## Installing The Web Interface

Notes

In these instructions I will assume that you are running the Apache web server on your machine. If you are using some other web server, you'll have to make changes where appropriate.

Configuring Aliases For The HTML Files And CGIs

In order to make the HTML files and CGIs accessible via the web, you'll have to edit your Apache web server configuration as follows...

Add a line in the httpd.conf file as follows (change to match the directory structure for you installation)...

Alias /netsaint/ /usr/local/netsaint/share/

This will allow you to use an URL like http://yourmachine/netsaint/ to view the HTML web interface and documentation. The alias should be the same value that you entered for the --with-htmurl argument to the configure script (default is /netsaint/).

You'll need to create an alias for the NetSaint CGIs as well. The default installation expects to find them within http://yourmachine/cgi-bin/netsaint/, although this can be changed using the --with-cgiurl option in the configure script. Anyway, add something like the following to your httpd.conf file (changing it to match any directory differences on your system)...

ScriptAlias /cgi-bin/netsaint/ /usr/local/netsaint/sbin/

Important: The ScriptAlias entry for the NetSaint CGIs must precede the standard 'ScriptAlias /cgi-bin/ /some...where../' directive already present in the configuration file. If it doesn't, you will most likely be unable to access the CGIs.

Once you've editing the Apache configuration file, you'll need to restart the web server with a command like this...

/etc/rc.d/init.d/httpd restart

Once you've gotten the web server restarted, there is just one minor thing you need to verify. Check the CGI configuration file (nscgi.cfg) in the etc/ subdirectory of your NetSaint installation and verify that the main_config_file variable points to the correct location of the main configuration file on your system. The CGIs will need to know this in order to find your current status log, history log, etc.

Don't forget to check and see if the changes you made to Apache work. You should be able to point your web browser at http://yourmachine/netsaint and get the web interface for NetSaint. The CGIs may not display any information, but this will be remedied once you configure web server authentication for the CGIs and start NetSaint.

Where To Go From Here

Once you have configured the web interface properly, you'll need to enable web server authentication for accessing the CGIs and configure user authorization information. Details on doing this can be found here.