Prerequisiti

La sezione seguente descrive i prerequisiti per l'uso del connettore IBM DB2 for LUW.

Prima di trasferire o replicare i dati, assicurarsi di aver completato i seguenti prerequisiti:

• Installare il driver richiesto sul server del gateway Movimento dati

• Concedere le autorizzazioni necessarie alla sorgente dati

• Configurare il connettore della sorgente dati

Configurazione del driver

È possibile installare driver utilizzando l'utilità di installazione dei driver (procedura consigliata) oppure manualmente. Si consiglia di utilizzate l'installazione manuale nel caso improbabile che si riscontrasse un problema con l'utilità di installazione dei driver.

Utilizzo dell'utilità di installazione dei driver per installare il driver

Questa sezione descrive come installare il driver richiesto. Per questo processo è necessario scaricare il driver, copiarlo nella cartella richiesta (vedere sotto) ed eseguire uno script che lo installerà e configurerà automaticamente. È inoltre possibile eseguire script per aggiornare e disinstallare il driver secondo le necessità.

Preparazione dell'installazione

• Assicurarsi che Python 3.6.x o versione successiva sia installato sul server del gateway di Spostamento dati.

  Python è preinstallato nella maggior parte delle distribuzioni Linux. È possibile verificare quale versione di Python è installata sul sistema, eseguendo il seguente comando:

  python3 --version

• Scaricare il client IBM Data Server <versione>_linuxx64_client.tar.gz" dal sito web di IBM. È possibile trovare la versione supportata in binary-artifacts in /opt/qlik/gateway/movement/drivers/manifests/db2. Una volta completato il download, copiare il file in:

  /opt/qlik/gateway/movement/drivers/db2

Installazione di driver

installare driver:

1. Arrestare il servizio gateway di Data Movement:

   sudo systemctl stop repagent

2. Facoltativamente, confermare che il servizio è stato interrotto:

   sudo systemctl status repagent

   Lo stato dovrebbe essere il seguente:

   Active: inactive (dead) since <timestamp> ago

3. Sul computer gateway Spostamento dati, cambiare la directory di lavoro in:

   opt/qlik/gateway/movement/drivers/bin

4. Eseguire il comando seguente:

   Sintassi:

   ./install db2

   Altrimenti, verrà visualizzato l'EULA del driver.

5. Effettuare una delle seguenti operazioni:

   • Premere ripetutamente [Invio] per scorrere lentamente l'EULA.
   • Premere ripetutamente la barra spaziatrice per scorrere rapidamente l'EULA.
   • Premere q per uscire dal testo della licenza e visualizzare le opzioni di accettazione dell'EULA.

6. Effettuare una delle seguenti operazioni:

   • Digitare "y" e premere [Invio] per accettare l'EULA e avviare l'installazione.
   • Digitare "n" e premere [Invio] per rifiutare l'EULA e uscire dall'installazione.

   • Digitare "v" e premere [Invio] per visualizzare nuovamente l'EULA.

Il driver verrà installato.

7. Attendere il completamento dell'installazione (indicato dal messaggio "Operazione completata"), quindi avviare il servizio gateway di Data Movement:

   sudo systemctl start repagent

8. Facoltativamente, conferma che il servizio si è avviato:

   sudo systemctl status repagent

   Lo stato dovrebbe essere il seguente:

   Active: active (running) since <timestamp> ago

Aggiornamento del driver

Eseguire il comando aggiorna se si desidera disinstallare le versioni precedenti del driver prima di installare il driver fornito.

Per e aggiornare driver:

1. Arrestare il servizio gateway di Data Movement:

   sudo systemctl stop repagent

2. Facoltativamente, confermare che il servizio è stato interrotto:

   sudo systemctl status repagent

   Lo stato dovrebbe essere il seguente:

   Active: inactive (dead) since <timestamp> ago

3. Sul computer gateway Spostamento dati, cambiare la directory di lavoro in:

   opt/qlik/gateway/movement/drivers/bin

4. Eseguire il comando seguente:

   Sintassi:

   ./update db2

   Altrimenti, verrà visualizzato l'EULA del driver.

5. Effettuare una delle seguenti operazioni:

   • Premere ripetutamente [Invio] per scorrere lentamente l'EULA.
   • Premere ripetutamente la barra spaziatrice per scorrere rapidamente l'EULA.
   • Premere q per uscire dal testo della licenza e visualizzare le opzioni di accettazione dell'EULA.

6. Effettuare una delle seguenti operazioni:

   • Digitare "y" e premere [Invio] per accettare l'EULA e avviare l'installazione.
   • Digitare "n" e premere [Invio] per rifiutare l'EULA e uscire dall'installazione.
   • Digitare "v" e premere [Invio] per rivedere l'EULA dall'inizio.

Il vecchio driver verrà disinstallato e il nuovo driver verrà installato.

7. Attendere il completamento dell'installazione (indicato dal messaggio "Operazione completata"), quindi avviare il servizio gateway di Data Movement:

   sudo systemctl start repagent

8. Facoltativamente, conferma che il servizio si è avviato:

   sudo systemctl status repagent

   Lo stato dovrebbe essere il seguente:

   Active: active (running) since <timestamp> ago

Disinstallazione del driver

Eseguire il comando di disinstallazione se si desidera disinstallare il driver.

Per disinstallare il driver:

1. interrompere tutte le attività configurate per utilizzare il connettore.

2. Sul computer gateway Spostamento dati, cambiare la directory di lavoro in:

   opt/qlik/gateway/movement/drivers/bin

3. Eseguire il comando seguente:

   Sintassi:

   ./uninstall db2

   Il driver verrà disinstallato.

Installazione manuale del driver

Si consiglia di tentare l'installazione manuale di driver nel caso in cui l'installazione automatizzata non venissa completata.

Sul computer gateway di Data Movement, aprire un prompt della shell e procedere come segue:

1. Arrestare il servizio gateway di Data Movement:

   sudo systemctl stop repagent

2. Facoltativamente, confermare che il servizio è stato interrotto:

   sudo systemctl status repagent

   Lo stato dovrebbe essere il seguente:

   Active: inactive (dead) since <timestamp> ago

3. Installare IBM Data Client v11.5.8_linuxx64_server_t.tar.gz; scegliere di installare “CLIENT”.

4. Se il computer gateway di Data Movement non dispone di un'istanza DB2, creane una eseguendo i seguenti comandi:

   adduser <db2_instance_name>

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

5. Aggiungere la posizione del driver DB2 al percorso della libreria Linux.

   Per fare ciò, aggiungere la seguente riga al file site_ arep_login.sh come segue:

   export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/lib

   dove path è il percorso del CLIENT al driver.

   Esempio (con db2clnt1 come nome dell'istanza):

   export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/db2clnt1/sqllib/lib:/home/db2clnt1/sqllib/lib64/gskit

   export DB2INSTANCE=db2clnt1

6. Creare un nuovo file chiamato odbcinst.ini sotto /etc e aggiungere la seguente voce:

   [IBM DB2 ODBC DRIVER]

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

   fileusage=1

   dontdlclose=1

7. Avviare il servizio gateway di Data Movement:

   sudo systemctl start repagent

8. Facoltativamente, confermare che il servizio si è avviato:

   sudo systemctl status repagent

   Lo stato dovrebbe essere il seguente:

   Active: active (running) since <timestamp> ago

9. Definire le impostazioni di connessione IBM DB2 per LUW come descritto in IBM DB2 per LUWe fare clic su Prova connessione.

   Se si riceve il seguente errore:

   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. Eseguire il comando seguente:

      /opt/ibm/db2/V11.5/bin /db2cli writecfg add -database <db_name_from_connettore_connection_settings> -host <server_name_from_connettore_connection_settings> -port <port_from_connettore_connection_settings>

   2. Passare alla directory gateway di Data Movementbin di (<install_dir>/bin). Quindi, interrompere e avviare il servizio gateway di Data Movement come descritto sopra.

Abilitazione di CDC sul database

Per abilitare il CDC (Change Data Capture):

• Imposta il database come recuperabile - Per acquisire le modifiche, gateway di Data Movement richiede che il database sia configurato come recuperabile. Un database è recuperabile se uno o entrambi i parametri di configurazione del database LOGARCHMETH1 e LOGARCHMETH2 non sono impostati su OFF.

• Autorizzazioni - All'utente Qlik devono essere concesse le seguenti autorizzazioni:

  • SYSADM o DBADM

  • DATAACCESS

• Per abilitare l'acquisizione dati da IBM DB2 per LUW, è necessario creare le tabelle di origine come segue:

  CREATE / ALTER TABLE table-name …. DATA CAPTURE CHANGES [INCLUDE LONGVAR COLUMNS];

  È possibile configurare gateway di Data Movement per eseguire questa operazione selezionando Abilita automaticamente MODIFICHE ACQUISIZIONE DATI (richiede privilegi di amministratore) nelle impostazioni di connettore oppure farlo manualmente.