Applies To:
  • CitectSCADA 5.31, 5.40, 5.41, 5.42, 5.50, 6.0, 6.1, 7.0
  • CitectHMI 5.31, 5.40, 5.41, 5.42, 5.50, 6.0, 6.1, 7.0
  • CitectFacilities 5.31, 5.40, 5.41, 5.42, 5.50, 6.0, 6.1, 7.0
  • CitectSCADA Batch 5.31, 5.40, 5.41, 5.42, 5.50, 6.0, 6.1, 7.0
  • CitectSCADA Pocket 5.31, 5.40, 5.41, 5.42, 5.50, 6.0, 6.1, 7.0

Summary:
This KB explains how to deploy open source software (Multi Router Traffic Grapher (MRTG) to monitor the health of Citect Servers and Clients on the network LAN. 

perl mrtg mrtg.cfg
Running as Deamon
in the mrtg.cfg file, add the following line:


RunAsDaemon: yes
At your command prompt, enter the following:


start /Dc:\mrtg-2.16.2\bin perl mrtg --logging=eventlog mrtg.cfg
Configuring IIS 
  1. Open up Internet Information Services (IIS) Start > Settings > Control Panel > Admin Tools > Internet Information Services
  2. Go to Web Sites > Default Web Site, and add a new virtual directory called 'MRTG' and make the local path C:\www\mrtg
  3. In properties > Directory Security > click Edit and tick Anonymous Access (Note: you can lock access back down after testing).  Make sure Windows Integrated Authentication is ticked.
  4. Click OK

Test IIS is serving web pages by putting the following link in your browser:

http://youripaddress/www/mrtg

Then select the interface you wish to view (ending in extn .html) 

Solution:

Before you start, you will need the following:

Installing

To make the most use of MRTG, I would suggest installing it on the machine that the Citect webserver is installed on.  That way, you can make use of the IIS webserver.  This is handy as other clients can access the monitoring data too.
 

Unzip MRTG to C:\mrtg-2.16.2 on the Windows machine of your choice.

Install Perl on the same Windows machine. You might want to make sure that the Perl binary directory is listed in your system path.

C:\Perl\bin;

You can manually check this by going to [Control Panel]->[System]->[Environment]

To see if everything is installed properly you can open a Command Shell and go into c:\mrtg-2.16.2\bin. Type:

perl mrtg

This should give you a friendly error message complaining about the missing MRTG configuration file. Now, you have successfully installed MRTG and Perl.

Configuring MRTG on the Citect IIS webserver

For this example, I will assume the IP address of the IO server we want monitor is 192.168.1.2 with a community string of 'public'.

MRTG will monitor input and output traffic in bytes and CPU load only.  Later I will show how to configure monitoring a particular OID.

We need to make up a config file, get to a cmd prompt and change to the c:\mrtg-2.16.2\bin directory. Type the following command:

perl cfgmaker public@192.168.1.2 --global "WorkDir: c:\www\mrtg" --output mrtg.cfg

This creates an initial MRTG config file for you. If you get any errors, please check your community string and IP address are correct.

In the mrtg.cfg file, add the following to the top:

WorkDir: c:\www\mrtg

Running MRTG

Keywords:
 

Attachments