= Workstation Installationsanleitung =

{i} Diese Seite ist ist Teil der [[Dokumentation|Technischen Dokumentation]] von Radio Helsinki. Alle weiteren Seiten der Dokumentation:
<<Navigation(siblings, 1)>>

== Vorbereitung / Anforderungen ==

 * Ansible Repo auschecken
 * Folgende Pakete werden benötigt:
  * xorriso
  * python3-passlib
  * jq
  * ansible
   * Paketquelle hinzufügen:
{{{
# sudo add-apt-repository ppa:ansible/ansible
# sudo apt update
# sudo apt install ansible
}}}

 * Funktionsfähigkeit testen z.B. mit (fragt nach PGP-Key-Passphrase):
{{{
% ansible-vault view group_vars/workstations/vault.yml
}}}

== Nur 1 Workstation installieren ==

 * USB-Stick-Installer erstellen:
{{{
% ./ws-install.sh ws-xy
}}}
 * Fragt nach PGP-Key-Passphrase
 * und nach dem device pfad des USB-Sticks (z.b. /dev/sda)
  * Wie prüfen:
{{{
% lsblk
}}}
oder
{{{
% sudo dmesg -w
}}}
und USB-Stick anstecken

 * Wenn das ISO-Image fertig runtergeladen bzw. im Ordner .cache verifiziert wurde liefert ansible den ddrescue-Befehl zum USB-Stick generieren
 * '''Ansible nicht unterbrechen!!!''' In anderem Terminal ausführen. Z.b.:
{{{
% sudo ddrescue /home/user/ansible/.cache/ubuntu-installer/ubuntu-noble/24.04.3-live-server/ubuntu-24.04.3-live-server-amd64.iso /dev/sda -D --force
}}}
 * Wenn ddrescue fertig ist, dann [ENTER] im Ansible-Terminal
 * Wenn fertig USB-Stick unmounten & abziehen ('''Ansible nicht abbrechen!!!''')
 * Workstation mit USB-Stick booten
 * Wenn der Login-Screen auftaucht weiter in Ansible mit [ENTER]
  * Falls Skript abbricht:
{{{
% ./run-host-playbook.sh ws-08
}}}
 * Wenn das Playbook fertig ist, Workstation rebooten -> '''fertig'''

== Mehrere Workstations installieren ==

{{{
% ./usb-generate.sh <hostnames> <distro> <codename>
}}}

Stand 26.09.2025:

{{{
% ./usb-generate.sh workstations ubuntu noble
}}}

 * Workstation mit USB-Stick Booten
 * Im Bootmenü die entsprechende Workstation auswählen
 * Wenn der Login-Screen auftaucht: 

{{{
% ./run-host-playbook.sh ws-xy
}}}

== ws-vp ==

Wegen Soundkarten-Konfiguration bricht das Playbook ab -> rebooten -> Playbook noch mal laufen lassen. Plus Standard-Reboot danach.