Im folgenden finden sie eine Anleitung, wie sie auf ihrem Linuxsystem unser Repository einrichten, damit sie über die Paketverwaltung von Debian, Ubuntu und allen anderen Betriebssystemen der der Debian-Familie unsere Pakete beziehen können.
Schritt 1: Voraussetzungen
- Sie benötigen einen Zugang zum root-Konto ihrer Linux-Installation, entweder direkt per root-Passwort oder per sudo/su.
- Die IServ-Module und Softwareverteilungspakete (winst-*) sind nur im Zusammenhang mit dem IServ-Portalserver der IServ GmbH nutzbar.
In dieser Anleitung wird aptitude verwendet, es muss eventuell erst durch Eingabe folgendes Befehls in einer Root-Shell installiert werden:
apt-get install aptitude
Schritt 2: Repository zu den Paketquellen hinzufügen
Ein Terminal öffnen oder per SSH auf dem Linux-System einloggen, dem das Repository hinzugefügt werden soll.
Falls man nicht als root direkt eingeloggt ist, zunächst per sudo zu root machen:
sudo su -l
sources-Eintrag für apt für das Repository mit folgenden Befehlen erstellen:
echo "deb https://repository.stsbl.de/debian stable main" > /etc/apt/sources.list.d/stsbl.list
echo "deb https://repository.stsbl.de/debian stable non-free" >> /etc/apt/sources.list.d/stsbl.list
echo "deb https://repository.stsbl.de/debian $(lsb_release -cs)-stable main" >> /etc/apt/sources.list.d/stsbl.list
echo "deb https://repository.stsbl.de/debian $(lsb_release -cs)-stable non-free" >> /etc/apt/sources.list.d/stsbl.list
Um das neue Repository dem System bekannt zu machen, muss nun der Cache mit folgenden Befehl aktualisiert werden:
aptitude update
Es wird eine Fehlermeldung auftreten, dass einzelne Paketquellen nicht verifiziert werden konnten, dies beheben wir im nächsten Schritt.
Schritt 3: Schlüsselbund installieren
Damit APT heruntergeladene Paketdateien überprüfen kann, muss nun der öffentliche Schlüssel installiert werden.
Zunächst lädt man den öffentlichen Schlüssel des Repositorys mit wget herunter:
wget -O stsbl.pub https://repository.stsbl.de/download/linux_signingkey.pub
Anschließend prüft man mit dem folgendem Befehl die SHA512-Summe des heruntergeladenen Schlüssels:
sha512sum stsbl.pub
Wenn die Ausgabe mit der unten stehenden übereinstimmt, ist der Schlüssel echt:
c4242fc8e90d95e27bdf8a501c9c8f27569d7d82cb686d707c808fcb12c8b5baf8375228403efd6aae220305dc311bdf151fe326a2ca34911902c86fa0e61d3b stsbl.pub
Der Schlüssel kann nach erfolgter Integritätsprüfung mit diesem Befehl zum APT-Schlüsselbund hinzugefügt werden:
apt-key add stsbl.pub
Nun müssen die Paketquellen erneut mit folgendem Befehl aktualisiert werden:
aptitude update
Anschließend muss das Schlüsselbund-Paket installiert werden, dieses sorgt dafür, dass der öffentliche Schlüssel des Repositorys automatisch durch einen neuen ersetzt wird, bevor er abläuft (alle vier Jahre):
aptitude install stsbl-keyring
Anschließend muss wie oben überprüft werden, ob die Installation des Schlüssels erfolgreich war, die Ausgabe des Befehls
apt-key list
muss folgendes enthalten:
/etc/apt/trusted.gpg.d/stsbl.gpg
--------------------------------
pub rsa2048 2017-10-04 [SC] [expired: 2019-10-04]
EDB8 501B F7C6 4065 CC71 DE73 FB13 1571 1C9E 3AC2
uid [ expired] StsBl Repository (Signing Key) <repository@stsbl.de>
pub rsa2048 2019-09-28 [SC] [expires: 2023-09-27]
ED88 A994 1E4A CE17 9E24 051F 4308 4C8B E41E 5C2B
uid [ unknown] StsBl Repository (Signing Key) <repository@stsbl.de>
pub rsa2048 2019-09-28 [SC] [expires: 2023-09-27]
539F 46F6 5793 A02A E3A2 E363 36DA A28D 8DA4 4F07
uid [ unknown] StsBl Repository (Signing Key) <repository@stsbl.de>
Schritt 4: Zugangsdaten eingeben und weitere Suiten hinzufügen
Für IServ-Server steht das Repository-Konfigurationsprogramm zur Verfügung, das ein grafisches Frontend zur Eingabe der Zugangsdaten zur Verfügung stellt. Um auf die Pakete mit lizenzpflichtiger Software für die IServ-Softwareverteilung zuzugreifen, ist das Konfigurationsprogramm erforderlich.
Wir empfehlen die Installation auf IServ-Servern immer durchzuführen, da das Konfigurationsprogramm sicherstellt, dass die Einbindung des Repositories immer mit aktuellen IServ-Versionen kompatibel bleibt. Ist nur der Zugriff auf die IServ-Module gewünscht, brauchen außer der Installation keine weiteren Schritte durchgeführt zu werden.
Dieses lässt sich mit folgenden Befehl installieren:
aptitude install stsbl-repoconfig
Die Handhabung dieses wird unter Repository-Konfigurationsprogramm beschrieben.
Falls Sie keinen IServ haben, sondern ein anderes Linux-System müssen statt der Installation des Repository-Konfigurationsprogramms folgende Schritte durchgeführt werden:
Falls man Zugangsdaten besitzt, muss man die Liste zunächst wieder leeren:
echo > /etc/apt/sources.list.d/stsbl.list
Falls sie spezielle Zugangsdaten haben, ersetzen sie in der nachfolgenden Anleitung <zugangsbenutzername> durch customer-<Ihre Zugangsnummer> und <zugangspasswort> durch das dazugehörige Passwort.
Fügen Sie mit folgendem Befehl, falls vorhanden die Zugangsdaten zur vorhin angelegten Paketquellliste hinzu:
echo "deb https://<zugangsbenutzername>:<zugangspasswort>@repository.stsbl.de/debian stable main non-free" >> /etc/apt/sources.list.d/stsbl.list
echo "deb https://<zugangsbenutzername>:<zugangspasswort>@repository.stsbl.de/debian stable main non-free" >> /etc/apt/sources.list.d/stsbl.list
Möchte man zusätzlich Vorabveröffentlichungen aus den Distributionen testing und unstable installieren, wiederholt man die beiden letzten Befehle, ersetzt das Wort stable aber durch ein testing bzw. unstable.
Siehe dazu auch: Dokumentation zum Update-Modus.
Schritt 5: Loslegen
Die Paketquelle ist nun fertig eingerichtet, die verfügbaren Pakete können nun über die Paketverwaltung des Systems installiert werden, zum Beispiel bei IServ über die Weboberfläche unter Verwaltung > System > Pakete.
Repository entfernen
Um das Repository wieder vom System zu entfernen, führt man folgende Befehle aus:
rm /etc/apt/sources.list.d/stsbl.list
aptitude purge stsbl-keyring
apt-key del 16974600
apt-key del 1C9E3AC2
apt-key del E41E5C2B
apt-key del 8DA44F07
aptitude update
Zusätzlich sollte man alle aus dem Repository installierten Pakete entfernen, da sie natürlich entsprechend keine Updates mehr erhalten können.
