Changing settings for BMC Application Diagnostics Agent for Java

You can change the settings for BMC Application Diagnostics Agent for Java in the portal.connection.properties file located in the ADOPsInstall/properties directory.

After making changes directly to this files, you must restart the Agent.

Updating Agent parameters

The following properties can be updated to allow the Agent to connect to the Portal.

• Host name or IP address on which the Portal is installed
   Default is localhost 

  portal.connection.ip=localhost

• Port to use when communicating with the Portal
   Default is 8100 

  portal.connection.port=8100

• Proxy server host and port when communicating with the Portal and Collector
   Default is blank; connection will be executed directly, without using a proxy server 

  outbound.http.connection.proxy.host=
  outbound.http.connection.proxy.port=
  outbound.https.connection.proxy.host=
  outbound.https.connection.proxy.port=
  outbound.socks.connection.proxy.host=
  outbound.socks.connection.proxy.port=

• The number of milliseconds to wait before connecting to the Portal
   Increase this value if a warning message is displayed, and the application server fails to start, or is not working properly. Default is 10000 (10 seconds) 

  portal.connection.delay=10000

• Application server name to display in the BMC Application Performance Management console 

  host.display.name=

• Application name to display in the application server
   Default is blank. 

  application.display.name=

• Agent web console ports range
   This specifies the lowest and highest port numbers for Agent's ports in the range (inclusive) from 1024 to 65536. Defaults are 50000 and 51000. 

  agent.web.console.port.range.min=50000
  agent.web.console.port.range.max=51000

• Server certificate file for HTTPS connection with the Portal 

  key.store.file.name=adopskeystore.jks

• Client certificate file for client authentication with the Portal 

  trust.store.file.name=adopstruststore.jks

• Password for Server certificate file for HTTPS connection with the Portal
   The password must be encrypted. 

  key.store.password.enc=YZ22D+YsakY=

• Algorithm for client SSL authentication with the Portal (SunX509/IbmX509) 

  ssl.algorithm=

• Provider for client SSL authentication with the Portal (SunJSSE) 

  ssl.provider=

Encrypting passwords

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

1. Run the following command:
   <InstallationDirectory>/collector/bin/passwordEncrypt.sh <NewPassword>
    A message displays while the password is encrypted.
    Once encrypted, the secret password is displayed.
2. Copy the encrypted secret password and paste it in the relevant location in the properties file.