第一种,从官网下载安装包。这是我们推荐使用的安装方式,通过该方式,您将得到一个可以立即使用的、打包好的二进制可执行文件。
第二种,使用源码编译。若您需要自行修改代码,可以使用该安装方式。
安装前请保证您的电脑上配有JDK>=1.8的运行环境,并配置好JAVA_HOME环境变量。
如果您需要从源码进行编译,还需要安装:
- Maven >= 3.6 的运行环境,具体安装方法可以参考以下链接:。
您可以从http://iotdb.apache.org/Download/ (opens new window) 上下载已经编译好的可执行程序iotdb-xxx.zip,该压缩包包含了IoTDB系统运行所需的所有必要组件。
您可以获取已发布的源码 ,或者从https://github.com/apache/iotdb/tree/master (opens new window) git仓库获取
源码克隆后,进入到源码文件夹目录下,使用以下命令进行编译:
编译后,IoTDB 服务器会在 “server/target/iotdb-server-{project.version}” 文件夹下,包含以下内容:
+- sbin/ <-- script files
|
+- conf/ <-- configuration files
|
|
+- tools/ <-- system tools
Apache IoTDB的Docker镜像已经上传至 , 使用即可获取最新的docker镜像。
用户也可以根据代码提供的Dockerfile文件来自己生成镜像。 Dockerfile 存放在的 docker 工程下的 src/main/Dockerfile 中.
- 您可以使用下面的命令构建 docker image:
$ docker build -t iotdb:base git://github.com/apache/iotdb#master:docker
或者:
- 创建数据文件和日志的 docker 挂载目录(docker volume):
$ docker volume create mydata
$ docker volume create mylogs
- 运行 docker container:
$ 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
您可以使用下面的命令来获取 container 的 ID:
假设这个 ID 为 <C_ID>.
然后使用下面的命令获取这个 ID 对应的 IP 地址:
假设获取的 IP 为 <C_IP>.
- 如果您想尝试使用 iotdb-cli 命令行, 您可以使用如下命令:
$ docker exec -it /bin/bash <C_ID>
$ (now you have enter the container): /cli/sbin/start-cli.sh -h localhost -p 6667 -u root -pw root
或者运行一个新的 client docker container,命令如下:
$ docker run -it iotdb:base /cli/sbin/start-cli.sh -h <C_IP> -p 6667 -u root -pw root
- 如果您想写一些代码来插入或者查询数据,您可以在 pom.xml 文件中加入下面的依赖:
<dependency>
<groupId>org.apache.iotdb</groupId>
<artifactId>iotdb-jdbc</artifactId>
这里是一些使用 IoTDB-JDBC 连接 IoTDB 的示例: https://github.com/apache/iotdb/tree/master/example/jdbc/src/main/java/org/apache/iotdb
- 现在已经大功告成了