guacamole
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
guacamole [2018/12/06 20:00] abeverley |
guacamole [2018/12/06 20:04] (current) abeverley |
||
|---|---|---|---|
| Line 9: | Line 9: | ||
| These brief instructions show how to set up Guacamole on a remote server, so that it can be used as a demo machine, controllable and viewable by anyone with a web browser. I use this to perform remote demonstrations of web-based software. The instructions assume that a Debian Jessie system is used, with Apache already installed. | These brief instructions show how to set up Guacamole on a remote server, so that it can be used as a demo machine, controllable and viewable by anyone with a web browser. I use this to perform remote demonstrations of web-based software. The instructions assume that a Debian Jessie system is used, with Apache already installed. | ||
| - | * Install required packages: | + | * Install required packages: |
| - | ''%% apt-get install xfce4 chromium guacamole-tomcat x11vnc xrdp libguac-client-rdp0%%'' | + | ''apt-get install xfce4 chromium guacamole-tomcat x11vnc xrdp libguac-client-rdp0'' |
| - | * Configure Apache as a proxy to Tomcat (and Guacamole) | + | * Configure Apache as a proxy to Tomcat (and Guacamole) |
| - | <html><VirtualHost _default_:443></html>\\ | + | <VirtualHost _default_:443> |
| - | ''%% ProxyPass / %%''[[http://localhost:8080/guacamole/|''%%http://localhost:8080/guacamole/%%'']]''%% flushpackets=on%%''\\ | + | ProxyPass / http://localhost:8080/guacamole/ flushpackets=on |
| - | ''%% ProxyPassReverse / %%''[[http://localhost:8080/guacamole/|''%%http://localhost:8080/guacamole/%%'']]\\ | + | ProxyPassReverse / http://localhost:8080/guacamole/ |
| - | ''%% ProxyPassReverseCookiePath /guacamole/ /%%''\\ | + | ProxyPassReverseCookiePath /guacamole/ / |
| - | ''%% SSLEngine on%%''\\ | + | SSLEngine on |
| - | ''%% SSLCertificateFile /etc/ssl/certs/mycert.pem%%''\\ | + | SSLCertificateFile /etc/ssl/certs/mycert.pem |
| - | ''%% SSLCertificateKeyFile /etc/ssl/private/mykey.key%%''\\ | + | SSLCertificateKeyFile /etc/ssl/private/mykey.key |
| - | <html></VirtualHost></html> | + | </VirtualHost> |
| * Add an RDP user to the Guacamole user config (/etc/guacamole/user-mapping.xml) | * Add an RDP user to the Guacamole user config (/etc/guacamole/user-mapping.xml) | ||
| - | <html><authorize username="myuser" password="mypass"></html>\\ | + | <authorize username="myuser" password="mypass"> |
| - | ''%% %%''<html><protocol></html>''%%rdp%%''<html></protocol></html>\\ | + | <protocol>rdp</protocol> |
| - | ''%% %%''<html><param name="hostname"></html>''%%localhost%%''<html></param></html>\\ | + | <param name="hostname">localhost</param> |
| - | ''%% %%''<html><param name="port"></html>''%%3389%%''<html></param></html>\\ | + | <param name="port">3389</param> |
| - | ''%% %%''<html><param name="password"></html>''%%rdp_pass%%''<html></param></html>\\ | + | <param name="password">rdp_pass</param> |
| - | <html></authorize></html> | + | </authorize> |
| Edit a connection to /etc/xrdp/xrdp.ini | Edit a connection to /etc/xrdp/xrdp.ini | ||
| - | ''%%[xrdp0]%%''\\ | + | [xrdp0] |
| - | ''%%name=My connection%%''\\ | + | name=My connection |
| - | ''%%lib=libvnc.so%%''\\ | + | lib=libvnc.so |
| - | ''%%username=%%''\\ | + | username= |
| - | ''%%password=vnc_pass # or "ask"%%''\\ | + | password=vnc_pass # or "ask" |
| - | ''%%ip=127.0.0.1%%''\\ | + | ip=127.0.0.1 |
| - | ''%%port=5900%%'' | + | port=5900 |
| ''%%systemctl restart xrdp.service%%'' | ''%%systemctl restart xrdp.service%%'' | ||
| Line 55: | Line 55: | ||
| If running Debian Stretch, then also instal xserver-xorg-legacy: | If running Debian Stretch, then also instal xserver-xorg-legacy: | ||
| - | ''%%# Fixes the following error:%%''\\ | + | # Fixes the following error: |
| - | ''%%# parse_vt_settings: Cannot open /dev/tty0 (Permission denied)%%''\\ | + | # parse_vt_settings: Cannot open /dev/tty0 (Permission denied) |
| - | ''%%apt-get install xserver-xorg-legacy%%'' | + | apt-get install xserver-xorg-legacy |
| Change to the normal user and start the required X services: | Change to the normal user and start the required X services: | ||
| - | ''%%su andrew%%''\\ | + | su andrew |
| - | ''%%x11vnc -storepasswd # As configured in /etc/xrdp/xrdp.ini%%''\\ | + | x11vnc -storepasswd # As configured in /etc/xrdp/xrdp.ini |
| - | ''%%startx &%%''\\ | + | startx & |
| - | ''%%x11vnc -noncache -usepw -display :0 -rfbport 5900 -shared%%'' | + | x11vnc -noncache -usepw -display :0 -rfbport 5900 -shared |
| It should now be possible to browse to the site configured in Apache, login to Guacamole, and see a standard XFCE desktop. Chromium (or Iceweasal/Firefox) can be launched from the applications menu. | It should now be possible to browse to the site configured in Apache, login to Guacamole, and see a standard XFCE desktop. Chromium (or Iceweasal/Firefox) can be launched from the applications menu. | ||
guacamole.1544126426.txt.gz · Last modified: 2018/12/06 20:00 by abeverley
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International
