From: Ethan G. <ega...@us...> - 2008-10-15 22:52:16
|
Update of /cvsroot/nagios/nagios/html/docs In directory fdv4jf1.ch3.sourceforge.com:/tmp/cvs-serv16843/html/docs Modified Files: quickstart-fedora.html quickstart-opensuse.html quickstart-ubuntu.html Log Message: Prep for new release Index: quickstart-ubuntu.html =================================================================== RCS file: /cvsroot/nagios/nagios/html/docs/quickstart-ubuntu.html,v retrieving revision 1.24 retrieving revision 1.25 diff -C2 -d -r1.24 -r1.25 *** quickstart-ubuntu.html 25 Jun 2008 18:16:36 -0000 1.24 --- quickstart-ubuntu.html 15 Oct 2008 22:52:09 -0000 1.25 *************** *** 1,342 **** ! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> ! ! <html> ! <head> ! <title>Ubuntu Quickstart</title> ! ! <STYLE type="text/css"> ! <!-- ! .Default { font-family: verdana,arial,serif; font-size: 8pt; } ! .PageTitle { font-family: verdana,arial,serif; font-size: 16pt; font-weight: bold; } ! --> ! </STYLE> ! ! </head> ! ! <body bgcolor="#FFFFFF" text="black" class="Default"> ! ! <div align="center"> ! <img src="images/nagios.jpg" border="0" alt="Nagios" title="Nagios"> ! <h1 class="PageTitle">Ubuntu Quickstart</h1> ! </div> ! ! <hr> ! ! <p> ! <img src="images/upto.gif" border="0" align="middle" alt="Up To" title="Up To">Up To: <a href="toc.html">Contents</a><br> ! <img src="images/seealso.gif" border="0" align="middle" alt="See Also" title="See Also"> See Also: <a href="quickstart.html">Quickstart Installation Guides</a> ! </p> ! ! <p> ! <strong><u>Introduction</u></strong> ! </p> ! ! <p> ! This guide is intended to provide you with simple instructions on how to install Nagios from source (code) on Ubuntu and have it monitoring your local machine inside of 20 minutes. No advanced installation options are discussed here - just the basics that will work for 95% of users who want to get started. ! </p> ! ! <p> ! These instructions were written based on an <b>Ubuntu 6.10</b> (desktop) installation. They should work for an <b>Ubuntu 7.10</b> install as well. ! </p> ! ! <p> ! <strong><u>What You'll End Up With</u></strong> ! </p> ! ! <p> ! If you follow these instructions, here's what you'll end up with: ! </p> ! ! <ul> ! <li>Nagios and the plugins will be installed underneath /usr/local/nagios</li> ! <li>Nagios will be configured to monitor a few aspects of your local system (CPU load, disk usage, etc.)</li> ! <li>The Nagios web interface will be accessible at http://localhost/nagios/</li> ! </ul> ! ! <p> ! <strong><u>Required Packages</u></strong> ! </p> ! ! <p> ! Make sure you've installed the following packages on your Ubuntu installation before continuing. ! </p> ! ! <ul> ! <li>Apache 2</li> ! <li>GCC compiler and development libraries</li> ! <li>GD development libraries</li> ! </ul> ! ! <p> ! You can use <i>apt-get</i> to install these packages by running the following commands: ! </p> ! ! <pre> ! sudo apt-get install apache2 ! sudo apt-get install build-essential ! </pre> ! ! <p> ! With Ubuntu 6.10, install the gd2 library with this command: ! </p> ! ! <pre> ! sudo apt-get install libgd2-dev ! </pre> ! <p> ! With Ubuntu 7.10, the gd2 library name has changed, so you'll need to use the following: ! </p> ! ! <pre> ! sudo apt-get install libgd2-xpm-dev ! </pre> ! ! <p> ! <strong><u>1) Create Account Information</u></strong> ! </p> ! ! <p> ! Become the root user. ! </p> ! ! <pre> ! sudo -s ! </pre> ! ! <p> ! Create a new <i>nagios</i> user account and give it a password. ! </p> ! ! <pre> ! /usr/sbin/useradd -m nagios ! passwd nagios ! </pre> ! ! <p> ! On Ubuntu server edition (6.01 and possible newer versions), you will need to also add a <i>nagios</i> group (it's not created by default). You should be able to skip this step on desktop editions of Ubuntu. ! </p> ! ! <pre> ! /usr/sbin/groupadd nagios ! /usr/sbin/usermod -G nagios nagios ! </pre> ! ! <p> ! Create a new <i>nagcmd</i> group for allowing external commands to be submitted through the web interface. Add both the nagios user and the apache user to the group. ! </p> ! ! <pre> ! /usr/sbin/groupadd nagcmd ! /usr/sbin/usermod -G nagcmd nagios ! /usr/sbin/usermod -G nagcmd www-data ! </pre> ! ! <p> ! <strong><u>2) Download Nagios and the Plugins</u></strong> ! </p> ! ! <p> ! Create a directory for storing the downloads. ! </p> ! ! <pre> ! mkdir ~/downloads ! cd ~/downloads ! </pre> ! ! <p> ! Download the source code tarballs of both Nagios and the Nagios plugins (visit <a href="http://www.nagios.org/download/">http://www.nagios.org/download/</a> for links to the latest versions). At the time of writing, the latest versions of Nagios and the Nagios plugins were 3.0.3 and 1.4.11, respectively. ! </p> ! ! <pre> ! wget http://osdn.dl.sourceforge.net/sourceforge/nagios/nagios-3.0.2.tar.gz ! wget http://osdn.dl.sourceforge.net/sourceforge/nagiosplug/nagios-plugins-1.4.11.tar.gz ! </pre> ! ! <p> ! <strong><u>3) Compile and Install Nagios</u></strong> ! </p> ! ! <p> ! Extract the Nagios source code tarball. ! </p> ! ! <pre> ! cd ~/downloads ! tar xzf nagios-3.0.2.tar.gz ! cd nagios-3.0.2 ! </pre> ! ! <p> ! Run the Nagios configure script, passing the name of the group you created earlier like so: ! </p> ! ! <pre> ! ./configure --with-command-group=nagcmd ! </pre> ! ! <p> ! Compile the Nagios source code. ! </p> ! ! <pre> ! make all ! </pre> ! ! <p> ! Install binaries, init script, sample config files and set permissions on the external command directory. ! </p> ! ! <pre> ! make install ! make install-init ! make install-config ! make install-commandmode ! </pre> ! ! <p> ! Don't start Nagios yet - there's still more that needs to be done... ! </p> ! ! <p> ! <strong><u>4) Customize Configuration</u></strong> ! </p> ! ! <p> ! Sample <a href="config.html">configuration files</a> have now been installed in the <i>/usr/local/nagios/etc</i> directory. These sample files should work fine for getting started with Nagios. You'll need to make just one change before you proceed... ! </p> ! ! <p> ! Edit the <i>/usr/local/nagios/etc/objects/contacts.cfg</i> config file with your favorite editor and change the email address associated with the <i>nagiosadmin</i> contact definition to the address you'd like to use for receiving alerts. ! </p> ! ! <pre> ! vi /usr/local/nagios/etc/objects/contacts.cfg ! </pre> ! ! <p> ! <strong><u>5) Configure the Web Interface</u></strong> ! </p> ! ! <p> ! Install the Nagios web config file in the Apache conf.d directory. ! </p> ! ! <pre> ! make install-webconf ! </pre> ! ! <p> ! Create a <i>nagiosadmin</i> account for logging into the Nagios web interface. Remember the password you assign to this account - you'll need it later. ! </p> ! ! <pre> ! htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin ! </pre> ! ! <p> ! Restart Apache to make the new settings take effect. ! </p> ! ! <pre> ! /etc/init.d/apache2 reload ! </pre> ! ! <p> ! <strong><u>6) Compile and Install the Nagios Plugins</u></strong> ! </p> ! ! <p> ! Extract the Nagios plugins source code tarball. ! </p> ! ! <pre> ! cd ~/downloads ! tar xzf nagios-plugins-1.4.11.tar.gz ! cd nagios-plugins-1.4.11 ! </pre> ! ! <p> ! Compile and install the plugins. ! </p> ! ! <pre> ! ./configure --with-nagios-user=nagios --with-nagios-group=nagios ! make ! make install ! </pre> ! ! ! <p> ! <strong><u>7) Start Nagios</u></strong> ! </p> ! ! <p> ! Configure Nagios to automatically start when the system boots. ! </p> ! ! <pre> ! ln -s /etc/init.d/nagios /etc/rcS.d/S99nagios ! </pre> ! ! <p> ! Verify the sample Nagios configuration files. ! </p> ! ! <pre> ! /usr/local/nagios/bin/nagios -v /usr/local/nagios/etc/nagios.cfg ! </pre> ! ! <p> ! If there are no errors, start Nagios. ! </p> ! ! <pre> ! /etc/init.d/nagios start ! </pre> ! ! <p> ! <strong><u>8) Login to the Web Interface</u></strong> ! </p> ! ! <p> ! You should now be able to access the Nagios web interface at the URL below. You'll be prompted for the username (<i>nagiosadmin</i>) and password you specified earlier. ! </p> ! ! <pre> ! http://localhost/nagios/ ! </pre> ! ! <p> ! Click on the "Service Detail" navbar link to see details of what's being monitored on your local machine. It will take a few minutes for Nagios to check all the services associated with your machine, as the checks are spread out over time. ! </p> ! ! <p> ! <strong><u>9) Other Modifications</u></strong> ! </p> ! ! <p> ! If you want to receive email notifications for Nagios alerts, you need to install the mailx (Postfix) package. ! </p> ! ! <pre> ! sudo apt-get install mailx ! </pre> ! ! <p> ! You'll have to edit the Nagios email notification commands found in <i>/usr/local/nagios/etc/objects/commands.cfg</i> and change any '/bin/mail' references to '/usr/bin/mail'. Once you do that you'll need to restart Nagios to make the configuration changes live. ! </p> ! ! <pre> ! sudo /etc/init.d/nagios restart ! </pre> ! ! <p> ! Configuring email notifications is outside the scope of this documentation. Refer to your system documentation, search the web, or look to the <a href="http://www.nagioscommunity.org/wiki">NagiosCommunity.org wiki</a> for specific instructions on configuring your Ubuntu system to send email messages to external addresses. ! </p> ! ! ! <hr> ! ! </body> </html> \ No newline at end of file --- 1,342 ---- ! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> ! ! <html> ! <head> ! <title>Ubuntu Quickstart</title> ! ! <STYLE type="text/css"> ! <!-- ! .Default { font-family: verdana,arial,serif; font-size: 8pt; } ! .PageTitle { font-family: verdana,arial,serif; font-size: 16pt; font-weight: bold; } ! --> ! </STYLE> ! ! </head> ! ! <body bgcolor="#FFFFFF" text="black" class="Default"> ! ! <div align="center"> ! <img src="images/nagios.jpg" border="0" alt="Nagios" title="Nagios"> ! <h1 class="PageTitle">Ubuntu Quickstart</h1> ! </div> ! ! <hr> ! ! <p> ! <img src="images/upto.gif" border="0" align="middle" alt="Up To" title="Up To">Up To: <a href="toc.html">Contents</a><br> ! <img src="images/seealso.gif" border="0" align="middle" alt="See Also" title="See Also"> See Also: <a href="quickstart.html">Quickstart Installation Guides</a> ! </p> ! ! <p> ! <strong><u>Introduction</u></strong> ! </p> ! ! <p> ! This guide is intended to provide you with simple instructions on how to install Nagios from source (code) on Ubuntu and have it monitoring your local machine inside of 20 minutes. No advanced installation options are discussed here - just the basics that will work for 95% of users who want to get started. ! </p> ! ! <p> ! These instructions were written based on an <b>Ubuntu 6.10</b> (desktop) installation. They should work for an <b>Ubuntu 7.10</b> install as well. ! </p> ! ! <p> ! <strong><u>What You'll End Up With</u></strong> ! </p> ! ! <p> ! If you follow these instructions, here's what you'll end up with: ! </p> ! ! <ul> ! <li>Nagios and the plugins will be installed underneath /usr/local/nagios</li> ! <li>Nagios will be configured to monitor a few aspects of your local system (CPU load, disk usage, etc.)</li> ! <li>The Nagios web interface will be accessible at http://localhost/nagios/</li> ! </ul> ! ! <p> ! <strong><u>Required Packages</u></strong> ! </p> ! ! <p> ! Make sure you've installed the following packages on your Ubuntu installation before continuing. ! </p> ! ! <ul> ! <li>Apache 2</li> ! <li>GCC compiler and development libraries</li> ! <li>GD development libraries</li> ! </ul> ! ! <p> ! You can use <i>apt-get</i> to install these packages by running the following commands: ! </p> ! ! <pre> ! sudo apt-get install apache2 ! sudo apt-get install build-essential ! </pre> ! ! <p> ! With Ubuntu 6.10, install the gd2 library with this command: ! </p> ! ! <pre> ! sudo apt-get install libgd2-dev ! </pre> ! <p> ! With Ubuntu 7.10, the gd2 library name has changed, so you'll need to use the following: ! </p> ! ! <pre> ! sudo apt-get install libgd2-xpm-dev ! </pre> ! ! <p> ! <strong><u>1) Create Account Information</u></strong> ! </p> ! ! <p> ! Become the root user. ! </p> ! ! <pre> ! sudo -s ! </pre> ! ! <p> ! Create a new <i>nagios</i> user account and give it a password. ! </p> ! ! <pre> ! /usr/sbin/useradd -m nagios ! passwd nagios ! </pre> ! ! <p> ! On Ubuntu server edition (6.01 and possible newer versions), you will need to also add a <i>nagios</i> group (it's not created by default). You should be able to skip this step on desktop editions of Ubuntu. ! </p> ! ! <pre> ! /usr/sbin/groupadd nagios ! /usr/sbin/usermod -G nagios nagios ! </pre> ! ! <p> ! Create a new <i>nagcmd</i> group for allowing external commands to be submitted through the web interface. Add both the nagios user and the apache user to the group. ! </p> ! ! <pre> ! /usr/sbin/groupadd nagcmd ! /usr/sbin/usermod -G nagcmd nagios ! /usr/sbin/usermod -G nagcmd www-data ! </pre> ! ! <p> ! <strong><u>2) Download Nagios and the Plugins</u></strong> ! </p> ! ! <p> ! Create a directory for storing the downloads. ! </p> ! ! <pre> ! mkdir ~/downloads ! cd ~/downloads ! </pre> ! ! <p> ! Download the source code tarballs of both Nagios and the Nagios plugins (visit <a href="http://www.nagios.org/download/">http://www.nagios.org/download/</a> for links to the latest versions). At the time of writing, the latest versions of Nagios and the Nagios plugins were 3.0.3 and 1.4.11, respectively. ! </p> ! ! <pre> ! wget http://osdn.dl.sourceforge.net/sourceforge/nagios/nagios-3.0.4.tar.gz ! wget http://osdn.dl.sourceforge.net/sourceforge/nagiosplug/nagios-plugins-1.4.11.tar.gz ! </pre> ! ! <p> ! <strong><u>3) Compile and Install Nagios</u></strong> ! </p> ! ! <p> ! Extract the Nagios source code tarball. ! </p> ! ! <pre> ! cd ~/downloads ! tar xzf nagios-3.0.2.tar.gz ! cd nagios-3.0.2 ! </pre> ! ! <p> ! Run the Nagios configure script, passing the name of the group you created earlier like so: ! </p> ! ! <pre> ! ./configure --with-command-group=nagcmd ! </pre> ! ! <p> ! Compile the Nagios source code. ! </p> ! ! <pre> ! make all ! </pre> ! ! <p> ! Install binaries, init script, sample config files and set permissions on the external command directory. ! </p> ! ! <pre> ! make install ! make install-init ! make install-config ! make install-commandmode ! </pre> ! ! <p> ! Don't start Nagios yet - there's still more that needs to be done... ! </p> ! ! <p> ! <strong><u>4) Customize Configuration</u></strong> ! </p> ! ! <p> ! Sample <a href="config.html">configuration files</a> have now been installed in the <i>/usr/local/nagios/etc</i> directory. These sample files should work fine for getting started with Nagios. You'll need to make just one change before you proceed... ! </p> ! ! <p> ! Edit the <i>/usr/local/nagios/etc/objects/contacts.cfg</i> config file with your favorite editor and change the email address associated with the <i>nagiosadmin</i> contact definition to the address you'd like to use for receiving alerts. ! </p> ! ! <pre> ! vi /usr/local/nagios/etc/objects/contacts.cfg ! </pre> ! ! <p> ! <strong><u>5) Configure the Web Interface</u></strong> ! </p> ! ! <p> ! Install the Nagios web config file in the Apache conf.d directory. ! </p> ! ! <pre> ! make install-webconf ! </pre> ! ! <p> ! Create a <i>nagiosadmin</i> account for logging into the Nagios web interface. Remember the password you assign to this account - you'll need it later. ! </p> ! ! <pre> ! htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin ! </pre> ! ! <p> ! Restart Apache to make the new settings take effect. ! </p> ! ! <pre> ! /etc/init.d/apache2 reload ! </pre> ! ! <p> ! <strong><u>6) Compile and Install the Nagios Plugins</u></strong> ! </p> ! ! <p> ! Extract the Nagios plugins source code tarball. ! </p> ! ! <pre> ! cd ~/downloads ! tar xzf nagios-plugins-1.4.11.tar.gz ! cd nagios-plugins-1.4.11 ! </pre> ! ! <p> ! Compile and install the plugins. ! </p> ! ! <pre> ! ./configure --with-nagios-user=nagios --with-nagios-group=nagios ! make ! make install ! </pre> ! ! ! <p> ! <strong><u>7) Start Nagios</u></strong> ! </p> ! ! <p> ! Configure Nagios to automatically start when the system boots. ! </p> ! ! <pre> ! ln -s /etc/init.d/nagios /etc/rcS.d/S99nagios ! </pre> ! ! <p> ! Verify the sample Nagios configuration files. ! </p> ! ! <pre> ! /usr/local/nagios/bin/nagios -v /usr/local/nagios/etc/nagios.cfg ! </pre> ! ! <p> ! If there are no errors, start Nagios. ! </p> ! ! <pre> ! /etc/init.d/nagios start ! </pre> ! ! <p> ! <strong><u>8) Login to the Web Interface</u></strong> ! </p> ! ! <p> ! You should now be able to access the Nagios web interface at the URL below. You'll be prompted for the username (<i>nagiosadmin</i>) and password you specified earlier. ! </p> ! ! <pre> ! http://localhost/nagios/ ! </pre> ! ! <p> ! Click on the "Service Detail" navbar link to see details of what's being monitored on your local machine. It will take a few minutes for Nagios to check all the services associated with your machine, as the checks are spread out over time. ! </p> ! ! <p> ! <strong><u>9) Other Modifications</u></strong> ! </p> ! ! <p> ! If you want to receive email notifications for Nagios alerts, you need to install the mailx (Postfix) package. ! </p> ! ! <pre> ! sudo apt-get install mailx ! </pre> ! ! <p> ! You'll have to edit the Nagios email notification commands found in <i>/usr/local/nagios/etc/objects/commands.cfg</i> and change any '/bin/mail' references to '/usr/bin/mail'. Once you do that you'll need to restart Nagios to make the configuration changes live. ! </p> ! ! <pre> ! sudo /etc/init.d/nagios restart ! </pre> ! ! <p> ! Configuring email notifications is outside the scope of this documentation. Refer to your system documentation, search the web, or look to the <a href="http://www.nagioscommunity.org/wiki">NagiosCommunity.org wiki</a> for specific instructions on configuring your Ubuntu system to send email messages to external addresses. ! </p> ! ! ! <hr> ! ! </body> </html> \ No newline at end of file Index: quickstart-opensuse.html =================================================================== RCS file: /cvsroot/nagios/nagios/html/docs/quickstart-opensuse.html,v retrieving revision 1.23 retrieving revision 1.24 diff -C2 -d -r1.23 -r1.24 *** quickstart-opensuse.html 25 Jun 2008 18:16:33 -0000 1.23 --- quickstart-opensuse.html 15 Oct 2008 22:52:09 -0000 1.24 *************** *** 1,305 **** ! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> ! ! <html> ! <head> ! <title>openSUSE Quickstart</title> ! ! <STYLE type="text/css"> ! <!-- ! .Default { font-family: verdana,arial,serif; font-size: 8pt; } ! .PageTitle { font-family: verdana,arial,serif; font-size: 16pt; font-weight: bold; } ! --> ! </STYLE> ! ! </head> ! ! <body bgcolor="#FFFFFF" text="black" class="Default"> ! ! <div align="center"> ! <img src="images/nagios.jpg" border="0" alt="Nagios" title="Nagios"> ! <h1 class="PageTitle">openSUSE Quickstart</h1> ! </div> ! ! <hr> ! ! <p> ! <img src="images/upto.gif" border="0" align="middle" alt="Up To" title="Up To">Up To: <a href="toc.html">Contents</a><br> ! <img src="images/seealso.gif" border="0" align="middle" alt="See Also" title="See Also"> See Also: <a href="quickstart.html">Quickstart Installation Guides</a> ! </p> ! ! <p> ! <strong><u>Introduction</u></strong> ! </p> ! ! <p> ! This guide is intended to provide you with simple instructions on how to install Nagios from source (code) on openSUSE and have it monitoring your local machine inside of 20 minutes. No advanced installation options are discussed here - just the basics that will work for 95% of users who want to get started. ! </p> ! ! <p> ! These instructions were written based on an <b>openSUSE 10.2</b> installation. ! </p> ! ! <p> ! <strong><u>Required Packages</u></strong> ! </p> ! ! <p> ! Make sure you've installed the following packages on your openSUSE installation before continuing. You can use <i>yast</i> to install packages under openSUSE. ! </p> ! ! <ul> ! <li>apache2</li> ! <li>C/C++ development libraries</li> ! </ul> ! ! <p> ! <strong><u>1) Create Account Information</u></strong> ! </p> ! ! <p> ! Become the root user. ! </p> ! ! <pre> ! su -l ! </pre> ! ! <p> ! Create a new <i>nagios</i> user account and give it a password. ! </p> ! ! <pre> ! /usr/sbin/useradd -m nagios ! passwd nagios ! </pre> ! ! <p> ! Create a new <i>nagios</i> group. Add the nagios user to the group. ! </p> ! ! <pre> ! /usr/sbin/groupadd nagios ! /usr/sbin/usermod -G nagios nagios ! </pre> ! ! <p> ! Create a new <i>nagcmd</i> group for allowing external commands to be submitted through the web interface. Add both the nagios user and the apache user to the group. ! </p> ! ! <pre> ! /usr/sbin/groupadd nagcmd ! /usr/sbin/usermod -G nagcmd nagios ! /usr/sbin/usermod -G nagcmd wwwrun ! </pre> ! ! <p> ! <strong><u>2) Download Nagios and the Plugins</u></strong> ! </p> ! ! <p> ! Create a directory for storing the downloads. ! </p> ! ! <pre> ! mkdir ~/downloads ! cd ~/downloads ! </pre> ! ! <p> ! Download the source code tarballs of both Nagios and the Nagios plugins (visit <a href="http://www.nagios.org/download/">http://www.nagios.org/download/</a> for links to the latest versions). At the time of writing, the latest versions of Nagios and the Nagios plugins were 3.0.3 and 1.4.11, respectively. ! </p> ! ! <pre> ! wget http://osdn.dl.sourceforge.net/sourceforge/nagios/nagios-3.0.2.tar.gz ! wget http://osdn.dl.sourceforge.net/sourceforge/nagiosplug/nagios-plugins-1.4.11.tar.gz ! </pre> ! ! <p> ! <strong><u>3) Compile and Install Nagios</u></strong> ! </p> ! ! <p> ! Extract the Nagios source code tarball. ! </p> ! ! <pre> ! cd ~/downloads ! tar xzf nagios-3.0.2.tar.gz ! cd nagios-3.0.2 ! </pre> ! ! <p> ! Run the Nagios configure script, passing the name of the group you created earlier like so: ! </p> ! ! <pre> ! ./configure --with-command-group=nagcmd ! </pre> ! ! <p> ! Compile the Nagios source code. ! </p> ! ! <pre> ! make all ! </pre> ! ! <p> ! Install binaries, init script, sample config files and set permissions on the external command directory. ! </p> ! ! <pre> ! make install ! make install-init ! make install-config ! make install-commandmode ! </pre> ! ! <p> ! Don't start Nagios yet - there's still more that needs to be done... ! </p> ! ! <p> ! <strong><u>4) Customize Configuration</u></strong> ! </p> ! ! <p> ! Sample <a href="config.html">configuration files</a> have now been installed in the <i>/usr/local/nagios/etc</i> directory. These sample files should work fine for getting started with Nagios. You'll need to make just one change before you proceed... ! </p> ! ! <p> ! Edit the <i>/usr/local/nagios/etc/objects/contacts.cfg</i> config file with your favorite editor and change the email address associated with the <i>nagiosadmin</i> contact definition to the address you'd like to use for receiving alerts. ! </p> ! ! <pre> ! vi /usr/local/nagios/etc/objects/contacts.cfg ! </pre> ! ! <p> ! <strong><u>5) Configure the Web Interface</u></strong> ! </p> ! ! <p> ! Install the Nagios web config file in the Apache conf.d directory. ! </p> ! ! <pre> ! make install-webconf ! </pre> ! ! <p> ! Create a <i>nagiosadmin</i> account for logging into the Nagios web interface. Remember the password you assign to this account - you'll need it later. ! </p> ! ! <pre> ! htpasswd2 -c /usr/local/nagios/etc/htpasswd.users nagiosadmin ! </pre> ! ! <p> ! Restart Apache to make the new settings take effect. ! </p> ! ! <pre> ! service apache2 restart ! </pre> ! ! <p> ! <strong><u>6) Compile and Install the Nagios Plugins</u></strong> ! </p> ! ! <p> ! Extract the Nagios plugins source code tarball. ! </p> ! ! <pre> ! cd ~/downloads ! tar xzf nagios-plugins-1.4.11.tar.gz ! cd nagios-plugins-1.4.11 ! </pre> ! ! <p> ! Compile and install the plugins. ! </p> ! ! <pre> ! ./configure --with-nagios-user=nagios --with-nagios-group=nagios ! make ! make install ! </pre> ! ! ! <p> ! <strong><u>7) Start Nagios</u></strong> ! </p> ! ! <p> ! Add Nagios to the list of system services and have it automatically start when the system boots. ! </p> ! ! <pre> ! chkconfig --add nagios ! chkconfig nagios on ! </pre> ! ! <p> ! Verify the sample Nagios configuration files. ! </p> ! ! <pre> ! /usr/local/nagios/bin/nagios -v /usr/local/nagios/etc/nagios.cfg ! </pre> ! ! <p> ! If there are no errors, start Nagios. ! </p> ! ! <pre> ! service nagios start ! </pre> ! ! <p> ! <strong><u>8) Login to the Web Interface</u></strong> ! </p> ! ! <p> ! You should now be able to access the Nagios web interface at the URL below. You'll be prompted for the username (<i>nagiosadmin</i>) and password you specified earlier. ! </p> ! ! <pre> ! http://localhost/nagios/ ! </pre> ! ! <p> ! Click on the "Service Detail" navbar link to see details of what's being monitored on your local machine. It will take a few minutes for Nagios to check all the services associated with your machine, as the checks are spread out over time. ! </p> ! ! <p> ! <strong><u>9) Other Modifications</u></strong> ! </p> ! ! <p> ! Make sure your machine's firewall rules are configured to allow access to the web server if you want to access the Nagios interface remotely. ! </p> ! ! <p> ! You can do this by: ! </p> ! ! <ul> ! <li>Opening the control center</li> ! <li>Select 'Open Administrator Settings' to open the YaST administrator control center</li> ! <li>Select 'Firewall' from the 'Security and Users' category</li> ! <li>Click the 'Allowed Services' option in the Firewall Configuration window ! <li>Add 'HTTP Server' to the allowed services list for the 'External Zone'</li> ! <li>Click 'Next' and 'Accept' to activate the new firewall settings</li> ! </ul> ! ! <p> ! Configuring email notifications is outside the scope of this documentation. Refer to your system documentation, search the web, or look to the <a href="http://www.nagioscommunity.org/wiki">NagiosCommunity.org wiki</a> for specific instructions on configuring your openSUSE system to send email messages to external addresses. ! </p> ! ! ! <hr> ! ! </body> </html> \ No newline at end of file --- 1,305 ---- ! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> ! ! <html> ! <head> ! <title>openSUSE Quickstart</title> ! ! <STYLE type="text/css"> ! <!-- ! .Default { font-family: verdana,arial,serif; font-size: 8pt; } ! .PageTitle { font-family: verdana,arial,serif; font-size: 16pt; font-weight: bold; } ! --> ! </STYLE> ! ! </head> ! ! <body bgcolor="#FFFFFF" text="black" class="Default"> ! ! <div align="center"> ! <img src="images/nagios.jpg" border="0" alt="Nagios" title="Nagios"> ! <h1 class="PageTitle">openSUSE Quickstart</h1> ! </div> ! ! <hr> ! ! <p> ! <img src="images/upto.gif" border="0" align="middle" alt="Up To" title="Up To">Up To: <a href="toc.html">Contents</a><br> ! <img src="images/seealso.gif" border="0" align="middle" alt="See Also" title="See Also"> See Also: <a href="quickstart.html">Quickstart Installation Guides</a> ! </p> ! ! <p> ! <strong><u>Introduction</u></strong> ! </p> ! ! <p> ! This guide is intended to provide you with simple instructions on how to install Nagios from source (code) on openSUSE and have it monitoring your local machine inside of 20 minutes. No advanced installation options are discussed here - just the basics that will work for 95% of users who want to get started. ! </p> ! ! <p> ! These instructions were written based on an <b>openSUSE 10.2</b> installation. ! </p> ! ! <p> ! <strong><u>Required Packages</u></strong> ! </p> ! ! <p> ! Make sure you've installed the following packages on your openSUSE installation before continuing. You can use <i>yast</i> to install packages under openSUSE. ! </p> ! ! <ul> ! <li>apache2</li> ! <li>C/C++ development libraries</li> ! </ul> ! ! <p> ! <strong><u>1) Create Account Information</u></strong> ! </p> ! ! <p> ! Become the root user. ! </p> ! ! <pre> ! su -l ! </pre> ! ! <p> ! Create a new <i>nagios</i> user account and give it a password. ! </p> ! ! <pre> ! /usr/sbin/useradd -m nagios ! passwd nagios ! </pre> ! ! <p> ! Create a new <i>nagios</i> group. Add the nagios user to the group. ! </p> ! ! <pre> ! /usr/sbin/groupadd nagios ! /usr/sbin/usermod -G nagios nagios ! </pre> ! ! <p> ! Create a new <i>nagcmd</i> group for allowing external commands to be submitted through the web interface. Add both the nagios user and the apache user to the group. ! </p> ! ! <pre> ! /usr/sbin/groupadd nagcmd ! /usr/sbin/usermod -G nagcmd nagios ! /usr/sbin/usermod -G nagcmd wwwrun ! </pre> ! ! <p> ! <strong><u>2) Download Nagios and the Plugins</u></strong> ! </p> ! ! <p> ! Create a directory for storing the downloads. ! </p> ! ! <pre> ! mkdir ~/downloads ! cd ~/downloads ! </pre> ! ! <p> ! Download the source code tarballs of both Nagios and the Nagios plugins (visit <a href="http://www.nagios.org/download/">http://www.nagios.org/download/</a> for links to the latest versions). At the time of writing, the latest versions of Nagios and the Nagios plugins were 3.0.3 and 1.4.11, respectively. ! </p> ! ! <pre> ! wget http://osdn.dl.sourceforge.net/sourceforge/nagios/nagios-3.0.4.tar.gz ! wget http://osdn.dl.sourceforge.net/sourceforge/nagiosplug/nagios-plugins-1.4.11.tar.gz ! </pre> ! ! <p> ! <strong><u>3) Compile and Install Nagios</u></strong> ! </p> ! ! <p> ! Extract the Nagios source code tarball. ! </p> ! ! <pre> ! cd ~/downloads ! tar xzf nagios-3.0.2.tar.gz ! cd nagios-3.0.2 ! </pre> ! ! <p> ! Run the Nagios configure script, passing the name of the group you created earlier like so: ! </p> ! ! <pre> ! ./configure --with-command-group=nagcmd ! </pre> ! ! <p> ! Compile the Nagios source code. ! </p> ! ! <pre> ! make all ! </pre> ! ! <p> ! Install binaries, init script, sample config files and set permissions on the external command directory. ! </p> ! ! <pre> ! make install ! make install-init ! make install-config ! make install-commandmode ! </pre> ! ! <p> ! Don't start Nagios yet - there's still more that needs to be done... ! </p> ! ! <p> ! <strong><u>4) Customize Configuration</u></strong> ! </p> ! ! <p> ! Sample <a href="config.html">configuration files</a> have now been installed in the <i>/usr/local/nagios/etc</i> directory. These sample files should work fine for getting started with Nagios. You'll need to make just one change before you proceed... ! </p> ! ! <p> ! Edit the <i>/usr/local/nagios/etc/objects/contacts.cfg</i> config file with your favorite editor and change the email address associated with the <i>nagiosadmin</i> contact definition to the address you'd like to use for receiving alerts. ! </p> ! ! <pre> ! vi /usr/local/nagios/etc/objects/contacts.cfg ! </pre> ! ! <p> ! <strong><u>5) Configure the Web Interface</u></strong> ! </p> ! ! <p> ! Install the Nagios web config file in the Apache conf.d directory. ! </p> ! ! <pre> ! make install-webconf ! </pre> ! ! <p> ! Create a <i>nagiosadmin</i> account for logging into the Nagios web interface. Remember the password you assign to this account - you'll need it later. ! </p> ! ! <pre> ! htpasswd2 -c /usr/local/nagios/etc/htpasswd.users nagiosadmin ! </pre> ! ! <p> ! Restart Apache to make the new settings take effect. ! </p> ! ! <pre> ! service apache2 restart ! </pre> ! ! <p> ! <strong><u>6) Compile and Install the Nagios Plugins</u></strong> ! </p> ! ! <p> ! Extract the Nagios plugins source code tarball. ! </p> ! ! <pre> ! cd ~/downloads ! tar xzf nagios-plugins-1.4.11.tar.gz ! cd nagios-plugins-1.4.11 ! </pre> ! ! <p> ! Compile and install the plugins. ! </p> ! ! <pre> ! ./configure --with-nagios-user=nagios --with-nagios-group=nagios ! make ! make install ! </pre> ! ! ! <p> ! <strong><u>7) Start Nagios</u></strong> ! </p> ! ! <p> ! Add Nagios to the list of system services and have it automatically start when the system boots. ! </p> ! ! <pre> ! chkconfig --add nagios ! chkconfig nagios on ! </pre> ! ! <p> ! Verify the sample Nagios configuration files. ! </p> ! ! <pre> ! /usr/local/nagios/bin/nagios -v /usr/local/nagios/etc/nagios.cfg ! </pre> ! ! <p> ! If there are no errors, start Nagios. ! </p> ! ! <pre> ! service nagios start ! </pre> ! ! <p> ! <strong><u>8) Login to the Web Interface</u></strong> ! </p> ! ! <p> ! You should now be able to access the Nagios web interface at the URL below. You'll be prompted for the username (<i>nagiosadmin</i>) and password you specified earlier. ! </p> ! ! <pre> ! http://localhost/nagios/ ! </pre> ! ! <p> ! Click on the "Service Detail" navbar link to see details of what's being monitored on your local machine. It will take a few minutes for Nagios to check all the services associated with your machine, as the checks are spread out over time. ! </p> ! ! <p> ! <strong><u>9) Other Modifications</u></strong> ! </p> ! ! <p> ! Make sure your machine's firewall rules are configured to allow access to the web server if you want to access the Nagios interface remotely. ! </p> ! ! <p> ! You can do this by: ! </p> ! ! <ul> ! <li>Opening the control center</li> ! <li>Select 'Open Administrator Settings' to open the YaST administrator control center</li> ! <li>Select 'Firewall' from the 'Security and Users' category</li> ! <li>Click the 'Allowed Services' option in the Firewall Configuration window ! <li>Add 'HTTP Server' to the allowed services list for the 'External Zone'</li> ! <li>Click 'Next' and 'Accept' to activate the new firewall settings</li> ! </ul> ! ! <p> ! Configuring email notifications is outside the scope of this documentation. Refer to your system documentation, search the web, or look to the <a href="http://www.nagioscommunity.org/wiki">NagiosCommunity.org wiki</a> for specific instructions on configuring your openSUSE system to send email messages to external addresses. ! </p> ! ! ! <hr> ! ! </body> </html> \ No newline at end of file Index: quickstart-fedora.html =================================================================== RCS file: /cvsroot/nagios/nagios/html/docs/quickstart-fedora.html,v retrieving revision 1.20 retrieving revision 1.21 diff -C2 -d -r1.20 -r1.21 *** quickstart-fedora.html 25 Jun 2008 18:16:33 -0000 1.20 --- quickstart-fedora.html 15 Oct 2008 22:52:09 -0000 1.21 *************** *** 1,371 **** ! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> ! ! <html> ! <head> ! <title>Fedora Quickstart</title> ! ! <STYLE type="text/css"> ! <!-- ! .Default { font-family: verdana,arial,serif; font-size: 8pt; } ! .PageTitle { font-family: verdana,arial,serif; font-size: 16pt; font-weight: bold; } ! --> ! </STYLE> ! ! </head> ! ! <body bgcolor="#FFFFFF" text="black" class="Default"> ! ! <div align="center"> ! <img src="images/nagios.jpg" border="0" alt="Nagios" title="Nagios"> ! <h1 class="PageTitle">Fedora Quickstart</h1> ! </div> ! ! <hr> ! ! <p> ! <img src="images/upto.gif" border="0" align="middle" alt="Up To" title="Up To">Up To: <a href="toc.html">Contents</a><br> ! <img src="images/seealso.gif" border="0" align="middle" alt="See Also" title="See Also"> See Also: <a href="quickstart.html">Quickstart Installation Guides</a> ! </p> ! ! <p> ! <strong><u>Introduction</u></strong> ! </p> ! ! <p> ! This guide is intended to provide you with simple instructions on how to install Nagios from source (code) on Fedora and have it monitoring your local machine inside of 20 minutes. No advanced installation options are discussed here - just the basics that will work for 95% of users who want to get started. ! </p> ! ! <p> ! These instructions were written based on a standard <b>Fedora Core 6</b> Linux distribution. ! </p> ! ! <p> ! <strong><u>What You'll End Up With</u></strong> ! </p> ! ! <p> ! If you follow these instructions, here's what you'll end up with: ! </p> ! ! <ul> ! <li>Nagios and the plugins will be installed underneath /usr/local/nagios</li> ! <li>Nagios will be configured to monitor a few aspects of your local system (CPU load, disk usage, etc.)</li> ! <li>The Nagios web interface will be accessible at http://localhost/nagios/</li> ! </ul> ! ! <p> ! <strong><u>Prerequisites</u></strong> ! </p> ! ! <p> ! During portions of the installation you'll need to have <b>root</b> access to your machine. ! </p> ! ! <p> ! Make sure you've installed the following packages on your Fedora installation before continuing. ! </p> ! ! <ul> ! <li>Apache</li> ! <li>GCC compiler</li> ! <li><a href="http://www.boutell.com/gd/">GD</a> development libraries</li> ! </ul> ! ! <p> ! You can use <i>yum</i> to install these packages by running the following commands (as root): ! </p> ! ! <pre> ! yum install httpd ! yum install gcc ! yum install glibc glibc-common ! yum install gd gd-devel ! </pre> ! ! <p> ! <strong><u>1) Create Account Information</u></strong> ! </p> ! ! <p> ! Become the root user. ! </p> ! ! <pre> ! su -l ! </pre> ! ! <p> ! Create a new <i>nagios</i> user account and give it a password. ! </p> ! ! <pre> ! /usr/sbin/useradd -m nagios ! passwd nagios ! </pre> ! ! <p> ! Create a new <i>nagcmd</i> group for allowing external commands to be submitted through the web interface. Add both the nagios user and the apache user to the group. ! </p> ! ! <pre> ! /usr/sbin/groupadd nagcmd ! /usr/sbin/usermod -G nagcmd nagios ! /usr/sbin/usermod -G nagcmd apache ! </pre> ! ! <p> ! <strong><u>2) Download Nagios and the Plugins</u></strong> ! </p> ! ! <p> ! Create a directory for storing the downloads. ! </p> ! ! <pre> ! mkdir ~/downloads ! cd ~/downloads ! </pre> ! ! <p> ! Download the source code tarballs of both Nagios and the Nagios plugins (visit <a href="http://www.nagios.org/download/">http://www.nagios.org/download/</a> for links to the latest versions). At the time of writing, the latest versions of Nagios and the Nagios plugins were 3.0.3 and 1.4.11, respectively. ! </p> ! ! <pre> ! wget http://osdn.dl.sourceforge.net/sourceforge/nagios/nagios-3.0.2.tar.gz ! wget http://osdn.dl.sourceforge.net/sourceforge/nagiosplug/nagios-plugins-1.4.11.tar.gz ! </pre> ! ! <p> ! <strong><u>3) Compile and Install Nagios</u></strong> ! </p> ! ! <p> ! Extract the Nagios source code tarball. ! </p> ! ! <pre> ! cd ~/downloads ! tar xzf nagios-3.0.2.tar.gz ! cd nagios-3.0.2 ! </pre> ! ! <p> ! Run the Nagios configure script, passing the name of the group you created earlier like so: ! </p> ! ! <pre> ! ./configure --with-command-group=nagcmd ! </pre> ! ! <p> ! Compile the Nagios source code. ! </p> ! ! <pre> ! make all ! </pre> ! ! <p> ! Install binaries, init script, sample config files and set permissions on the external command directory. ! </p> ! ! <pre> ! make install ! make install-init ! make install-config ! make install-commandmode ! </pre> ! ! <p> ! Don't start Nagios yet - there's still more that needs to be done... ! </p> ! ! <p> ! <strong><u>4) Customize Configuration</u></strong> ! </p> ! ! <p> ! Sample <a href="config.html">configuration files</a> have now been installed in the <i>/usr/local/nagios/etc</i> directory. These sample files should work fine for getting started with Nagios. You'll need to make just one change before you proceed... ! </p> ! ! <p> ! Edit the <i>/usr/local/nagios/etc/objects/contacts.cfg</i> config file with your favorite editor and change the email address associated with the <i>nagiosadmin</i> contact definition to the address you'd like to use for receiving alerts. ! </p> ! ! <pre> ! vi /usr/local/nagios/etc/objects/contacts.cfg ! </pre> ! ! <p> ! <strong><u>5) Configure the Web Interface</u></strong> ! </p> ! ! <p> ! Install the Nagios web config file in the Apache conf.d directory. ! </p> ! ! <pre> ! make install-webconf ! </pre> ! ! <p> ! Create a <i>nagiosadmin</i> account for logging into the Nagios web interface. Remember the password you assign to this account - you'll need it later. ! </p> ! ! <pre> ! htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin ! </pre> ! ! <p> ! Restart Apache to make the new settings take effect. ! </p> ! ! <pre> ! service httpd restart ! </pre> ! ! ! ! <p> ! <strong><u>6) Compile and Install the Nagios Plugins</u></strong> ! </p> ! ! <p> ! Extract the Nagios plugins source code tarball. ! </p> ! ! <pre> ! cd ~/downloads ! tar xzf nagios-plugins-1.4.11.tar.gz ! cd nagios-plugins-1.4.11 ! </pre> ! ! <p> ! Compile and install the plugins. ! </p> ! ! <pre> ! ./configure --with-nagios-user=nagios --with-nagios-group=nagios ! make ! make install ! </pre> ! ! ! <p> ! <strong><u>7) Start Nagios</u></strong> ! </p> ! ! <p> ! Add Nagios to the list of system services and have it automatically start when the system boots. ! </p> ! ! <pre> ! chkconfig --add nagios ! chkconfig nagios on ! </pre> ! ! <p> ! Verify the sample Nagios configuration files. ! </p> ! ! <pre> ! /usr/local/nagios/bin/nagios -v /usr/local/nagios/etc/nagios.cfg ! </pre> ! ! <p> ! If there are no errors, start Nagios. ! </p> ! ! <pre> ! service nagios start ! </pre> ! ! <p> ! <strong><u>8) Modify SELinux Settings</u></strong> ! </p> ! ! <p> ! Fedora ships with SELinux (Security Enhanced Linux) installed and in Enforcing mode by default. This can result in "Internal Server Error" messages when you attempt to access the Nagios CGIs. ! </p> ! ! <p> ! See if SELinux is in Enforcing mode. ! </p> ! ! <pre> ! getenforce ! </pre> ! ! <p> ! Put SELinux into Permissive mode. ! </p> ! ! <pre> ! setenforce 0 ! </pre> ! ! <p> ! To make this change permanent, you'll have to modify the settings in <i>/etc/selinux/config</i> and reboot. ! </p> ! ! <p> ! Instead of disabling SELinux or setting it to permissive mode, you can use the following command to run the CGIs under SELinux enforcing/targeted mode: ! </p> ! ! <pre> ! chcon -R -t httpd_sys_content_t /usr/local/nagios/sbin/ ! chcon -R -t httpd_sys_content_t /usr/local/nagios/share/ ! </pre> ! ! <p> ! For information on running the Nagios CGIs under Enforcing mode with a targeted policy, visit the NagiosCommunity.org wiki at <a href="http://www.nagioscommunity.org/wiki">http://www.nagioscommunity.org/wiki</a>. ! </p> ! ! <p> ! <strong><u>9) Login to the Web Interface</u></strong> ! </p> ! ! <p> ! You should now be able to access the Nagios web interface at the URL below. You'll be prompted for the username (<i>nagiosadmin</i>) and password you specified earlier. ! </p> ! ! <pre> ! http://localhost/nagios/ ! </pre> ! ! <p> ! Click on the "Service Detail" navbar link to see details of what's being monitored on your local machine. It will take a few minutes for Nagios to check all the services associated with your machine, as the checks are spread out over time. ! </p> ! ! <p> ! <strong><u>10) Other Modifications</u></strong> ! </p> ! ! <p> ! Make sure your machine's firewall rules are configured to allow access to the web server if you want to access the Nagios interface remotely. ! </p> ! ! <p> ! Configuring email notifications is out of the scope of this documentation. While Nagios is currently configured to send you email notifications, your system may not yet have a mail program properly installed or configured. Refer to your system documentation, search the web, or look to the <a href="http://www.nagioscommunity.org/wiki">NagiosCommunity.org wiki</a> for specific instructions on configuring your system to send email messages to external addresses. More information on notifications can be found <a href="notifications.html">here</a>. ! </p> ! ! <p> ! <strong><u>11) You're Done</u></strong> ! </p> ! ! <p> ! Congratulations! You sucessfully installed Nagios. Your journey into monitoring is just beginning. You'll no doubt want to monitor more than just your local machine, so check out the following docs... ! </p> ! ! <ul> ! <li><a href="monitoring-windows.html">Monitoring Windows machines</a></li> ! <li><a href="monitoring-linux.html">Monitoring Linux/Unix machines</a></li> ! <li><a href="monitoring-netware.html">Monitoring Netware servers</a></li> ! <li><a href="monitoring-routers.html">Monitoring routers/switches</a></li> ! <li><a href="monitoring-publicservices.html">Monitoring publicly available services (HTTP, FTP, SSH, etc.)</a></li> ! </ul> ! ! <hr> ! ! </body> </html> \ No newline at end of file --- 1,371 ---- ! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> ! ! <html> ! <head> ! <title>Fedora Quickstart</title> ! ! <STYLE type="text/css"> ! <!-- ! .Default { font-family: verdana,arial,serif; font-size: 8pt; } ! .PageTitle { font-family: verdana,arial,serif; font-size: 16pt; font-weight: bold; } ! --> ! </STYLE> ! ! </head> ! ! <body bgcolor="#FFFFFF" text="black" class="Default"> ! ! <div align="center"> ! <img src="images/nagios.jpg" border="0" alt="Nagios" title="Nagios"> ! <h1 class="PageTitle">Fedora Quickstart</h1> ! </div> ! ! <hr> ! ! <p> ! <img src="images/upto.gif" border="0" align="middle" alt="Up To" title="Up To">Up To: <a href="toc.html">Contents</a><br> ! <img src="images/seealso.gif" border="0" align="middle" alt="See Also" title="See Also"> See Also: <a href="quickstart.html">Quickstart Installation Guides</a> ! </p> ! ! <p> ! <strong><u>Introduction</u></strong> ! </p> ! ! <p> ! This guide is intended to provide you with simple instructions on how to install Nagios from source (code) on Fedora and have it monitoring your local machine inside of 20 minutes. No advanced installation options are discussed here - just the basics that will work for 95% of users who want to get started. ! </p> ! ! <p> ! These instructions were written based on a standard <b>Fedora Core 6</b> Linux distribution. ! </p> ! ! <p> ! <strong><u>What You'll End Up With</u></strong> ! </p> ! ! <p> ! If you follow these instructions, here's what you'll end up with: ! </p> ! ! <ul> ! <li>Nagios and the plugins will be installed underneath /usr/local/nagios</li> ! <li>Nagios will be configured to monitor a few aspects of your local system (CPU load, disk usage, etc.)</li> ! <li>The Nagios web interface will be accessible at http://localhost/nagios/</li> ! </ul> ! ! <p> ! <strong><u>Prerequisites</u></strong> ! </p> ! ! <p> ! During portions of the installation you'll need to have <b>root</b> access to your machine. ! </p> ! ! <p> ! Make sure you've installed the following packages on your Fedora installation before continuing. ! </p> ! ! <ul> ! <li>Apache</li> ! <li>GCC compiler</li> ! <li><a href="http://www.boutell.com/gd/">GD</a> development libraries</li> ! </ul> ! ! <p> ! You can use <i>yum</i> to install these packages by running the following commands (as root): ! </p> ! ! <pre> ! yum install httpd ! yum install gcc ! yum install glibc glibc-common ! yum install gd gd-devel ! </pre> ! ! <p> ! <strong><u>1) Create Account Information</u></strong> ! </p> ! ! <p> ! Become the root user. ! </p> ! ! <pre> ! su -l ! </pre> ! ! <p> ! Create a new <i>nagios</i> user account and give it a password. ! </p> ! ! <pre> ! /usr/sbin/useradd -m nagios ! passwd nagios ! </pre> ! ! <p> ! Create a new <i>nagcmd</i> group for allowing external commands to be submitted through the web interface. Add both the nagios user and the apache user to the group. ! </p> ! ! <pre> ! /usr/sbin/groupadd nagcmd ! /usr/sbin/usermod -G nagcmd nagios ! /usr/sbin/usermod -G nagcmd apache ! </pre> ! ! <p> ! <strong><u>2) Download Nagios and the Plugins</u></strong> ! </p> ! ! <p> ! Create a directory for storing the downloads. ! </p> ! ! <pre> ! mkdir ~/downloads ! cd ~/downloads ! </pre> ! ! <p> ! Download the source code tarballs of both Nagios and the Nagios plugins (visit <a href="http://www.nagios.org/download/">http://www.nagios.org/download/</a> for links to the latest versions). At the time of writing, the latest versions of Nagios and the Nagios plugins were 3.0.3 and 1.4.11, respectively. ! </p> ! ! <pre> ! wget http://osdn.dl.sourceforge.net/sourceforge/nagios/nagios-3.0.4.tar.gz ! wget http://osdn.dl.sourceforge.net/sourceforge/nagiosplug/nagios-plugins-1.4.11.tar.gz ! </pre> ! ! <p> ! <strong><u>3) Compile and Install Nagios</u></strong> ! </p> ! ! <p> ! Extract the Nagios source code tarball. ! </p> ! ! <pre> ! cd ~/downloads ! tar xzf nagios-3.0.2.tar.gz ! cd nagios-3.0.2 ! </pre> ! ! <p> ! Run the Nagios configure script, passing the name of the group you created earlier like so: ! </p> ! ! <pre> ! ./configure --with-command-group=nagcmd ! </pre> ! ! <p> ! Compile the Nagios source code. ! </p> ! ! <pre> ! make all ! </pre> ! ! <p> ! Install binaries, init script, sample config files and set permissions on the external command directory. ! </p> ! ! <pre> ! make install ! make install-init ! make install-config ! make install-commandmode ! </pre> ! ! <p> ! Don't start Nagios yet - there's still more that needs to be done... ! </p> ! ! <p> ! <strong><u>4) Customize Configuration</u></strong> ! </p> ! ! <p> ! Sample <a href="config.html">configuration files</a> have now been installed in the <i>/usr/local/nagios/etc</i> directory. These sample files should work fine for getting started with Nagios. You'll need to make just one change before you proceed... ! </p> ! ! <p> ! Edit the <i>/usr/local/nagios/etc/objects/contacts.cfg</i> config file with your favorite editor and change the email address associated with the <i>nagiosadmin</i> contact definition to the address you'd like to use for receiving alerts. ! </p> ! ! <pre> ! vi /usr/local/nagios/etc/objects/contacts.cfg ! </pre> ! ! <p> ! <strong><u>5) Configure the Web Interface</u></strong> ! </p> ! ! <p> ! Install the Nagios web config file in the Apache conf.d directory. ! </p> ! ! <pre> ! make install-webconf ! </pre> ! ! <p> ! Create a <i>nagiosadmin</i> account for logging into the Nagios web interface. Remember the password you assign to this account - you'll need it later. ! </p> ! ! <pre> ! htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin ! </pre> ! ! <p> ! Restart Apache to make the new settings take effect. ! </p> ! ! <pre> ! service httpd restart ! </pre> ! ! ! ! <p> ! <strong><u>6) Compile and Install the Nagios Plugins</u></strong> ! </p> ! ! <p> ! Extract the Nagios plugins source code tarball. ! </p> ! ! <pre> ! cd ~/downloads ! tar xzf nagios-plugins-1.4.11.tar.gz ! cd nagios-plugins-1.4.11 ! </pre> ! ! <p> ! Compile and install the plugins. ! </p> ! ! <pre> ! ./configure --with-nagios-user=nagios --with-nagios-group=nagios ! make ! make install ! </pre> ! ! ! <p> ! <strong><u>7) Start Nagios</u></strong> ! </p> ! ! <p> ! Add Nagios to the list of system services and have it automatically start when the system boots. ! </p> ! ! <pre> ! chkconfig --add nagios ! chkconfig nagios on ! </pre> ! ! <p> ! Verify the sample Nagios configuration files. ! </p> ! ! <pre> ! /usr/local/nagios/bin/nagios -v /usr/local/nagios/etc/nagios.cfg ! </pre> ! ! <p> ! If there are no errors, start Nagios. ! </p> ! ! <pre> ! service nagios start ! </pre> ! ! <p> ! <strong><u>8) Modify SELinux Settings</u></strong> ! </p> ! ! <p> ! Fedora ships with SELinux (Security Enhanced Linux) installed and in Enforcing mode by default. This can result in "Internal Server Error" messages when you attempt to access the Nagios CGIs. ! </p> ! ! <p> ! See if SELinux is in Enforcing mode. ! </p> ! ! <pre> ! getenforce ! </pre> ! ! <p> ! Put SELinux into Permissive mode. ! </p> ! ! <pre> ! setenforce 0 ! </pre> ! ! <p> ! To make this change permanent, you'll have to modify the settings in <i>/etc/selinux/config</i> and reboot. ! </p> ! ! <p> ! Instead of disabling SELinux or setting it to permissive mode, you can use the following command to run the CGIs under SELinux enforcing/targeted mode: ! </p> ! ! <pre> ! chcon -R -t httpd_sys_content_t /usr/local/nagios/sbin/ ! chcon -R -t httpd_sys_content_t /usr/local/nagios/share/ ! </pre> ! ! <p> ! For information on running the Nagios CGIs under Enforcing mode with a targeted policy, visit the NagiosCommunity.org wiki at <a href="http://www.nagioscommunity.org/wiki">http://www.nagioscommunity.org/wiki</a>. ! </p> ! ! <p> ! <strong><u>9) Login to the Web Interface</u></strong> ! </p> ! ! <p> ! You should now be able to access the Nagios web interface at the URL below. You'll be prompted for the username (<i>nagiosadmin</i>) and password you specified earlier. ! </p> ! ! <pre> ! http://localhost/nagios/ ! </pre> ! ! <p> ! Click on the "Service Detail" navbar link to see details of what's being monitored on your local machine. It will take a few minutes for Nagios to check all the services associated with your machine, as the checks are spread out over time. ! </p> ! ! <p> ! <strong><u>10) Other Modifications</u></strong> ! </p> ! ! <p> ! Make sure your machine's firewall rules are configured to allow access to the web server if you want to access the Nagios interface remotely. ! </p> ! ! <p> ! Configuring email notifications is out of the scope of this documentation. While Nagios is currently configured to send you email notifications, your system may not yet have a mail program properly installed or configured. Refer to your system documentation, search the web, or look to the <a href="http://www.nagioscommunity.org/wiki">NagiosCommunity.org wiki</a> for specific instructions on configuring your system to send email messages to external addresses. More information on notifications can be found <a href="notifications.html">here</a>. ! </p> ! ! <p> ! <strong><u>11) You're Done</u></strong> ! </p> ! ! <p> ! Congratulations! You sucessfully installed Nagios. Your journey into monitoring is just beginning. You'll no doubt want to monitor more than just your local machine, so check out the following docs... ! </p> ! ! <ul> ! <li><a href="monitoring-windows.html">Monitoring Windows machines</a></li> ! <li><a href="monitoring-linux.html">Monitoring Linux/Unix machines</a></li> ! <li><a href="monitoring-netware.html">Monitoring Netware servers</a></li> ! <li><a href="monitoring-routers.html">Monitoring routers/switches</a></li> ! <li><a href="monitoring-publicservices.html">Monitoring publicly available services (HTTP, FTP, SSH, etc.)</a></li> ! </ul> ! ! <hr> ! ! </body> </html> \ No newline at end of file |