You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@guacamole.apache.org by sam g <sa...@yahoo.fr.INVALID> on 2021/12/08 10:17:39 UTC
Simple extension not working
Hello,
I can't figure out how to make the simple extension describe here https://guacamole.apache.org/doc/gug/guacamole-ext.html , "Updating existing HTML", to work.
The guac-manifest.json looks like thi: {
"guacamoleVersion" : "1.3.0",
"name" : "TOTO",
"namespace" : "toto",
"html" : [ "loginDisclaimer.html" ]
}
The loginDisclaimer.html looks like this:<meta name="after" content=".login-ui .login-dialog">
<div class="welcome">
<h2>Welcome to our Guacamole server!</h2>
<p>
Please be sure to read our privacy policy before continuing.
</p>
</div>
The build is successful:[INFO] Building tar: /home/sam/guacamole-client-1.3.0/target/guacamole-client-1.3.0.tar.gz
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO]
[INFO] guacamole-common 1.3.0 ............................. SUCCESS [ 7.898 s]
[INFO] guacamole-ext 1.3.0 ................................ SUCCESS [ 7.707 s]
[INFO] guacamole-common-js 1.3.0 .......................... SUCCESS [ 0.963 s]
[INFO] guacamole 1.3.0 .................................... SUCCESS [ 10.496 s]
[INFO] guacamole-auth-header 1.2.0 ........................ SUCCESS [ 0.449 s]
[INFO] guacamole-auth-jdbc 1.3.0 .......................... SUCCESS [ 0.005 s]
[INFO] guacamole-auth-jdbc-base 1.3.0 ..................... SUCCESS [ 2.761 s]
[INFO] guacamole-auth-jdbc-mysql 1.3.0 .................... SUCCESS [ 3.156 s]
[INFO] guacamole-auth-jdbc-postgresql 1.3.0 ............... SUCCESS [ 2.894 s]
[INFO] guacamole-auth-jdbc-sqlserver 1.3.0 ................ SUCCESS [ 2.784 s]
[INFO] guacamole-auth-jdbc-dist 1.3.0 ..................... SUCCESS [ 0.839 s]
[INFO] guacamole-auth-saml 1.3.0 .......................... SUCCESS [ 0.744 s]
[INFO] guacamole-toto 1.3.0 ............................... SUCCESS [ 0.122 s]
[INFO] guacamole-client 1.3.0 ............................. SUCCESS [ 2.615 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
Tomcat is stopped, the war copied in the right place, Tomcat is started.I checked and the html file and the manifest are in the war.Still, nothing is displayed on the logon page.
What am I missing? How can I debug this?
Thanks,Sam
Re: Simple extension not working
Posted by sam g <sa...@yahoo.fr.INVALID>.
Thanks, that was it.It's in fact described at the bottom of https://guacamole.apache.org/doc/gug/event-listeners.html but your explanations are more cleare.
Sam
Le mercredi 8 décembre 2021, 12:18:48 UTC+1, Mike Jumper <mi...@glyptodon.com> a écrit :
On Wed, Dec 8, 2021, 02:17 sam g <sa...@yahoo.fr.invalid> wrote:
Hello,
I can't figure out how to make the simple extension describe here https://guacamole.apache.org/doc/gug/guacamole-ext.html , "Updating existing HTML", to work.
...
The build is successful:[INFO] Building tar: /home/sam/guacamole-client-1.3.0/target/guacamole-client-1.3.0.tar.gz
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO]
...
[INFO] guacamole-auth-saml 1.3.0 .......................... SUCCESS [ 0.744 s]
[INFO] guacamole-toto 1.3.0 ............................... SUCCESS [ 0.122 s]
[INFO] guacamole-client 1.3.0 ............................. SUCCESS [ 2.615 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
Tomcat is stopped, the war copied in the right place, Tomcat is started.I checked and the html file and the manifest are in the war.Still, nothing is displayed on the logon page.
What am I missing? How can I debug this?
There is a bit of a misunderstanding here about what an extension is. An extension does not need to be part of the guacamole-client build or source tree, nor will being part of the build have any effect on the .war, nor will the presence of a guac-manifest.json in the .war file have any impact on the webapp.
An extension is an independent .jar file that contains a guac-manifest.json. This is part of the point of extensions: they can be developed independently of the mainline source and installed without rebuilding the source.
To create an extension, you create a .jar file that follows the format described in the documentation:
https://guacamole.apache.org/doc/gug/guacamole-ext.html#ext-file-format
|
|
| |
Chapter 23. guacamole-ext
|
|
|
To install an extension, you copy the .jar produced into GUACAMOLE_HOME/extensions/ (typically "/etc/guacamole/extensions"), just as you would any of the standard extensions like the database support:
https://guacamole.apache.org/doc/gug/configuring-guacamole.html#guacamole-home
When the Guacamole webapp starts up, it will look through that directory for .jar files containing a guac-manifest.json and load those extensions.
An example is provided demonstrating the basics of the extension format and how HTML can be modified:
https://github.com/apache/guacamole-client/tree/master/doc/guacamole-branding-example
- Mike
Re: Simple extension not working
Posted by Mike Jumper <mi...@glyptodon.com>.
On Wed, Dec 8, 2021, 02:17 sam g <sa...@yahoo.fr.invalid> wrote:
> Hello,
>
> I can't figure out how to make the simple extension describe here
> https://guacamole.apache.org/doc/gug/guacamole-ext.html , "Updating
> existing HTML", to work.
>
> ...
>
> The build is successful:
> [INFO] Building tar:
> /home/sam/guacamole-client-1.3.0/target/guacamole-client-1.3.0.tar.gz
> [INFO]
> ------------------------------------------------------------------------
> [INFO] Reactor Summary:
> [INFO]
> ...
> [INFO] guacamole-auth-saml 1.3.0 .......................... SUCCESS [
> 0.744 s]
> *[INFO] guacamole-toto 1.3.0 ............................... SUCCESS [
> 0.122 s]*
> [INFO] guacamole-client 1.3.0 ............................. SUCCESS [
> 2.615 s]
> [INFO]
> ------------------------------------------------------------------------
> [INFO] BUILD SUCCESS
> [INFO]
> ------------------------------------------------------------------------
>
> Tomcat is stopped, the war copied in the right place, Tomcat is started.
> I checked and the html file and the manifest are in the war.
> Still, nothing is displayed on the logon page.
>
> What am I missing? How can I debug this?
>
There is a bit of a misunderstanding here about what an extension is. An
extension does not need to be part of the guacamole-client build or source
tree, nor will being part of the build have any effect on the .war, nor
will the presence of a guac-manifest.json *in the .war file* have any
impact on the webapp.
An extension is an independent .jar file that contains a
guac-manifest.json. This is part of the point of extensions: they can be
developed independently of the mainline source and installed without
rebuilding the source.
To create an extension, you create a .jar file that follows the format
described in the documentation:
https://guacamole.apache.org/doc/gug/guacamole-ext.html#ext-file-format
To install an extension, you copy the .jar produced into
GUACAMOLE_HOME/extensions/ (typically "/etc/guacamole/extensions"), just as
you would any of the standard extensions like the database support:
https://guacamole.apache.org/doc/gug/configuring-guacamole.html#guacamole-home
When the Guacamole webapp starts up, it will look through that directory
for .jar files containing a guac-manifest.json and load those extensions.
An example is provided demonstrating the basics of the extension format and
how HTML can be modified:
https://github.com/apache/guacamole-client/tree/master/doc/guacamole-branding-example
- Mike