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.
-
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 samodzielny Health Monitor (avhealth.exe) musi zostać zamknięte podczas korzystania z narzędzia 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, przerywając ich bieżącą sesję obszaru roboczego na stronie Sessions w interfejsie przeglądarkowym (Admin – Sessions). Więcej informacji znajdziesz na stronie Sessions.
-
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.
Proces kopii/przywracania resetuje również licznik transakcji bazy danych. Bieżący stan licznika transakcji serwera można sprawdzić za pomocą narzędzia Health Monitor (zobacz wpis Transaction count w obszarze DATABASE okna narzędzia).
Narzędzie do kopii zapasowych 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 zapasowych 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 przestoju 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 zapasowych zastosuje podejście bez tworzenia kopii w tle (co można także włączyć jawnie za pomocą przełącznika --skip-shadow-copy).
Uzyskiwanie dostępu do narzędzia Backup Tool
Aby użyć narzędzia:
-
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.
-
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 wklejać do wiersza polecenia za pomocą Ctrl+V, ale można wkleić przez menu po kliknięciu prawym przyciskiem myszy. Najpierw skopiuj wymagane ciągi, a następnie wklej je tą metodą, aby zaoszczędzić czas i uniknąć pomyłek.
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.
Backup Example
Poniższy wpis w trybie cichym wykona 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 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.
Jeśli istnieje plik skrótu *.md5 dla archiwum ZIP kopii zapasowej, z którego ma nastąpić 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, używając 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ładowego polecenia przywracania. Zwróć uwagę, że narzędzie najpierw tworzy punkt przywracania (kopia zapasowa 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 ). 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 (
).
Tłumaczenie SI