Deployment Requirements

Please make sure you have covered all the prerequisites before you start the configuration.

1

Virtual Machine requirements

In order to connect your wireless network with Cisco Spaces, Cisco Spaces Connector should be installed on a virtual machine. The Spaces Connector supports VMware ESXi 6.5 or above versions, as well as AMI and HyperV

The connector supports Standard/Advanced 1/Advanced 2 configurations with the VM requirements as follows:

Standard/Advanced 1/Advanced 2
vCPU 2/4/8
RAM 4/8/16 GB
Hard Disk 60GB

Note: Standard configuration is adequate in most cases unless Cisco Spaces team specifically recommends Med/High configuration for your deployment.

Tested VMware Environments

  • VMware ESXi: 6.5.0 Update 2 (Build 13004031), 6.7.0 Update 2 (Build 13006603)
  • VMware vSphere Client Version 6.7.0
  • VMware vCenter Server Appliance 6.7.0
2

Spaces Connector and Cisco Spaces endpoints

The Cisco Spaces Connector should be able to reach out to the Cisco Spaces endpoints for establishing data connectivity with Cisco Spaces.)

For Global Setup

The Cisco Spaces Connector must be able to reach out to https://connector.dnaspaces.io/

Primary IP Address 52.20.144.155, 34.231.154.95
Disaster Recovery 54.176.92.81, 54.183.58.225

For EU Setup

The Cisco Spaces Connector must be able to reach out to https://connector.dnaspaces.eu/

Primary IP Address 63.33.127.190, 63.33.175.64
Disaster Recovery 3.122.15.26, 3.122.15.7

For Singapore Setup

The Cisco Spaces Connector must be able to reach out to https://connector.ciscospaces.sg/

Primary IP Address 13.228.159.49, 54.179.105.241
Disaster Recovery 13.214.251.223, 54.255.57.46
3

The Cisco Spaces Connector must be able to communicate to the WLC on ports:
– 16113 TCP (NMSP)
– 161/162 UDP (SNMP) – only for AirOS
– 830 TCP (NETCONF) – only for Catalyst Controllers
– 22 TCP (SSH)Ed
– Information about Open Ports: https://www.cisco.com/c/en/us/td/docs/wireless/spaces/connector/2-x/config/b_connector/m_open-ports.html

4

Ensure that the CMX Cloud Services are disabled on the WLC. Execute the following command to disable your CMX Cloud Services: config cloud-services cmx disable

5

Ensure that https://www.cisco.com and cisco.com domains are white-listed.

The following connector specific control/data channels need to be whitelisted
connector.dnaspaces.io
connector.dnaspaces.eu
connector.ciscospaces.sg

6

SNMP Read/Write permissions are needed for AireOS based controllers and not needed for IOS-XE based controllers.

7

The WLC Controller IP you configure in the Cisco Spaces dashboard must be able to reach out to the Cisco Spaces Connector. Refer to Step 3 above.

Note: The Cisco Spaces Connector is tested to operate on the internet links with less than 0.1% packet loss.

Download and Deploy the Cisco Spaces Connector OVA

  • STEP 1

    Download the Cisco Spaces Connector OVA from here: Cisco Spaces OVA

  • STEP 2

    Deploy the downloaded Cisco Spaces OVA file on your virtual machine.

  • STEP 3

    Once the OVA is deployed, you can log into the VMware console using the default username and password provided in the console.

  • STEP 4

    Enter the network settings.

  • STEP 5

    Enter NTP settings or leave it blank.

  • STEP 6

    Set the password for the root user and dnasadmin user

    • The connector is operating in restricted mode, if they want root access in CLI that will be restricted. For security reasons the root access is disabled.
  • STEP 7

    When prompted, reboot the device and open the WebUI using the address provided.

    NOTE:

    2.x will use dnasadmin
    3.x will use spacesadmin
    2.x and 3.x is selected when the customer selects the ova file download
    Connector Configuration guide: https://www.cisco.com/c/en/us/td/docs/wireless/cisco-dna-spaces/connector/config/b_connector/m_ova.html

Adding a Connector in Cisco Spaces

  • STEP 1

    In the Cisco Spaces dashboard, click on “Setup” on the Menu

  • STEP 2

    Select “Wireless Networks” ​

  • STEP 3

    Click on “Get Started” button ​

  • STEP 4

    Select “Cisco AireOS/Catalyst”

  • STEP 5

    Select “via Spaces Connector”, then select “Continue Setup” button


  • STEP 6

    Under step 2 “Configure Spaces Connector”, click on “Create Connector”

  • STEP 7

    In the “Connector Name” field, enter a name for the connector and click on “Save”.

  • Setting up the Cisco Spaces Connector

    You now need to copy the Connector token from Cisco Spaces dashboard and configure it in Spaces Connector VM GUI. Follow these steps to copy the Token:

  • STEP 8

    On the Customized Setup page step 2 “Configure Spaces Connector”, click on “View Connectors”

  • STEP 9

    You will see the list of Connectors you’ve created. Select the desired Connector.

  • STEP 10

    Click on ‘Generate Token’

  • STEP 11

    Copy the token that appears on the following screen of the Cisco Spaces dashboard

  • STEP 12

    Launch the Cisco Spaces Connector using the HTTP address provided at the OVA deployment, https://< IP-address >/. In the Cisco Spaces Connector window that opens up, enter the username and password that was configured earlier.

  • STEP 13

    (For a 2.3.x instance) on “Configure Token” click on ‘Setup’

  • STEP 14

    (For a 2.3.x instance) Paste the generated token copied from Cisco Spaces dashboard and click “Save”. You may need to wait a few minutes for Cisco Spaces connector to start as images may take some time to download. The wait time is dependent on the speed of your connection

  • STEP 15

    Once the Cisco Spaces Connector is displayed, you can observe the health of various connections, as illustrated in the image below:

    • Running: Status in the top-right indicates that the Cisco Spaces Connector is up and running.
    • Control Channel: Health of connection between Cisco Spaces Connector and Cisco Spaces Cloud.
    • Data Channel: Health of connection between Cisco Spaces Connector and Cisco Spaces Cloud.
    • Connector Details: NMSP connection between Cisco Spaces Connector and Cisco Wireless Controller (WLC).

Setup a Proxy

In the Cisco Spaces Connector window, you can also configure the HTTP Proxy and other Privacy settings.

Setup Proxy to connect the Cisco Spaces Connector to the Cisco Spaces Cloud.

  • STEP 1

    Add proxy server by clicking “Configure Proxy” under settings
    add proxy IP with port – http or https

    ex: https://< proxy server IP>:< port >

  • STEP 2

    Verify the proxy by seeing dashboard proxy status “proxy configured”

Setup Proxy

NOTE: Proxy Setup is required only if your virtual machine hosting the Cisco Spaces Connector is behind a proxy. Without this proxy configuration, the Cisco Spaces Connector is unable to communicate with the Cisco Spaces Cloud.

Adding a Controller in Cisco Spaces

  • STEP 1

    On the Customized Setup page step 3, click on “Add Controllers”

  • STEP 2

    Select the Connector you’ve just created from the drop-down

  • STEP 3

    Add the IP address of the Controller

  • STEP 4

    Add the name of the Controller

  • STEP 5

    Select Controller Type

  • STEP 6

    Add details based on your controller type.

    For WLC (AireOS) – Select Controller SNMP version depending on your controller’s SNMP version. Read/Write permissions are needed for V2C and V3

    • For V2C SNMP, provide SNMP Community.
    • For V3 SNMP, provide username, password, select authentication Protocol and enter Privacy password.

    For Catalyst WLC / Catalyst 9800 – Add the following credentials

    • Enter Netconf Username and Password.
    • Enter Enable password of the controller.
    • Verify the interface: NMSP will only be sent from the interface configured as the “wireless management interface”. Interfaces used as a service-port (e.g., gig0/0 for an appliance) cannot send NMSP traffic.
  • STEP 7

    Click “Save & Add Next Controller” if you want to add another controller. If not, Click “Save & Close”.

Import your Maps into the Location Hierarchy

After the Spaces Connector is configured and starts running, you need to import your locations into the location hierarchy.

  • If you have maps in Cisco Prime or DNA Center version 1.3.1 & above, you may import locations in the same hierarchical structure as defined in Cisco Prime or DNA Center by importing the maps file from these products.
  • If you don’t have maps on Cisco Prime or DNA Center version 1.3.1 & above, then you may import controllers in location hierarchy and manually group them into business locations on your Cisco Spaces dashboard.

Please Note: Cisco Prime/DNAC maps are required for Detect & Locate, Asset tracker, IoT services, and Proximity Reporting.

Please contact dnaspaces-onboarding@cisco.com if you don’t have DNA Center or Cisco Prime Maps

  • STEP 1

    Import maps from Cisco Prime or sync from DNA Center.

  • STEP 2

    Go to Customized Setup page step 4 “Import Maps”, click on “Import/Sync Maps”

    Please select the respective product from where you want to import the maps.

    Upload the map file that you have downloaded from Cisco Prime or DNAC

    You have successfully connected your network with Cisco Spaces. You may now organize the Location Hierarchy.

    If you don’t have maps on Cisco Prime or DNA Center, then follow Step 3 to import controllers in location hierarchy and group APs into business locations manually in Cisco Spaces dashboard.

  • STEP 3

    Go to Step 5 of Customized Setup page “Setup location hierarchy”, and click on “Add Locations”

    Please select “No, add location using AP prefix”

    Please choose the destination where you want to import controllers and click “Next”. (If you’re importing controllers for the first time, you will see the default location i.e. your Cisco Spaces account name. If not, you will also see the controllers that you had imported earlier)

    Choose the controller/networks you want to import and click “Finish”.

    • If the APs of the controllers are grouped as networks based on an existing naming convention, those network names will appear. If you want to retain the same grouping, just select the networks. However, if your APs are not grouped, network names will not be displayed.

    With Grouped Network names

    Without Network names

    You have successfully connected your network with Cisco Spaces. You may now organize the Location Hierarchy.