vSTREAM Embedded on Windows: Difference between revisions

From wiki.comcert.com
Jump to navigation Jump to search
No edit summary
No edit summary
 
(20 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 host with less than one CPU or less than one GB of RAM.}}
{{#invoke:Message box|ambox |type=speedy|text=Do not install vSTREAM Embedded on host with less than two CPU or less than two GB of RAM.}}


 
 
Line 12: Line 12:
 
 


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 Windows Server-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.  However, vSTREAM Embedded is supported by Netscout on virtual machines only.
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 Windows Server-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.


 
 


== Solution ==
== 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.


 
 


[[File:WIP.jpg|center|150px|WIP.jpg]]
=== Firewall ===
 
Before 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


Silent installation
 


vSTREAM Embedded is available for bot 32 bit and 64 bit Windows Server operating systems. 
=== Silent installation ===
 
vSTREAM EMB is available for 32 and 64 bit Windows Server operating systems Version 2008 and above. 


Copy the latest version of the .exe to c:\temp directory and checksum.
Copy the latest version of the .exe to c:\temp directory and checksum.


Open a command prompt as Administrator (right-click + Run as administrator)
Open a command prompt as Administrator (right-click + Run as administrator).


Execute the following command; be aware that the name of the exe may be different.
Execute the following command; be aware that the name of the exe may be different. <span style="background-color:#FFFF00">Replace A.B.C.D with the IP address of the nGeniusONE Server.</span>
<pre>c:\temp\is-6110-646-vSTREAM-EMB-x64.exe /s /v/qn /v"INSTALLDIR=C:\NETSCOUT\vSCOUT NSHTTP_PORT=7080 NSHTTPS_PORT=7443 NSCONFIG_SERVER_IP= NSCOMM_PORT=395 NSCONSOLE_PORT=1501 NSCONFIG_MONITOR_PORT=1 NSCONFIG_MGMT_PORT=1"</pre>
<pre>c:\temp\is-6110-646-vSTREAM-EMB-x64.exe /s /v/qn /v"INSTALLDIR=C:\NETSCOUT\vSTREAM-EMB NSHTTP_PORT=7080 NSHTTPS_PORT=7443 NSCONFIG_SERVER_IP=A.B.C.D NSCOMM_PORT=395 NSCONSOLE_PORT=7501 NSCONFIG_MONITOR_PORT=1 NSCONFIG_MGMT_PORT=1"</pre>


Be aware that the name of the exe may be different.
This is a silent install; the command prompt will return immediately after you clicked <Enter>, but the installer is still running.


This is a silent install.&nbsp; The prompt will return immediately after you clicked <Enter>, but the installer is still running.
The easyest way to check if the installation has finished, is to open '''Task Manager''' and to look for the two background processes associated with vSTEAM EMB, '''nsprobe''' and '''procmanager'''.


The best way to check if the installation has finished, is to open '''Task Manager''' and to look for the two background processes associated with vSTEAM Embedded, '''nsprobe''' and '''procmanager'''.
&nbsp;


VSE_TaskManagerBP.png
[[File:VSEMB TaskManagerBP.png|border|center|400px|VSEMB_TaskManagerBP.png]]


&nbsp;
&nbsp;
=== Configuration ===
The preferred way to configure vSTREAM EMB is using the '''System Tray Utility'''.&nbsp; Start the System Tray Utility manually by double-clicking or executing this file:
<pre>C:\NETSCOUT\vSTREAM-EMB\rtm\bin\nstray.exe</pre>
A green orb should appear in the System Tray. The orb may be hidden.


&nbsp;
&nbsp;
[[File:VSEMB SystemTrayUtility.png|border|center|400px|VSEMB_SystemTrayUtility.png]]
&nbsp;
Tip: to have this utility start automatically at reboot, add a shortcut to the common startup folder. The common startup folder is found at C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp.
Tip: you can open this folder by running (Windows+R):&nbsp;"shell:common startup".
If the server has multiple interfaces , you may have to modify monitoring and management Interface&nbsp; You can select up to four interfaces to monitor (check resources!) and one management interface.
Right-click the orb and select Configure.&nbsp; Change the interfaces accordingly and click Apply.&nbsp; Confirm the restart of the vSTREAM EMB processes.
&nbsp;
[[File:VSEMB Configure.png|border|center|400px|VSEMB_Configure.png]]
&nbsp;
=== Start Stop ===
Right-click the orb and select Stop, Start or Restart.
&nbsp;
=== Rename ===
Go to C:\NETSCOUT\vSCOUT\rtm\config
<pre>copy .uuid .nsprobeid</pre>
Edit .nsprobeid and replace UUID with the hostname of the server
Example: replace EDA32E42-F0BC-C14E-EB9C-0F2B74EE9189 with CRT-VIR-W-ADDS.
Delete this agent from NGS (Device Configuration)
Restart the agent (nstray or&nbsp;localconsole option 12)
&nbsp;
=== Uninstall ===
The safest way to uninstall vSTREAM EMB is Config Panel > Programs and Features > Uninstall.&nbsp; The shortcut to the System Tray Utility in the common&nbsp;startup folder and the install directory must be removed manually.
<span style="background-color:#FFFF00;">Be aware that the uninstall option for vSCOUT or vSTREAM-EMB may&nbsp;only be visible under the same user as during installation.</span>
Open a command prompt as administrator and execute:
<pre>c:\temp\is-6110-646-vSTREAM-EMB-x64.exe /s /x /v/qn
</pre>
Successsfull removal will remove all folders below the folder "NETSCOUT".&nbsp; You may want to remove this&nbsp;folder manually.


&nbsp;
&nbsp;


&nbsp;
&nbsp;

Latest revision as of 14:39, 28 September 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 Windows Server-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

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.

 

Firewall

Before 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

 

Silent installation

vSTREAM EMB is available for 32 and 64 bit Windows Server operating systems Version 2008 and above. 

Copy the latest version of the .exe to c:\temp directory and checksum.

Open a command prompt as Administrator (right-click + Run as administrator).

Execute the following command; be aware that the name of the exe may be different. Replace A.B.C.D with the IP address of the nGeniusONE Server.

c:\temp\is-6110-646-vSTREAM-EMB-x64.exe /s /v/qn /v"INSTALLDIR=C:\NETSCOUT\vSTREAM-EMB NSHTTP_PORT=7080 NSHTTPS_PORT=7443 NSCONFIG_SERVER_IP=A.B.C.D NSCOMM_PORT=395 NSCONSOLE_PORT=7501 NSCONFIG_MONITOR_PORT=1 NSCONFIG_MGMT_PORT=1"

This is a silent install; the command prompt will return immediately after you clicked <Enter>, but the installer is still running.

The easyest way to check if the installation has finished, is to open Task Manager and to look for the two background processes associated with vSTEAM EMB, nsprobe and procmanager.

 

VSEMB_TaskManagerBP.png
VSEMB_TaskManagerBP.png

 

Configuration

The preferred way to configure vSTREAM EMB is using the System Tray Utility.  Start the System Tray Utility manually by double-clicking or executing this file:

C:\NETSCOUT\vSTREAM-EMB\rtm\bin\nstray.exe

A green orb should appear in the System Tray. The orb may be hidden.

 

VSEMB_SystemTrayUtility.png
VSEMB_SystemTrayUtility.png

 

Tip: to have this utility start automatically at reboot, add a shortcut to the common startup folder. The common startup folder is found at C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp.

Tip: you can open this folder by running (Windows+R): "shell:common startup".

If the server has multiple interfaces , you may have to modify monitoring and management Interface  You can select up to four interfaces to monitor (check resources!) and one management interface.

Right-click the orb and select Configure.  Change the interfaces accordingly and click Apply.  Confirm the restart of the vSTREAM EMB processes.

 

VSEMB_Configure.png
VSEMB_Configure.png

 

Start Stop

Right-click the orb and select Stop, Start or Restart.

 

Rename

Go to C:\NETSCOUT\vSCOUT\rtm\config

copy .uuid .nsprobeid

Edit .nsprobeid and replace UUID with the hostname of the server

Example: replace EDA32E42-F0BC-C14E-EB9C-0F2B74EE9189 with CRT-VIR-W-ADDS.

Delete this agent from NGS (Device Configuration)

Restart the agent (nstray or localconsole option 12)

 

Uninstall

The safest way to uninstall vSTREAM EMB is Config Panel > Programs and Features > Uninstall.  The shortcut to the System Tray Utility in the common startup folder and the install directory must be removed manually.

Be aware that the uninstall option for vSCOUT or vSTREAM-EMB may only be visible under the same user as during installation.

Open a command prompt as administrator and execute:

c:\temp\is-6110-646-vSTREAM-EMB-x64.exe /s /x /v/qn

Successsfull removal will remove all folders below the folder "NETSCOUT".  You may want to remove this folder manually.