安装包获取

IoTDB 为您提供了两种安装方式,您可以参考下面的建议,任选其中一种:

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

第二种,使用源码编译。若您需要自行修改代码,可以使用该安装方式。

安装环境要求

安装前请保证您的电脑上配有 JDK>=1.8 的运行环境,并配置好 JAVA_HOME 环境变量。

如果您需要从源码进行编译,还需要安装:

  1. Maven >= 3.6 的运行环境,具体安装方法可以参考以下链接:https://maven.apache.org/install.html

注: 也可以选择不安装,使用我们提供的‘mvnw’ 或 ‘mvnw.cmd’ 工具。使用时请用‘mvnw’ 或 ‘mvnw.cmd’命令代替下文的‘mvn’命令。

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

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

下载后,您可使用以下操作对 IoTDB 的压缩包进行解压:

Shell > unzip iotdb-<version>.zip

使用源码编译

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

源码克隆后,进入到源码文件夹目录下。如果您想编译已经发布过的版本,可以先用git checkout -b my_{project.version} v{project.version}命令新建并切换分支。比如您要编译0.12.4这个版本,您可以用如下命令去切换分支:

> git checkout -b my_0.12.4 v0.12.4

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

> mvn clean package -pl server -am -Dmaven.test.skip=true

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

+- sbin/       <-- script files
|
+- conf/      <-- configuration 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

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