Validating integrations
BMC Change Automation integrates BMC BladeLogic Automation system and BMC Remedy Change Management system through BMC Atrium Orchestrator. After you install BMC Change Automation, it is recommended that you perform the one click integration validation test to validate whether the integrations are working correctly. If the integration fails, you can use the resolutions provided in this topic to fix the errors and run the one click validation test again.
Running the one-click validation utility
The one-click validation utility is a primary diagnostic tool that performs a quick health check and validates the BMC Change Automation integration.
BMC recommends that you run the utility every time a configuration changes. For example, when there is a change in the host system configuration, you must manually run the one-click validation utility. This utility is available in the Install Directory\BAO\Utilities\OneClickTest folder.
To run the one-click validation utility
- Edit the inputParametersForOneClick.xml file located in the Install Directory\BAO\Utilities\OneClickTest folder to add BMC Remedy AR System and BMC Server Automation connection details.
The following images shows an example of connection details: - Create the following environment variable:
- JAVA_HOME to point to JDK 1.8 folder.
- Go to the command prompt and change directory to the Install Directory\BAO\Utilities\OneClickTest folder.
- Run the following command:
- (Windows) OneClickTest.bat
- (UNIX) OneClickTest.sh
- Review the output of the one-click test. The results are logged in a file called oneclicktestresult.xml file.
Resolving validation test errors
Use the information provided in this topic to understand the checks and the corrective actions to be taken if any of the checks show an integration failure during an end-to-end integration test.
Test: AO database connectivity
Description | Checks connectivity to the BMC Atrium Orchestrator database (embedded or external). |
---|---|
Possible errors |
|
Corrective action | Ensure that the database tables: 'INCOMINGMESSAGES' and 'AUTOMATIONHOSTS' are created in the database and configured correctly in the CLA_DBActorAdapter. If you are using an external database, you must create the database tables manually. For more information, see Creating-database-tables. |
Test: AR Connectivity via AO
Description | Checks connectivity to the AR System server through BMC Atrium Orchestrator. |
---|---|
Possible errors |
|
Corrective action | If you receive the SSL Certificate related error, ensure that you import the relevant SSL certificate. Check your network connectivity. Ensure that the AR server user name and password that were used during CA installation or configuration are available. |
Test: Accessibility:CHG_ChangeServiceInterface
Description | Checks connectivity to the inbound web service CHG_ChangeServiceInterface. |
---|---|
Possible errors |
|
Corrective action | Ensure that the AR server user name has permissions to access the inbound and outbound interface forms. Ensure that the supported version of BMC Remedy Change Management (version 9.1.02 or later) is installed. For more information about supported versions, see Supported-products-and-versions. |
Test: Accessibility:CHG_ChangeOutboundInterface
Description | Checks connectivity to the outbound web service CHG_ChangeOutboundInterface. |
---|---|
Possible errors | {{code language="none"}} |
Corrective action | Ensure that the supported version of BMC Remedy Change Management (version 9.1.02 or later) is installed. For more information about supported versions, see Supported-products-and-versions. |
Test: Accessibility:Blade connectivity via AO
Description | Checks connectivity to the BMC Server Automation host. |
---|---|
Possible errors | Connection details of Automation host not present or are incorrect in AO. |
Corrective action | Ensure that the BMC Server Automation user name and password that were used during CA installation or configuration are available. |
Test: Accessibility:BMC Server Automation user role verification via AO
Description | Checks whether the BMC Server Automation user that is configured has only a single role associated to it. |
---|---|
Possible errors | The BSA user (user_name) that is configured has multiple roles associated with it. |
Corrective action | Configure a user that has a single role associated to it. For more information, see User Role Selectionin the BMC Server Automation 8.9 online documentation. |