Migration von OSS-3-4-2

Aus CEPHALIX/CRANIX

Migration von OSS 3.4.2 auf CRANIX-4

Bitte beachten Sie folgendes für die Migration: auch wenn der Prozess sorgfältig getestet wurde, können wir keine Garantie für die Übernahme aller Daten übernehmen. Der Migrations-Prozess kann nur Daten übernehmen, die von einem richtig gepflegten und aktualisierten OSS 3 stammen. Daten einer installierten Fremdsoftware oder OSS Daten, die von einer Fremdsoftware angepasst und angereichert wurden, können ggf. nicht korrekt übernommen werden. Wenn Sie in Ihrem OSS Fremdsoftware installiert haben, dann wird diese aller Voraussicht nach deinstalliert oder sie wird nicht mehr korrekt funktionieren. Aus der Umstellung zur Active-Directory Server Kompatibilität und der daraus resultierenden Notwendigkeit der Eindeutigkeit von Objekt-Namen, ergibt sich die Besonderheit, dass bei Benutzer, Gruppen und Workstation-Accounts mit identischen Namen nur das Benutzerkonto migriert wird. Die Daten der Gruppe bleiben dann zwar erhalten, die Gruppe selbst wird jedoch nicht migriert.

Die Windows-Benutzerprofile werden NICHT übernommen. Die Benutzer selbst müssen dafür Sorge tragen, dass sie vor der Migration alle wichtige Dateien in ihren Homeverzeichnisse speichern!

Portalseite wird NICHT übernommen. Der CRANIX-4 liefert keine eigene Portalseite wie der OSS-3 und bei der Migration per Neuinstallation wird die alte Portalseite nicht übernommen.

Drucker können nur dann übernommen werden, wenn dieser sowohl über die Adminoberfläche als auch in CUPS mit völlig identischen namen angelegt wurden. Damit solche Drucker in CRANIX-4 weiter verwaltet werden können, muss für die Geräte die Gerätekonfiguration nach der Migration über die Adminoberfläche auf 'Printer' gesetzt werden. Drucker die diese Schema nicht entsprechen, müssen vor der Migration gelöscht und neu angelegt werden.

Die Übernahme von Mailaccounts bzw. Mailservereinstellungen erfolgt nicht automatisch. Dieses bieten wir als zusätzliche Dienstleistung an. Sollten Sie hierbei Unterstützung benötigen, erstellen wir Ihnen gerne ein unverbindliches Angebot. Schreiben Sie uns einfach über: support@cephalix.eu an.

Es gibt 2 Möglichkeiten für die Migration von OSS-3.4.2 auf CRANIX-4 über ein Update per DVD oder über Neuinstallation und anschließende Import der Objekten. In beiden Fällen muss der Server bzw die Klients für die Migration vorbereitet werden. Das neueste Migrationspaket, Installationsmedium und das ClientSetup Programm befinden sich auf unserem Server: [1]

Die Migration von OSS 3.4.2 per Neuinstallation

  1. Installation der Migrationstools auf dem Server
    Bitte laden Sie die neueste Version von oss-migration-3-to-4 von unserem Repository-Server https://repo.cephalix.eu/Downloads herunter und installieren Sie diese auf dem Server:
    zypper install oss-migration-3-to-4-3.4-7.noarch.rpm
  2. Installation des neuen Klientprogrammes auf den Rechnern.
    Der CRANIX-4 verwaltet die Klientrechner mit dem SaltStack-Management-Software. Um die Umstellungsarbeiten zu erleichtern, haben wir ein Wpkg-Paket erstellt, womit man das neue Klientprogramm mit dem alten Softwarevertelungstool installiert werden kann. Laden Sie dazu das Programm Oss4UpdateClients aus der Kategorie "OSS4.0 prereq" herunter. Bevor Sie dieses Software nun allen Clients zuweisen und die Installation starten müssen Sie die Datei /srv/itool/swrepository/Oss4UpdateClients/install.ps1 anpassen und den Platzhalter "<<DOMAIN>>" durch ihren DNS-Domainnamen ersetzen: $name = ($env:COMPUTERNAME).ToLower() + ".rs-angels.haeven.edu". Nach dieser Anpassung müssen Sie dieses Paket allen Rechner zuweisen und die Softwareinstallation anstoßen. Erst nachdem das neue Programm auf den Clients installiert ist, sollten Sie mit der Migration vorfahren.
  3. Exportieren der Objekten
    Im Paket oss-migration-3-to-4 befindet sich ein Programm womit man die Objekten von OSS-3-4-2 in Dateien exportiert, die mit CRANIX-4 importiert werden können: /usr/sbin/oss_export-for-4-0.pl.
    Erstellen Sie ein Verzeichnis für die Importskripten:
    mkdir -p /home/migration/CRANIX-4
    Wechseln Sie in diese Verzeichnis
    cd /home/migration/CRANIX-4
    Führen Sie nun das Exportskrip aus:
    /usr/sbin/oss_export-for-4-0.pl
    Überprüfen Sie den Inhalt der Importdateien. Wichtig ist auch, dass die Importdateien auf eine Partition liegen, die bei der Installation nicht formatiert wird. Am besten ist es, wenn Sie ein Backup erstellen.
  4. Neuinstallation von CRANIX-4
    Sie können CRANIX-4 auf eine neue Hardware oder auch auf die selbe Hardware installieren. In letzterem Fall müssen Sie die manuelle Installation wählen und die Partitioniereung selber vornehmen. Dabei ist sehr wichtig, dass die Partition mit /home nicht formatiert wird.
    Möchten Sie die E-Mails auch übertragen, müssen Sie von den Verzeichnissen /var/lib/imap, /var/spool/imapund /var/lib/sieve ein Backup erstellen.
    Sie können während der Installation eine andere Domäne wählen, die Netzwerkkonfiguration soll jedoch erhalten bleiben, sonst können die exportierten Räumen und Geräten nicht importiert werden.
  5. Übertragung der Dateien
    Wurde der CRANIX-4 auf eine neue Hardware installiert, muss das /home/ vom alten Server auf den neuen Server übertragen werden. Verwenden Sie dazu das Tool rsync mit folgenden Parametern:
    rsync -aAv --exclude profile --exclude archiv /home/ <neuer-server>:/home/
  6. Importieren der Objekten
    Die Reihenfolge wie Sie die Importdateien einlesen ist sehr wichtig. Weichen Sie davon nicht ab!
  7. Importieren von Gerätekonfigurationen: Von der Kommandozeile mit folgendem Befehl: oss_api_post_file.sh clonetool/hwconf/import hwconfs.csv
  8. Importieren von Räumen: Von der Kommandozeile mit folgendem Befehl: oss_api_upload_file.sh rooms/import rooms.csv. Alternativ ober die Adminoberfläche: Netzwerk -> Räume -> Aktion-> Räume importieren rooms.csv
  9. Importieren von Benutzern: Die Benutzer müssen rollen weise von der Kommandozeile mit folgenden Befehl importiert werden:
    oss_import_user_list.py --role <role> --input /home/migration/CRANIX-4/<role>.csv.
    Wobei <role> mit den entsprechenden Rollen ersetzt werden soll. Bitte beachten Sie, das die Importdatei immer mit vollem absolutem Pfad angegeben werden muss. Alternativ können Sie das Import auch über die Adminoberfläche durchführen. Weiterhin muss beachtet werden, dass die so angelegten Benutzter neue Passwörter erhalten. Sie können jedoch mit Verwendung der Parameter --userpassword --mustchange dieses Verhalten beeinflussen. Die Importlisten befinden sich anschließend in /home/groups/SYSADMINS/userimports/.
  10. Importieren von Geräten: Von der Kommandozeile mit folgendem Befehl: oss_api_upload_file.sh devices/import devices.csv. Alternativ über die Adminoberfläche: Netzwerk -> Räume -> Aktion Geräte importieren devices.csv
  11. Anpassen von Filesystemrechten: Dazu müssen 2 Befehle ausgeführt werden:
    oss_reset_home.sh -a
    und "bash chown-users.sh" aus dem Verzeichnis aus, wo sich die Importdateien befinden.
  12. Importieren von Gruppen: Während der Anpassung der Dateisystemrechten kann die Datei groups.csv von der Kommandozeile mit folgendem Befehl eingelesen werden: oss_api_upload_file.sh groups/import groups.csv. Das geht auch über die Adminoberfläche: Administration -> Gruppen -> Aktion -> Gruppen importieren.

Die Migration von OSS 3.4.2 per Update

  1. Installation der Migrationstools auf dem Server
    Bitte laden Sie die neueste Version von oss-migration-3-to-4 von unserem Repository-Server http://repo.cephalix.eu/Downloads herunter und installieren Sie diese auf dem Server:
    zypper install oss-migration-3-to-4-3.4-7.noarch.rpm
  2. Installation des neuen Klientprogrammes auf den Rechnern.
    Der CRANIX-4 verwaltet die Klientrechner mit dem SaltStack-Management-Software. Um die Umstellungsarbeiten zu erleichtern, haben wir ein Wpkg-Paket erstellt, womit man das neue Klientprogramm mit dem alten Softwarevertelungstool installiert werden kann. Laden Sie dazu das Programm Oss4UpdateClients aus der Kategorie "OSS4.0 prereq" herunter. Bevor Sie dieses Software nun allen Clients zuweisen und die Installation starten müssen Sie die Datei /srv/itool/swrepository/Oss4UpdateClients/install.ps1 anpassen und den Platzhalter "<<DOMAIN>>" durch ihren DNS-Domainnamen ersetzen: $name = ($env:COMPUTERNAME).ToLower() + ".rs-angels.haeven.edu". Nach dieser Anpassung müssen Sie dieses Paket allen Rechner zuweisen und die Softwareinstallation anstoßen. Erst nachdem das neue Programm auf den Clients installiert ist, sollten Sie mit der Migration vorfahren.
  3. Vorbereitung der vorhandenen Daten auf dem alten OSS-Server
    Als erstes muss auf dem Server das Paket oss-migration-3-to-4 installiert werden. Dieses Paket liefert alle nötigen Skripte, die zur Vorbereitung der Migration nötig sind. Es ist dringend zu empfehlen ein Backup vom System durchzuführen. Die Vorbereitung zur Migration wird mit dem Skript: /usr/share/oss/oss-migration-3-to-4/migrate-to-4-0.sh gestartet. Dieses Skript muss als Benutzer root mit der vollen Pfadangabe ausgeführt werden.
  4. Update des Systems
    Dieser Schritt muss von einem CRANIX-4 Installationsmedium durchgeführt werden. Laden Sie das aktuelle CRANIX-4 DVD-Image herunter. Bei Bedarf muss dieses auf DVD gebrannt werden. Starten Sie das System von der erstellten DVD und wählen Sie aus dem Bootmenü Upgrade. Während des Upgradeprozesses werden einige Fragen gestellt, bzw. Hinweise gegeben, welche immer im positiven Sinne beantwortet werden müssen. Eine Ausnahme besteht dann, wenn eine Warnung während der Partitionierung angezeigt wird. In den meisten Fällen handelt es sich darum, dass in der Datei /etc/fstab einige Partitionen mit ihrem Kernel-Device-Namen eingetragen sind. Dies ist nicht zu empfehlen. Bitte brechen Sie in diesem Fall die Installation ab, starten Sie das alte System, und berichtigen Sie die Partitionierung mit dem "yast2 disk" Modul (Partitionierer).
  5. Einspielen von Daten
    Das Skript oss-prepare-migration.pl erstellt unter /home/archiv/migrate-to-4-0 einige Skripte, die zum Einspielen der Daten aus dem alten System nötig sind. Man startet das Einspielen der vorbereiteten Daten als Benutzer root mit dem Befehl /usr/share/oss/oss-migration-3-to-4/import-from-3-4.sh
  6. Nacharbeiten
    Während der Migration bleibt das root-Passwort ungeändert. Das Administrator-Passwort muss jedoch anschließend neu gesetzt und der Printserver in die Domäne aufgenommen werden:
 samba-tool user setpassword Administrator
 net ADS JOIN -s /etc/samba/smb-printserver.conf -U Administrator

Weiterhin müssen ggf. die Apache2 Kongigurationsdateien angepasst werden. Hier geht es in erster Linie um die Zugriffskontrolle. Bitte lesen Sie dazu: Apache-Update auf 2.4 von 2.2 Ob das erforderlich ist, sieht man daran ob apache2 gestartet werden konnte:

 systemctl status apache2
● apache2.service - The Apache Webserver
  Loaded: loaded (/usr/lib/systemd/system/apache2.service; enabled; vendor preset: disabled)
  Active: failed (Result: exit-code) since Do 2018-08-30 16:46:34 CEST; 3s ago
 Process: 13103 ExecStop=/usr/sbin/start_apache2 -DSYSTEMD -DFOREGROUND -k graceful-stop (code=exited, status=1/FAILURE)
 Process: 13093 ExecStart=/usr/sbin/start_apache2 -DSYSTEMD -DFOREGROUND -k start (code=exited, status=1/FAILURE)
Main PID: 13093 (code=exited, status=1/FAILURE)
Aug 30 16:46:34 admin systemd[1]: Starting The Apache Webserver...
Aug 30 16:46:34 admin start_apache2[13093]: AH00526: Syntax error on line 5 of /etc/apache2/vhosts.d/7IF2.group:
Aug 30 16:46:34 admin start_apache2[13093]: Invalid command 'Order', perhaps misspelled or defined by a module not included in the server configuration

WICHTIG Bitte beachten Sie folgende Hinweise:

  • Die Uhr des Servers muss genau eingestellt werden. Liegt die Systemzeit in der Zukunft, wird der Server nach dem Update nicht 100% betriebsfähig sein.
  • Es gibt keinen Weg zurück: Hat man das Mirgrationsskript gestartet, wird das System so umkonfiguriert, dass das alte System nicht mehr funktionsfähig ist.
  • Das Einspielen eines Backups von einem OSS 3.4.2 Systems ist NICHT möglich.
  • Je nach Anzahl der Benutzerkonten und Rechner brauchen Sie ca. 100MB freien Speicherplatz unter /home/archiv/. Das Skript /usr/share/oss/oss-migration-3-to-4/oss-prepare-migration.pl überprüft, ob genug Speicherplatz zur Verfügung steht. Ansonsten wird dieses nicht gestartet.
  • Es werden nur die, vom OpenSchoolServer-Team, per Update zur Verfügung gestellten Pakete aktualisiert. Haben Sie Pakete von Drittanbieter bezogen, werden diese höchstwahrscheinlich gelöscht.
  • Eine Migration per "zypper dup" von einer Online-Repository ist nicht möglich.
  • Während der Migration wird der Benutzer "admin" samt seine Daten in den Benutzer "Administrator" konvertiert. Dieser Benutzer ist nun der Domain-Hauptadministrator. Einen Benutzer "admin" gibt es im OSS 4.0 nicht.