Cisco DNA Center ITSM Integration Guide, Release 2.3.5
Bias-Free Language
The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This release supports closed loop automation for software image management (SWIM) between Cisco DNA Center and ServiceNow. Closed-loop automation consists of a user configuring the provisioning of software device images in Cisco DNA Center. This configuration information is then communicated directly from Cisco DNA Center to ServiceNow as an immediate or scheduled change request. The ServiceNow administrator reviews the change request and either
approves or rejects it in ServiceNow. The change request acceptance or rejection is then communicated back to Cisco DNA Center.
After receipt of an approved change request from ServiceNow, Cisco DNA Center performs the software update at that time (immediately) or at its scheduled future time.
After Cisco DNA Center successfully performs the software update, a notification (task completed) is sent back to ServiceNow. If the software update
fails, then this is also communicated back to ServiceNow (task fail), so that the user can then manually perform the software
update in Cisco DNA Center.
Note
If the SWIM provisioning is stopped by the user in Cisco DNA Center during this process, a task termination notification is sent to ServiceNow.
Ensure that the Cisco DNA app is installed within the ServiceNow instance and perform the following procedures to enable SWIM closed loop automation
between Cisco DNA Center and ServiceNow:
Review the SWIM closed loop automation workflow to ensure that the required Cisco DNA Center admin and ServiceNow admin tasks are performed for this feature. See SWIM Closed Loop Automation Workflow.
SWIM Closed Loop Automation Requirements
The following table lists the requirements for SWIM closed loop automation.
Table 1. SWIM Closed Loop Automation Requirements
Software Product, App, or Procedure
Requirement
Cisco DNA Center
Release 2.3.5.
Service Now
Install or upgrade to a compatible version of ServiceNow mentioned on the ServiceNow Store website.
Click the following link to access the ServiceNow Store website:
The Cisco DNA app must be installed in your ServiceNow instance by a ServiceNow administrator. The Cisco DNA app versions 2.1.1 and 2.0.1 are compatible with the Tokyo and Utah releases of ServiceNow. If you want to use the Vancouver
release of ServiceNow, you must first upgrade the Cisco DNA app to the latest version, 2.2.0.
The following table describes the SWIM closed loop automation workflow between Cisco DNA Center and ServiceNow.
Table 2. SWIM Closed Loop Automation Workflow
Step
Description
Step 1
The Cisco DNA Center admin configures the Image Repository to prepare for the provisioning of devices in the network.
Note
See the Manage Software Images chapter in the Cisco DNA Center User Guide for information about setting up the Image Repository, as well as to review the software image provisioning process.
Step 2
The Cisco DNA Center admin distributes the software image to a device or devices at the present time or schedules this activity for a later time.
Note
Before this step is done, ensure that the Cisco DNA Center Automation events for ITSM (ServiceNow) bundle is configured and activated.
From the Cisco DNA Center home page, the admin clicks Provision.
From the Focus drop-down list, the admin chooses Software Images and selects the device with the image to upgrade.
From the Actions drop-down list, the admin chooses Software Images > Update Image and does the following:
Distribute: Clicks Now to start the distribution immediately or clicks Later to schedule the distribution at a specific time.
Clicks Next.
Activate: Clicks Now to start the activation immediately or clicks Later to schedule the activation at a specific time.
Confirm: Clicks Confirm to confirm the update.
Figure 1. Cisco DNA Assurance Provision
Note
See the Manage Software Images chapter in the Cisco DNA Center User Guide for detailed information about this step.
Step 3
After a software image distribution is created in Cisco DNA Center (software image update to be activated immediately or later), a SWIM event is created and communicated directly to the ServiceNow
ITSM as a change request ticket. This is done through the use of APIs from the Cisco DNA app. The change request ticket status is new.
The SWIM event appears in the ServiceNow GUI in the ServiceNow Change Requests table.
Figure 2. ServiceNow Change Requests
Step 4
In the Change Requests table, the ServiceNow admin clicks the change request number (identifier) to open and review its status and data. In the
ServiceNow GUI, the ServiceNow admin can edit the change request. For example, the admin can change the State from 'New' to 'Scheduled' and enter 'Change Management' for the Assignment group. The ServiceNow admin can also identify the SWIM change request with information in the Short Description field.
Figure 3. Change Request
Step 5
The ServiceNow admin now clicks the Cisco DNA tab in the change request. Important additional data synchronized from Cisco DNA Center to ServiceNow can be viewed in this tab.
Figure 4. Cisco DNA Tab
Step 6
The ServiceNow admin now either approves or rejects the change request ticket in the ServiceNow GUI.
In the Cisco DNA tab, the ServiceNow admin clicks the Approval Status field and clicks either Approved to approve the request or Rejected to reject the request.
Note
Before the change request is executed, it must be approved in ServiceNow. Only after an approval in ServiceNow will the change
request be executed in Cisco DNA Center.
Figure 5. Cisco DNA Approval Status Field
Step 7
After the ServiceNow admin approves the ticket and the status of the change request is changed to Implement, a notification
is sent to Cisco DNA Center. In case the ticket is rejected, the update is sent to Cisco DNA Center in Scheduled state itself and the ServiceNow ticket is automatically canceled.
Step 8
After a successful software image update in Cisco DNA Center, a notification (task completed) is sent back to ServiceNow. ServiceNow then closes the change request ticket. The change
request ticket closure is done through the use of APIs from the Cisco DNA app.
Note
For a failed software update, ServiceNow reports the failure so that the ServiceNow admin can manually take action on the
change request ticket. For a terminated software update, the change request ticket is canceled in ServiceNow. The reporting
of both a failed software image update and a terminated software image update are also done through the use of APIs from the
Cisco DNA app.
Step 9
The Cisco DNA Center admin can review the SWIM event by choosing Runtime Dashboard > Event Summary.
Note
By clicking the individual events in the GUI window, the admin accesses additional GUI windows that permit direct access to
the event in ServiceNow.
Figure 6. Event Summary
Step 10
The Cisco DNA Center admin clicks an event name (link) to view additional detailed data.
Figure 7. Event History
Step 11
The Cisco DNA Center admin clicks an event ID number (link) to view only data associated with that specific event.
Figure 8. Event ID Data
Step 12
The Cisco DNA Center admin clicks the ITSM Link to return to the ServiceNow Service Management GUI and specific incident.