Troubleshooting run books

This topic describes the issues that you might encounter while using the BMC Atrium Orchestrator run book, and the workarounds to resolve the issues. 

Troubleshooting the issues with the invalid assignment details in the task template

When you create a change request (CR) with invalid assignment details in the task template, the following message may be displayed:

 The Assignment Information is not valid. Use the menus provided on the Assignee CompanyAssigneeOrganization and Assignee Group or the type ahead return function on the Assignee Group or Assignee fields fields to select this information. 

The assignment issues occur for the following solutions:

  • Continuous Compliance for Databases
  • Continuous Compliance for Networks
  • Continuous Compliance for Servers
  • Triage and Remediation
  • NetApp Solutions

Solution: Create a change request with valid assignment details in the task template for the run books.

 To create a change request with valid assignment details in the task template for the BMC Compliance for Database Automation solution
  1. Navigate to the BMC Remedy AR System home page.
  2. In the Quick Links section, click Application Administration Console.
  3. Click the Custom Configuration tab and then select 
    Task Management System > Template.
  4. Open the Database Automation OIC Task Template task template.
  5. Click the Assignment tab.
  6. Select the same values from the list that you specified at installation 
    for the following fields, and then click Save:
    • Assignee Company
    • Assignee Organization
    • Assignee Group
    • Assignee
    • NotifyAssignee
 To create a change request with valid assignment details in the task template for the BMC Continuous Compliance for Network Automation solution
  1. Navigate to the BMC Remedy AR System home page.
  2. In the Quick Links section, click Application Administration Console.
  3. Click the Custom Configuration tab and then select 
    Task Management System > Template.
  4. Open the Network Task task template.
  5. Click the Assignment tab.
  6. Select the same values from the list that you specified at 
    installation for the following fields, and then click Save:
    • Assignee Company
    • Assignee Organization
    • Assignee Group
    • Assignee
    • NotifyAssignee
 To create a change request with valid assignment details in the task template for the BMC Continuous Compliance for Servers solution
  1.  Navigate to the BMC Remedy AR System home page.
  2. In the Quick Links section, click Application Administration Console.
  3. Click the Custom Configuration tab and then select 
    Task Management System > Template.
  4. Open the BladeLogic Audit Task Template task template.
  5. Click the Assignment tab.
  6.  Select the same values from the list that 
    you specified at installation for the following fields, and then click Save:
    • Assignee Company
    • Assignee Organization
    • Assignee Group
    • Assignee
    • NotifyAssignee
  7. Repeat step 1 through step 6for the following task templates:
    • BladeLogic Compliance Task Template
    • Operator Initiated Change Task Template
    • BladeLogic Audit Task Template
 To create a change request (CR) with valid assignment details in the task template for the BMC Proactivenet Performance Management Triage and Remediation solution
  1.  Navigate to the BMC Remedy AR System home page.
  2. In the Quick Links section, click Application Administration Console.
  3. Click the Custom Configuration tab and then select 
    Task Management System > Template.
  4. Open the Triage Remediation DB Tablespace Full task template.
  5. Click the Assignment tab.
  6.  Select the same values from the list 
    that you specified at installation for the following fields, and then click Save:
    • Assignee Company
    • Assignee Organization
    • Assignee Group
    • Assignee
    • NotifyAssignee
  7. Repeat step 1 through step 6for the following task templates:
    • Triage Remediation ESX Host Not Responding
    • Triage Remediation Failed Backup Recovery
    • Triage Remediation OS Disk Space Full Clean Temp
    • Triage Remediation OS Disk Space Full Compress Logs
    • Triage Remediation OS Disk Space Full Delete Cache
    • Triage Remediation Server Actions
    • Triage Remediation Service Actions
    • Triage Remediation DB Tablespace Full
 To create a change request (CR) with valid Assignment Details in the task template for the BMC Atrium Orchestrator Run Book for NetApp Solutions
  1.  Navigate to the BMC Remedy AR System home page.
  2. In the Quick Links section, click Application Administration Console.
  3. Click the Custom Configuration tab and then select 
    Task Management System > Template.
  4. Open the Storage Provisioning Provision Storage Task task template.
  5. Click the Assignment tab.
  6.  Select the same values from the list 
    that you specified at installation for the following fields, and then click Save:
    • Assignee Company
    • Assignee Organization
    • Assignee Group
    • Assignee
    • NotifyAssignee
  7. Repeat step 1 through step 6 for the following task templates:
    • Storage Provisioning Provision Virtual Server Task
    • Storage Provisioning Provision Storage Task

Troubleshooting the Continuous Compliance for Servers run book when the BladeLogic adapter is enabled in the BLCLI tunneling mode

When you enable the BMC Server Automation application adapter in the BMC BladeLogic command-line interface (BLCLI) tunneling mode, the Continuous Compliance for Servers, Closed Loop Server Audit and Closed Loop Server Compliance run books fail to execute.

This problem does not affect the Operator Initiated Change and Server Incident Enrichment run books.

Solution: To avoid this issue, you must use two instances of the BMC Server Automation adapter. 

When the BladeLogic adapter is enabled in BLCLI tunneling mode, the module's BLCLI, which creates a .csv file, creates the same .csv file on the BMC BladeLogic server. The File adapter is not able to read this file since it cannot be configured to read or write files on remote machines. Due to this limitation, the run book module fails when the BladeLogic adapter is enabled in BLCLI tunneling mode. 

To prevent the run book module from failing, use two instances of the BMC BladeLogic adapter. Configure the first instance in BLCLI tunneling mode and the second in normal mode (supporting nsh). After you configure the adapters, the second adapter instance creates the csv file on the server where the adapter is enabled during BLCLI calls. Using this method, you also leverage the benefits BLCLI tunneling for other BLCLI calls.

To prevent run book module failures, perform the following procedures:

Note

You must perform these procedures on both affected run books: Closed Loop Server Audit (Closed_Loop_Server-SA-Audit) and Closed Loop Server Compliance (Closed_Loop_Server-SA-Compliance).

 

To set the BLCLI tunneling flag to true:

 

  1. Launch BMC Atrium Orchestrator Development Studio, and then select Designer.
  2. Expand the grid, and then expand the Closed Loop Server run book that you want to modify.
  3. Expand configurationBLADELOGIC, and Runbook_Defaults.
  4. Navigate to and open the blcli_tunneling configuration item.
  5. In the Value box, enter true
    Closed Loop Server run book BLCLI parameter value
     

To activate two instances of the BMC Atrium Orchestrator application adapter for BMC BladeLogic Server Automation:

Note

You must specify a unique name for each instance of the BMC Atrium Orchestrator application adapter for BMC BladeLogic Server Automation.

  1. Using Grid Manager, in the adapter configuration, enable the adapter in tunneling mode. See BMC Server Automation adapter for details on enabling the adapter in tunneling mode
  2. Using BMC Atrium Orchestrator Development Studio, in the Designer mode, navigate to the run book that you want to modify.
  3. Expand configurationBLADELOGICRunbook_Defaults, and BL_Connection_Details.
  4. In the Value box, specify a unique name for this instance of the BMC Server Automation adapter. 
    Closed Loop run book application adapter first instance
     
  5. On the same peer on which the file adapter is enabled, enable the BMC Network Automation adapter by setting the <is-cli-tunnel-enabled> element to false in the adapter configuration to support nsh. For more information, see BMC Server Automation adapter.
  6. Navigate to BLADELOGIC > Runbook_Defaults > BL_Connection_Details_Instance_2 parameter.
  7. In the Value box, specify a unique name for the second instance of the BMC Server Automation adapter. 
    Closed Loop run book application adapter second instance

Related topics

Run books

Known and corrected issues

Was this page helpful? Yes No Submitting... Thank you

Comments