By default, App Visibility uses pregenerated, self-signed certificates for authentication between the components. If you prefer to use your own certificates, you need to edit each of the following files to create new KeyStore files and TrustStore files that point to the correct location for each component.
Notes
This topic contains the following sections:
Install and configure App Visibility components.
In the portal.properties file, located on the App Visibility portal computer, make the required changes and restart the portal service.
InstallationDirectory
with the full path.KeystoreFileName
with the name of your KeyStore file.TruststoreFileName
with the name of your TrustStore file.encryptedPassword
with your encrypted password.Windows | |
---|---|
File name | portal.properties |
File location | InstallationDirectory \portal\properties |
Configuration options |
|
Linux | |
---|---|
File name | portal.properties |
File location | InstallationDirectory /portal/properties |
Configuration options |
|
In the collector.properties file, located on each App Visibility collector computer, make the required changes and restart the collector service.
InstallationDirectory
with the full path.KeystoreFileName
with the name of your KeyStore file.TruststoreFileName
with the name of your TrustStore file.encryptedPassword
with your encrypted password.Windows | |
---|---|
File name | collector.properties |
File location | InstallationDirectory \collector\properties |
Configuration options |
|
Linux | |
---|---|
File name | collector.properties |
File location | InstallationDirectory /collector/properties |
Configuration options |
|
In the agent.properties file, located on each App Visibility agent computer, make the required changes and restart the agent.
KeystoreFileName
with the name of your KeyStore file.TruststoreFileName
with the name of your TrustStore file.encryptedPassword
with your encrypted password.Windows | |
---|---|
File name | agent.properties |
File location | InstallationDirectory \ADOPsInstall\properties |
Configuration options |
|
Linux | |
---|---|
File name | agent.properties |
File Location | InstallationDirectory /ADOPsInstall/properties |
Configuration options |
|
In the agent.properties file, located on each App Visibility agent computer, make the required changes and restart the agent.
KeystoreFileName
with the name of your KeyStore file.TruststoreFileName
with the name of your TrustStore file.encryptedPassword
with your encrypted password.Notes
Windows, only | |
---|---|
Configuration file name | agent.properties |
Configuration file location | InstallationDirectory\properties |
Configuration options |
|
In the adops_rest.properties file, located on Presentation Server computer, make the required changes and restart the service.
InstallationDirectory
with the full path.KeystoreFileName
with the name of your KeyStore file.encryptedPassword
with your encrypted password.Linux, only | |
---|---|
File name | adops_rest.properties |
File Location | InstallationDirectory/conf/props |
Configuration options |
|
Refer to the Java Keytool documentation on the Oracle website.
If you are changing certificates in a system that includes the BMC Synthetic Transaction Execution Adapter (TEA) Agent for synthetic transaction monitoring, do not change the name or password of the new certificates or the TEA Agent cannot communicate with the server.
The TEA Agent requires privateKey.pem and clientCert.pem files. Use the following procedure to convert .pfx files to the required .pem format.
In a command prompt on the computer with the TEA Agent installation, run the following OpenSSL commands:
openssl pkcs12 -in yourP12File.pfx -nocerts -out privateKey.pem
openssl pkcs12 -in yourP12File.pfx -clcerts -nokeys -out clientCert.pem
Use an encrypted password so that the plain text password is not displayed in your property files. After you encrypt the new password, copy the encrypted password to the relevant property file.
Windows
InstallationDirectory\portal\bin\passwordEncrypt.bat NewPassword
Linux
InstallationDirectory
/portal/bin/passwordEncrypt.sh NewPassword
Importing a KeyStore file or replacing the certificate
Changing the App Visibility database password
Starting and stopping services
Changing the App Visibility agent settings
Changing App Visibility collector settings
Changing App Visibility portal settings
Changing App Visibility proxy settings