Kinetic/Test

Kinetic open source storage platform

License	License Mozilla Public License
Categories	Categories Net
GroupId	GroupId com.seagate.kinetic
ArtifactId	ArtifactId kinetic-test
Last Version	Last Version 0.8.0.5
Release Date	Release Date Nov 2, 2015
Type	Type jar
Description	Description Kinetic/Test Kinetic open source storage platform

Download kinetic-test

Filename	Size
kinetic-test-0.8.0.5.pom
kinetic-test-0.8.0.5.jar	2 KB
kinetic-test-0.8.0.5-tests.jar	331 KB
kinetic-test-0.8.0.5-javadoc.jar	174 KB
Browse

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.seagate.kinetic/kinetic-test/ -->
<dependency>
    <groupId>com.seagate.kinetic</groupId>
    <artifactId>kinetic-test</artifactId>
    <version>0.8.0.5</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.seagate.kinetic/kinetic-test/
implementation 'com.seagate.kinetic:kinetic-test:0.8.0.5'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.seagate.kinetic/kinetic-test/
implementation ("com.seagate.kinetic:kinetic-test:0.8.0.5")

Apache Buildr

'com.seagate.kinetic:kinetic-test:jar:0.8.0.5'

Apache Ivy

<dependency org="com.seagate.kinetic" name="kinetic-test" rev="0.8.0.5">
  <artifact name="kinetic-test" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.seagate.kinetic', module='kinetic-test', version='0.8.0.5')
)

Scala SBT

libraryDependencies += "com.seagate.kinetic" % "kinetic-test" % "0.8.0.5"

Leiningen

[com.seagate.kinetic/kinetic-test "0.8.0.5"]

Dependencies

compile (8)

Group / Artifact	Type	Version
org.testng : testng	jar	6.8.8
com.leacox.process : process-warden	jar	1.1.0
org.slf4j : slf4j-jdk14	jar	1.7.5
com.jcraft : jsch	jar	0.1.50
commons-io : commons-io	jar	2.4
com.seagate.kinetic : kinetic-common	jar	0.8.0.5
com.seagate.kinetic : kinetic-client	jar	0.8.0.5
com.seagate.kinetic : kinetic-simulator	jar	0.8.0.5

Project Modules

There are no modules declared in this project.

Java API and Simulator for the Kinetic Open Storage Platform.

Kinetic Protocol Definition: [https://github.com/Kinetic/kinetic-protocol] (https://github.com/Kinetic/kinetic-protocol)

Overview

Project components:

kinetic-client (Java client API and implementation of Kinetic Protocol)
kinetic-simulator (Kinetic device simulator)
kinetic-common (Common library for kinetic-client and kinetic-simulator)
kinetic-test (Test Suite for simulator and kinetic devices)

Suggested development environment

Latest version of Git: http://git-scm.com/downloads
JDK 1.7 or above: http://www.oracle.com/technetwork/java/javase/downloads/index.html
Maven 3.0.3 or later: http://maven.apache.org/download.cgi

Quick start

Download and build

  cd ~/workspace
  git clone https://github.com/Kinetic/kinetic-java.git
  mvn clean package
  
  # By default, simulator uses "USER-HOME/kinetic" as its data store folder.
  # To build, the "workspace" must be located in a separate folder as the data store folder.

Start the simulator

Start with simulator jar:

  cd ~/workspace
  java -jar kinetic-simulator/target/kinetic-simulator-"Version"-SNAPSHOT-jar-with-dependencies.jar

where "Version" above is the build version number (such as 3.0.7).

Start with script (If configuring tcp_port, tls_port and Kinetic_home, type script -help for usage help):

  cd ~/workspace
  ./bin/startSimulator.sh

Ping the simulator

cd ~/workspace

# ping <device-ip>, 
# e.g.:
./bin/ping.sh 127.0.0.1

Run test suite against a remote instance

Run the integration tests against the simulator with specified max memory: mvn test -DargLine="-Xmx500M"
Run the integration tests against the remote instance at a particular host: mvn test -DRUN_AGAINST_EXTERNAL=true -DKINETIC_HOST=1.2.3.4

Admin client command usage

Download, build, and start simulator as described in Quick Start section above
Run admin CLI

   cd ~/workspace
   ./bin/kineticadmin.sh -help

Erase data in the Simulator

The simulator should be running, default port for TCP is 8123, SSL/TLS port is 8443

  ./bin/kineticadmin.sh -instanterase

Simulator and Java API examples

Examples are located at the following directory.

"workspace"/kinetic-test/src/test/java/com/seagate/kinetic/example

Kinetic Java API Javadoc location

To browse Javadoc: http://kinetic.github.io/kinetic-java/

kinetic-java runtime on maven central

kinetic-releases: https://github.com/Kinetic/kinetic-java/releases

Run smoke tests against a remote instance

Download, build, and start simulator as described in Quick Start section above
cd "workspace"/bin
sh runSmokeTests.sh [-host host_ip] [-port port] [-tlsport tlsport] [-home kinetic_home]

Kinetic tools and console

The kinetic tools and console provide tools to discover, setup, configure, and monitor Kinetic devices.

[https://github.com/Seagate/kinetic-java-tools] (https://github.com/Seagate/kinetic-java-tools)

Kinetic Open Storage Project

Versions

Version
0.8.0.5 Nov 2, 2015
0.8.0.4 Jun 30, 2015
0.8.0.3 Mar 12, 2015
0.8.0.2 Oct 22, 2014
0.8.0.1 Sep 20, 2014
0.7.0.2 Sep 22, 2014