====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