Changing BMC Application Diagnostics Portal settings

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

• For Windows
  <InstallationDirectory>\portal\properties

• For 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. Before changing your password, encrypt it first. See Encrypting passwords. 

   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. Before changing your password, encrypt it first. See Encrypting passwords. 

   database.password.enc=ABCD9876

BMC Real End User Experience Monitoring integration

Edit the apm.console.url parameter to change the host to your BMC Application Management Console’s host:

Where
 <console_host> is the BMC Application Performance Management Console host
 <console_port> is the port of the BMC Application Performance Management Console host, if the default port was changed during the Portal installation.

This will activate the Real User Analyzer address to BMC Application Diagnostics, from BMC Real End User Experience Monitoring views.

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

Passwords are encrypted. Before changing your password, you must encrypt it first.

To encrypt a password:

For Windows

1. Open a command prompt, and run the following command:
   <InstallationDirectory>\portal\bin\passwordEncrypt.bat <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 properties file.

For Linux

1. Run the following command:
   <InstallationDirectory>/portal/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 properties file.