Troubleshooting the Integration Service

This topic lists troubleshooting tips that you can use if you run into problems when using the Integration Service.

The Integration Services pconfig variable points to an Integration Service in a disconnected state

When you add an Integration Service to a Infrastructure Management Server using the TrueSight console, and the Integration Service does not get connected when adding it, it appears to be in a disconnected state. In this case, the staging adapter port number for the Integration Service is set as 3183 by default. If the staging adapter port number that you specified when installing the Integration Service is other than the default value of 3183, then on the PATROL Agent you must update the value of the /AgentSetup/integration/integrationServices pconfig variable (if you configured the Integration Service field using the Staging Policy Configuration dialog box) or the value of the /ConfigData/AgentSetup/integration/integrationServices pconfig variable (if you configured the Integration Service field using the Monitoring Policy Configuration dialog box) with the staging adapter port number you specified. You can update the value of the pconfig variable using the PATROL Agent Configuration Utility. For information about pconfig variables, see Using pconfig to configure the BMC PATROL Agent

Integration Service displays as unknown on a Linux-based BMC TrueSight Infrastructure Management Server

The Integration Service displays as unknown in Central Monitoring Administration. Also, you cannot access the Administrator Console remotely.

Solution

1. On the BMC TrueSight Infrastructure Management Server, locate the /etc/hosts file.
2. Search for any one of the following entries:
   

   127.0.1.1
   :::1

3. Comment the above entries and save the /etc/hosts file.

4. Restart the BMC TrueSight Infrastructure Management Server.

Unable to restore Integration Service security certificates

If the Integration Service upgrade fails, you may not be able to restore the original keystore, and keystore password files from the automatically backed up location that is  <installationDirectory\Agent\backup_security_<oldversion>. During the Integration Service upgrade, you are asked to take a manual backup of the keystore, and keystore password files . Restore the security certificates from this manually backed up files.