Skip to content
This repository was archived by the owner on Mar 25, 2018. It is now read-only.
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
60 changes: 60 additions & 0 deletions documentation/releasenotes/1.6.1.md
Original file line number Diff line number Diff line change
@@ -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 %}
<dependencies>
<dependency>
<groupId>org.apache.jclouds</groupId>
<artifactId>jclouds-all</artifactId>
<version>1.6.1-incubating</version>
</dependency>
</dependencies>
{% 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).

1 change: 1 addition & 0 deletions documentation/releasenotes/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The 1.6.1 docs are currently being built, by the way...

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we document how that's done and get that onto something under jclouds.incubator.apache.org? I'll open a JIRA. Ideally, I'd like anything that's part of a release to be done as part of the release process, by the release manager (or at least overseen by the release manager), so that things like updating the site, getting the javadocs up, etc, doesn't lag.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we document how that's done and get that onto something under jclouds.incubator.apache.org?

Absolutely! Let's get this hosted somewhere on Apache space as quickly as possible. There's nothing magical going on here - it's just generation of the Maven site, which includes the Javadocs. We should try to trim down the amount of what's generated to speed things up, then it's simply a matter of changing the POM to publish the site to wherever on Apache we should be hosting it.

* [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/)
Expand Down
48 changes: 24 additions & 24 deletions documentation/userguide/installation-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand All @@ -32,9 +32,9 @@ the following your project's __pom.xml__:
{% highlight xml %}
<dependencies>
<dependency>
<groupId>org.jclouds</groupId>
<groupId>org.apache.jclouds</groupId>
<artifactId>jclouds-all</artifactId>
<version>1.6.0</version>
<version>1.6.1-incubating</version>
</dependency>
</dependencies>
{% endhighlight %}
Expand All @@ -53,8 +53,8 @@ When you run this script with __ant__, it will build a __lib__ directory full of
<delete dir="lib" />
<mkdir dir="lib" />
<artifact:dependencies filesetId="jclouds.fileset" versionsId="dependency.versions">
<dependency groupId="org.jclouds" artifactId="jclouds-all" version="1.6.0" />
<dependency groupId="org.jclouds.driver" artifactId="jclouds-sshj" version="1.6.0" />
<dependency groupId="org.apache.jclouds" artifactId="jclouds-all" version="1.6.1-incubating" />
<dependency groupId="org.apache.jclouds.driver" artifactId="jclouds-sshj" version="1.6.1-incubating" />
<dependency groupId="ch.qos.logback" artifactId="logback-classic" version="[1.0.9,)" />
</artifact:dependencies>
<copy todir="lib" verbose="true">
Expand All @@ -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 %}
<dependency groupId="org.jclouds" artifactId="jclouds-all" version="1.6.0" />
<dependency groupId="org.apache.jclouds" artifactId="jclouds-all" version="1.6.1-incubating" />
{% endhighlight %}

with

{% highlight xml %}
<dependency groupId="org.jclouds.provider" artifactId="the-provider-id" version="1.6.0" />
<dependency groupId="org.apache.jclouds.provider" artifactId="the-provider-id" version="1.6.1-incubating" />
{% endhighlight %}

You can see the list of supported providers and their ids in the [Supported Providers](/documentation/reference/supported-providers).
Expand All @@ -95,12 +95,12 @@ Then, add jclouds to your __build.xml__ as shown below:

{% highlight xml %}
<artifact:dependencies pathId="jclouds.classpath">
<dependency groupId="org.jclouds"
<dependency groupId="org.apache.jclouds"
artifactId="jclouds-allcompute"
version="1.6.0" />
<dependency groupId="org.jclouds"
version="1.6.1-incubating" />
<dependency groupId="org.apache.jclouds"
artifactId="jclouds-allblobstore"
version="1.6.0" />
version="1.6.1-incubating" />
</artifact:dependencies>
{% endhighlight %}

Expand All @@ -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 %}

## <a id="lib"></a>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
Expand All @@ -144,14 +144,14 @@ You need to update your repositories and add the following in your project's pom
</repositories>
<dependencies>
<dependency>
<groupId>org.jclouds</groupId>
<groupId>org.apache.jclouds</groupId>
<artifactId>jclouds-allcompute</artifactId>
<version>1.6.1-SNAPSHOT</version>
<version>1.6.2-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>org.jclouds</groupId>
<groupId>org.apache.jclouds</groupId>
<artifactId>jclouds-allblobstore</artifactId>
<version>1.6.1-SNAPSHOT</version>
<version>1.6.2-SNAPSHOT</version>
</dependency>
</dependencies>
{% endhighlight %}
Expand All @@ -166,12 +166,12 @@ Then, add jclouds snapshot dependencies to your __build.xml__ as shown below:
<artifact:remoteRepository id="jclouds.snapshot.repository"
url="https://oss.sonatype.org/content/repositories/snapshots" />
<artifact:dependencies pathId="jclouds.classpath">
<dependency groupId="org.jclouds"
<dependency groupId="org.apache.jclouds"
artifactId="jclouds-allcompute"
version="1.6.1-SNAPSHOT" />
<dependency groupId="org.jclouds"
version="1.6.2-SNAPSHOT" />
<dependency groupId="org.apache.jclouds"
artifactId="jclouds-allblobstore"
version="1.6.1-SNAPSHOT" />
version="1.6.2-SNAPSHOT" />
<remoteRepository refid="jclouds.snapshot.repository" />
</artifact:dependencies>
{% endhighlight %}
Expand All @@ -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 %}