vSTREAM Embedded on Linux: Difference between revisions

From wiki.comcert.com
Jump to navigation Jump to search
VisualWikitext
No edit summary
No edit summary
 
(19 intermediate revisions by the same user not shown)
Line 4: Line 4:
 
 


{{#invoke:Message box|ambox |type=speedy|text=Do not install vSTREAM Embedded on a host with less than two CPU and less than two 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.}}


 
 


{{#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.}}


 
 


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 [https://my.netscout.com MyNetscout].  We've installed vSTREAM Embedded with success on both physical and virtual servers. 
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 [https://my.netscout.com 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.


 
 
Line 20: Line 22:
=== Before you install ===
=== 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.
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.  


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.
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 !


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 !
=== Firewall ===


==== Pre-configuration files ====
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.


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.
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.
<pre># vi /tmp/nsagent_config.cfg
<pre># vi /tmp/nsagent_config.cfg


Line 41: Line 67:
(save and exit with ":wq")</pre>
(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 (-).
<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>
<pre># vi /tmp/nsagent_config.cfg
 
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
HOSTNAME
Line 48: Line 76:
(save and exit with ":wq")</pre>
(save and exit with ":wq")</pre>


=== &nbsp; ===
<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;


=== Installation ===
=== Installation ===
Line 54: Line 84:
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.
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
<pre># cd /tmp
# wget https://comcert.box.com/shared/static/something.rpm
# wget https://comcert.box.com/shared/static/something.rpm
# mv something.rpm is-6110-668-vSTREAM_EMB.x86_64.rpm
# mv something.rpm is-6110-668-vSTREAM_EMB.x86_64.rpm
# md5sum is-6110-668-vSTREAM_EMB.x86_64.rpm
# md5sum is-6110-668-vSTREAM_EMB.x86_64.rpm
</pre>
</pre>


Run the rpm. There are no dependencies to be installed.
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># yum localinstall is-6110-668-vSTREAM_EMB.x86_64.rpm --nogpgcheck</pre>
<pre># yum localinstall is-6110-668-vSTREAM_EMB.x86_64.rpm --nogpgcheck --prefix=<target directory></pre>
 
&nbsp;
 
=== Configuration ===
 
 
<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>"
 
Change "export HTTPS_PORT=8443" to "export HTTPS_PORT=<span style="background-color:#FFA500">7443</span>"
 
Example:
<pre>export NSCOMM_PORT=395
export NSCONSOLE_PORT=1501
export HTTP_PORT=7080
export HTTPS_PORT=7443
export  MON_INF=eth0
export MGMT_INF=eth0</pre>


&nbsp;
&nbsp;


=== Start/Stop ===
=== Clean-up ===
<pre># systemctl restart vstream-emb
</pre>


or:
<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># service vstream-emb stop
# service vstream-emb start</pre>
 
Note: restarting the system may take a minute.


&nbsp;
&nbsp;


=== Test ===
=== Service ===
 
Verify if services procmana and nsprobe are running
<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;
Check if the vSCOUT-Emb service is running:
<pre># systemctl status vstream-emb</pre>


=== Firewall ===
Stop/Start/Restart the service with the following commands:
 
<pre># systemctl stop vstream-emb
From nGeniusONE Server (Standalone or Local Server) to host:
# systemctl start vstream-emb
 
or
*tcp/7080 or tcp/7443 (we recommend to use the latter)
# systemctl restart vstream-emb</pre>
*tcp/1501 (optional feature; Remote Login&nbsp;from&nbsp;nGeniusONE Server to&nbsp;vSTREAM Embedded)
 
From host to nGeniusONE Server (Standalone or Local Server):
 
*tcp/395 (optional feature; automatic registation of the vSTREAM Embedded in&nbsp;nGeniusONE Server)
 
Between host and InfiniStreamNG:
 
*GRE (IP protocol number 47) or udp/50100. Tunneling packets is optional but it is recommeded to have&nbsp;this&nbsp;protocol/port&nbsp;open .


&nbsp;
&nbsp;


=== Localconsole ===
=== Clean-up ===


Run the agent configuration utility to add vSTREAM Embedded to NGS.
We recommend removing all the files from the /tmp direcotory immediately after verification.
<pre># cd /usr/lib/NetScout/rtm/bin
# ./localconsole
</pre>


&nbsp;
&nbsp;


=== Rename ===
=== Modifying the configuration ===


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):
If for any reason the configuration needs to be modified, edit this file and restart the agent.
<pre>/usr/lib/NetScout/config/.uuid</pre>
<pre># vi <target directory>/NetScout/rtm/config/nsagent_config.cfg


Example: 31cf3c80-44e8-4efe-8e59-ee368152f18f becomes IS-AWS-FRA-L-WEB-COMC
(save and exit with ":wq")</pre>
 
&nbsp;
 
=== Uninstall ===
<pre># cd /usr/lib/NetScout/rtm/bin
# ./vscout_uninstall.sh</pre>

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")
Retrieved from "https://wiki.comcert.com/index.php?title=vSTREAM_Embedded_on_Linux&oldid=5211"