Configuring the Event Orchestration Configuration module
The Event Orchestration Configuration module contains configuration data for the event management tool and ITSM system. For the out-of-the-box Service Down event, you must configure the TrueSight Infrastructure Management and BMC Remedy ITSM details in the module.
The following table describes the configuration items and values that you can specify for the Event Orchestration Configuration module.
Configuration group/item | Configuration item | Description |
|---|---|---|
General | EventSourceType | Specifies the name of the event management tool from which the event is generated. You must update the EventSourceType based on your environment. EventSourceType is a high-level configuration item. Connection details and other information about the event source system appears in the Specifics configuration group. Default value: BMC_TrueSight |
ITSMType | Specifies the ITSM application to be used to create incidents, change, or tasks for an event. Specifies the high-level configuration item. Connection details and other information about the event source system appears in the Specifics configuration group. Default value: BMC_AR_System | |
Specifics > BMC_TrueSight > EventTypes > ServiceDown | {EventType} | Specifies the event type generated in the event. By default, EventTypes contains the configuration items for the Service Down event type, which is supported out-of-the-box. |
IncidentEnabled | Specifies whether to create an incident in the BMC Remedy ITSM system when the event is reported. Valid values: true (default), false | |
ChangeEnabled | Specifies whether to create a change in the BMC Remedy ITSM system when the event is reported. If false, change and task tickets are not created for events. Set to false if:
Set to true if:
Default value: true (default), false | |
ChangeTemplateName | Specifies the name of the change template (in BMC Remedy Change Management application) based on which a change will be created for an event. Sample value: EventOrchestration_ServiceDown_ChangeTemplate | |
RemediationEnabled | Specifies whether to perform remediation for an event. If false, only triage is performed and remediation and verification actions are skipped. Default value: true | |
IsITSMDataCustom | Default value: true | |
IncidentIDFieldName | Default value: itsm-incident-id | |
ChangeIDFieldName | Default value: itsm-change-id | |
TaskIDFieldName | Default value: itsm-task-id | |
ChangeType | Specifies whether the change created for the event needs approval. By default, a change ticket that does not need approval is created in BMC Remedy ITSM. Default value: normal | |
Specifics > Adapters | EventActorAdapter | Specifies the name of the actor adapter, which updates the notes in the event management tool. If your event management tool is TrueSight Infrastructure Management, specify the TrueSight Operations Manager adapter. Default value: TruesightActor |
RESTAdapter | Specifies the name of the adapter, which is used to make REST API web service calls to the target application. The REST adapter is used to invoke triage and remediation workflows in TrueSight Orchestration. Ensure that the name of the adapter matches the adapter configured on the grid. Default value: RESTAdapter | |
ITSMActorAdapter | Specifies the name of the adapter, which uses non-web service calls to communicate with the ITSM application. This adapter invokes BMC Remedy AR System. Default value: ARSAdapter | |
WindowsCommandAdapter | Specifies the name of the adapter, which contains commands that perform triage and remediation actions on a target host running on a Windows operating system. Default value: WindowsCommandAdapter | |
SSHAdapter | Specifies the name of the adapter, which performs triage and remediation actions on a target host running on a UNIX operating system. Default value: SSHAdapter | |
ITSMWebServiceAdapter | Specifies the name of the adapter, which uses the web service calls to communicated with the ITSM application. Default value: SOAPAdapter | |
Specifics > BAO | URL | Specifies the URL to the TrueSight Orchestration Configuration Distribution Peer (CDP) in an FQDN format, where the modules required for the Event Orchestration run book are activated. Sample URL format: https://FullyQualifiedDomainName:CDPWebServerPort/baocdp |
UserName | Specifies the user name required to log on to the TrueSight Orchestration CDP. | |
Password | Specifies the password that matches the username. | |
Specifics > BMC_AR_System > WebServiceConnectionData | URL | Specifies the URL to the target BMC Remedy ITSM system. The ITSM type is defined in the General > ITSMType configuration item. |
UserName | Specifies the username required to log on to the BMC Remedy ITSM system to invoke web service requests. | |
Password | Specifies the password that matches the username, in a secure format. | |
Specifics > BMC_AR_System > ChangeManagementDefaults | ReportedSource | Specifies the value to be updated in the CHG:Infrastructure Change form when a change ticket is created for the event. The value in this field is used to query approved change tickets that is specific to Event Orchestration solution. Default value: EventOrchestration |
Specifics > BMC_AR_System > IncidentManagementDefaults | IncidentType | Specifies the type of incident to be created in BMC Remedy ITSM for an event. Default value: Infrastructure Event |
DefaultIncidentStatus | Specifies the status to be assigned when an incident is created. Default value: Assigned | |
DefaultServiceType | Specifies the service type to be assigned when an incident is created. Default value: Infrastructure Event | |
DefaultImpact | Specifies the impact to be assigned when an incident is created. Default value: 3-Moderate/Limited | |
DefaultUrgency | Specifies the impact to be assigned when an incident is created. Default value: 3-Medium | |
ReportedSource | Specifies the reported source of the event when an incident is created Default value: Event Orchestration | |
StatusReason | Specifies the status reason to be assigned when an incident is created. Default value: Infrastructure Change | |
WorkInfoType | Specifies the default value for the WorkInfoType to be assigned when an incident is created. Default value: General Information | |
WorkInfoSource | Specifies the default value for the WorkInfoSource to be assigned when an incident is created. Default value: BMC TrueSight Event | |
WorkInfoLocked | Specifies the default value to be added to the workInfo source to be assigned when an incident is created. Default value: No | |
WorkInfoViewAccess | Specifies the default value to be added to the WorkInfoViewAccess field of the incident ticket's WorkInfo record when a WorkInfo is created. Default value: Public | |
AssignedSupportCompany | Specifies the default value for the Contact Company field when an incident is created. Default value: Calbro Services | |
AssignedSupportOrganization | Specifies the default value for the Support Organization field when an incident is created. Default value: IT Support | |
AssignedGroup | Specifies the default value for the Assigned Group field when an incident is created. Default value: Service Desk | |
Assignee | Specifies the default value for the Contact Company field when an incident is created. Default value: Allen Allbrook | |
Specifics > BMC_AR_System > Mappings | Contains the mapping for each of the configuration item: | |
Specifics > BMC_AR_System > Templates | Templates | Contains a list of templates to be used based on the event type. |
Specifics > BMC_AR_System | TSMLocaleLanguage | Specifies the Locale Language of the Event Source Type. |
Specifics > BMC_AR_System | TSMLocaleCountry | Specifies the Locale Country of the Event Source Type. |
Specifics > BMC_AR_System | ITSMTimeZone | Specifies the timezone (standard Java timezones) where ITSM application is running. This field is used to determine the EPOCH time. EPOCH time is used queries to retrieve approved tasks by scheduled dates. For example, Asia/Kolkata or Europe/Paris. |
Specifics > WorkflowDefinitions | CommonWorkflows | Contains the workflow definitions for all the common workflows, which are used to invoke the remediation actions in an asynchronous manner. |
WorkflowsByEventType | Contains the workflows by event types, which are used to invoke triage, remediation and verification workflows via REST APIs. You can update the list of workflows to add more workflow names as new event types are added to solution. |
Where to go from here
After successfully configuring the Event Orchestration Configuration module, you can now configure the Credentials Store Management module for storing the credentials to be used in the run book. For more information, see Configuring-the-Credentials-Store-module.