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 2018/02/02 20:28:48 UTC
[05/13] guacamole-manual git commit: GUACAMOLE-197: Add instructions
for building RADIUS module.
GUACAMOLE-197: Add instructions for building RADIUS module.
Project: http://git-wip-us.apache.org/repos/asf/guacamole-manual/repo
Commit: http://git-wip-us.apache.org/repos/asf/guacamole-manual/commit/8a54a55d
Tree: http://git-wip-us.apache.org/repos/asf/guacamole-manual/tree/8a54a55d
Diff: http://git-wip-us.apache.org/repos/asf/guacamole-manual/diff/8a54a55d
Branch: refs/heads/master
Commit: 8a54a55d3481d6212c7fb957ad9eb3bf92ee1e80
Parents: a7615a3
Author: Nick Couchman <vn...@apache.org>
Authored: Wed Jan 31 09:58:35 2018 -0500
Committer: Nick Couchman <vn...@apache.org>
Committed: Wed Jan 31 09:58:35 2018 -0500
----------------------------------------------------------------------
src/chapters/radius-auth.xml | 62 +++++++++++++++++++++++++++++++++++----
1 file changed, 57 insertions(+), 5 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/guacamole-manual/blob/8a54a55d/src/chapters/radius-auth.xml
----------------------------------------------------------------------
diff --git a/src/chapters/radius-auth.xml b/src/chapters/radius-auth.xml
index 362d532..30a58ef 100644
--- a/src/chapters/radius-auth.xml
+++ b/src/chapters/radius-auth.xml
@@ -20,11 +20,63 @@
</section>
<section xml:id="installing-radius-auth">
<title>Installing RADIUS authentication</title>
- <para>Guacamole extensions are self-contained <filename>.jar</filename> files which are
- located within the <filename>GUACAMOLE_HOME/extensions</filename> directory.
- <emphasis>If you are unsure where <varname>GUACAMOLE_HOME</varname> is located on
- your system, please consult <xref linkend="configuring-guacamole"/> before
- proceeding.</emphasis></para>
+ <para>The RADIUS extension must be explicitly enabled during build time in order to generate
+ the binaries and resulting JAR file. This is done by adding the flag <>-Plgpl-extensions</>
+ to the MAVEN command line during the build, and should result in the output below:</para>
+ <informalexample>
+ <screen><prompt>$</prompt> <userinput>mvn clean package -Plgpl-extensions</userinput>
+<computeroutput>[INFO] --- maven-assembly-plugin:2.5.3:single (make-source-archive) @ guacamole-client ---
+[INFO] Reading assembly descriptor: project-assembly.xml
+[INFO] Building tar: /home/guac/guacamole-client/target/guacamole-client-0.9.14.tar.gz
+[INFO] ------------------------------------------------------------------------
+[INFO] Reactor Summary:
+[INFO]
+[INFO] guacamole-common .................................. SUCCESS [6.037s]
+[INFO] guacamole-ext ..................................... SUCCESS [5.382s]
+[INFO] guacamole-common-js ............................... SUCCESS [0.751s]
+[INFO] guacamole ......................................... SUCCESS [9.767s]
+[INFO] guacamole-auth-cas ................................ SUCCESS [2.811s]
+[INFO] guacamole-auth-duo ................................ SUCCESS [2.441s]
+[INFO] guacamole-auth-header ............................. SUCCESS [1.875s]
+[INFO] guacamole-auth-jdbc ............................... SUCCESS [0.277s]
+[INFO] guacamole-auth-jdbc-base .......................... SUCCESS [2.144s]
+[INFO] guacamole-auth-jdbc-mysql ......................... SUCCESS [5.637s]
+[INFO] guacamole-auth-jdbc-postgresql .................... SUCCESS [5.465s]
+[INFO] guacamole-auth-jdbc-sqlserver ..................... SUCCESS [5.398s]
+[INFO] guacamole-auth-jdbc-dist .......................... SUCCESS [0.824s]
+[INFO] guacamole-auth-ldap ............................... SUCCESS [2.743s]
+[INFO] guacamole-auth-noauth ............................. SUCCESS [0.964s]
+[INFO] guacamole-auth-openid ............................. SUCCESS [2.533s]
+[INFO] guacamole-example ................................. SUCCESS [0.888s]
+[INFO] guacamole-playback-example ........................ SUCCESS [0.628s]
+[INFO] guacamole-auth-radius ............................. SUCCESS [17.729s]
+[INFO] guacamole-client .................................. SUCCESS [5.645s]
+[INFO] ------------------------------------------------------------------------
+[INFO] BUILD SUCCESS
+[INFO] ------------------------------------------------------------------------
+[INFO] Total time: 1:20.134s
+[INFO] Finished at: Wed Jan 31 09:45:41 EST 2018
+[INFO] Final Memory: 47M/749M
+[INFO] ------------------------------------------------------------------------</computeroutput>
+ <prompt>$</prompt></screen>
+ </informalexample>
+
+ <para>After the build completes successfully, the extension will be in the
+ <filename>extensions/guacamole-auth-radius/target/</filename> directory, and will be
+ called guacamole-auth-radius-0.9.14.jar. This extension file can be copied to
+ the <filename>GUACAMOLE_HOME/extensions</filename> directory.
+ <emphasis>If you are unsure where <varname>GUACAMOLE_HOME</varname> is located on
+ your system, please consult <xref linkend="configuring-guacamole"/> before
+ proceeding.</emphasis></para>
+
+ <para>Extensions are loaded in alphabetical order, and authentication is performed
+ in the order in which the extensions were loaded. If you are stacking the
+ RADIUS extension with another extension, like the JDBC extension, in order to
+ store connection information, you may need to change the name of the RADIUS
+ extension such that it is evaluated prior to the JDBC extension - otherwise
+ an authentication failure in one of the previous modules may block the RADIUS
+ module from ever being evaluated.</para>
+
<para>To install the RADIUS authentication extension, you must:</para>
<procedure>
<step>