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

This topic describes the following changes:

• • To change the host name for communication with the Collector
  • To changing the port numbers
  • To configure the Portal connection
  • To modify database settings
  • To modify proxy settings
  • To encrypt a password

To change 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.

To changing the port numbers

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

To configure the Portal connection

Set the Portal connection.

To modify 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

3. Change the database retention time and size.

   The retention time is in days.
   The database size is in MB.

   retention.time=35
   db.max.size=102400

To modify 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 configure the proxy settings, you must make additional configuration changes to the BMC Application Diagnostics Agent settings.

To encrypt a password

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

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.