Installing plugin prerequisites

TrueSight Intelligence provides technology plugins to extend the features of the core product and provide the coverage of multiple 3rd party products. Unlike the TrueSight Meter (which is developed in C language, compiled to native code and fully self-contained), the plugins usually are implemented using a dynamic language such as node.js, Python or Java, and require additional runtime support. Additionally, some plugins are not supported on all platforms supported by Meter.

To install node.js

If a plugin requires node.js support, it should be installed on the host before installing the plugin. The installation method depends on server OS.

Check the installed version

Open your terminal (a.k.a. shell or command line) window and type:

node -v

If the node.js is properly installed, you should see something like:

v0.10.29

TrueSight Intelligence plugins require at least node.js v0.8.0, but as it is backward compatible, more recent versions also work. Additionally, you might want to verify that npm (Node Package Manager) is also installed at your system. Recent versions of node.js packages already include npm, so usually there is no need to install it separately. You can check npm version by typing 

npm -v

If the npm is properly installed, you should see something like:

1.4.24

Installation instructions

Linux and Unix (Debian, Ubuntu, FreeBSD, ...)

Use the relevant package manager to install node.js on your system. See detailed instructions for each OS here: https://github.com/joyent/node/wiki/installing-node.js-via-package-manager

Windows

Download native Windows installer (either 32- or 64-bit) at node.js web site.

Mac OS X

Download native OSX installer at node.js web site.

To install Python

If a plugin requires Python support, it should be installed on the host before installing the plugin. The installation method depends on server OS. Check if you are already have the Python installed and what is its version.

Check installed version

On Windows run the command "python" in command prompt or PowerShell.

On Linux or UNIX run the same "python" command in a terminal.

We need Python v2.6.6 or later

Installation instructions

Linux and Unix (Debian, Ubuntu, FreeBSD, ...)

The latest versions of CentOS, Fedora, Redhat Enterprise (RHEL) and Ubuntu come with Python 2.7 out of the box.

To see which version of Python you have installed, open a command prompt and run

$ python --version

If not installed, type the following command:

$ sudo yum install python

OR

# yum install python

Use the following commands to install Python under Debian and Ubuntu Linux:

First, install some dependencies:

sudo apt-get install build-essential

sudo apt-get install libreadline-gplv2-dev libncursesw5-dev libssl-dev libsqlite3-dev tk-dev libgdbm-dev libc6-dev libbz2-dev

Then download using the following command:
cd ~/Downloads/

wget https://www.python.org/ftp/python/2.7.11/Python-2.7.11.tgz

or download directly from https://www.python.org/downloads/source/

Extract and go to the directory:

tar -xvf Python-2.7.11.tgz
cd Python-2.7.11

Now, install using the following commands:

./configure
make
sudo make install

Windows

Download latest native Python installer for Windows at the Python website .

Mac OS X

Download latest native Python installer for OS X at the Python website .

To install Java

If a plugin requires Java support, it should be installed on the host before installing the plugin. The installation method depends on server OS. Check if you are already have the Java installed and what is its version.

We suggest using latest Java 1.8 and above.

Type java -version to check the installed version.

Installation instructions

See the official Java link for the latest installation instructions based on your platform.

Linux and Unix (Debian, Ubuntu, FreeBSD, ...)

Linux install

Windows

Windows Install - Online

Windows Install - Offline

Mac OS X

Mac OS X Install

Troubleshooting your Java installation

Follow the procedure given below if you encounter the following error:

failed to launch process java: The system cannot find the file specified.

1. Set your system environment variable JAVA_HOME to your currently installed folder.
   For example, C:\Program Files\Java\jdk1.8.0_131
2. Append the system environment variable PATH to your bin file.
   For example, C:\Program Files\Java\jdk1.8.0_131\bin
3. Restart the TrueSight Meter. Use the Windows services program or command prompt.
   For more information, see Starting, stopping, and restarting the meter.