vSTREAM Embedded on Linux
Introduction
Its is not recommended to install vSTREAM Embedded on a host with less than two CPU and less than two GB of memory. |
Installing or removing vSTREAM Embedded does not require a restart of the host's operating system or any service other that the vSTREAM Agent service. |
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 Agent successfully on both physical and virtual servers.
We kept the overhead and comments to a minimum. For detailed information, please read the guide mentionned above.
Solution
Before you install
Some considefrations before you start:
- We do not want to use Netscout's default communication ports because they are too common and may be in use on the target host, now or in the future.
- We want to display a name for the vSTREAM Embedded in Device Configuration that differs from the UUIS; most customers want to use the name of the host.
- We need to know the IP address of the nGeniusONE server before we start.
All these modifications can be automatically configured if we create a couple of text files. It will make the installation silent and ready to be scripted !
Firewall
Before you start, make sure these ports are open between the host, nGenius Server (NGS) and InfiniStreamNG (IS-NG or vSTREAM-STL). The host is the server you install vSTREAM-EMB on.
From NGS to host:
- tcp/7080
- tcp/7443
- tcp/7501
From host to NGS:
- udp/395
Between host and InfiniStreamNG:
- GRE (IP protocol number 47) or udp/50100
Pre-configuration files
Login as root or sudo to root.
Create a 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")
You MUST specify all four communication ports in this file. Respect the syntax. Failure to do so will make the installation return to its default values.
Create the file /tmp/nsprobeid with the following content. Replace HOSTNAME with the actual hostname or any string value you need to proper identify this vSTREAM Enbedden in nGeniusONE. The name can be up to 127 characters long. It can only contain alphanumerical characters, period (.) and hyphen (-), NO SPACES, NO UNDERSCORE (_), NO SPECIAL CHARACTERS !
# vi /tmp/nsprobeid HOSTNAME (save and exit with ":wq")
Both files MUST have "0644" rights and be owned by "root:root". This should already be the case.
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. If you omit the --prefix argument, the installation directory will be /usr/lib/NetScout/. If you specify for example "--prefix=/opt" vSTREAM Embedded will be installed in /opt/NetScout/
# yum localinstall is-6110-668-vSTREAM_EMB.x86_64.rpm --nogpgcheck --prefix=<target directory>
Clean-up
Remove all installation and configuration files from the /tmp directory immediately after verifying if the vSTREAM Embedded is working properly.
Service
Check if the vSCOUT-Emb service is running:
# systemctl status vstream-emb
Stop/Start/Restart the service with the following commands:
# systemctl stop vstream-emb # systemctl start vstream-emb or # systemctl restart vstream-emb
Clean-up
We recommend removing all the files from the /tmp direcotory immediately after verification.
Modifying the configuration
If for any reason the configuration needs to be modified, edit this file and restart the agent.
# vi <target directory>/NetScout/rtm/config/nsagent_config.cfg (save and exit with ":wq")