Short maintenance outage Saturday

This site, docs.bmc.com, will undergo a brief outage for maintenance at 2 A.M. CDT Saturday, April 4. Total downtime will be less than five minutes.

Page tree

Short maintenance outage Saturday

This site, docs.bmc.com, will undergo a brief outage for maintenance at 2 A.M. CDT Saturday, April 4. Total downtime will be less than five minutes.

Skip to end of metadata
Go to start of metadata

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.

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

  1. 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:
  2. Create the following environment variable:
    • JAVA_HOME to point to JDK 1.8 folder.
  3. Go to the command prompt and change directory to the Install Directory\BAO\Utilities\OneClickTest folder.
  4. Run the following command:
    • (WindowsOneClickTest.bat
    • (UNIXOneClickTest.sh
  5. 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

DescriptionChecks connectivity to the BMC Atrium Orchestrator database (embedded or external).
Possible errors
  1. AO tables are not created or configured correctly in SQL adapter.
  2. AO: Query to table 'AUTOMATIONHOSTS' failed
  3. 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

DescriptionChecks connectivity to the AR System server through BMC Atrium Orchestrator.
Possible errors
  1. Cannot establish a network connection to the AR System server.
  2. SSL Certificate not imported correctly.
  3. Time-out occurred.
  4. 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

DescriptionChecks connectivity to the inbound web service CHG_ChangeServiceInterface.
Possible errors
  1. You have no access to inbound interface form.
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

DescriptionChecks connectivity to the outbound web service CHG_ChangeOutboundInterface.
Possible errors

You have no access to the outbound interface form.

Corrective actionEnsure 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

DescriptionChecks 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

DescriptionChecks whether the BMC Server Automation user that is configured has only a single role associated to it.
Possible errorsThe 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 Selection in the BMC Server Automation 8.9 online documentation.