下載與安裝
IoTDB 為您提供了兩種安裝方式,您可以參考下面的建議,任選其中一種:
第一種,從官網下載安裝包。這是我們推薦使用的安裝方式,通過該方式,您將得到一個可以立即使用的、打包好的二進制可執行文件。
第二種,使用源碼編譯。若您需要自行修改代碼,可以使用該安裝方式。
安裝環境要求
安裝前請保證您的電腦上配有 JDK>=1.8 的運行環境,并配置好 JAVA_HOME 環境變量。
如果您需要從源碼進行編譯,還需要安裝:
- Maven >= 3.6 的運行環境,具體安裝方法可以參考以下鏈接:https://maven.apache.org/install.html。
注: 也可以選擇不安裝,使用我們提供的'mvnw.sh' 或 'mvnw.cmd' 工具。使用時請用'mvnw.sh' 或 'mvnw.cmd'命令代替下文的'mvn'命令。
從官網下載二進制可執行文件
您可以從 http://iotdb.apache.org/Download/ 上下載已經編譯好的可執行程序 iotdb-xxx.zip,該壓縮包包含了 IoTDB 系統運行所需的所有必要組件。
下載后,您可使用以下操作對 IoTDB 的壓縮包進行解壓:
Shell > uzip 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目錄中找到需要的包了。
通過 Docker 安裝 (Dockerfile)
Apache IoTDB 的 Docker 鏡像已經上傳至 https://hub.docker.com/r/apache/iotdb,
獲取 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:
$ git clone https://github.com/apache/iotdb $ cd iotdb $ mvn package -DskipTests $ cd docker $ docker build -t iotdb:base .
當 docker image 在本地構建完成的時候 (示例中的 tag 為 iotdb:base),已經距完成只有一步之遙了!
創建數據文件和日志的 docker 掛載目錄 (docker volume):
$ docker volume create mydata
$ docker volume create mylogs- 運行 docker 容器:
$ docker run -p 6667:6667 -v mydata:/iotdb/data -v mylogs:/iotdb/logs -d iotdb:base /iotdb/bin/start-server.sh您可以使用docker ps來檢查是否運行成功,當成功時控制臺會輸出下面的日志:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
2a68b6944cb5 iotdb:base "/iotdb/bin/start-se…" 4 minutes ago Up 5 minutes 0.0.0.0:6667->6667/tcp laughing_meitner您可以使用下面的命令來獲取 container 的 ID:
$ docker container ls假設這個 ID 為 <C_ID>.
然后使用下面的命令獲取這個 ID 對應的 IP 地址,假設獲取的 IP 為 <C_IP>:
$ docker inspect --format='{{.NetworkSettings.IPAddress}}' <C_ID>現在 IoTDB 服務器已經啟動成功了。
- 如果您想嘗試使用 iotdb-cli 命令行,您可以使用如下命令:
$ docker exec -it <C_ID> /bin/bash
$ (now you have enter the container): /iotdb/sbin/start-cli.sh -h localhost -p 6667 -u root -pw root還可以使用本地的 iotdb-cli,執行如下命令:
$ /%IOTDB_HOME%/sbin/start-cli.sh -h localhost -p 6667 -u root -pw root- 如果您想寫一些代碼來插入或者查詢數據,您可以在 pom.xml 文件中加入下面的依賴:
<dependency>
<groupId>org.apache.iotdb</groupId>
<artifactId>iotdb-jdbc</artifactId>
<version>0.13.4</version>
</dependency>這里是一些使用 IoTDB-JDBC 連接 IoTDB 的示例:https://github.com/apache/iotdb/tree/master/example/jdbc/src/main/java/org/apache/iotdb