vSCOUT on Linux: Difference between revisions

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


 
== Introduction ==
 
vSCOUT verion 6.1.1 build 336 is the final version of product that supports "lite" mode.  In lite mode the agent is not analyzing traffic.  It can only be used as packet forwarder to any InfiniStream NG.


== Introduction ==
The procedure below is a siplified installation procedures tested by our engineers and in accordance with our best practises. Supported OS and Harware as specified by NETSCOUT.


vSCOUT verions 6.1.1 build 336 is the most recent version of the agent that supports lite mode.  In lite mode the agent is not analyzing traffic.  Therefore, it uses less resources.  It can only be used to forward ackets to InfiniStream and vSTREAM.
Please read the article on [https://wiki.comcert.com/index.php/vSCOUT_vSTREAM_Embedded_and_vSTREAM_Agent_resource_usage vSCOUT resource usage] before you start.


The procedure below is a siplified installation procedures; we made most decisions based on our best practices and experience.
This article assumes familiarity with Windows server operations systems.


 
 
Line 12: Line 14:
== Solution ==
== Solution ==


=== Prepare ===


Create a file /tmp/nsprobeid containing the hostname of the host.  This name will eventually be used to identify this instance of vSCOUT in nGenius Server:
=== Before you begin ===
 
Create a first file <code>nsprobeid</code>&nbsp;containing the hostname of the target host.&nbsp; This name will eventually be used by NGS to identify the&nbsp;vSCOUT:
<pre># vi /tmp/nsprobeid</pre>
<pre># vi /tmp/nsprobeid</pre>


Line 20: Line 23:
<pre>HOSTNAME</pre>
<pre>HOSTNAME</pre>


Create a second file /tmp/nsagent_config.cfg.&nbsp; Replace <A.B.C.D> with the IP address of the nGenius Server.&nbsp; Replace <MON> and <MAN> with the device name of the network interface(s) of the host.&nbsp; In many cases the interface to monitor is the same interface used to communicate&nbsp;with nGenius (MON=MAN):
Save and exit (wq).
 
Create a second file named <code>nsagent_config.cfg</code>.&nbsp; Replace <A.B.C.D>&nbsp;with the IP address of the nGenius Server.&nbsp; Replace <MON> and <MAN> with the device name of the network interface on&nbsp;the target host.&nbsp; In most&nbsp;cases the interface to monitor will be the same&nbsp;interface used to communicate&nbsp;with nGenius (<MON>=<MAN>):
<pre># vi /tmp/nsagent_config.cfg</pre>


Content of the file:
Content of the file:
Line 35: Line 41:
</pre>
</pre>


The host will time stamp the packets.&nbsp; Make sure the host has adequate time sources configureda and&nbsp;tested.
Save and exit (wq).
 
Note: these files will be copied by the installer to their final destination in the installation folder.&nbsp; The file nsagent_config.cfg&nbsp;can be modified after installation to change vSCOUT settings as many times as you want.&nbsp; You must restart vSCOUT for the changes to take effect.


&nbsp;
&nbsp;
Line 61: Line 69:
&nbsp;
&nbsp;


&nbsp;
=== Removing vSCOUT from Linux ===
 
&nbsp;


&nbsp;
vSCOUT, vSTREAM Embedded and vSTREAM Agent are completely different products with different capabilities and different licenses.&nbsp; Before moving to vSTREAM Embedded or vSTREAM Agent, vSCOUT must be removed entirely.


&nbsp;
To [[Removing_vSCOUT_vSTREAM_Embedded_and_vSTREAM_Agent_on_Linux|remove vSCOUT from Linux]], please read the article.
 
&nbsp;

Latest revision as of 12:36, 21 June 2020

Introduction

vSCOUT verion 6.1.1 build 336 is the final version of product that supports "lite" mode.  In lite mode the agent is not analyzing traffic.  It can only be used as packet forwarder to any InfiniStream NG.

The procedure below is a siplified installation procedures tested by our engineers and in accordance with our best practises. Supported OS and Harware as specified by NETSCOUT.

Please read the article on vSCOUT resource usage before you start.

This article assumes familiarity with Windows server operations systems.

 

Solution

Before you begin

Create a first file nsprobeid containing the hostname of the target host.  This name will eventually be used by NGS to identify the vSCOUT:

# vi /tmp/nsprobeid

Content of the file:

HOSTNAME

Save and exit (wq).

Create a second file named nsagent_config.cfg.  Replace <A.B.C.D> with the IP address of the nGenius Server.  Replace <MON> and <MAN> with the device name of the network interface on the target host.  In most cases the interface to monitor will be the same interface used to communicate with nGenius (<MON>=<MAN>):

# vi /tmp/nsagent_config.cfg

Content of the file:

export NSCONFIG_SERVER=<A.B.C.D>
export NSCOMM_PORT=395
export NSCONSOLE_PORT=7501
export HTTP_PORT=7080
export HTTPS_PORT=7443
export NUM_CPUS=2
export MEM_SIZE=2048
export MON_INF=<MON>
export MGMT_INF=<MAN>
export VSCOUT_MODE=lite

Save and exit (wq).

Note: these files will be copied by the installer to their final destination in the installation folder.  The file nsagent_config.cfg can be modified after installation to change vSCOUT settings as many times as you want.  You must restart vSCOUT for the changes to take effect.

 

Download

Use wget or curl to download the required installation file to the /tmp directory on the host.  There are two versions of this file: RPM to be used with Redhat, CentOS and Amazon Linux and BIN to be used with Ubuntu, Fedore and SUSE Linux.  Keep in mind that only x86_64 architecture is supported.

 

Installing vSCOUT using the RPM file

# md5sum is-6xxx-xxx-vSCOUT.x86_64.rpm
# yum -y is-6xxx-xxx-vSCOUT.x86_64.rpm --prefix=<target directory>

The --prefix argument is optional and allows you to specify a location for the vSCOUT installation.  The default location is /opt/NetScout/.  If you want for example install vSCOUT in /usr/lib/NetScout/, you must specify /usr/lib/ as target directory.

 

Installing vSCOUT using the BIN file

# md5sum is-6xxx-xxx-vSCOUT.bin
# chmod +x is-6xxx-xxx-vSCOUT.bin
# ./is-6xxx-xxx-vSCOUT.bin --prefix=<target directory>

 

Removing vSCOUT from Linux

vSCOUT, vSTREAM Embedded and vSTREAM Agent are completely different products with different capabilities and different licenses.  Before moving to vSTREAM Embedded or vSTREAM Agent, vSCOUT must be removed entirely.

To remove vSCOUT from Linux, please read the article.