Compiling and Running Applications

Scenario

IoTDB applications can run in a Linux environment where an IoTDB client is installed. After the application code is developed, you can upload the JAR file to the prepared Linux environment. A Session application is used as an example. Operations for JDBC applications are the same as those for Session applications.

Prerequisites

• You have installed the IoTDB client.
• If the host where the client is installed is not a node in the cluster, the mapping between the host name and the IP address must be set in the hosts file on the node where the client is located. The host names and IP addresses must be mapped one by one.

Procedure

1. Export a JAR file.

   You can build a JAR file in either of the following ways:

   • Method 1:

     Choose Maven > Sample project name > Lifecycle > clean and double-click clean to run the clean command of Maven.

     Choose Maven > Sample project name > Lifecycle > install and double-click install to run the install command of Maven.

     Figure 1 Maven tools clean and install
     
   • Method 2: Go to the directory where the pom.xml file is located in the Terminal window in the lower part of the IDEA, and run the mvn clean install command to compile the file.
     Figure 2 Entering mvn clean install in the IDEA Terminal text box
     

     After the compilation is completed, the message "BUILD SUCCESS" is displayed, the target directory is generated, and the generated JAR file is stored in the target directory.

2. Prepare the dependent JAR file.
   1. Log in to the IoTDB client and import the JAR file generated in 1 to the lib directory of the IoTDB client, for example, /opt/client/IoTDB/iotdb/lib.
   2. In the root directory of the IoTDB client, for example, /opt/client/IoTDB/iotdb, create the run.sh script, modify the content as follows, and save the modification.

      #!/bin/sh
      BASEDIR=`cd $(dirname $0);pwd`
      cd ${BASEDIR}
      for file in ${BASEDIR}/lib/*.jar
      do
      i_cp=$i_cp:$file
      echo "$file"
      done
      for file in ${BASEDIR}/conf/*
      do
      i_cp=$i_cp:$file
      done
      
      java -cp .${i_cp} com.huawei.bigdata.iotdb.JDBCExample

      com.huawei.bigdata.iotdb.JDBCExample is an example. Use the actual code instead.

   3. Run the run.sh script to run the JAR file.

      sh /opt/client/IoTDB/iotdb/run.sh