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 ganze Oracle-Rechenzentren haben. Der Wiederherstellungsprozess umfasst typischerweise drei Schritte, wie in der folgenden Abbildung dargestellt.

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

Annahmen in diesem Dokument

Obwohl Oracle-Konfigurationen von Standort zu Standort variieren können, werden in diesem Dokument durchgehend 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 auf hoher Ebene über die Enterprise-Server-Architektur

Ähnlich wie andere Software, die für die Ausführung unter Microsoft Windows entwickelt wurde, ist der Enterprise Server eine multithreadfähige Serveranwendung mit mehreren Diensten. 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 und stellt die gesamte Backend-Architektur des Enterprise Server dar.

Überblick auf hoher Ebene über die Enterprise-Server-Architektur. 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 in diesem Block gesichert, möglicherweise auf einen anderen Rechner migriert und dann auf demselben oder einem anderen Rechner wiederhergestellt werden. Innerhalb der Backend Storages finden 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 im VCS-Repository des Enterprise Server. Diese Binärdaten umfassen Informationen wie PCB- und Schaltplan-Projektdokumente, Footprints, Symbole, Draftsman und andere native oder nicht native Enterprise-Server-Dokumente.

Überblick auf hoher Ebene über das Altium-Wiederherstellungstool

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 nicht 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 das Enterprise-Server-Installationsprogramm 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-Diensten) 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 richten sich die Anweisungen auch an kleinere Unternehmen, 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

• Vorhandene funktionierende Instanz des Enterprise Server mit Oracle-Backend.
• 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 Enterprise-Server-Befehlszeilenprogramm für Sicherung/Wiederherstellung (avbackup.exe) korrekt auszuführen.
• Geeigneter DBA-Zugriff auf den Oracle-Server (d. h. das Windows-Konto des Benutzers in der Windows-Umgebung zur Rolle sysDBA hinzufügen).

Wiederherstellungsverfahren

1. Falls noch keine 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 für ein Beispiel, wie der Enterprise Server mit Oracle-Backend auf einem neuen Rechner eingerichtet wird.
2. An diesem Punkt 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. Öffnen 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 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 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. Nach erfolgreichem Import der DB entziehen Sie die DBA-Berechtigungen wieder:

revoke DBA from AESUSER313;

4. Stellen Sie die Oracle-Daten wieder her (dieser Abschnitt geht davon aus, dass sowohl das Benutzerkonto als auch die Schemata AESUSER313 heißen und das Passwort Altium haben):
   1. Öffnen 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 auf das Schema und Zugriffsrechten auf die DB.

Altium – Passwort für das dem Enterprise Server zugeordnete Oracle-Benutzerkonto.

xe – Netzwerkdienstname der Ziel-DB, 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 entsprechenden Berechtigungen und Rollen erstellen).

5. Überprüfen Sie die Datenintegrität.
   1. Prüfen Sie die Datei tnsname.ora. Sie sollten den Namen des Netzwerkdienstes aktualisieren, falls Sie den DB-Server geändert haben.
   2. Überprüfen Sie die IIS-Servereinstellungen. Prüfen Sie in den Bindungen im IIS-Manager die Spalte „Host name“ 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 – vom DBA definiertes Benutzerkennwort.
      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 Application Pools zu stoppen.
2. Schritt 2 besteht darin, die Enterprise Server Daten wiederherzustellen.
3. Schritt 3 besteht darin, die mit dem Enterprise Server verknüpften Oracle-Daten wiederherzustellen.

Wenn Sie dieses Verfahren in der beschriebenen Reihenfolge durchführen, wird die Wahrscheinlichkeit einer Datenbeschädigung aufgrund einer Nichtübereinstimmung zwischen der Oracle-Datenbank und den Binärdaten des Enterprise Server erheblich verringert.