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.
-
Jeśli narzędzie avbackup.exe nie znajduje się w domyślnej ścieżce – \Program Files (x86)\Altium\Altium365\Tools\BackupTool – podczas przywracania mogą wystąpić błędy/wyjątki.
-
Narzędzie samodzielne Health Monitor (avhealth.exe) musi zostać zamknięte podczas używania Backup Tool (zarówno w trybie tworzenia kopii, jak i przywracania), ponieważ oba narzędzia wymagają dostępu do pliku bazy danych Enterprise Server.
-
Zdecydowanie zaleca się, aby podczas procesów tworzenia kopii zapasowej i przywracania użytkownicy nie byli połączeni z obszarem roboczym ani z niego nie korzystali, ponieważ procesy te wymagają dostępu do bazy danych obszaru roboczego. Jako administrator obszaru roboczego możesz w razie potrzeby wymusić wylogowanie użytkowników, zrywając ich bieżącą sesję obszaru roboczego na stronie Sessions interfejsu przeglądarkowego (Admin – Sessions). Więcej informacji znajdziesz na stronie Sessions page.
-
Przywrócenie kopii zapasowej jest możliwe wyłącznie do tej samej wersji Enterprise Server, z której ta kopia została wykonana. Z tego względu dobrym pomysłem może być przechowywanie instalatora tego Enterprise Server oraz odpowiadających mu plików licencji razem z archiwum ZIP kopii zapasowej.
Narzędzie kopii zapasowej używa usługi Volume Shadow Copy Service (VSS) do utworzenia kopii w tle woluminu, na którym znajdują się dane serwera (obsługiwana jest także konfiguracja, w której rewizje są przechowywane na osobnym woluminie). Z użyciem VSS narzędzie kopii zapasowej zatrzymuje usługi, tworzy kopię w tle, uruchamia usługi, a następnie wykonuje kopię danych, korzystając z utworzonej kopii w tle. Takie podejście minimalizuje czas niedostępności serwera (okres pomiędzy zatrzymaniem a ponownym uruchomieniem usług) i jest używane domyślnie. W przypadku błędu podczas tworzenia kopii w tle narzędzie kopii zapasowej zastosuje podejście bez tworzenia kopii w tle (co można także włączyć jawnie przełącznikiem --skip-shadow-copy).
Uzyskiwanie dostępu do Backup Tool
Aby użyć narzędzia:
-
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.
-
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\
-
Aby uruchomić narzędzie i wyświetlić dostępne opcje, w wierszu polecenia wpisz: avbackup ?
W niektórych wersjach systemu Windows nie można wkleić do Wiersza polecenia za pomocą Ctrl+V, ale można wkleić przez menu pod prawym przyciskiem myszy. Najpierw skopiuj wymagane ciągi, a następnie wklej tą metodą, aby zaoszczędzić czas i uniknąć pomyłek.
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.
Backup Example
Poniższy wpis wykona cichą kopię zapasową Enterprise Server do pliku o nazwie 02102024_Backup.zip, zapisując plik w folderze 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"
Wszystkie wskazane foldery muszą już istnieć. Ponadto istniejące pliki są nadpisywane, jeśli nowy plik ma taką samą nazwę jak plik już istniejący.
Wynik uruchomienia przykładowego polecenia 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.
Jeśli istnieje plik hash *.md5 dla archiwum ZIP kopii zapasowej, z którego ma zostać wykonane przywracanie (plik *.md5 znajduje się w tym samym folderze co plik ZIP i jest nazwany tak jak plik ZIP, tj. <ZipFileName>.zip.md5), jego hash zostanie sprawdzony przed przywróceniem.
Restore Example
Poniższy wpis w trybie cichym przywróci Enterprise Server przy użyciu archiwum ZIP kopii zapasowej o nazwie 30082022_Backup.zip, które jest przechowywane w folderze C:\Backups\Altium Enterprise Server\:
avbackup restore -z "C:\Backups\Altium Enterprise Server\30082022_Backup.zip" -i "C:\Program Files (x86)\Altium\Altium365\LocalVault.ini"
Wynik uruchomienia przykładowej komendy przywracania. Zwróć uwagę, że narzędzie najpierw tworzy punkt przywracania (kopię zapasową bieżącej instalacji Enterprise Server), zanim wykona przywracanie.
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.
Tłumaczenie SI