vSTREAM Embedded on Linux: Difference between revisions
No edit summary |
No edit summary |
||
| Line 20: | Line 20: | ||
=== Before you install === | === Before you install === | ||
Some considefrations before you start: | |||
We want to display a name for the vSTREAM Embedded in Device Configuration | *We do not want to use most of the default communication ports because they are too common and may be in use by other processes on the target host | ||
*We want to display a name for the vSTREAM Embedded in Device Configuration on nGeniusONE Server that differs from the uuid; most customers want to use the hostname or FSDN of the target host. | |||
*We know the IP address of the nGeniusONE server before we start installation of vSTREAM Embedded. | |||
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 ! | |||
| |||
=== Pre-configuration files === | |||
Login as root or sudo to root. | |||
Create | 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. | ||
<pre># vi /tmp/nsagent_config.cfg | <pre># vi /tmp/nsagent_config.cfg | ||
| Line 48: | Line 52: | ||
(save and exit with ":wq")</pre> | (save and exit with ":wq")</pre> | ||
Both files must have "0644" rights. This should already be the case. | |||
| |||
=== Installation === | === Installation === | ||
| Line 72: | Line 78: | ||
=== Service === | === Service === | ||
Check if the vSCOUT-Emb service is running | Check if the vSCOUT-Emb service is running: | ||
<pre># systemctl status vscout-emb</pre> | <pre># systemctl status vscout-emb</pre> | ||
Stop/Start/Restart the service with the following commands | Stop/Start/Restart the service with the following commands: | ||
<pre># systemctl stop vscout-emb | <pre># systemctl stop vscout-emb | ||
# systemctl start vscout-emb | # systemctl start vscout-emb | ||
| Line 85: | Line 91: | ||
=== Modifying the configuration === | === Modifying the configuration === | ||
If for any reason the configuration needs to be modified, edit this file and restart the agent | If for any reason the configuration needs to be modified, edit this file and restart the agent. | ||
<pre># vi /usr/lib/NetScout/rtm/config/nsagent_config.cfg | <pre># vi /usr/lib/NetScout/rtm/config/nsagent_config.cfg | ||
(save and exit with ":wq")</pre> | (save and exit with ":wq")</pre> | ||
Revision as of 18:41, 4 June 2019
Introduction
 | Do not install vSTREAM Embedded on a host with less than two CPU and less than two GB of RAM. |
 | Installing or removing vSTREAM Embedded does not require a restart of the host's operating system or any service other that the vSTREAM Embedded 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 Embedded with success on both physical and virtual servers.
Solution
Before you install
Some considefrations before you start:
- We do not want to use most of the default communication ports because they are too common and may be in use by other processes on the target host
- We want to display a name for the vSTREAM Embedded in Device Configuration on nGeniusONE Server that differs from the uuid; most customers want to use the hostname or FSDN of the target host.
- We know the IP address of the nGeniusONE server before we start installation of vSTREAM Embedded.
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 !
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")
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")
Both files must have "0644" rights. 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.
# 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")