...
| Info |
|---|
The following assumes that reader is proficient in basic Linux usage and networking |
LIPI
- Download the newest LIPI installation files from MazeMap: https://www.jottacloud.com/s/113950633e009454e379c2f969e9943666d
- Upload this file to the LIPI server and unzip it
- Read the included README file
- Read through the installation script to understand what it does. There are different installation scripts for different operating systems, pick the one that matches the operating system of your LIPI server
...
| Issue | Symptom | Solution |
|---|---|---|
| Missing GPS markers | LIPI debug tool fails on test 6. No floor shown in client , position showing outside building | How To Add GPS markers to CMX |
| Broken/Poor GPS markers | Client location differs between CMX GUI and MazeMap/Visual Debug Tool | |
| Wrong z-mapping | Positioning works, but wrong floor is indicated. Z-level is visible in the LIPI Debug Tool. | Add explicit zmapping for floor in LIPI config file |
| No zmapping | Positioning works, but wrong floor or "outside" is indicated | Add explicit zmapping for floor in LIPI config file |
| Firewall blocks Wireless clients from reaching LIPI | Debug tool fails on test 1. Position in client might appear outside building (since it falls back to the phones built in positioning service) | Open firewall |
| Firewall blocks LIPI from contacting CMX | Debug tool fails on test 4 or 1 (depending on timeout limits). | Open firewall |
Checklist
1. Is the LIPI server (ubuntu server) accessible?
2. Is the LIPI service (geopos.service) running?
2. 1. If it is not running: Is the JSON config correct?
2.2. If it is not running: Are there issues with dependencies? JAVA?
3. If it is running but not working: Are the LIPI able to connect to CMX? Ping or CURL it?
3.1. If it is able to connect to CMX but not getting any data: Are the LIPI CMX user able to get any data? Is the username and password correct in the config.json?
3.2. If it is still not able to get any data: Does the CMX user have the right privileges (Read access)?
4. If the CMX user is correct and the LIPI are able to get data from CMX but it is still not working: Are there GPS markers placed on the floors set up in MazeMap?
4.1. If there are no GPS markers set on the floor where the device running the test are located: Add GPS markers on the floors.
5. If the LIPI are able to get data from CMX and there are GPS markers placed on the floor but MazeMap are showing the wrong floor: Check z-mapping of the config.json
Tip to check output from journalctl geopos.service on the LIPI server, run the command: journalctl -u geopos.service -n 50
Maintenance
In order to ensure proper functioning of the positioning service, the service should be retested when changes are made to:
...