12.2. Installation

Installation of sFlowTrend-Pro as a service is done through an installer, obtained from http://www.myinmon.com. Download the appropriate installation file for your system: either Windows, Linux or Mac. For Linux, you can download either an interactive installer, a Debian package (.deb file), or an RPM file, depending on your preference. If you are installing on Windows, Mac or using the interactive installer on Linux, follow the instructions in Section 12.2.1, “Using the interactive installer”. For more information on installing with a Debian or RPM package, see Section 12.2.2, “Installing with a Debian or RPM package”.

After sFlowTrend-Pro is installed, the license must be configured to allow it to be used. When the client first connects to the server, a dialog should automatically pop up to allow you to enter the license number. If it does not, or you would like to change the license, see Section 13.1, “Configuring the license for more information. Note that normally sFlowTrend-Pro will use the Internet to download the license key, once the license number has been entered. If a proxy configuration is required for the server to connect to the Internet, please make sure that the proxy is correctly configured (see Section 13.5.4, “Proxy configuration ). If the system has no Internet connectivity at all, then the license key can be entered manually. First, request a manual license key using a support request at http://www.myinmon.com. Once you have the key, then enter it as described in Section 13.1, “Configuring the license .

12.2.1. Using the interactive installer

On Windows, Mac, or if using the interactive installer on Linux, follow the instructions in this section after downloading the installer file.

On Windows, just run the file by double-clicking it.

On Mac, mount the disk image by double clicking on it, then run the installer contained in the disk image by double clicking on it. Remember to unmount the disk image when finished.

On Linux, you will need to be root to install sFlowTrend-Pro. If you choose to use the interactive installer, run the installer by typing # /bin/sh installer where installer is the file you downloaded. Alternatively make the file executable and then run it.

When you launch the installer, you will be presented with a sequence of installation steps. After the initial welcome screen, you will need to accept the license agreement. Next, choose the directory where you would like to install sFlowTrend-Pro; it is recommended that you accept the default location. In the next screen, you can chose which components to install:

sFlowTrend-Pro service
Select this option to install the service and the local client used to connect to the service on the same system.
sFlowTrend-Pro remote client
Select this option to install the remote client, which you can use to connect to other systems running the service.

You can install both the service and the remote client on the same system, if desired. You must select at least one of the options to complete the installation.

If you selected the service installation, on the next screen you will be prompted for the sFlowTrend-Pro home directory. This is where the database, log files and custom configuration is stored. Using the default directory is recommended, although it can be changed if you would rather use a different location. In particular, please make sure that enough disk space is available to store the database. The disk space required will depend on the type of network traffic seen, and the number of switches being monitored. Several gigabytes will be enough for most installations. Once you have chosen a location, it cannot be changed without reinstalling sFlowTrend-Pro.

The remaining screens allow you to select the menu location to install the shortcuts for launching sFlowTrend-Pro, and then proceed with the installation. After completing the installation, the service is started automatically (if you chose to install it), and you will have the option of immediately launching the client.

12.2.2. Installing with a Debian or RPM package

If you chose to install sFlowTrend-Pro using a Debian or RPM package, then the normal method for installing these files should be followed for your operating system, after downloading them. Note that Java 6.0 must be installed prior to installing sFlowTrend-Pro. When installing sFlowTrend-Pro using a package file, the home directory cannot be changed.

12.2.3. Notes on installing sFlowTrend-Pro as a service under Linux

After completing the installation of sFlowTrend-Pro on Linux as a service, the sFlowTrend-Pro service will be automatically created (as /etc/init.d/sflowtrend-server) and started. The service will also be registered to automatically start when the system is booted, using chkconfig. This is only possible for Linux distributions that use the chkconfig command. Some distributions use other methods for automatically starting services. If the Linux that you are using does not use chkconfig, then you should enter the /etc/init.d/sflowtrend-server service manually as a service to be started at boot time.

If you are installing sFlowTrend-Pro on a system which does not have a graphical user interface, you can either install using a package (see Section 12.2.2, “Installing with a Debian or RPM package”), or using the interactive installer but with a terminal interface. To do this, add the command line option -c to the installer, eg: # /bin/sh installer -c. This will step through the same installation steps that are used for the graphical installer, just using a terminal interface. Please take care to enter the data correctly, as the command line interface is more difficult to use than the graphical interface.

12.2.4. Memory configuration for the sFlowTrend-Pro service

The amount of memory required by the sFlowTrend-Pro service varies considerably, depending on how many sFlow agents are monitored, and the quantity and type of network traffic. The default memory available to the service is generous and suitable for most installations. However, if memory runs low then events will appear in the event log warning of this, and performance of sFlowTrend-Pro may become poor.

To increase the memory available to the service, first go to the bin directory, in the directory on the server where sFlowTrend-Pro was installed. Here there should be a file named sflowtrend-server.vmoptions. Edit this file with a text editor, and add a line to the end with this format:

                -Xmx1800m
                

This will change the memory available to be 1800 MB. The memory can also be reduced in a similar way. After making this change, the sFlowTrend-Pro service must be restarted for the change to take effect.

[Note] Note

It is very important to specify a valid memory configuration. If the directive is incorrectly typed, or has an invalid size of memory, then the sFlowTrend-Pro service will not start. Be aware that with a 32-bit JRE, the maximum memory that can be specified is approximately 1800 MB; if the size is greater than this, then the service will not start. If you are using a 64-bit OS and a 64-bit JRE, then a larger amount can be specified.

12.2.5. Configuring https certificates

To allow https to run on the sFlowTrend-Pro server, an https certificate is required. When the sFlowTrend-Pro service is first started, a default certificate will be installed. If possible, this will use the hostname of the server, or if this cannot be determined, then a generic localhost hostname.

It is possible to configure a different certificate to use for the server, if, for example, you wish to use a certificate signed by a local enterprise certificate authority. To do so, you will need to use the command keytool, which is included with the Java Development Kit (JDK), available from Oracle or the OpenJDK.

First stop the sFlowTrend-Pro service. Then create the keystore to use with keytool. The keystore must contain a trusted certificate entry (including a private key), and should be placed in the sFlowTrend-Pro home directory. You should then create the custom configuration options server.webserver.https.keyStore, server.webserver.https.alias, server.webserver.https.password and server.webserver.https.keyPassword (these are only required if the desired values are different from the defaults). When the sFlowTrend-Pro service is then restarted, the new certificate from the keystore will be used.

If, at any time a new default certificate is required (eg if the system name is changed), just stop the sFlowTrend-Pro service, delete the default keystore, and restart the service. A new default keystore will be automatically created.