Przywracanie Altium On-Prem Enterprise Server z backendem Oracle

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 tym 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 zrzut danych Oracle zgodnie z dokumentem 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 importu danych Oracle powinien być obecny administrator bazy danych (DBA). Co najmniej użytkownik korzystający z tego przewodnika 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 dane są importowane 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 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 Restore Tool

Narzędzie do odtwarzania Altium nazywa się avbackup.exe. Jest to to samo narzędzie używane do wykonywania kopii zapasowych i odtwarzania dla 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 nie NOT obsługuje odtwarzania metadanych Enterprise Server do bazy danych Oracle. Ta funkcja działa wyłącznie 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 uruchomi ponownie wszystkie zatrzymane usługi po pomyślnym odtworzeniu.

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 do poprawnego uruchomienia narzędzia 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 – albo w wyniku nowej, albo 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\Altium365\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 AESUSER313 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 AESUSER313 to nazwa schematu, który chcemy usunąć):

drop user AESUSER313 cascade;

5. Ponownie aktywuj bazę danych w normalny sposób, restartując 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 AESUSER313 identified by “Altium”;

GRANT ALL PRIVILEGES TO AESUSER313;

GRANT IMP_FULL_DATABASE TO AESUSER313;

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

GRANT DBA TO AESUSER313;

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

revoke DBA from AESUSER313;

4. Odtwórz dane Oracle (ta sekcja zakłada, że konto użytkownika i schematy mają nazwę AESUSER313 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 AESUSER313/Altium@xe file=c:\Backups\AESUSER313.dmp log=c:\Backups\AESUSER313_import.log fromuser=AESUSER313 touser=AESUSER313

gdzie,

AESUSER313 – 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\AESUSER313.dmp – lokalizacja kopii zapasowej.

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

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

touser=AESUSER313 – 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 kolumna „Host name” w powiązaniach (bindings) w IIS Manager jest aktualna. Powinna zawierać bieżącą w pełni kwalifikowaną nazwę domenową (FQDN) Twojego Enterprise Server.
   3. Sprawdź wartości następujących parametrów w pliku C:\Program Files (x86)\Altium\Altium365\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=AESUSER313 – 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.

Podsumowanie

Chociaż powyższy przykład zawiera dodatkowe szczegóły dotyczące łączenia się z bazą Oracle Database i wykonywania na niej operacji, istnieją tylko trzy kluczowe kroki przywracania danych Enterprise Server:

1. Krok 1: zatrzymaj usługi IIS oraz pule aplikacji (Application Pools) Enterprise Server w IIS.
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 danych binarnych Enterprise Server.