Commit edd6660b authored by Steph Zylstra's avatar Steph Zylstra
Browse files

Readme formatting improvements.

parent 5520ecc2

README.md

+52 −40
Original line number Diff line number Diff line
@@ -15,6 +15,7 @@ Suggested Development Environments 
  32 bit: [http://www.microsoft.com/en-us/download/details.aspx?id=5555](http://www.microsoft.com/en-us/download/details.aspx?id=5555)

  64 bit: [http://www.microsoft.com/en-us/download/details.aspx?id=14632](http://www.microsoft.com/en-us/download/details.aspx?id=14632 )





Project components

===================================

The kinetic-java project contains:
@@ -36,17 +37,19 @@ Client bootstrap class: 
Simulator bootstrap class:

[https://github.com/Kinetic/kinetic-java/blob/master/kinetic-simulator/src/main/java/kinetic/simulator/KineticSimulator.java](https://github.com/Kinetic/kinetic-java/blob/master/kinetic-simulator/src/main/java/kinetic/simulator/KineticSimulator.java)





Getting Started With Kinetic drives

===================================

* 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/Kinetic+Developer+Kit+Connection+Guide)

[https://developers.seagate.com/display/KV/Development+Chassis](https://developers.seagate.com/display/KV/Development+Chassis)

* [https://developers.seagate.com/display/KV/Kinetic+Developer+Kit+Connection+Guide](https://developers.seagate.com/display/KV/Kinetic+Developer+Kit+Connection+Guide)

* [https://developers.seagate.com/display/KV/Development+Chassis](https://developers.seagate.com/display/KV/Development+Chassis)





Getting Started With Development

================================

1. Clone the code: `git clone https://github.com/Kinetic/kinetic-java.git`

1. Build the runtime jar files as stated in Getting Started with Simulator below

1. Build the runtime jar files as stated in *Getting Started with Simulator* below

1. Run the integration tests against the Java Simulator: `mvn test -DargLine="-Xmx500M"`

1. Run the integration tests but exclude specific files: `mvn test -Dmaven.test.excludes="**/File.java,**/OtherFile.java"`

1. Run the integration tests against the remote instance at a particular path: `mvn test -DRUN_AGAINST_EXTERNAL=true -DKINETIC_PATH=/path/to/kinetic_home`
@@ -56,11 +59,12 @@ Getting Started With Development 
Getting Started With Simulator

================================

1. Run `mvn clean package` in "Kinetic-Folder"

2. Start with java CLI:     

       `java -jar` in "Kinetic-Folder"/kinetic-simulator/target/kinetic-simulator-"Version"-SNAPSHOT-jar-with-dependencies.jar

            where "Version" above is the build version number.  Such as 0.8.0.1 .

2. **Start with java CLI**:    

       From within "Kinetic-Folder": `java -jar kinetic-simulator/target/kinetic-simulator-"Version"-SNAPSHOT-jar-with-dependencies.jar`    

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



   or Start with script (If configuring tcp_port, tls_port and Kinetic_home, use `script -help`):

   or    

**Start with script** (If configuring tcp_port, tls_port and Kinetic_home, use `script -help`):



  Windows:

```
@@ -76,13 +80,13 @@ Getting Started With Simulator 


Admin command line Usage

==============================

1, make sure "Kinetic-Folder"/kinetic-simulator/target/kinetic-simulator-'Version"-SNAPSHOT-jar-with-dependencies.jar 

             "Kinetic-Folder"/kinetic-client/target/kinetic-client-"Version"-SNAPSHOT-jar-with-dependencies.jar

   exist

1. Make sure the following jars exist:

    * "Kinetic-Folder"/kinetic-simulator/target/kinetic-simulator-'Version"-SNAPSHOT-jar-with-dependencies.jar

    * "Kinetic-Folder"/kinetic-client/target/kinetic-client-"Version"-SNAPSHOT-jar-with-dependencies.jar



2, start simulator as described in the above section.

1. Start simulator as described in the above section.



3, run admin cli

1. Run admin CLI



   Windows:

```
@@ -102,7 +106,8 @@ Erasing all data in the Simulator 
* 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`)



1. ./bin/kineticadmin.sh -setup -erase true

1. `./bin/kineticadmin.sh -setup -erase true`





Simulator and Java API usage examples

=================================
@@ -119,9 +124,16 @@ To generate Javadoc: 


1. Run `mvn clean package` in "Kinetic-Folder".



1. Or run `mvn clean package` in "Kinetic-Folder"/kinetic-client, "Kinetic-Folder"/kinetic-simulator and "Kinetic-Folder"/kinetic-test.

1. Or run `mvn clean package` in:

    * "Kinetic-Folder"/kinetic-client, 

    * "Kinetic-Folder"/kinetic-simulator     

    * and "Kinetic-Folder"/kinetic-test



2. 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.



2. 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.



Latest Kinetic release, protocol dependency, and runtime dependencies on maven central

=================================
@@ -131,10 +143,10 @@ Run smoke test against simulator or kinetic drive 
==================================

Make sure one instance of simulator or kinetic drive is running.



1.  Run `mvn clean package` in "Kinetic-Folder" or "Kinetic-Folder"/kinetic-test, verify that

   "Kinetic-Folder"/kinetic-test/target/kinetic-test-0.8.0.1-SNAPSHOT-jar-with-dependencies.jar 

   "Kinetic-Folder"/kinetic-test/target/smoke-tests.jar

   exist.

1.  Run `mvn clean package` in "Kinetic-Folder" or "Kinetic-Folder"/kinetic-test   

    Verify that these jars exist:

   * "Kinetic-Folder"/kinetic-test/target/kinetic-test-0.8.0.1-SNAPSHOT-jar-with-dependencies.jar

   * "Kinetic-Folder"/kinetic-test/target/smoke-tests.jar



2. `cd "Kinetic-Folder"/bin`