Wiederherstellung

Parent page: Altium On-Prem Enterprise Server mit Oracle-Backend

Dieses Dokument richtet sich an einen IT-Administrator, der die Daten seines Altium On-Prem Enterprise Server wiederherstellt, wenn der Enterprise Server ein Oracle-Datenbank-Backend verwendet. Es enthält Details zum Enterprise Server, zum Wiederherstellungsverfahren im Kontext der Verwendung von Oracle, wichtige Informationen zu den Systemanforderungen sowie ein Beispiel zur Datenwiederherstellung auf der Microsoft-Windows-Plattform.

Überblick über den Wiederherstellungsprozess

Die Wiederherstellung des Enterprise Server bei Verwendung eines Oracle-Backends hängt davon ab, wie Ihr Unternehmen seine Oracle-Datenbanken verwaltet. Einige Unternehmen betreiben Oracle-Datenbanken auf Windows-Server-Betriebssystemen, während andere über vollständige Oracle-Rechenzentren verfügen. Der Wiederherstellungsprozess umfasst typischerweise drei Schritte, wie in der folgenden Abbildung dargestellt.

Überblick über das Wiederherstellungsverfahren für Enterprise Server und Oracle-Datenbank auf hoher Ebene.

In diesem Dokument getroffene Annahmen

Obwohl Oracle-Konfigurationen von Standort zu Standort variieren können, werden in diesem Dokument die folgenden Annahmen getroffen:

1. Eine vollständige Sicherung der Enterprise-Server-Daten und des zugehörigen Oracle-Datendumps wurde wie im Dokument Sichern von Altium On-Prem Enterprise Server mit einem Oracle-Backend beschrieben durchgeführt.
2. Die Wiederherstellung wird von einem IT-Administrator durchgeführt. Mindestens sollte der Benutzer, der die Wiederherstellung des Enterprise Server durchführt, über Administratorrechte auf dem Host-Rechner verfügen.
3. Ein Datenbankadministrator (DBA) sollte anwesend sein, um den Import der Oracle-Daten durchzuführen. Mindestens sollte der Benutzer, der dieser Anleitung folgt, vollständigen Lese-/Schreibzugriff haben, um die Oracle-Datenbank des Unternehmens zu importieren und zu ändern.
4. Diese Anleitung setzt voraus, dass bereits eine Installation des Enterprise Server vorhanden ist, die konfiguriert ist und mit einem Oracle-Backend funktioniert. (Weitere Details dazu, wie eine Umgebung zu handhaben ist, in der ein neuer Enterprise Server auf einem Rechner bereitgestellt und Daten in diese Enterprise-Server-Instanz importiert werden, finden Sie im Beispielabschnitt).
5. Das Oracle-Schema und die Oracle-Anmeldedaten der Anwendung, die auf den Quell- und Ziel-Oracle-Servern verwendet werden, müssen identisch sein.

Überblick über die Architektur des Enterprise Server auf hoher Ebene

Ähnlich wie andere Software, die für die Ausführung unter Microsoft Windows entwickelt wurde, ist der Enterprise Server eine Multi-Thread- und Multi-Service-Serveranwendung. Da sich dieses Dokument ausschließlich auf Teile des Enterprise Server konzentriert, die mit einer Oracle-Datenbank interagieren können, ist die folgende Abbildung vereinfacht dargestellt, um die gesamte Backend-Architektur des Enterprise Server zu repräsentieren.

Überblick über die Architektur des Enterprise Server auf hoher Ebene. Die Backend Storages des Enterprise Server enthalten den Großteil der binären Kundendaten, während die Windows Services eine Sammlung unterstützender Dienste sind.

Dieses Dokument konzentriert sich auf die Backend Storages, da die Daten innerhalb dieses Blocks gesichert, möglicherweise auf einen anderen Rechner migriert und dann entweder auf demselben oder auf einem anderen Rechner wiederhergestellt werden. Innerhalb der Backend Storages befinden sich die folgenden Elemente:

• Databases – enthält Metadaten wie die Zuordnung von Komponenten-Footprints und Schaltplansymbolen, Parameter, Dateipfade, Links zu Datenquellen der Komponenten-Lieferkette und mehr. Diese Informationen können sich in einer Firebird- oder Oracle-Datenbank befinden.
• File Storage – dieser File-Storage-Bereich enthält Binärdaten innerhalb des VCS-Repository des Enterprise Server. Diese Binärdaten umfassen Informationen wie PCB- und Schaltplan-Projektdokumente, Footprints, Symbole, Draftsman sowie andere native oder nicht-native Enterprise-Server-Dokumente.

Überblick über das Altium-Wiederherstellungstool auf hoher Ebene

Das Altium-Wiederherstellungstool heißt avbackup.exe. Es ist dasselbe Dienstprogramm, das beim Enterprise Server für Sicherungs- und Wiederherstellungszwecke verwendet wird. Es handelt sich um ein Befehlszeilenprogramm, das IT-Administratoren ausführen können, um ihre Enterprise-Server-Daten wiederherzustellen. avbackup.exe ist dasselbe Dienstprogramm, das für Wiederherstellungszwecke verwendet wird, wenn der Enterprise Server mit einem standardmäßigen Firebird-Datenbank-Backend konfiguriert ist oder wenn Oracle als Backend-Datenbank verwendet wird.

Bei der Verwendung von avbackup.exe in einer Enterprise-Server-Implementierung, die eine Oracle-Datenbank verwendet, sollten Administratoren Folgendes beachten:

1. avbackup.exe unterstützt NOT die Wiederherstellung Ihrer Enterprise-Server-Metadaten in eine Oracle-Datenbank. Diese Funktion arbeitet nur bei Enterprise-Server-Implementierungen mit einem Firebird-Datenbank-Backend, das ursprünglich automatisch durch den Enterprise Server Installer konfiguriert wurde.
2. avbackup.exe akzeptiert die Zip-Datei, die es bei Verwendung als Sicherungstool erzeugt. Diese Zip-Datei enthält alle binären Daten des Enterprise Server.
3. Der Enterprise Server muss ausgeführt werden. avbackup.exe fährt während der Datenwiederherstellung automatisch alle Enterprise-Server-Dienste (einschließlich IIS-Dienste) herunter und startet nach erfolgreicher Wiederherstellung alle heruntergefahrenen Dienste erneut.

Beispiel für die Wiederherstellung von Enterprise-Server-Daten mit Oracle-Backend auf der Windows-Plattform

In diesem Beispiel sind die Anweisungen auch auf kleinere Unternehmen zugeschnitten, die möglicherweise keinen dedizierten Oracle-Datenbankadministrator (DBA) haben, aber dennoch ihren Enterprise Server und die zugehörigen Oracle-Daten in ihrem Netzwerk wiederherstellen müssen. Die folgenden Schritte zeigen, wie eine grundlegende Sicherung des Enterprise Server und der zugehörigen Oracle-Datenbank auf einem neuen Rechner und in einer neuen Oracle-Datenbank wiederhergestellt werden kann.

Erforderliche Elemente

• Eine bereits vorhandene funktionierende Instanz des Enterprise Server mit Oracle-Backend.
• Bereits vorhandene Ordner und Datenquellen:
  • Die Ordner, in denen sich Ihre Enterprise-Server- und Oracle-Daten befinden werden, müssen bereits vorhanden sein und eine Kopie Ihrer Enterprise-Server-Backup-Zip-Datei sowie Ihrer Oracle-.DMP-Datei enthalten.
• Administratorzugriff auf den Enterprise-Server-Host-Rechner. Dies ist erforderlich, um das Befehlszeilenprogramm für die Enterprise-Server-Sicherung (avbackup.exe) korrekt auszuführen.
• Entsprechender DBA-Zugriff auf den Oracle-Server (d. h. das Windows-Konto des Benutzers in der Windows-Umgebung zur Rolle sysDBA hinzufügen).

Wiederherstellungsverfahren

1. Wenn keine bereits vorhandene Instanz des Enterprise Server mit Oracle-Backend eingerichtet wurde, lesen Sie bitte das Dokument Installieren von Altium On-Prem Enterprise Server mit einem Oracle-Backend, um ein Beispiel dafür zu erhalten, wie der Enterprise Server mit Oracle-Backend auf einem neuen Rechner eingerichtet wird.
2. Zu diesem Zeitpunkt sollten Sie bereits über eine vorhandene Instanz des Enterprise Server mit Oracle verfügen – entweder aufgrund einer neuen oder einer früheren Installation.
3. Auf dem Enterprise-Server-Host-Rechner:
   1. Erstellen Sie einen Wiederherstellungsordner (es ist hilfreich, gemeinsame Dateipfade zu verwenden, zum Beispiel: C:\Backups). Legen Sie die Enterprise-Server-Backup-Zip-Datei in diesen Ordner.
   2. Stellen Sie Ihre Enterprise-Server-Daten wieder her, indem Sie das Tool avbackup.exe als Administrator ausführen. Das Tool befindet sich im Ordner C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool.
   3. Fahren Sie die IIS-Enterprise-Server-Dienste herunter oder fahren Sie den Enterprise-Server-Host-Rechner herunter. Dadurch werden unbeabsichtigte Schreibvorgänge in Ihre Oracle-Datenbank durch Enterprise-Server-Dienste verhindert.

4. Auf dem Host-Rechner der Oracle-Datenbank:
   1. Erstellen Sie einen Wiederherstellungsordner und legen Sie die Oracle-.dmp-Datei in diesen Ordner (es ist hilfreich, gemeinsame Dateipfade zu verwenden, zum Beispiel: C:\Backups).
   2. Löschen/entfernen Sie das vorhandene Schema und Benutzerkonto aus der Oracle-Datenbank.

Das Löschen eines Oracle-Benutzerkontos und des zugehörigen Schemas kann wie folgt erfolgen. In diesem Beispiel löschen wir das vorhandene Benutzerkonto AESUSER313 und das zugehörige Schema aus einer Oracle-Datenbank unter Microsoft Windows:

1. Starten Sie eine Eingabeaufforderung mit Administratorrechten.
2. Beenden Sie IIS-Dienste, falls diese auf dem Oracle-Rechner vorhanden sind, mit dem Befehl: net stop WAS, drücken Sie dann Y und bestätigen Sie mit Enter.
3. Stellen Sie eine Verbindung zur Oracle-DB her, indem Sie eine SqlPlus-Sitzung starten:

sqlplus / as sysdba

shutdown immediate;

startup restrict;

4. Löschen Sie das dem Enterprise Server zugeordnete Schema (in diesem Beispiel ist AESUSER313 der Name des Schemas, das wir löschen möchten):

drop user AESUSER313 cascade;

5. Aktivieren Sie die DB anschließend wieder normal, entweder durch einen Neustart des Rechners oder mit den folgenden Befehlen:

shutdown immediate;

startup;

3. Erstellen Sie ein identisches Schema auf dem Oracle-Server und weisen Sie erhöhte Rechte zu:
   1. Öffnen Sie die Befehlszeile als Administrator und geben Sie Folgendes ein:

sqlplus / as sysdba;

CREATE user AESUSER313 identified by “Altium”;

GRANT ALL PRIVILEGES TO AESUSER313;

GRANT IMP_FULL_DATABASE TO AESUSER313;

2. Alternativ können Sie diesem Benutzer vorübergehend die DBA-Rolle zuweisen, Dateien importieren und diese Berechtigung anschließend wie unten gezeigt wieder entziehen:

GRANT DBA TO AESUSER313;

3. Entziehen Sie nach erfolgreichem Import der DB die DBA-Berechtigungen:

revoke DBA from AESUSER313;

4. Stellen Sie Oracle-Daten wieder her (dieser Abschnitt geht davon aus, dass sowohl das Benutzerkonto als auch die Schemas AESUSER313 heißen und das Passwort Altium haben):
   1. Starten Sie eine Eingabeaufforderung mit Administratorrechten
   2. Beenden Sie IIS-Server mit dem Befehl:

net stop WAS

3. Importieren Sie die Oracle-Daten. Ein Beispiel für einen Importbefehl ist:

imp AESUSER313/Altium@xe file=c:\Backups\AESUSER313.dmp log=c:\Backups\AESUSER313_import.log fromuser=AESUSER313 touser=AESUSER313

wobei,

AESUSER313 – Benutzer mit vollständigen Rechten für das Schema und Zugriffsrechten auf die DB.

Altium – Passwort für das Oracle-Benutzerkonto, das dem Enterprise Server zugeordnet ist.

xe – Netzwerkdienstname der Zieldatenbank, enthalten in tnsnames.ora.

file = c:\Backups\AESUSER313.dmp – Speicherort des Backups.

log = c:\Backups\AESUSER313_import.log – Wiederherstellungsprotokoll (optional).

fromuser=AESUSER313 – Eigentümer des Backup-Schemas.

touser=AESUSER313 – der neue Eigentümer des Schemas (wenn die Eigentümer unterschiedlich sind, müssen Sie einen neuen Benutzer mit den entsprechenden Berechtigungen und Rollen erstellen).

5. Datenintegrität überprüfen.
   1. Prüfen Sie die Datei tnsname.ora. Sie sollten den Netzwerkdienstnamen aktualisieren (wenn Sie den DB-Server geändert haben).
   2. Überprüfen Sie die IIS-Servereinstellungen. Prüfen Sie in IIS Manager die Spalte „Host name“ in den Bindungen auf Aktualität. Dort sollte der aktuelle Fully Qualified Domain Name (FQDN) Ihres Enterprise Server eingetragen sein.
   3. Prüfen Sie die Werte der folgenden Parameter in der Datei C:\Program Files (x86)\Altium\Altium365\LocalVault.ini.
      1. Domain – der Name Ihrer Domäne.
      2. WebsiteDomain – FQDN Ihres Enterprise Server.
      3. DataSourceType=Oracle – falls Oracle DB verwendet wird.
      4. User=AESUSER313 – Eigentümer des Schemas.
      5. Password=Altium – das vom DBA definierte Benutzerpasswort.
      6. DBLocation=FQDN oder ip_address:1521 – Adresse Ihres DB-Servers.
      7. DatabaseName=xe – aktueller Netzwerkdienstname der DB, enthalten in tnsnames.ora.

Fazit

Obwohl das oben genannte Beispiel zusätzliche Details zur Anbindung und Bearbeitung einer Oracle-Datenbank enthält, gibt es nur drei wesentliche Schritte zur Wiederherstellung Ihrer Enterprise Server-Daten:

1. Schritt 1 besteht darin, die IIS-Dienste und die Enterprise Server IIS-Anwendungspools zu stoppen.
2. Schritt 2 besteht darin, die Enterprise Server Daten wiederherzustellen.
3. Schritt 3 besteht darin, die dem Enterprise Server zugeordneten Oracle-Daten wiederherzustellen.

Wenn Sie dieses Verfahren in der beschriebenen Reihenfolge durchführen, wird die Wahrscheinlichkeit einer Datenbeschädigung aufgrund einer Nichtübereinstimmung zwischen Oracle-Datenbank und binären Enterprise Server-Daten erheblich reduziert.