Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

MazeMap has released a new and improved LIPI indoor positioning software called LIPI 4.x. The process of updating to the newest LIPI version is simple and straightforward if you have access to the correct services, and your existing LIPI server is connected to the internet. (If your LIPI server is not connected to the internet, please follow the steps in this installation guide.) You will need to involve someone with access to the LIPI server and that preferably has experience with SSH and linux Linux when performing this update. For more detailed information about the LIPI installer, have a look at the this description.

For this update MazeMap has implemented a new tool that will:

...

Time needed: 30 minutes.

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.

    • A CMX GUI user for MazeMap with Full Read Only privileges set up on MSE/CMXCMX (MSE is not supported at the moment).

    • A 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.

    • Enable the apiserver on the CMX

      • To do so, ssh into the cmx and run the command:

        • cmxos apiserver enable

        • cmxos apiserver restart


Dependencies

In order to upgrade the LIPI you will need the following:

...

  1. SSH into the LIPI server

  2. Download and install the script by typing:

    Code Block
    wget -O lipi 'https://storage.mazemap.com';/lipi/latest/lipi
    chmod +x lipi;./lipi --setup
    


    You will get the following question:

    Code Block
    Mazemap API key (leave blank and hit <enter> for offline installation):

  3. To get your API Key do the following steps:

    1. Go to Map Editor and navigate to the Indoor positioning menu.

    2. Click on LIPI Configuration

    3. Expand a LIPI configuration and click on generate. You can then copy this key and past it into your SSH.

  4. When you have pasted in the API key from the question in 3, you will get a new question

    Code Block
    Installation folder:


    We recommend you to name the folder lipi-install

    Code Block
    Installation folder: lipi-install     


    After this is done, it is worth mentioning that the LIPI will send a status report to MazeMap on a regular basis. The information that is sent to the MazeMap is the same information that you get when typeing

    Code Block
    ./lipi --status


    You should get the following message, this means that you ave successfully installed the tool we use to install and set up the LIPI correct.

    Code Block
    Setup complete

  5. To download the LIPI do the following:

    Code Block
    ./lipi --install latest

  6. You will get the following questions. Press Enter for question number 1 and 2. Press y for question 3.

    Code Block
    Enter lipi_port (<enter> to keep "443"):
    Enter lipi server protocol (<enter> to keep "https")
    Ready to activate. Continue (y/n)?


    You should get the message:

    Code Block
    Stopping current lipi version: OK
    Waiting for LIPI to start (up to 30 sec): ....OK
    Saving config: OK

  7. Run the following command to get a status:

    Code Block
    ./lipi --status


    You should get the message:

    Code Block
    Checking lipi installation... OK
    Running shallow health checks... OK
    Running deep health checks... OK
    Status: healthy
    Version: 4.0.2Installed at: 2019-11-06 14:14:19

  8. Test and verify that the LIPI is running.

    1. Open a browser and go to https://debug.mazemap.com/lipi/

    2. Click on “Refresh List” and your LIPI should show up in the list.

    3. Click on the blue “Test”-button associated to your LIPI.

    4. If all tests are green and says “PASSED” it means your LIPI is working as expected without any issues. You can now go to use.mazemap.com and test that the blue dot is working as it did prior to the update.

    5. If one or more of the tests says “FAILED” contact MazeMap support at support@mazemap.com and describe the problem. Please take a screenshot of the tests and attach it to the email. Also click on the blue button on the bottom of the page that says “Send results to MazeMap”.

...