Changing settings of the agent for Java


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

After making changes directly to this file, 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 port 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 is encrypted. To change your password, encrypt it first.

    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 using the following procedure.

  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*