Performing the Diagnostics Server installation

The BMC Application Diagnostics Server includes three components:

  • One Application Diagnostics Portal component, which manages Diagnostics Collectors, the APM proxy, and Diagnostics Agents, and collects relevant data to display in the Console. The application diagnostics environment uses only one Portal component.
  • One or more Application Diagnostics Collector components, which communicates with one or more Diagnostics Agents and stores the information for the monitored application. The application diagnostics environment uses one or more Collector components. You can install the component on a computer that does not have a Diagnostics Portal installation.

  • One or more 

    APM proxy

     (required for active end-user monitoring only), receives and processes end-user experience data. To collect end-user metrics with the APM mode, you must install the APM proxy. The application diagnostics environment uses one or moreAPM proxy component and you can install it on a computer that does not have a Diagnostics Portal installation. 

Perform this procedure to install all the Diagnostics Server components on one computer, for a small environment, or each component on separate computers, such as for larger environments with several Diagnostics Collectors. When the Diagnostics Portal and Collector components are installed on the same computer, they share the same database.

You can use the installation wizard, as described in this topic, or perform a silent installation.

This topic presents the following sections:

When you install Feature Pack 1 (version 2.7.01), a POODLE security patch is automatically applied and does not need to be installed separately.

Before you begin

Ensure that you have completed all preinstallation tasks.

If you are installing the APM proxy, you must have a KeyStore certificate and its password in clear text.

To install the Diagnostics Server

  1. On the computer where you want to install one or more Diagnostics Server components, launch the installation wizard:

    • Windows

      Navigate to ADOPServer\Disk1 and double-click setup.cmd. In Windows 2008, the system may require you to right-click the setup.cmd icon to select to Run as administrator.

    • Linux
      1. Ensure that you have set the DISPLAY environment variable.
      2. Navigate to ADOPServer/Disk1 and run setup.sh.
  2. In the Diagnostics Server Installer Welcome page, click Next.
  3. On the License Agreement page, read the agreement and select the I agree to the terms of the license agreement option, and then click Next. If you do not agree to the terms of the license agreement, the installation process will end.

  4. Select the Diagnostics Server component or components that you want to install, and then click Next:

    • Application Diagnostics Portal
    • Application Diagnostics Collector 
    • APM proxy

    Note

    Installation configuration pages are displayed only for the selected component or components.

  5. On the Directory Selection page, the system displays the available space on the current drive and the amount of space required.

    In the Destination Directory box, enter the path for the installation directory or click Browse to select a directory, and then click Next.

    Ensure that the directory is empty.

    • Windows

      Default directory: C:\Program Files\BMC Software\BMC Application Diagnostics

    • Linux

      Default directory: /opt/bmc/BMC_Application_Diagnostics

      Recommendation

      On Linux computers, BMC recommends using the default installation directory. Otherwise, you might experience issues related to permissions and access.

  6. (For Portal installation) On the Portal Configuration page, define the following options, and then click Next.
     Ensure that the port you enter is available.

  7. (For Collector installation) On the Collector Configuration page, provide the following system connection information and then click Next.
    Ensure that the port you enter is available.

  8. (For Collector installation) If you are installing the Diagnostics Collector on a computer that does not have a Diagnostics Portal installation, the Diagnostics Portal connection information is required.

    Click here to expand.

    Click Test Connection to check communication with the Portal.

  9. (For APM proxy installation) On the Proxy Configuration page, provide the following port numbers and then click Next.
    Ensure that the port you enter is available.

  10. (For APM proxy installation) On the Proxy KeyStore Configuration page, choose an import option:
    • Import the KeyStore file now:
      1. Ensure that Import KeyStore file now is selected.
      2. Select the KeyStore type, JKS or PKCS12.

      3. Enter the KeyStore password, if one exists.

        The KeyStore password cannot contain the following characters: | ^ ; " < > ,

      4. Enter the full path or browse to the location of the KeyStore file.
      5. Click Next.
    • Import the KeyStore post-installation.

  11. (For APM proxy installation) If you are installing the APM proxy on a computer that does not have a Diagnostics Portal installation, the Diagnostics Portal connection information is required.

    Click here to expand.

    Click Test Connection to check communication with the Portal.

  12. On the Listening Address Configuration page, confirm the address of the computer on which you are installing the Diagnostics Server component or components.You can either accept the default address that is received from the operating system, or change the default address to the host name or IP address of the computer on which you are installing. The application diagnostics components use this address to connect to the computer on which you are installing.

    Note

    Ensure that the address is accessible from other components. If you need to change the address after installation, see Changing-Diagnostics-Portal-settings.

  13. (For Portal or Collector installation) On the Database Setup page, enter the database port number.
     The default port is 3301. A new database is created under the installationDirectory\ADOP_DB directory.

  14. (For Portal or Collector installation) Enter the following values in the Database Configuration page.

  15. Verify that the information on the Installation Preview page reflects your installation correctly. Click Previous to make changes, or click Install.
  16. After the installation is complete, click View Log to view the installation log files and confirm that the installation process was successful.
  17. Click Done to exit the installation wizard.
  18. (Optional) If the operating system's host name is incorrect or you want Diagnostics Server components to use an IP address to connect to one another, you must override the default host name configuration. The following links provide instructions:

To patch the Application Diagnostic Server 2.6.x components for POODLE security vulnerability

This patch repairs the POODLE (Padding Oracle On Downgraded Legacy Encryption) security vulnerabilities for communication between Application Diagnostics Agents for Java and Application Diagnostics Server components. Ensure that you select the Patches tab when you download the installation files for BMC Application Diagnostics.

Extract and replace the required file on the Application Diagnostics Portal, Collector, and Proxy servers, and modify the property files as instructed.

If the Portal, Collector, and APM Proxy are installed on the same computer, replace the file once, otherwise, replace it for each installation.

  1. Stop the service or services.
  2. In the server installation directory, under the common/lib directory, replace common-server.jar with the extracted file from this patch.
    The following file paths show the default installation directory:
    • (Windows) C:\Program Files\BMC Software\BMC Application Diagnostics\common\lib
    • (Linux) /opt/bmc/BMC_Application_Diagnostics/common/lib

  3. In the Portal installation directory, under portal/lib directory, replace the portal.jar with the file in this patch.

    The following file paths show the default installation directory:

    (Windows) C:\Program Files\BMC Software\BMC Application Diagnostics\portal\lib

    (Linux) /opt/bmc/BMC_Application_Diagnostics/portal/lib

  4. Open the properties file for each component in a text editor:
    • Portal: installationDirectory\portal\properties\portal.properties
    • Collector: installationDirectory\collector\properties\collector.properties
    • APM Proxy: installationDirectory\apm-proxy\properties\apm-proxy.properties

  5. For each component properties file, add the following lines for the tomcat.ciphers and the tomcat.ssl.enabled.protocols properties:

    # A comma separated list of encryption ciphers to support for HTTPS connections. Spaces between list items are not allowed.
    tomcat.ciphers=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA,TLS_RSA_WITH_AES_128_CBC_SHA256,TLS_RSA_WITH_AES_128_CBC_SHA,TLS_RSA_WITH_AES_256_CBC_SHA256,TLS_RSA_WITH_AES_256_CBC_SHA

    #The comma separated list of SSL protocols to support for HTTPS connections. Spaces between list items are not allowed.
    #Default Value: TLSv1,TLSv1.1,TLSv1.2
    tomcat.ssl.enabled.protocols=SSLv2Hello,TLSv1,TLSv1.1,TLSv1.2
  6. Restart the service or services.

 

Notes

  • If the installation fails, for example the database stops responding during installation, you must uninstall what has already been installed before rerunning the installation wizard. For more information about the uninstall process, see Uninstalling-the-BMC-Application-Diagnostics-Server.
  • You can find the Diagnostics Server log files in the following location:
    • (Windows) %temp%\adopserver_install_log.txt
    • (Linux) /tmp/adopserver_install_log.txt

Where to go from here

Verify that the BMC Application Diagnostics Server installation is successful.

Change the MySQL root password.

Install the BMC Application Diagnostics Agent for Java.

Install the BMC Application Diagnostics Agent for .NET.

Configure the BMC Application Management Console.

Related topic

Importing-a-KeyStore-file-to-replace-the-self-signed-certificate

 

 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*