# Wymagania wstępne Poniższa sekcja zawiera opis wymagań wstępnych dotyczących pracy z łącznikiem IBM DB2 for LUW. 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 pobieranie sterownika, skopiowanie go do wymaganego folderu (zobacz poniżej) i uruchomienie skryptu, który automatycznie 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 * Pobierz oprogramowanie IBM Data Server Client „<wersja>\_linuxx64\_client.tar.gz” z witryny internetowej IBM. Obsługiwaną wersję można znaleźć w sekcji binary-artifacts w pliku /opt/qlik/gateway/movement/drivers/manifests/db2.yaml. Po zakończeniu pobierania skopiuj plik do: /opt/qlik/gateway/movement/drivers/db2 ### Instalowanie aplikacji driver Aby zainstalować driver: 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. Na urządzenie bramy Data Movement zmień katalog roboczy na: opt/qlik/gateway/movement/drivers/bin 4. Wykonaj następujące polecenie: Składnia: ./install db2 W przeciwnym razie zostanie wyświetlona umowa licencyjna dotycząca driver. 5. 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. 6. 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. 7. Poczekaj na zakończenie instalacji (wskazane komunikatem „Ukończono!”), a następnie 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 ### driver — aktualizacja Uruchom polecenie aktualizacji, jeśli chcesz odinstalować driver w poprzedniej wersji, zanim zainstalujesz dostarczony driver. Aby zaktualizować driver: 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. Na urządzenie bramy Data Movement zmień katalog roboczy na: opt/qlik/gateway/movement/drivers/bin 4. Wykonaj następujące polecenie: Składnia: ./update db2 W przeciwnym razie zostanie wyświetlona umowa licencyjna dotycząca driver. 5. 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. 6. 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. 7. Poczekaj na zakończenie instalacji (wskazane komunikatem „Ukończono!”), a następnie 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 ### 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 db2 Sterownik driverzostanie odinstalowany. ### Ręczne instalowanie sterownika Sterownik driver należy instalować ręcznie tylko wtedy, gdy automatyczna instalacja nie zakończyła się pomyślnie. Na komputerze z 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 pakiet IBM Data Client v11.5.8\_linuxx64\_server\_t.tar.gz i wybierz instalację typu „CLIENT”. 4. Jeśli maszyna Data Movement gateway nie ma instancji DB2, utwórz ją, wykonując następujące polecenia: `adduser ` `/opt/ibm/db2/V``11``.5/instance/db2icrt ` 5. Dodaj lokalizację sterownika DB2 do ścieżki biblioteki systemu Linux. Aby to zrobić, dodaj następujący wiersz do pliku **site\_ arep\_login.sh** : `export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/lib` gdzie `path` jest ścieżką CLIENT do sterownika. **Przykład (z db2clnt1 jako nazwą instancji):** `export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/db2clnt1/sqllib/lib:/home/db2clnt1/sqllib/lib64/gskit ` `export DB2INSTANCE=db2clnt1` 6. Utwórz nowy plik o nazwie odbcinst.ini w folderze **/etc** i dodaj następujący wpis: `[IBM DB2 ODBC DRIVER]` `Driver = /home/db2clnt1/sqllib/lib/libdb2o.so` `fileusage=1` `dontdlclose=1` 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 9. Zdefiniuj ustawienia połączenia IBM DB2 for LUW zgodnie z opisem w [IBM DB2 for LUW](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/SourcesConnections/IBM4DB2-luw/IBM4DB2-luw-source.htm) i kliknij Testuj połączenie. Jeśli pojawi się następujący błąd: `Cannot connect to DB2 LUW Server ODBC unknown error.` `RetCode: SQL_ERROR SqlState: NativeError: -1390 Message: [unixODBC][IBM][CLI Driver] SQL10007N Message "0" could not be retrieved. Reason code: "3". ODBC general error.` 1. Wykonaj następujące polecenie: `/opt/ibm/db2/V11.5/bin /db2cli writecfg add -database -host -port ` 2. Zmień katalog bin usługi Data Movement gateway (<katalog\_instalacji>/bin). Następnie zatrzymaj i uruchom Data Movement gateway usługę w sposób opisany powyżej. ## Włączanie CDC w bazie danych Aby włączyć CDC (Change Data Capture): * Ustaw bazę danych tak, aby możliwe było jej odzyskiwanie – aby przechwytywać zmiany, Data Movement gateway wymaga, aby konfiguracja bazy danych umożliwiała jej odzyskiwanie. Baza danych jest możliwa do odzyskiwania, jeśli którykolwiek z parametrów `LOGARCHMETH1` i `LOGARCHMETH2` lub oba te parametry są wyłączone. * Uprawnienia – użytkownik Qlik musi mieć przydzielone następujące uprawnienia: * SYSADM lub DBADM * DATAACCESS * Aby włączyć przechwytywanie danych z IBM DB2 for LUW, należy utworzyć tabele źródłowe w następujący sposób: CREATE / ALTER TABLE table-name …. DATA CAPTURE CHANGES [INCLUDE LONGVAR COLUMNS]; Można skonfigurować Data Movement gateway do wykonywania tej operacji, wybierając opcję Automatically enable DATA CAPTURE CHANGES (requires admin privilege) [Automatycznie włącz przechwytywanie zmian danych — wymaga uprawnień administratora] w ustawieniach łącznik lub wykonać to ręcznie. Informacja Kiedy jest wybrana opcja Automatically enable DATA CAPTURE CHANGES (requires admin privilege) [Automatycznie włącz przechwytywanie zmian danych — wymaga uprawnień administratora], Data Movement gateway wykonuje operację `ALTER TABLE` w chwili uruchomienia zadania. Jeśli zostanie dodana nowa tabela (do źródłowej bazy danych) pasująca do wzorca wyboru tabeli już w trakcie wykonywania zadania, to Data Movement gateway będzie przechwytywać jej zmiany tylko, jeśli zostanie ona utworzona z opisanym powyżej atrybutem `DATA CAPTURE CHANGE`.