Guacamole之配置Guacamole（五）
摘要
在网上看到一篇Guacamole官方手册的翻译，但是找不到后续，于是想自己也翻译几篇，有时间的话，会尽量多翻译一些。 原文地址：http://guacamole.incubator.apache.org/doc/gug/index.html
在安装好Guacamole后，你需要配置用户和连接Guacamole才会工作。这一篇概括了常用的Guacamole配置，以及使用默认的验证方法。
Guacamole的默认验证方法是读取一个名字为user-mapping.xml简单的配置文件。这种验证方法适用于：
- 足够为小规模的Guacamole部署。
- 是一种相对容易设置的方法来验证Guacamole。
另外，更复杂的验证方法是用后端的数据库、LDAP等等，这些分开在后面的篇章再来讨论。
无论你用哪种验证方法，Guacamole的配置总是包含两部分：一个是叫做GUACAMOLE_HOME的目录，这是主要搜索的配置文件路径，另一个是guacamole.properties，是Guacamole及其扩展的主要配置文件。
GUACAMOLE_HOME
Guacamole从默认的配置目录中读取文件，当在这个目录中找不到文件时才从类路径中读取。Guacamole会按照如下顺序定位目录：
- guacamole.home系统属性指定的目录。
-
GUACAMOLE_HOME环境变量指定的目录。 - 在运行servlet容器的用户home目录下的.guacamole目录。
GUACAMOLE_HOME目录参照该文档的其它地方。
Guacamole把GUACAMOLE_HOME作为搜索配置文件主要的路径：例如：guacamole.properties。GUACAMOLE_HOME的结构是受严格规定的，里面包含如下可选文件：
guacamole.properties
这是Guacamole的主要配置文件。这个文件决定了Guacamole如何连接guacd，也会配置安装的扩展验证属性。
logback.xml
Guacamole用Logback记录所有的日志信息。Guacamole默认只会记录控制台日志，但是你能通过你自己的Logback配置文件来改变它。
extensions/
这是Guacamole所有扩展安装的位置。Guacamole在启动的时候会自动加载所有在这个目录中的.jar文件。
lib/
这是Guacamole的所有扩展所需库的搜索目录。Guacamole会为所有扩展编译这个目录中有用的.jar文件。如果扩展需要额外的库，像数据库驱动就应该放这里。
guacamole.properties
名字为guacamole.properties的文件是Guacamole web应用程序使用的主要配置文件。Guacamole或它的其它扩展通过读取该文件能够定位所有配置属性。
在之前的发行版中，这个文件必须在你的servlet容器类路径中。现在，guacamole.properties能够被环境变量或系统属性指定路径，只有类路径才被作为最后的途径。在Guacamole搜索guacamole.properties时会按顺序检查：
1. 在上面定义的GUACAMOLE_HOME中。
2. Servlet容器的类路径中。
当默认的配置不符合要求时，才需要配置guacamole.properties文件，或者为扩展提供额外的配置信息。下面是一些标准的配置属性：
api-session-timeout
时间是以分钟为单位，允许Guacamole回话（验证令牌）在用户无活动时保持有效。如果忽略设置，Guacamole回话就会在无活动后60分钟到期。
available-languages
用英文逗号把语言关键字白名单隔开，这是允许在Guacamole接口中使用的语言。例如：限制Guacamole只能用英语和法语：
available-languages: en, de
当找不到对应语言的翻译文件时，英语将作为备用语言。仅仅当你完全确定不会缺失字符时，才可以在配置列表里取消英语。
guacd-host
Guacamole代理守护进程默认监听的主机。如果忽略设置，Guacamole将默认监听localhost。
guacd-port
Guacamole代理守护进程默认监听的端口。如果忽略设置，Guacamole将默认监听4822端口。
guacd-ssl
如果设置为“true”，Guacamole将在web应用程序和guacd间用SSL/TLS加密。默认情况下，web应用程序和guacd之间的连接不加密。
注意，如果你启用了这个选项，你必须用命令行选项配置guacd使用SSL。这些选项的文档在guacd的手册中。你需要一个SSL证书和私钥。
Example 5.1. Example guacamole.properties
# Hostname and port of guacamole proxy
guacd-hostname: localhost
guacd-port: 4822
Web应用日志
默认情况下，Guacamole将会记录所有控制台日志。比如Tomcat等Servlet容器会自动重定向这些消息到一个日志文件中，使用Tomcat时为catalina.out，在Guacamole运行时该文件只读。日志消息分为四个不同的等级，根据消息的重要性和严重性分为：
error
致命的错误。被日志描述的操作不能继续执行，该错误是个严重需要去解决的问题。
warn
警告通常不是致命的。操作能继续执行，但是个值得注意的问题。
info
普通的信息。这些也许有用，或只是为了引起管理员的注意，但对Guacamole服务器来说，通常不是重要的操作。
debug
面向开发的详细调试信息。几乎所有的调试信息都包含堆栈追踪和内部信息，这些信息在代码中调查问题时非常有用。这些预期的调试信息虽然冗长，但不会影响性能。
trace
追踪信息和调试信息类似的故意冗长，但是如此低级别且频繁的信息会影响性能。追踪级别的信息很少的情况下才有设置的必要，主要是在调查问题时提供非常详细的信息。
Guacamole日志消息使用一个
未完待续。。
