Page tree
Skip to end of metadata
Go to start of metadata

You can change the App Visibility proxy settings, such as the host name of the computer or port numbers, in the apm-proxy.properties file located in the following directories:

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

Note

After you change the apm-proxy.properties file, restart the App Visibility proxy service.

This topic presents the following procedures:

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

By default, App Visibility uses the operating system’s configured host name to communicate between components.

You can override the default host name configuration in 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, and save the file.
  3. Restart the App Visibility proxy service.

To change the App Visibility proxy port numbers

  1. On the App Visibility proxy, open the apm-proxy.properties file.
  2. Modify the App Visibility proxy HTTPS listening port. The default port is 8300.

    tomcat.https.listening.port=8300
  3. Modify the App Visibility proxy supportability port. The default port is 8301.

    tomcat.supportablity.port=8301
  4. Save the file and restart the App Visibility proxy service.

To set security properties for the proxy

JavaScript fetch is used to collect end-user metrics. If your pages are only HTTP, you can change the protocol of the JavaScript fetch API to work with HTTP, instead of the default HTTPS. With HTTP, you do not need to import a keystore file. After you modify the value in the apm-proxy.properties file, save the file and restart the proxy service.

js.path.protocol=http

Warning

To provide a new keystore file that handles SSL-encrypted beacons and injected requests, see Importing a keystore file or replacing the certificate for the App Visibility proxy . Do not modify the keystore settings in the Beacon Receiver Port section of the apm-proxy.properties file.

Related topics

Changing App Visibility collector settings

Changing App Visibility portal settings

Starting and stopping the App Visibility server services

Changing security certificates in App Visibility components