Requirements for LIPI server and Cisco CMX

Owned by Kenneth Pedersen (Unlicensed)
Last updated: 26 Feb, 2020 by Roselle B Dela Fuente (Unlicensed)

The MazeMap-CMX integration comprises of three services that must be configured to work together

  • The Cisco CMX, configured and hosted by the customer
  • The LIPI Server, configured and hosted by the customer

Pre-Installation checks

Requirements for the LIPI server

    • Can be virtual or physical, does not matter.

    • No OVA currently available, one of the supported OSes needs to be installed.

    • Supported Operating systems: Newest stable Ubuntu or Debian.

    • Server/Virtual Machine(VM) specs: Tested to work with single Core VM with 3.5 GB Ram and 7 GB HDD.

Requirements for the network

    • Open port 443 from LIPI server to CMX (https for API).
    • Open port 443 from all wireless clients to LIPI (https for position requests).
    • Traffic from Wireless Clients to LIPI must not pass through NAT.

Requirements for the CMX 

    • CMX set up with Location services activated and sufficient licenses.
    • Building maps, with correct map scaling and a minimum of 3 GPS markers per floor need to be set up on Cisco Prime, exported and imported into CMX.
      • GPS markers should use coordinates created using MazeMaps own map. MazeMap provides a tool for generating these. You can find the POI inspector-tool here: https://debug.mazemap.com/
    • Access points must be placed correctly (within a meter of actual location) in the maps in Cisco Prime.
    • CMX GUI user for MazeMap with Full Read Only privileges set up on MSE/CMX.
    • CMX CLI API user with full Read and API access. Both CMX GUI and CLI users should have the same username/password
      To create a CMX CLI user       ssh into your CMX and run the following command: cmxos apiserver user add
      You will be asked to type in a username and password for the user - use the same username and password as you used for the GUI user.



Installation Instructions


The following assumes that reader is proficient in basic Linux usage and networking
If installing LIPI with internet connection, refer to LIPI for CMX Installation Guide
If installing LIPI without internet connection, please refer to LIPI for CMX Offline Installation Guide.

Siteresolver


The siteresolver must be configured by MazeMap. MazeMap requires the following information in order to set this up:
  • The private IP address of the LIPI server (the address that WiFi clients will use to connect to the LIPI without traversing NAT)
  • The public IP address or range of addresses for the WiFI clients. This is most commonly the public IP address of the NAT