Sentilo平台技术常见问题解答

Sentilo平台简介

Sentilo是一个开源的传感器网络平台，专为智慧城市和物联网应用设计。它提供了传感器数据收集、存储、处理和分发的完整解决方案。本文将针对Sentilo平台使用过程中常见的技术问题进行详细解答。

平台兼容性与部署环境

测试过的平台配置

Sentilo已在多种Linux服务器环境中成功部署和测试。以下是巴塞罗那市议会首次部署的典型配置：

前端服务器配置：

• 操作系统：Ubuntu Server LTS 18.04
• 内存：4GB
• 硬盘：16GB

后端服务器配置：

• 操作系统：Ubuntu Server LTS 18.04
• 内存：4GB
• 硬盘：16GB

实时数据库服务器(Redis)配置：

• 内存：32GB
• 硬盘：36GB

其他已知的Sentilo实例主要部署在CentOS 6+和Ubuntu Server 14.04+环境中。虽然这些是官方测试过的配置，但Sentilo也可以在其他Linux发行版上运行，只要满足系统资源需求即可。

常见问题解决方案

数据发布后未显示在目录中

问题描述：成功发布观测数据后，在目录中看不到相应数据。

解决方案：

1. 确保Catalog和Sentilo API服务器使用相同的时区（推荐UTC）
2. 确认sentilo-server启动时包含以下JVM参数：

   -Duser.timezone=UTC
   

3. 检查托管Catalog应用的Tomcat是否也设置了相同的参数（通常在$JAVA_OPTS变量中）

Google地图无法显示

问题原因：Google地图API密钥政策变更导致。

解决方案：

1. 获取有效的Google Maps API密钥
2. 在配置文件/etc/sentilo/sentilo-catalog.conf中添加：

   # Google API key to use Google Maps
   sentilo.catalog.map.google.key=<你的API密钥>
   

3. 重启Tomcat服务使配置生效

新创建的Provider令牌无效

问题现象：创建Provider后立即使用其令牌发布观测数据时收到401"Invalid credential"错误。

可能原因及解决方案：

1. 后台任务延迟：Provider激活是一个后台任务，每5分钟运行一次。请等待几分钟后重试。
2. 启动顺序问题：如果API服务器在Catalog应用之前启动，可能导致权限同步失败。
   • 解决方案：重启Sentilo，确保API服务器在Catalog应用完全部署后再启动。

安装与验证

安装确认方法

确认Sentilo平台是否正常运行的方法：

1. 使用测试脚本：

   ./scripts/testServerStatus.sh
   

2. 本地安装验证：
   • 目录应用：http://localhost:8080/sentilo-catalog-web
   • REST API：http://localhost:8081

构建失败问题

问题描述：执行mvn package appassembler:assemble命令失败。

解决方案：确保在要安装的组件目录中执行该命令。

调试与日志

启用调试日志

要启用Sentilo的调试日志，可以通过JVM参数设置日志级别：

1. 在组件的bin目录下的脚本中添加：

   -Dsentilo.log.level=DEBUG
   

2. 重启服务使配置生效

最佳实践建议

1. 部署顺序：始终确保Catalog应用在API服务器之前完全部署。
2. 时区配置：所有组件统一使用UTC时区以避免时间同步问题。
3. 资源监控：定期检查Redis数据库的内存使用情况，特别是在高负载环境下。
4. 密钥管理：妥善保管Google Maps API密钥等敏感信息。

通过以上解决方案和最佳实践，可以确保Sentilo平台稳定运行并充分发挥其在物联网和智慧城市应用中的价值。