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 <[email protected]> Authored: Tue Dec 15 13:39:48 2015 -0800 Committer: Michael Jumper <[email protected]> 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>
