You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@guacamole.apache.org by mj...@apache.org on 2016/03/20 03:15:28 UTC
[18/50] incubator-guacamole-manual git commit: GUAC-1392: Bump
version numbers to 0.9.9 everywhere.
GUAC-1392: Bump version numbers to 0.9.9 everywhere.
Project: http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/commit/99e70334
Tree: http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/tree/99e70334
Diff: http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/diff/99e70334
Branch: refs/heads/master
Commit: 99e70334c8dcabd4b1249108d5e735dbfce66bbf
Parents: e0a3f13
Author: Michael Jumper <mi...@guac-dev.org>
Authored: Tue Dec 15 13:39:48 2015 -0800
Committer: Michael Jumper <mi...@guac-dev.org>
Committed: Tue Dec 15 13:54:09 2015 -0800
----------------------------------------------------------------------
src/chapters/custom-auth.xml | 14 ++++++--------
src/chapters/guacamole-ext.xml | 4 ++--
src/chapters/installing.xml | 14 +++++++-------
src/chapters/jdbc-auth.xml | 32 +++++++++++++++++++++++++-------
src/chapters/ldap-auth.xml | 4 ++--
src/chapters/noauth.xml | 4 ++--
src/chapters/yourown.xml | 14 +++++++-------
src/gug.xml | 4 ++--
8 files changed, 53 insertions(+), 37 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/blob/99e70334/src/chapters/custom-auth.xml
----------------------------------------------------------------------
diff --git a/src/chapters/custom-auth.xml b/src/chapters/custom-auth.xml
index edd2997..d23db23 100644
--- a/src/chapters/custom-auth.xml
+++ b/src/chapters/custom-auth.xml
@@ -18,11 +18,9 @@
information saved in properties inside the <filename>guacamole.properties</filename>
file.</para>
<para>In general, all other authentication plugins for Guacamole will use the principles
- demonstrated here. However, as of Guacamole 0.8.0, the authentication model has been
- significantly enhanced, and supports more than simply translating a username/password pair
- into a set of authorized configurations. This tutorial demonstrates the simplest way to
- create an authentication plugin for Guacamole - an authentication plugin that does not
- support management of users and connections via the web interface.</para>
+ demonstrated here. This tutorial demonstrates the simplest way to create an authentication
+ plugin for Guacamole - an authentication plugin that does not support management of users
+ and connections via the web interface.</para>
<section xml:id="auth-model">
<title>Guacamole's authentication model</title>
<para>When you view any page in Guacamole, whether that be the login screen or the client
@@ -60,7 +58,7 @@
<groupId>org.glyptodon.guacamole</groupId>
<artifactId>guacamole-auth-tutorial</artifactId>
<packaging>jar</packaging>
- <version>0.9.8</version>
+ <version>0.9.9</version>
<name>guacamole-auth-tutorial</name>
<url>http://guac-dev.org/</url>
@@ -90,7 +88,7 @@
<dependency>
<groupId>org.glyptodon.guacamole</groupId>
<artifactId>guacamole-common</artifactId>
- <version>0.9.7</version>
+ <version>0.9.9</version>
<scope>provided</scope>
</dependency>
@@ -98,7 +96,7 @@
<dependency>
<groupId>org.glyptodon.guacamole</groupId>
<artifactId>guacamole-ext</artifactId>
- <version>0.9.8</version>
+ <version>0.9.9</version>
<scope>provided</scope>
</dependency>
http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/blob/99e70334/src/chapters/guacamole-ext.xml
----------------------------------------------------------------------
diff --git a/src/chapters/guacamole-ext.xml b/src/chapters/guacamole-ext.xml
index b05ce72..49364af 100644
--- a/src/chapters/guacamole-ext.xml
+++ b/src/chapters/guacamole-ext.xml
@@ -159,7 +159,7 @@
<filename>guac-manifest.json</filename> will look something like this:</para>
<informalexample>
<programlisting>{
- "guacamoleVersion" : "0.9.8",
+ "guacamoleVersion" : "0.9.9",
"name" : "My Extension",
"namespace" : "my-extension"
}</programlisting>
@@ -171,7 +171,7 @@
<informalexample>
<programlisting>{
- "guacamoleVersion" : "0.9.8",
+ "guacamoleVersion" : "0.9.9",
"name" : "My Extension",
"namespace" : "my-extension",
http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/blob/99e70334/src/chapters/installing.xml
----------------------------------------------------------------------
diff --git a/src/chapters/installing.xml b/src/chapters/installing.xml
index ac5e1e9..afc0a70 100644
--- a/src/chapters/installing.xml
+++ b/src/chapters/installing.xml
@@ -492,8 +492,8 @@
of a <filename>.tar.gz</filename> archive which you can extract from the command
line:</para>
<informalexample>
- <screen><prompt>$</prompt> <userinput>tar -xzf guacamole-server-0.9.8.tar.gz</userinput>
-<prompt>$</prompt> <userinput>cd guacamole-server-0.9.8/</userinput>
+ <screen><prompt>$</prompt> <userinput>tar -xzf guacamole-server-0.9.9.tar.gz</userinput>
+<prompt>$</prompt> <userinput>cd guacamole-server-0.9.9/</userinput>
<prompt>$</prompt></screen>
</informalexample>
<para>If you want the absolute latest code, and don't care that the code hasn't been as
@@ -545,7 +545,7 @@ checking whether build environment is sane... yes
...
------------------------------------------------
-guacamole-server version 0.9.8
+guacamole-server version 0.9.9
------------------------------------------------
Library status:
@@ -713,8 +713,8 @@ make[1]: Leaving directory `/home/zhz/guacamole/guacamole-server'</computeroutpu
<filename>.tar.gz</filename> archive which you can extract from the command
line:</para>
<informalexample>
- <screen><prompt>$</prompt> <userinput>tar -xzf guacamole-client-0.9.8.tar.gz</userinput>
-<prompt>$</prompt> <userinput>cd guacamole-client-0.9.8/</userinput>
+ <screen><prompt>$</prompt> <userinput>tar -xzf guacamole-client-0.9.9.tar.gz</userinput>
+<prompt>$</prompt> <userinput>cd guacamole-client-0.9.9/</userinput>
<prompt>$</prompt></screen>
</informalexample>
<para>As with <package>guacamole-server</package>, if you want the absolute latest code, and
@@ -808,7 +808,7 @@ Resolving deltas: 100% (3942/3942), done.</computeroutput>
application from the name of the <filename>.war</filename> file, you will likely want to
rename this to simply <filename>guacamole.war</filename> while copying:</para>
<informalexample>
- <screen><prompt>#</prompt> <userinput>cp guacamole/target/guacamole-0.9.8.war <replaceable>/var/lib/tomcat/webapps</replaceable>/guacamole.war</userinput>
+ <screen><prompt>#</prompt> <userinput>cp guacamole/target/guacamole-0.9.9.war <replaceable>/var/lib/tomcat/webapps</replaceable>/guacamole.war</userinput>
<prompt>#</prompt></screen>
</informalexample>
<para>Again, if you are using a different servlet container or if Tomcat is installed to a
@@ -826,7 +826,7 @@ Resolving deltas: 100% (3942/3942), done.</computeroutput>
Starting Tomcat... OK</computeroutput>
<prompt>#</prompt> <userinput>/etc/init.d/guacd start</userinput>
<computeroutput>Starting guacd: SUCCESS
-guacd[6229]: INFO: Guacamole proxy daemon (guacd) version 0.9.8 started</computeroutput>
+guacd[6229]: INFO: Guacamole proxy daemon (guacd) version 0.9.9 started</computeroutput>
<prompt>#</prompt></screen>
</informalexample>
<important>
http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/blob/99e70334/src/chapters/jdbc-auth.xml
----------------------------------------------------------------------
diff --git a/src/chapters/jdbc-auth.xml b/src/chapters/jdbc-auth.xml
index f06d68c..a755c62 100644
--- a/src/chapters/jdbc-auth.xml
+++ b/src/chapters/jdbc-auth.xml
@@ -60,10 +60,10 @@
<term><filename>mysql/</filename></term>
<listitem>
<para>Contains the MySQL/MariaDB authentication extension,
- <filename>guacamole-auth-jdbc-mysql-0.9.8.jar</filename>, along with a
+ <filename>guacamole-auth-jdbc-mysql-0.9.9.jar</filename>, along with a
<filename>schema/</filename> directory containing MySQL-specific SQL
scripts required to set up the database. The
- <filename>guacamole-auth-jdbc-mysql-0.9.8.jar</filename> file will
+ <filename>guacamole-auth-jdbc-mysql-0.9.9.jar</filename> file will
ultimately need to be placed within
<filename>GUACAMOLE_HOME/extensions</filename>, while the MySQL JDBC
driver must be placed within <filename>GUACAMOLE_HOME/lib</filename>.</para>
@@ -80,10 +80,10 @@
<term><filename>postgresql/</filename></term>
<listitem>
<para>Contains the PostgreSQL authentication extension,
- <filename>guacamole-auth-jdbc-postgresql-0.9.8.jar</filename>, along
+ <filename>guacamole-auth-jdbc-postgresql-0.9.9.jar</filename>, along
with a <filename>schema/</filename> directory containing PostgreSQL-specific
SQL scripts required to set up the database. The
- <filename>guacamole-auth-jdbc-postgresql-0.9.8.jar</filename> file will
+ <filename>guacamole-auth-jdbc-postgresql-0.9.9.jar</filename> file will
ultimately need to be placed within
<filename>GUACAMOLE_HOME/extensions</filename>, while the PostgreSQL
JDBC driver must be placed within
@@ -170,7 +170,7 @@ Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
script located within the <filename>upgrade/</filename> directory:</para>
<informalexample>
<screen><prompt>$</prompt> <userinput>ls schema/upgrade/</userinput>
-<computeroutput>upgrade-pre-0.8.2.sql upgrade-pre-0.9.7.sql
+<computeroutput>upgrade-pre-0.8.2.sql upgrade-pre-0.9.7.sql upgrade-pre-0.9.9.sql
upgrade-pre-0.9.6.sql upgrade-pre-0.9.8.sql</computeroutput>
<prompt>$</prompt> <userinput>mysql -u root -p <replaceable>guacamole_db</replaceable> < schema/upgrade/upgrade-pre-0.8.2.sql</userinput>
<prompt>Enter password:</prompt> <userinput><replaceable>password</replaceable></userinput>
@@ -201,6 +201,14 @@ upgrade-pre-0.9.6.sql upgrade-pre-0.9.8.sql</computeroutput>
<prompt>Enter password:</prompt> <userinput><replaceable>password</replaceable></userinput>
<prompt>$</prompt></screen>
</informalexample>
+ <para>If you are upgrading from a version of Guacamole before 0.9.9, schema changes
+ which add indexes improving the performance of connection history searches need
+ to be applied:</para>
+ <informalexample>
+ <screen><prompt>$</prompt> <userinput>mysql -u root -p <replaceable>guacamole_db</replaceable> < schema/upgrade/upgrade-pre-0.9.9.sql</userinput>
+<prompt>Enter password:</prompt> <userinput><replaceable>password</replaceable></userinput>
+<prompt>$</prompt></screen>
+ </informalexample>
</important>
</section>
<section xml:id="jdbc-auth-postgresql">
@@ -267,6 +275,16 @@ ALTER TABLE
ALTER TABLE</computeroutput>
<prompt>$</prompt></screen>
</informalexample>
+ <para>If you are upgrading from a version of Guacamole before 0.9.9, schema
+ changes which add indexes improving the performance of connection history
+ searches need to be applied:</para>
+ <informalexample>
+ <screen><prompt>$</prompt> <userinput>psql -d <replaceable>guacamole_db</replaceable> -f schema/upgrade/upgrade-pre-0.9.9.sql</userinput>
+<computeroutput>CREATE INDEX
+CREATE INDEX
+CREATE INDEX</computeroutput>
+<prompt>$</prompt></screen>
+ </informalexample>
</informalexample>
</important>
</section>
@@ -282,9 +300,9 @@ ALTER TABLE</computeroutput>
does not already exist.</para>
</step>
<step>
- <para>Copy <filename>guacamole-auth-jdbc-mysql-0.9.8.jar</filename>
+ <para>Copy <filename>guacamole-auth-jdbc-mysql-0.9.9.jar</filename>
<emphasis>or</emphasis>
- <filename>guacamole-auth-jdbc-postgresql-0.9.8.jar</filename> within
+ <filename>guacamole-auth-jdbc-postgresql-0.9.9.jar</filename> within
<filename>GUACAMOLE_HOME/extensions</filename>, depending on whether you are
using MySQL/MariaDB or PostgreSQL.</para>
</step>
http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/blob/99e70334/src/chapters/ldap-auth.xml
----------------------------------------------------------------------
diff --git a/src/chapters/ldap-auth.xml b/src/chapters/ldap-auth.xml
index 3721cbc..c04bace 100644
--- a/src/chapters/ldap-auth.xml
+++ b/src/chapters/ldap-auth.xml
@@ -82,7 +82,7 @@
containing:</para>
<variablelist>
<varlistentry>
- <term><filename>guacamole-auth-ldap-0.9.8.jar</filename></term>
+ <term><filename>guacamole-auth-ldap-0.9.9.jar</filename></term>
<listitem>
<para>The Guacamole LDAP support extension itself, which must be placed in
<filename>GUACAMOLE_HOME/extensions</filename>.</para>
@@ -208,7 +208,7 @@ dn: cn={4}guacConfigGroup,cn=schema,cn=config
does not already exist.</para>
</step>
<step>
- <para>Copy <filename>guacamole-auth-ldap-0.9.8.jar</filename> within
+ <para>Copy <filename>guacamole-auth-ldap-0.9.9.jar</filename> within
<filename>GUACAMOLE_HOME/extensions</filename>.</para>
</step>
<step>
http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/blob/99e70334/src/chapters/noauth.xml
----------------------------------------------------------------------
diff --git a/src/chapters/noauth.xml b/src/chapters/noauth.xml
index d29ddee..d25ef3e 100644
--- a/src/chapters/noauth.xml
+++ b/src/chapters/noauth.xml
@@ -35,7 +35,7 @@
packaged as a <filename>.tar.gz</filename> file containing:</para>
<variablelist>
<varlistentry>
- <term><filename>guacamole-auth-noauth-0.9.8.jar</filename></term>
+ <term><filename>guacamole-auth-noauth-0.9.9.jar</filename></term>
<listitem>
<para>The NoAuth extension itself, which must be placed in
<filename>GUACAMOLE_HOME/extensions</filename>.</para>
@@ -61,7 +61,7 @@
does not already exist.</para>
</step>
<step>
- <para>Copy <filename>guacamole-auth-noauth-0.9.8.jar</filename> within
+ <para>Copy <filename>guacamole-auth-noauth-0.9.9.jar</filename> within
<filename>GUACAMOLE_HOME/extensions</filename>.</para>
</step>
<step>
http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/blob/99e70334/src/chapters/yourown.xml
----------------------------------------------------------------------
diff --git a/src/chapters/yourown.xml b/src/chapters/yourown.xml
index 0f29918..0464e24 100644
--- a/src/chapters/yourown.xml
+++ b/src/chapters/yourown.xml
@@ -112,7 +112,7 @@
<groupId>org.glyptodon.guacamole</groupId>
<artifactId>guacamole-tutorial</artifactId>
<packaging>war</packaging>
- <version>0.9.8</version>
+ <version>0.9.9</version>
<name>guacamole-tutorial</name>
<url>http://guac-dev.org/</url>
@@ -201,7 +201,7 @@
</informalexample>
<para>Assuming you see the "<computeroutput>BUILD SUCCESSFUL</computeroutput>" message
when you build the web application, there will be a new file,
- <filename>target/guacamole-tutorial-0.7.0.war</filename>, which can be deployed
+ <filename>target/guacamole-tutorial-0.9.9.war</filename>, which can be deployed
to your servlet container and tested. If you changed the name or version of the
project in the <filename>pom.xml</filename> file, the name of this new
<filename>.war</filename> file will be different, but it can still be found
@@ -302,7 +302,7 @@
<dependency>
<groupId>org.glyptodon.guacamole</groupId>
<artifactId>guacamole-common</artifactId>
- <version>0.9.7</version>
+ <version>0.9.9</version>
<scope>compile</scope>
</dependency>
@@ -310,7 +310,7 @@
<dependency>
<groupId>org.glyptodon.guacamole</groupId>
<artifactId>guacamole-common-js</artifactId>
- <version>0.9.8</version>
+ <version>0.9.9</version>
<type>zip</type>
<scope>runtime</scope>
</dependency>
@@ -329,8 +329,8 @@
web application should build successfully, and the Guacamole JavaScript API should
be accessible in the <filename>guacamole-common-js/</filename> subdirectory of your
web application after it is deployed. A quick check that you can access
- <uri>/guacamole-tutorial-0.8.0/guacamole-common-js/guacamole.js</uri> is
- probably worth the effort.</para>
+ <uri>/guacamole-tutorial-0.9.9/guacamole-common-js/all.min.js</uri> is probably
+ worth the effort.</para>
</section>
<section xml:id="simple-tunnel">
<title>The simplest tunnel possible</title>
@@ -438,7 +438,7 @@ public class TutorialGuacamoleTunnelServlet
to the URL we wish to use when making HTTP requests to the servlet:
<uri>/tunnel</uri>. This URL is relative to the context root of the web
application. In the case of this web application, the final absolute URL will be
- <uri>/guacamole-tutorial-0.8.0/tunnel</uri>.</para>
+ <uri>/guacamole-tutorial-0.9.9/tunnel</uri>.</para>
</section>
<section xml:id="simple-client">
<title>Adding the client</title>
http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/blob/99e70334/src/gug.xml
----------------------------------------------------------------------
diff --git a/src/gug.xml b/src/gug.xml
index b8d5498..f8c76da 100644
--- a/src/gug.xml
+++ b/src/gug.xml
@@ -3,7 +3,7 @@
xmlns:xi="http://www.w3.org/2001/XInclude">
<info>
<title>Guacamole Manual</title>
- <edition>0.9.8</edition>
+ <edition>0.9.9</edition>
<author>
<personname><firstname>Michael</firstname>
<surname>Jumper</surname></personname>
@@ -41,7 +41,7 @@
application, etc.) to give a good starting point beyond simply looking at the Guacamole
codebase.</para>
<para>This particular edition of the <citetitle>Guacamole Manual</citetitle> covers
- Guacamole version 0.9.8. New releases which create new features or break compatibility
+ Guacamole version 0.9.9. New releases which create new features or break compatibility
will result in new editions of the user's guide, as will any necessary corrections. As
the official documentation for the project, this book will always be freely available in
its entirety online.</para>