下载与安装

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

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

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

安装环境要求

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

如果您需要从源码进行编译，还需要安装：

  1. Maven >= 3.6 的运行环境，具体安装方法可以参考以下链接：https://maven.apache.org/install.html下载与安装 - 图1 (opens new window)。

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

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

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

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

  1. Shell > uzip iotdb-<version>.zip

使用源码编译

您可以获取已发布的源码 https://iotdb.apache.org/Download/下载与安装 - 图3 (opens new window) ，或者从 https://github.com/apache/iotdb/tree/master下载与安装 - 图4 (opens new window) git 仓库获取

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

  1. > git checkout -b my_0.12.4 v0.12.4

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

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

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

  1. +- sbin/       <-- script files
  2. |
  3. +- conf/      <-- configuration files
  4. |
  5. +- lib/       <-- project dependencies
  6. |
  7. +- tools/      <-- system tools

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

  1. > mvn clean package -pl jdbc -am -DskipTests -P get-jar-with-dependencies

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

通过 Docker 安装 (Dockerfile)

Apache IoTDB 的 Docker 镜像已经上传至 https://hub.docker.com/r/apache/iotdb下载与安装 - 图5 (opens new window)，

  1. 获取 IoTDB docker 镜像

    • 推荐：执行 docker pull apache/iotdb:latest 即可获取最新的 docker 镜像。

    • 用户也可以根据代码提供的 Dockerfile 文件来自己生成镜像。Dockerfile 存放在的 docker 工程下的 src/main/Dockerfile 中。

      • 方法 1：$ docker build -t iotdb:base git://github.com/apache/iotdb#master:docker

      • 方法 2：

        1. $ git clone https://github.com/apache/iotdb
        2. $ cd iotdb
        3. $ mvn package -DskipTests
        4. $ cd docker
        5. $ docker build -t iotdb:base .

    当 docker image 在本地构建完成的时候 （示例中的 tag 为 iotdb:base)，已经距完成只有一步之遥了！

  2. 创建数据文件和日志的 docker 挂载目录 (docker volume):

  1. $ docker volume create mydata
  2. $ docker volume create mylogs
  1. 运行 docker 容器：
  1. $ docker run -p 6667:6667 -v mydata:/iotdb/data -v mylogs:/iotdb/logs -d iotdb:base /iotdb/bin/start-server.sh

您可以使用docker ps来检查是否运行成功，当成功时控制台会输出下面的日志：

  1. CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                               NAMES
  2. 2a68b6944cb5        iotdb:base          "/iotdb/bin/start-se…"   4 minutes ago       Up 5 minutes        0.0.0.0:6667->6667/tcp              laughing_meitner

您可以使用下面的命令来获取 container 的 ID:

  1. $ docker container ls

假设这个 ID 为 <C_ID>.

然后使用下面的命令获取这个 ID 对应的 IP 地址，假设获取的 IP 为 <C_IP>:

  1. $ docker inspect --format='{{.NetworkSettings.IPAddress}}' <C_ID>

现在 IoTDB 服务器已经启动成功了。

  1. 如果您想尝试使用 iotdb-cli 命令行，您可以使用如下命令：
  1. $ docker exec -it <C_ID> /bin/bash
  2. $ (now you have enter the container): /iotdb/sbin/start-cli.sh -h localhost -p 6667 -u root -pw root

还可以使用本地的 iotdb-cli，执行如下命令：

  1. $ /%IOTDB_HOME%/sbin/start-cli.sh -h localhost -p 6667 -u root -pw root
  1. 如果您想写一些代码来插入或者查询数据，您可以在 pom.xml 文件中加入下面的依赖：
  1.         <dependency>
  2.             <groupId>org.apache.iotdb</groupId>
  3.             <artifactId>iotdb-jdbc</artifactId>
  4.             <version>0.13.0-SNAPSHOT</version>
  5.         </dependency>

这里是一些使用 IoTDB-JDBC 连接 IoTDB 的示例：https://github.com/apache/iotdb/tree/master/example/jdbc/src/main/java/org/apache/iotdb