Doc and Config fixups.

Be explicit about linux package names for those not familiar with
the platform. Also more explicit about steps such as editing file,
and testing the daemon.

Remove leading whitespace from commented-out config examples.
Set default parallel DNS back to 10, and suggest override of 100 in
config file. Enforce skipped DNS for autoconf IPs if unset (this is
a consequence of the way Dancer merges the two files - top level
config cannot be in both files).
This commit is contained in:
Oliver Gorwits
2014-02-08 15:10:57 +00:00
parent 279924d2fb
commit 3a7ffcf379
3 changed files with 46 additions and 39 deletions

View File

@@ -79,6 +79,9 @@ setting('plugins')->{DBIC}->{daemon} = {
schema_class => 'App::Netdisco::Daemon::DB',
};
# force skipped DNS resolution, if unset
setting('dns')->{no} ||= ['fe80::/64','169.254.0.0/16']
=head1 NAME
App::Netdisco - An open source web-based network management tool.
@@ -134,15 +137,15 @@ Notes|App::Netdisco::Manual::ReleaseNotes>.
Netdisco has several Perl library dependencies which will be automatically
installed. However it's I<strongly> recommended that you first install
L<DBD::Pg> and L<SNMP> using your operating system packages. The following
commands will test for the existence of them on your system:
L<DBD::Pg>, L<SNMP>, and a compiler using your operating system packages.
perl -MDBD::Pg\ 999
perl -MSNMP\ 999
On Ubuntu/Debian:
You'll also need a compiler for some of the other Perl dependencies. For
example on Ubuntu/Debian, install the C<build-essential> package. On
Fedora/Red-Hat, install C<make>, C<automake>, and C<gcc>.
root:~# apt-get install libdbd-pg-perl libsnmp-perl build-essential
On Fedora/Red-Hat:
root:~# yum install perl-DBD-Pg net-snmp-perl make automake gcc
With those installed, we can proceed...
@@ -187,7 +190,8 @@ Link some of the newly installed apps into a handy location:
ln -s ~/perl5/bin/{localenv,netdisco-*} ~/bin/
Test the installation by running the following command, which should only
produce a status message (and throw up no errors):
produce a status message (it's just a test - you'll start the daemon properly,
later on):
~/bin/netdisco-daemon status
@@ -200,12 +204,13 @@ template from this distribution:
cp ~/perl5/lib/perl5/auto/share/dist/App-Netdisco/environments/deployment.yml ~/environments
chmod +w ~/environments/deployment.yml
Edit the file and change the database connection parameters to match those for
your local system (that is, the C<name>, C<host>, C<user> and C<pass>).
Edit the file ("C<~/environments/deployment.yml>") and change the database
connection parameters to match those for your local system (that is, the
C<name>, C<host>, C<user> and C<pass>).
In the same file uncomment and edit the C<domain_suffix> setting to be
appropriate for your local site. Optionally, set the C<no_auth> value to true
if you wish to skip user authentication in the web interface.
appropriate for your local site. If this is a fresh install, uncomment and set
the C<no_auth> value to true (temporarily disables user authentication).
=head1 Bootstrap