iotdb-web-workbench 编译安装说明文档

一、 前言

IoTDB-Workbench是IoTDB的可视化管理工具，可对IoTDB的数据进行增删改查、权限控制等，简化IoTDB的使用及学习成本。 欢迎大家一起参与IoTDB的开源社区，进行IoTDB-Workbench的开发及维护。

 

二 、如何获取源码

IoTDB-Workbench已在GitHub开源，仓库地址：https://github.com/apache/iotdb-web-workbench，有需要的可以自行下载。

三 、编译和打包

IoTDB-Workbench不提供二进制文件，有需要的小伙伴需要自行克隆后编译才可使用。

IoTDB-Workbench分为前端程序和后端程序，如下图，backend文件夹存放的是后端代码，frontend文件夹存放的是前段代码，需分别进行编译。

前端编译

 1. 依赖：

node 10.0.0 +

npm 6.0.0 +

 2. 编译：

cd iotdb-web-workbench/frontend

npm install

npm run build

如下图即为编译打包完成，文件路径

iotdb-web-workbench/frontend/dist

 3. 备注

若需要提高编译速度，可使用阿里云的cnpm命令行工具代替默认的npm

npm install -g cnpm --registry=https://registry.npmmirror.com

后端编译

 1. 依赖：

jdk1.8+

maven3.6+

2. 准备工作：

• 修改log路径

                配置文件路径：

iotdb-web-workbench/backend/src/main/resources/log4j2.xml

                需手动更换log路径为当前目录，如下图

•  修改端口信息

                为避免报错，可将后段端口与前端web界面的端口保持一致，需修改配置文件：

iotdb-web-workbench/backend/src/main/resources/application-dev.properties

                可按需修改如下端口、配置等参数：

 3. 编译

cd iotdb-web-workbench/backed
mvn package

        如下图，显示该内容即为编译完成，文件位置：

iotdb-web-workbench/backend/target/workbench-1.0.0.jar

四、 部署

为了可以更好的使用IoTDB-Workbench，我们使用nginx将前后端共同部署。

在经过上一步骤编译打包之后，为清晰区分前后端程序，我们可按如下图所示放置：

新建iotdb-web-workbench目录，在该目录新建backend目录存放后端程序workbench-1.0.0.jar，新建backend目录存放后端程序，applogs为log文件夹，tempFile存放的则是临时文件；front存放的前端web代码（即第三步前端编译生成的dist文件夹，重命名为front）

 1. 依赖

nginx stable

 2. 配置Nginx

修改Nginx配置文件，如下图所示，修改前端代码的路径，确定后端程序的端口。

 修改完毕后启动Nginx。

 3. 启动后端程序

# 后台启动后端

cd iotdb-web-workbench/backend

nohup java -jar workbench-1.0.0.jar > nohup.out 2>&1 &

 4. Web访问

访问地址：http://127.0.0.1:8080

默认账号：root

默认密码：123456