Installation instructions for CySight and supported Operating Systems

Tips for CySight Linux Installation

Tips for a Linux Installation

A number of factors affect the installation of CySight in RedHat Enterprise Linux /CentOS platform. We recommend CentOS Minimal installation as the supported platform for NetFlow installation; the installation of any additional packages is not recommended. However, installation of CySight may still succeed if the following tips have been followed:

MySQL
MySQL packages are shipped together in CentOS. However, that version is not compatible with CySight, therefore please make sure mysql package is installed before CySight installation.

Type the command to check if mysql packages installed or not:
rpm -qa | grep -i mysql

To uninstall the existing mysql packages, type the command:
rpm -e --nodeps [package]

Java
gcc Java package is shipped together in CentOS. CySight works with Sun Java only and is not compatible with gcc java. Therefore, gcc java package must be not be installed before CySight installation.

To check the gcc java package, type the command:
rpm -qa | grep -i java

To uninstall the gcc java packages, type the command:
rpm -e --nodeps [package]

perl-DBI
perl-DBI is required for the current version of MySQL package in CySight. perl-DBI is also shipped with CentOS, and if the perl-DBI version is lower than required by CySight, CySight will uninstall the existing one and install the suitable version. However, this may disrupt those packages which depend on the old perl-DBI. To avoid the disruption please either choose Minimal installation when installing CentOS or allocate a dedicated box for CySight.

Path and Permission
CySight need to run certain Linux system commands during installation process. Linux searches the system commands within the directories set up in $PATH environment variable. If $PATH is not configured properly, Linux shell could not found the commands and error messages like 'command not found' will come up. If the Linux user who launches the installation does not have the permissions to run the commands, error messages like 'Permission denied' will show up. In either case the installation will fail.

To ensure a successful installation please make sure root user is used for installation and $PATH is correctly configured.

Cron job
CySight employs Cron as part of its health checking mechanism. During installation, CySight sets up a job in the Cron table, "digitoll.cron". The digitoll.cron job runs a script every 5 minutes to check if CySight service is still running. If the CySight service is not running, the script will automatically restart CySight. The periodical running of the job by the Cron ensures minimal data loss.

When upgrading from v3.6.6 or earlier to v3.6.7 and later, the digitoll.cron Cron job should be disabled. This is because the v3.6.7 (and higher versions) Upgrade Package has to upgrade the physical traffic data tables from v3.6.6. Upgrading these table may take a long time depending on the size of traffic volume and the Upgrade Package should have sole and exclusive access to these data tables. CySight service should be prevented from restarting to avoid access of these table.

After completing the update please ensure that you re-enable the job again to reactivate the digitoll.cron collection protection mechanism.

The command to edit the crontab file is:
crontab -e

Find the lines which contains the text '/usr/local/digitoll/bin/digitoll.cron' to locate the job. This line could be
'0,5,10,15,20,25,30,35,40,45,50,55 * * * * /usr/local/digitoll/bin/digitoll.cron'
for v3.6.8 or earlier
or
'* * * * * /usr/local/digitoll/bin/digitoll.cron'
for v3.6.9.

Press i key to enter Input Mode.

To disable the job, insert a '#' at the beginning of the line;
To enable it again, delete the '#'.

The new cron table will only be activated after it has been saved

Press Esc to exit the Input mode.

Type ':wq' to save and exit.

cron