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 ruchu danych

• Przyznaj wymagane uprawnienia w źródle danych

• Skonfiguruj łącznik źródła danych

Zainstaluj produkt R4Z w systemie z/OS

Aby móc pracowaź ze źródłem IBM DB2 for z/OS, najpierw należy zainstalować i skonfigurować produkt R4Z w systemie z/OS.

1. Przejście do Pobieranie produktów.

2. Wybierz Integracja danych Qlik.

3. Przewiń w dół listy Produkt i wybierz Integracja danych Qlik Cloud.

4. W kolumnie Łącze do pobierania kliknij łącze do pliku QlikReplicate_2022.5.0.191_r4z.zip, aby rozpocząć pobieranie.

5. Pobierz program R4Z i zainstaluj go na swoim źródle danych z/OS.

Instrukcję instalacji i konfiguracji zawiera temat Instalowanie i konfigurowanie R4Z.

Instalowanie i konfiguracja sterownika

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ę Brama danych ruchu danych:

   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ę Brama danych ruchu danych:

   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ę Brama danych ruchu danych:

   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ę Brama danych ruchu danych:

   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.

Instalowanie sterownika ręcznie

Sterownik driver należy instalować ręcznie tylko wtedy, gdy automatyczna instalacja nie zakończyła się pomyślnie.

Pakiet klienta ODBC do systemu Linux

Możesz wybrać instalację pełnego pakietu klienta ODBC lub samego klienta serwera danych, jak opisano poniżej w rozdziale Klient serwera danych w systemie Linux.

Na komputerze z Brama danych ruchu danych otwórz wiersz poleceń i wykonaj następujące czynności:

1. Zatrzymaj usługę Brama danych ruchu danych:

   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 v11.5.8_linuxx64_server_dec.tar.gz i wybierz opcję „CLIENT”.

4. Jeśli komputer Brama danych ruchu danych 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. Zmień katalog roboczy na <katalog_instalacji_Brama danych ruchu danych>/bin.

6. 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

7. Opcjonalnie potwierdź, że lokalizacja sterownika została skopiowana:

   cat site_arep_login.sh

8. Dodaj następujący wpis do pliku odbcinst.ini w katalogu /etc:

   [IBM DB2 ODBC DRIVER]

   Driver = /home/db2clnt1/sqllib/lib/libdb2o.so

   fileusage=1

   dontdlclose=1

9. Uruchom usługę Brama danych ruchu danych:

   sudo systemctl start repagent

10. Opcjonalnie potwierdź, że usługa została uruchomiona:

    sudo systemctl status repagent

    Status powinien być następujący:

    Active: active (running) since <timestamp> ago

Klient serwera danych w systemie Linux

1. Pobierz pakiet v11.5.8_linuxx64_client.tar.gz z witryny IBM Fix Central i wyodrębnij pliki.

2. Zatrzymaj usługę Brama danych ruchu danych:

   sudo service repagent stop

3. Opcjonalnie potwierdź, że usługa została zatrzymana:

   sudo service repagent status

   Status powinien być następujący:

   Active: inactive (dead) since <timestamp> ago

4. Zmień katalog roboczy na /opt/client i uruchom db2_install.

5. Utwórz plik RSP (zobacz Przykładowy plik RSP poniżej), a następnie uruchom następujące polecenie (z /opt/client):

   ./db2setup -r /file-path/client.rsp

6. Dodaj następujący wpis do pliku odbcinst.ini w katalogu /etc:

   [IBM DB2 ODBC DRIVER]

   Driver = /opt/ibm/db2/V11.5/lib64/libdb2o.so

   fileusage=1

   dontdlclose=1

9. Uruchom usługę Brama danych ruchu danych:

   sudo service repagent start

10. Opcjonalnie potwierdź, że usługa została uruchomiona:

    sudo service repagent status

    Status powinien być następujący:

    Active: active (running) since <timestamp> ago

Przykładowy plik RSP

*-----------------------------------------------------
* Generated response file used by the DB2 Setup wizard
* generation time: 2/18/22 4:10 PM
*-----------------------------------------------------
*  Product Installation
LIC_AGREEMENT       = ACCEPT
PROD       = CLIENT
FILE       = /opt/ibm/db2/V11.5
INSTALL_TYPE       = TYPICAL
* ----------------------------------------------
*  Instance properties
* ----------------------------------------------
INSTANCE       = inst1
inst1.TYPE       = client
*  Instance-owning user
inst1.NAME       = qlik
inst1.UID       = 1000
inst1.GROUP_NAME       = qlik
inst1.HOME_DIRECTORY       = /home/qlik
inst1.AUTOSTART       = NO
*-----------------------------------------------
*  Installed Languages
*-----------------------------------------------
LANG       = EN
		

Instalacja ODBC na serwerze

Powiąż plan, który ma być używany dla ODBC, zgodnie z definicją w wartości PLANNAME= w pliku inicjalizacyjnym ODBC. Domyślna nazwa to DSNACLI. Zadanie BIND można znaleźć w członku DSNTIJCL, który znajduje się w bibliotece SDSNSAMP źródłowej instalacji DB2.

Użyj polecenia wiązania DB2CLI, aby powiązać pakiety dostarczone przez ODBC ze swoim planowanym podsystemem źródłowym DB2 z/OS. To działanie jest opisane na stronie Configuring your developer and runtime environment (Konfiguracja środowiska programistycznego i wykonawczego) w witrynie IBM. Informacje na temat narzędzia DB2CLI, włącznie z przykładem narzędzia do wiązania, znajdują się na stronie db2cli - DB2 interactive CLI command (db2cli – interaktywne polecenie CLI DB2) w witrynie IBM.

Wymagane uprawnienia

Aby Brama danych ruchu danych mógł pobierać dane z tabel źródłowych (w trybach pełnego ładowania i przechwytywania zmian danych), użytkownik określony w ustawieniach łącznika IBM DB2 for z/OS musi mieć przydzielone następujące uprawnienia:

• EXECUTE na IFI wczytującym UDTF (wymagane tylko dla przechwytywania zmian danych)
• SELECT na tabelach źródłowych i w następujących tabelach katalogu systemowego:
  • SYSIBM.SYSDUMMY1
  • SYSIBM.SYSTABLES
  • SYSIBM.SYSTABLESPACE
  • SYSIBM.SYSPARMS
  • SYSIBM.SYSROUTINES
  • SYSIBM.SYSCOLUMNS
  • SYSIBM.SYSLGRNX
  • SYSIBM.SYSTABLEPART
• MONITOR2, aby umożliwić rozpoczynanie sesji IFI (wymagane tylko dla przechwytywania zmian danych)

Przechwytywanie zmian danych

Aby przechwycić zmiany z IBM DB2 for z/OS, Brama danych ruchu danych używa specjalnego programu – wywoływanego jako procedura zewnętrzna – który jest zdefiniowaną przez użytkownika funkcją tabeli (UDTF). Ten program (moduł ładujący), jak również UDTF, należy zainstalować i skonfigurować w systemie z/OS, aby móc przechwytywać zmiany. Procedurę instalacji, która powinna zostać wykonana przez DBA, zawiera Instalowanie i konfigurowanie R4Z.

Dodatkowo każda tabela, której zmiany mają być przechwytywane, musi mieć ustawiony atrybut DATA CAPTURE CHANGES. Można to zrobić ręcznie lub można pozwolić Brama danych ruchu danych na zrobienie tego przez pozostawienie włączonej opcji Automatically enable DATA CAPTURE CHANGES (requires admin privilege) (Automatycznie włącz PRZECHWYTYWANIE ZMIAN DANYCH (wymaga uprawnień administratora)) (domyślne) w ustawieniach łącznik (jest to ustawienie domyślne).