Version: GSB 7How-To: Durchführung von Wartungsfenstern
Der vorliegende Abschnitt ist Teil einer kleinen Sammlung von kurzen Anleitungen und Ansatzpunkten für die Arbeiten eines GSB 7.5 Administrators. Erfahrungen mit vorherigen GSB 7 Installationen werden vorausgesetzt. Diese Dokumente sollen den Betriebsverantwortlichen den Umstieg erleichtern
Contents1 Hintergrundwissen |
1 Hintergrundwissen
Der Prozess zur Durchführung eines Wartungsfensters ist konzeptionell gleich geblieben. Die bestehende Installation wird unter /opt/gsb/active<Zeitstempel> verschoben und steht dort als Fallback zur Verfügung.
An dieser Stelle werden daher die begleitenden Arbeiten im Rahmen eins "üblichen" Wartungsfensters skizziert
2 Ausgangssituation
Wir gehen von einer vollständigen Installation mit Redaktion-, Administration-, Master-, Replication-, Site- und Delivery-Servern aus. Eine neue Mandantenlieferung ist in Form einer Zip-Datei bereitgestellt worden.
Die Zip-Datei liegt z.B. an einer zentralen Stelle z.B. auf einem Share: /opt/gsb/share/Deployment/Platforms/<PLATTFORMNAME>/customers/
3 Update eines bestehenden Mandanten in einer neuen Version
3.1 Mandantenlieferung verteilen
Die Mandantenlieferung muss auf dem jeweiligen System im Verzeichnis /home/cmadmin/software/ entpackt werden. Es ergibt sich eine Verzeichnissturktur nach folgendem Schema:
3.2 Konfiguration anpassen
Damit die gewünschte Version eines Mandanten installiert wird, muss die Version unter /home/cmadmin/config/config eingetragen werden.
3.3 Deployment der Mandantlieferung
Bevor die nun verteilte Mandantenlieferung verteilt wird, muss der GSB gestoppt werden:
Das Deployment wird mit dem Befehl install-gsb ausgeführt. Der vorherige Stand wird unter /opt/gsb/active-<Zeitstempel> gesichert:
Nach dem Deployment kann der GSB wieder gestartet werden:
4 Lieferung eines weiteren Mandanten
4.1 Ausgangssituation
Der Content und die Rechte des neuen Mandanten sind im Contentserver importiert. Die Benutzer und Gruppen sind im LDAP der Redaktion importiert. Als neuer Mandant wird hier bespielhaft standardlsg betrachtet. DNS-Einträge und Zertifikate wurden bereits angelegt bzw. erweitert.
4.2 Konfiguration anpassen
4.2.1 Apache
Der neue Mandant muss mitsamt seiner gelieferten Version auf den Systemen in /home/cmadmin/config/config eingetragen werden:
Auf den Systemen mit einem Apache Webserver (normalerweise Staging/Referenz, Redaktion und Delivery) muss der Mandant in den Runtime-Properties bekannt gemacht werden. Dazu in /opt/gsb/runtime/Apache2/gsb.conf je nach Typ des Systems folgende Zeilen eintragen:
Desweiteren müssen die Hostnamen des Mandaten definiert werden. Diese müssen in /opt/gsb/runtime/Apache2/host.conf eigetragen werden:
4.2.2 Redaktion
Contentserver:
Werden die Benutzer des Mandanten im LDAP gepflegt, muss dies auch im Contentserver vermerkt werden. Hierfür in /opt/gsb/runtime/contentserver-preview-jaas.conf folgende Zeile vor die letzte schließende Klammer einfügen:
In /opt/gsb/runtime/content-server-preview.properties werden weitere LDAP-Konfigurationen benötigt. Die Konfiguration kann auf der Redaktion mit dem Skript ~/bin/create-ldap-config.sh erzeugt werden. Das Skript benötigt als ersten Parameter den Namen des neuen Mandanten. Als zweiter Parameter wird ein Index benötigt. Dieser ergibt sich aus /opt/gsb/runtime/content-server-preview.properties . Hier finden sich verschiedene Einträge beginnend mit cap.server.userproviders . Danach folgt eine Nummer. Hier die höchste Nummer in der Konfiguration ermitteln und 1 addieren. Dies ist der neue Index. Denkbar ist folgender Befehl:
Die Ausgabe des Skripts kann dann in /opt/gsb/runtime/content-server-preview.properties eingefügt werden.
Editor:
In der Redaktion muss der neue Mandant im Editor eingetragen werden. Dazu in /opt/gsb/runtime/editor-preview.properties die Liste der Mandanten erweitern:
Werden die Benutzer des Mandanten im LDAP gepflegt, muss dies auch im Editor vermerkt werden. Dazu in /opt/gsb/runtime/editor.properties folgende Liste erweitern:
Administration
In der Administration muss der Mandant ebenfalls eingetragen werden. Die Administration benötigt die Preview-Adresse des Mandanten. Dazu in /opt/gsb/runtime/administration.properties folgende Anpassungen vornehmen:
Wenn diese Konfigurationen vorgenommen wurde, kann wie in einem normalen Wartungsfenster weiter verfahren werden.
Workflowserver
Es müssen die Workflows für den Mandanten hochgeladen werden. Dafür werden zwei Hilfsscripte in /opt/gsb/active/infrastructure/workflowserver mitgliefert. Die Scripte müssen im Ordner /opt/gsb/active/infrastructure/workflow-server ausgeführt werden.
Das Script prepareStartworfklow.sh benötigt als Parameter eine Liste der hinzuzufügenden Mandanten mit ihren Domains. Anschließend können die Workflows mit dem Script uploadWorkflows.sh in den Workflowserver hochgeladen werden.
