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, uruchamiane z poziomu wiersza polecenia.

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

Nazwa narzędzia do kopii zapasowych to avbackup.exe.

Uzyskiwanie dostępu do narzędzia Backup Tool

Aby użyć narzędzia:

1. Uruchom wiersz polecenia systemu Windows.

   Musisz uruchomić wiersz polecenia w trybie administratora, aby móc korzystać z 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ę jednoznacznym 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 zapasowych przez wiersz polecenia (uruchomiony jako administrator).

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

• 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 korzystania z 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 sumy 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 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, użyty zostanie tryb cichy.

• -d, --debug – jeśli ten przełącznik zostanie podany, użyty zostanie 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żywane, 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 przestoju serwera (okres pomiędzy zatrzymaniem a uruchomieniem usług) zwiększa się przy użyciu tego przełącznika.

Wpisując tylko 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 korzystania z 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żliwości wycofania 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 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, użyty zostanie tryb cichy.

• -d, --debug – jeśli ten przełącznik zostanie podany, użyty zostanie 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żywane, 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 jest określony, nie zostanie utworzona kopia w tle (shadow copy) dla punktu przywracania (kopia zapasowa bieżącej instalacji Enterprise Server). Należy pamiętać, że przestój serwera (okres pomiędzy zatrzymaniem a ponownym uruchomieniem usług) wydłuża się, gdy używany jest ten przełącznik.

Wpisując samo avbackup restore, te przełączniki 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 ). W tym celu 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.

Rejestrowanie kopii zapasowej i przywracania

Informacje o zdarzeniach podczas tworzenia kopii zapasowej lub przywracania są prezentowane bezpośrednio w oknie CMD i można je również znaleźć w pliku dziennika:

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

Jeśli podczas tworzenia kopii zapasowej lub przywracania wystąpi błąd, pełne informacje na jego temat można również znaleźć w pliku dziennika ().