Build and use IoTDB by Dockerfile

Now a Dockerfile has been written at ROOT/docker/Dockerfile on the branch enable_docker_image.

1. You can build a docker image by:

$ docker build -t iotdb:base git://github.com/apache/incubator-iotdb#master:docker

Or:

$ git clone https://github.com/apache/incubator-iotdb
$ cd incubator-iotdb
$ cd docker
$ docker build -t iotdb:base .

Once the docker image has been built locally (the tag is iotdb:base in this example), you are almost done!

1. create docker volume for data files and logs:

$ docker volume create mydata
$ docker volume create mylogs

1. run a docker container:

$ docker run -p 6667:6667 -v mydata:/iotdb/data -v mylogs:/iotdb/logs -d iotdb:base /iotdb/bin/start-server.sh

If success, you can run docker ps, and get something like the following:

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

You can use the above command to get the container ID:

$ docker container ls

suppose the ID is .

And get the docker IP by:

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

suppose the IP is .

1. If you just want to have a try by using iotdb-cli, you can:

$ docker exec -it /bin/bash  <C_ID>
$ (now you have enter the container): /cli/sbin/start-client.sh -h localhost -p 6667 -u root -pw root

Or, run a new docker container as the client:

$ docker run -it iotdb:base /cli/sbin/start-client.sh -h <C_IP> -p 6667 -u root -pw root

Or, if you have a iotdb-cli locally (e.g., you have compiled the source code by mvn package), and suppose your work_dir is cli/bin, then you can just run:

$ start-client.sh -h localhost -p 6667 -u root -pw root

1. If you want to write codes to insert data and query data, please add the following dependence:

        <dependency>
            <groupId>org.apache.iotdb</groupId>
            <artifactId>iotdb-jdbc</artifactId>
            <version>0.8.2</version>
        </dependency>

Some example about how to use IoTDB with IoTDB-JDBC can be found at: https://github.com/apache/incubator-iotdb/tree/master/jdbc/src/test/java/org/apache/iotdb/jdbc/demo

1. Now enjoy it!