mrtg-nw-guide man page

mrtg-nw-guide — MRTG for NetWare

Synopsis

This guide is intended to aid in the installation and configuration of MRTG on a NetWare server.

Overview

MRTG is a relative newcomer to the NetWare platform. Earlier versions of NetWare could not run MRTG natively for several reasons:

Support for the NetWare OS has now been fully added into MRTG, beginning with MRTG release 2.12.2.

Liberallly minded operating systems support a commandline length approaching 1000 characters. In such environments it was an easy matter to pass the sometimes high number of parameters used by MRTG's Rateup executable directly on the commandline. Until NetWare 6.5, NetWare had a commandline limit of 512 characters. This limitation was also removed for NetWare 6.0 by Service Pack 5. For other NetWare versions and earlier Service Packs, this limitation remains. To permit a 'standard' interface for NetWare, the Rateup executable has been modified to also read its parameters from a file, and the MRTG script has been modified to support this method on a NetWare platform.  (See New Rateup Switch)

A Rateup NLM is now available, along with the necessary scripts to build it if required. See the  NetWare Support section of this document for further details. Additionally, mrtg.pl has been revised because of the unique (to NetWare) name of executables (NLM).

The absence of a specific installation procedure has caused MRTG to fail in the past because the Perl script could not find or load the Rateup executable. The installation method supplied here will solve this problem for now.

The MRTG.pl script in the 2.12.2 (or later) version of MRTG has been configured to suit all likely versions of NetWare able to use Perl5, and bypasses all of the known problems with NetWare Perl running MRTG.

Prerequisites

You will need the following:

For copies of the .ncf files and Rateup NLM, see NetWare Support in this document.

Installing MRTG

1.

Install the latest Perl 5.8.x release on your server. See the Perl documentation for details.

2.

Create the following directories:

         SYS:/Mrtg
         SYS:/Mrtg/bin
         SYS:/Mrtg/contrib    (Optional for this document)
         SYS:/Mrtg/doc        (Optional for this document)
         SYS:/Mrtg/html
         SYS:/Mrtg/html/images
         SYS:/Mrtg/html/work
         SYS:/Mrtg/lib
         SYS:/Mrtg/logs
         SYS:/Mrtg/translate
3.

Copy from the MRTG package the following files:

 \bin\*        to  SYS:/Mrtg/bin              All files. See Note 1.

Note 1: Add a .pl extension to the mrtg, cfgmaker and indexmaker files. The rateup.exe will NOT be needed on the NetWare server.

 \contrib\*    to  SYS:/Mrtg/contrib/         Include sub-directories
 \doc\*        to  SYS:/Mrtg/doc/             All files
 \images\*     to  SYS:/Mrtg/html/images/     All files
 \translate\*  to  SYS:/Mrtg/translate/       All files. See Note 2.

Note 2: For English-only language support, all \translate files EXCEPT Locales_mrtg may be deleted.

 \lib\*        to  SYS:/Mrtg/lib              Include sub-directories. See Note 3.

Note 3: This will create the SYS:/Mrtg/lib/mrtg2 and ./pod directories.

4.

Create copies of the three .ncf files and install them:

 *.ncf         to  SYS:/Mrtg/bin

See NetWare Support in this document for details on how to create copies of these files.

5.

See Compiling Rateup.nlm"> in this document for details on compiling the Rateup NLM yourself if desired. A prebuit verion is available in the .\mrtg\bin directory where it must remain.

Configuring MRTG

Welcome to MRTG!!

Make MRTG Run All the Time

MRTG can be made to run periodically by at least two means:

CRON Scheduling

To use CRON scheduling, create a CRON Scheduler entry to execute the RunMrtg.ncf file on a frequency appropriate for the server environment and information desired. The following entry in the sys:\etc\crontab file will execute MRTG every five minutes:

 0,5,10,15,20,25,30,35,40,45,50,55 * * * * sys:\mrtg\bin\runmrtg.ncf

The CRON Scheduler (cron.nlm) can be started automatically by adding it in AUTOEXEC.ncf or, manually loading it at the server console.

MRTG in Daemon Mode

Refer to the MRTG-Reference document for information about the 'RunAsDaemon' option. Its use is outside the scope of this document.

Troubleshooting

Read the MRTG documents, Perl documents or, finally, submit questions to the MRTG User forums.

For NetWare specific issues, submit questions to the Perl forum at  news://developer-forums.novell.com/novell.devsup.perl (Novell Developer Forums).

Compiling Rateup.Nlm

In addition to the rateup.c and Makefile.Netware supplied with the MRTG release, you will also need:

The auxiliary libraries can be obtained from:

GD Graphics Library.   (See http://www.boutell.com/gd/ )

PNG Graphics Library.   (See http://libpng.sourceforge.net/ )

zLib Compression Library.   (See http://www.gzip.org/zlib/ )

Edit the Makefile.Netware file as required to match your installation paths; search the file for the key word 'Edit'.

Netware Support

For copies of the NCF and get_ver.awk scripts, see Appendix.

For NetWare specific issues, submit questions to the Perl forum at  news://developer-forums.novell.com/novell.devsup.perl (Novell Developer Forums).

To move the MRTG application to a volume other than SYS: you will need to edit the NCF scripts provided plus the MRTG[.pl] script itself in two places.

New Rateup Switch

The MRTG[.pl] script, when used on a NetWare platform, uses Rateup[.nlm] with the new commandline switch:

     RATEUP -f filename

where the filename parameter can include a leading path element.

The file format is exactly the same as that used on the commandline by other operating systems, including the leading path and name of the Rateup NLM.

Appendix

The Appendix includes 'copies' of the following files:

To create copies of these files, simply 'cut and paste' into your favourite 'text editor' and save under their respective names. You should remove the leading space from each line.

MakeMrtgCfg.NCF

 # MakeMrtgCfg.NCF
 # Purpose : Create the MRTG Configuration File
 # Changed :  5/05/2005  New
 # Located : SYS:MRTG\BIN
 # Set For : 
 # Params  : 

 # Edit this file and:

 # Replace ccccc with your device GET SNMP Community Name - If unsure try 'public'.
 # Replace ddddd with your device IP (n.n.n.n) or domain name.

 perl --noscreen sys:\mrtg\bin\cfgmaker.pl ccccc@ddddd > sys:\mrtg\bin\Mrtg.cfg

 #
 # End of MakeMrtgCfg.NCF

RunMrtg.NCF

 # RunMrtg.NCF
 # Purpose : Run the MRTG Application
 # Changed :  5/05/2005  New
 # Located : SYS:MRTG\BIN
 # Set For : 
 # Params  : 

 # The paths are as per the examples recommended in "Getting Started".

 perl --noscreen sys:\mrtg\bin\mrtg.pl sys:\mrtg\bin\mrtg.cfg

 #
 # End of RunMrtg.NCF

MakeMrtgIndex.NCF

 # MakeMrtgIndex.NCF
 # Purpose : Create the HTML Index File for MRTG HTML data pages
 # Changed :  5/05/2005  New
 # Located : SYS:MRTG\BIN
 # Set For : 
 # Params  : 

 # Note: Edit this file and change the redirected output to the location
 #       specified for HtmlDir or WorkDir. The sys:\apache2\htdocs\mrtg\index.html
 #       is based on the examples in "Getting Started".

 perl --noscreen sys:\mrtg\bin\indexmaker.pl sys:\mrtg\bin\Mrtg.cfg > sys:\mrtg\html\index.html

 #
 # End of MakeMrtgIndex.NCF

License

GNU General Public License

Credits

The MRTG for NetWare exists largely through the efforts of Guenter Knauf and feedback from beta testers.

Author

Norm W..

Info

2012-01-12 2.17.4 mrtg