vSTREAM Embedded on Linux

Introduction

 

 

 

This is a simplified installation procedure that has been thoroughly tested by our engineers.  It meets most customer's needs and can be trusted for installation of vSTREAM Embedded on any Linux-based host.  The complete and detailed installation guide can be found on MyNetscout.  We've installed vSTREAM Embedded with success on both physical and virtual servers. 

 

Solution

Before you install

We do not want to use most of the default communication ports because they are too common and may be used by other processes on the target host, now or in the future.

We want to display a name for the vSTREAM Embedded in Device Configuration different from the uuid. We suggest to use the hostname of the target host.

In most cases the IP address of the nGeniusONE server is already known.

We can put all these modifications in a couple of text files and make the installation silent and ready to be scripted !

Pre-configuration files

Create the file /tmp/nsagent_config.cfg with the following content. Replace A.B.C.D with the IP address of the nGeniusONE (Local) Server.

# vi /tmp/nsagent_config.cfg

export NSCOMM_PORT=395
export NSCONSOLE_PORT=7501
export HTTP_PORT=7080
export HTTPS_PORT=7443
export NSCONFIG_SERVER_IP=A.B.C.D 

(save and exit with ":wq")

Create the file /tmp/nsprobeid with the following content. Replace HOSTNAME with the actual hostname or any value you need to proper identify this vSTREAM Enbedden in nGeniusONE. The name can be up to 127 characters but in can only contain alphanumerical characters, period (.) and hyphen (-).

# vi /tmp/nsagent_config.cfg

HOSTNAME

(save and exit with ":wq")

Installation

Copy the most recent version of the rpm to the /tmp directory on the target host. It is recommended to keep the original file name for reference.

# cd /tmp
# wget https://comcert.box.com/shared/static/something.rpm
# mv something.rpm is-6110-668-vSTREAM_EMB.x86_64.rpm
# md5sum is-6110-668-vSTREAM_EMB.x86_64.rpm

Run the rpm. There are no dependencies to be installed.

# yum localinstall is-6110-668-vSTREAM_EMB.x86_64.rpm --nogpgcheck

 

Firewall

If there is a firewall on the target host, the installer will try to open those ports specified in /usr/lib/NetScout/rtm/config/nsagent_config.cfg.  You may have to configure additional security software to keep these ports from closing again.

 

Service

Check if the vSCOUT-Emb service is running

# systemctl status vscout-emb

Stop/Start/Restart the service with the following commands

# systemctl stop vscout-emb
# systemctl start vscout-emb
or
# systemctl restart vscout-emb

 

Modifying the configuration

If for any reason the configuration needs to be modified, edit this file and restart the agent

# vi /usr/lib/NetScout/rtm/config/nsagent_config.cfg

(save and exit with ":wq")