Troubleshooting continuous compliance for servers issues

This following topics offer basic troubleshooting tips for common issues that might occur when implementing continuous compliance for servers.

Troubleshooting Closed Loop Server Compliance and Audit

To troubleshoot issues with the Closed Loop Server Compliance and Closed Loop Server Audit use cases, perform the steps in the following table to isolate the issue.

ProductTroubleshooting steps

BMC Server Automation

Perform the following checks to isolate the issue.

  • Check whether ITSM Approval is configured for the Compliance or Audit Job. In the BMC Server Automation Console, select Configuration > Approval Configuration.
  • Check whether a compliance or audit discrepancy was found. In the Jobs folder, select a Compliance Job or an Audit Job, right-click, and select Show Results.
  • Check to see if the interaction with the change management system was successful by reviewing the job schedule log, which is displayed under the job until the job starts running.
  • Check the job schedule log by completing the following tasks in the BMC Server Automation Console:
    • Select the job from the Jobs folder.
    • Right-click and select Open.
    • Click the Schedule tab.
    • Review the job schedule log to see:
      • when the job has been approved and is waiting to run
      • if the attempt to schedule the job has failed (for example, failed to create or update the change ticket)
    • After the job starts executing after approval, the information in the job schedule log is rolled into job log.
  • View the job schedules and note the value of ChangeID, which shows the ID of the Change Request created, if available.
  • Check the Job status:
    • Waiting for approval
    • Request approved – Waiting for schedule
    • Request approved – Executed (success or failure)
  • After the change request is approved in BMC Remedy ITSM, BMC Atrium Orchestrator triggers the remediation job in BMC Server Automation. Check the Remediation Job Results view to see if the job ran. From the Jobs folder, navigate to a job, right-click and select Show Results. Check to see if there were errors in the job run.
  • Check to see if the Remediation Job sent results back to BMC Remedy ITSM.

BMC Atrium Orchestrator

Perform the following checks to verify that the modules and adapters are loaded and working.

  • Verify that the BMC Atrium Orchestrator modules and adapters are configured and loaded. For more information, see the Troubleshooting topic in the BMC Atrium Orchestrator online documentation.
  • Verify that the BMC Atrium Orchestrator monitor adapters are able to read alerts from BMC Remedy ITSM.
  • Verify that the BMC Atrium Orchestrator actor adapter is able to connect to BMC Remedy ITSM. For more information, see Verifying the connection to BMC Remedy ITSM.
  • Verify that the BMC Atrium Orchestrator for BladeLogic Server Automation adapter is able to run BLCLI commands. For more information, see Verifying the connection to BMC Server Automation.
  • Verify that the BMC Atrium Orchestrator SNMP Monitor adapter is able to recent alerts/traps from BMC Server Automation.

BMC Remedy ITSM

Perform the following checks to see if the ticket was created.

  • Query for the change request ticket number identified in the BMC Server Automation Job, if available. If the Change ID is not available in the Job, query for Change Requests based on the name of the Change Template used to create change requests. This action checks to see if the change request was created but the Change ID was not propagated back to the BMC Server Automation Job.
  • If the change request is not found, BMC Atrium Orchestrator might have encountered an error creating the change request.
  • If the change request is found, check the value of Status and Next Approval Phaseto see the current status of the change request:
    • Status = Scheduled, and Approval Status = Review – The change request has been submitted but has not gone through the approval process. Verify the change request is assigned appropriately. If the change request is undergoing approval, investigate the approval process in BMC Remedy ITSM.
    • Status = Implementation in Progress, and Approval Status = Close Down Approval  – The change request has been approved.  This is the status shown when the job is waiting to run, or is waiting for the update that the job has run. 
    • Status  = Completed or Closed.  The job has been run in BMC Server Automation, and details of the job should be in the work details.
  • Perform the following queries:
    • Query on Alert Events to see if the notifications by BMC Remedy ITSM on the changes in the state of the change request were sent to BMC Atrium Orchestrator.
    • Query for all Alert Events to be read by BMC Atrium Orchestrator using the following: User = <BMC Remedy user that was used to configure the BMC Remedy Monitor adapter>.
    • Query for all Alert Events on a particular Change Request/Incident by using the following: 'Alert Text' LIKE "%<Change ID or Incident ID>%"
    • The value of the Read field indicates whether the alert has been received by BMC Atrium Orchestrator. 'Read' = X means the alert has not been read by BMC Atrium Orchestrator. 

Troubleshooting operator-initiated change

To troubleshoot issues with the operator-initiated change use case, perform the steps in the following table to isolate the issue.

ProductTroubleshooting steps

BMC Server Automation

Perform the following checks to isolate the issue:

  • Check the Job Schedule to see if the job was created with approval. See Executing a job with BMC Remedy ITSM approval in the BMC Server Automation documentation.
  • Note the values of status, approval type and change parameters specified. If the status is Waiting for Approval, it means BMC Server Automation has sent the request to BMC Remedy ITSM to create the change request and is waiting for the response that it was created and approved. See Status types for change management approval jobs in the BMC Server Automation documentation.
  • If the status is Scheduled, it means that although the change request was created and associated and it has been approved, but is awaiting the scheduled time.
  • Check whether there is a value of ChangeID in the job properties, which will indicate whether the change request has been created and associated.
  • Check to see if the job completed, and if so then view the results. From the Jobs folder, navigate to a job, right-click and select Show Results.

BMC Atrium Orchestrator

Perform the following checks to verify modules and adapters are loaded and working:

  • Verify that the BMC Atrium Orchestrator modules and adapters are configured and loaded. For more information, see Troubleshooting in the BMC Atrium Orchestrator online documentation.
  • Verify that the BMC Atrium Orchestrator monitor adapters are able to read alerts from BMC Remedy ITSM.
  • Verify that the BMC Atrium Orchestrator actor adapter is able to connect to BMC Remedy ITSM. For more information, see Verifying the connection to BMC Remedy ITSM.
  • Verify that the BMC Atrium Orchestrator SNMP Monitor adapter is able to recent alerts/traps from BMC Server Automation.

BMC Remedy ITSM

Perform the following checks to see if the change request was created or updated.

  • Query for the change request ticket number identified in the job, if available. If the change ID is not known, query based on the Change Template categorization that is used to create change requests. This query will show you if the change request was created, but the ID was not propagated back to the BMC Server Automation job.
  • Verify the incident or change request is related to the CI specified in the template.
  • Check the Approval Status of the change cequest to see if it will go through the approval process.
  • Verify the categorization of the change request requires approval. See Configuring job approval for job types in the BMC Server Automation documentation.
  • Check the Approvers page of the change request to see whom is it waiting for approval.
  • Check the value of status of the change request:
    • Pending Approval --The change request requires approval, and is awaiting for it
    • Planning – The change request has been approved, or does not require approval. This status indicates that the Job is waiting to run, or BMC Remedy ITSM is waiting for the update that the job has run.
    • Resolved or Closed – The change request has been approved (if necessary), the job has run, and the change request has been updated with the results of the job and closed.
  • Perform the following queries:
    • Query on Alert Events to see if the notifications by BMC Remedy ITSM on the changes in the state of the change request were sent to BMC Atrium Orchestrator.
    • Query for all Alert Events to be read by BMC Atrium Orchestrator using the following: User = <BMC Remedy user that was used to configure the BMC Remedy Monitor adapter>.
    • Query for all Alert Events on a particular Change Request/Incident by using the following: 'Alert Text' LIKE "%<Change ID or Incident ID>%"
    • The value of the Read field indicates whether the alert has been received by BMC Atrium Orchestrator. 'Read' = X means the alert has not been read by BMC Atrium Orchestrator.

Troubleshooting server incident enrichment

To troubleshoot issues with the Server Incident Enrichment use case, perform the following steps to isolate the issue:

ProductTroubleshooting steps

BMC Server Automation

Check for any of the following details:

  • Verify the server name or ID is the same host name related to the incident.
  • Check what details are available on the host.
  • Check whether any jobs have been run against the server in the past 24 hours.

BMC Atrium Orchestrator

Perform the following checks to verify that the modules and adapters are loaded and working.

  • Verify that the BMC Atrium Orchestrator modules and adapters are configured and loaded. For more information, see the Troubleshooting topic in the BMC Atrium Orchestrator online documentation.
  • Verify that the BMC Atrium Orchestrator monitor adapters are able to read alerts from BMC Remedy ITSM.
  • Verify that the BMC Atrium Orchestrator actor adapter is able to connect to BMC Remedy ITSM. For more information, see Verifying the connection to BMC Remedy ITSM.
  • Verify BMC Atrium Orchestrator BladeLogic actor adapter is able to connect to BladeLogic for Server Automation. For more information, see Verifying the connection to BMC Server Automation.

BMC Remedy ITSM

Perform the following checks:

  • View the incident in Incident Management. Naviagte to the Related Items page and verify there is a related ComputerSystem. Note the name of the ComputerSystem. Verify that the incident is open.
  • Verify an alert was sent from Incident Management to BMC Atrium Orchestrator by issuing the following query on the Alert Events form: where 'Text' Like AOSIE:<Incident number>%
  • Note: Alerts are periodically purged after they are read by BMC Atrium Orchestrator, so they will not collect here indefinitely.

Additional investigation and debug logging

You can also investigate various log files for additional information.

Search for errors in the BMC Atrium Orchestrator logs – grid.log and processes.log. Identify which product is giving the error message, the meaning of the error message, and potential resolutions.

Debug logs might be required to collect more information about the transaction encountering the error.  Below is a list of additional logs that can be enabled.

  • Enable additional logging on the BMC Remedy ITSM server. Log the output to files. For information about how to do this see "Using log files" in the BMC Remedy Action Request System Optimizing and Troubleshooting Guide.
  • For more information about logging in BMC Atrium Orchestrator, see the Troubleshooting topic in the BMC Atrium Orchestrator online documentation.
  • Enable additional logging on the BladeLogic adapter in BMC Atrium Orchestrator. For information about how to do this see Debug level adapter logging steps topic in the BMC Atrium Orchestrator online documentation.
  • Enable additional logging on the Remedy adapters in BMC Atrium Orchestrator. For details on how to enable logging, Debug level adapter logging steps topic in the BMC Atrium Orchestrator online documentation.
  • Enable additional logging in BMC Server Automation. For information, see Working with logs in the BMC Server Automation documentation.
Was this page helpful? Yes No Submitting... Thank you

Comments