Sentilo平台安装与配置完全指南

前言

Sentilo是一个开源的物联网平台，主要用于传感器数据收集、处理和分发。本文将详细介绍如何从零开始搭建Sentilo平台，包括环境准备、代码获取、编译构建以及部署配置的全过程。

环境准备

在开始安装Sentilo之前，需要确保系统已安装以下基础软件：

1. Java开发环境：JDK 1.8或更高版本
2. 构建工具：Maven 3.x
3. 版本控制工具（可选）：Git

确保Java和Maven的可执行文件已添加到系统PATH环境变量中，以便全局调用。

获取源代码

Sentilo的源代码可以通过以下两种方式获取：

方法一：使用Git克隆

git clone https://github.com/sentilo/sentilo.git sentilo

方法二：下载ZIP压缩包

下载后解压到名为"sentilo"的目录中

无论采用哪种方式，最终都会得到一个包含完整源代码的"sentilo"目录。

编译与构建

Sentilo提供了便捷的构建脚本buildSentilo.sh，位于./scripts/目录下。执行该脚本将自动完成以下工作：

1. 编译所有模块
2. 生成部署包
3. 将构建结果输出到../sentilo-deploy-artifacts目录

构建完成后，sentilo-deploy-artifacts目录将包含以下内容：

• conf：所有配置文件
• sentilo-agent-*：各种代理模块的部署结构
• sentilo-catalog-web：Web应用war包
• sentilo-platform-server：平台服务器部署结构

自定义构建

如需修改代码后再构建，建议：

1. 使用Eclipse导入项目（需安装M2E插件）
2. 确保Eclipse配置了JDK 1.8+
3. 修改完成后，仍使用buildSentilo.sh脚本构建

平台基础设施

Sentilo运行依赖以下基础设施组件：

必需组件

1. Redis 6.2.2：用于实时数据存储
2. MongoDB 4.4.2：用于持久化存储
3. Tomcat 8.5.32+：Web容器

可选组件

1. MySQL 5.5.x：关系型数据库代理
2. Elasticsearch 6+：活动监控代理
3. openTSDB 2.2.0+：历史数据代理

配置详解

Sentilo采用Spring和Maven的profile机制来支持不同环境的配置。默认使用"dev" profile，假设所有组件都安装在本地机器上，使用标准端口：

• Redis: 6379
• MongoDB: 27017
• Tomcat: 8080
• MySQL: 3306
• Elasticsearch: 9200
• openTSDB: 4242

配置文件结构

Sentilo的配置采用分层覆盖机制：

1. 基础配置：位于各模块的src/main/resources/properties目录下
2. 运行时配置：部署在/etc/sentilo目录下，会覆盖基础配置

关键配置文件：

• sentilo.conf：平台核心配置
• 各模块的.conf文件：模块特定配置

配置覆盖机制示例

# 基础配置（classpath中）
sentilo.redis.host=127.0.0.1

# 运行时配置（/etc/sentilo/sentilo.conf）
sentilo.redis.host=192.168.2.106

重要配置参数

参数	默认值	说明
sentilo.redis.password	sentilo	Redis访问密码
sentilo.redis.expire.key.seconds	0	Redis数据过期时间(0表示永不过期)
sentilo.redis.connTimeout	5000	Redis连接超时(毫秒)
sentilo.redis.client.maxTotal	10	连接池最大连接数

部署建议

1. 配置文件：将sentilo.conf部署到/etc/sentilo目录
2. 组件部署：根据实际需求选择部署哪些代理模块
3. 环境隔离：生产环境建议将各组件部署在不同服务器上
4. 性能调优：根据负载情况调整连接池等参数

常见问题

1. 版本兼容性：确保所有组件版本匹配
2. 端口冲突：检查各组件默认端口是否被占用
3. 权限问题：确保应用有权限访问配置文件和数据库

通过以上步骤，您应该能够成功搭建并运行Sentilo平台。如需进一步定制，可以参考各模块的详细配置说明进行深度配置。