diff --git a/Netdisco/Makefile.PL b/Netdisco/Makefile.PL
index 790c1a23..354c1a10 100644
--- a/Netdisco/Makefile.PL
+++ b/Netdisco/Makefile.PL
@@ -28,7 +28,7 @@ requires 'Socket6' => 0;
requires 'Template' => 0;
requires 'YAML' => 0;
requires 'namespace::clean' => 0;
-requires 'version' => 0;
+requires 'version' => 0.9901;
install_share 'share';
diff --git a/Netdisco/lib/App/Netdisco.pm b/Netdisco/lib/App/Netdisco.pm
index a8f0015d..7e50934c 100644
--- a/Netdisco/lib/App/Netdisco.pm
+++ b/Netdisco/lib/App/Netdisco.pm
@@ -30,11 +30,12 @@ App::Netdisco - An open source web-based network management tool.
=head1 Introduction
-The contents of this distribution is the next major version of the Netdisco
-network management tool. See L for further information
-on the project.
+The content of this distribution is the next major version of the Netdisco
+network management tool. Pieces are still missing however, so if you're a new
+user please see L for further information on the project
+and how to download the current official release.
-So far L provides a web frontend and a backend daemon to handle
+L provides a web frontend and a backend daemon to handle
interactive requests such as changing port or device properties. There is not
yet a device poller, so please still use the old Netdisco's discovery, arpnip,
and macsuck.
@@ -56,14 +57,16 @@ With those two installed, we can proceed...
Create a user on your system called C if one does not already exist.
We'll install Netdisco and its dependencies into this user's home area, which
-will take about 200MB including MIB files.
+will take about 250MB including MIB files.
- # useradd -m -p x -s /bin/bash nedisco
+ root:~# useradd -m -p x -s /bin/bash nedisco
Netdisco uses the PostgreSQL database server. Install PostgreSQL and then change
to the PostgreSQL superuser (usually C). Create a new database and
PostgreSQL user for the Netdisco application:
+ root:~# su - postgres
+
postgres:~$ createuser -DRSP netdisco
Enter password for new role:
Enter it again:
@@ -84,12 +87,13 @@ install Netdisco and its dependencies into the C user's home area
Link some of the newly installed apps into the C user's C<$PATH>,
e.g. C<~netdisco/bin>:
+ mkdir ~/bin
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):
- localenv netdisco-daemon status
+ ~/bin/localenv netdisco-daemon status
=head1 Configuration
@@ -113,7 +117,7 @@ release of Netdisco (1.x). You also need vendor MAC address prefixes (OUI
data) and some MIBs if you want to run the daemon. The following script will
take care of all this for you:
- DANCER_ENVDIR=~/environments localenv netdisco-deploy
+ DANCER_ENVDIR=~/environments ~/bin/localenv netdisco-deploy
If you don't want that level of automation, check out the database schema diff
from the current release of Netdisco, and apply it yourself:
@@ -124,14 +128,14 @@ from the current release of Netdisco, and apply it yourself:
Run the following command to start the web server:
- DANCER_ENVDIR=~/environments localenv plackup ~/bin/netdisco-web
+ DANCER_ENVDIR=~/environments ~/bin/localenv plackup ~/bin/netdisco-web
Other ways to run and host the web application can be found in the
L page. See also the L documentation.
Run the following command to start the daemon:
- DANCER_ENVDIR=~/environments localenv netdisco-daemon start
+ DANCER_ENVDIR=~/environments ~/bin/localenv netdisco-daemon start
=head1 Tips and Tricks
@@ -145,7 +149,7 @@ For SQL debugging try the following command:
DANCER_ENVDIR=~/environments plackup ~/bin/netdisco-web
To run the job daemon in the foreground, start the C
-program instead of C.
+program instead of C.
=head1 Future Work