Przywracanie

Parent page: Altium On-Prem Enterprise Server z backendem Oracle

Ten dokument jest przeznaczony dla administratora IT, który odtwarza dane Altium On-Prem Enterprise Server, gdy Enterprise Server korzysta z backendu bazy danych Oracle. Zawiera szczegóły dotyczące Enterprise Server, procedury odtwarzania w kontekście użycia Oracle, ważne informacje o wymaganiach systemowych, a także przykład przedstawiający odtwarzanie danych na platformie Microsoft Windows.

Przegląd procesu odtwarzania

Odtwarzanie Enterprise Server przy użyciu backendu Oracle zależy od tego, jak Twoja firma zarządza bazami danych Oracle. Niektóre firmy uruchamiają bazy danych Oracle na systemach operacyjnych Windows Server, podczas gdy inne mają całe centra danych Oracle. Proces odtwarzania zwykle obejmuje trzy kroki, jak pokazano na poniższym obrazie.

Ogólny przegląd procedury odtwarzania Enterprise Server i bazy danych Oracle.

Założenia przyjęte w całym dokumencie

Chociaż konfiguracje Oracle mogą się różnić w zależności od lokalizacji, w całym dokumencie przyjęto następujące założenia:

1. Wykonano pełną kopię zapasową danych Enterprise Server oraz powiązany z nią zrzut danych Oracle, zgodnie z opisem w dokumencie Backing up Altium On-Prem Enterprise Server with an Oracle Backend.
2. Odtwarzanie wykonuje administrator IT. Co najmniej użytkownik wykonujący odtwarzanie Enterprise Server powinien mieć uprawnienia administracyjne do maszyny hosta.
3. Do wykonania importu danych Oracle powinien być dostępny administrator bazy danych (DBA). Co najmniej użytkownik postępujący zgodnie z tym przewodnikiem powinien mieć pełny dostęp do odczytu/zapisu, aby importować i modyfikować firmową bazę danych Oracle.
4. Ten przewodnik zakłada, że istnieje już instalacja Enterprise Server, skonfigurowana i działająca z backendem Oracle. (Zobacz sekcję przykładu, aby uzyskać więcej informacji, jak postępować w środowisku, w którym wdrażany jest nowy Enterprise Server na maszynie i importuje się dane do tej instancji Enterprise Server).
5. Schemat Oracle (Oracle Schema) oraz poświadczenia aplikacji Oracle używane na źródłowych i docelowych serwerach Oracle muszą być takie same.

Ogólny przegląd architektury Enterprise Server

Podobnie jak inne oprogramowanie zaprojektowane do działania w systemie Microsoft Windows, Enterprise Server jest wielowątkową, wielousługową aplikacją serwerową. Ponieważ ten dokument koncentruje się wyłącznie na częściach Enterprise Server, które mogą wchodzić w interakcję z bazą danych Oracle, poniższy obraz został uproszczony, aby przedstawić ogólną architekturę backendu Enterprise Server.

Ogólny przegląd architektury Enterprise Server. Backend Storages w Enterprise Server zawiera większość binarnych danych klienta, natomiast Windows Services to zbiór usług wspierających.

Ten dokument koncentruje się na Backend Storages, ponieważ dane w tym bloku są tym, co jest archiwizowane, potencjalnie migrowane na inną maszynę, a następnie odtwarzane na tej samej lub innej maszynie. W ramach Backend Storages można znaleźć następujące elementy:

• Databases – zawiera metadane, takie jak powiązanie footprintu komponentu i symbolu schematowego, parametry, ścieżki plików, łącza do źródeł danych łańcucha dostaw komponentów i inne. Informacje te mogą znajdować się w bazie danych Firebird lub Oracle.
• File Storage – ten obszar File Storage przechowuje dane binarne w repozytorium VCS Enterprise Server. Dane binarne obejmują informacje takie jak dokumenty projektów PCB i schematów, footprinty, symbole, Draftsman oraz inne natywne lub nienatywne dokumenty Enterprise Server.

Ogólny przegląd narzędzia Altium do odtwarzania

Narzędzie Altium do odtwarzania nazywa się avbackup.exe. Jest to to samo narzędzie używane do wykonywania kopii zapasowych i odtwarzania w Enterprise Server. Jest to narzędzie wiersza poleceń, które administratorzy IT mogą uruchamiać, aby odtworzyć dane Enterprise Server. avbackup.exe to to samo narzędzie używane do odtwarzania, gdy Enterprise Server jest skonfigurowany z domyślnym backendem bazy danych Firebird lub gdy jako backend używana jest baza danych Oracle.

Podczas używania avbackup.exe w implementacji Enterprise Server korzystającej z bazy danych Oracle administratorzy powinni pamiętać o następujących kwestiach:

1. avbackup.exe NOT nie obsługuje odtwarzania metadanych Enterprise Server do bazy danych Oracle. Ta funkcja działa tylko w implementacjach Enterprise Server używających backendu bazy danych Firebird, który został pierwotnie automatycznie skonfigurowany przez instalator Enterprise Server.
2. avbackup.exe przyjmuje plik Zip, który generuje, gdy jest używany jako narzędzie do tworzenia kopii zapasowej. Ten plik Zip zawiera wszystkie binarne dane Enterprise Server.
3. Enterprise Server musi być uruchomiony. avbackup.exe automatycznie zatrzyma wszystkie usługi Enterprise Server (w tym usługi IIS) podczas odtwarzania danych, a następnie po pomyślnym odtworzeniu uruchomi ponownie wszystkie zatrzymane usługi.

Przykładowe odtwarzanie danych Enterprise Server z backendem Oracle na platformie Windows

W tym przykładzie instrukcje są również dostosowane do mniejszych firm, które mogą nie mieć dedykowanego administratora bazy danych Oracle (DBA), ale nadal muszą odtworzyć Enterprise Server i powiązane dane Oracle w swojej sieci. Poniższe kroki pokazują, jak podstawowa kopia zapasowa Enterprise Server i powiązanej bazy danych Oracle może zostać odtworzona na nowej maszynie i w nowej bazie danych Oracle.

Wymagane elementy

• Istniejąca, działająca instancja Enterprise Server z backendem Oracle.
• Istniejące foldery i źródła danych:
  • Foldery, w których będą znajdować się dane Enterprise Server i Oracle, muszą już istnieć i zawierać kopię pliku zip kopii zapasowej Enterprise Server oraz plik Oracle .DMP.
• Dostęp administracyjny do maszyny hosta Enterprise Server. Jest to wymagane, aby poprawnie uruchomić narzędzie wiersza poleceń do kopii zapasowej Enterprise Server (avbackup.exe).
• Odpowiedni dostęp DBA do serwera Oracle (tj. dodanie konta Windows użytkownika do roli sysDBA w środowisku Windows).

Procedura odtwarzania

1. Jeśli nie skonfigurowano wcześniej instancji Enterprise Server z backendem Oracle, przeczytaj dokument Installing Altium On-Prem Enterprise Server with an Oracle Backend, aby zobaczyć przykład konfiguracji Enterprise Server z użyciem backendu Oracle na nowej maszynie.
2. Na tym etapie powinieneś mieć już istniejącą instancję Enterprise Server z Oracle – wynikającą z nowej lub wcześniejszej instalacji.
3. Na maszynie hosta Enterprise Server:
   1. Utwórz folder do odtwarzania (pomaga stosowanie wspólnych ścieżek plików, na przykład: C:\Backups). Umieść w tym folderze plik Zip kopii zapasowej Enterprise Server.
   2. Odtwórz dane Enterprise Server, uruchamiając narzędzie avbackup.exe jako administrator. Narzędzie znajduje się w folderze C:\Program Files (x86)\Altium\Altium NEXUS Server\Tools\BackupTool.
   3. Zatrzymaj usługi IIS Enterprise Server lub wyłącz maszynę hosta Enterprise Server. Zapobiegnie to niezamierzonym operacjom zapisu do bazy danych Oracle przez usługi Enterprise Server.

4. Na maszynie hosta bazy danych Oracle:
   1. Utwórz folder do odtwarzania i umieść w nim plik Oracle .dmp (pomaga stosowanie wspólnych ścieżek plików, na przykład: C:\Backups).
   2. Usuń (drop/delete) istniejący schemat i konto użytkownika z bazy danych Oracle.

Usunięcie konta użytkownika Oracle i powiązanego z nim schematu można wykonać w następujący sposób. W tym przykładzie usuniemy istniejące konto użytkownika ANSUSER313 i powiązany z nim schemat z bazy danych Oracle w systemie Microsoft Windows:

1. Uruchom wiersz poleceń z uprawnieniami administratora.
2. Zatrzymaj usługi IIS, jeśli są obecne na maszynie Oracle, używając polecenia: net stop WAS, następnie naciśnij Y i Enter.
3. Połącz się z bazą Oracle, uruchamiając sesję SqlPlus:

sqlplus / as sysdba

shutdown immediate;

startup restrict;

4. Usuń schemat powiązany z Enterprise Server (w tym przykładzie ANSUSER313 to nazwa schematu, który chcemy usunąć):

drop user ANSUSER313 cascade;

5. Ponownie aktywuj bazę danych w normalny sposób, uruchamiając ponownie maszynę lub używając następujących poleceń:

shutdown immediate;

startup;

3. Utwórz identyczny schemat na serwerze Oracle i nadaj podwyższone uprawnienia:
   1. Otwórz wiersz poleceń jako administrator i wpisz:

sqlplus / as sysdba;

CREATE user ANSUSER313 identified by “Altium”;

GRANT ALL PRIVILEGES TO ANSUSER313;

GRANT IMP_FULL_DATABASE TO ANSUSER313;

2. Alternatywnie możesz tymczasowo nadać temu użytkownikowi rolę DBA, zaimportować pliki, a następnie odebrać to uprawnienie, jak pokazano poniżej:

GRANT DBA TO ANSUSER313;

3. Po pomyślnym zaimportowaniu bazy danych odbierz uprawnienia DBA:

revoke DBA from ANSUSER313;

4. Odtwórz dane Oracle (ta sekcja zakłada, że konto użytkownika i schematy mają nazwę ANSUSER313 oraz hasło Altium):
   1. Uruchom wiersz poleceń z uprawnieniami administratora
   2. Zatrzymaj serwery IIS, używając polecenia:

net stop WAS

3. Zaimportuj dane Oracle. Przykładowe polecenie importu to:

imp ANSUSER313/Altium@xe file=c:\Backups\ANSUSER313.dmp log=c:\Backups\ANSUSER313_import.log fromuser=ANSUSER313 touser=ANSUSER313

gdzie,

ANSUSER313 – użytkownik mający pełne uprawnienia do schematu oraz prawa dostępu do bazy danych.

Altium – hasło do konta użytkownika Oracle powiązanego z Enterprise Server.

xe – nazwa usługi sieciowej docelowej bazy danych zawarta w tnsnames.ora.

file = c:\Backups\ANSUSER313.dmp – lokalizacja kopii zapasowej.

log = c:\Backups\ANSUSER313_import.log – log odtwarzania (opcjonalnie).

fromuser=ANSUSER313 – właściciel schematu kopii zapasowej.

touser=ANSUSER313 – nowy właściciel schematu (jeśli właściciele są różni, musisz utworzyć nowego użytkownika z odpowiednimi uprawnieniami i rolami).

5. Zweryfikuj integralność danych.
   1. Sprawdź plik tnsname.ora. Należy zaktualizować nazwę usługi sieciowej (jeśli zmieniono serwer DB).
   2. Zweryfikuj ustawienia serwera IIS. Sprawdź, czy wartość w kolumnie „Host name” w powiązaniach (bindings) w IIS Manager jest aktualna. Powinna to być bieżąca w pełni kwalifikowana nazwa domenowa (FQDN) Twojego Enterprise Server.
   3. Sprawdź wartości następujących parametrów w pliku C:\Program Files (x86)\Altium\Altium NEXUS Server\LocalVault.ini.
      1. Domain – nazwa Twojej domeny.
      2. WebsiteDomain – FQDN Twojego Enterprise Server.
      3. DataSourceType=Oracle – jeśli używasz bazy Oracle DB.
      4. User=ANSUSER313 – właściciel schematu.
      5. Password=Altium – hasło użytkownika zdefiniowanego przez DBA.
      6. DBLocation=FQDN lub ip_address:1521 – adres Twojego serwera DB.
      7. DatabaseName=xe – bieżąca nazwa usługi sieciowej DB, zawarta w tnsnames.ora.

Wnioski

Chociaż powyższy przykład zawiera dodatkowe szczegóły dotyczące integracji i operacji na bazie Oracle Database, istnieją tylko trzy kluczowe kroki przywracania danych Enterprise Server:

1. Krok 1: zatrzymaj usługi IIS oraz pule aplikacji IIS dla Enterprise Server.
2. Krok 2: przywróć dane Enterprise Server .
3. Krok 3: przywróć dane Oracle powiązane z Enterprise Server.

Wykonanie tej procedury w opisanej kolejności znacząco zmniejsza ryzyko uszkodzenia danych wynikające z niedopasowania bazy Oracle i binarnych danych Enterprise Server.