Tworzenie kopii zapasowej i przywracanie instalacji

Obszar roboczy Enterprise Server może przechowywać szeroki zakres cennych danych, w tym zdefiniowanych użytkowników, grupy, zadania synchronizacji LDAP, dane projektowe (w tym projekty, komponenty, modele, szablony) oraz konfiguracje usług PLS i NIS (a zazwyczaj także szereg pozyskanych produktów i rozszerzeń oraz zdefiniowane pakiety wdrożeniowe dla tych ostatnich). Kluczowym wymaganiem zapewnienia długoterminowej integralności tych danych jest wykonywanie kopii zapasowych. Standardowa instalacja Enterprise Server zawiera narzędzie do tworzenia kopii zapasowych i przywracania, dostępne z poziomu wiersza polecenia.

Domyślna lokalizacja narzędzia kopii zapasowej znajduje się w folderze \Program Files (x86)\Altium\Altium365\Tools\BackupTool.

Nazwa narzędzia kopii zapasowej to avbackup.exe.

Uzyskiwanie dostępu do Backup Tool

Aby użyć narzędzia:

1. Uruchom Wiersz polecenia systemu Windows.

   Musisz uruchomić Wiersz polecenia w trybie administratora, aby móc używać narzędzia Backup and Restore. Jeśli nie uruchomisz okna CMD jako administrator systemu Windows, próba wykonania polecenia dotyczącego tworzenia kopii zapasowej lub przywracania Enterprise Server zakończy się czytelnym komunikatem: Access Denied. Administrator permissions are needed to use the selected options. Use an administrator command prompt to complete these tasks.

2. Przejdź do właściwego folderu. Dla domyślnej instalacji na dysku C komputera hosta będzie to: cd C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\

3. Aby uruchomić narzędzie i wyświetlić dostępne opcje, w wierszu polecenia wpisz: avbackup ?

Dostęp do narzędzia kopii zapasowej przez Wiersz polecenia (uruchomiony jako administrator).

Zwróć uwagę na ? — jego użycie wyświetla pomoc dotyczącą funkcji dostępnych w narzędziu kopii zapasowej:

• backup – wykonanie kopii danych do archiwum ZIP.

• restore – przywrócenie danych z archiwum ZIP. Punkt przywracania zostanie utworzony automatycznie.

• help – wyświetlenie ekranu pomocy (? można użyć zamiast ciągu help).

Zawartość archiwum Zip

Narzędzie wykonuje kopię całego Enterprise Server oraz danych użytkownika, w tym:

• Pełna kopia bazy danych, obejmująca: wszystkie elementy danych (modele, komponenty, zarządzane arkusze, szablony, wydane projekty itd.), użytkowników, grupy, instalacje pozyskane przez Network Installation Service oraz ustawienia synchronizacji LDAP.

• Wszystkie rewizje powyższych.

• Repozytoria oraz zawarte w nich projekty obszaru roboczego.

• Indeks wyszukiwania.

• Ustawienia zdefiniowane przez użytkownika (niestandardowe).

Składnia kopii zapasowej i przełączniki

Następujące przełączniki są dostępne podczas używania funkcji tworzenia kopii zapasowej narzędzia:

avbackup backup -z [-t] [-h] [-i] [-m] [-d] [-c] [--split] [--skip-shadow-copy]

• -z – ścieżka i nazwa pliku docelowego zip, który ma zostać utworzony. Ujmij w cudzysłów, jeśli w ciągu występują spacje. Ten przełącznik jest wymagany.

• -t, --test – jeśli ten przełącznik zostanie podany, plik zip zostanie przetestowany po wykonaniu kopii.

• -h, --hash – jeśli ten przełącznik zostanie podany, zostanie utworzony plik skrótu MD5 (*.md5).

• -i – pełna ścieżka do pliku LocalVault.ini Enterprise Server, który dostarcza informacji o lokalizacji danych dla Enterprise Server, dla którego ma zostać wykonana kopia. Domyślna ścieżka tego pliku to C:\Program Files (x86)\Altium\Altium365\LocalVault.ini. Jeśli ten przełącznik nie zostanie podany, narzędzie spróbuje znaleźć plik automatycznie na podstawie tej domyślnej lokalizacji instalacji. Ujmij w cudzysłów, jeśli w ciągu występują spacje.

• -m – pozwala określić, czy operacja tworzenia kopii ma działać w trybie cichym (-m silent, który jest trybem domyślnym), czy też ma pojawić się okno dialogowe z prośbą o ponowienie próby w razie niepowodzenia (-m dialog). Jeśli ten przełącznik nie zostanie podany, zostanie użyty tryb cichy.

• -d, --debug – jeśli ten przełącznik zostanie podany, zostanie użyty tryb debugowania, który spowoduje tworzenie większej liczby logów do celów diagnostycznych oraz do udostępnienia inżynierom Altium.

• -c – pozwala określić poziom kompresji docelowego pliku zip. Użyj liczby od 0 do 9. Możesz także użyć następujących wartości:

  • Default – równa się poziomowi kompresji 6 (używany, jeśli ten przełącznik nie zostanie podany)

  • None – równa się poziomowi kompresji 0

  • BestSpeed – równa się poziomowi kompresji 1

  • BestCompression – równa się poziomowi kompresji 9.

• --split – jeśli ten przełącznik zostanie podany, zostaną utworzone osobne pliki zip dla repozytoriów i rewizji (bez kompresji), oprócz pliku zip dla pozostałych danych.

• --skip-shadow-copy – jeśli ten przełącznik zostanie podany, kopia w tle nie zostanie utworzona. Zwróć uwagę, że czas niedostępności serwera (okres pomiędzy zatrzymaniem a uruchomieniem usług) zwiększa się, gdy używany jest ten przełącznik.

Wpisując samo avbackup backup, przełączniki te zostaną wyświetlone jako pomocna ściągawka.

Przełączniki dostępne podczas używania narzędzia w trybie tworzenia kopii zapasowej.

Składnia przywracania i przełączniki

Następujące przełączniki są dostępne podczas używania funkcji przywracania narzędzia:

avbackup restore -z [--skip-backup] [-i] [-m] [-d] [-c] [--split] [--skip-shadow-copy]

• -z – ścieżka i nazwa pliku zip kopii zapasowej, z którego ma nastąpić przywrócenie. Ujmij w cudzysłów, jeśli w ciągu występują spacje. Ten przełącznik jest wymagany.

• --skip-backup – pozwala pominąć tworzenie punktu przywracania przed rozpoczęciem przywracania Enterprise Server. Używaj ostrożnie, ponieważ jeśli przywracanie danych się nie powiedzie, nie będzie możliwe wycofanie zmian.

• -i – pełna ścieżka do pliku LocalVault.ini Enterprise Server, który dostarcza informacji o lokalizacjach, do których mają zostać przywrócone dane Enterprise Server. Domyślna ścieżka tego pliku to C:\Program Files (x86)\Altium\Altium365\LocalVault.ini. Jeśli ten przełącznik nie zostanie podany, narzędzie spróbuje znaleźć plik automatycznie na podstawie tej domyślnej lokalizacji instalacji. Ujmij w cudzysłów, jeśli w ciągu występują spacje.

• -m – pozwala określić, czy operacja przywracania ma działać w trybie cichym (-m silent, który jest trybem domyślnym), czy też ma pojawić się okno dialogowe z prośbą o ponowienie próby w razie niepowodzenia (-m dialog). Jeśli ten przełącznik nie zostanie podany, zostanie użyty tryb cichy.

• -d, --debug – jeśli ten przełącznik zostanie podany, zostanie użyty tryb debugowania, który spowoduje tworzenie większej liczby logów do celów diagnostycznych oraz do udostępnienia inżynierom Altium.

• -c – pozwala określić poziom kompresji docelowego pliku zip dla punktu przywracania (kopii bieżącej instalacji Enterprise Server). Użyj liczby od 0 do 9. Możesz także użyć następujących wartości:

  • Default – równa się poziomowi kompresji 6 (używany, jeśli ten przełącznik nie zostanie podany)

  • None – równa się poziomowi kompresji 0

  • BestSpeed – równa się poziomowi kompresji 1

  • BestCompression – równa się poziomowi kompresji 9.

• --split – jeśli ten przełącznik zostanie podany, zostaną utworzone osobne pliki zip dla repozytoriów i rewizji (bez kompresji), oprócz pliku zip dla pozostałych danych, dla punktu przywracania (kopii bieżącej instalacji Enterprise Server).

• --skip-shadow-copy –  jeśli ten przełącznik zostanie podany, kopia w tle nie zostanie utworzona dla punktu przywracania (kopii bieżącej instalacji Enterprise Server). Zwróć uwagę, że czas niedostępności serwera (okres pomiędzy zatrzymaniem a uruchomieniem usług) zwiększa się, gdy używany jest ten przełącznik.

Wpisując samo avbackup restore, przełączniki te zostaną wyświetlone jako pomocna ściągawka.

Przełączniki dostępne podczas używania narzędzia w trybie przywracania.

Punkt przywracania

Narzędzie do tworzenia kopii zapasowych automatycznie tworzy punkt przywracania przed rozpoczęciem przywracania Enterprise Server (jeśli do przywracania nie użyto --skip-backup ). Aby to zrobić, narzędzie wykonuje kopię zapasową istniejącego Enterprise Server i kopiuje plik ZIP przywracania do następującej lokalizacji:

C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\Backups\

Plik ZIP jest nazywany w formacie: Backup_<Date>_<Time>.zip.

Błędy podczas tworzenia kopii zapasowej lub przywracania

Błędy, które wystąpią podczas tworzenia kopii zapasowej lub przywracania, są wyświetlane bezpośrednio w oknie CMD, wraz z pełną ścieżką do dziennika błędów:

C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\errors.log

Podczas tworzenia kopii zapasowej lub przywracania Enterprise Server szczegóły wszelkich błędów, a także pełna ścieżka do pliku errors.log, są prezentowane bezpośrednio w oknie CMD.