Cisco DNA Spaces Configuration Guide

Brand: Cisco

Model: DNA Spaces

Type: Configuration Guide

Cisco DNA Spaces: Asset Locator Configuration Guide

First Published: 2017-12-11

Last Modified: 2019-07-11

Americas Headquarters

Cisco Systems, Inc.

170 West Tasman Drive

San Jose, CA 95134-1706

USA

http://www.cisco.com

Tel: 408 526-4000

800 553-NETS (6387)

Fax: 408 527-0883

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS,

INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND,

EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH

THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY,

CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version of

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS.

CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF

MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT

LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS

HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network

topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional

and coincidental.

All printed copies and duplicate soft copies of this document are considered uncontrolled. See the current online version for the latest version.

Cisco has more than 200 offices worldwide. Addresses and phone numbers are listed on the Cisco website at www.cisco.com/go/offices.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL:

https://www.cisco.com/c/en/us/about/legal/trademarks.html. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a

partnership relationship between Cisco and any other company. (1721R)

CONTENTS

Preface vii

PREFACE

Audience vii

Conventions vii

Communications, Services, and Additional Information viii

Overview 1

CHAPTER 1

Overview 1

Features and Benefits 4

Licensing 6

Setup 9

CHAPTER 2

Request a Cisco DNA Spaces: Asset Locator Account 9

Setup Connectivity between Asset Locator and Cisco DNA Spaces 9

Setup Connectivity between Asset Locator and Cisco CMX (Release 10.6 and above) 9

Setup Connectivity Between Asset Locator and Cisco CMX (Prior to Release 10.6) 10

Setup Connectivity Between Asset Locator and Cisco DNA Spaces: Detect and Locate 10

Manage Maps 11

CHAPTER 3

Uploading Maps 11

Create Chokepoints (Monitors) 12

Create Zones 13

Manage Assets 15

CHAPTER 4

Creating Categories and Department 15

Creating a Category 15

Creating Assets Manually 17

Cisco DNA Spaces: Asset Locator Configuration Guide

iii

Adding Assets Individually 17

Uploading Assets in Bulk 18

Manage Rules 21

CHAPTER 5

Manage Rules 21

Configuring Rules and Actions 21

Opting Your Device for Location-Based Notifications 32

Manage Reports 35

CHAPTER 6

Manage Reports 35

Manage Users 45

CHAPTER 7

Manage Users 45

Configuring User Permissions, User Roles, and Users 45

Modifying Users and User Roles 47

Track and Trace 53

CHAPTER 8

Track and Trace 53

Dashboard View 53

Locator 54

Search 54

Filter 55

Widget 55

Locator: List View 56

Locator: The Map View 56

Exporting List View as CSV 57

Manage Columns 58

Asset 360: A Detailed View of Assets 58

History View 59

Alerts View 62

Tags View 65

Troubleshoot 67

CHAPTER 9

Cisco DNA Spaces: Asset Locator Configuration Guide

Contents

Troubleshoot 67

API 69

CHAPTER 10

APIs 69

Appendix 71

CHAPTER 11

Appendix 71

Configuring Cisco CMX with controller 71

Configure a Hash Key on controller 71

Configuring a Proxy on Cisco CMX 10.4 and above 72

Import Maps from Cisco PI to Cisco CMX 73

How to obtain a Cisco CMX token from Cisco DNA Spaces 74

Location Services Using Cisco CMX 77

Configuring Cisco CMX 10.6 and Above 77

Configuring Cisco CMX 10.5 and Before 78

Cisco DNA Spaces: Asset Locator Configuration Guide

Contents

Cisco DNA Spaces: Asset Locator Configuration Guide

Contents

Preface

•Audience, on page vii

•Conventions, on page vii

•Communications, Services, and Additional Information, on page viii

Audience

This document is for Cisco DNA Spaces network and IT administrators who deploy Cisco DNA Spaces to

monitor, manage, and optimize usage of assets in an organization.

Conventions

This document uses the following conventions:

Table 1: Conventions

IndicationConvention

Commands and keywords and user-entered text appear in bold font.bold font

Document titles, new or emphasized terms, and arguments for which you supply

values are in italic font.

italic font

Elements in square brackets are optional.[ ]

Required alternative keywords are grouped in braces and separated by vertical

bars.

{x | y | z }

Optional alternative keywords are grouped in brackets and separated by vertical

bars.

[ x | y | z ]

A nonquoted set of characters. Do not use quotation marks around the string.

Otherwise, the string will include the quotation marks.

string

Terminal sessions and information the system displays appear in courier font.courier font

Nonprinting characters such as passwords are in angle brackets.<>

Default responses to system prompts are in square brackets.[]

Cisco DNA Spaces: Asset Locator Configuration Guide

vii

IndicationConvention

An exclamation point (!) or a pound sign (#) at the beginning of a line of code

indicates a comment line.

!, #

Means reader take note. Notes contain helpful suggestions or references to material not covered in the manual.

Note

Means the following information will help you solve a problem.

Tip

Means reader be careful. In this situation, you might perform an action that could result in equipment damage

or loss of data.

Caution

Communications, Services, and Additional Information

• To receive timely, relevant information from Cisco, sign up at Cisco Profile Manager.

• To get the business impact you’re looking for with the technologies that matter, visit Cisco Services.

• To submit a service request, visit Cisco Support.

• To discover and browse secure, validated enterprise-class apps, products, solutions and services, visit

Cisco Marketplace.

• To obtain general networking, training, and certification titles, visit Cisco Press.

• To find warranty information for a specific product or product family, access Cisco Warranty Finder.

Cisco Bug Search Tool

Cisco Bug Search Tool (BST) is a web-based tool that acts as a gateway to the Cisco bug tracking system

that maintains a comprehensive list of defects and vulnerabilities in Cisco products and software. BST provides

you with detailed defect information about your products and software.

Cisco DNA Spaces: Asset Locator Configuration Guide

viii

Preface

Communications, Services, and Additional Information

CHAPTER 1

Overview

Asset Locator is more than an asset management tool. It is a comprehensive single resource for managing,

monitoring, and optimizing your assets, Internet of Things (IoT) sensors, alerting system, and operational

workflows. Using a technology-agnostic approach, the solution can use a wide range of tags and sensors,

including Wi-Fi, RFID, and environmental monitors, to continually integrate, monitor, and manage your

connected operations. Through its cloud-based interface, you can define the profile, category, and ownership

of each of the assets. You can establish business rules to define workflows and the expected operating range

of your assets and sensors.

Asset Locator then continually monitors data from the sensors attached to your assets—including telemetry

data such as temperature and humidity. When any measure deviates from the norm established by your

workflows, policies, and business rules, the solution swings into action. It can give you an immediate alert

or, if you prefer, can trigger an automated action that is predefined by your workflows and business rules.

The cloud solution and mobile app give you real-time visibility into how your operations are functioning,

enabling you to take immediate action and optimize operational processes. In addition, you have access to a

wide range of historical reports and Key Performance Indicators (KPIs) to help you continually evaluate the

effectiveness of operations and measure the impact of new processes.

•Overview, on page 1

•Features and Benefits, on page 4

•Licensing, on page 6

Overview

Here is a quick glance at the solution architecture:

• Asset Locator cloud account.

• Assets that are to be tracked.

• Tags (Wi-FI, BLE, or RFID) attached to the assets that need to be tracked.

• Cisco Access Points and Cisco Wireless Controllers.

• Cisco Connected Mobile Experiences device (Cisco CMX) OR Cisco DNA Spaces: Detect and Locate

deployed within the network.

• Floor Maps downloaded from Cisco Prime Infrastructure (Cisco PI).

Cisco DNA Spaces: Asset Locator Configuration Guide

Version supportedDescriptionSolution Component

Any controller versionControl and DataCisco Wireless Controller

(controller)

Any APFor Wi-FI tags. Location of assets

based on RSSI information

emananting from tag.

Cisco Access Points

Cisco PI Version 3.0 and above.For AP positioning and exporting

maps. (Management)

Cisco Prime Infrastructure (Cisco

PI)

Cisco CMX 10.3.1.x and above.Configuration and management

required for Asset Locator.

Cisco CMX OR Cisco DNA

Spaces: Detect and Locate

CCX Compatible, Wi-Fi, BLE,

RFID

Attached to assets that need to be

tracked

Tags

—Assets that need to be trackedAssets

—Building and floors maps exported

from Cisco Prime Infrastructure

(Cisco PI)

Maps

—Monitor, Track, and Manage assetsCisco Asset Locator

Cisco DNA Spaces: Asset Locator Configuration Guide

Overview

Figure 1: Information Flow

Asset Locator requires a data path that includes either Cisco DNA Spaces: Connector or Cisco CMX.

Note

Cisco DNA Spaces: Asset Locator Configuration Guide

Overview

Figure 2: Information Flow

Features and Benefits

•Use your existing wireless network to provide better operational insights and efficiencies

•Digitize and capture indoor location, sensor telemetry and other contextual data from your assets

•Save critical staff time by easily managing and quickly locating assets in your facilities

•Synthesize the collected data via a sophisticated rules engine, apply business and workflow rules, and

automatically trigger defined actions and alerts

•Reduce manual processes by tracking, managing, and monitoring Wi-Fi, RFID tags, and telemetry

sensors attached to assets

•Avoid inventory loss or stock outages by monitoring assets and sensors in real time, applying business

and workflow rules, and automatically triggering alerts

•Automate KPI monitoring through the web dashboard and reports, for real-time and historical insights

to optimize operations

•Provide connectivity to enterprise applications via a flexible, API-driven platform

•Gainunifiedvisibility across the entire organization from a single cloud-scaled dashboard while providing

custom roles and permissions to users

•Reduce CapEx and maintenance costs with a SaaS subscription model

Cisco DNA Spaces: Asset Locator Configuration Guide

Overview

Features and Benefits

Table 2: Features and Benefits

BenefitFeature

Provides support for multiple tag providers

Helps reduce new investment when tag systems are

already deployed

Cisco Compatible Extensions (CCX) compatibility

Reduces installation cost and time

Improves scalability as demand grows

Improves solution through continuous feature

development and faster deployment

Cloud service

Improves efficiency of critical staff by reducing

manual monitoring and tracking of assets

Improves asset utilization by analyzing movement

and utilization patterns

Improves tactical operations through real-time

visibility into all assets in a facility

Asset track and trace, monitoring, and management

Enables automated workflows through rules that

address conditions such as asset location, motion

status, environmental telemetry, and other business

attributes

Avoids inventory loss or stock outages through an

alerting system

Detects the temperature and humidity of refrigerators

to maintain an acceptable range for

temperature-sensitive assets

Tracks assets based on entrance, exit, or

motion-sensing events

Improves safety and security by detecting panic button

trigger

Rules

Reduces downtime by triggering alerts when asset

condition exceeds threshold defined by business rules

and workflows

Helps keep staff informed through alerts sent by email

or text message

Automatically classifies assets based on rule

conditions

Manages alerts with built-in audit trail and alert

management system

Triggers secondary workflows through API triggers

to other enterprise back-end systems

Alerting system

Cisco DNA Spaces: Asset Locator Configuration Guide

Overview

Features and Benefits

BenefitFeature

Reduces time spent collecting data, monitoring assets,

and reporting

Helps improve decision-making through automated

and customizable KPI reports

Enables compliance reporting with historic records

on telemetry data (temperature, humidity, etc.) and

asset status

Reporting

Provides a user-friendly interface to help reduce time

spent searching for assets inside a facility

Uses the mobile device’s location to further improve

asset search by limiting results to nearby assets and

alerts

Improves response to and compliance with alerts

through notifications and easy alert management

Improves user experience and mobility for staff on

the floor

Mobile app

Licensing

Cisco DNA Spaces: Asset Locator has the flexibility to fit your needs. It is tag and sensor technology agnostic,

so depending on your technology preferences, you can purchase sensors from any CCX-compliant tag vendor.

The web and mobile platforms give you the power to tailor the solution to your needs. How do you want to

categorize your assets? What workflows are important to your operations? Through a single, cloud-based

interface, you have complete control over each of these elements. And by automating your workflows and

alerts, you no longer need to spend cycles on day-to-day monitoring, but rather can focus on continually

improving your operations.

Asset Locator is a component of Cisco DNA Spaces, a cloud-based and mobile solution that can be deployed

easily and quickly. And its subscription model helps provide predictable, year-to-year operational expenses.

Asset Locator is included in the Cisco DNA Spaces ACT license.

Navigate to Settings>Licenses to find details of existing license.

Cisco DNA Spaces: Asset Locator Configuration Guide

Overview

Licensing

Figure 3: The License Tab

•Type—Type of License (Evaluation or Advanced)

•End Date—Date of expiry of license

•Days Remaining—Number of days remaining for the license to expire.

•Account Name—Account Name of License

•Account Number—Account Number of License

Cisco DNA Spaces: Asset Locator Configuration Guide

Overview

Licensing

Cisco DNA Spaces: Asset Locator Configuration Guide

Overview

Licensing

CHAPTER 2

Setup

•Request a Cisco DNA Spaces: Asset Locator Account, on page 9

•Setup Connectivity between Asset Locator and Cisco DNA Spaces , on page 9

•Setup Connectivity between Asset Locator and Cisco CMX (Release 10.6 and above), on page 9

•Setup Connectivity Between Asset Locator and Cisco CMX (Prior to Release 10.6), on page 10

•Setup Connectivity Between Asset Locator and Cisco DNA Spaces: Detect and Locate, on page 10

Request a Cisco DNA Spaces: Asset Locator Account

Request an account on Cisco DNA Spaces by sending an email to [email protected] requesting

for a demo or live account creation on the Cisco DNA Spaces dashboard. For more information, see Getting Started with

DNA Spaces Dashboard:

Setup Connectivity between Asset Locator and Cisco DNA

Spaces

Refer to Cisco DNA Spaces: Connector Configuration Guide for more information.

Setup Connectivity between Asset Locator and Cisco CMX

(Release 10.6 and above)

To setup connectivity between Asset Locator and Cisco CMX 10.6 and above, no configuration is necessary

on Asset Locator. You can follow instructions in the Configuring Cisco CMX 10.6 and above section of the

Appendix. This task also triggers the automatic synchronization of maps to Asset Locator.

Cisco DNA Spaces: Asset Locator Configuration Guide

dnaspaces-stream is the channel to track data flow from Cisco CMX to Asset Locator.

Note

Setup Connectivity Between Asset Locator and Cisco CMX

(Prior to Release 10.6)

To setup connectivity between Asset Locator and Cisco CMX prior to Release 10.6, no configuration is

necessary on Asset Locator.

Step 1 Import maps from Cisco PI to Cisco CMX

Refer to Import Maps from Cisco PI to Cisco CMX section of the Appendix.

Step 2 Connect the Cisco CMX to Cisco DNA Spaces.

Refer to How to Obtain a token from Cisco DNA Spaces section of the Appendix.

Step 3 Configure notifications on Cisco CMX.

Refer to Configuring Notifications on Cisco CMX 10.5 and below section of the Appendix.

Setup Connectivity Between Asset Locator and Cisco DNA

Spaces: Detect and Locate

To setup connectivity between Asset Locator and Cisco DNA Spaces: Detect and Locate, no configuration

is necessary on Asset Locator. This is because the system auto-provisions the dnaspaces-stream during customer

onboarding or asset provisioning

Cisco DNA Spaces: Asset Locator Configuration Guide

Setup

Setup Connectivity Between Asset Locator and Cisco CMX (Prior to Release 10.6)

CHAPTER 3

Manage Maps

•Uploading Maps, on page 11

•Create Chokepoints (Monitors), on page 12

•Create Zones, on page 13

Uploading Maps

One of the first setup tasks involved in setting up Asset Locator is uploading maps exported from Cisco PI

to Asset Locator.

If Asset Locator is launched through Cisco DNA Spaces, maps are automatically synced into Asset Locator.

Note

Before you begin

If you are using Cisco CMX version 10.5 or below, refer to Import Maps from Cisco PI to Cisco CMX, on

page 73.

Step 1 Log in to the Asset Locator.

Step 2 From the left-navigation pane, click Configure>Maps, and then click Upload button.

Cisco DNA Spaces: Asset Locator Configuration Guide

Step 3 Browse to the location and select the maps exported previously from Cisco PI.

Step 4 Verify if the maps were uploaded successfully by selecting the floor map.

Create Chokepoints (Monitors)

From the left navigation pane, click Configure>Maps, and browse to the location where you need to create

a chokepoint. Click the chokepoint icon from the toolbar to the left as shown and enter the details of the

chokepoint before placing it on the map.

Cisco DNA Spaces: Asset Locator Configuration Guide

Manage Maps

Create Chokepoints (Monitors)

Page is loading ...

Cisco DNA Spaces Configuration Guide

Cisco DNA Spaces Configuration Guide

Cisco DNA Spaces Configuration Guide

Related papers

Other documents