How to update to MazeMap LIPI v. 4.0.1

MazeMap has released a new and improved LIPI indoor positioning software called LIPI 4.0.1. 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, you can do please go 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 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:

download and update the LIPI for you;
make sure to use the current configuration running in your LIPI; and,
create a copy of the last working version so that you are able to go back to that version if there are any issues during the install.

This guide will explain what needs to be done Step-by-step to install the LIPI.

Time needed: 30 minutes.

Dependencies

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

SSH access to the LIPI server.
Access to CMX GUI (browser) and CLI (terminal).
A device that is connected to the WiFi network that is used for positioning purposes. This requires you being on site at the campus and using public wifi network
Pre-installed java in the server openjdk-8-jre-headless
Access to Map Editor in MazeMap https://admin.mazemap.com/
LIPI 4.1 software update tool that can be downloaded from here: https://storage.googleapis.com/mm-prod-app-public-sharing/lipi/1.0.0/lipi

Update an existing LIPI configuration:

SSH into the LIPI server

Download and install the script by typing:

wget -O lipi 'https://storage.googleapis.com/mm-prod-app-public-sharing/lipi/latest/lipi';chmod +x lipi;./lipi --setup

You will get the following question:

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

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.
When you have pasted in the API key from the question in 3, you will get a new question
```
Installation folder:
```
We recommend you to name the folder lipi-install
```
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
```
./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.
```
Setup complete
```
To download the LIPI do the following:
```
./lipi --install latest
```

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

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:

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

Run the following command to get a status:

./lipi --status

You should get the message:

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

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”.

Assistance:

If you need any help while doing the upgrade, you are welcome to send a mail to support@mazemap.com. If needed we can also schedule a meeting and go through the update together with you.

Good luck!