Repository: incubator-guacamole-website Updated Branches: refs/heads/asf-site 41968fe74 -> af120dc64
Deploy updated draft release notes for 0.9.10-incubating (RC2). Project: http://git-wip-us.apache.org/repos/asf/incubator-guacamole-website/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-guacamole-website/commit/af120dc6 Tree: http://git-wip-us.apache.org/repos/asf/incubator-guacamole-website/tree/af120dc6 Diff: http://git-wip-us.apache.org/repos/asf/incubator-guacamole-website/diff/af120dc6 Branch: refs/heads/asf-site Commit: af120dc64312205482956cca8b29d34790333639 Parents: 41968fe Author: Michael Jumper <[email protected]> Authored: Sun Dec 4 01:25:44 2016 -0800 Committer: Michael Jumper <[email protected]> Committed: Sun Dec 4 01:25:44 2016 -0800 ---------------------------------------------------------------------- content/releases/0.9.10-incubating/index.html | 155 +++++++++++++++++---- 1 file changed, 131 insertions(+), 24 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-guacamole-website/blob/af120dc6/content/releases/0.9.10-incubating/index.html ---------------------------------------------------------------------- diff --git a/content/releases/0.9.10-incubating/index.html b/content/releases/0.9.10-incubating/index.html index 5ed4fc6..2190498 100644 --- a/content/releases/0.9.10-incubating/index.html +++ b/content/releases/0.9.10-incubating/index.html @@ -139,19 +139,19 @@ below.</p> <tr> - <td><a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-client-0.9.10-incubating.tar.gz";>guacamole-client-0.9.10-incubating.tar.gz</a></td> - <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-client-0.9.10-incubating.tar.gz.md5";>MD5</a> ]</td> - <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-client-0.9.10-incubating.tar.gz.sha";>SHA</a> ]</td> - <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-client-0.9.10-incubating.tar.gz.asc";>PGP</a> ]</td> + <td><a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-client-0.9.10-incubating.tar.gz";>guacamole-client-0.9.10-incubating.tar.gz</a></td> + <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-client-0.9.10-incubating.tar.gz.md5";>MD5</a> ]</td> + <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-client-0.9.10-incubating.tar.gz.sha";>SHA</a> ]</td> + <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-client-0.9.10-incubating.tar.gz.asc";>PGP</a> ]</td> </tr> <tr> - <td><a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-server-0.9.10-incubating.tar.gz";>guacamole-server-0.9.10-incubating.tar.gz</a></td> - <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-server-0.9.10-incubating.tar.gz.md5";>MD5</a> ]</td> - <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-server-0.9.10-incubating.tar.gz.sha";>SHA</a> ]</td> - <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-server-0.9.10-incubating.tar.gz.asc";>PGP</a> ]</td> + <td><a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-server-0.9.10-incubating.tar.gz";>guacamole-server-0.9.10-incubating.tar.gz</a></td> + <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-server-0.9.10-incubating.tar.gz.md5";>MD5</a> ]</td> + <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-server-0.9.10-incubating.tar.gz.sha";>SHA</a> ]</td> + <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-server-0.9.10-incubating.tar.gz.asc";>PGP</a> ]</td> </tr> </table> @@ -172,37 +172,37 @@ still be built and installed from source.</strong></p> <tr> - <td><a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-0.9.10-incubating.war";>guacamole-0.9.10-incubating.war</a></td> - <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-0.9.10-incubating.war.md5";>MD5</a> ]</td> - <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-0.9.10-incubating.war.sha";>SHA</a> ]</td> - <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-0.9.10-incubating.war.asc";>PGP</a> ]</td> + <td><a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-0.9.10-incubating.war";>guacamole-0.9.10-incubating.war</a></td> + <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-0.9.10-incubating.war.md5";>MD5</a> ]</td> + <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-0.9.10-incubating.war.sha";>SHA</a> ]</td> + <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-0.9.10-incubating.war.asc";>PGP</a> ]</td> </tr> <tr> - <td><a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-auth-jdbc-0.9.10-incubating.tar.gz";>guacamole-auth-jdbc-0.9.10-incubating.tar.gz</a></td> - <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-auth-jdbc-0.9.10-incubating.tar.gz.md5";>MD5</a> ]</td> - <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-auth-jdbc-0.9.10-incubating.tar.gz.sha";>SHA</a> ]</td> - <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-auth-jdbc-0.9.10-incubating.tar.gz.asc";>PGP</a> ]</td> + <td><a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-auth-jdbc-0.9.10-incubating.tar.gz";>guacamole-auth-jdbc-0.9.10-incubating.tar.gz</a></td> + <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-auth-jdbc-0.9.10-incubating.tar.gz.md5";>MD5</a> ]</td> + <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-auth-jdbc-0.9.10-incubating.tar.gz.sha";>SHA</a> ]</td> + <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-auth-jdbc-0.9.10-incubating.tar.gz.asc";>PGP</a> ]</td> </tr> <tr> - <td><a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-auth-ldap-0.9.10-incubating.tar.gz";>guacamole-auth-ldap-0.9.10-incubating.tar.gz</a></td> - <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-auth-ldap-0.9.10-incubating.tar.gz.md5";>MD5</a> ]</td> - <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-auth-ldap-0.9.10-incubating.tar.gz.sha";>SHA</a> ]</td> - <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-auth-ldap-0.9.10-incubating.tar.gz.asc";>PGP</a> ]</td> + <td><a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-auth-ldap-0.9.10-incubating.tar.gz";>guacamole-auth-ldap-0.9.10-incubating.tar.gz</a></td> + <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-auth-ldap-0.9.10-incubating.tar.gz.md5";>MD5</a> ]</td> + <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-auth-ldap-0.9.10-incubating.tar.gz.sha";>SHA</a> ]</td> + <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-auth-ldap-0.9.10-incubating.tar.gz.asc";>PGP</a> ]</td> </tr> <tr> - <td><a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-auth-noauth-0.9.10-incubating.tar.gz";>guacamole-auth-noauth-0.9.10-incubating.tar.gz</a></td> - <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-auth-noauth-0.9.10-incubating.tar.gz.md5";>MD5</a> ]</td> - <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-auth-noauth-0.9.10-incubating.tar.gz.sha";>SHA</a> ]</td> - <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC1/guacamole-auth-noauth-0.9.10-incubating.tar.gz.asc";>PGP</a> ]</td> + <td><a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-auth-noauth-0.9.10-incubating.tar.gz";>guacamole-auth-noauth-0.9.10-incubating.tar.gz</a></td> + <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-auth-noauth-0.9.10-incubating.tar.gz.md5";>MD5</a> ]</td> + <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-auth-noauth-0.9.10-incubating.tar.gz.sha";>SHA</a> ]</td> + <td>[ <a href="https://dist.apache.org/repos/dist/dev/incubator/guacamole/0.9.10-incubating-RC2/guacamole-auth-noauth-0.9.10-incubating.tar.gz.asc";>PGP</a> ]</td> </tr> </table> @@ -220,6 +220,32 @@ Local clipboard integration has also been added (for those browsers which support it), as well as audio input for RDP, theming/branding via extensions, and several other improvements.</p> +<p><strong>This release contains changes which break compatibility with past releases.</strong> +Please see the <a href="#deprecation--compatibility-notes">deprecation / compatibility +notes</a> section for more information.</p> + +<h2 id="were-incubating">Weâre incubating!</h2> + +<p>The Guacamole project has been accepted into the <a href="http://incubator.apache.org/";>Apache +Incubator</a>, and is thus now Apache Guacamole +(incubating). Beyond simply moving the website, this necessitated a number of +changes, including switching to the <a href="https://www.apache.org/licenses/LICENSE-2.0";>Apache +License</a> and migrating Guacamoleâs +Java API and Maven artifacts from <code class="highlighter-rouge">org.glyptodon.guacamole</code> to +<code class="highlighter-rouge">org.apache.guacamole</code>. If you are simply using the Guacamole web application +as-is, the transition should be fairly seamless, but downstream users of the +APIs will need to update their source to make use of this release.</p> + +<ul> + <li><a href="https://issues.apache.org/jira/browse/GUACAMOLE-1";>GUACAMOLE-1</a> - Update source licenses and LICENSE / NOTICE / DISCLAIMER</li> + <li><a href="https://issues.apache.org/jira/browse/GUACAMOLE-3";>GUACAMOLE-3</a> - Contribution guidelines are incorrect</li> + <li><a href="https://issues.apache.org/jira/browse/GUACAMOLE-93";>GUACAMOLE-93</a> - Migrate Docker images to build from git</li> + <li><a href="https://issues.apache.org/jira/browse/GUACAMOLE-97";>GUACAMOLE-97</a> - Update documentation for Docker images</li> + <li><a href="https://issues.apache.org/jira/browse/GUACAMOLE-107";>GUACAMOLE-107</a> - Update documentation with respect to Apache</li> + <li><a href="https://issues.apache.org/jira/browse/GUACAMOLE-116";>GUACAMOLE-116</a> - Strip pre-built minified JavaScript libraries from source tarball</li> + <li><a href="https://issues.apache.org/jira/browse/GUACAMOLE-131";>GUACAMOLE-131</a> - JavaScript libraries should not be bundled in source</li> +</ul> + <h2 id="screen-sharing">Screen sharing</h2> <p>Guacamole now supports screen sharing for all protocols, even those which do @@ -267,6 +293,7 @@ handle file transfer as it always has.</p> <ul> <li><a href="https://issues.apache.org/jira/browse/GUACAMOLE-44";>GUACAMOLE-44</a> - Upload/download of files that are more than 1 GB fail</li> + <li><a href="https://issues.apache.org/jira/browse/GUACAMOLE-46";>GUACAMOLE-46</a> - File uploads are very slow</li> </ul> <h2 id="rdp-audio-input">RDP audio input</h2> @@ -403,10 +430,90 @@ typos in Guacamoleâs French translation.</p> <li><a href="https://issues.apache.org/jira/browse/GUACAMOLE-18";>GUACAMOLE-18</a> - Fix typo in French translation</li> <li><a href="https://issues.apache.org/jira/browse/GUACAMOLE-22";>GUACAMOLE-22</a> - Update missing french translations</li> <li><a href="https://issues.apache.org/jira/browse/GUACAMOLE-23";>GUACAMOLE-23</a> - __guac_socket_fd_select_handler() must always init fd_set</li> + <li><a href="https://issues.apache.org/jira/browse/GUACAMOLE-35";>GUACAMOLE-35</a> - Performance flags not handled</li> <li><a href="https://issues.apache.org/jira/browse/GUACAMOLE-66";>GUACAMOLE-66</a> - Remove usage of Apache Commons Codec Library</li> <li><a href="https://issues.apache.org/jira/browse/GUACAMOLE-67";>GUACAMOLE-67</a> - I/O error in WebSocket can cause connection tracking to fail</li> + <li><a href="https://issues.apache.org/jira/browse/GUACAMOLE-76";>GUACAMOLE-76</a> - Retrieval of connection group tree too slow</li> + <li><a href="https://issues.apache.org/jira/browse/GUACAMOLE-112";>GUACAMOLE-112</a> - Update MessageFormat</li> + <li><a href="https://issues.apache.org/jira/browse/GUACAMOLE-115";>GUACAMOLE-115</a> - Client may not cleanly disconnect if tunnel read() is blocking</li> </ul> +<h1 id="deprecation--compatibility-notes">Deprecation / Compatibility notes</h1> + +<p>As of 0.9.10-incubating, the following changes have been made which affect +compatibility with past releases:</p> + +<h2 id="database-schema-changes">Database schema changes</h2> + +<p>The MySQL and PostgreSQL schemas have changed to facilitate screen sharing +support. Users of the database authentication will need to run the +<code class="highlighter-rouge">upgrade-pre-0.9.10.sql</code> script specific to their chosen database.</p> + +<h2 id="deprecation-of-the-basic-user-mapping-property">Deprecation of the <code class="highlighter-rouge">basic-user-mapping</code> property</h2> + +<p>The <code class="highlighter-rouge">basic-user-mapping</code> property used to specify an alternative location for +<code class="highlighter-rouge">user-mapping.xml</code> is now deprecated. The property will continue to function as +in previous releases, but a warning will be logged advising of its deprecation.</p> + +<p>Administrators should instead place their <code class="highlighter-rouge">user-mapping.xml</code> files directly +within <a href="/doc/0.9.10-incubating/gug/configuring-guacamole.html#guacamole-home"><code class="highlighter-rouge">GUACAMOLE_HOME</code></a>.</p> + +<h2 id="removal-of-deprecated-lib-directory-and-auth-provider-properties">Removal of deprecated <code class="highlighter-rouge">lib-directory</code> and <code class="highlighter-rouge">auth-provider</code> properties</h2> + +<p>The <code class="highlighter-rouge">lib-directory</code> and <code class="highlighter-rouge">auth-provider</code> properties have been deprecated since +the 0.9.7 release, in favor of a self-contained extension format which does not +require their use. From 0.9.7 on, though these properties still functioned as +in 0.9.6 and older, a warning was logged advising of their deprecation.</p> + +<p>These properties have now been removed, and configurations which rely on these +properties will need to use the <code class="highlighter-rouge">extensions/</code> directory within +<a href="/doc/0.9.10-incubating/gug/configuring-guacamole.html#guacamole-home"><code class="highlighter-rouge">GUACAMOLE_HOME</code></a> +instead.</p> + +<h2 id="rename-from-orgglyptodonguacamole-to-orgapacheguacamole">Rename from <code class="highlighter-rouge">org.glyptodon.guacamole</code> to <code class="highlighter-rouge">org.apache.guacamole</code></h2> + +<p>As Guacamole is now a project operating under the Apache Incubator, its Java +classes and Maven artifacts have moved from the <code class="highlighter-rouge">org.glyptodon.guacamole</code> +package and groupId to <code class="highlighter-rouge">org.apache.guacamole</code>. Downstream developers using +Guacamoleâs APIs will need to update their source code accordingly.</p> + +<h2 id="extension-api-changes-for-screen-sharing">Extension API changes for screen sharing</h2> + +<p>The Guacamole extension API (guacamole-ext) been changed to provide for storage +of sharing profile data, and to allow for extensions to generate temporary +credentials for shared connections. If you have written an extension for +Guacamole, you may need to implement additional functions in addition to +rebuilding your extension against the latest.</p> + +<p>These changes center around the addition of the <a href="/doc/0.9.10-incubating/guacamole-ext/org/apache/guacamole/net/auth/Shareable.html"><code class="highlighter-rouge">Shareable</code></a> and +<a href="/doc/0.9.10-incubating/guacamole-ext/org/apache/guacamole/net/auth/SharingProfile.html"><code class="highlighter-rouge">SharingProfile</code></a> +interfaces, and primarily affect implementations of the following interfaces:</p> + +<ul> + <li><a href="/doc/0.9.10-incubating/guacamole-ext/org/apache/guacamole/net/auth/ActiveConnection.html"><code class="highlighter-rouge">ActiveConnection</code></a></li> + <li><a href="/doc/0.9.10-incubating/guacamole-ext/org/apache/guacamole/net/auth/UserContext.html"><code class="highlighter-rouge">UserContext</code></a></li> +</ul> + +<p>The <a href="/doc/0.9.10-incubating/gug/guacamole-ext.html">updated guacamole-ext +overview</a> within the manual +covers these changes, particularly the <a href="/doc/0.9.10-incubating/gug/guacamole-ext.html#ext-active-connections">managing/sharing active +connections</a> +section.</p> + +<h2 id="libguac-api-changes">libguac API changes</h2> + +<p>The libguac API has been extensively modified for the sake of screen sharing. +A new <a href="/doc/0.9.10-incubating/libguac/structguac__user.html"><code class="highlighter-rouge">guac_user</code></a> +structure has been added to represent each user sharing a logical connection, +where that connection is represented by +<a href="/doc/0.9.10-incubating/libguac/structguac__client.html"><code class="highlighter-rouge">guac_client</code></a>. This +requires a completely new initialization flow for protocol support +implementations, and any plugins which provide additional protocol support for +guacd will need to be updated.</p> + +<p>These changes are documented in more detail in the <a href="/doc/0.9.10-incubating/gug/libguac.html">updated libguac +overview</a> within the manual.</p> + </div>
