Difference between revisions of "vSTREAM Embedded on Linux"

From wiki.comcert.com
Jump to navigation Jump to search
Line 18: Line 18:
 
== Solution ==
 
== Solution ==
  
−
=== Installation ===
+
=== 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.
 +
<pre># 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")</pre>
 +
 
 +
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 (-).
 +
<pre># vi /tmp/nsagent_config.cfg
  
−
Download or copy the most recent version of the&nbsp;.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.
+
HOSTNAME
−
<pre># cd /tmp
 
  
−
# wget https://comcert.box.com/shared/static/something.bin
+
(save and exit with ":wq")</pre>
  
−
# mv something.bin is-6110-668-vSTREAM_EMB.bin
+
=== &nbsp; ===
  
−
# md5sum is-6110-668-vSTREAM_EMB.bin
+
=== Installation ===
  
−
# chmod +x is-6110-668-vSTREAM_EMB.bin
+
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.
 +
<pre># cd /tmp
  
−
# ./is-6110-668-vSTREAM_EMB.bin -i console</pre>
+
# wget https://comcert.box.com/shared/static/something.rpm
  
−
Should output (example on ubuntu):
+
# mv something.rpm is-6110-668-vSTREAM_EMB.x86_64.rpm
−
<pre>vSTREAM-EMB install path selected: /usr/lib/NetScout
 
−
Starting installation of vSTREAM-EMB Version&nbsp;: 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...
+
# md5sum is-6110-668-vSTREAM_EMB.x86_64.rpm
−
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.
 
 
</pre>
 
</pre>
  
−
Should output (example on CentOS):
+
Run the rpm. There are no dependencies to be installed.
−
<pre>Starting installation of vSTREAM-EMB Version&nbsp;: 6.1.1  Build&nbsp;: 668
+
<pre># yum localinstall is-6110-668-vSTREAM_EMB.x86_64.rpm --nogpgcheck</pre>
−
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
 
−
</pre>
 
  
−
&nbsp;
+
&nbsp;  
  
 
=== Configuration ===
 
=== Configuration ===
 +
 +
 
<pre># cd /usr/lib/NetScout/rtm/config
 
<pre># cd /usr/lib/NetScout/rtm/config
 
# vi nsagent_config.cfg
 
# vi nsagent_config.cfg

Revision as of 18:23, 4 June 2019

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

 

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 (hidden): 

/usr/lib/NetScout/config/.uuid

Example: 31cf3c80-44e8-4efe-8e59-ee368152f18f becomes IS-AWS-FRA-L-WEB-COMC

 

Uninstall

# cd /usr/lib/NetScout/rtm/bin
# ./vscout_uninstall.sh
Retrieved from "https://wiki.comcert.com/index.php?title=vSTREAM_Embedded_on_Linux&oldid=4452"