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
  - To run the one-click validation utility
- Resolving validation test errors

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.

Before you begin

Ensure that you import the relevant SSL certificate for BMC Server Automation on the computer from where you will run this utility.

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.

Note

Errors, if any, are logged in a file called OneClickTest.log located in the Install Directory\BAO\Utilities\OneClickTest\logs folder.

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	AO tables are not created or configured correctly in SQL adapter. AO: Query to table 'AUTOMATIONHOSTS' failed AO: Query to table 'INCOMINGMESSAGES' failed
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	Cannot establish a network connection to the AR System server. SSL Certificate not imported correctly. Time-out occurred. Authentication failed. Make sure that your user name and password were entered correctly.
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	{{code language="none"}} You have no access to inbound interface form. {{/code}}
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"}} You have no access to the outbound interface form {{/code}}.
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.