• Spaces
  • Collections
  • Help
    • ×
     
     
    •  
    BMC TrueSight App Visibility Manager 2.6

    Page tree

    This topic provides information about preparing your environment before installing the BMC Application Diagnostics Agent for .NET.

    Ensure that your environment satisfies the following requirements:

    Install the Diagnostics Server

    Install the BMC Application Diagnostics Server before installing the BMC Application Diagnostics Agent for .NET.

    Install IIS Management Scripts and Tools

    If you are monitoring applications hosted on an IIS server, ensure that IIS Management Scripts and Tools are installed. The Diagnostics Agent for .NET employs the memory usage events feature to access application pool settings. On the computer where you are installing the Agent, ensure that IIS Management Scripts and Tools is selected:

    • Microsoft Windows 2008 R2

    • Microsoft Windows 2012

    Note

    (Version 2.6.10) Windows Server 2003 does not require IIS Management Scripts and Tools.

    Download installation files

    Download the Agent for .NET installation files from the Electronic Product Distribution site.

    Confirm access and permissions

    When you perform an installation or upgrade, you must use an IIS Application Pool Identity that has read and execute access to the installation directory, subdirectories, and files  for BMC Application Diagnostics Agent for .NET. Specifically, you must have "Traverse folder" access to the Agent installation directories. For example, if %ProgramFiles(x86)% is C:\Program Files (x86), then you need "Traverse folder" access to the following directories:

    • C:\
    • C:\Program Files (x86)\
    • C:\Program Files (x86)\BMC Software\
    • C:\Program Files (x86)\BMC Software\Application Diagnostics\

    Disable applications that use the .NET CLR Profiler

    (BMC Application Diagnostics Agent for .NET) If your environment includes a monitoring tool that uses the .NET CLR Profiler, such as in a Microsoft System Center Operations Manager (SCOM) version 2012 environment, you must disable application performance monitoring because only one application can use the .NET CLR Profiler at a time.

    For example, use the following procedure to remove the SCOM APM:

    1. Uninstall the Operations Manager agent. Open link
    2. Reinstall the Operations Manager agent without .NET Application Performance Monitoring, as described in the SCOM product documentation Open link . Ensure that you use the NOAPM=1 switch.

    SCOM APM is not installed and will not interfere with the BMC Application Diagnostics Agent for .NET. For more information, see SCOM product documentation.

    To configure the required Terminal Server options

    To enable running the installation wizard through a Terminal Services connection or a remote desktop session, certain Terminal Server configuration options that pertain to temporary folders must be configured.

    1. On the host computer, open the Local Group Policy Editor by selecting Start > Run and typing gpedit.msc.
    2. Expand the following folder: Computer Configuration > Administrative Templates > Windows Components > Remote Desktop Services > Remote Desktop Session Host > Temporary folders.
    3. Double-click the following options to set each to Enabled:
      • Do not delete temp folder upon exit
      • Do not use temporary folders per session
    4. Restart the computer.

    If you try to run the installation utility and again see the notification about Terminal Server configuration, backup the registry and then adjust the following key:

    1. On the host computer, open the Registry Editor by selecting Start > Run and typing regedit.
    2. Expand the following folder: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server.
    3. Set the value for PerSessionTempDir and DeleteTempDirsOnExit to 0.
    4. Restart the computer.

    You can revert these changes after you complete the installation process. You might be required to reboot the computer.

    To allow the installation utility to run unrestricted

    (Only for Windows XP SP2 and Windows 2003 SP1) Configure the setup executable file to run in unrestricted mode, unblocked by the Data Execution Prevention (DEP) feature.

    1. Select Control Panel > System, then select Advanced system settings.
    2. In the System Properties dialog box, select the Advanced tab, and then click the Settings button under Performance.
    3. On the Data Execution Prevention tab, select Turn on DEP for all programs and services except those I select.
    4. Click Add and select the setup.exe file that you downloaded or obtained from BMC Support.
    5. Click OK in all dialog boxes.
    6. Restart the computer.

    Where to go from here

    Select an installation method for the Diagnostics Agent for .NET:

     

     

    © Copyright 2005-2024 BMC Software, Inc. Use of this site signifies your acceptance of BMC’s Terms of Use . BMC, the BMC logo, and other BMC marks are assets of BMC Software, Inc. These trademarks are registered and may be registered in the U.S. and in other countries.