Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
allgemein:guacamole_installation [2023/07/17 16:26 CEST] – ↷ Seitename wurde von allgemein:guacamole_installation_test auf allgemein:guacamole_installation geändert sritterallgemein:guacamole_installation [2023/11/03 13:42 CET] (aktuell) sritter
Zeile 114: Zeile 114:
 Um remote auf bwLehrpool-Clients zugreifen zu können ([Remotenutzung von bwLehrpool](https://www.bwlehrpool.de/doku.php/allgemein/remotenutzung_von_bwlehrpool)), benötigen Sie einen [Apache Guacamole](https://guacamole.apache.org)-Server. Um remote auf bwLehrpool-Clients zugreifen zu können ([Remotenutzung von bwLehrpool](https://www.bwlehrpool.de/doku.php/allgemein/remotenutzung_von_bwlehrpool)), benötigen Sie einen [Apache Guacamole](https://guacamole.apache.org)-Server.
  
-In dieser Anleitung wird **Ubuntu 20.04.2 LTS** als Basis-OS genutzt und **Guacamole in der Version 1.3.0** verwendet.+In dieser Anleitung wird **Ubuntu 20.04.2 LTS** als Basis-OS genutzt und **Guacamole in der Version 1.5.3** 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). 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).
Zeile 126: Zeile 126:
 (Anmerkung: Das derzeit aktuelle Debian 11 „Bullseye“ beinhaltet kein libjpeg-turbo8-dev, jedoch libjpeg62-turbo-dev.) (Anmerkung: Das derzeit aktuelle Debian 11 „Bullseye“ beinhaltet kein libjpeg-turbo8-dev, jedoch libjpeg62-turbo-dev.)
  
-- Guacamole 1.3.herunterladen  +- Guacamole 1.5.herunterladen  
   ````bash   ````bash
-  mkdir /usr/src && cd /usr/src +  VER=1.5.3 
-  wget https://dlcdn.apache.org/guacamole/1.3.0/binary/guacamole-1.3.0.war +  mkdir -p /usr/src && cd /usr/src 
-  wget https://dlcdn.apache.org/guacamole/1.3.0/binary/guacamole-auth-ldap-1.3.0.tar.gz +  wget https://dlcdn.apache.org/guacamole/$VER/binary/guacamole-$VER.war 
-  wget https://dlcdn.apache.org/guacamole/1.3.0/source/guacamole-server-1.3.0.tar.gz+  wget https://dlcdn.apache.org/guacamole/$VER/binary/guacamole-auth-ldap-$VER.tar.gz 
 +  wget https://dlcdn.apache.org/guacamole/$VER/source/guacamole-server-$VER.tar.gz
   ````   ````
  
-- Sources entpacken  +- Sources entpacken und Configure aufrufen
   ````   ````
-  tar xzf guacamole-server-1.3.0.tar.gz +  tar xzf guacamole-server-$VER.tar.gz 
-  ```` +  cd /usr/src/guacamole-server-$VER
- +
-- Configure aufrufen +
-  ```` +
-  cd /usr/src/guacamole-server-1.3.0+
   ./configure --with-systemd-dir=/etc/systemd/system     ./configure --with-systemd-dir=/etc/systemd/system  
   ````   ````
Zeile 148: Zeile 145:
   ````bash   ````bash
   #------------------------------------------------   #------------------------------------------------
-  guacamole-server version 1.3.0+  guacamole-server version 1.5.3
   #------------------------------------------------   #------------------------------------------------
      
Zeile 196: Zeile 193:
     make install     make install
     ldconfig     ldconfig
-  ```` 
- 
-- Guacamole Server Service   
-  ````bash 
-  systemctl enable guacd 
-  systemctl start guacd 
   ````   ````
  
Zeile 210: Zeile 201:
   mkdir /etc/guacamole   mkdir /etc/guacamole
   echo 'GUACAMOLE_HOME="/etc/guacamole"' >> /etc/environment   echo 'GUACAMOLE_HOME="/etc/guacamole"' >> /etc/environment
 +  ````
 +  
 +- Guacamole Server Service  
 +  ````bash
 +  systemctl --now enable guacd
   ````   ````
  
 ### Guacamole-Client installieren und starten ### Guacamole-Client installieren und starten
   ````bash   ````bash
-  cp /usr/src/guacamole-1.3.0.war /var/lib/tomcat9/webapps/guacamole.war+  cp /usr/src/guacamole-$VER.war /var/lib/tomcat9/webapps/guacamole.war
  
   # Verlinke die Konfigurationsdateien    # Verlinke die Konfigurationsdateien 
   ln -s /etc/guacamole /usr/share/tomcat9/.guacamole   ln -s /etc/guacamole /usr/share/tomcat9/.guacamole
  
 +  # Service neustarten
 +  systemctl restart tomcat9.service
 +  systemctl restart guacd.service
 +  ````
 + 
 +### GUACD konfigurieren 
 +  
 +  Unter Umständen lauscht guacd fälschlicherweise ausschließlich auf IPv6, während Tomcat sich mit IPv4 zu verbinden versucht. Sie können das mittels 'ss -plunt' bzw 'netstat -plunt' prüfen. 
 +  
 +  ````
 +  Ergänzen Sie '/etc/guacamole/guacamole.properties' mit folgender Zeile:
 +  guacd-hostname: 127.0.0.1
 +
 +  Erstellen Sie die Datei /etc/guacamole/guacd.conf mit folgendem Inhalt:
 +  [server]
 +  bind_host = 127.0.0.1
 +  bind_port = 4822
 +
 +  Nehmen Sie explizit '127.0.0.1' und nicht 'localhost'.
 +  
   # Service neustarten   # Service neustarten
   systemctl restart tomcat9.service   systemctl restart tomcat9.service
Zeile 231: Zeile 247:
 ````bash ````bash
 cd /usr/src/ cd /usr/src/
-tar xvzf guacamole-auth-ldap-1.3.0.tar.gz+tar xvzf guacamole-auth-ldap-$VER.tar.gz
  
 # extensions Verzeichnis anlegen # extensions Verzeichnis anlegen
 mkdir /etc/guacamole/extensions mkdir /etc/guacamole/extensions
-cp /usr/src/guacamole-auth-ldap-1.3.0/guacamole-auth-ldap-1.3.0.jar /etc/guacamole/extensions/+cp /usr/src/guacamole-auth-ldap-$VER/guacamole-auth-ldap-$VER.jar /etc/guacamole/extensions/
 ```` ````
  
Zeile 292: Zeile 308:
 cd /etc/guacamole/extensions/ cd /etc/guacamole/extensions/
 rm -i bwlp-guac*.jar rm -i bwlp-guac*.jar
-wget https://files.bwlp.ks.uni-freiburg.de/satellit/guacamole/bwlp-guac-1.3.1-SNAPSHOT.jar+wget https://files.bwlp.ks.uni-freiburg.de/satellit/guacamole/bwlp-guac-1.5.0-SNAPSHOT.jar
  
-# Um das Plugin mit dem bwLehrpool-Satellitenserver zu verbinden, folgende Zeile in '/etc/guacamole/guacamole.properties' einfügen:+# Um das Plugin mit dem bwLehrpool-Satellitenserver zu verbinden, folgende Zeile in '/etc/guacamole/guacamole.properties' einfügen (**<SAT-IP> anpassen**):
 slx-client-list-url: https://<SAT-IP>/slx-admin/api.php?do=remoteaccess slx-client-list-url: https://<SAT-IP>/slx-admin/api.php?do=remoteaccess
 ```` ````
 +
  
 Bitte fahren Sie zum Abschluß der Installation mit dem Punkt [„Apache Reverse Proxy einrichten“](#apache_reverse_proxy_einrichten) fort. Bitte fahren Sie zum Abschluß der Installation mit dem Punkt [„Apache Reverse Proxy einrichten“](#apache_reverse_proxy_einrichten) fort.
Drucken/exportieren