Configuring the BMC Atrium Orchestrator components
The Atrium Orchestrator integration is available in version 11.0.00.02 and later.
At a minimum, this integration requires BMC Atrium Orchestrator Platform 7.9 to be installed. Also, BMC Triage and Remediation Solution run book version 20.17.01 or earlier must be installed. This run book is deprecated from TrueSight Orchestration Content 20.18.01 onwards.
For more information, see the following links:
The following sections provide an overview of the steps required to configure the BMC Atrium Orchestrator adapters and modules required for the Triage and Remediation Solution. For more information about modifying adapter and module configurations, see the of the BMC Atrium Orchestrator documentation.
Configure the required adapters
Adapters provide the interface between workflow processes, external systems, and applications. BMC Atrium Orchestrator configures adapters to establish connections and facilitate communications. The following table lists the required adapters, their user guides, and where you can find more information about working with them:
Description of adapters required for Triage and Remediation Solution
|Adapter name||Description||User guide|
|Windows command line||The Windows command adapter is used to run commands on remote hosts running Windows operating systems.||BMC Atrium Orchestrator Base Adapters User Guide|
|BMC Remedy Action Request System (ARS) application adapter and Remedy monitor adapter||ARS application adapter and Remedy monitor adapter performs actions on BMC Remedy ARS schemas.||BMC Atrium Orchestrator Application Adapter User Guide for Remedy AR System|
|BMC Event Manager and ProactiveNet||Interfaces with Infrastructure Management and the BMC Event Manager system||BMC Atrium Orchestrator Application Adapter User Guide for BMC Event Manager and ProactiveNet|
|SSH||The SSH adapter is used to run commands on a remote host through the SSH protocol.||BMC Atrium Orchestrator Base Adapters User Guide|
|Telnet||The Telnet adapter is used to run commands on a remote host through the Telnet protocol.||BMC Atrium Orchestrator Base Adapters User Guide|
|Tivoli Storage Manager actor adapter||The Tivoli Storage Manager (TSM) actor adapter resides on the TSM node and enables communication with the Backup and Recovery workflow.||None|
|SQL actor adapter||The SQL actor adapter is used to run commands on the specified database.||BMC Atrium Orchestrator Base Adapters User Guide|
To configure an adapter on a grid
Open the Grid Manager application.
To open Grid Manager, use a web browser to navigate to the Grid Manager application: http://hostName or IPaddress:CDPWebServerPort/baocdp/gm
This URL is an example where hostName or IPaddress indicates the IP address or host name of the server, where the CDP is installed (example localhost, server1, 192.168.1.123) and where CDPWebServerPort reflects the actual web server port defined during the CDP server installation. (The default port number is 8080.)
If security is installed in your environment, the Access Manager log on page is displayed. Log on using the user name and password provided by your administrator. The default username and password are
- Select Manage > Adapters.
Select the Adaptercheck box that is required.
To review BMC Atrium Orchestrator adapter information, see the Adapter configurations parameters and nodes table.
- Configure the adapter type that you just added.
The adapter is added to the Adapters on Grid table.
For specific configuration node requirements, open the Current Operation: Edit an Adapter Configuration view. Switch to the XML view, and update the XML configuration document specified for the adapter. For more information, see Event Adapter User Guide. Some adapters do not require a specific configuration node. In such cases, enter the <config/> XML text in the Properties field.
- Repeat step 3 to step 6 for each required adapter.
Adapter configurations parameters and nodes
|Adapter||Configuration parameters||Configuration node|
|BMC Remedy AR System application adapter|
Enter the adapter configuration properties in XML format. Add the following required elements:
|BMC Remedy Monitor adapter|
Enter the adapter Configuration properties in XML format. Add the following required elements:
To enable the PATROL CLI command to work on Windows, add the following parameter to the Windows command line configuration:
|BMC Event Manager and ProactiveNet monitor adapter|
Enter the adapter configuration properties in an XML format. Add the following required elements:
The values for these elements must match the values in themcell.dir file
|BMC Event Manager and ProactiveNet actor adapter.|
Enter the adapter configuration properties in XML format. Add the following required elements:
|SQL actor adapter|
|TSM actor adapter|
Add the following credential definitions for the TSM client to the adapter's configuration file:
Enable the required adapters
The Triage and Remediation Solution solution requires that the adapters listed in the following table are installed by using the BMC Atrium Orchestrator content installer. After the content installation is completed, import the adapter wrappers into BMC Atrium Orchestrator Development Studio and enable them on the CDP.
To enable an adapter on a grid
- In Grid Manager, select Manage > Peers.
- From the peers list, select the peer where you want to enable the adapter, and then click the Edit icon.
- In the New Adapters section, click Enable.
- Select the adapters that you want to enable, and click OK.
- After selecting the adapters, click OK to enable the adapters on the grid.
Configure and deploy the required OA management modules
The Triage and Remediation Solution requires that the following modules are installed by using the BMC Atrium Orchestrator content installer. After the content installation is completed, import and unbundle the modules into BMC Atrium Orchestrator Development Studio.
OA management modules required for the Triage and Remediation Solution
|AutoPilot OA Change Management||Enables you to control the lifecycle of all changes with minimum disruption to IT services. Specific processes exist for interfacing with BMC Remedy ITSM change management.|
|AutoPilot OA Configuration Management||Enables you to manage configuration items. Specific processes exist for interfacing with BMC Remedy ITSM change management and BMC Atrium CMDB.|
|AutoPilot OA Incident Management||Enables you to manage incident requests. Specific processes exist for interfacing with service request management systems and BMC Remedy ITSM.|
|AutoPilot OA Task Management||Enables you to perform tasks in response to service tickets. Specific processes exist for interfacing with service request management systems and BMC Remedy ITSM.|
|AutoPilot Common Utilities||Contain predeveloped processes representing platform processes used across all operations actions modules.|
|AutoPilot AD Utilities||Predeveloped processes containing common application-related commands used in Red Hat Linux, Oracle Solaris, and Microsoft Windows environments.|
|AutoPilot Event Management||Contains configuration information that each workflow uses. The module provides complete configurations for BMC Event Management, HP Service Center, and IBM Netcool OMNIbus environments.|
|AutoPilot Credentials Store||Contains the user names and passwords required to access the computers that you are managing with Triage and Remediation Solution and to communicate with PATROL.|
|AMD AD BMC Remedy ARS module||Wrapper that contains the AR adapters|
|RBA AD BMC Event Manager module||Wrapper that contains the Infrastructure Management and BMC Event and Impact Management adapters|
To complete the module integration
- Import and unbundle the modules in the BMC Orchestrator Development Studio.
- Configure each module according to the instructions in Configure and deploy the required OA management modules.
- Export and enable the modules in Grid Manager.
To import and unbundle a module
- Open Development Studio and click Library Manager.
- Click Import Modules.
Click From Grid, and then select the grid that contains the module that you want to import.
If you are working offline in Development Studio, the login Window prompts you to log on to import a module from the grid library.
The Library Manager retrieves a list of available modules on the selected grid, and displays them in the Import modules pane. By default, only new modules are displayed. To display all modules on the selected grid, select Show All Versions.
- Check Unbundle for each module that you want to import and unbundle.
- Click Import.
Before you enable the module, modify its configuration to match the information you entered when you configured incident, change, and task templates in your BMC Remedy ITSM system.
You can configure the modules by using Grid Manager, or you can configure the modules by using Development Studio and then export the module configuration to the grid to keep the changes intact.
Modify the BMC Atrium Orchestrator modules in Development Studio
- From Development Studio, click Designer View.
- In the Project Explorer under Applications, double-click a module to expand it.
- Double-click Configuration to open the module Configuration Editor.
- Under Configuration, double-click the configuration group to display the configuration group items.
- Double-click a group item to view the configuration items within that group.
- Update the value of the configuration items in the group according to the information shown in Configuring the Credential Store and Configuring the Triage and Remediation module.
- Double-click a configuration item, make the required changes to the value, and click Save.
- Repeat the process of modifying the configuration groups until you finish customizing them for your environment.