cisco dna center integration with...

20
Cisco DNA Center Integration with ServiceNow About Cisco DNA Center Integration Use Cases, on page 1 About Cisco DNA Center ITSM Support, on page 1 Configuring Cisco DNA Center for ServiceNow Integration, on page 2 About Cisco DNA Center Integration Use Cases Cisco DNA Center supports the following types of integration use cases with other third-party applications: • Network management integrations: • IP Pool usage and allocation metrics • Bidirectional IP grid synchronization • Operation integrations: • ITSM event, problem, and incident management For this release, only ServiceNow ® operational integration is supported. Note • Approvals and schedule window information • Assistance in issue triage and association • Build your own dashboards and reports via select data sets About Cisco DNA Center ITSM Support Cisco DNA Center supports the following capabilities: • Integrating of Cisco DNA Center into ITSM processes of incident, event, and problem management. • Integrating of Cisco DNA Center into ITSM approval and preapproval chains. • Integrating of Cisco DNA Center with formal change and maintenance window schedules. Cisco DNA Center Integration with ServiceNow 1

Upload: others

Post on 21-Mar-2020

4 views

Category:

Documents


1 download

TRANSCRIPT

Page 1: Cisco DNA Center Integration with ServiceNow...YoucanadjustthebundlesthataredisplayedintheGUIbyclickingtheFiltericonandusingthefilter,orbyentering akeywordintheFindfield. Step3 ClickontheBasicITSM(ServiceNow

Cisco DNA Center Integration with ServiceNow

• About Cisco DNA Center Integration Use Cases, on page 1• About Cisco DNA Center ITSM Support, on page 1• Configuring Cisco DNA Center for ServiceNow Integration, on page 2

About Cisco DNA Center Integration Use CasesCisco DNA Center supports the following types of integration use cases with other third-party applications:

• Network management integrations:

• IP Pool usage and allocation metrics

• Bidirectional IP grid synchronization

• Operation integrations:

• ITSM event, problem, and incident management

For this release, only ServiceNow® operational integration is supported.Note

• Approvals and schedule window information

• Assistance in issue triage and association

• Build your own dashboards and reports via select data sets

About Cisco DNA Center ITSM SupportCisco DNA Center supports the following capabilities:

• Integrating of Cisco DNA Center into ITSM processes of incident, event, and problem management.

• Integrating of Cisco DNA Center into ITSM approval and preapproval chains.

• Integrating of Cisco DNA Center with formal change and maintenance window schedules.

Cisco DNA Center Integration with ServiceNow1

Page 2: Cisco DNA Center Integration with ServiceNow...YoucanadjustthebundlesthataredisplayedintheGUIbyclickingtheFiltericonandusingthefilter,orbyentering akeywordintheFindfield. Step3 ClickontheBasicITSM(ServiceNow

Cisco DNACenter bundles are prebuilt solutions that enable integration between DNA capabilities and specificIT domains. For the ServiceNow ITSM integration, the following bundles can be configured and used:

• Basic ITSM (ServiceNow) CMDB Synchronization

• Network Issue Monitor and Enrichment for ITSM (ServiceNow)

• Network Events for REST API Endpoint

• SWIM Events for REST API Endpoint

Configuring Cisco DNA Center for ServiceNow IntegrationThe following table describes the procedure required for Cisco DNA Center integration with ServiceNow.

The following Cisco DNA Center integration procedure with ServiceNow requires having the EventManagement Plug-in in the ServiceNow instance. If you do not have the ServiceNow Event ManagementPlug-in, then additional tasks are required for configuring the bundles in Steps 5 and 8 below.

Note

Table 1: Cisco DNA Center to ServiceNow Integration Procedure

DescriptionStep

Install or upgrade to Cisco DNA Center, Release 1.2.8.

For information about installing Cisco DNA Center, see the Cisco DigitalNetwork Architecture Center Installation Guide. For information aboutupgrading to Cisco DNACenter, Release 1.2.8, refer to the specific releasenotes for Release 1.2.8.

Note

Step 1

Download and install the Cisco DNA Center platform application.

For information, see Install Cisco DNA Center Platform.Note

Step 2

Install ServiceNow running one of the following versions:

• Jakarta

• Istanbul

• Kingston

Refer to your ServiceNow documentation for its installation procedure.This procedure to be performed by a ServiceNow administrator.

Note

Step 3

Cisco DNA Center Integration with ServiceNow2

Cisco DNA Center Integration with ServiceNowConfiguring Cisco DNA Center for ServiceNow Integration

Page 3: Cisco DNA Center Integration with ServiceNow...YoucanadjustthebundlesthataredisplayedintheGUIbyclickingtheFiltericonandusingthefilter,orbyentering akeywordintheFindfield. Step3 ClickontheBasicITSM(ServiceNow

DescriptionStep

Configure Bundles: Basic ITSM (ServiceNow) CMDB Synchronization.

Synchronizing the network device inventory with the ServiceNow CMDB is aprerequisite to enable the auto-generation of ITSM tickets. Therefore, the CMDBSyncmust be enabled first (if it is not already done outside of Cisco DNA Center). Checkwith your ServiceNow administrator to see whether the CMDB Sync is being doneelsewhere.

For information about configuring this bundle, see Configure Bundles: Basic ITSM(ServiceNow) CMDB Synchronization, on page 4.

Step 4

Configure Bundles: Network Issue Monitor and Enrichment for ITSM(ServiceNow)

This bundle enables Change Management between the two systems (Cisco DNACenter and ServiceNow). Change Management and Incident/Problem Managementworkflows should be enabled based on the automation or assurance use cases that youwant to log tickets to in ServiceNow.

For information about configuring this bundle, see Configure Bundles: Network IssueMonitor and Enrichment for ITSM (ServiceNow), on page 8.

If you do not have the ServiceNow Event Management Plug-in, then youalso need to configure a destination to receive the events (EventManagement or REST API Endpoint) in this step.

Note

Step 5

Configure Event Settings.

The Cisco DNACenter platform and ITSM integration allows the user to choose fromall of the assurance issues to create and modify the severity of events, incidents, orproblems in ServiceNow to match business priorities.

For information about configuring the settings, see Configure Event Settings, on page11.

Step 6

Configure Bundles: Network Events for REST API Endpoint

For information about configuring this bundle, see Configure Bundles: Network Eventsfor REST API Endpoint, on page 13.

Step 7

Cisco DNA Center Integration with ServiceNow3

Cisco DNA Center Integration with ServiceNowCisco DNA Center Integration with ServiceNow

Page 4: Cisco DNA Center Integration with ServiceNow...YoucanadjustthebundlesthataredisplayedintheGUIbyclickingtheFiltericonandusingthefilter,orbyentering akeywordintheFindfield. Step3 ClickontheBasicITSM(ServiceNow

DescriptionStep

Depending upon whether you have the ServiceNow Event Management Plug-in,perform one of the following tasks:

• Configure Bundles: SWIM Events for REST API Endpoint

If you have the ServiceNow Event Management Plug-in, then perform this task.For information about configuring this bundle, see Configure Bundles: SWIMEvents for REST API Endpoint, on page 15.

• Configure Bundles: SWIM Events for ITSM (ServiceNow)

If you do not have the ServiceNow Management Plug-in then perform this task.For information about configuring this bundle, see Configure Bundles: SWIMEvents for ITSM (ServiceNow), on page 17. If you do not have the ServiceNowEvent Management Plug-in, then you also need to configure a destination toreceive the events (Event Management or REST API Endpoint) in this step.

Cisco DNA Center platform supports the Software Image Management (SWIM)workflow. In this use case, the user designates an image as golden in the ImageRepository tab of Cisco DNA Center. The Software Image Management REST APIbundle then scans the network for devices that have software images that are notcurrently running the golden image as designated in the Image Repository andautomatically logs a ticket to the ITSM.

Step 8

Configure Bundles: Basic ITSM (ServiceNow) CMDB SynchronizationPerform this procedure to either trigger or schedule a synchronization between the Cisco DNACenter devicesand your ServiceNow CMDB system. If devices have not been synchronized between Cisco DNA Center andthe ServiceNow CMDB system, then this bundle must be activated as a prerequisite, before activating anyother bundles.

Before you begin

• Ensure that you have installed or upgraded to Cisco DNACenter Release GA 1.2.5, and have downloadedand installed the Cisco DNA Center platform application. To review the status of the Cisco DNA Centerplatform application in the GUI, click the gear icon ( ) and choose System Settings > Software Updates> Installed Apps. For information about managing applications, see the Cisco Digital NetworkArchitecture Center Administrator Guide.

• Ensure that you have ServiceNow running on a system that you will integrate with Cisco DNA Centerplatform.

• Run a successful Discovery job in Cisco DNA Center. You can check whether a Discovery job issuccessful inDevice Inventory. From theHome page, clickProvision >Device Inventory > Inventoryto view the results.

Step 1 From the Cisco DNA Center home page, click Platform >Manage > Bundles.Step 2 Review the displayed bundles and their current status.

Cisco DNA Center Integration with ServiceNow4

Cisco DNA Center Integration with ServiceNowConfigure Bundles: Basic ITSM (ServiceNow) CMDB Synchronization

Page 5: Cisco DNA Center Integration with ServiceNow...YoucanadjustthebundlesthataredisplayedintheGUIbyclickingtheFiltericonandusingthefilter,orbyentering akeywordintheFindfield. Step3 ClickontheBasicITSM(ServiceNow

You can adjust the bundles that are displayed in the GUI by clicking the Filter icon and using the filter, or by enteringa keyword in the Find field.

Step 3 Click on the Basic ITSM (ServiceNow) CMDB synchronization bundle link or icon (colored square with initial) foradditional information about the bundle.

Additional information provided may include the following:

• General information—Vendor, version, platform, tags displayed under the square icon.

Tags indicate what the Cisco DNA Center component is used for or affected by the bundle.Note

• Information—Tab that displays general information (purpose of bundle and how bundle works in the network),sample schemas, configuration notes, and other data about the bundle.

• Contents—Tab that accesses the integration flows and APIs that make up the bundle.

• Release Notes—Tab that displays latest release information about the bundle, including its version.

Step 4 Review the bundle data in the Information tab.Step 5 Click the Contents tab.

Depending upon the bundle selected, either an Integration Flows or APIs header will appear.

Step 6 For this bundle, click the Integration Flows header.

Proceed to review the list of available integration flows under the header.

Step 7 Click the Enable button to activate the links.

An Information field appears in the window.

Step 8 In the Information field, click the Enable button to confirm enabling the bundle.

After clicking the Enable button to confirm, a success message appears.

Step 9 Click OK in the success message.Step 10 Click on the link for the individual integration flow to perform the tasks listed below:

For Schedule-based integration flows, perform the following tasks:

• Review the description, tags, How to Use this Flow, and scheduler.

• Configure the repeat interval (daily or weekly), time (including AM or PM), time zone, and start and end dates.

• Click Schedule to enable.

Only enable a schedule, after you have finished configuring the bundle as described in the followingsteps.

Important

Step 11 Click the Configure button to configure instances at the bundle level.

A configuration side bar appears. You are then prompted to configure the following:

• Set Operational Limit and Source Identifier for ServiceNow—Go to steps 12 to 15 to configure this instancetype.

• ServiceNow Access Settings—Go to steps 16 to 19 to configure this instance type.

Cisco DNA Center Integration with ServiceNow5

Cisco DNA Center Integration with ServiceNowCisco DNA Center Integration with ServiceNow

Page 6: Cisco DNA Center Integration with ServiceNow...YoucanadjustthebundlesthataredisplayedintheGUIbyclickingtheFiltericonandusingthefilter,orbyentering akeywordintheFindfield. Step3 ClickontheBasicITSM(ServiceNow

Step 12 In the configuration side bar, Click Set Operational Limit and Source Identifier for ServiceNow to configure anInventory Sync Settings instance.

Step 13 Click the radio button to configure either an existing Inventory Sync Settings instance or configure a new instance.Figure 1: Inventory Sync Settings Instance Configuration Fields

For configuring an existing Inventory Sync Settings instance, select it from the drop down menu in the window andclick Activate.

Step 14 For configuring a new Inventory Sync Settings instance, the following additional information must be entered.

• Instance Name—Name of the instance.

• Description—Descriptive test of the instance.

• Inventory Sync—Inventory items synchronized per iteration (value between 10-20).

• Source Identifier—Required identifier for ServiceNow. This value must be an exact match.

Step 15 Click Check Connectivity to test whether you can connect to the server where the endpoint is located.

After a successful test of connectivity to the server, either proceed to the next step to configure a ServiceNowConnectioninstance or proceed to step 20 to activate the Inventory Sync Settings.

Step 16 In the configuration side bar, click ServiceNow Access Settings to configure a ServiceNow Connection instance.Step 17 Click the radio button to configure either an existing ServiceNow Connection instance or configure a new instance.

Cisco DNA Center Integration with ServiceNow6

Cisco DNA Center Integration with ServiceNowCisco DNA Center Integration with ServiceNow

Page 7: Cisco DNA Center Integration with ServiceNow...YoucanadjustthebundlesthataredisplayedintheGUIbyclickingtheFiltericonandusingthefilter,orbyentering akeywordintheFindfield. Step3 ClickontheBasicITSM(ServiceNow

Figure 2: ServiceNow Connection Instance Configuration Fields

For configuring an existing ServiceNow Connection instance, select it from the drop down menu in the window andclick Activate.

Step 18 For configuring a new ServiceNowConnection instance, the following additional information must be entered.

• Instance Name—Name of the instance.

• Description—Descriptive text of the instance.

• Host name—Host name for the ServiceNow system.

• Username—Username required to access the ServiceNow system.

• Password—Password required to access the ServiceNow system.

Step 19 Click Check Connectivity to test whether you can connect to the server where the endpoint is located.

After a successful test of connectivity to the server, proceed to step 20.

Step 20 Click Activate to save your changes and activate the bundle or click Cancel to cancel the configuration and close theside bar.

The changes made to the bundle begin to take effect immediately. Additionally, the bundle status changes fromENABLED to ACTIVE.

Cisco DNA Center Integration with ServiceNow7

Cisco DNA Center Integration with ServiceNowCisco DNA Center Integration with ServiceNow

Page 8: Cisco DNA Center Integration with ServiceNow...YoucanadjustthebundlesthataredisplayedintheGUIbyclickingtheFiltericonandusingthefilter,orbyentering akeywordintheFindfield. Step3 ClickontheBasicITSM(ServiceNow

Configure Bundles: Network Issue Monitor and Enrichment for ITSM(ServiceNow)

Perform this procedure to set up monitoring for network for assurance and maintenance issues, as well aspublishing event details to a ServiceNow system.

The Cisco DNACenter integration procedure with ServiceNow requires having the EventManagement Plug-inin the ServiceNow instance. If you do not have the ServiceNow Event Management Plug-in, then additionaltasks are required for configuring the bundles in Steps 12, 13, and 14 below.

Note

Before you begin

• Ensure that you have completed the preceding task, configure the Basic ITSM (ServiceNow) CMDBSynchronization bundle.

Step 1 From the Cisco DNA Center home page, click Platform > Bundles.Step 2 Review the displayed bundles and their current status.

You can adjust the bundles that are displayed in the GUI by clicking the Filter icon and using the filter, or by enteringa keyword in the Find field.

Step 3 Click on the Network Issue Monitor and Enrichment for ITSM (ServiceNow) bundle link or icon (colored squarewith initial) for additional information about the bundle.

Additional information provided may include the following:

• General information—Vendor, version, platform, tags displayed under the square icon.

Tags indicate what the Cisco DNA Center component is used for or affected by the bundle.Note

• Information—Tab that displays general information (purpose of bundle and how bundle works in the network),sample schemas, configuration notes, and other data about the bundle.

• Contents—Tab that accesses the integration flows and APIs that make up the bundle.

• Release Notes—Tab that displays latest release information about the bundle, including its version.

Step 4 Review the bundle data in the Information tab.Step 5 Click the Contents tab.

Depending upon the bundle selected, either an Integration Flows or APIs header will appear.

Step 6 For this bundle, click the Integration Flows header.

Proceed to review the list of available integration flows under the header.

Step 7 Click the Enable button to activate the links.

An Information field appears in the window.

Step 8 In the Information field, click the Enable button to confirm enabling the bundle.

Cisco DNA Center Integration with ServiceNow8

Cisco DNA Center Integration with ServiceNowConfigure Bundles: Network Issue Monitor and Enrichment for ITSM (ServiceNow)

Page 9: Cisco DNA Center Integration with ServiceNow...YoucanadjustthebundlesthataredisplayedintheGUIbyclickingtheFiltericonandusingthefilter,orbyentering akeywordintheFindfield. Step3 ClickontheBasicITSM(ServiceNow

After clicking the Enable button to confirm, a success message appears.

Step 9 Click OK in the success message.Step 10 Click on the links for the individual integration flows to perform the tasks listed below:

• For REST-based integration flows, perform the following tasks:

• Review the description, tags, parameters, responses, model schemas, policies.

• Click Code Preview and select a programming language to view a code sample snippet.

• Click Try It to send a request and see the response.

• For Schedule-based integration flows, perform the following tasks:

• Review the description, tags, How to Use this Flow, and scheduler.

• Configure the repeat interval (daily or weekly), time (including AM or PM), time zone, and start and enddates.

• Click Schedule to enable.

Only enable a schedule, after you have finished configuring the bundle as described in the followingsteps.

Important

Step 11 Click the Configure button to configure instances at the bundle level.

A configuration side bar appears.

Step 12 (Optional) In the configuration side bar, click Destination to receive events to configure an Destination Connectioninstance.

The Cisco DNA Center integration procedure with ServiceNow requires having the Event ManagementPlug-in in the ServiceNow instance. If you do not have the ServiceNow Event Management Plug-in, thenperform this step and Steps 13 and 14.. If you have the ServiceNow Event Management Plug-in, then do notperform this step and proceed directly to Step 15.

Note

Step 13 (Optional) Click the radio button to configure either an existing Destination Connection instance or configure a newinstance.

Cisco DNA Center Integration with ServiceNow9

Cisco DNA Center Integration with ServiceNowCisco DNA Center Integration with ServiceNow

Page 10: Cisco DNA Center Integration with ServiceNow...YoucanadjustthebundlesthataredisplayedintheGUIbyclickingtheFiltericonandusingthefilter,orbyentering akeywordintheFindfield. Step3 ClickontheBasicITSM(ServiceNow

Figure 3: Example of Destination to Receive Events Configuration Fields

For configuring an existing Destination Connection instance, select it from the drop down menu in the window andclick Activate.

The Cisco DNA Center integration procedure with ServiceNow requires having the Event ManagementPlug-in in the ServiceNow instance. If you do not have the ServiceNow Event Management Plug-in, thenperform this step and Step 14. If you have the ServiceNow Event Management Plug-in, then do not performthis step and proceed directly to Step 15.

Note

Step 14 (Optional) For configuring a newDestination Connection instance, the following additional informationmust be entered.

• Instance Name—Name of the instance.

• Description—Descriptive text of the instance.

• Destination to receive events—Choose Event Management or REST API Endpoint.

The Cisco DNA Center integration procedure with ServiceNow requires having the Event ManagementPlug-in in the ServiceNow instance. If you do not have the ServiceNow Event Management Plug-in, thenperform this step. If you have the ServiceNow Event Management Plug-in, then do not perform this step andproceed directly to Step 15.

Note

Step 15 In the configuration side bar, click ServiceNow Access Settings to configure a ServiceNow Connection instance.Step 16 Click the radio button to configure either an existing ServiceNow Connection instance or configure a new instance.

Cisco DNA Center Integration with ServiceNow10

Cisco DNA Center Integration with ServiceNowCisco DNA Center Integration with ServiceNow

Page 11: Cisco DNA Center Integration with ServiceNow...YoucanadjustthebundlesthataredisplayedintheGUIbyclickingtheFiltericonandusingthefilter,orbyentering akeywordintheFindfield. Step3 ClickontheBasicITSM(ServiceNow

Figure 4: ServiceNow Connection Instance Configuration Fields

For configuring an existing ServiceNow Connection instance, select it from the drop down menu in the window andclick Activate.

Step 17 For configuring a new ServiceNow Connection instance, the following additional information must be entered.

• Instance Name—Name of the instance.

• Description—Descriptive text of the instance.

• Host name—Host name for the ServiceNow system.

• Username—Username required to access the ServiceNow system.

• Password—Password required to access the ServiceNow system.

Step 18 Click Check Connectivity to test whether you can connect to the server where the endpoint is located.

After a successful test of connectivity to the server, proceed to the next step.

Step 19 Click Activate to save your changes and activate the bundle or click Cancel to cancel the configuration and close theside bar.

The changes made to the bundle begin to take effect immediately. Additionally, the bundle status changes fromENABLED to ACTIVE.

Configure Event SettingsCisco DNA Center platform currently supports specific Cisco DNA Center events that may occur within yournetwork. You can configure the category, severity, and type of each kind of event by clicking Edit inConfigurations.

Cisco DNA Center Integration with ServiceNow11

Cisco DNA Center Integration with ServiceNowConfigure Event Settings

Page 12: Cisco DNA Center Integration with ServiceNow...YoucanadjustthebundlesthataredisplayedintheGUIbyclickingtheFiltericonandusingthefilter,orbyentering akeywordintheFindfield. Step3 ClickontheBasicITSM(ServiceNow

Figure 5: Cisco DNA Center Platform Configurations Window

Before you begin

Ensure that you have completed the following preceding tasks:

• Configured the Basic ITSM (ServiceNow) CMDB Synchronization bundle.

• Configured the Network Issue Monitor and Enrichment for ITSM (ServiceNow) bundle.

Step 1 From the Cisco DNA Center home page, click Platform >Manage > Configurations.

A Configurations window opens that contains an Events Settings section.

Step 2 Review the Event Settings section that appears.

The following Event Settings information is displayed:

• Event Name—Name of the Cisco DNA Center event.

• Domain—Domain or category of the Cisco DNA Center event.

The following domains are supported: AP issue, Apple IOS issue, Application Experience issue, Client AuthenticationIssue, Client Connectivity Issue, Client Onboarding Issue, Fabric Issue, Network Issue, Radio Issue, ReachabilityIssue, Sensor Issue, SGACL Issue, SNMP Issue, Switch Issue, SYSLOG Issue, TCAM Issue, Trap Issue, and WLCIssue.

• Type—Network, App, System, Security, Integrations type.

• Category—Error, Warn, Info, Alert, Task Progress, Task Complete

• Severity—P1 (Priority 1) through P5 (Priority 5).

Priority 1 is the most important or critical priority and should be assigned as such.Note

Cisco DNA Center Integration with ServiceNow12

Cisco DNA Center Integration with ServiceNowCisco DNA Center Integration with ServiceNow

Page 13: Cisco DNA Center Integration with ServiceNow...YoucanadjustthebundlesthataredisplayedintheGUIbyclickingtheFiltericonandusingthefilter,orbyentering akeywordintheFindfield. Step3 ClickontheBasicITSM(ServiceNow

• Workflow—Incident, Problem, Event, or RFC (Request for Change)

• Actions—Edit

You can adjust what is displayed in the table by clicking the Filter icon and using the filter, or by typing a keyword inthe Find field. For example, to display all access point notifications, type 'AP' in the Find field. To view all networknotifications, type 'Network' in the Find field. To view all Priority 1 (P1) notifications, type 'P1' in the Find field.

Step 3 Click Edit in the Actions column to edit an event.

Select a setting by clicking on the downward pointing angle and adjust the value. For example, clickNetwork and adjustto App. This changes the event type from a network type to an application type. Click Severity and adjust to P1 fromP5. This raises the priority level from Priority 5 to Priority 1.

Step 4 Click the box next to the Event name to enable notifications.

This enables notifications through Cisco DNA Center when the event occurs in the future.

Step 5 Click Save to save your configuration.

Configure Bundles: Network Events for REST API EndpointPerform this task to publish Cisco DNACenter events to any RESTAPI endpoint, as well as to receive updatesabout the event and its associated artifacts (incident , problem or request for change). The bundle then populatesthe Runtime Dashboard with this data.

Before you begin

Ensure that you have completed the following preceding tasks:

• Configured the Basic ITSM (ServiceNow) CMDB Synchronization bundle.

• Configure the Network Issue Monitor and Enrichment for ITSM (ServiceNow) bundle.

• Configured Event Settings.

Step 1 From the Cisco DNA Center home page, click Platform >Manage > Bundles.Step 2 Review the displayed bundles and their current status.

You can adjust the bundles that are displayed in the GUI by clicking the Filter icon and using the filter, or by enteringa keyword in the Find field.

Step 3 Click on the Network Events for REST API Endpoint bundle link or icon (colored square with initial) for additionalinformation about the bundle.

Additional information provided may include the following:

• General information—Vendor, version, platform, tags displayed under the square icon.

Tags indicate what the Cisco DNA Center component is used for or affected by the bundle.Note

• Information—Tab that displays general information (purpose of bundle and how bundle works in the network),sample schemas, configuration notes, and other data about the bundle.

Cisco DNA Center Integration with ServiceNow13

Cisco DNA Center Integration with ServiceNowConfigure Bundles: Network Events for REST API Endpoint

Page 14: Cisco DNA Center Integration with ServiceNow...YoucanadjustthebundlesthataredisplayedintheGUIbyclickingtheFiltericonandusingthefilter,orbyentering akeywordintheFindfield. Step3 ClickontheBasicITSM(ServiceNow

• Contents—Tab that accesses the integration flows and APIs that make up the bundle.

• Release Notes—Tab that displays latest release information about the bundle, including its version.

Step 4 Review the bundle data in the Information tab.Step 5 Click the Contents tab.

Depending upon the bundle selected, either an Integration Flows or APIs header will appear.

Step 6 For this bundle, click the Integration Flows header.Step 7 Click the Enable button to activate the links.

An Information field appears in the window.

Step 8 In the Information field, click the Enable button to confirm enabling the bundle.

After clicking the Enable button to confirm, a success message appears.

Step 9 Click OK in the success message.Step 10 Click on the link for the individual integration flow to perform the tasks listed below:

For Schedule-based integration flows, perform the following tasks:

• Review the description, tags, How to Use this Flow, and scheduler.

• Configure the repeat interval (daily or weekly), time (including AM or PM), time zone, and start and end dates.

• Click Schedule to enable.

Only enable a schedule, after you have finished configuring the bundle as described in the followingsteps.

Important

Step 11 Click the Configure button to configure instances at the bundle level.

A configuration side bar appears. You are then prompted to configure the REST Endpoint for Publishing Event.

Step 12 In the configuration side bar, click REST Endpoint for Publishing Event to configure a REST endpoint instance.Step 13 Click a radio button to configure either an existing REST endpoint instance or configure a new instance.Step 14 For configuring a new REST endpoint instance, the following additional information must be entered.

• Instance Name—Name of the instance.

• Description—Descriptive text of the instance.

• REST Endpoint—Host name or IP address of system for the REST endpoint.

• Username—Username required to access the system for the REST endpoint.

• Password—Password required to access the system for the REST endpoint.

Step 15 Click Check Connectivity to test whether you can connect to the server where the endpoint is located.

After a successful test of connectivity to the server, proceed to activate the bundle.

Step 16 Click Activate to save your changes and activate the bundle or click Cancel to cancel the configuration and close theside bar.

Cisco DNA Center Integration with ServiceNow14

Cisco DNA Center Integration with ServiceNowCisco DNA Center Integration with ServiceNow

Page 15: Cisco DNA Center Integration with ServiceNow...YoucanadjustthebundlesthataredisplayedintheGUIbyclickingtheFiltericonandusingthefilter,orbyentering akeywordintheFindfield. Step3 ClickontheBasicITSM(ServiceNow

By clicking Activate, you enable the changes made to the bundle and the changes take effect immediately.Additionally, the bundle's status changes from ENABLED to ACTIVE.

Note

Configure Bundles: SWIM Events for REST API EndpointPerform this task to monitor and publish events that require software image updates for compliance, securityor any other operational triggers, to any REST API end-point system, as well as to receive updates about theevent and its associated artifacts (incident, problem or request for change). The bundle then populates theRuntime Dashboard with this data.

Before you begin

Ensure that you have completed the following preceding tasks:

• Configured the Basic ITSM (ServiceNow) CMDB Synchronization bundle.

• Configure the Network Issue Monitor and Enrichment for ITSM (ServiceNow) bundle.

• Configured the Event Settings.

• Configured the Network Events for REST API Endpoint bundle.

Step 1 From the Cisco DNA Center home page, click Platform >Manage > Bundles.Step 2 Review the displayed bundles and their current status.

You can adjust the bundles that are displayed in the GUI by clicking the Filter icon and using the filter, or by enteringa keyword in the Find field.

Step 3 Click on the SWIM Events for REST API Endpoint bundle link or icon (colored square with initial) for additionalinformation about the bundle.

Additional information provided may include the following:

• General information—Vendor, version, platform, tags displayed under the square icon.

Tags indicate what the Cisco DNA Center component is used for or affected by the bundle.Note

• Information—Tab that displays general information (purpose of bundle and how bundle works in the network),sample schemas, configuration notes, and other data about the bundle.

• Contents—Tab that accesses the integration flows and APIs that make up the bundle.

• Release Notes—Tab that displays latest release information about the bundle, including its version.

Step 4 Review the bundle data in the Information tab.Step 5 Click the Contents tab.

Depending upon the bundle selected, either an Integration Flows or APIs header will appear.

Step 6 For this bundle, click the Integration Flows header.Step 7 Click the Enable button to activate the links.

Cisco DNA Center Integration with ServiceNow15

Cisco DNA Center Integration with ServiceNowConfigure Bundles: SWIM Events for REST API Endpoint

Page 16: Cisco DNA Center Integration with ServiceNow...YoucanadjustthebundlesthataredisplayedintheGUIbyclickingtheFiltericonandusingthefilter,orbyentering akeywordintheFindfield. Step3 ClickontheBasicITSM(ServiceNow

An Information field appears in the window.

Step 8 In the Information field, click the Enable button to confirm enabling the bundle.

After clicking the Enable button to confirm, a success message appears.

Step 9 Click OK in the success message.Step 10 Click on the link for the individual integration flow to perform the tasks listed below:

For Schedule-based integration flows, perform the following tasks:

• Review the description, tags, How to Use this Flow, and scheduler.

• Configure the repeat interval (daily or weekly), time (including AM or PM), time zone, and start and end dates.

• Click Schedule to enable.

Only enable a schedule, after you have finished configuring the bundle as described in the followingsteps.

Important

Step 11 Click the Configure button to configure instances at the bundle level.

A configuration side bar appears. You are then prompted to configure the REST Endpoint for Publishing Event.

Step 12 In the configuration side bar, click REST Endpoint for Publishing Event to configure a REST endpoint instance.Step 13 Click a radio button to configure either an existing REST endpoint instance or configure a new instance.Step 14 For configuring a new REST endpoint instance, the following additional information must be entered.

• Instance Name—Name of the instance.

• Description—Descriptive text of the instance.

• REST Endpoint—Host name or IP address of system for the REST endpoint.

• Username—Username required to access the system for the REST endpoint.

• Password—Password required to access the system for the REST endpoint.

Step 15 Click Check Connectivity to test whether you can connect to the server where the endpoint is located.

After a successful test of connectivity to the server, proceed to activate the bundle.

Step 16 Click Activate to save your changes and activate the bundle or click Cancel to cancel the configuration and close theside bar.

By clicking Activate, you enable the changes made to the bundle and the changes take effect immediately.Additionally, the bundle's status changes from ENABLED to ACTIVE.

Note

What to do next

1. From the Cisco DNACenter home page, click Platform >Runtime Dashboard. Notifications for eventswill display in the Events Summary field.

2. Click View Details to view the notifications.

Cisco DNA Center Integration with ServiceNow16

Cisco DNA Center Integration with ServiceNowCisco DNA Center Integration with ServiceNow

Page 17: Cisco DNA Center Integration with ServiceNow...YoucanadjustthebundlesthataredisplayedintheGUIbyclickingtheFiltericonandusingthefilter,orbyentering akeywordintheFindfield. Step3 ClickontheBasicITSM(ServiceNow

Configure Bundles: SWIM Events for ITSM (ServiceNow)Perform this procedure to set up monitoring and publishing events requiring software image updates forcompliance, security, or other operational triggers to a ServiceNow system.

Before you begin

Ensure that you have completed the following preceding tasks:

• Configured the Basic ITSM (ServiceNow) CMDB Synchronization bundle.

• Configured the Network Issue Monitor and Enrichment for ITSM (ServiceNow) bundle.

• Configured Event Settings.

Step 1 From the Cisco DNA Center home page, click Platform >Manage > Bundles.Step 2 Review the displayed bundles and their current status.

You can adjust the bundles that are displayed in the GUI by clicking the Filter icon and using the filter, or by enteringa keyword in the Find field.

Step 3 Click on the SWIM Events for ITSM (ServiceNow) bundle link or icon (colored square with initial) for additionalinformation about the bundle.

Additional information provided may include the following:

• General information—Vendor, version, platform, tags displayed under the square icon.

Tags indicate what the Cisco DNA Center component is used for or affected by the bundle.Note

• Information—Tab that displays general information (purpose of bundle and how bundle works in the network),sample schemas, configuration notes, and other data about the bundle.

• Contents—Tab that accesses the integration flows and APIs that make up the bundle.

• Release Notes—Tab that displays latest release information about the bundle, including its version.

Step 4 Review the bundle data in the Information tab.Step 5 Click the Contents tab.

Depending upon the bundle selected, either an Integration Flows or APIs header will appear.

Step 6 For this bundle, click the Integration Flows header.

Proceed to review the list of available integration flows (links) under the header.

Step 7 Click the Enable button to activate the links.

An Information field appears in the window.

Step 8 Click the Enable button in the Information field to confirm enabling the bundle.

After clicking the Enable button to confirm, a success message appears.

Step 9 Click OK in the success message.Step 10 Click on the link for the individual integration flow to perform the tasks listed below:

Cisco DNA Center Integration with ServiceNow17

Cisco DNA Center Integration with ServiceNowConfigure Bundles: SWIM Events for ITSM (ServiceNow)

Page 18: Cisco DNA Center Integration with ServiceNow...YoucanadjustthebundlesthataredisplayedintheGUIbyclickingtheFiltericonandusingthefilter,orbyentering akeywordintheFindfield. Step3 ClickontheBasicITSM(ServiceNow

For Schedule-based integration flows, perform the following tasks:

• Review the description, tags, How to Use this Flow (recurring schedule or cron expression), and scheduler.

• Click either Recurring Schedule or Cron Expression..

• Configure a schedule or cron expression and click Schedule.

Step 11 Click the Configure button to configure at the bundle level.

A configuration side bar appears.

Step 12 In the configuration side bar, click Destination to receive events to configure an Destination Connection instance.Step 13 Click the radio button to configure either an existing Destination Connection instance or configure a new instance.

Figure 6: Example of Destination to Receive Events Configuration Fields

For configuring an existing Destination Connection instance, select it from the drop down menu in the window andclick Activate.

Step 14 For configuring a new Destination Connection instance, the following additional information must be entered.

• Instance Name—Name of the instance.

• Description—Descriptive text of the instance.

• Destination to receive events—Choose Event Management or REST API Endpoint.

After entering this information, proceed to step 15.

Step 15 In the configuration sidebar, click ServiceNow Access Settings to configure a ServiceNowConnection instance.Step 16 Click the radio button to configure either an existing ServiceNow Connection instance or configure a new instance.

Cisco DNA Center Integration with ServiceNow18

Cisco DNA Center Integration with ServiceNowCisco DNA Center Integration with ServiceNow

Page 19: Cisco DNA Center Integration with ServiceNow...YoucanadjustthebundlesthataredisplayedintheGUIbyclickingtheFiltericonandusingthefilter,orbyentering akeywordintheFindfield. Step3 ClickontheBasicITSM(ServiceNow

Figure 7: ServiceNowConnection Instance Configuration Fields

For configuring an existing ServiceNow Connection instance, select it from the drop down menu in the window andclick Activate.

Step 17 For configuring a new ServiceNowConnection instance, the following additional information must be entered.

• Instance Name—Name of the instance.

• Description—Descriptive text of the instance.

• Host name—Host name for the ServiceNow system.

• Username—Username required to access the ServiceNow system.

• Password—Password required to access the ServiceNow system.

Step 18 Click Check Connectivity to test whether you can connect to the server where the endpoint is located.

After a successful test of connectivity to the server, proceed to the next step.

Step 19 Click Activate to save your changes and activate the bundle or click Cancel to cancel the configuration and close theside bar.

By clicking Activate, you enable the changes made to the bundle and the changes take effect immediately.Additionally, the bundle's status changes from ENABLED to ACTIVE.

Note

Cisco DNA Center Integration with ServiceNow19

Cisco DNA Center Integration with ServiceNowCisco DNA Center Integration with ServiceNow

Page 20: Cisco DNA Center Integration with ServiceNow...YoucanadjustthebundlesthataredisplayedintheGUIbyclickingtheFiltericonandusingthefilter,orbyentering akeywordintheFindfield. Step3 ClickontheBasicITSM(ServiceNow

Cisco DNA Center Integration with ServiceNow20

Cisco DNA Center Integration with ServiceNowCisco DNA Center Integration with ServiceNow