This topic lists troubleshooting tips that you can use if you run into problems when deploying packages using the TrueSight console.
Administrators can use packages to install and upgrade monitoring solutions to BMC PATROL Agents. The deployable package is copied to the file system of the Integration Service and target PATROL Agents. It is subsequently extracted and installed on the target PATROL Agents.
In addition to, the following validations are performed:
Checksum mismatch : <chunk filename> on PATROL agent
Chunk missing : <chunk filename> on PATROL agent
Reinitialize the deploy and install process to get a new copy of the package for deployment. For more information, see Deploying packages to PATROL Agents using the TrueSight console.
From the Deployment and Installation Summary page, the PATROL Agent Details page displays a
Security certificate not found on the Integration Service error message.
Ensure that the same certificate is present on both the Presentation Server and the Integration Service host. Perform the following steps for all instances of the Integration Service on the same or on any other computer.
Log on to the host computer where the Presentation Server is installed.
The keytool utility that is used to generate and import the certificates is present in the <TrueSight Presentation Server Installation Directory>\jre\bin directory. Add this directory path to the
PATH environment variable by running the following command:
Run the keytool command as follows:
keytool -export -alias truesightserver -file <filename.cer> -keystore $TRUESIGHTPSERVER_HOME/truesightpserver/conf/secure/loginvault.ks -storepass changeitExample
keytool -export -alias truesightserver -file truesight.cer -keystore $TRUESIGHTPSERVER_HOME/truesightpserver/conf/secure/loginvault.ks -storepass changeit
keytool.exe -export -alias truesightserver -file truesight.cer -keystore %TRUESIGHTPSERVER_HOME%\truesightpserver\conf\secure\loginvault.ks -storepass changeit
Copy the truesight.cer file that is generated at the following temporary location on the Integration Service System:
The steps for updating the system PATH environment variable must be added to be executed on the system where Integration Service is installed. Add the directory path to the PATH environment variable by running one of the following commands:
On the Integration Service server, use the
keytool -importcert -alias <aliasname> -file <cert file location> -keystore "<keystore location>" -storepass changeitcommand to import the certificate in one of the following folders:
Remote IS: <installation_directory>/TSIMAgent/Agent/jre/lib/security/cacerts
keytool -importcert -alias truesightserver -file /tmp/truesight.cer -keystore "$BPPM_AGENT_HOME/Agent/jre/lib/security/cacerts" -storepass changeit
keytool.exe -importcert -alias truesightserver -file C:\temp\truesight.cer -keystore "%BPPM_AGENT_HOME%\Agent\jre\lib\security\cacerts" -storepass changeit
Local IS: <installation_directory>/TrueSight/pw/jre/lib/security/cacerts
keytool -importcert -alias truesightserver -file /tmp/truesight.cer -keystore "$BPPM_SERVER_HOME/pw/jre/lib/security/cacerts" -storepass changeit
keytool.exe -importcert -alias truesightserver -file C:\temp\truesight.cer -keystore "%BPPM_SERVER_HOME%\pw\jre\lib\security\cacerts" -storepass changeit
For Unix, perform the following steps to restart the Integration Service:
Open the Command Prompt.
Navigate to one of the following directories:
Remote IS: $BPPM_AGENT_HOME/Agent/pronto/bin
Local IS: $BPPM_SERVER_HOME/pw/pronto/bin
Execute the following commands to restart the Integration Service
./pw is stop
./pw is start
For Windows, restart the Integration Service [ProNetAgent] by using Windows Services.
When you deploy a package to a PATROL Agent running on IBM AIX, it fails. The RunSilentInstall log file contains the following error:
ERROR: PatrolAgent Cannot bind to RT Server - tcp:localhost:2059 smux bind failure: Address already in use
/opt/bmc/PatrolAgent/Patrol3//AIX7.1-64/bin/snmpmagt: error processing configuration The installation completed successfully.
stopsrc -s snmpd
startsrc -s snmpd
In certain environments, deploying packages to PATROL Agents might fail due to an incorrect Presentation Server host name reference.
Use the Presentation Server external alias instead. Ensure that this host name is accessible from the Integration Service.
tssh properties set CHUNK_URL_HOSTNAME <external_alias>
tssh properties reload
The upgrade process of the PATROL Agent might fail with the following reason:
PATROL Agent installation directory not found.
Restart the PATROL Agent and trigger the deployment again.