Description
Downloads and updates LIPI installation and configuration files.
...
Installing the LIPI CLI Tool
Download the CLI tool
| Code Block |
|---|
# download user@localhost$ wget <https://apistorage.mazemap.com/lipi/download/lipi> # (optional) add to path for ease of use user@localhost$ latest/lipi |
(Optional) Add lipi command to your path. Then you can run command with $ lipi instead of $ ./lipi
| Code Block |
|---|
cp lipi /usr/local/bin/
# complete installation |
Complete the installation (one
...
time
...
setup
...
of
...
api
...
key
...
and
...
installation
...
folder)
...
| Code Block |
|---|
lipi --setup Initiating setup Setup already complete. Reconfigure (y/n): y Mazemap API key: 123456789 <input your api key from Map Editor here> |
Putting in your API key:
a. Go to Map Editor and navigate the Indoor Positioning menu
...
b. Click the LIPI Configuration
...
c. Expand the LIPI configuration and click on “Generate”. You can copy this key and paste it on your SSH
...
When you have already pasted the API key as shown above, you will get a new question regarding the name of your new folder in the field as shown below. (E.g, “lipi-install” or any intuitive names). Save the configuration and cron as shown in Lines 2 and 3 below.
| Code Block |
|---|
Installation folder: /lipi-install <input directory name here> Saving config: OK Installing cron: OK |
Once you have successfully installed the tool we use to install and set up the LIPI correctly, you will get the following message.
| Code Block |
|---|
Setup complete |
Usage
Download and install latest lipi
...
| Code Block | ||
|---|---|---|
| ||
# Starts a service on port 443 which answers 200 on localhost:443/shallow and localhost:443/deep. # This will allow the health checks to complete even though there's no lipi service running. ./start-mock-server.sh # run commands on python src: python src/updater.py --help # run commands using packaged executable bin/lipi --help |
SUMMARY
This summary contains commands that are useful when setting up the LIPI server.
The config file that is used is under the /srv folder use command cd to open folder and ls to read what is in the folder.
Action | Command | Comment |
|---|---|---|
Start LIPI server | sudo systemctl start lipi | |
Stop LIPI server | sudo systemctl stop lipi | |
Restart LIPI server | sudo systemctl restart lipi | |
Status of LIPI server | sudo systemctl status lipi | |
Check the lipi log | journalctl -u lipi -n 200 -f | |
Get list of GPS markers from CMX | curl https://<CMX_IP>/gcpdump --insecure | If this is successful it means |
Create a new command line user in CMX | cmxos apiserver user add [the_username] [the_password] | |
Update lipi | Download the new lipi Make sure that the file is executable by typing: | |
open and update the config file | sudo nano config.json | |
view the config file | cat config.json | |
Move a file from one location to another | mv <start location> <end location> | In the example the config file is located in /home/cygate and we are moving it to /srv/. We are replacing the old file with the new file. |
It is useful to know what happens when you install or upgrade lipi. Since LIPI Version 4.0.0
When you run the INSTALL script the following happens:
Java is installed on the server
The keystor, geopos.jar and config.json files are copied to /srv folder
The geopos.service file is copied over to /etc/systemd/system folder
The LIPI server is started
When you run the UPGRADE script the following happens:
The LIPI Server is Stopped
The keystore and geopos.jar files are copied to /srv folder (Note: the config.json file is not updated)
The geopos.service file is copied over to /etc/systemd/system folder
The LIPI server is started again