Changing portal settings

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

• Windows
  <InstallationDirectory>\portal\properties

• Linux
  <InstallationDirectory>/portal/properties

After making changes directly to the the portal.properties file, restart the Portal service.

Changing the host name for communication with the Portal

By default BMC Application Diagnostics uses the operating system’s configured host name to communicate between components. The Portal’s host name must be reachable from the Agent and Collector 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 portal.properties file.
2. Change the callback.address value to the correct host name or IP address that you want the components to use when connecting to the Portal.

Changing ports

1. Set the BMC Application Diagnostics Portal HTTP listening port. The default port is 8100.

   tomcat.http.listening.port=8100

2. Set the BMC Application Diagnostics Portal HTTPS listening port. The default port is 8143.

   tomcat.https.listening.port=8143

3. Set the port on which the BMC Application Diagnostics Portal will listen for connections signaling it to shut down:

   shutdown.port=8109

Setting security properties

1. Set the security level of http connection:

   connection.security.level=not_secured

   Options include:

   • not_secured
   • encrypted
   • encrypted_authenticated

2. Set the keystore file location for SSL secured connection:

   key.store.file.path=/portal/security/adopskeystore.jks
   trust.store.file.path=/portal/security/adopstruststore.jks

3. Set the password for the BMC Application Diagnostics Server certificate file.
    The password is encrypted. To change your password, encrypt it first.

   key.store.password.enc=FGHI

Database settings

1. Set the database location:

   database.url=jdbc:mysql://localhost:3306/adops_portal

2. Set the password to access the database. The password is encrypted. To change your password, encrypt it first.

   database.password.enc=ABCD9876

Configuring SNMP events

1. Set the interval in seconds between consecutive runs of the event trapping task (5 minutes by default):

   event.trapping.task.interval.sec=300

2. Set event reporting flags (to specify that the BMC Application Diagnostics Portal reports, through SNMP, error violations, duration violations, and stale agents):

   event.trapping.should.collect.error=false
   event.trapping.should.collect.duration=false
   event.trapping.should.collect.agents=false

3. Set the host and port of the SNMP destination:

   event.trapping.snmp.destination.ip=localhost
   event.trapping.snmp.destination.port=162

4. Set the OIDs of the trap and the message when reporting on violations:

   event.trapping.snmp.oid.violation.trap=1.3.6.1.6.3.1.1.4.1.1.1
   event.trapping.snmp.oid.violation.message=1.3.6.1.6.3.1.1.4.1.1.0

5. Set the OIDs of the trap and the message when reporting on stale agents:

   event.trapping.snmp.oid.agents.trap=1.3.6.1.6.3.1.1.4.1.2
   event.trapping.snmp.oid.agents.message=1.3.6.1.6.3.1.1.4.1.2.0

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\portal\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/portal/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.