Agent Installation for .NET

 

Pre-requisites

Windows application server should have below software installed:

  1. vc_redist.x64.exe
  2. Procdump.zip (Optional: This is required to take thread dump and heap dump)
  3. DebugDiagx64.msi (Optional: This helps in analysing .Net ND issues)

Install NetDiagnostics for .NET

Follow the below mentioned steps for installing NetDiagnostics for .NET:

Step – 1: Get NetDiagnostics for .NET MSI file from Cavisson Systems Inc.

1

User needs to get the NetDiagnostics for .NET MSI file from Cavisson Systems Inc. to install it on the windows server.

Step – 2: Execute NetDiagnostics for .NET MSI

Double-click on the NetDiagnostics for .NET MSI file. The NetDiagnostics for .NET Agents Setup Wizard is displayed. Click the Next button.

Step – 3: Accept the License Agreement

Accept the License Agreement by selecting the I accept the terms in the License Agreement check box. Click the Next button.

Step – 4: Setup the Destination Folder

Specify the destination folder where NetDiagnostics for .NET agent need to be installed. To install NetDiagnostics for .NET agent at the default location (i.e. C:\Program Files\msi_files), simply click the Next button. To install them on any other location, first click the Change button, browse the location for installation, and then click the Next button.

Step – 5: Auto Registration of NetDiagnostics for .NET Agent

To perform auto registration of NetDiagnostics for .NET agent, provide the following details:

  1. Controller Host/IP:Port
  2. Tier Name
  3. Server Host/IP
  4. Instance Name (Optional)

Step – 6: Initiate the Installation Process

Click the Install button to initiate the NetDiagnostics for .NET agent installation process.

Step – 7: Finish the Installation Process

Click the Finish button to finish the installation process and exit from the setup wizard. The NetDiagnostics for .NET agent gets installed at the specified location.

Register NetDiagnostics for .NET Agent

  1. Use stop_web_server.bat to stop following services:
  • net stop w3logsvc (may not present on Windows 2008 Server)
  • net stop W3SVC
  • net stop WAS
  1. Use start_web_server.bat to start following services:
  • net start w3logsvc (may not present on Windows 2008 Server)
  • net start W3SVC
  • net start WAS

The NetDiagnostics has a provision of auto scaling by which it can detect and start monitoring of any new instance or a server. However, if auto-scaling is disabled then NetDiagnostics is not be able to automatically detect and monitor the newly added server.

For NetDiagnostics to automatically monitor the newly added server, the auto registration of the agents is needed, where we provide the information of the tier, server, NetDiagnostics IP address as well as the NetDiagnostics port to the agent. This is referred to as auto registration of agent.

To auto register new server, and to enable auto scaling, user needs to define certain configuration details in the following file:

C:\Program Files\msi_files\cavisson\netdiagnostics\config  

Configuration:

  • NDE Controller Address (Host and Port): User can configure NDE Controller as following:

CONTROLLER=<host:port>

  • Tier Name: At the time of enabling of auto-scale feature, user needs to define tier name. It is an optional field. Upon defining the tier name, the newly added server becomes the part of this tier. If the tier name is not defined, then the server becomes the part of default tier.

Tier=<Tier Name>

  • Server: At the time of enabling of auto-scale feature, user needs to define server name. This server is registered with the specified tier. It is an optional field.
  • Instance: At the time of enabling of auto-scale feature, user needs to define instance name of the application where ndAgent is plugged in. This instance is registered with the specified server. It is an optional field.

For example:

#NDE Controller Host and Port - Mandatory
CONTROLLER=10.10.40.13:7890
#Tier and Server - Optional
TIER=WebStore
SERVER=<ip address or host name of server>

NetDiagnostics Directory Structure

Following directories are created when the NetDiagnostics for .NET package is installed in the following directory:

C:\Program Files\msi_files\cavisson\netdiagnostics\

2

  • logs: Contains log files created by NetDiagnostics for .NET agent.
  • conf: Contains configuration information for running NetDiagnostics for .NET agent on windows based system.
  • etc: Contains version information.
  • dll: Contains agent dll files.
  • profilerhelper_folder: Contains agent ProfilerHelper.dll file. This file is copied to Global Assembly Cache (GAC_64) folder.

Un-install NetDiagnostics for .NET Agent

Follow the below mentioned steps to uninstall the NetDiagnostics for .NET agent:

  • Go to Control Panel > Programs > Programs and Features and select NetDiagnostics Enterprise.

3

  • Click the Uninstall button to uninstall the NetDiagnostics for .NET agent.

Un-Register NetDiagnostics for .NET Agent

  1. Use stop_web_server.bat to stop following services:
  • net stop w3logsvc (may not present on Windows 2008 Server)
  • net stop W3SVC
  • net stop WAS
  1. Run command prompt (as Administrator) and go to %ndhome%\dll
  • Use unregister_dll_IL.bat script to unregister .Net Agent dll
  1. Use start_web_server.bat to start following services:
    • net start w3logsvc (may not present on Windows 2008 Server)
    • net start W3SVC
    • net start WAS