Creating a new TrueSight Server Automation job with Change Management approval
When you create a job using a job type that requires BMC Remedy ITSM approval, you are prompted to select the approval type and enter the approval parameters when you configure the schedule.
You can specify an approval type when you execute a job or schedule a job for execution, as shown in the following table.
Setting the approval type
The Approval Information tab enables you to select an Approval type and enter the required BMC Remedy ITSM parameters to create a new change ticket or use an existing one.
- Approval types are available to you based on your role. For example, the BLOperator role might be configured with authorization for manual approval, while the BLAdmins role might be authorized for all approval types.
- Approval parameters determine the values of the corresponding BMC Remedy ITSM change ticket parameters that are created when the job definition is completed.
In the Enter approval information dialog box or the Approval Information tab, do the following:
From the list of predefined options, select the Approval type:
The [confluence_table-plus] macro is a standalone macro and it cannot be used inline.
The Job Approval type defines the values that you must populate in the change request for the BMC Remedy ITSM user.Enter the additional information to be used in the change request.
The [confluence_table-plus] macro is a standalone macro and it cannot be used inline.
- Do one of the following:
- Select Create new Change Ticket.
- Select Use existing Change Ticket, and enter the IDs for the existing change request and task in BMC Remedy ITSM. In this case the integration does not create a new change request, but rather updates the specified change request and task. See Considerations for the Using existing Change Ticket option.
- Click OK.
Verifying the job
After the job definition is completed, TrueSight Server Automation schedules the job and requests that a new change request be created in BMC Remedy ITSM. A new change request is created using a specific change template and includes one task, even if multiple servers are used as targets.
To check if the interaction with the change management system is successful, review the job schedule log (which is displayed in the TrueSight Server Automation console under the job, until the job starts running). You can also check the job schedule log by completing the following tasks in the TrueSight Server Automation console:
- Select the job from the Jobs folder.
- Right-click and select Open.
- Click the Schedule tab.
The job schedule log makes it easy to see:
- When the job is approved and if it is waiting to run
- If the attempt to schedule the job failed (for example, failed to create or update the change ticket)
After the job is approved and starts executing, the information in the job schedule log gets rolled into job log.
Considerations for jobs with multiple users
If multiple users execute the same job, each user must acquire approval by submitting a separate approval request. Approval requests are associated with the job schedule and are not associated with the job. Associating an approval request with the job means that all users are able to use the same approval reply.
Considerations for the Using existing Change Ticket option
If you select the Using existing Change Ticket option on the Approval information tab, note that the Change ID can be from:
- An already approved but unused Change ticket
- A change ticket where the task has the operational categorizations required for approval in BMC Remedy ITSM. In this case, make sure that the task has the following organizational tiers:
- Organizational tier 1: Operator Initiated Change
- Organizational tier 2: BMC BladeLogic
This the operational categorizations are required for TrueSight Orchestration to recognize that the alert is for the operator-initiated change use case. If you are using the change template and task template installed by the TrueSight Orchestration Content installer, then the values are set by default.