diff --git a/Netdisco/Changes b/Netdisco/Changes index c85efc6b..5f725fb1 100644 --- a/Netdisco/Changes +++ b/Netdisco/Changes @@ -3,6 +3,7 @@ [ENHANCEMENTS] * Request net-snmp-devel on Fedora/Red-Hat builds + * Add BSD install notes 2.029014 - 2014-11-19 diff --git a/Netdisco/MANIFEST b/Netdisco/MANIFEST index 78e9d877..0c59f914 100644 --- a/Netdisco/MANIFEST +++ b/Netdisco/MANIFEST @@ -144,6 +144,7 @@ lib/App/Netdisco/DB/schema_versions/App-Netdisco-DB-9-10-PostgreSQL.sql lib/App/Netdisco/Environment.pm lib/App/Netdisco/JobQueue.pm lib/App/Netdisco/JobQueue/PostgreSQL.pm +lib/App/Netdisco/Manual/BSDInstall.pod lib/App/Netdisco/Manual/Configuration.pod lib/App/Netdisco/Manual/Deployment.pod lib/App/Netdisco/Manual/Developing.pod diff --git a/Netdisco/lib/App/Netdisco.pm b/Netdisco/lib/App/Netdisco.pm index d83833ca..113e678a 100644 --- a/Netdisco/lib/App/Netdisco.pm +++ b/Netdisco/lib/App/Netdisco.pm @@ -75,8 +75,9 @@ On Fedora/Red-Hat: root:~# yum install perl-core perl-DBD-Pg net-snmp-perl net-snmp-devel make automake gcc -With those installed, next check that your system's clock is correct. Then, we -can proceed... +On BSD systems please see L. + +With those installed, please check that your system's clock is correct. 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 diff --git a/Netdisco/lib/App/Netdisco/Manual/BSDInstall.pod b/Netdisco/lib/App/Netdisco/Manual/BSDInstall.pod new file mode 100644 index 00000000..98557bc8 --- /dev/null +++ b/Netdisco/lib/App/Netdisco/Manual/BSDInstall.pod @@ -0,0 +1,58 @@ +=head1 NAME + +App::Netdisco::Manual::BSDInstall - BSD Install Instructions + +=head1 Introduction + +This document is compiled from suggestions and comments on the Netdisco mail +lists. We're grateful for the help, and if you have any additions please do +let the project staff know. + +=head1 Ports Installs + +=over 4 + +=item * + +Perl (if not already installed) + +=item * + +C (will also pull in C) + +=item * + +C + +=item * + +C (should install the Perl binding C) + +=back + +=head1 Additional Steps + +=head2 Netdisco User + + pw useradd netdisco -N -m -s /bin/bash -w no + +=head2 PostgreSQL Setup + + /usr/local/etc/rc.d/postgresql initdb + /usr/local/etc/rc.d/postgresql start + +Make sure PostgreSQL starts at boot by adding the following to +"C": + + postgresql_enable="YES" + +When installing C port, it creates the C user with +"C" shell. As root, do C and change the shell to C or +whichever shell you want, so that you can do the C step from the +main instructions. + +C doesn't seem to work on NetBSD. This needs looking into. Nothing +will break, but it just means the server probably isn't tuned to your system's +hardware (RAM, etc). + +=cut