Performing the Agent for .NET installation

Deploy and configure the BMC Application Diagnostics Agent for .NET on the computer before connecting it to the application server instance. You can use the installation wizard, as described in this topic, or the silent installation.

The installation utility checks the computer for existing versions of the Agent:

• If version 1.3 or earlier, you are instructed to uninstall the existing version before running the installation.
• If version 2.0 or later, you can upgrade to version 2.5.
  After upgrade, the Agent runs using the same log files and configuration, and the already applied agent policy and recording configuration.
• If no version is detected, version 2.5 is installed.
• If version 2.5 is detected, you can uninstall the Agent.

To install the Agent, you must have administrative privileges for the application server that will be monitored.

This topic presents the following content:

• • Before you begin
  • To install the BMC Application Diagnostics Agent for .NET
  • To configure the Agent for .NET in SCOM
  • Where to go from here
  • Related topics

Before you begin

Ensure that you have completed all tasks to prepare the environment for Agent installation.

To install the BMC Application Diagnostics Agent for .NET

1. Copy and extract the files to a temporary directory on the target computer.
2. Launch the installation wizard by double-clicking setup.exe.
3. On the BMC Application Diagnostics Agent for .NET Installer Welcome page, click Next.
4. On the License Agreement page, read the agreement and click Yes to agree to the terms of the license agreement.
   If you do not agree to the terms of the license agreement, the installation process ends.
5. In the Customer Information screen, enter values in User Name and Company Name.

6. Select the destination directory where the BMC Application Diagnostics Agent for .NET will be installed.
   The default directory is C:\Program Files (x86)\BMC Software\Application Diagnostics\Agent for .NET.

   If required system settings for the default .NET profiler are assigned to another product, then installing BMC Application Diagnostics Agent for .NET disables that product:

   • If the system settings are not configured, the wizard continues to the Agent Information screen.
   • If the system settings are assigned to another product, click Continue to permit the installer to overwrite the variables, or click Abort to stop the installation process.
7. In the Agent Information screen, enter the following Agent information:
   • Application Server Display Name — Enter the host name, which is displayed in the BMC Application Performance Management Console as the application server’s display name. The default name used is the DNS host name.
   • Application Display Name — Enter a name for the application to be displayed in the BMC Application Performance Management Console. The application name is required and it is case insensitive.
   • Tier Type — Specify the type of tier this Agent represents in the Application View: App, Business, Web.
8. In the Portal Information For Connection screen, perform the following steps:
   1. Enter the portal connection information:
      
      • Portal Server — Enter the IP address or host name on which the BMC Application Diagnostics Portal is (or will be) installed.
      • Portal Port — Enter the BMC Application Diagnostics Portal port number.
      • If you are using a secure connection, select Use HTTPS.
   2. Click Test Connection to verify that the Agent can connect to the portal.
       If the test is successful, the following message is displayed: Test connection succeeded
       If the test fails, the following message is displayed: Test connection Failed: Portal not answering (may be down)
   3. If the test connection fails, check the information you entered and test the connection again. If the test connection fails again, continue with the installation. You can change the portal host settings post-installation.
9. If you are using a proxy server, perform the following steps:
   1. Select Use proxy server and enter the following information:
      • HTTP Proxy Server Host — Enter the HTTP proxy server host name or IP address.
      • HTTP Proxy Server Port — Enter the HTTP proxy server port number.
   2. Click Test Connection to verify the connection of the proxy server.
       If the test is successful, the message Test connection succeeded is displayed.
      If the test fails, the message Test connection Failed: Portal not answering (may be down), proxy configuration may be wrong or proxy is down is displayed.
   3. If the test connection fails, check the information you entered and test the connection again. If the test connection fails again, continue with the installation. You can change the proxy server host and port setting post-installation.
10. Review the settings displayed in the Start Copying Files screen and click Install.
    The Setup Status screen displays the status of the installation. On successful installation, the system prompts you to select to automatically or manually restart the computer on which the Agent is installed.
11. Select one of the following options:
    • Yes, I want to restart my computer now.

    • No, I will restart my computer later.

      Warning

      Note

      The Agent will be activated only after the computer has been restarted.

12. Click Finish to end the installation process.

To configure the Agent for .NET in SCOM

To use the BMC Application Diagnostics Agent for .NET in a Microsoft System Center Operations Manager (SCOM) environment, you must disable application performance monitoring (APM) for SCOM. Only one application can use the .NET CLR Profiler at a time.

1. Disable the APM rule on the SCOM server.
2. Disable the APM service on the BMC Application Diagnostics Agent for .NET.
3. Restart the Agent computer.

SCOM APM is disabled and will not interfere with the BMC Application Diagnostics Agent for .NET. Refer to SCOM documentation for more information.

Where to go from here

Verify that the BMC Application Diagnostics Agent for .NET installation is successful.
Configure BMC Application Diagnostics Portal in BMC Application Performance Management Console, if you haven't already done so.
If required, change security settings.

Related topics

Installing-the-Agent-for-Java
Changing-settings-of-the-Agent-for-NET