Gunther Oracle APEX und Datenbank Wiki

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====Session Recording in Apache Guacamole====

Nach der Installation (siehe [[linux:oracle_linux_8_guacamole|Eine Oracle System Umgebung mit Apache Guacamole auf Oracle Linux 8.7 verwalten]] können die erweiterten Funktionen wie das Aufzeichnen einer Session von Guacamole konfiguriert werden.

===Aufgabe: Aufzeichnen der Sessions===

Wie in der Anleitung für die Installation beschreiben müssen dazu bereits bei der Installation die entsprechenden Libraries auf der Maschine hinterlegt werden, um die Optionen beim Übersetzen des **guacd** auch zu aktiveren und es muss das Plugin dazu hinterlegt werden.


=== Vorbereitung ===

Verzeichnis für die Daten mit den richtigen Rechten anlegen (der **guacd** Prozess muss die Daten schreiben können und der Tomcat wieder lesen) anlegen:

<code bash>

mkdir -p /daten/guacamole_recording

chown -R guacd:tomcat /daten/guacamole_recording/

chmod 2750 /daten/guacamole_recording/

</code>

==Plugin hinterlegen==


<code bash>

cd /srv/guacamole_source
mkdir ex
 
cd ex
 
wget https://downloads.apache.org/guacamole/1.5.0/binary/guacamole-history-recording-storage-1.5.0.tar.gz  
 
tar -xvf guacamole-history-recording-storage-1.5.0.tar.gz  
 
cd /srv/guacamole_source/ex/guacamole-history-recording-storage-1.5.0/
 
# Adapter hinterlegen
 
cp guacamole-history-recording-storage-1.5.0.jar  /etc/guacamole/extensions/
</code>



----

==== Aufzeichnen SSH Session mit Typescript ====


=== Aufzeichnen konfigurieren ===

Wichtig für das Aufzeichen sind die folgenden Parameter in der guacamole.properties:

vi /etc/guacamole/guacamole.properties:
<code bash>
#Recording Settings
recording-search-path:  /daten/guacamole_recording
</code>

Danach Tomcat neu starten:
<code bash>
 systemctl stop tomcat.service
 systemctl start tomcat.service
</code>


Im Tomcat Log prüfen ob der Adpater auch gefunden wurden:
<code bash>

cd /srv/tomcat/config/logs

grep Recording  catalina.out

18:51:59.910 [main] INFO  o.a.g.extension.ExtensionModule -  - [recording-storage] "Session Recording Storage" (/etc/guacamole/extensions/guacamole-history-recording-storage-1.5.0.jar)
18:52:00.972 [main] INFO  o.a.g.extension.ExtensionModule - Extension "Session Recording Storage" (recording-storage) loaded.

</code>

----


=== Session Konfiguration ===

In der Session Konfiguration kann dann mit ${HISTORY_PATH} auf dieses Verzeichnis referenziert werden. 

Nach etwas Test fand ich die folgenden Einstellungen am geeignetsten:

  * Typescript path:  ${HISTORY_PATH}/${HISTORY_UUID}
  * Typescript name:  <leer lassen>
  * Automatically create typescript path: <anhacken>

{{ :linux:guacamole_typescript_recording_settings.png?300 | Typescript Recording Settings Guacamole}}


----
=== In der Console abspielen ===


In der Console abspielen mit "scriptreplay":

<code bash>

cd /daten/guacamole_recording/<session_id>/

scriptreplay  typescript.timing typescript

</code>




----


=== Im Browser anzeigen ===


Leider ist es mir bisher noch nicht gelungen das Ergebnis im Browser aufzurufen, trotz einiger Tests bleibt die Spalte "Log" in der Historie leer.

<note important>Demnächst mehr</note>


----



==== Quellen ====


Doku:
  * https://guacamole.apache.org/doc/gug/recording-playback.html