Installing the server

The BMC Application Diagnostics Server includes one portal component, and one or more collector components. You can install the BMC Application Diagnostics Portal and Collector on one computer, for a small environment, or on separate computers.

Before you begin

Ensure that you have completed all preinstallation tasks.

To install the BMC Application Diagnostics Server

1. 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. Before running the wizard, ensure that you have a DISPLAY environment variable set.
     2. Navigate to ADOPServer/Disk1 and run setup.sh.
2. In the BMC Application 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. On the Features page, select to install one or both BMC Application Diagnostics Server components, and then click Next:
   • BMC Application Diagnostics Portal. The BMC Application Diagnostics environment uses only one portal component.

   • BMC Application Diagnostics Collector. The BMC Application Diagnostics environment uses one or more collector components.

     Note

     If you install only the BMC Application Diagnostics Portal or only the BMC Application Diagnostics Collector, then only the relevant configuration pages are displayed.

5. On the Directory Selection page, enter the installation directory, or click Browse to select a directory, and then click Next.
   
   

   The macro unmigrated-inline-wiki-markup from Confluence is no longer available.

   The system displays the available space on the current drive and the amount of space required.

6. On the Portal Configuration page, define the following options, and then click Next.
    Ensure that the required ports are available.
7. Provide the following system connection information and then click Next.
   Ensure that the required port is available.

   • Collector Configuration
      Enter the listening port for the same security protocol that you set for the portal.

   • If you are installing only the BMC Application Diagnostics Collector, that is, separate from the portal installation, then the following portal connection information is required:

     The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
     This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.
     Click Test Connection to check communication with the portal.

8. On the Listening address configuration page, confirm the address of the current computer, that is, the computer on which you are installing the server or server component. You can accept the default address, received from the operating system, or change it to the host name or IP address of the computer on which you are installing.
   
   This is the address that BMC Application Diagnostics components will use to connect to the current computer.

   Note

   Ensure that the address is accessible from other components.

9. 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.

10. If you are installing the BMC Application Diagnostics Collector, the Collector Database Configuration page displays. Enter the following values:

    Option	Description
    Database Retention Time (Days)	Number of days before which the historical data on the BMC Application Diagnostics Collector database is overwritten. The default time is 35 days. The overwrite is automatically launched when the system reaches the specified retention time.
    Database Max Size (GB)	Maximum disk space allowed for database use. The default size is 100 GB. When the database reaches the maximum size, historical data will be overwritten regardless of the value defined in the database retention time parameter. Note: The wizard validates that there is sufficient space available on the installation directory, and displays a validation error if there is insufficient space.

    Verify that the information on the Installation Preview page reflects your installation correctly. Click Previous to make changes, or click Install.

11. After the installation is complete, click View Log to view the installation log files and confirm that the installation process was successful.
12. Click Done to exit the installation wizard.
13. (Optional) If the operating system's host name is incorrect or you want BMC Application 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:
    • Change the host name for communication with the Portal
    • Change the host name for communication with the Collector

Where to go from here

Verify that the BMC Application Diagnostics Server installation is successful.

Install the BMC Application Diagnostics Agent.

Configure the BMC Application Performance Management console.