-
Latest version of Git for your OS: http://git-scm.com/downloads
-
JDK 1.7 or above: http://www.oracle.com/technetwork/java/javase/downloads/index.html
-
Eclipse IDE For Java Developers. Version 4.2 (Juno) or later: http://www.eclipse.org/downloads/
-
Maven 3.0.3 or later: http://maven.apache.org/download.cgi
-
Protocol buffer 2.5 [https://code.google.com/p/protobuf/downloads/list] (https://code.google.com/p/protobuf/downloads/list)
-
For Windows 7 system, install the system patch package for jni: 32 bit: http://www.microsoft.com/en-us/download/details.aspx?id=5555 64 bit: http://www.microsoft.com/en-us/download/details.aspx?id=14632
The kinetic-java project contains:
-
kinetic-client (kinetic java client API and implementation)
-
kinetic-simulator (kinetic simulator API and implementation)
-
kinetic-common (common library for kinetic-client and kinetic-simulator)
-
kinetic-test (test suite for the kinetic-java and kinetic drive implementation)
kinetic-java provides the Java API and Simulator for the Kinetic Open Storage Platform: [https://developers.seagate.com/display/KV/Kinetic+Open+Storage+Documentation+Wiki] (https://developers.seagate.com/display/KV/Kinetic+Open+Storage+Documentation+Wiki)
Client bootstrap class: [https://github.com/Seagate/kinetic-java/blob/master/kinetic-client/src/main/java/kinetic/client/KineticClientFactory.java] (https://github.com/Seagate/kinetic-java/blob/master/kinetic-client/src/main/java/kinetic/client/KineticClientFactory.java)
Simulator bootstrap class: https://github.com/Seagate/kinetic-java/blob/master/kinetic-simulator/src/main/java/kinetic/simulator/KineticSimulator.java
- The 4-bay developer kit: [http://youtu.be/2UOepUmAJ3o] (http://youtu.be/2UOepUmAJ3o) https://developers.seagate.com/display/KV/Kinetic+Developer+Kit+Connection+Guide https://developers.seagate.com/display/KV/Development+Chassis
- Clone the code:
git clone https://github.com/Seagate/kinetic-java.git
- Run the integration tests against the Java Simulator:
mvn test -DargLine="-Xmx500M"
- Run the integration tests but exclude specific files: `mvn test -Dmaven.test.excludes="/File.java,/OtherFile.java"
- Run the integration tests against the remote instance at a particular path:
mvn test -DRUN_AGAINST_EXTERNAL=true -DKINETIC_PATH=/path/to/kinetic_home
- Run the integration tests against the remote instance at a particular host:
mvn test -DRUN_AGAINST_EXTERNAL=true -DKINETIC_HOST=1.2.3.4
- Run the integration tests against the remote instance at a particular host using SSH to reset state before runs:
mvn test -DRUN_AGAINST_EXTERNAL=true -DKINETIC_HOST=1.2.3.4 -DFAST_CLEAN_UP=true
-
Run "mvn clean package" in "Kinetic-Folder"
-
Start with java CLI: java -jar in "Kinetic-Folder"/kinetic-simulator/target/kinetic-simulator-0.6.0.2-SNAPSHOT-jar-with-dependencies.jar
or Start with script (If configuration tcp_port, tls_port and Kinetic_home, use script -help): Windows: cd "Kinetic-Folder"\bin startSimulator.bat
Linux & Mac: cd "Kinetic-Folder"/bin sh startSimulator.sh
1, make sure "Kinetic-Folder"/kinetic-simulator/target/kinetic-simulator-0.6.0.2-SNAPSHOT-jar-with-dependencies.jar "Kinetic-Folder"/kinetic-client/target/kinetic-client-0.6.0.2-SNAPSHOT-jar-with-dependencies.jar exist
2, start simulator Windows: cd "Kinetic-Folder"/bin kineticsimulator.bat
Linux: cd "Kinetic-Folder"/bin ./kineticsimulator.sh
3, run admin cli Windows: cd "Kinetic-Folder"/bin kineticadmin -help
Linux: cd "Kinetic-Folder"/bin ./kineticadmin.sh -help
- The simulator should be running, default port for TCP is 8123, SSL/TLS port is 8443
- You'll need to have recently built .jar (i.e. run
mvn package
)
- ./bin/kineticadmin.sh -setup -erase true
Examples are located at the following directory.
"Kinetic-Folder"/kinetic-test/src/test/java/com/seagate/kinetic/example
To browse Javadoc: [http://seagate.github.io/kinetic-java/] (http://seagate.github.io/kinetic-java/)
To generate Javadoc:
-
Run "mvn clean package" in "Kinetic-Folder".
-
Or run "mvn clean package" in "Kinetic-Folder"/kinetic-client, "Kinetic-Folder"/kinetic-simulator and "Kinetic-Folder"/kinetic-test.
-
Javadoc will be generated for modules in directory of "Kinetic-Folder"/kinetic-client/doc, "Kinetic-Folder"/kinetic-simulator/doc and "Kinetic-Folder"/kinetic-test/doc.
-
kinetic-simulator: [http://mvnrepository.com/artifact/com.seagate.kinetic/kinetic-simulator/0.6.0.2] (http://mvnrepository.com/artifact/com.seagate.kinetic/kinetic-simulator/0.6.0.2)
-
kinetic-client: [http://mvnrepository.com/artifact/com.seagate.kinetic/kinetic-client/0.6.0.2] (http://mvnrepository.com/artifact/com.seagate.kinetic/kinetic-client/0.6.0.2)
Make sure one instance of simulator or kinetic drive is running.
-
Run "mvn clean package" in "Kinetic-Folder" or "Kinetic-Folder"/kinetic-test, verify that "Kinetic-Folder"/kinetic-test/target/kinetic-test-0.6.0.2-SNAPSHOT-jar-with-dependencies.jar "Kinetic-Folder"/kinetic-test/target/smoke-tests.jar exist.
-
cd "Kinetic-Folder"/bin
-
sh runSmokeTests.sh [-host host_ip] [-port port] [-tlsport tlsport] [-home kinetic_home] or python runSmokeTests.py [-host host_ip] [-port port] [-tlsport tlsport] [-home kinetic_home]