diff --git a/documentation/releasenotes/1.6.1.md b/documentation/releasenotes/1.6.1.md new file mode 100644 index 0000000..b15b723 --- /dev/null +++ b/documentation/releasenotes/1.6.1.md @@ -0,0 +1,60 @@ +--- +layout: jclouds +title: Release Notes for jclouds Version 1.6.1 +--- + +Release Notes for jclouds Version 1.6.1 +========================= + +Release Date: June 19, 2013 + +## Introduction + +jclouds Version 1.6.1 is geared around the transition into the Apache Incubator. It represents the first release of jclouds in the Apache Incubator. The most significant change is to the jclouds Maven groupId. You can read more about it in the Changes section below. + +You can read the official announcement at [Apache jclouds 1.6.1-incubating released](http://www.mail-archive.com/user@jclouds.incubator.apache.org/msg00112.html). You can read the details of the specific JIRA issues addressed in this release at the [JIRA Release Notes](https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12314430&version=12324412). + +To get jclouds, please see the [jclouds installation guide](/documentation/userguide/installation-guide). + + +## Additions + + * Added the karaf/CLI command blobstore-blob-exists. + +## Removals + + * Removed sandbox-apis and sandbox-providers. + +## Changes + + * The jclouds Maven groupId has changed from org.jclouds to org.apache.jclouds so a pom.xml dependency would now look like: + +{% highlight xml %} + + + org.apache.jclouds + jclouds-all + 1.6.1-incubating + + +{% endhighlight %} + + * Note that the package names in the source code have *not* changed. + * jclouds-karaf has undergone a similar modification and you'll need to change the `featureRepositories` line in `etc/org.apache.karaf.features.cfg` to `featuresRepositories=mvn:org.apache.jclouds.karaf/jclouds-karaf/${jclouds.karaf.version}/xml/features` in the command line interface. + * Updated license headers and project metadata to align with Apache Incubator. + +## Fixes + + * Allow repeatable Payload with InputSupplier input (allows retries to work) + * Map S3 TooManyBuckets to InsufficientResourcesException + * Fixed the jclouds-cli start script so that it now runs smoothly on Windows. + +## Deprecated and Non-backwards Compatible Changes +* All "Async" interfaces are deprecated and will be removed in the next major version of jclouds. Please only use the normal apis, such as `NovaApi`. + * Accordingly, please discontinue use of `RestContext`. This is replaced with `ApiContext`, which doesn't have an async type. Note that you can use `ContextBuilder.buildApi(YourApi.class)` instead of using contexts, as api interfaces are now closeable. +* Please discontinue use of `Context.utils()` as many features there were only present to support the Async interfaces of jclouds. Code in jclouds will be easier to maintain when we needn't support utilities that are also present in tools such as Guava and Bouncycastle. + +## Credits + +jclouds would like to thank everyone who contributed time and effort in order to make the release of jclouds Version 1.6.1 happen. A special thanks to our Apache mentors for guiding us through our first release. Check out who has been busy [here](http://www.ohloh.net/p/jclouds/contributors?query=&sort=latest_commit). + diff --git a/documentation/releasenotes/index.md b/documentation/releasenotes/index.md index 50a8237..fb17e98 100644 --- a/documentation/releasenotes/index.md +++ b/documentation/releasenotes/index.md @@ -7,6 +7,7 @@ title: Release Notes Index The Release Notes and Javadocs for every major release of jclouds are listed chronologically below. +* [1.6.1](/documentation/releasenotes/1.6.1) | [Javadoc](http://demobox.github.com/jclouds-maven-site-1.6.0/1.6.0/jclouds-multi/apidocs/) * [1.6.0](/documentation/releasenotes/1.6) | [Javadoc](http://demobox.github.com/jclouds-maven-site-1.6.0/1.6.0/jclouds-multi/apidocs/) * [1.5.10](/documentation/releasenotes/1.5) | [Javadoc](http://demobox.github.com/jclouds-maven-site-1.5.10/1.5.10/jclouds-multi/apidocs/) * [1.5.9](/documentation/releasenotes/1.5) | [Javadoc](http://demobox.github.com/jclouds-maven-site-1.5.9/1.5.9/jclouds-multi/apidocs/) diff --git a/documentation/userguide/installation-guide.md b/documentation/userguide/installation-guide.md index 49c08da..3abb252 100644 --- a/documentation/userguide/installation-guide.md +++ b/documentation/userguide/installation-guide.md @@ -18,7 +18,7 @@ title: Installation * Download [lein](https://github.com/technomancy/leiningen/raw/stable/bin/lein) and make it executable. * Create a __project.clj__ file with the below contents. {% highlight clojure %} -(defproject deps "1" :dependencies [[org.jclouds/jclouds-all "1.6.0"] [org.jclouds.driver/jclouds-sshj "1.6.0"]]) +(defproject deps "1" :dependencies [[org.apache.jclouds/jclouds-all "1.6.1-incubating"] [org.apache.jclouds.driver/jclouds-sshj "1.6.1-incubating"]]) {% endhighlight %} * Execute __lein pom__, then __mvn dependency:copy-dependencies__ which will fill `target/dependency` with all the jclouds jars. @@ -32,9 +32,9 @@ the following your project's __pom.xml__: {% highlight xml %} - org.jclouds + org.apache.jclouds jclouds-all - 1.6.0 + 1.6.1-incubating {% endhighlight %} @@ -53,8 +53,8 @@ When you run this script with __ant__, it will build a __lib__ directory full of - - + + @@ -77,13 +77,13 @@ When you run this script with __ant__, it will build a __lib__ directory full of To only fetch the jars for a particular provider replace {% highlight xml %} - + {% endhighlight %} with {% highlight xml %} - + {% endhighlight %} You can see the list of supported providers and their ids in the [Supported Providers](/documentation/reference/supported-providers). @@ -95,12 +95,12 @@ Then, add jclouds to your __build.xml__ as shown below: {% highlight xml %} - - + + version="1.6.1-incubating" /> {% endhighlight %} @@ -112,13 +112,13 @@ If you use lieningen, you can add jclouds to your project.clj like below, suppor :dependencies [[org.clojure/clojure "1.3.0"] [org.clojure/core.incubator "0.1.0"] [org.clojure/tools.logging "0.2.3"] - [org.jclouds/jclouds-allcompute "1.6.0"] - [org.jclouds/jclouds-allblobstore "1.6.0"]] + [org.apache.jclouds/jclouds-allcompute "1.6.1-incubating"] + [org.apache.jclouds/jclouds-allblobstore "1.6.1-incubating"]] {% endhighlight %} ## Making your own lib dir * Using maven: - * Create a pom.xml file with dependencies you need (ex. org.jclouds/jclouds-all) and the snapshot repository, if you want snapshot version (1.6.1-SNAPSHOT). + * Create a pom.xml file with dependencies you need (ex. org.apache.jclouds/jclouds-all) and the snapshot repository, if you want snapshot version (1.6.2-SNAPSHOT). * Execute `mvn dependency:copy-dependencies`. * You'll notice a new directory target/dependency with all the jars you need. * Using lein @@ -144,14 +144,14 @@ You need to update your repositories and add the following in your project's pom - org.jclouds + org.apache.jclouds jclouds-allcompute - 1.6.1-SNAPSHOT + 1.6.2-SNAPSHOT - org.jclouds + org.apache.jclouds jclouds-allblobstore - 1.6.1-SNAPSHOT + 1.6.2-SNAPSHOT {% endhighlight %} @@ -166,12 +166,12 @@ Then, add jclouds snapshot dependencies to your __build.xml__ as shown below: - - + + version="1.6.2-SNAPSHOT" /> {% endhighlight %} @@ -184,7 +184,7 @@ If you use lieningen, you can add jclouds snapshots to your __project.clj__ like :dependencies [[org.clojure/clojure "1.3.0"] [org.clojure/core.incubator "0.1.0"] [org.clojure/tools.logging "0.2.3"] - [org.jclouds/jclouds-allcompute "1.6.1-SNAPSHOT"] - [org.jclouds/jclouds-allblobstore "1.6.1-SNAPSHOT"]] + [org.apache.jclouds/jclouds-allcompute "1.6.2-SNAPSHOT"] + [org.apache.jclouds/jclouds-allblobstore "1.6.2-SNAPSHOT"]] :repositories { "jclouds-snapshot" "https://oss.sonatype.org/content/repositories/snapshots"} {% endhighlight %}