ceph/src/rocksdb/java/RELEASE.md

   1 ## Cross-building
   2
   3 RocksDB can be built as a single self contained cross-platform JAR. The cross-platform jar can be usd on any 64-bit OSX system, 32-bit Linux system, or 64-bit Linux system.
   4
   5 Building a cross-platform JAR requires:
   6
   7  * [Vagrant](https://www.vagrantup.com/)
   8  * [Virtualbox](https://www.virtualbox.org/)
   9  * A Mac OSX machine that can compile RocksDB.
  10  * Java 7 set as JAVA_HOME.
  11
  12 Once you have these items, run this make command from RocksDB's root source directory:
  13
  14     make jclean clean rocksdbjavastaticrelease
  15
  16 This command will build RocksDB natively on OSX, and will then spin up two Vagrant Virtualbox Ubuntu images to build RocksDB for both 32-bit and 64-bit Linux.
  17
  18 You can find all native binaries and JARs in the java/target directory upon completion:
  19
  20     librocksdbjni-linux32.so
  21     librocksdbjni-linux64.so
  22     librocksdbjni-osx.jnilib
  23     rocksdbjni-3.5.0-javadoc.jar
  24     rocksdbjni-3.5.0-linux32.jar
  25     rocksdbjni-3.5.0-linux64.jar
  26     rocksdbjni-3.5.0-osx.jar
  27     rocksdbjni-3.5.0-sources.jar
  28     rocksdbjni-3.5.0.jar
  29
  30 ## Maven publication
  31
  32 Set ~/.m2/settings.xml to contain:
  33
  34     <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
  35       <servers>
  36         <server>
  37           <id>sonatype-nexus-staging</id>
  38           <username>your-sonatype-jira-username</username>
  39           <password>your-sonatype-jira-password</password>
  40         </server>
  41       </servers>
  42     </settings>
  43
  44 From RocksDB's root directory, first build the Java static JARs:
  45
  46     make jclean clean rocksdbjavastaticpublish
  47
  48 This command will [stage the JAR artifacts on the Sonatype staging repository](http://central.sonatype.org/pages/manual-staging-bundle-creation-and-deployment.html). To release the staged artifacts.
  49
  50 1. Go to [https://oss.sonatype.org/#stagingRepositories](https://oss.sonatype.org/#stagingRepositories) and search for "rocksdb" in the upper right hand search box.
  51 2. Select the rocksdb staging repository, and inspect its contents.
  52 3. If all is well, follow [these steps](https://oss.sonatype.org/#stagingRepositories) to close the repository and release it.
  53
  54 After the release has occurred, the artifacts will be synced to Maven central within 24-48 hours.