NetSaint 0.0.7 Quick-and-Dirty Installation Instructions -------------------------------------------------------- I would highly recommend using a web browser to read the documentation and installation instructions in the html/docs directory. They provide a much better overview of how to configure NetSaint. This is especially important due to the new CGI authorization requirements. *** IMPORTANT *** Plugins are no longer distributed with the core NetSaint distribution. However, plugins are required if you actually want to use NetSaint. You'll have to download any plugins you want to use from the main website, compile them, and install them before you can actually start using NetSaint. Plugins can be obtained from the downloads page at http://www.netsaint.org or from the SourceForge project page at http://netsaintplug.sourceforge.net Compiling The Binaries ---------------------- 1) Run the configure script to initialize variables and create a Makefile, etc. ./configure --prefix=PREFIX --with-cgiurl=CGIURL --with-htmurl=HTMURL --with-netsaint-user=SOMEUSER --with-netsaint-grp=SOMEGROUP a) Replace PREFIX with the base directory under which NetSaint should be installed. Default is '/usr/local/netsaint' b) Replace CGIURL with the base URL that you will be using to access the CGIs. Do NOT include a trailing slash. Default is '/cgi-bin/netsaint' c) Replace HTMURL with the base URL that you will be using to access the html documentation and main interface. Default is '/netsaint' d) Replace SOMEUSER with the name of the user on your system that will be given permissions to the NetSaint directories and files. Default is 'netsaint' e) Replace SOMEGROUP with the name of the group on your system that will be given permissions to the NetSaint directories and files. Default is 'netsaint' Notes: There are also --with-command-user and --with-command-grp options that can be specified. These are used when installing the directory that will hold the external command file. For more information on external commands, read the HTML documentation. 2) Compile NetSaint and the CGIs with the following command: make all Installing The Binaries ----------------------- 1) Install the binaries and HTML documentations with the following command: make install Creating And Installing Sample Config Files ------------------------------------------- Sample main, host, resource, and CGI configuration files are automatically created in your distribution distribution directory after you run the configure script. The files are named 'netsaint.cfg', 'hosts.cfg', 'resource.cfg', and 'nscgi.cfg' respectively. 1) If you want, you can install the sample config files into the {prefix}/etc directory with the following command: make install-config Installing The Init Script -------------------------- 1) If you want to install and init script for starting NetSaint, use the following command: make install-init 2) ...or if you want to run NetSaint in daemon mode, use the following command: make install-daemoninit Everything Else --------------- 1) You'll have to download and install plugins for use with NetSaint. Plugins can be obtained from the downloads page at http://www.netsaint.org of from the SourceForge project page at http://netsaintplug.sourceforge.net 2) You'll have to edit your main, host, resource, and CGI config files in order to fit your system setup and define what hosts and service you want to monitor. Read the HTML docs on how to do this and look at the sample config files. 3) If you plan on using the CGIs, you'll have to read the HTML documentation on configuring you web server properly and CGI authentication and authorization. These are a must to read! That's it! If you have problems or questions, read all of the HTML documentation, particularly the sections on the configuration files and CGI authentication before reporting problems. Unless you feel that your problem can only be answered by me, try posting a message to the appropriate mailing list. -- Ethan Galstad (netsaint@netsaint.org)