vSTREAM Agent on Windows: Difference between revisions

From wiki.comcert.com
Jump to navigation Jump to search
No edit summary
No edit summary
Line 64: Line 64:
*vStream Agent will be configured with a 10GB Packet store  
*vStream Agent will be configured with a 10GB Packet store  
*Interface eth0 is used for both management and monitor interface  
*Interface eth0 is used for both management and monitor interface  
*vStream Agent is allowed to use 2vCPU and 2GB of memory on the host  
*vStream Agent is allowed to use 2 CPU and 4 GB of memory on the host  


 
 


From 1 to 16 vCPU can be assigned to vStream Agent to spread the load workload among each processor but at the cost of additional licenses. Valid ranges for allocated memory are 1024, 2048, 4096, 8192, 10240, 12288, 14336 and 16384).
From 1 to 16 vCPU can be assigned to vStream Agent to spread the load workload among each processor but at the cost of additional licenses. Valid ranges for allocated memory are 1024, 2048, 4096, 8192, 10240, 12288, 14336 and 16384).


 
 
Line 78: Line 78:
=== Create storage path ===
=== Create storage path ===


The path where to store XDR records and packets must be created upfront. In our example, we decided to use <code>F:\nsagentstore</code> for that matter.
The path where to store XDR records and packets must be created upfront. In our example, we decided to use E<code>:\nsagentstore</code> for that purpose.


&nbsp;
&nbsp;
Line 84: Line 84:
=== Create configuration files ===
=== Create configuration files ===


Create the file&nbsp;%temp%/.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:
Create the file&nbsp;<code>%temp%/.nsprobeid</code> 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:
<pre><hostname></pre>
<pre><hostname></pre>
<span style="background-color:#FFFF00;">File names starting with a dot are unusual in Windows.&nbsp; Use the </span><code><span style="background-color:#FFFF00;">rename</span></code><span style="background-color:#FFFF00;">command to alter the name of the file.</span>


&nbsp;
&nbsp;
Line 91: Line 93:
=== Installation ===
=== Installation ===


Copy the most recent version of the rpm to the /temp directory on the host. It is recommended to keep the original file name for future reference.
Place the most recent version and build of the <code>*.exe</code>&nbsp;in the <code>c:/temp</code>&nbsp;folder&nbsp;on the host. We recommend&nbsp;to keep the original file name for future reference.


Run the following command to install the agent:
Open a Command Prompt as Administrator and run the following command to install the agent:
<pre>C:\temp\is-6210-xxx-vStream_agent-x64.exe /s /v/qn /v"INSTALLDIR=C:\NETSCOUT NSHTTP_PORT=7080 NSHTTPS_PORT=7443 NSCOMM_PORT=395 NSCONSOLE_PORT=7501 NSCONFIG_SERVER_IP=<IP_NGS> MON_INF=1 MGMT_INF=1 NUM_CPUS=1 MEM_SIZE=2048 STORAGE_PATH=F:\nsagentstore XDRSTORE_SIZE=1000 PKTSTORE_SIZE=10000 NUM_FWD_CPUS=1"
<pre>C:\temp\is-6210-437-vStream_agent_x64.exe /s /v/qn /v"INSTALLDIR=C:\NETSCOUT NSHTTP_PORT=7080 NSHTTPS_PORT=7443 NSCOMM_PORT=395 NSCONSOLE_PORT=7501 NSCONFIG_SERVER_IP=10.165.30.183 MON_INF=1 MGMT_INF=1 NUM_CPUS=2 MEM_SIZE=4096 STORAGE_PATH=E:\nsagentstore XDRSTORE_SIZE=1000 PKTSTORE_SIZE=10000 NUM_FWD_CPUS=1"
</pre>
</pre>
<span style="background-color:#FFFF00;">To see of the installation has finished, look for the running services (see Test).</span>


&nbsp;
&nbsp;
Line 101: Line 105:
=== Test ===
=== Test ===


Open Taskmanager to see if the required processes are running.
Logs are located in&nbsp;&nbsp;<code>%temp%</code>


The installation log is located under <code>%temp%\vStream.log</code>
To check if vStream Agent is running, open Task Manager >&nbsp;


&nbsp;
Stop/Start/Restart the service:


=== Clean-up ===
To stop the agent, run the following batch file:
<pre><tbv>
</pre>


We recommend removing all the temporary configuration files from the /tmp direcotory after verification.&nbsp; These files cannot be used to reconfigure the agent.
To start the agent, run the following batch file:
<pre><tbv></pre>


&nbsp;
&nbsp;


=== Modifying the configuration ===
=== Clean-up ===


To modify the configuration, edit this file and restart the agent:
We recommend removing all the temporary configuration files from the /tmp direcotory after verification.&nbsp; These files cannot be used to reconfigure the agent.
<pre><tbv>
</pre>


&nbsp;
&nbsp;
Line 127: Line 132:
Use the following command to perform a silent uninstallation of vStream Agent:
Use the following command to perform a silent uninstallation of vStream Agent:
<pre>C:\is-6210-xxx-vStream_agent-x64.exe /s /x /v/qn</pre>
<pre>C:\is-6210-xxx-vStream_agent-x64.exe /s /x /v/qn</pre>
The original&nbsp; install directory (c:\NETSCOUT)&nbsp;should be empty after successful removal of the agent.
&nbsp;
&nbsp;
&nbsp;

Revision as of 17:36, 9 December 2019

 

Introduction

This is a simplified installation procedure that has been thoroughly tested by our engineers on virtual as well as physical host.

A complete and detailed installation guide is available on MyNetscout.

 

Solution

 

 

 

Before you install

Some considerations before we start:

  • You don't want to use NetScout's default communication ports as they are relatively common and could be in use on the host, now or in the future.
  • You want to see the name of the agent in Device Configuration to be identical to the host's name.
  • You know the IP address of the nGeniusONE Server (NGS). 
  • You are familiar with nGeniusONE
  • You are familiar with Windows CMD and/or PowerShell

 

Firewall

These communication are required.  Make sure they are allowed by every firewall in the path between the host running vStream Agent and NGS:

From NGS to vStream Agent (basic communication = required):

  • tcp/7080
  • tcp/7443
  • tcp/7501

From vStream Agent to NGS 

  • udp/395 

From vStream Agent to any InfiniStream NG

  • GRE (IP protocol number 47) or udp/50100

 

Pre-configuration considerations

  • vStream Agent offers the posibility to store application session detailed records (ASR) and data packets on the host itself.  The amount of disk space used for this purpose is restricted; it must be at least 1GB/10GB respectively.  Any value configured below this value will effecitvely disable that functionality.  We recommend to start with 1GB and 10GB for the XDR store and packet store respectivily.  
  • vStream Agent can monitor more than one interface and those interfaces can be different from the interface used to communicate with NGS and NGIS.

In the example below:

  • vStream Agent will be configured with a 1GB ASR store
  • vStream Agent will be configured with a 10GB Packet store
  • Interface eth0 is used for both management and monitor interface
  • vStream Agent is allowed to use 2 CPU and 4 GB of memory on the host

 

From 1 to 16 vCPU can be assigned to vStream Agent to spread the load workload among each processor but at the cost of additional licenses. Valid ranges for allocated memory are 1024, 2048, 4096, 8192, 10240, 12288, 14336 and 16384).

 

 

Create storage path

The path where to store XDR records and packets must be created upfront. In our example, we decided to use E:\nsagentstore for that purpose.

 

Create configuration files

Create the file %temp%/.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:

<hostname>

File names starting with a dot are unusual in Windows.  Use the renamecommand to alter the name of the file.

 

Installation

Place the most recent version and build of the *.exe in the c:/temp folder on the host. We recommend to keep the original file name for future reference.

Open a Command Prompt as Administrator and run the following command to install the agent:

C:\temp\is-6210-437-vStream_agent_x64.exe /s /v/qn /v"INSTALLDIR=C:\NETSCOUT NSHTTP_PORT=7080 NSHTTPS_PORT=7443 NSCOMM_PORT=395 NSCONSOLE_PORT=7501 NSCONFIG_SERVER_IP=10.165.30.183 MON_INF=1 MGMT_INF=1 NUM_CPUS=2 MEM_SIZE=4096 STORAGE_PATH=E:\nsagentstore XDRSTORE_SIZE=1000 PKTSTORE_SIZE=10000 NUM_FWD_CPUS=1"

To see of the installation has finished, look for the running services (see Test).

 

Test

Logs are located in  %temp%

To check if vStream Agent is running, open Task Manager > 

Stop/Start/Restart the service:

To stop the agent, run the following batch file:

<tbv>

To start the agent, run the following batch file:

<tbv>

 

Clean-up

We recommend removing all the temporary configuration files from the /tmp direcotory after verification.  These files cannot be used to reconfigure the agent.

 

Uninstall

If for any reason the agent needs to be uninstalled, open Control Panel > Programs > Uninstall a program. This is the preferred way for removing the agent.

Use the following command to perform a silent uninstallation of vStream Agent:

C:\is-6210-xxx-vStream_agent-x64.exe /s /x /v/qn

The original  install directory (c:\NETSCOUT) should be empty after successful removal of the agent.