vSTREAM Embedded on Linux: Difference between revisions
No edit summary |
No edit summary |
||
| Line 146: | Line 146: | ||
=== Rename === | === Rename === | ||
Go to NGS > Console > Device Configuration > Devices and change the name of the | Go to NGS > Console > Device Configuration > Devices and change the name of the vSTREAM EMB from UUID to a more meaningfull name (example IS-<hostname>) before continuing to the next installation. If you have added multiple vSTREAM EMB at once and don't know which is which, the UUID is found at: | ||
<pre>C:\NETSCOUT\vSTREAM-EMB\rtm\config\.uuid</pre> | |||
Example: EDA32E42-F0BC-C14E-EB9C-0F2B74EE9189 becomes IS-CRT-VIR-W-ADDS. | |||
| | ||
Revision as of 14:19, 10 May 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. However, vSTREAM Embedded is supported by Netscout on virtual machines only.
Solution
Installation
Download or copy the most recent version of the .bin installer to a local directory on the target host, for example use wget to copy the installer to the /tmp directory. The file can be safely removed after completion.
# cd /tmp # wget https://comcert.box.com/shared/static/something.bin # mv something.bin is-6110-668-vSTREAM_EMB.bin # md5sum is-6110-668-vSTREAM_EMB.bin # chmod +x is-6110-668-vSTREAM_EMB.bin # ./is-6110-668-vSTREAM_EMB.bin -i console
Should output (example on ubuntu):
vSTREAM-EMB install path selected: /usr/lib/NetScout
Starting installation of vSTREAM-EMB Version : 6.1.1 Build: 668
groupadd: group 'ngenius' already exists
groupadd: group 'vscout_lighttpd' already exists
vSTREAM-EMB installation has been successfully completed...
● vstream-emb.service - SYSV: Starts and stops NETSCOUT vSCOUT probe service
Loaded: loaded (/etc/init.d/vstream-emb; bad; vendor preset: enabled)
Active: active (running) since Tue 2019-05-07 16:26:53 UTC; 11ms ago
Docs: man:systemd-sysv-generator(8)
Process: 29896 ExecStart=/etc/init.d/vstream-emb start (code=exited, status=0/SUCCESS)
Main PID: 30030 (nsprobe)
Tasks: 13
Memory: 346.4M
CPU: 827ms
CGroup: /system.slice/vstream-emb.service
├─30027 /usr/lib/NetScout/rtm/bin/procmanager
├─30030 /usr/lib/NetScout/rtm/bin/nsprobe -r -l -c -G
├─30057 /bin/bash /usr/lib/NetScout/rtm/bin/monvscoutd start
├─30059 /bin/bash /usr/lib/NetScout/rtm/bin/monvscoutd start
├─30061 ps -aux
├─30062 grep monvscout.sh
└─30063 wc -l
May 07 16:26:39 ip-10-167-4-92 systemd[1]: Starting SYSV: Starts and stops NETSCOUT vSCOUT probe service...
May 07 16:26:39 ip-10-167-4-92 vstream-emb[29896]: Starting vstream-emb:
May 07 16:26:53 ip-10-167-4-92 systemd[1]: Started SYSV: Starts and stops NETSCOUT vSCOUT probe service.
Should output (example on CentOS):
Starting installation of vSTREAM-EMB Version : 6.1.1 Build : 668
Lighttpd service is running. Please make sure you choose different HTTP/HTTPS ports for vSTREAM-EMB configuration to avoid conflict with existing lighttpd service
groupadd: group 'ngenius' already exists
groupadd: group 'vscout_lighttpd' already exists
vSTREAM-EMB installation has been successfully completed...
vSTREAM-EMB is running....
vSTREAM-EMB <---> nG1 communication agent is not running....
user, pid, rss, vsz, pm, pc, command
root 2728 494676 560092 24.2 11.5 nsprobe
Configuration
# cd /usr/lib/NetScout/rtm/config # vi nsagent_config.cfg
Change "export HTTP_PORT=8080" to "export HTTP_PORT=7080"
Change "export HTTPS_PORT=8443" to "export HTTPS_PORT=7443"
Example:
export NSCOMM_PORT=395 export NSCONSOLE_PORT=1501 export HTTP_PORT=7080 export HTTPS_PORT=7443 export MON_INF=eth0 export MGMT_INF=eth0
Start/Stop
# systemctl restart vstream-emb
or:
# service vstream-emb stop # service vstream-emb start
Note: restarting the system may take a minute.
Test
Verify if services procmana and nsprobe are running
root@ip-10-167-4-92:/usr/lib/NetScout/rtm/bin# ./PS
user, pid, rss, vsz, pm, pc, command
root 30027 3152 4604 0.1 0.0 procmana
root 30030 494664 560080 24.1 7.2 nsprobe
Firewall
From nGeniusONE Server (Standalone or Local Server) to host:
- tcp/7080 or tcp/7443 (we recommend to use the latter)
- tcp/1501 (optional feature; Remote Login from nGeniusONE Server to vSTREAM Embedded)
From host to nGeniusONE Server (Standalone or Local Server):
- tcp/395 (optional feature; automatic registation of the vSTREAM Embedded in nGeniusONE Server)
Between host and InfiniStreamNG:
- GRE (IP protocol number 47) or udp/50100. Tunneling packets is optional but it is recommeded to have this protocol/port open .
Localconsole
Run the agent configuration utility to add vSTREAM Embedded to NGS.
# cd /usr/lib/NetScout/rtm/bin # ./localconsole
Rename
Go to NGS > Console > Device Configuration > Devices and change the name of the vSTREAM EMB from UUID to a more meaningfull name (example IS-<hostname>) before continuing to the next installation. If you have added multiple vSTREAM EMB at once and don't know which is which, the UUID is found at:
C:\NETSCOUT\vSTREAM-EMB\rtm\config\.uuid
Example: EDA32E42-F0BC-C14E-EB9C-0F2B74EE9189 becomes IS-CRT-VIR-W-ADDS.
Uninstall
# cd /usr/lib/NetScout/rtm/bin # ./vscout_uninstall.sh