Parent page: Konserwacja
Obszar roboczy Enterprise Server może przechowywać szeroki zakres cennych danych, w tym zdefiniowanych użytkowników, role, zadania synchronizacji LDAP, dane projektowe (w tym projekty, komponenty, modele, szablony) oraz konfiguracje usług PLS i NIS (a także zazwyczaj szereg pozyskanych produktów i rozszerzeń oraz zdefiniowane pakiety wdrożeniowe dla tych ostatnich). Kluczowym wymogiem 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 poleceń.
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.
- Tworzenie kopii zapasowych i przywracanie za pomocą tego narzędzia jest obecnie obsługiwane wyłącznie dla instalacji Enterprise Server korzystającej z bazy danych Firebird jako zaplecza.
-
Narzędzie standalone Health Monitor tool (avhealth.exe) musi zostać zamknięte podczas korzystania z 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 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.
Dostęp do 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 CMD jako administrator systemu Windows, próba wykonania polecenia dotyczącego tworzenia kopii zapasowej lub przywracania Enterprise Server zakończy się wyświetleniem jednoznacznego komunikatu: 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 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 zapasowej danych do archiwum ZIP.restore – przywrócenie danych z archiwum ZIP. Punkt przywracania zostanie utworzony automatycznie.help – wyświetlenie ekranu pomocy (? może zostać użyte zamiast ciągu help).
Zawartość archiwum ZIP
Narzędzie wykonuje kopię zapasową całego Enterprise Server oraz danych użytkownika, w tym:
- Pełną kopię bazy danych, obejmującą: wszystkie elementy danych (modele, komponenty, zarządzane arkusze, szablony, wydane projekty itd.), użytkowników, role, instalacje pozyskane przez Network Installation Service oraz ustawienia synchronizacji LDAP.
- Wszystkie rewizje powyższych.
- Repozytoria oraz zawarte w obszarze roboczym projekty.
- 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 [-i] [-m] [-d]
-z – ścieżka i nazwa pliku docelowego ZIP, który ma zostać utworzony. Jeśli w ciągu występują spacje, ujmij go w cudzysłów. Ten przełącznik jest wymagany.-i – pełna ścieżka do pliku LocalVault.ini Enterprise Server, który dostarcza informacji o lokalizacji danych dla Enterprise Server, którego kopia ma zostać wykonana. Domyślna ścieżka do 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. Jeśli w ciągu występują spacje, ujmij go w cudzysłów.-m – pozwala określić, czy operacja tworzenia kopii zapasowej 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 przypadku 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.
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 30082022_Backup.zip, zapisując plik w folderze C:\Backups\Altium Enterprise Server\:
avbackup backup -z "C:\Backups\Altium Enterprise Server\30082022_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 [-i] [-m] [-d]
-z – ścieżka i nazwa pliku ZIP kopii zapasowej, z którego ma nastąpić przywrócenie. Jeśli w ciągu występują spacje, ujmij go w cudzysłów. Ten przełącznik jest wymagany.-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 do 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. Jeśli w ciągu występują spacje, ujmij go w cudzysłów.-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 przypadku 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.
Wpisując tylko avbackup restore, przełączniki te zostaną wyświetlone jako pomocna ściągawka.
Przełączniki dostępne podczas używania narzędzia w trybie przywracania.
Restore Example
Poniższy wpis w trybie cichym przywróci Enterprise Server przy użyciu pliku ZIP kopii zapasowej o nazwie 30082022_Backup.zip, który jest przechowywany 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 (kopię zapasową bieżącej instalacji Enterprise Server), zanim wykona przywrócenie.
Punkt przywracania
Narzędzie kopii zapasowej automatycznie tworzy punkt przywracania przed rozpoczęciem przywracania Enterprise Server. W tym celu narzędzie kopii zapasowej wykonuje kopię zapasową istniejącego Enterprise Server i kopiuje przywracany plik ZIP do następującej lokalizacji:
C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool\Backups\
Plik ZIP jest nazywany według formatu: Backup_<Date>_<Time>.zip.
Błędy podczas tworzenia kopii zapasowej lub przywracania
Błędy występujące podczas tworzenia kopii zapasowej lub przywracania są prezentowane 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