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.

  • Spaces
  • People
  • Help
    • BMC Support Central BMC Communities BMC.com
    ×
    BMC Change Automation 2.0

    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:
      • (Windows) OneClickTest.bat
      • (UNIX) OneClickTest.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.

    © Copyright 2005-2020 BMC Software, Inc.