# Wymagania wstępne Zanim będzie można umieszczać lub replikować dane, należy spełnić następujące wymagania wstępne: * Zainstaluj wymagany driver na serwerze bramy Brama danych ruchu danych Informacja Jest to wymagane tylko wtedy, gdy pracujesz z bramą Brama danych ruchu danych. Informacje o zaletach bramy Brama danych ruchu danych i o okolicznościach, w których jest wymagana, zawiera temat [Brama danych Qlik — ruch danych](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm). * Przyznaj wymagane uprawnienia w źródle danych * Skonfiguruj łącznik źródła danych ## Konfiguracja sterowników Sterownik driver można zainstalować za pomocą Narzędzia do instalacji sterowników (zalecane) lub ręcznie. Instalacji ręcznej należy próbować tylko w mało prawdopodobnym przypadku wystąpienia problemu z Narzędziem do instalacji sterowników. ### Używanie Narzędzia do instalacji sterowników w celu instalacji sterownika W tej sekcji opisano, jak zainstalować wymagany driver. Proces ten obejmuje uruchomienie skryptu, który automatycznie pobierze, zainstaluje i skonfiguruje wymagany driver. W razie potrzeby można także uruchamiać skrypty, aby zaktualizować i odinstalować driver. ### Przygotowanie instalacji * Na serwerze bramy Data Movement musi być zainstalowane środowisko Python 3.6 lub nowsze. Środowisko Python jest preinstalowane w większości dystrybucji systemu Linux. Aby sprawdzić, która wersja środowiska Pythona jest zainstalowana w Twoim systemie, uruchom następujące polecenie: python3 --version ### Instalowanie aplikacji driver Aby pobrać i zainstalować driver: 1. Na urządzenie bramy Data Movement zmień katalog roboczy na: opt/qlik/gateway/movement/drivers/bin 2. Wykonaj następujące polecenie: Składnia: ./install oracle Jeśli driver nie może zostać pobrany (ze względu na ograniczenia dostępu lub problemy techniczne), zostanie wyświetlony komunikat informujący, skąd pobrać driver i dokąd go skopiować na urządzenie bramy Data Movement. Po wykonaniu tej czynności ponownie uruchom polecenie install oracle. W przeciwnym razie zostanie wyświetlona umowa licencyjna dotycząca driver. 3. Wykonaj jedną z poniższych czynności: * Naciśnij klawisz [Enter] wielokrotnie, aby powoli przewinąć treść umowy licencyjnej. * Naciśnij klawisz spacji wielokrotnie, aby szybko przewinąć treść umowy licencyjnej. * Naciśnij klawisz „q”, aby zamknąć tekst umowy licencyjnej i wyświetlić opcje jej akceptacji. 4. Wykonaj jedną z poniższych czynności: * Wpisz „y” i naciśnij klawisz [Enter], aby zaakceptować umowę licencyjną i rozpocząć instalację. * Wpisz „n” i naciśnij klawisz [Enter], aby odrzucić umowę licencyjną i zakończyć instalację. * Wpisz „v” i naciśnij klawisz [Enter], aby ponownie wyświetlić umowę licencyjną. Zostanie zainstalowany driver. ### driver — aktualizacja Uruchom polecenie aktualizacji, jeśli chcesz odinstalować driver w poprzedniej wersji, zanim zainstalujesz dostarczony driver. Aby pobrać i zaktualizować driver: 1. Na urządzenie bramy Data Movement zmień katalog roboczy na: opt/qlik/gateway/movement/drivers/bin 2. Wykonaj następujące polecenie: Składnia: ./update oracle Jeśli driver nie może zostać pobrany (ze względu na ograniczenia dostępu lub problemy techniczne), zostanie wyświetlony komunikat informujący, skąd pobrać driver i dokąd go skopiować na urządzenie bramy Data Movement. Po wykonaniu tej czynności ponownie uruchom polecenie update oracle. W przeciwnym razie zostanie wyświetlona umowa licencyjna dotycząca driver. 3. Wykonaj jedną z poniższych czynności: * Naciśnij klawisz [Enter] wielokrotnie, aby powoli przewinąć treść umowy licencyjnej. * Naciśnij klawisz spacji wielokrotnie, aby szybko przewinąć treść umowy licencyjnej. * Naciśnij klawisz „q”, aby zamknąć tekst umowy licencyjnej i wyświetlić opcje jej akceptacji. 4. Wykonaj jedną z poniższych czynności: * Wpisz „y” i naciśnij klawisz [Enter], aby zaakceptować umowę licencyjną i rozpocząć instalację. * Wpisz „n” i naciśnij klawisz [Enter], aby odrzucić umowę licencyjną i zakończyć instalację. * Wpisz „v” i naciśnij klawisz [Enter], aby wyświetlić umowę licencyjną od początku. Stary driver zostanie odinstalowany, a zainstalowany zostanie nowy driver. ### driver — odinstalowywanie Uruchom polecenie odinstalowania, jeśli chcesz odinstalować driver. Aby odinstalować driver: 1. Zatrzymaj wszystkie zadania skonfigurowane do korzystania z tego łącznika. 2. Na urządzenie bramy Data Movement zmień katalog roboczy na: opt/qlik/gateway/movement/drivers/bin 3. Wykonaj następujące polecenie: Składnia: ./uninstall oracle Sterownik driverzostanie odinstalowany. ### Instalowanie sterownika ręcznie Sterownik driver należy instalować ręcznie tylko wtedy, gdy automatyczna instalacja nie zakończyła się pomyślnie. Po zainstalowaniu Brama danych ruchu danych pobierz sterownik oracle-instantclient-basiclite-<wersja>.x86\_64.rpm. Łącze do bezpośredniego pobrania obsługiwanej wersji można znaleźć w sekcji binary-artifacts w pliku /opt/qlik/gateway/movement/drivers/manifests/oracle.yaml. Po zakończeniu pobierania skopiuj plik RPM na komputer z Brama danych ruchu danych. Następnie na serwerze Data Movement gateway otwórz wiersz poleceń i wykonaj następujące czynności: 1. Zatrzymaj usługę Data Movement gateway: sudo systemctl stop repagent 2. Opcjonalnie potwierdź, że usługa została zatrzymana: sudo systemctl status repagent Status powinien być następujący: Active: inactive (dead) since <timestamp> ago 3. Zainstaluj sterownik (RPM). 4. Dodatkowo, jeśli nie ma go jeszcze w systemie, utwórz symboliczny link `$Oracle_Home\lib` w katalogu. Nadaj nazwę łącza `libclntsh.so` i wskaż na konkretną wersję tego pliku. Przykład: lrwxrwxrwx 1 oracle oracle 63 Oct 2 14:16 libclntsh.so -> /u01/app/oracle/home/lib/libclntsh.so.21.1 5. Zmień katalog roboczy na <Data Movement gateway-Install-Dir>/bin i dodaj zmienną środowiskową `LD_LIBRARY_PATH` do katalogu Oracle Instant Client i do katalogu Data Movement gateway lib, kopiując lokalizację sterownika do pliku `site_arep_login.sh`: echo "export LD\_LIBRARY\_PATH=\$LD\_LIBRARY\_PATH:/opt/oracle/instantclient\_<version>:/opt/qlik/gateway/movement/lib/" >> site\_arep\_login.sh 6. Opcjonalnie potwierdź, że lokalizacja sterownika została skopiowana: ``` cat site_arep_login.sh ``` 7. Uruchom usługę Data Movement gateway: sudo systemctl start repagent 8. Opcjonalnie potwierdź, że usługa została uruchomiona: sudo systemctl status repagent Status powinien być następujący: Active: active (running) since <timestamp> ago ## Zapewnij dostęp do konta Oracle Musisz zapewnić użytkownikowi dostęp do konta OracleData Movement gateway. Ten użytkownik musi mieć uprawnienia do odczytu/zapisu w bazie danych Oracle. Aby uzyskać informacje na temat ustawiania dostępu do konta Oracle, zobacz [Wymagane uprawnienia](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Global_Common/Content/SharedReplicateHDD/Oracle/OracleDBSource_Security.htm). ## Upewnij się, że tryb ARCHIWELOG jest włączony Oracle może być uruchomiony w dwóch różnych trybach: trybie `ARCHIVELOG`i trybie `NOARCHIVELOG`. Aby użyć logów Oracle z Data Movement gateway, uruchom bazę danych w trybie`ARCHIVELOG`. Jeśli dziennik nie jest ustawiony na tryb`ARCHIVELOG`, wykonaj następujące zapytanie: `ALTER database ARCHIVELOG` Uwaga: jeśli instancja bazy danych Oracle znajduje się w Amazon RDS, należy wykonać inne polecenie. Więcej informacji zawierają sekcje [Włączanie automatycznych kopii zapasowych](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Global_Common/Content/SharedReplicateHDD/Oracle/oracle_rds_prerequisites.htm#Enabling) i [Konfigurowanie archiwizacji](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Global_Common/Content/SharedReplicateHDD/Oracle/oracle_rds_prerequisites.htm#ar_oracleds_385117211_chdddeji) ## Skonfiguruj logowanie dodatkowe Logowanie dodatkowe musi być włączone dla bazy danych Oracle, zarówno na poziomie bazy danych, jak i na poziomie tabeli. Informacja W Przenoszenieprzypadku korzystania ze środowiska Oracle standby logowanie dodatkowe musi być skonfigurowane w podstawowej instancji Oracle (jak opisano poniżej), a nie w instancji standby. ### Sprawdzanie i włączanie dodatkowego logowania na poziomie bazy danych 1. Wykonaj następujące zapytanie: SELECT name, value, description FROM v$parameter WHERE name = 'compatible'; Zwrócony wynik powinien wynosić ` GE to ``n``.``n``.``n` gdzie `n``.``n``.``n` jest wersją bazy danych Oracle (np. 10.0.0). Ostrzeżenie Wartość parametru musi odpowiadać rzeczywistej wersji bazy danych. 2. Wykonaj następujące zapytanie: SELECT supplemental\_log\_data\_min FROM v$database; Zwrócony wynik powinien wynosić YES lub IMPLICIT. Włącz dodatkowe logowanie, wykonując poniższe zapytanie: ALTER DATABASE ADD SUPPLEMENTAL LOG DATA Informacja Jeśli instancja bazy danych Oracle znajduje się w Amazon RDS, należy wykonać inne polecenie. Więcej informacji zawiera temat [Praca z usługą Amazon RDS for Oracle](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Global_Common/Content/SharedReplicateHDD/Oracle/oracle_rds_prerequisites.htm). ### Sprawdzanie i włączanie dodatkowego logowania na poziomie tabeli 1. Aby sprawdzić, czy logowanie dodatkowe jest włączone na poziomie tabeli, wykonaj poniższe zapytanie: Składnia: select count(\*) from ALL\_LOG\_GROUPS where LOG\_GROUP\_TYPE='ALL COLUMN LOGGING' and OWNER= 'OWNER' and TABLE\_NAME='TABLE-NAME'; Przykład: select count(\*) from ALL\_LOG\_GROUPS where LOG\_GROUP\_TYPE='ALL COLUMN LOGGING' and OWNER= 'HR' and TABLE\_NAME='EMPLOYEES'; 2. Aby udostępnić logowanie dodatkowe na poziomie tabeli, wykonaj poniższe zapytanie: Składnia: ALTER TABLE TABLE-NAME ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS; Przykład: ALTER TABLE HR.EMPLOYEES ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS; Zob. także: [Wymagane uprawnienia](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Global_Common/Content/SharedReplicateHDD/Oracle/OracleDBSource_Security.htm)