guacamole-spice-protocol/README

131 lines
4.3 KiB
Plaintext
Raw Permalink Normal View History

2013-06-05 21:33:43 +00:00
------------------------------------------------------------
About this README
------------------------------------------------------------
This README is intended to provide quick and to-the-point documentation for
technical users intending to compile parts of Guacamole themselves.
Source archives are available from the files section of the main project page:
2013-06-05 21:33:43 +00:00
http://sourceforge.net/projects/guacamole/files/
A full manual is provided on the Guacamole web site:
2013-06-05 21:33:43 +00:00
http://guac-dev.org/
------------------------------------------------------------
What is guacamole-server?
2013-06-05 21:33:43 +00:00
------------------------------------------------------------
The guacamole-server package is a set of software which forms the basis of the
Guacamole stack. It consists of guacd, libguac, and several protocol support
libraries.
2013-06-05 21:33:43 +00:00
guacd is the Guacamole proxy daemon used by the Guacamole web application and
framework. As JavaScript cannot handle binary protocols (like VNC and remote
desktop) efficiently, a new test-based protocol was developed which would
contain a common superset of the operations needed for efficient remote desktop
access, but would be easy for JavaScript programs to process. guacd is the
proxy which translates between arbitrary protocols and the Guacamole protocol.
2013-06-05 21:33:43 +00:00
------------------------------------------------------------
Compiling and installing guacd, libguac, etc.
2013-06-05 21:33:43 +00:00
------------------------------------------------------------
All software within guacamole-server is built using the popular GNU Automake,
and thus provides the standard configure script. Before compiling, you need to
have compiled and installed libguac, the core Guacamole library. This is
available from the main Guacamole site at http://guac-dev.org/.
2013-06-05 21:33:43 +00:00
1) Run configure
$ ./configure
Assuming all dependencies have been installed, this should succeed without
errors. If you wish to install the init script as well, you need to specify
the location where your system init scripts are located (typically
/etc/init.d):
$ ./configure --with-init-dir=/etc/init.d
Running configure in this manner will cause the "make install" step to
install an init script to the specified directory, which you can then
activate using the service management mechanism provided by your
distribution).
2) Run make
$ make
guacd, libguac, and any available protocol support libraries will now
compile.
2013-06-05 21:33:43 +00:00
3) Install (as root)
# make install
All software that was just built, including documentation, will be
installed.
2013-06-05 21:33:43 +00:00
guacd will install to your /usr/local/sbin directory by default. You can
change the install location by using the --prefix option for configure.
------------------------------------------------------------
Running guacd
------------------------------------------------------------
If you installed the init script during compile and install, you should be
able to start guacd through the service management utilities provided by
your distribution (if any) or by running the init script directly (as root):
# /etc/init.d/guacd start
Root access is needed to write the pidfile /var/run/guacd.pid. You can also run
guacd itself directly without the init script (as any user):
$ guacd
guacd currently takes several command-line options:
2013-06-05 21:33:43 +00:00
-b HOST
Changes the host or address that guacd listens on.
-l PORT
Changes the port that guacd listens on (the default is port 4822).
-p PIDFILE
Causes guacd to write the PID of the daemon process to the specified
file. This is useful for init scripts and is used by the provided init
script.
-L LEVEL
Sets the maximum level at which guacd will log messages to syslog and,
if running in the foreground, the console. Legal values are debug,
info, warning, and error. The default value is info.
2013-06-05 21:33:43 +00:00
-f
Causes guacd to run in the foreground, rather than automatically
forking into the background.
Additional information can be found in the guacd man page:
$ man guacd
2013-06-05 21:33:43 +00:00
------------------------------------------------------------
Reporting problems
------------------------------------------------------------
Please report any bugs encountered by opening a new issue in the JIRA system
2013-06-05 21:33:43 +00:00
hosted at:
http://glyptodon.org/jira/
2013-06-05 21:33:43 +00:00