Ein Enterprise Server Workspace kann eine große Bandbreite wertvoller Daten enthalten, darunter definierte Benutzer, Gruppen, LDAP-Sync-Aufgaben, Konstruktionsdaten (einschließlich Projekten, Komponenten, Modellen und Vorlagen) sowie Konfigurationen für PLS- und NIS-Dienste (und typischerweise auch eine Reihe erworbener Produkte und Erweiterungen sowie definierte Deployment-Pakete für Letztere). Eine wesentliche Voraussetzung, um die langfristige Integrität dieser Daten sicherzustellen, ist deren Sicherung. Die Standardinstallation von Enterprise Server umfasst ein Backup- und Restore-Tool, auf das über eine Eingabeaufforderung zugegriffen wird.
Der Standardspeicherort des Backup-Tools befindet sich im Ordner \Program Files (x86)\Altium\Altium365\Tools\BackupTool.
Der Name des Backup-Tools lautet avbackup.exe.
-
Wenn sich das Tool avbackup.exe nicht im Standardpfad – \Program Files (x86)\Altium\Altium365\Tools\BackupTool – befindet, können während einer Wiederherstellung Fehler/Ausnahmen auftreten.
-
Das eigenständige Health Monitor-Tool (avhealth.exe) muss bei der Verwendung des Backup-Tools (sowohl im Backup- als auch im Restore-Modus) geschlossen sein, da beide Tools Zugriff auf die Datenbankdatei des Enterprise Servers benötigen.
-
Es wird dringend empfohlen, dass während der Backup- und Restore-Vorgänge keine Benutzer mit dem Workspace verbunden sind und ihn verwenden, da diese Vorgänge Zugriff auf die Datenbank des Workspace erfordern. Als Workspace-Administrator können Sie Benutzer bei Bedarf zwangsweise abmelden, indem Sie ihre aktuelle Workspace-Sitzung über die Seite Sessions der Browseroberfläche (Admin – Sessions) beenden. Weitere Informationen finden Sie auf der Seite Sessions page.
-
Die Wiederherstellung eines Backups ist nur in dieselbe Version von Enterprise Server möglich, aus der dieses Backup erstellt wurde. In diesem Zusammenhang kann es sinnvoll sein, das Installationsprogramm für diesen Enterprise Server und die zugehörigen Lizenzdateien zusammen mit dem Backup-ZIP-Archiv aufzubewahren.
Der Backup-/Restore-Prozess setzt außerdem den Datenbank-Transaktionszähler zurück. Der aktuelle Status des Transaktionszählers des Servers kann mit dem Health Monitor tool überprüft werden (siehe den Eintrag Transaction count im Bereich DATABASE des Tool-Fensters).
Das Backup-Tool verwendet den Volume Shadow Copy Service (VSS), um eine Schattenkopie des Volumes zu erstellen, auf dem sich die Serverdaten befinden (eine Konfiguration, bei der Revisionen auf einem separaten Volume gespeichert werden, wird ebenfalls unterstützt). Mit VSS stoppt das Backup-Tool Dienste, erstellt eine Schattenkopie, startet die Dienste wieder und führt dann die Datensicherung mithilfe der erstellten Schattenkopie durch. Dieser Ansatz minimiert die Ausfallzeit des Servers (den Zeitraum zwischen dem Stoppen und dem Starten der Dienste) und wird standardmäßig verwendet. Tritt beim Erstellen einer Schattenkopie ein Fehler auf, verwendet das Backup-Tool einen Ansatz ohne Erstellung einer Schattenkopie (dies kann auch explizit mit dem Schalter --skip-shadow-copy aktiviert werden).
Zugriff auf das Backup-Tool
So verwenden Sie das Tool:
-
Starten Sie eine Windows-Eingabeaufforderung.
Sie müssen die Eingabeaufforderung im Administratormodus ausführen, um das Backup- und Restore-Tool verwenden zu können. Wenn Sie keine CMD-Eingabeaufforderung als Windows-Administrator ausführen, führt der Versuch, einen Befehl zum Sichern oder Wiederherstellen Ihres Enterprise Servers auszuführen, zu der eindeutigen Meldung: Access Denied. Administrator permissions are needed to use the selected options. Use an administrator command prompt to complete these tasks.
-
Navigieren Sie zum richtigen Ordner. Bei einer Standardinstallation auf dem Laufwerk C des Host-Computers ist dies: cd C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\
-
Um das Tool auszuführen und die verfügbaren Optionen aufzulisten, geben Sie an der Eingabeaufforderung Folgendes ein: avbackup ?
In einigen Windows-Versionen ist es nicht möglich, mit Ctrl+V in eine Eingabeaufforderung einzufügen, Sie können jedoch über das Rechtsklick-Menü einfügen. Kopieren Sie die erforderlichen Zeichenfolgen zuerst und fügen Sie sie dann mit dieser Technik ein, um Zeit zu sparen und Fehler zu vermeiden.
Zugriff auf das Backup-Tool über eine Eingabeaufforderung (als Administrator ausgeführt).
Beachten Sie ?; wenn dies eingeschlossen wird, wird Hilfe zu den im Backup-Tool verfügbaren Funktionen angezeigt:
-
backup – Daten in ein ZIP-Archiv sichern.
-
restore – Daten aus einem ZIP-Archiv wiederherstellen. Der Wiederherstellungspunkt wird automatisch erstellt.
-
help – den Hilfebildschirm anzeigen (? kann anstelle der Zeichenfolge help verwendet werden).
Inhalt des ZIP-Archivs
Das Tool sichert den gesamten Enterprise Server und die Benutzerdaten, einschließlich:
-
Vollständige Datenbanksicherung, einschließlich: aller Datenelemente (Modelle, Komponenten, verwaltete Schaltpläne, Vorlagen, freigegebene Designs usw.), Benutzer, Gruppen, über den Network Installation Service erworbene Installationen und LDAP-Sync-Einstellungen.
-
Alle Revisionen des Vorstehenden.
-
Repositories und enthaltene Workspace-Designs.
-
Suchindex.
-
Benutzerdefinierte (Custom-)Einstellungen.
Backup-Syntax und Schalter
Die folgenden Schalter sind verfügbar, wenn die Backup-Funktion des Tools verwendet wird:
avbackup backup -z [-t] [-h] [-i] [-m] [-d] [-c] [--split] [--skip-shadow-copy]
-
-z – Pfad und Dateiname der zu erstellenden Ziel-ZIP-Datei. Wenn die Zeichenfolge Leerzeichen enthält, in Anführungszeichen setzen. Dieser Schalter ist erforderlich.
-
-t, --test – wenn dieser Schalter angegeben wird, wird die ZIP-Datei nach dem Backup getestet.
-
-h, --hash – wenn dieser Schalter angegeben wird, wird eine MD5-Hash-Datei (*.md5) erstellt.
-
-i – vollständiger Pfad zur Datei LocalVault.ini des Enterprise Servers, die Informationen zum Speicherort der Daten für den zu sichernden Enterprise Server bereitstellt. Der Standardpfad dieser Datei ist C:\Program Files (x86)\Altium\Altium365\LocalVault.ini. Wenn dieser Schalter nicht angegeben wird, versucht das Tool, die Datei anhand dieses Standardinstallationsorts automatisch zu finden. Wenn die Zeichenfolge Leerzeichen enthält, in Anführungszeichen setzen.
-
-m – ermöglicht es Ihnen festzulegen, ob der Backup-Vorgang im stillen Modus (-m silent, der Standardmodus) ausgeführt werden soll oder ob im Fehlerfall ein Dialogfeld eingeblendet werden soll, das zum erneuten Versuch auffordert (-m dialog). Wenn dieser Schalter nicht angegeben wird, wird der stille Modus verwendet.
-
-d, --debug – wenn dieser Schalter angegeben wird, wird der Debug-Modus verwendet, wodurch mehr Protokolle zu Diagnosezwecken und zur Weitergabe an Altium Engineers erstellt werden.
-
-c – ermöglicht es Ihnen, die Komprimierungsstufe der Ziel-ZIP-Datei festzulegen. Verwenden Sie eine Zahl von 0 bis 9. Sie können auch die folgenden Werte verwenden:
-
Default – entspricht der Komprimierungsstufe 6 (wird verwendet, wenn dieser Schalter nicht angegeben wird)
-
None – entspricht der Komprimierungsstufe 0
-
BestSpeed – entspricht der Komprimierungsstufe 1
-
BestCompression – entspricht der Komprimierungsstufe 9.
-
--split – wenn dieser Schalter angegeben wird, werden zusätzlich zur ZIP-Datei für die übrigen Daten separate ZIP-Dateien für Repositories und Revisionen (ohne Komprimierung) erstellt.
-
--skip-shadow-copy – wenn dieser Schalter angegeben wird, wird keine Schattenkopie erstellt. Beachten Sie, dass sich die Ausfallzeit des Servers (der Zeitraum zwischen dem Stoppen und dem Starten der Dienste) erhöht, wenn dieser Schalter verwendet wird.
Wenn Sie nur avbackup backup eingeben, werden diese Schalter als hilfreiche Übersicht aufgelistet.
Verfügbare Schalter bei Verwendung des Tools im Backup-Modus.
Backup Example
Der folgende Eintrag sichert den Enterprise Server im stillen Modus in die Datei mit dem Namen 02102024_Backup.zip und schreibt die Datei in den Ordner C:\Backups\Altium Enterprise Server\:
avbackup backup -z "C:\Backups\Altium Enterprise Server\02102024_Backup.zip" -i "C:\Program Files (x86)\Altium\Altium365\LocalVault.ini"
Alle angegebenen Ordner müssen bereits vorhanden sein. Außerdem werden vorhandene Dateien überschrieben, wenn die neue Datei denselben Namen wie eine vorhandene Datei hat.
Das Ergebnis der Ausführung des Beispiel-Backup-Befehls.
Restore-Syntax und Schalter
Die folgenden Schalter sind verfügbar, wenn die Restore-Funktion des Tools verwendet wird:
avbackup restore -z [--skip-backup] [-i] [-m] [-d] [-c] [--split] [--skip-shadow-copy]
-
-z – Pfad und Dateiname der Backup-ZIP-Datei, aus der wiederhergestellt werden soll. Wenn die Zeichenfolge Leerzeichen enthält, in Anführungszeichen setzen. Dieser Schalter ist erforderlich.
-
--skip-backup – ermöglicht es Ihnen, das Erstellen eines Wiederherstellungspunkts vor Beginn der Wiederherstellung des Enterprise Servers zu überspringen. Verwenden Sie dies mit Vorsicht, da bei einem Fehlschlagen der Datenwiederherstellung kein Rollback möglich ist.
-
-i – vollständiger Pfad zur Datei LocalVault.ini des Enterprise Servers, die Informationen zu den Speicherorten bereitstellt, an denen die Enterprise-Server-Daten wiederhergestellt werden sollen. Der Standardpfad dieser Datei ist C:\Program Files (x86)\Altium\Altium365\LocalVault.ini. Wenn dieser Schalter nicht angegeben wird, versucht das Tool, die Datei anhand dieses Standardinstallationsorts automatisch zu finden. Wenn die Zeichenfolge Leerzeichen enthält, in Anführungszeichen setzen.
-
-m – ermöglicht es Ihnen festzulegen, ob der Restore-Vorgang im stillen Modus (-m silent, der Standardmodus) ausgeführt werden soll oder ob im Fehlerfall ein Dialogfeld eingeblendet werden soll, das zum erneuten Versuch auffordert (-m dialog). Wenn dieser Schalter nicht angegeben wird, wird der stille Modus verwendet.
-
-d, --debug – wenn dieser Schalter angegeben wird, wird der Debug-Modus verwendet, wodurch mehr Protokolle zu Diagnosezwecken und zur Weitergabe an Altium Engineers erstellt werden.
-
-c – ermöglicht es Ihnen, die Komprimierungsstufe der Ziel-ZIP-Datei für den Wiederherstellungspunkt (ein Backup der aktuellen Enterprise-Server-Installation) festzulegen. Verwenden Sie eine Zahl von 0 bis 9. Sie können auch die folgenden Werte verwenden:
-
Default – entspricht der Komprimierungsstufe 6 (wird verwendet, wenn dieser Schalter nicht angegeben wird)
-
None – entspricht der Komprimierungsstufe 0
-
BestSpeed – entspricht der Komprimierungsstufe 1
-
BestCompression – entspricht der Komprimierungsstufe 9.
-
--split – wenn dieser Schalter angegeben wird, werden zusätzlich zur ZIP-Datei für die übrigen Daten separate ZIP-Dateien für Repositories und Revisionen (ohne Komprimierung) für den Wiederherstellungspunkt (ein Backup der aktuellen Enterprise-Server-Installation) erstellt.
-
--skip-shadow-copy – wenn dieser Schalter angegeben wird, wird für den Wiederherstellungspunkt keine Schattenkopie erstellt (kein Backup der aktuellen Enterprise Server-Installation). Beachten Sie, dass sich die Server-Ausfallzeit (der Zeitraum zwischen dem Stoppen und Starten der Dienste) erhöht, wenn dieser Schalter verwendet wird.
Wenn Sie nur avbackup restore eingeben, werden diese Schalter als hilfreiche Übersicht aufgelistet.
Verfügbare Schalter bei Verwendung des Tools im Wiederherstellungsmodus.
Wenn für die Backup-ZIP-Datei, aus der wiederhergestellt werden soll, eine *.md5-Hash-Datei vorhanden ist (die Datei *.md5 befindet sich im selben Ordner wie die ZIP-Datei und ist nach der ZIP-Datei benannt, d. h. <ZipFileName>.zip.md5), wird ihr Hash vor der Wiederherstellung überprüft.
Restore Example
Der folgende Eintrag stellt den Enterprise Server im stillen Modus mithilfe der Backup-ZIP-Datei mit dem Namen 30082022_Backup.zip wieder her, die im Ordner C:\Backups\Altium Enterprise Server\ gespeichert ist:
avbackup restore -z "C:\Backups\Altium Enterprise Server\30082022_Backup.zip" -i "C:\Program Files (x86)\Altium\Altium365\LocalVault.ini"
Das Ergebnis der Ausführung des Beispielbefehls zur Wiederherstellung. Beachten Sie, dass das Tool zuerst einen Wiederherstellungspunkt erstellt (ein Backup der aktuellen Enterprise Server-Installation), bevor die Wiederherstellung durchgeführt wird.
Wiederherstellungspunkt
Das Backup-Tool erstellt automatisch einen Wiederherstellungspunkt, bevor mit der Wiederherstellung des Enterprise Server begonnen wird (wenn --skip-backup nicht für die Wiederherstellung verwendet wurde). Dazu führt das Backup-Tool eine Sicherung des vorhandenen Enterprise Server durch und kopiert die Wiederherstellungs-ZIP an den folgenden Speicherort:
C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\Backups\
Die ZIP-Datei wird im folgenden Format benannt: Backup_<Date>_<Time>.zip.
Protokollierung von Backup und Wiederherstellung
Informationen zu Ereignissen während eines Backups oder einer Wiederherstellung werden direkt im CMD-Fenster angezeigt und sind außerdem in der Protokolldatei zu finden:
C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\avbackup.log
Tritt während eines Backups oder einer Wiederherstellung ein Fehler auf, finden Sie vollständige Informationen dazu ebenfalls in der Protokolldatei (
).
AI-localized