IoTDB 为您提供了两种安装方式,您可以参考下面的建议,任选其中一种:
第一种,从官网下载安装包。这是我们推荐使用的安装方式,通过该方式,您将得到一个可以立即使用的、打包好的二进制可执行文件。
第二种,使用源码编译。若您需要自行修改代码,可以使用该安装方式。
安装前请保证您的电脑上配有 JDK>=1.8 的运行环境,并配置好 JAVA_HOME 环境变量。
如果您需要从源码进行编译,还需要安装:
注: 也可以选择不安装,使用我们提供的‘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目录中找到需要的包了。