Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende ÜberarbeitungNächste ÜberarbeitungBeide Seiten der Revision | ||
allgemein:guacamole_installation_test [2023/07/07 12:31 CEST] – sritter | allgemein:guacamole_installation [2023/07/17 16:26 CEST] – gelöscht - Externe Bearbeitung (Unbekanntes Datum) 127.0.0.1 | ||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
- | < | ||
- | <WRAP 800px> | ||
- | |||
- | # Apache Guacamole | ||
- | |||
- | Guacamole ist eine Art VNC-Proxy, den Sie entweder lokal kompilieren und installieren müssen oder mittels Docker in Containern betreiben können. Mit einem zusätzlichen bwLehrpool-Plugin können Sie dann über eine einfache Weboberfläche Ihre bwLehrpool-Clients per Webbrowser zugänglich machen (siehe auch [[allgemein: | ||
- | |||
- | Da Inbetriebnahme und Updates von Guacamole mit Docker deutlich einfacher und schneller als eine lokale Installation ist, beschränken wir uns hier auf die Containerlösung. | ||
- | |||
- | # Container Setup | ||
- | |||
- | Sie finden ein vorgefertigtes Docker-Compose File nebst README und Beispielen zur Konfiguration in unserem Git-Repository im Unterordner ' | ||
- | |||
- | *Beachten Sie, dass unter Linux Dateien die mit einem ' | ||
- | |||
- | Klonen Sie das Repository und kopieren als ersten Schritt die Konfigurationsdatei ' | ||
- | |||
- | ``` | ||
- | git clone https:// | ||
- | cd bwlp-guacamole-ext/ | ||
- | cp .env.example .env | ||
- | ``` | ||
- | |||
- | Editieren Sie dort mindestens IP/Hostname der Variablen ' | ||
- | |||
- | Für den LDAP-Login müssen Sie noch die notwendingen ' | ||
- | |||
- | **Optional: | ||
- | |||
- | Kopieren Sie als nächstes das für Ihre Guacamole Version passende ' | ||
- | Die aktuell zur Verfügung stehenden Plugins finden Sie unter https:// | ||
- | |||
- | Achten Sie darauf, dass immer **nur ein** bwlp-Plugin in diesem Ordner liegt! | ||
- | |||
- | Um die Container zu starten führen Sie abschließend einfach folgenden Befehl aus: | ||
- | |||
- | ``` | ||
- | docker compose up --build -d | ||
- | ``` | ||
- | |||
- | Um zu prüfen, ob die Container laufen bzw. um Logs zu inspizieren: | ||
- | ``` | ||
- | docker ps | ||
- | docker logs -f < | ||
- | ``` | ||
- | |||
- | ---- | ||
- | |||
- | Wenn Sie auf eine andere Guacamole-Version wechseln möchten, editieren Sie einfach wieder die .env-Datei und starten die Container mit folgendem Kommando neu: | ||
- | ``` | ||
- | docker compose up --build --force-recreate -d | ||
- | |||
- | ``` | ||
- | |||
- | |||
- | ## Apache Reverse Proxy einrichten | ||
- | |||
- | Sie sollten einen Reverse Webproxy verwenden, um einen verschlüsselten Zugriff auf die Weboberfläche zu ermöglichen. Wir verwenden im Beispiel den Webserver Apache. Aber auch nginx ist möglich. | ||
- | |||
- | Zunächst müssen Sie einige Module aktivieren. | ||
- | |||
- | ``` | ||
- | a2enmod rewrite | ||
- | a2enmod proxy_http | ||
- | a2enmod ssl | ||
- | a2enmod proxy_wstunnel | ||
- | ``` | ||
- | |||
- | Anschließend kopieren Sie folgenden Inhalt z.B. nach '/ | ||
- | |||
- | **IP (10.9.8.7)** und **FQDN (bwlehrpool-remote.hs-xyz.de)** sind Platzhalter und müssen entsprechend angepasst werden: | ||
- | |||
- | ``` | ||
- | < | ||
- | ServerName bwlehrpool-remote.hs-xyz.de | ||
- | ServerAdmin webmaster@test.de | ||
- | |||
- | RewriteEngine On | ||
- | RewriteCond %{HTTPS} !=on | ||
- | RewriteRule ^/?(.*) https:// | ||
- | </ | ||
- | |||
- | |||
- | < | ||
- | ServerName bwlehrpool-remote.hs-xyz.de | ||
- | ServerAdmin webmaster@test.de | ||
- | |||
- | SSLEngine on | ||
- | SSLProtocol All -SSLv2 -SSLv3 | ||
- | SSLCertificateFile / | ||
- | SSLCertificateKeyFile / | ||
- | | ||
- | RewriteEngine | ||
- | RewriteRule | ||
- | |||
- | ProxyPass / http:// | ||
- | ProxyPassReverse / http:// | ||
- | ProxyPassReverseCookiePath /guacamole / | ||
- | | ||
- | < | ||
- | Order allow,deny | ||
- | Allow from all | ||
- | ProxyPass ws:// | ||
- | ProxyPassReverse ws:// | ||
- | </ | ||
- | SetEnvIf Request_URI " | ||
- | CustomLog | ||
- | </ | ||
- | ``` | ||
- | |||
- | ``` | ||
- | # Selbst signiertes Zertifikat erstellen (besser Let's Encrypt oder korrektes Hochschulzertifikat verwenden) | ||
- | openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout / | ||
- | |||
- | # Seite aktivieren: | ||
- | a2ensite bwlehrpool-remote.conf | ||
- | |||
- | # Webserver neustarten | ||
- | systemctl restart apache2 | ||
- | ``` | ||
- | |||
- | |||
- | ## Problembehebung | ||
- | |||
- | Wenn nach dem Login an der Guacamole-Anmeldemaske keine Raumgruppen oder Clients angezeigt werden, kann evtl. die Liste vom Satellitenserver nicht abgerufen werden. | ||
- | |||
- | Prüfen Sie, ob der Wert der Variablen ' | ||
- | |||
- | Sie können zur Kontrolle die Metadaten des Satellitenservers direkt innerhalb des Guacamole-Containers abrufen. | ||
- | |||
- | ``` | ||
- | docker exec -it < | ||
- | curl -k -L -v https://< | ||
- | ``` | ||
- | |||
- | Dabei sollte eine json-Struktur herauskommen, | ||
- | |||
- | </ | ||
- | |||
- | |||
- | ## Lokale Installation (old-way) | ||
- | |||
- | Der Vollständigkeit halber finden Sie hier noch die alte Anleitung zur lokalen Installation. Diese wird derzeit jedoch nicht mehr gepflegt und wir empfehlen Ihnen die Nutzung der Docker Container. | ||
- | |||
- | ++++ Anleitung ausklappen | | ||
- | |||
- | # Aufsetzen eines Apache Guacamole Proxy | ||
- | |||
- | Um remote auf bwLehrpool-Clients zugreifen zu können ([Remotenutzung von bwLehrpool](https:// | ||
- | |||
- | In dieser Anleitung wird **Ubuntu 20.04.2 LTS** als Basis-OS genutzt und **Guacamole in der Version 1.3.0** verwendet. | ||
- | |||
- | Sie können Guacamole entweder direkt aus den Sources bauen und installieren oder alternativ in Docker-Containern bereitstellen. Zusätzlich wird ein Webserver benötigt (im Beispiel wird Apache verwendet). | ||
- | |||
- | ## Installation von Guacamole | ||
- | |||
- | - Installation benötigter Abhängigkeiten | ||
- | ``` | ||
- | apt install apache2 freerdp2-dev gcc libavcodec-dev libavformat-dev libavutil-dev libcairo2-dev libjpeg-turbo8-dev libossp-uuid-dev libpango1.0-dev libpng-dev libpulse-dev libssh2-1-dev libssl-dev libswscale-dev libtool-bin libvncserver-dev libvorbis-dev libwebp-dev libwebsockets-dev make tomcat9 | ||
- | ``` | ||
- | (Anmerkung: Das derzeit aktuelle Debian 11 „Bullseye“ beinhaltet kein libjpeg-turbo8-dev, | ||
- | |||
- | - Guacamole 1.3.0 herunterladen | ||
- | ````bash | ||
- | mkdir /usr/src && cd /usr/src | ||
- | wget https:// | ||
- | wget https:// | ||
- | wget https:// | ||
- | ```` | ||
- | |||
- | - Sources entpacken | ||
- | ```` | ||
- | tar xzf guacamole-server-1.3.0.tar.gz | ||
- | ```` | ||
- | |||
- | - Configure aufrufen | ||
- | ```` | ||
- | cd / | ||
- | ./configure --with-systemd-dir=/ | ||
- | ```` | ||
- | |||
- | - Die Ausgabe sollte bei korrekter Installation der Abhängigkeiten in etwa so aussehen: | ||
- | ````bash | ||
- | # | ||
- | guacamole-server version 1.3.0 | ||
- | # | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | pango ............... yes | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | Kubernetes .... yes | ||
- | RDP ........... yes | ||
- | SSH ........... yes | ||
- | Telnet ........ no | ||
- | VNC ........... yes | ||
- | | ||
- | | ||
- | | ||
- | guacd ...... yes | ||
- | guacenc .... yes | ||
- | guaclog .... yes | ||
- | | ||
- | | ||
- | Init scripts: no | ||
- | | ||
- | | ||
- | Type " | ||
- | | ||
- | ```` | ||
- | | ||
- | - Kompilieren und Installieren | ||
- | ```` | ||
- | make | ||
- | make install | ||
- | ldconfig | ||
- | ```` | ||
- | |||
- | - Guacamole Server Service | ||
- | ````bash | ||
- | systemctl enable guacd | ||
- | systemctl start guacd | ||
- | ```` | ||
- | |||
- | - GUACAMOLE_HOME anlegen und setzen | ||
- | |||
- | ````bash | ||
- | # GUACAMOLE_HOME dir anlegen | ||
- | mkdir / | ||
- | echo ' | ||
- | ```` | ||
- | |||
- | ### Guacamole-Client installieren und starten | ||
- | ````bash | ||
- | cp / | ||
- | |||
- | # Verlinke die Konfigurationsdateien | ||
- | ln -s / | ||
- | |||
- | # Service neustarten | ||
- | systemctl restart tomcat9.service | ||
- | systemctl restart guacd.service | ||
- | ```` | ||
- | |||
- | |||
- | ### LDAP-Plugin installieren | ||
- | |||
- | Authentifizieren via LDAP ermöglichen. | ||
- | |||
- | ````bash | ||
- | cd /usr/src/ | ||
- | tar xvzf guacamole-auth-ldap-1.3.0.tar.gz | ||
- | |||
- | # extensions Verzeichnis anlegen | ||
- | mkdir / | ||
- | cp / | ||
- | ```` | ||
- | |||
- | #### Update guacamole.properties für LDAP | ||
- | |||
- | Die Konfigurationsdatei guacamole.properties unter ``/ | ||
- | **Hinweis: | ||
- | |||
- | ````bash | ||
- | vi / | ||
- | ```` | ||
- | |||
- | ````properties | ||
- | # LDAP Einstellungen für Active Directory | ||
- | # IP-Adresse oder DNS-Name eines Domänencontrollers | ||
- | ldap-hostname: | ||
- | # Port Nummer von LDAP | ||
- | ldap-port: | ||
- | # Verschlüsslungsmethode für LDAP-Verbindung | ||
- | ldap-encryption-method: | ||
- | # DN des Benutzer der für die Abfrage genutzt werden | ||
- | ldap-user-base-dn: | ||
- | # Set searchbase to search for users in subtree | ||
- | ldap-search-bind-dn: | ||
- | # rename attribute name to cn (default: uid) | ||
- | ldap-username-attribute: | ||
- | ```` | ||
- | |||
- | [Guacamole LDAP - weitere Informationen](https:// | ||
- | |||
- | #### LDAP Cert installieren | ||
- | |||
- | Falls Ihr LDAP Server verschlüsselt kommuniziert, | ||
- | |||
- | ````bash | ||
- | # Copy your CA to dir / | ||
- | cp CERT.crt / | ||
- | |||
- | # Update CA Store: | ||
- | update-ca-certificates | ||
- | |||
- | # Tomcat neustarten | ||
- | systemctl restart tomcat9 | ||
- | ```` | ||
- | |||
- | ### BWLP-Plugin installieren | ||
- | |||
- | In diesem Schritt verknüpfen Sie Guacamole mit Ihrem Satellitenserver. Sie müssen dazu das aktuelle bwlp-guac-plugin herunterladen. | ||
- | |||
- | |||
- | **Achten Sie darauf, dass immer nur ein bwlp-Plugin verwendet wird! Löschen Sie ältere Pluginversionen, | ||
- | |||
- | |||
- | ````bash | ||
- | # Das aktuelle bwlp-plugin muss im Guacamole extensions Verzeichnis abgelegt werden | ||
- | cd / | ||
- | rm -i bwlp-guac*.jar | ||
- | wget https:// | ||
- | |||
- | # Um das Plugin mit dem bwLehrpool-Satellitenserver zu verbinden, folgende Zeile in '/ | ||
- | slx-client-list-url: | ||
- | ```` | ||
- | |||
- | Bitte fahren Sie zum Abschluß der Installation mit dem Punkt [„Apache Reverse Proxy einrichten“](# | ||
- | |||
- | ++++ | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||