IoTDB下载安装

IoTDB下载安装

环境准备

IoTDB 的理念就是系统运维要简单，要一键启动、开箱即用。先从安装环境开始说起

1. 安装前需要保证设备上配有 JDK>=1.8 的运行环境，并配置好 JAVA_HOME 环境变量；

2. 如果希望能从源代码编译和安装IoTDB，需要maven版本 >= 3.6；

3. 将最大文件打开数(max open files)设置为 65535，以避免"too many open files"错误。

4. 将 somaxconn 设置为 65535，以避免系统在高负载时出现"connection reset" 错误(可选)。

下载与安装

IoTDB 提供了两种安装方式：

第一种，从官网下载安装包。这是推荐的安装方式，通过该方式，可以得到一个可以立即使用的、打包好的二进制可执行文件。

第二种，使用源码编译。如果想自行修改代码，可以使用这种安装方式。

历史版本下载：https://archive.apache.org/dist/iotdb/

从官网下载二进制可执行文件

可以从 http://iotdb.apache.org/Download/ (opens new window)上下载已经编译好的可执行程序 iotdb-xxx.zip，该压缩包包含了 IoTDB 系统运行所需的所有必要组件。

下载后，可使用如下命令对 IoTDB 的压缩包进行解压：

uzip iotdb-<version>.zip

使用源码编译

可以获取已发布的源码 https://iotdb.apache.org/Download/，或者从 https://github.com/apache/iotdb/tree/master 仓库获取

克隆项目

git clone https://github.com/apache/iotdb.git

源码克隆后，进入到源码文件夹目录下。

如果想编译已经发布过的版本，可以先用git checkout -b my_{project.version} v{project.version}命令新建并切换分支。比如当要编译0.12.4这个版本的源码，可以用如下命令去切换分支：

git checkout -b my_0.12.4 v0.12.4

server编译

切换分支之后就可以使用以下命令进行编译：

mvn clean package -pl server -am -Dmaven.test.skip=true # 跳过单测打包server

编译后，IoTDB 服务器会在 “server/target/iotdb-server-{project.version}” 文件夹下，包含以下内容：

+- conf/      	<-- configuration files  # 配置文件目录
|
+- lib/       	<-- project dependencies  # 系统工具目录
|
+- logs/      	<-- project logs  #项目日志目录
|
+- sbin/       	<-- script files  # 启动和停止脚本目录
|
+- tools/      	<-- system tools  # 依赖包目录

cli编译

mvn clean package -pl cli -am -Dmaven.test.skip=true # 跳过单测打包cli

编译后，IoTDB cli工具在"cli/target/iotdb-server-{project.version}"文件下，包含以下内容：

+- sbin/       	<-- script files  # 启动和停止脚本目录
|
+- lib/       	<-- project dependencies  # 系统工具目录
|
+- tools/      	<-- system tools  # 依赖包目录

如果想要编译项目中的某个模块，可以在源码文件夹中使用mvn clean package -pl {module.name} -am -DskipTests命令进行编译。如果需要的是带依赖的 jar 包，您可以在编译命令后面加上-P get-jar-with-dependencies参数。

比如想编译带依赖的 jdbc jar 包，可以使用以下命令进行编译：

mvn clean package -pl jdbc -am -DskipTests -P get-jar-with-dependencies # 编译打包带依赖的 jar 包

编译完成后就可以在{module.name}/target目录中找到需要的包了。

通过 Docker 安装 (Dockerfile)

dockerfile 文件位于 https://github.com/apache/iotdb/blob/master/docker/src/main

Docker简介

Docker 是一种运行于 Linux 和 Windows 上的软件，用于创建、管理和编排容器。

“Docker”一词来自英国口语，意为码头工人（Dock Worker），即从船上装卸货物的人。