This version of the documentation is not fully supported. However, the documentation is available for your convenience. You will not be able to leave comments.

See information on this topic in the latest version (11.3.01) or versions 11.0, 10.7, and 10.5.

This topic describes how to install the App Visibility server components with the installation wizard. You can use the installation wizard, as described in this topic, or perform a silent installation (also called unattended installation), which requires no user interaction during installation and can be deployed over several computers.

The App Visibility server includes the following components:

  • One App Visibility portal component
  • One or more App Visibility collector components
  • One or more App Visibility proxy components

For details about the components, see Installing the App Visibility server components.

Perform the following procedures to install the App Visibility server components. For a very small environment or a test environment, you can install the portal, one collector, and one proxy on the same computer. When the App Visibility portal and collector components are installed on the same computer, they share the same database.

For most production environments, you install one App Visibility portal on one computer, several App Visibility collectors (each on a separate computer), and App Visibility proxies on separate computers that are in the network's demilitarized zone (DMZ).

This topic presents the following sections:

Before you begin

Ensure that you have completed all preinstallation tasks.

The App Visibility proxy uses SSL-encrypted beacons and injection requests and therefore requires a KeyStore with a certificate that is trusted by the end users’ browsers. You can import the KeyStore during proxy installation or after installation.

Note

If you have some App Visibility server components from an earlier version, and you want to add server components to the same computer, upgrade the earlier components before you install new components.

To install the App Visibility portal

 Click here to expand steps.
  1. On the computer where you want to install the App Visibility portal, launch the installation wizard:
    • (Windows)

      Navigate to ADOPServer\Disk1 and double-click setup.exe.

      In Windows 2008, you might need to right-click the setup.exe icon and select Run as administrator.

    • (Linux)
      1. Ensure that you have set the DISPLAY environment variable.
      2. Navigate to ADOPServer/Disk1 and run setup.bin.
  2. On the App Visibility 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 ends.
  4. Select Install App Visibility Portal and then click Next.

  5. On the Directory Selection page, enter the path for the installation directory or click Browse and then click Next.

    Ensure that the specified directory is empty.

    • (Windows) Default directory: C:\Program Files\BMC Software\App Visibility

    • (Linux) Default directory: /opt/bmc/App_Visibility

      Best practice

      On Linux computers, use the default installation directory. Otherwise, you might experience issues related to permissions and access.
  6. On the Portal Configuration page, define the following options and then click Next.
    Ensure that the port numbers you enter are available.

    Option

    Description

    Portal Connection

    Communication Port

    Listening port of the App Visibility portal

    The default port is 8100.

    KM Integration and Supportability Port

    Listening port of the portal support console. A support console, which helps detect issues, is automatically activated with one-way SSL authentication.

    The default port is 8101.

  7. Enter the following values on the Database Configuration page and then click Next.

    Option

    Description

    Database Port

    Listening port of the App Visibility portal database

    The default port is 3301. The new database is created under the installationDirectory\ADOP_DB directory.

    Data Retention Time (days)

    Number of days before which the historical data on the App Visibility portal database is overwritten

    The default time is 35 days. The overwrite function launches automatically when the system reaches the specified retention time.

    Maximum Data Storage (GB)

    When the database reaches the maximum size, historical data is overwritten, regardless of the value defined in the database retention time parameter.

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

  9. After the installation is complete, click View Log to view the installation log files and confirm that the installation process was successful.
  10. Click Done to exit the installation wizard.
  11. If the operating system's host name is incorrect or you want the App Visibility portal to use an IP address to connect to other components, change the host name for communication with the portal.

To install an App Visibility collector

 Click here to expand steps.
  1. On the computer where you want to install the App Visibility collector, launch the installation wizard:
    • (Windows)

      Navigate to ADOPServer\Disk1 and double-click setup.exe.

      In Windows 2008, you might need to right-click the setup.exe icon and select Run as administrator.

    • (Linux)
      1. Ensure that you have set the DISPLAY environment variable.
      2. Navigate to ADOPServer/Disk1 and run setup.bin.
  2. On the BMC TrueSight App Visibility Manager 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 ends.
  4. Select Install App Visibility Collector and then click Next.

  5. On the Directory Selection page, enter the path for the installation directory or click Browse and then click Next.

    Ensure that the specified directory is empty.

    • (Windows) Default directory: C:\Program Files\BMC Software\App Visibility

    • (Linux) Default directory: /opt/bmc/App_Visibility

      Best practice

      On Linux computers, use the default installation directory. Otherwise, you might experience issues related to permissions and access.
  6. On the Collector Configuration page, provide the following system connection information and then click Next.
    Ensure that the port numbers you enter are available.

    Option

    Description

    Communication Port

    Listening port of the App Visibility collector

    The default port is 8200.

    Supportability Port

    Listening port of the collector support console. A support console, which helps detect issues, is automatically activated with one-way SSL authentication.

    The default port is 8201.

  7. If you install the App Visibility collector on a computer that does not have an App Visibility portal installation, enter the App Visibility portal connection information, click Test Connection to check communication with the portal, and then click Next.

     Click here to expand.

    Option

    Description

    Portal Host or IP

    Portal host name or IP address

    Portal Port

    Listening port of the portal (Enter the same port number that you entered in portal configuration steps. The default value is 8100.)

  8. On the Listening Address Configuration page, confirm the address of the computer on which you are installing the App Visibility collector, and then click Next.

    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 App Visibility components use this address to contact 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 App Visibility collector settings to change the callback.address property.

  9. Enter the following values on the Database Configuration page.

    Option

    Description

    Database Port

    Listening port of the App Visibility portal database

    The default port is 3301. The new database is created under the installationDirectory\ADOP_DB directory.

    Data Retention Time (days)

    Number of days before which the historical data on the App Visibility collector database is overwritten

    The default time is 35 days. The overwrite function launches automatically when the system reaches the specified retention time.

    Maximum Data Storage (GB)

    Maximum disk space allowed for data storage

    The default size is 100 GB. For information about sizing considerations for components installed on the server, see Sizing App Visibility and Synthetic TEA Agent components.

    When the database reaches the maximum size, historical data is overwritten, regardless of the value defined in the database retention time parameter.

  10. 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. If the operating system's host name is incorrect or you want the App Visibility collector to use an IP address to connect to other components, see Changing App Visibility collector settings.

To install the App Visibility proxy

 Click here to expand steps.
  1. On the computer where you want to install the App Visibility proxy, launch the installation wizard:
    • (Windows)

      Navigate to ADOPServer\Disk1 and double-click setup.exe.

      In Windows 2008, you might need to right-click the setup.exe icon and select Run as administrator.

    • (Linux)
      1. Ensure that you have set the DISPLAY environment variable.
      2. Navigate to ADOPServer/Disk1 and run setup.bin.
  2. On the BMC TrueSight App Visibility Manager 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 ends.
  4. Select Install App Visibility Proxy and then click Next.

  5. On the Directory Selection page, enter the path for the installation directory or click Browse and then click Next.

    Ensure that the specified directory is empty.

    • (Windows) Default directory: C:\Program Files\BMC Software\App Visibility

    • (Linux) Default directory: /opt/bmc/App_Visibility

      Recommendation

      On Linux computers, BMC recommends using the default installation directory. Otherwise, you might experience issues related to permissions and access.
  6. On the Proxy Configuration page, provide the following port numbers and then click Next.
    Ensure that the port numbers you enter are available.

    Option

    Description

    Proxy Communication Port

    Listening port of the proxy, communication from the portal and collector

    The default port is 8300.

    Supportability Port

    Listening port of the proxy support console. A support console, which helps detect issues, is automatically activated with one-way SSL authentication.

    The default port is 8301.

    Beacon Receiver HTTP Port

    Listening port of the beacon receiver, HTTP communication from the end users' browsers

    The default port is 880.

    Beacon Receiver HTTPS Port

    Listening port of the beacon receiver, HTTPS communication from the end users' browsers

    The default port is 8444.

  7. On the Proxy KeyStore Configuration page, choose an import option, and then click Next:

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

    • Import the KeyStore post-installation or change the protocol to work with HTTP.
  8. If you are installing the App Visibility proxy on a computer that does not have an App Visibility portal installation, enter the App Visibility portal connection information, and then click Next.

     Click here to expand.

    Option

    Description

    Portal Host or IP

    Portal host name or IP address

    Portal Port

    Listening port of the portal (Enter the same port number that you entered in portal configuration steps. The default value is 8100.)

  9. On the Listening Address Configuration page, confirm the address of the computer on which you are installing the App Visibility proxy, and then click Next.

    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 App Visibility components use this address to contact the computer on which you are installing.

    Note

  10. 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. If the operating system's host name is incorrect or you want the App Visibility proxy to use an IP address to connect to other components, see Changing App Visibility proxy settings.

To install more than one App Visibility server component

 Click here to expand steps.
  1. On the computer where you want to install the App Visibility portal, launch the installation wizard:
    • (Windows)

      Navigate to ADOPServer\Disk1 and double-click setup.exe.

      In Windows 2008, you might need to right-click the setup.exe icon and select Run as administrator.

    • (Linux)
      1. Ensure that you have set the DISPLAY environment variable.
      2. Navigate to ADOPServer/Disk1 and run setup.bin.
  2. On the BMC TrueSight App Visibility Manager 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 ends.
  4. Select the App Visibility server component or components that you want to install, and then click Next:

    • Install App Visibility Portal

    • Install App Visibility Collector 

    • Install App Visibility proxy

    Note

    Installation configuration pages are displayed only for the selected component or components.
  5. On the Directory Selection page, enter the path for the installation directory or click Browse and then click Next.

    Ensure that the specified directory is empty.

    • (Windows) Default directory: C:\Program Files\BMC Software\App Visibility

    • (Linux) Default directory: /opt/bmc/App_Visibility

      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 numbers you enter are available.

    Option

    Description

    Portal Connection

    Communication Port

    Listening port of the App Visibility portal

    The default port is 8100.

    KM Integration and Supportability Port

    Listening port of the portal support console. A support console, which helps detect issues, is automatically activated with one-way SSL authentication.

    The default port is 8101.

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

    Option

    Description

    Communication Port

    Listening port of the App Visibility collector

    The default port is 8200.

    Supportability Port

    Listening port of the collector support console. A support console to help detect issues is automatically activated with one-way SSL authentication.

    The default port is 8201.

  8. (For App Visibility proxy installation) On the Proxy Configuration page, provide the following port numbers and then click Next.
    Ensure that the ports you enter are available.

    Option

    Description

    Proxy Communication Port

    Listening port of the proxy, communication from the portal and collector

    The default port is 8300.

    Supportability Port

    Listening port of the proxy support console. A support console to help detect issues is automatically activated with one-way SSL authentication.

    The default port is 8301.

    Beacon Receiver HTTP Port

    Listening port of the beacon receiver, HTTP communication from the end users' browsers

    The default port is 880.

    Beacon Receiver HTTPS Port

    Listening port of the beacon receiver, HTTPS communication from the end users' browsers

    The default port is 8444.

  9. (For App Visibility proxy installation) On the Proxy KeyStore Configuration page, choose an import option, and then click Next:

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

    • Import the KeyStore post-installation or change the protocol to work with HTTP.
    Click Next.
  10. (For App Visibility proxy or collector installation) If you are installing the App Visibility proxy, the collector, or both on a computer that does not have the App Visibility portal installation, enter the App Visibility portal connection information, click Test Connection to check communication with the portal, and then click Next.

     Click here to expand.

    Option

    Description

    Portal Host or IP

    Portal host name or IP address

    Portal Port

    Listening port of the portal (Enter the same port number that you entered in portal configuration steps. The default value is 8100.)

  11. (For collector or proxy installation) On the Listening Address Configuration page, confirm the address of the computer on which you are installing the App Visibility components, and then click Next.

    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 App Visibility components use this address to contact 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 App Visibility collector settings or Changing App Visibility proxy settings to change the callback.address property.
  12. (For portal or collector installation) Enter the following values in the Database Configuration page and then click Next.

    Option

    Description

    Database Port

    Listening port of the App Visibility portal database

    The default port is 3301. The new database is created under the installationDirectory\ADOP_DB directory.

    Data Retention Time (days)

    Number of days before which the historical data on the App Visibility collector database is overwritten

    The default time is 35 days. The overwrite function is automatically launched when the system reaches the specified retention time.

    Maximum Data Storage (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 the space available on the installation directory and displays a validation error if there is insufficient space.

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

  14. After the installation is complete, click View Log to view the installation log files and confirm that the installation process was successful.
  15. Click Done to exit the installation wizard.
  16. (Optional) If the operating system's host name is incorrect or you want the App Visibility components to use an IP address to connect to other components, override the default host name configuration. The following links provide instructions:

Where to go from here

Verify that the App Visibility server installation is successful.

Change the MySQL root password.

If you did not import the KeyStore file during installation, import the KeyStore post-installation.

Configure network settings.

Install the App Visibility agent for Java.

Install the App Visibility agent for .NET.

Install the BMC Synthetic Transaction Execution Adapter (TEA) Agent

Add the App Visibility portal to the Operations Management Console.

Related topics

Importing a KeyStore file or replacing the certificate

App Visibility installation process overview

BMC TrueSight Operations Management architecture

 

 

Was this page helpful? Yes No Submitting... Thank you
© Copyright 2013-2016 BMC Software, Inc.
© Copyright 2013-2016 BladeLogic, Inc.
Legal notices