Page tree

You can change the APM proxysettings in the apm-proxy.properties file located in the following directories:

  • Windows
    installationDirectory\apm-proxy\properties
  • Linux
    installationDirectory/apm-proxy/properties

Note

After making changes directly to the apm-proxy.properties file, restart the APM Proxy service.

This topic presents the following procedures:

To change the host name for communication with the APM proxy (or access through a load balancing or reverse proxy server)

By default, BMC Application Diagnostics uses the operating system’s configured host name to communicate between components.

Override the default host name configuration for any of the following situations:

  • If the default APM proxy host name is incorrect, for example, if the automatically detected host name is not the fully qualified device name (FQDN), you need to replace the host name with the FQDN.
  • If APM proxy is behind a load balancing or reverse proxy server, then you must replace the host name or IP address with that of the intermediary server. The property value directs end-user browser data through the load balancing or reverse proxy server and must be accessible from all browsers. You need to configure the load balancing or reverse proxy server to forward requests to the APM proxy.

Perform the following procedure to override the default host name configuration:

  1. Open the apm-proxy.properties file.
  2. Change the callback.address value to the required host name or IP address.
  3. Restart the APM Proxy service.

To change the port numbers

  1. Modify the APM proxy HTTP listening port. The default port is 8300.

    tomcat.http.listening.port=8300
  2. Modify the APM proxy HTTPS listening port. The default port is 8343.

    tomcat.https.listening.port=8343
  3. Restart the APM Proxy service.

To set security properties

  1. Set the security level of http connection:

    connection.security.level=not_secured

    The following options are valid:

    • not_secured
    • encrypted_authenticated
  2. Restart the APM Proxy service.

Warning

To provide a new KeyStore file that handles SSL-encrypted beacons and injected requests, see Importing a KeyStore file to replace the self-signed certificate. Do not modify the KeyStore settings in the Beacon Receiver Port section of the apm-proxy.properties file.