Changing collector settings


You can change the BMC Application Diagnostics Collector settings in the collector.properties file located in the following directories:

  • Windows
    <InstallationDirectory>\collector\properties
  • Linux
    <InstallationDirectory>/collector/properties

After making changes directly to the the collector.properties file, restart the Collector service.

Changing the host name for communication with the Collector

By default BMC Application Diagnostics uses the operating system’s configured host name to communicate between components. The Collector’s host name must be reachable from the Agent and Portal computers.

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 as follows:

  1. Open the collector.properties file.
  2. Change the callback.address value to the correct host name or IP that you want components to use when connecting to the Collector.

Changing ports

  1. Set the BMC Application Diagnostics Collector's HTTP listening port.
    The default port is 8200.

    tomcat.http.listening.port=8200
  2. Set the BMC Application Diagnostics Collector's HTTPS listening port.
    The default port is 8243.

    tomcat.https.listening.port=8243
  3. Set the port on which the BMC Application Diagnostics Collector listens for connections signaling it to shut down.
    The default port is 8209.

    shutdown.port=8209

Configuring portal connection

Set the portal connection.

portal.connection.ip=localhost
portal.connection.http.port=8100
portal.connection.https.port=8143

Note

When entering IPv6 addresses, you must enter the IP address in square brackets. For example:
portal.connection.ip=[::1]

Database settings

  1. Set the database location.

    database.url=jdbc:mysql://localhost:3306/adops_collector
  2. Set the password to access the database.
     The password is encrypted. To change your password, encrypt it first.

    database.password.enc=ABCD1234

Proxy settings

If the collector uses a proxy to connect to the portal, configure the proxy details. If you do not need to configure a proxy, leave the values empty.

  1. Set the proxy details for HTTP:

    http.proxy.host=
    http.proxy.port=
  2. Set the proxy details for HTTPS:

    https.proxy.host=
    https.proxy.port=
  3. Set the proxy details for SOCKS:

    socks.proxy.host=
    socks.proxy.port=

    Note

    If you are configure the proxy settings, you must make additional configuration changes to the BMC Application Diagnostics Agent settings.

Encrypting passwords

Before changing your password, you must encrypt it using the following procedure.

To encrypt a password

Windows

  1. Open a command prompt, and run the following command:
    installationDirectory\collector\bin\passwordEncrypt.bat newPassword
     A message is displayed during encryption and then the encrypted password is displayed.
  2. Copy the encrypted password and paste it in the relevant properties file.

Linux

  1. Run the following command:
    installationDirectory/collector/bin/passwordEncrypt.sh newPassword
     A message is displayed during encryption and then the encrypted password is displayed.
  2. Copy the encrypted password and paste it in the relevant properties file.

 

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