vSTREAM Embedded on Linux: Difference between revisions

Latest revision as of 12:31, 7 December 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 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")

@@ Line 4: / Line 4: @@
 &nbsp;
-{{#invoke:Message box|ambox |type=speedy|text=Do not install vSTREAM Embedded on host with less than one CPU or less than one GB of RAM.}}
+{{#invoke:Message box|speedy |type=speedy|text=Its is not recommended to install vSTREAM Embedded on a host with less than two CPU and less than two GB of memory.}}
 &nbsp;
-{{#invoke:Message box|ambox |type=notice|text=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.}}
+{{#invoke:Message box|ambox |type=notice|text=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.}}
 &nbsp;
-This is a simplified installation procedure that meets most customer needs. The complete installation manual can be found on [https://my.netscout.com MyNetscout].
+This is a simplified installation procedure that has been thoroughly tested by our engineers.&nbsp; It&nbsp;meets most customer's needs and can be trusted for installation of vSTREAM Embedded on any Linux-based host.&nbsp; The complete and detailed installation guide&nbsp;can be found on [https://my.netscout.com MyNetscout].&nbsp; We've installed vSTREAM Agent successfully on both physical and virtual servers.
+We kept the overhead and comments to a minimum.&nbsp; For detailed information, please read the guide mentionned above.
 &nbsp;
@@ Line 18: / Line 20: @@
 == Solution ==
-=== Installation ===
+=== Before you install ===
-<pre># wget https://comcert.box.com/shared/static/something.bin
+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.&nbsp; It will make the installation silent and ready to be scripted&nbsp;!
+&nbsp;
+=== Firewall ===
-# mv something.bin is-6110-668-vSTREAM_EMB.bin
+Before you start, make sure these ports are open between the host, nGenius Server (NGS) and InfiniStreamNG (IS-NG or vSTREAM-STL).&nbsp; The host is the server you install vSTREAM-EMB on.
-# md5sum is-6110-668-vSTREAM_EMB.bin
+From NGS to host:
-# chmod +x is-6110-668-vSTREAM_EMB.bin
+*tcp/7080
+*tcp/7443
+*tcp/7501
-# ./ is-6110-668-vSTREAM_EMB.bin -i console</pre>
+From host to NGS:
-Should output (ubuntu):
+*udp/395&nbsp;
-<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...
+Between host and InfiniStreamNG:
-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>
-Should output (CentOS):
+*GRE (IP protocol number 47) or udp/50100
-<pre>Starting installation of vSTREAM-EMB Version&nbsp;: 6.1.1  Build&nbsp;: 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
-</pre>
 &nbsp;
-=== Configuration ===
+=== Pre-configuration files ===
-<pre># cd /usr/lib/NetScout/rtm/config
-# vi nsagent_config.cfg
-</pre>
-Change "export HTTP_PORT=8080" to "export HTTP_PORT=<span style="background-color:#FFA500;">7080</span>"
+Login as root or sudo to root.
-Change "export HTTPS_PORT=8443" to "export HTTPS_PORT=<span style="background-color:#FFA500;">7443</span>"
+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
-Example:
+export NSCOMM_PORT=395
-<pre>export NSCOMM_PORT=395
+export NSCONSOLE_PORT=7501
-export NSCONSOLE_PORT=1501
 export HTTP_PORT=7080
 export HTTPS_PORT=7443
-export  MON_INF=eth0
+export NSCONFIG_SERVER_IP=A.B.C.D
-export MGMT_INF=eth0</pre>
+(save and exit with ":wq")</pre>
+<span style="background-color:#FFFF00">You MUST specify all four communication ports in this file.&nbsp; Respect the syntax.&nbsp; Failure to do so will make the installation return to its default values.&nbsp;</span>
+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.&nbsp; It can only contain alphanumerical characters, period (.) and hyphen (-), NO SPACES, NO UNDERSCORE (_), NO SPECIAL CHARACTERS&nbsp;!
+<pre># vi /tmp/nsprobeid
+HOSTNAME
+(save and exit with ":wq")</pre>
+<span style="background-color:#FFFF00">Both files MUST have "0644" rights and be owned by "root:root".&nbsp; This should already be the case.</span>
 &nbsp;
-=== Start/Stop ===
+=== Installation ===
-<pre># systemctl restart vstream-emb
+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
+# 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
 </pre>
-or:
+Run the rpm. There are no dependencies to be installed. If you omit the --prefix argument, the installation directory will be /usr/lib/NetScout/.&nbsp; If you specify for example "--prefix=/opt" vSTREAM Embedded will be installed in /opt/NetScout/
-<pre># service vstream-emb stop
+<pre># yum localinstall is-6110-668-vSTREAM_EMB.x86_64.rpm --nogpgcheck --prefix=<target directory></pre>
-# service vstream-emb start</pre>
-Note: restarting the system may take a minute.
 &nbsp;
-=== Test ===
+=== Clean-up ===
-Verify if services procmana and nsprobe are running
+<span style="background-color:#FFFF00">Remove all installation and configuration files from the /tmp directory immediately after verifying if the vSTREAM Embedded is working properly.</span>
-<pre>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
-</pre>
 &nbsp;
-=== Localconsole ===
+=== Service ===
+Check if the vSCOUT-Emb service is running:
+<pre># systemctl status vstream-emb</pre>
-Run the agent configuration utility to add vSTREAM Embedded to NGS.
+Stop/Start/Restart the service with the following commands:
-<pre># cd /usr/lib/NetScout/rtm/bin
+<pre># systemctl stop vstream-emb
-# ./localconsole
+# systemctl start vstream-emb
-</pre>
+or
+# systemctl restart vstream-emb</pre>
 &nbsp;
-=== Rename ===
+=== Clean-up ===
-Go to NGS > Console > Device Configuration > Devices and change the name of the &nbsp;vSTREAM Embedded you just added from its UUID to a more meaningfull name (example IS-<hostname>) before continuing to the next installation.&nbsp;
+We recommend removing all the files from the /tmp direcotory immediately after verification.
 &nbsp;
-=== Uninstall ===
+=== Modifying the configuration ===
-<pre># cd /usr/lib/NetScout/rtm/bin
-# ./vscout_uninstall.sh</pre>
+If for any reason the configuration needs to be modified, edit this file and restart the agent.
+<pre># vi <target directory>/NetScout/rtm/config/nsagent_config.cfg
+(save and exit with ":wq")</pre>

vSTREAM Embedded on Linux: Difference between revisions

Latest revision as of 12:31, 7 December 2019

Contents

Introduction

Solution

Before you install

Firewall

Pre-configuration files

Installation

Clean-up

Service

Clean-up

Modifying the configuration

Navigation menu

vSTREAM Embedded on Linux: Difference between revisions

Latest revision as of 12:31, 7 December 2019

Introduction

Solution

Before you install

Firewall

Pre-configuration files

Installation

Clean-up

Service

Clean-up

Modifying the configuration

Navigation menu

Search