|
| 1 | +# Quickstart Running Oracle NoSQL Database on Docker |
| 2 | + |
| 3 | +Start up KVLite in a Docker container. You must give it a name. Startup of KVLite is the default CMD of the Docker image: |
| 4 | + |
| 5 | + $ docker run -d --name=kvlite oracle/nosql |
| 6 | + |
| 7 | +In a second shell, run a second Docker container to ping the kvlite store instance: |
| 8 | + |
| 9 | + $ docker run --rm -ti --link kvlite:store oracle/nosql \ |
| 10 | + java -jar lib/kvstore.jar ping -host store -port 5000 |
| 11 | + |
| 12 | +Note the required use of `--link` for proper hostname check (actual KVLite container is named '`kvlite`'; alias is '`store`'). |
| 13 | + |
| 14 | +You can also use the Oracle NoSQL Command Line Interface (CLI). Start the following container (keep container 'kvlite' running): |
| 15 | + |
| 16 | + $ docker run --rm -ti --link kvlite:store oracle/nosql \ |
| 17 | + java -jar lib/kvstore.jar runadmin -host store -port 5000 -store kvstore |
| 18 | + |
| 19 | + kv-> ping |
| 20 | + Pinging components of store kvstore based upon topology sequence #14 |
| 21 | + 10 partitions and 1 storage nodes |
| 22 | + Time: 2017-02-28 15:37:41 UTC Version: 12.1.4.3.11 |
| 23 | + Shard Status: healthy:1 writable-degraded:0 read-only:0 offline:0 |
| 24 | + Admin Status: healthy |
| 25 | + Zone [name=KVLite id=zn1 type=PRIMARY allowArbiters=false] RN Status: online:1 offline:0 |
| 26 | + Storage Node [sn1] on 659dbf4fba07:5000 |
| 27 | + Zone: [name=KVLite id=zn1 type=PRIMARY allowArbiters=false] |
| 28 | + Status: RUNNING Ver: 12cR1.4.3.11 2017-02-17 06:52:09 UTC Build id: 0e3ebe7568a0 |
| 29 | + Admin [admin1] Status: RUNNING,MASTER |
| 30 | + Rep Node [rg1-rn1] Status: RUNNING,MASTER sequenceNumber:49 haPort:5006 |
| 31 | + |
| 32 | + kv-> put kv -key /SomeKey -value SomeValue |
| 33 | + Operation successful, record inserted. |
| 34 | + kv-> get kv -key /SomeKey |
| 35 | + SomeValue |
| 36 | + kv-> |
| 37 | + |
| 38 | +You have now Oracle NoSQL on a Docker container. |
| 39 | + |
| 40 | +# More information |
| 41 | +For more information on Oracle NoSQL, visit the [homepage](http://www.oracle.com/technetwork/database/database-technologies/nosqldb/overview/index.html) and the [documentation](http://docs.oracle.com/cd/NOSQL/html/index.html) for specific NoSQL instructions. |
| 42 | + |
| 43 | +The Oracle NoSQL Database Community Edition also contains OpenJDK. |
| 44 | +The Oracle NoSQL Database Enterprise Edition also contains Oracle Java Server JRE. |
| 45 | + |
| 46 | +# Licenses |
| 47 | +Oracle NoSQL Community Edition is licensed under the [APACHE LICENSE v2.0](https://docs.oracle.com/cd/NOSQL/html/driver_table_c/doc/LICENSE.txt). |
| 48 | + |
| 49 | +OpenJDK is licensed under the [GNU General Public License v2.0 with the Classpath Exception](http://openjdk.java.net/legal/gplv2+ce.html) |
| 50 | + |
| 51 | +The files in this repository folder are licensed under the [Universal Permissive License 1.0](http://oss.oracle.com/licenses/upl) |
| 52 | + |
| 53 | +# Commercial Support on Docker Containers |
| 54 | +Oracle NoSQL Community Edition has **no** commercial support. |
| 55 | + |
| 56 | +# Copyright |
| 57 | +Copyright (c) 2017 Oracle and/or its affiliates. All rights reserved. |
0 commit comments