Explore Cisco
How to Buy

Have an account?

  •   Personalized content
  •   Your products and support

Need an account?

Create an account

Cisco DNA Spaces Configuration Guide

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.

Book Contents
Find Matches in This Book
Available Languages
Download Options

Book Title

Cisco DNA Spaces Configuration Guide

Chapter Title

Setup

Results

Updated:
May 3, 2021

Chapter: Setup

Setup

This chapter provides an overview on how to view the configuration instructions for various wireless networks, and how to configure the wireless network through various methods. It also covers the configurations for Meraki Camera.

Setting Up Cisco DNA Spaces to Work with Various Wireless Networks

To work with Cisco DNA Spaces, you must connect it with your wireless network. You can use Cisco DNA Spaces with Cisco AireOS (Catalyst) or Cisco Meraki. Cisco DNA Spaces provides instructions along with the required features to connect to various networks.

To connect Cisco DNA Spaces to a wireless network, perform the following steps:

Procedure

Step 1

In the Cisco DNA Spaces dashboard, choose Setup > Wireless Networks.

Step 2

In the Connect your wireless Network window, click Add New.

A window appears with the options Cisco AireOS/Catalyst and Cisco Meraki.

Note 
For new Cisco DNA Spaces accounts, the button name will be Get Started.
Step 3

Click Select for your wireless network.

Displays different methods through which you can connect to your wireless network.

  • For Cisco AireOS/Catalyst, configurations for the following methods will be available:

    • Via Spaces Connector: To connect Cisco DNA Spaces to Cisco Wireless Controller using a Cisco DNA Spaces Connector.

    • Connect WLC Directly: To connect Cisco DNA Spaces to Cisco Wireless Controller using a Cisco Wireless Controller Direct Connect.

    • Via CMX On-Prem: To connect Cisco DNA Spaces to Cisco Wireless Controller using Cisco CMX.

  • For Cisco Meraki, configurations for the following methods will be available:

    • Connect via Meraki Login: To connect Cisco DNA Spaces to Cisco Meraki using a Cisco Meraki account.

    • Connect via API Key: To connect Cisco DNA Spaces to Cisco Meraki using a Cisco Meraki API Key.

Step 4

Click Select for the method through which you want to connect to Cisco DNA Spaces.

The prerequisites for connecting to the wireless network using the selected method is displayed. Ensure that the prerequisites are met.

Step 5

Click Customize Setup.

The message Successfully saved the configuration is shown.

Step 6

A bar corresponding to the wireless network configuration method selected appears in the Connect your wireless network window. For example, if you select Via Spaces Connector, a bar Connect via Spaces Connector appears.

Step 7

To view the instructions, and configure the wireless network, click the drop-down button at the far right of the bar.

The instructions, and the features to connect to the particular network using the particular method is displayed.
Step 8

Follow the instructions to add the wireless network.

Wireless Network Bars

Any of the following bars will be displayed for Cisco AireOS based on the connection method selected:

  • Connect via Spaces Connector: Displays step-by-step instructions to connect Cisco DNA Spaces to Cisco Wireless Controller using a Cisco DNA Spaces Connector. You can add connectors using the Create a new token option provided at Step 2. You can add Cisco Wireless Controllers using the Add Controllers option provided at Step 3. You can then import the added Cisco Wireless Controller to the Cisco DNA Spaces location hierarchy using the Import Controllers option at Step 4. You can view the Cisco DNA Spaces Connectors and Cisco Wireless Controllers added using View Connectors and View Controllers options respectively. You can view the location hierarchy using the View Location Hierarchy option. For the OpenRoaming app, you can configure the hotspots through the Add OpenRoaming Hotspot option provided at Step 2. You can also view the configurations for the OpenRoaming app for various controllers separately using the OpenRoaming Controller Configuration option provided at Step 2.

  • Connect WLC/ Catalyst 9800 Directly: Displays step-by-step instructions to connect Cisco DNA Spaces to Cisco AireOS Wireless Controller or Cisco Catalyst 9800 Series Wireless Controller using Cisco Wireless Controller Direct Connect.

  • Connect via CMX Manual Upload: Displays step-by-step instructions to configure location hierarchy using a JSON file and to configure location updates for these locations for notifications and reports. You can upload the JSON file using the Upload Json option at Step 3.

  • Connect via CMX Tethering: Displays step-by-step instructions to configure location updates for a Cisco CMX node using CMX tethering with token. You can create the token using the Create New Token option at Step 2, and configure it in Cisco CMX. Then you can add the tethered Cisco CMX node to the location hierarchy using the Add CMXoption at Step 3.

  • Connect via CMX On-Prem Auto Sync: Displays step-by-step instructions to configure location updates for Cisco DNA Spaces by connecting to a Cisco CMX account using VPN. You can connect to Cisco CMX using Add CMX On-Prem provided at Step 2.

Any of the following tab will be displayed for Cisco Meraki based on your selection.

  • Connect via Meraki Login: Displays instructions to connect Cisco DNA Spaces to Cisco Meraki network using a Meraki account. You can connect to Cisco Meraki using the Connect option provided at Step 1. You can import a Meraki Organization and its child locations to the location hierarchy using the Import Networks option at Step 3.

  • Connect via Meraki API Key: Displays instructions to connect Cisco DNA Spaces to Cisco Meraki network using a Meraki API Key. You can import a Meraki Organization and its child locations to the location hierarchy using the Import Networks option at Step 3.

View Configuration Steps: Redirects to the documentation for the particular wireless network.

System Requirements: Provides the system requirements for Cisco DNA Spaces.

Frequently asked questions: Provides the link to the frequently asked questions for Cisco DNA Spaces.

Cisco AireOS/Catalyst: Displays instructions to import a CMX Node (CMX On-Prem) to the Location Hierarchy window.

Cisco Meraki: Displays instructions to import a Meraki Organization to the Location Hierarchy window.

Setting up Cisco DNA Spaces to Work with Cisco Meraki Camera

Cisco DNA Spaces enables you determine the number of visitors visiting your locations using a Cisco Meraki Camera. To avail this feature you must have a Meraki log in and must have installed Cisco Meraki Cameras in your locations. However, Meraki Camera supports internet access from Cisco AireOS or Cisco Catalyst network, and the Camera deployment can work alongside a Cisco Catalyst or Cisco AireOS deployment.

You can capture the following details using the Camera feature:

  • The total number of visits entering a location.

  • The total number of visits leaving a location.

  • The total number of visitors currently present at a location.


Note

If a visitor exits the tripwire line and enters the tripwire line again, the new entry is counted as a separate visit.

You can view the visitor count using the Camera Metrics app available in the Cisco DNA Spaces dashboard.

Configuring a Meraki Camera

To configure the Meraki Camera, perform the following steps:

Procedure

Step 1

In the Cisco Meraki dashboard, configure the cameras on required Meraki Network. For more information on configuring the cameras on the Meraki network, see Configuring Cameras.

Step 2

In the Cisco DNA Spaces dashboard, click the three-line menu icon displayed at the top-left of the dashboard.

Step 3

Choose Setup > Camera.

The Connect your Camera window appears.

Step 4

Click Get Started.

Note 

If you have connected to the Cisco Meraki earlier, the widget corresponding to the connection method used will be displayed automatically in the Connect your Camera window. In such cases, Get Started will not be displayed. If you want to connect to Cisco Meraki using same connection method(Login, API Key) for configuring Meraki camera, you can skip Step 4 to Step 6. However if you want to connect through the alternate connection method, you can add the corrsponding widget using Add New. If you have added widgets for both connection methods(through login and API key), Add New will be disabled.

Step 5

Click Select for the method using which you want to connect Cisco Meraki to Cisco DNA Spaces.

The window displays the prerequisites for the selected method. For more information on the methods, see Setting Up Cisco DNA Spaces to Work with Various Wireless Networks.

Step 6

Click Continue Setup.

In the Connect your wireless network window, a widget now appears using which you can configure the camera. The widget that appears depend on the method you selected at Step 5. For the Connect Via Meraki Login method, the widget displayed will be Meraki Camera for analytics via Meraki Login. For the Connect via API Key method, the widget displayed will be Meraki Camera for analytics via Meraki API Key.

Step 7

In the expanded widget, click Connect displayed at Step 1.

If you are already connected to the Cisco Meraki network using the same connection method, the instruction for Step 1 gets replaced with the message that you are connected, and the Connect link will not be displayed. In such cases, you can skip this step.

  1. For the Meraki Camera for analytics via Meraki Login widget, a window appears with fields to enter e-mail and password for login. Enter the login credentials, and click Submit. After connecting successfully, the content in Step 1 gets replaced with the message "Connected as [e-mail using which you have connected].

  2. For the Meraki Camera for analytics via Meraki API Key widget, a window appears with a API Key field. Enter the API Key, and click Submit. After connecting successfully, the content in Step 1 gets replaced with the message "Connected with [ masked API key].

Step 8

Click Import Networks displayed at Step 2 in the Connect your Meraki Camera window .

And if the camera network is already imported to the location hierarchy section, then you can skip Step 8 to Step 12.

Step 9

In the Import Networks window, select the Meraki Organization (in which the Meraki Camera Networks are configured) that you want to import.

Step 10

From the Choose Networks area, select the check boxes for the Meraki networks that you want to import.

Step 11

Click Import.

The total number of Meraki networks and cameras that are imported are displayed.
Step 12

Click Finish.

Step 13

Configure the MQTT Server details in Cisco Meraki as follows:

Host and port of the MQTT server are acount-specific, and the same for your Cisco DNA Spaces account will be displayed at Step 3 in the Connect your Meraki Camera window. You must configure this MQTT server details in Cisco Meraki.

  1. Log in to Cisco Meraki dashboard.

  2. From the menu in the left pane of the dashboard, choose Cameras > Cameras.

  3. In the Name field, click the link for the camera for which you want configure the MQTT server.

    The details of the selected camera are displayed. The Video tab for the camera is displayed by default.

  4. Click the Settings tab, and click Sense

  5. To the right of Sense API, click Enabled.

  6. Click the Add or Edit MQTT Brokers link.

  7. In the Edit MQTT Brokers window, click New MQTT Broker.

  8. In the Edit MQTT Broker window that appears, enter the MQTT server details.

    Host and port will be displayed at Step 3 in the Connect your Meraki Camera window.

  9. Click Save.

Now the cameras imported will be displayed in Cisco DNA Spaces dashboard.
Step 14

To configure the Entry/Exit line for the camera, click Draw Trip Wire at Step 4 in the Connect your Meraki Camera window.

Step 15

In the Draw Trip-Wire window that appears, click Select Locations, choose the location in which the camera is configured, and click Done.

Step 16

In the Select a camera you wish to draw the trip-wire area, select the radio button for the camera for which you want to set the trip wire, and click Next .

The camera preview image appears with Add Trip-wire over it.

Step 17

Click Add Trip-wire.

Step 18

Create the trip-wire by drawing a line on the camera preview image using +.

By default, the entry and exit arrows will appear in the middle of the trip-wire. The green arrow represents Entry and the red arrow represents Exit. Ensure that the entry and exit arrows are pointing in the direction as shown in the folowing images. If the arrows are not positioned properly, hover over the line, and click the arrow that appears to flip the line.

Step 19

Ensure to click both the end points of the line to configure the XY cordinates. After clicking the end points of the line, the XY cordinates for the entry and exit arrows will be displayed automatically in the Trip-wire status area, and status gets changed to Set. By default, the status will be Not Set.

Note 

The status will be changed to Set only if you click both the end points of the line.

Step 20

Click Finish.

Now the camera is configured to use in Cisco DNA Spaces.

Editing the Trip Wire for a Camera

To edit the XY coordinates of trip wire for a camera, perform the following steps:

Procedure

Step 1

In the Cisco DNA Spaces dashboard, click the three-line menu icon displayed at the top-left of the dashboard.

Step 2

Choose Settings > Camera.

The Connect your Meraki Camera window appears.

Step 3

Click View Cameras displayed at Step 4 in the Connect your Meraki Camera window .

The Cameras imported to Cisco DNA Spaces are displayed. You can filter to view the the cameras for a particular location.
Step 4

Click the Edit icon that is displayed far-right of the camera for which you want to edit the trip wire.

Step 5

In the Edit Trip Wirewindow that appears, edit the trip wire details, and click Done

Was this Document Helpful?

FeedbackFeedback

Contact Cisco