You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@guacamole.apache.org by hantuo <ha...@nature.ee.ncku.edu.tw> on 2022/12/18 18:03:35 UTC
Need help with guacamole.properties
Hi there,
I'm Han-Tuo, a novice at Guacamole. I encountered a configuration issue
when I tried to set up Guacamole the other day. Any help would be
appreciated.
I followed this tutorial to setup Guacamole:
https://kifarunix.com/install-apache-guacamole-on-ubuntu/ . It worked
smoothly after I completed all steps that this tutorial said. However,
when I tried to modify guacamole.properties, the deployment result did
not change.
I rename user-mapping.xml to user-mapping2.xml and modified
guacamole.properties accordingly. And then restart both tomcat and
guacd. However, this change did not come into effect. The system still
loaded user-mapping.xml. The weirdest thing is that the system still
worked after I deleted guacamole.properties and restart both tomcat and
guacd.
The following is my environment:
Ubuntu 20.04
Guacamole 1.4.0
Tomcat 9.0.31
Folder structure:
/etc/guacamole/
|- guacamole.properties
|- user-mapping2.xml
|- guacamole-1.4.0.war
/usr/share/tomcat9/.guacamole/
|- guacamole.properties (soft link to
/etc/guacamole/gracamole.properties)
I'm not sure what is wrong. It seems that guacamole.properties is not
loaded at all. Any help would be appreciated.
Thank you.
Sincerely,
Han-Tuo
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@guacamole.apache.org
For additional commands, e-mail: user-help@guacamole.apache.org
Re: Need help with guacamole.properties
Posted by hantuo <ha...@nature.ee.ncku.edu.tw>.
Hi,
I got it. I will check the official manual. Thanks for your time.
Sincerely,
Han-Tuo
Michael Jumper 於 2022-12-19 03:07 寫到:
> On Sun, Dec 18, 2022 at 10:03 AM hantuo <ha...@nature.ee.ncku.edu.tw>
> wrote:
>
>> Hi there,
>>
>> I'm Han-Tuo, a novice at Guacamole. I encountered a configuration
>> issue
>> when I tried to set up Guacamole the other day. Any help would be
>> appreciated.
>>
>> I followed this tutorial to setup Guacamole:
>> https://kifarunix.com/install-apache-guacamole-on-ubuntu/ . It
>> worked
>> smoothly after I completed all steps that this tutorial said.
>> However,
>> when I tried to modify guacamole.properties, the deployment result
>> did
>> not change.
>>
>> I rename user-mapping.xml to user-mapping2.xml and modified
>> guacamole.properties accordingly. And then restart both tomcat and
>> guacd. However, this change did not come into effect. The system
>> still
>> loaded user-mapping.xml. The weirdest thing is that the system still
>>
>> worked after I deleted guacamole.properties and restart both tomcat
>> and
>> guacd.
>>
>> The following is my environment:
>> Ubuntu 20.04
>> Guacamole 1.4.0
>> Tomcat 9.0.31
>>
>> Folder structure:
>> /etc/guacamole/
>> |- guacamole.properties
>> |- user-mapping2.xml
>> |- guacamole-1.4.0.war
>>
>> /usr/share/tomcat9/.guacamole/
>> |- guacamole.properties (soft link to
>> /etc/guacamole/gracamole.properties)
>>
>> I'm not sure what is wrong. It seems that guacamole.properties is
>> not
>> loaded at all. Any help would be appreciated.
>
> The tutorial linked above is incorrect in several areas:
>
> 1) Setting GUACAMOLE_HOME to /etc/guacamole is unnecessary. This is
> the default.
> 2) Creating a symbolic link within /usr/share/tomcat9 is unnecessary.
> Just use /etc/guacamole. You would only create an alternative
> configuration directory within the home directory of the Tomcat user
> if you want to override the default (/etc/guacamole). It makes no
> sense to override the default with that same default in two different
> ways.
> 3) There is no "user-mapping" property. Setting that will have no
> effect. There used to be a "basic-user-mapping" property, but that was
> removed in 1.0.0 (4 years ago). Guacamole will always look for
> "user-mapping.xml" within its GUACAMOLE_HOME directory, which defaults
> to /etc/guacamole.
> 4) There is no "auth-provider" property. Setting it will have no
> effect. It was deprecated in 2015 and removed in 2016.
> 5) "/etc/guacamole" is not a sensible location for the .war file.
> Doing this will not break anything per se, but it's wrong. Files and
> directories beneath "/etc" are configuration files, whereas the .war
> file is an application binary. It would make more sense to place it in
> a location like "/usr/share/guacamole".
>
> Unfortunately, this is only one of several tutorials that all
> recommend the same incorrect steps based on configuration methods that
> haven't applied for a very long time. You should instead consult the
> manual, which is current:
>
> https://guacamole.apache.org/doc/gug/installing-guacamole.html
>
> https://guacamole.apache.org/doc/gug/configuring-guacamole.html
>
> If ever in doubt what configuration files are being loaded by
> Guacamole, check your Tomcat logs. Guacamole logs the location of the
> guacamole.properties file when it starts up.
>
> - Mike
---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@guacamole.apache.org
For additional commands, e-mail: user-help@guacamole.apache.org
Re: Need help with guacamole.properties
Posted by Michael Jumper <mj...@apache.org>.
On Sun, Dec 18, 2022 at 10:03 AM hantuo <ha...@nature.ee.ncku.edu.tw>
wrote:
> Hi there,
>
> I'm Han-Tuo, a novice at Guacamole. I encountered a configuration issue
> when I tried to set up Guacamole the other day. Any help would be
> appreciated.
>
> I followed this tutorial to setup Guacamole:
> https://kifarunix.com/install-apache-guacamole-on-ubuntu/ . It worked
> smoothly after I completed all steps that this tutorial said. However,
> when I tried to modify guacamole.properties, the deployment result did
> not change.
>
> I rename user-mapping.xml to user-mapping2.xml and modified
> guacamole.properties accordingly. And then restart both tomcat and
> guacd. However, this change did not come into effect. The system still
> loaded user-mapping.xml. The weirdest thing is that the system still
> worked after I deleted guacamole.properties and restart both tomcat and
> guacd.
>
> The following is my environment:
> Ubuntu 20.04
> Guacamole 1.4.0
> Tomcat 9.0.31
>
> Folder structure:
> /etc/guacamole/
> |- guacamole.properties
> |- user-mapping2.xml
> |- guacamole-1.4.0.war
>
> /usr/share/tomcat9/.guacamole/
> |- guacamole.properties (soft link to
> /etc/guacamole/gracamole.properties)
>
> I'm not sure what is wrong. It seems that guacamole.properties is not
> loaded at all. Any help would be appreciated.
>
The tutorial linked above is incorrect in several areas:
1) Setting GUACAMOLE_HOME to /etc/guacamole is unnecessary. This is the
default.
2) Creating a symbolic link within /usr/share/tomcat9 is unnecessary. Just
use /etc/guacamole. You would only create an alternative configuration
directory within the home directory of the Tomcat user if you want to
override the default (/etc/guacamole). It makes no sense to override the
default with that same default in two different ways.
3) There is no "user-mapping" property. Setting that will have no effect.
There used to be a "basic-user-mapping" property, but that was removed in
1.0.0 (4 years ago). Guacamole will always look for "user-mapping.xml"
within its GUACAMOLE_HOME directory, which defaults to /etc/guacamole.
4) There is no "auth-provider" property. Setting it will have no effect. It
was deprecated in 2015 and removed in 2016.
5) "/etc/guacamole" is not a sensible location for the .war file. Doing
this will not break anything per se, but it's wrong. Files and directories
beneath "/etc" are configuration files, whereas the .war file is an
application binary. It would make more sense to place it in a location like
"/usr/share/guacamole".
Unfortunately, this is only one of several tutorials that all recommend the
same incorrect steps based on configuration methods that haven't applied
for a very long time. You should instead consult the manual, which is
current:
https://guacamole.apache.org/doc/gug/installing-guacamole.html
https://guacamole.apache.org/doc/gug/configuring-guacamole.html
If ever in doubt what configuration files are being loaded by Guacamole,
check your Tomcat logs. Guacamole logs the location of the
guacamole.properties file when it starts up.
- Mike