====== Installation ======

Zurück zur [[start|Startseite]]

===== Linux und macOS =====

Der ganze Installationsvorgang kann mit dem Skript ''TagungInstall.sh'' durchgeführt werden. Dieses Skript verschicke ich bei Bedarf per eMail. Das Skript macht allerdings auch nichts anderes als was im Folgenden beschrieben ist.


==== Python ====

In aller Regel ist auf Linux-Systemen Python 3 installiert. Falls nicht, muss man es über die üblichen Repositories nachholen. Unter Umständen muss man zusätzlich ''python3-venv'' installieren.

**Unter macOS ist das Programm bisher nicht getestet. In jedem Fall muss Python 3 installiert werden, evt. zusätzlich die Bibliothek ''venv'' für Virtuelle Umgebungen (Virtual Environments).**


==== Virtual Environment ====

Es wird dringend empfohlen (und im Folgenden vorausgesetzt), die GUI innerhalb einer Virtuellen Umgebung laufen zu lassen. Dafür:

1. Ein Verzeichnis für die GUI anlegen, z.B.

<code>
mkdir Tagung'
</code>

2. Dort eine virtuelle Umgebung anlegen:

<code>
cd Tagung
python3 -m venv .venv
</code>

Damit wird innerhalb des Verzeichnisses ''Tagung'' eine Virtuelle Umgebung namens ''.venv'' angelegt.

3. Die Virtuelle Umgebung aktivieren:

<code>
source .venv/bin/activate
</code>

4. Nach Beendigung der Arbeit die Virtuelle Umgebung deaktivieren:
<code>
deactivate
</code>


==== ug_tagung installieren ====

Dafür wechseln wir wieder in die Virtuelle Umgebung und installieren das Paket dort:

1. In das Verzeichnis wechseln:  
<code>
cd Tagung
</code>

2. Die Virtuelle Umgebung aktivieren:

<code>
source .venv/bin/activate
</code>

3. Das Paket ''ug_tagung'' installieren:

<code>
pip install ug_tagung
</code>

4. Das Programm einmalig im Setup-Modus laufen lassen:

<code>
python -m ug_tagung.Tagung --setup
</code>

5. Es sollten nun einige Dateien in das aktuelle Verzeichnis kopiert worden sein. Darunter die beiden Skripte ''TagungStart.sh'' und ''TagungUpgrade.sh''.

6. Diese beiden Skripte ausführbar machen, etwa mit

<code>
chmod a+x TagungStart.sh TagungUpgrade.sh
</code>

7. Die Virtuelle Umgebung deaktivieren:

<code>
deactivate
</code>


==== Starter ====

Optional können, wenn man die GUI später per Mausklick ausführen möchte, für die beiden genannten Skripte Starter angelegt werden, einen für ''TagungStart.sh'' und einen für ''TagungUpgrade.sh''. Mit dem ersten wird später die GUI gestartet, mit dem anderen werden - falls verfügbar - Upgrades installiert.

In beiden Fällen muss das Arbeitsverzeichnis angegeben werden, etwa "Ausführen in:" Dort ist etwa ''/home/.../Tagung'' anzugeben. In beiden Fällen sollte, wenn die Option besteht, etwa "Im Terminal ausführen" aktiviert werden.


===== Windows =====

Unter Windows ist der Installationsvorgang etwas holperig - finde ich...


==== Python ====

Python3 sollte über ...


==== Powershell ====

In der Powershell können Skripte nicht ohne weiteres ausgeführt werden. Das verhindert ein Schutzmechanismus von Windows.

Um es doch zu ermöglichen, ist z.B. folgendes zu machen, um den "Executionpolicy" anzupassen:

  - Powershell als Administrator öffnen (das geht über das Startmenü, dort "Powershell" eingeben und dann un ter den Optionen "Öffnen als Administrator" wählen.
  - Mit ''get-executionpolicy'' überprüfen, wie die Einstellung aktuell ist. Es sollte i.d.R. ''Restricted'' eingestellt sein.
  - Mit ''set-executionpolicy unrestricted'' den Wert anpassen. Damit ermöglicht man, alle ''.ps1'' Skripte auszuführen.
  - Powershell als normaler Benutzer öffnen.
  - Start-Skript ausführen. Nun sollte es laufen.


==== Starter z.B. auf dem Desktop ====

Zunächst muss dafür gesorgt werden, dass ''.ps1''-Sktipte per Mausklick nicht mit dem Editor, sondern mit der Powershell geöffnet werden.

Dafür:
  - Rechtsklick auf das Powershell-Skript.
  - ''Öffnen mit...''
  - ''Andere App auswählen''
  - ''Wählen Sie eine App auf Ihrem PC aus''
  - ''C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe''
  - Je nach Wunsch die Powershell für alle ''.ps1'' Skripte aktivieren.

Nun sollte das Skript mit einem Mausklick (Doppelklick) gestartet werden.

Dann kann man - je nach Bedarf - auch noch einen Starter auf den Desktop oder sonst wohin bringen. Dafür legt man z.B. per Rechtsklick auf das Start-Skript ein Verknüpfung an, verschiebt diese dann auf den Desktop und benennt sie dort sinnvoll um.