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

• 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 Ruch danych 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 Ruch danych 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 Ruch danych 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 Ruch danych 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 komputer Data Movement gateway nie ma instancji DB2, utwórz ją, wykonując następujące polecenia:

   adduser <db2_instance_name>

   /opt/ibm/db2/V11.5/instance/db2icrt <db2_instance_name>

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 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 <db_name_from_łącznik_connection_settings> -host <server_name_from_łącznik_connection_settings> -port <port_from_łącznik_connection_settings>

   2. Zmień katalog na Data Movement gatewaybin (<install_dir>/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.