LEAPS Center

LEAPS Center 是一个网络应用程序，提供设备管理, 网络管理以及整个网络的位置和遥测数据的可视化。

主要功能

  • 2D和3D网格提供实时位置更新，并将网络中的设备可视化。

  • 其他有用的功能包括用户管理, 区域管理, 区域历史, 平面图管理, 位置历史和位置热图。

  • The LEAPS Center 通过 MQTT Broker 与 LEAPS Server 互联. 它作为一项服务在 Linux 和 Windows 上运行

安装

系统要求

Docker的系统要求因操作系统而异。

  • 对于 Linux，您需要 64 位架构, 兼容的内核版本和特定的内核功能。

  • 在 Windows 上，在启用虚拟化的 Windows 10上使用 Docker Desktop

  • 在 macOS 上，请使用配备 macOS 10.13 或更新版本的Docker Desktop. 在硬件方面，建议至少配备 2GB 内存以及足够的 CPU 和磁盘空间。

注解

有关最新详情，请参阅 Docker 官方文档。

说明

  1. 在电脑上安装 Docker

在 Linux 上安装 Docker Desktop

此外，您还可以参考以下命令进行安装：

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh ./get-docker.sh
sudo usermod -aG docker $USER

在 Windows 上安装 Docker Desktop

在macOS上安装Docker桌面

  1. 准备配置软件包

  1. 在电脑上打开命令提示符或终端窗口。

例如，在 Ubuntu (Linux) 上：

cd LEAPS_CENTER_DOCKER/

  1. 安装 LEAPS Center Docker 软件包并运行：

docker run -d -p 80:8080/tcp --name some_name -v /path/to/data/data/:/app/data/ -e LEAPS_CENTER_HOME=/app/data/ leapslabs/leaps_center:tag sh -c "cd /app &&  java -jar leaps-center-web.jar"

其中 some_name 是要分配给容器的名称，tag 是指定要使用的 leaps-center-web 版本的标记。

leaps_center 映像必须与外部挂载的文件夹一起运行，该文件夹包含配置文件以及应用程序日志和配置/节点历史数据库的空间。

选项 -v /path/to/data/:/app/data/ 将位于 /path/to/data/ 的文件夹挂载到内部的 /app/data 文件夹. 数据文件夹必须包含以下文件。

  • 推荐的运行选项

    • --user $(id -u):$(id -g) 在特定用户和组下运行实例。

    • --restart unless-stopped 在服务器崩溃时自动重启实例。

  • 可选运行选项

    • --security-opt seccomp=unconfined 在 32 位 Raspberry Pi 镜像（Raspbian）上需要这个选项，因为它包含一个过时的 seccomp 库，其中的一个错误会对 Docker 镜像产生负面影响（无法连接到 MQTT 服务器）. 该选项允许我们覆盖这一问题。

  1. LEAPS Center 安装过程将开始。

例如，在 Ubuntu (Linux) 上：

docker run -d -p 80:8080/tcp --name leaps_center -v $PWD/leaps_center/:/app/data/ -e LEAPS_CENTER_HOME=/app/data/ leapslabs/leaps_center:latest sh -c "cd /app &&  java -jar leaps-center-web.jar"

Unable to find image 'leapslabs/leaps_center:latest' locally
latest: Pulling from leapslabs/leaps_center
a458657ccc71: Pull complete
Digest: sha256:a19b127656d41d8607f043c2c83924e5b9a5cbd4dc23cfbed070be3b9cfc6b9a
Status: Downloaded newer image for leapslabs/leaps_center:latest
320d3768289874e063619f75faca7a24dd75a08884df8cd8fb2cc9b54c6f0a46

  1. 确认安装成功，运行：

例如，在 Ubuntu (Linux) 上：

docker ps

CONTAINER ID   IMAGE                    COMMAND                  CREATED          STATUS                          PORTS     NAMES
b1145b72db35   leapslabs/leaps_center:latest   "sh -c 'cd /app &&  …"   37 seconds ago   11 seconds ago                            leaps_center

  1. 打开web浏览器并输入以下内容 http://localhost:80； 将在web浏览器中加载 LEAPS Center 应用程序。

../../../_images/lc_login.png

因此，您已在PC上成功安装并启动 LEAPS Center。

配置文件

  • leaps-center-web.conf

    JAVA_OPTS="-Xms256m -Xmx512m -Xss256k"

  • 应用程序。属性

  • leaps-center-history.properties

  • leaps-center-web.properties

    该配置文件控制应用程序日志记录。

    #
#     LEAPS - Low Energy Accurate Positioning System - LEAPS Center.
#
#     Copyright (c) 2016-2026, LEAPS.
#
#     Licensed under the Apache License, Version 2.0 (the "License");
#     you may not use this file except in compliance with the License.
#     You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
#     Unless required by applicable law or agreed to in writing, software
#     distributed under the License is distributed on an "AS IS" BASIS,
#     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
#     See the License for the specific language governing permissions and
#     limitations under the License.

#default WINDOWNS("user.home"/leaps-center-log/leaps-center-web.log), UNIX(/var/log/leaps-center-web.log)

# Logging file
#logging.file.name=/app/data/log/leaps-center-web.log

# Level log TRACE < DEBUG < INFO < WARN < ERROR < OFF, default is OFF
logging.level.root=OFF

    该配置文件控制节点位置历史记录。

    #
#       LEAPS - Low Energy Accurate Positioning System - LEAPS Center.
#
#       Copyright (c) 2016-2026, LEAPS.
#
#       Licensed under the Apache License, Version 2.0 (the "License");
#       You may not use this file except in compliance with the License.
#       You may obtain a copy of the License at
#
#       http://www.apache.org/licenses/LICENSE-2.0
#
#       Unless required by applicable law or agreed to in writing, software
#       distributed under the License is distributed on an "AS IS" BASIS,
#       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
#       See the License for the specific language governing permissions and
#       limitations under the License.
#

# history enabled (default false)
history.enabled=false
history.position.enabled=true
history.zone.enabled=true

# use node position message timestamp (default true)
history.use.position.timestamp=false

# =======================================================================================================
# Export Options
# =======================================================================================================

# add headers (default false)
history.export.headers=false

# maximum number of records (default 1000000)
history.export.max.lines=1000000

# compress export file (default true)
history.export.compress=true

# number of decimal places for x, y, z values (default 4)
history.export.position.decimal.places=2

# format network id to hex value (default true)
history.export.hex.network.id=true

# format node  ID to hex value (default true)
history.export.hex.node.id=true

# =======================================================================================================
# Position History Options
# =======================================================================================================

# interval time to add a history record (default 10000)
history.node.position.interval.time=10000

# minimun quality value (default 0)
history.node.position.min.quality=0

# =======================================================================================================
# Heatmap Options
# =======================================================================================================
# maximum number of records for heatmap (default 100000)
heatmap.max.results=100000

# =======================================================================================================
# Purge Options
# =======================================================================================================

# time to purge database records in days (default 30 days)
history.purge.time=30

# backup purged records to a file in /history folder (default false)
history.purge.backup.records=true

# max number of backup files (default 10)
history.purge.max.backup.files=5

# =======================================================================================================
# DBMS (SQLITE, POSTGRESQL, MY_SQL, ORACLE, SQL_SERVER or CUSTOM)
# =======================================================================================================

# History - SQLite Database Example (default).
# history.dbms=SQLITE
# history.db.jdbc.url=jdbc:sqlite:leaps-center-history.db
# history.db.username=
# history.db.password=

# History - PostgreSQL Database Example
# history.dbms=POSTGRESQL
# history.db.jdbc.url=jdbc:postgresql://localhost:5432/leaps_center_history
# history.db.username=leaps_center
# history.db.password=pwd

    该配置文件控制 leaps_center 应用程序。

    #
#       LEAPS - Low Energy Accurate Positioning System - LEAPS Center.
#
#       Copyright (c) 2016-2026, LEAPS.
#
#       Licensed under the Apache License, Version 2.0 (the "License");
#       you may not use this file except in compliance with the License.
#       You may obtain a copy of the License at
#
#       http://www.apache.org/licenses/LICENSE-2.0
#
#       Unless required by applicable law or agreed to in writing, software
#       distributed under the License is distributed on an "AS IS" BASIS,
#       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
#       See the License for the specific language governing permissions and
#       limitations under the License.
#

# database (SQLITE, POSTGRESQL, MY_SQL, ORACLE, SQL_SERVER or CUSTOM)
db.dbms=SQLITE

# History - SQLite Database Example.
# dbms=SQLITE
# db.jdbc.url=jdbc:sqlite:leaps-center-db
# db.username=
# db.password=

# History - PostgreSQL Database Example
# db.dbms=POSTGRESQL
# db.jdbc.url=jdbc:postgresql://localhost:5432/leaps_center
# db.username=postgres
# db.password=qwe123

# =======================================================================================================
# Network
# =======================================================================================================

# create the default network if it does not exist when starting. (default true)
network.create.default.network=true
network.create.default.floor.plan=false

# change the networkId via the gateway message.
network.change.network.id.via.gateway.message=false

network.default.id=1234
network.default.name=LEAPS

# network type, PANS or LEAPS
network.default.network.type=LEAPS

# PAN_ID or HOST
network.default.mqtt.connection.type=HOST

# WS or SSE
network.default.web.client.connection.type=SSE

# MQTT
mqtt.host=localhost
mqtt.ws.port=15675
mqtt.tcp.port=1883
mqtt.username=leaps
mqtt.password=leaps

mqtt.topic.prefix=leaps
mqtt.tag.topic.prefix=node
mqtt.anchor.topic.prefix=node

# define if the network id will be added in the topic prefix
mqtt.add.network.id.topic.prefix=true

# Enable/Disable MQTT TLS
# mqtt.tls=true
# mqtt.tls.host.name.verification.enabled=false
# CA_SIGNED_CERTIFICATE (signed by a publicly trusted CA), CA_FILE_CERTIFICATE (file certificate), SELF_SIGNED_CERTIFICATE (self signed file certificate);
# mqtt.tls.certificate.type=SELF_SIGNED_CERTIFICATE
# TLS Protocol: TLS_V1 (TLSv1), TLS_V1_1 (TLSv1.1), TLS_V1_2 (TLSv1.2), TLS_V1_3(TLSv1.3);
# mqtt.tls.protocol=TLS_V1_2
# mqtt.tls.certificate.file=/app/data/certs/cacert.pem

# mqtt.tls.client.certificate.file=/app/data/certs/leaps-center-broker-clientcert.pem
# mqtt.tls.client.key.file=/app/data/certs/leaps-center-broker-clientkey.pem
# mqtt.tls.client.password=

# =======================================================================================================
# Web server settings
# =======================================================================================================

# http session timeout
server.servlet.session.timeout=-1

# maximum number of http sessions per user (-1 is unlimited)
server.max.sessions.per.user=-1

# mod-jk/ajp connector configuration
tomcat.ajp.enabled=false
# tomcat.ajp.port=8009
# tomcat.ajp.secret.required=false
# tomcat.apr.enabled=false

# server port (2-65535), (default 8080)
server.port=8080

# enable / disable https
server.ssl.enabled=false
# keystore format
# server.ssl.key-store-type=PKCS12
# keystore location
# server.ssl.key-store=/usr/share/leaps_center/key-store.p12
# keystore alias
# server.ssl.key-alias=leaps_center
# keystore password
# server.ssl.key-store-password=password
# SSL protocol to use
# server.ssl.protocol=TLS
# Enabled SSL protocols
# server.ssl.enabled-protocols=TLSv1.2

#server.servlet.context-path=/leaps_center
server.sent.events.timeout=2

开始

默认情况下，登录账户的用户名为 admin，密码为 admin。

LEAPS Server Docker

网络配置

To configure the network, go to the menu and select Networks. Then, click the Add button at the bottom right to create a new network.

../../../_images/lc_list_networks.png

现在，填写所需的配置参数：

  • 名称

  • 主机

  • TCP 端口

  • 用户名

  • 主题前缀

  • 网络类型

如果不知道网络 ID，可以使用 LEAPS Manager 或 Shell 查找。

填写完毕后，点击 Save 按钮连接并接收网络 ID。

最后，您可以单击 Test 按钮检查连接情况，然后单击 Save 按钮保存配置。

节点配置

要配置节点，需要事先将节点分配到特定网络。

选择指定节点的网络，查看网络详细信息。 然后，您就可以开始配置节点了。

../../../_images/lc_list_nodes.png

有关可配置为网关, 锚点或标记节点的节点，请参阅以下详细信息

../../../_images/lc_config_gateway.png
../../../_images/lc_config_anchor.png
../../../_images/lc_config_tag.png

平面图

要配置平面图，请进入菜单并选择 Floor Plans。

Click the Add button in the bottom right. Then, import the Floor Plans you want to configure and fill in the corresponding parameters.

../../../_images/lc_floor_plans_create.png

填写完毕后，点击 Save 按钮保存配置. 使用 Visible 复选框启用地图上的可见性。

../../../_images/lc_floor_plans_udk.png

区域

要配置区段，请进入菜单并选择 Zones。

Click the Add button in the bottom right. Then, fill in the corresponding parameters and add the configuration for Save.

../../../_images/lc_zone_config.png

Once you’ve filled it in, click the Save button to save the configuration.

../../../_images/lc_zone_list.png

用户

要配置用户，请进入菜单并选择 Users。

默认情况下，应用程序已预先配置了一个管理员账户和一个普通账户。

../../../_images/lc_user_list.png

适用于管理员账户或普通账户。

应用程序接口授权

  1. 用户需要向/login发送一个简单的HTTP POST，并传递以下参数（以admin:admin为例）。

    • 用户名: admin

    • 密码：admin

    • 记住我：开启

  2. 登录后会生成 JSESSIONID cookie，用户需要在后续请求中使用它。

    注解

    1. 这不是强制性的，如果用户使用了它，会在响应中添加另一个 cookie（cookie REMEMBERME），用户可以在后续请求中使用它。

    2. 由于 LEAPS Center 在登录后以及用户未经授权时执行重定向，因此有必要在用户的客户端中正确设置”跟随重定向” 参数。登录后的响应码为302，但用户需要手动处理，因为如果用户未获得授权，状态码也为302。例如，用户可以向REST服务发出任何请求，如果响应状态代码不是200，则用户将不会被授权。

下面是一个用 Java 编写的请求和查询网络的代码示例：

../../../_images/api-authorization.png

更多详情，请参阅以下两段视频，一段使用 Postman，另一段使用 Java 代码

Postman

Java Client

故障排除

  • 使用以下命令 docker restart leaps_center 重启 LEAPS Center。

  • 当 LEAPS Center 正在运行时检查日志，打开docker桌面并选择leaps_center容器。

  • Open via Safari: If the interactive floor plan fails to load when you open the app, a Safari experimental feature is likely causing a conflict. Go to Settings > Safari > Advanced > Experimental Features and disable ‘requestIdleCallback’.