Önkoşullar

Aşağıdaki bölümde IBM DB2 for LUW bağlayıcısı ile çalışmanın önkoşulları anlatılmaktadır.

Verileri yerleştirebilmeniz veya çoğaltabilmeniz için önce aşağıdaki önkoşulları yerine getirdiğinizden emin olun:

• Gerekli driver öğesini Veri Hareketi ağ geçidi sunucusuna yükleyin

• Veri kaynağında gerekli izinleri verin

• Veri kaynağı bağlayıcısını yapılandırma

Sürücü kurulumu

driver öğesini, sürücü yükleme yardımcı programını kullanarak (önerilir) veya manuel olarak yükleyebilirsiniz. Manuel yükleme, nadir görülen şekilde sürücü yükleme yardımcı programında bir sorunla karşılaşmanız durumunda denenmelidir.

Sürücüyü yüklemek için sürücü yükleme yardımcı programı kullanma

Bu bölümde, gerekli driver öğesinin nasıl yükleneceği açıklanmıştır. Sürece; driver öğesini indirme, gerekli klasöre (aşağıya bakın) kopyalama ve otomatik olarak yükleyecek ve yapılandıracak bir komut dosyası çalıştırma işlemleri dahildir. Gerektiğinde driver öğesini güncellemek ve kaldırmak için de komut dosyaları çalıştırabilirsiniz.

Yüklemeyi hazırlama

• Python 3.6 veya daha yeni bir sürümünün Veri Hareketi ağ geçidi sunucusunda yüklü olduğundan emin olun.

  Python, çoğu Linux dağıtımında önceden yüklenmiş şekilde sunulur. Aşağıdaki komutu çalıştırarak sisteminizde yüklü olan Python sürümünü öğrenebilirsiniz:

  python3 --version

• IBM Data Server Client "<version>_linuxx64_client.tar.gz" dosyasını IBM web sitesinden indirin. Desteklenen sürümü /opt/qlik/gateway/movement/drivers/manifests/db2.yaml dizininde binary-artifacts altında bulabilirsiniz. İndirme işlemi tamamlandığında dosyayı şuraya kopyalayın:

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

driver uygulamasını yükleme

driver öğesini yüklemek için:

1. Veri Hareketi ağ geçidi hizmetini durdurun:

   sudo systemctl stop repagent

2. İsteğe bağlı olarak hizmetin durduğunu doğrulayın:

   sudo systemctl status repagent

   Durum aşağıdaki gibi olmalıdır:

   Active: inactive (dead) since <timestamp> ago

3. Veri Hareketi ağ geçidi makinesinde, çalışan dizini şu şekilde değiştirin:

   opt/qlik/gateway/movement/drivers/bin

4. Şu komutu çalıştırın:

   Söz Dizimi:

   ./install db2

   Aksi durumda, driver öğesinin EULA'sı görünür.

5. Şunlardan birini yapın:

   • EULA'da yavaşça gezinmek için [Enter] tuşuna tekrar tekrar basın.
   • EULA'da hızlı bir şekilde gezinmek için Boşluk tuşuna tekrar tekrar basın.
   • Lisans metninden çıkmak ve EULA kabul seçeneklerine ulaşmak için q tuşuna basın.

6. Şunlardan birini yapın:

   • EULA'yı kabul etmek ve yükleme işlemini başlatmak için "y" yazıp [Enter] tuşuna basın.
   • EULA'yı reddetmek ve yükleme işleminden çıkmak için "n" yazıp [Enter] tuşuna basın.

   • EULA'yı tekrar görüntülemek için "v" yazıp [Enter] tuşuna basın.

driver yüklenir.

7. Yüklemenin tamamlanmasını ("Tamamlandı!" ifadesiyle belirtilir) bekleyin ve ardından Veri Hareketi ağ geçidi hizmetini başlatın:

   sudo systemctl start repagent

8. İsteğe bağlı olarak hizmetin başladığını doğrulayın:

   sudo systemctl status repagent

   Durum aşağıdaki gibi olmalıdır:

   Active: active (running) since <timestamp> ago

driver öğesini güncelleme

Sağlanan driver öğesini yüklemeden önce driver öğesinin eski sürümlerini kaldırmak istiyorsanız güncelleme komutunu çalıştırın.

driver öğesini güncellemek için:

1. Veri Hareketi ağ geçidi hizmetini durdurun:

   sudo systemctl stop repagent

2. İsteğe bağlı olarak hizmetin durduğunu doğrulayın:

   sudo systemctl status repagent

   Durum aşağıdaki gibi olmalıdır:

   Active: inactive (dead) since <timestamp> ago

3. Veri Hareketi ağ geçidi makinesinde, çalışan dizini şu şekilde değiştirin:

   opt/qlik/gateway/movement/drivers/bin

4. Şu komutu çalıştırın:

   Söz Dizimi:

   ./update db2

   Aksi durumda, driver öğesinin EULA'sı görünür.

5. Şunlardan birini yapın:

   • EULA'da yavaşça gezinmek için [Enter] tuşuna tekrar tekrar basın.
   • EULA'da hızlı bir şekilde gezinmek için Boşluk tuşuna tekrar tekrar basın.
   • Lisans metninden çıkmak ve EULA kabul seçeneklerine ulaşmak için q tuşuna basın.

6. Şunlardan birini yapın:

   • EULA'yı kabul etmek ve yükleme işlemini başlatmak için "y" yazıp [Enter] tuşuna basın.
   • EULA'yı reddetmek ve yükleme işleminden çıkmak için "n" yazıp [Enter] tuşuna basın.
   • EULA'yı baştan incelemek için "v" yazıp [Enter] tuşuna basın.

Eski driver kaldırılacak ve yeni driver yüklenecektir.

7. Yüklemenin tamamlanmasını ("Tamamlandı!" ifadesiyle belirtilir) bekleyin ve ardından Veri Hareketi ağ geçidi hizmetini başlatın:

   sudo systemctl start repagent

8. İsteğe bağlı olarak hizmetin başladığını doğrulayın:

   sudo systemctl status repagent

   Durum aşağıdaki gibi olmalıdır:

   Active: active (running) since <timestamp> ago

driver öğesini kaldırma

driver öğesini kaldırmak istiyorsanız kaldırma komutunu çalıştırın.

driver öğesini kaldırmak için:

1. Bu bağlayıcıyı kullanmak için yapılandırılan tüm görevleri durdurun.

2. Veri Hareketi ağ geçidi makinesinde, çalışan dizini şu şekilde değiştirin:

   opt/qlik/gateway/movement/drivers/bin

3. Şu komutu çalıştırın:

   Söz Dizimi:

   ./uninstall db2

   driver kaldırılacaktır.

Sürücüyü manuel olarak yükleme

driver öğesini manuel olarak yüklemeyi yalnızca otomatik sürücü yükleme başarıyla tamamlanmadığında denemelisiniz.

Veri Hareketi ağ geçidi makinesinde bir kabuk istemi açın ve şunları yapın:

1. Veri Hareketi ağ geçidi hizmetini durdurun:

   sudo systemctl stop repagent

2. İsteğe bağlı olarak hizmetin durduğunu doğrulayın:

   sudo systemctl status repagent

   Durum aşağıdaki gibi olmalıdır:

   Active: inactive (dead) since <timestamp> ago

3. IBM Data Client v11.5.8_linuxx64_server_t.tar.gz dosyasını yükleyin; "CLIENT" yüklemeyi seçin.

4. Veri Hareketi ağ geçidi makinesinde bir DB2 örneği yoksa, şu komutları çalıştırarak bir DB2 örneği oluşturun:

   adduser <db2_instance_name>

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

5. DB2 sürücü konumunu Linux kitaplık yoluna ekleyin.

   Bunun için aşağıdaki satırı site_ arep_login.sh dosyasına şu şekilde ekleyin:

   export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/lib

   burada path sürücünün İSTEMCİ yoludur.

   Örnek (örnek adı db2clnt1 olacak şekilde):

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

   export DB2INSTANCE=db2clnt1

6. odbcinst.ini adlı dosyayı /etc altında oluşturup şu girişi ekleyin:

   [IBM DB2 ODBC DRIVER]

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

   fileusage=1

   dontdlclose=1

7. Veri Hareketi ağ geçidi hizmetini başlatın:

   sudo systemctl start repagent

8. İsteğe bağlı olarak hizmetin başladığını doğrulayın:

   sudo systemctl status repagent

   Durum aşağıdaki gibi olmalıdır:

   Active: active (running) since <timestamp> ago

9. IBM DB2 for LUW bağlantı ayarlarını IBM DB2 for LUW içinde açıklandığı gibi tanımlayın ve Bağlantıyı Test Et'e tıklayın.

   Şu hatayı alırsanız:

   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. Şu komutu çalıştırın:

      /opt/ibm/db2/V11.5/bin /db2cli writecfg add -database <db_name_from_connector_connection_settings> -host <server_name_from_connector_connection_settings> -port <port_from_connector_connection_settings>

   2. Veri Hareketi ağ geçidibin dizinine (<yukleme_dizini>/bin) geçin. Sonra Veri Hareketi ağ geçidi hizmetini yukarıda anlatıldığı gibi durdurup başlatın.

Veritabanında CDC'yi etkinleştirme

CDC'yi (Değişiklik Verisi Yakalama) etkinleştirmek için:

• Veritabanını kurtarılabilir olarak ayarla - Veri Hareketi ağ geçidi, değişiklikleri yakalamak için veritabanının kurtarılabilir olarak yapılandırılmasını gerektirir. LOGARCHMETH1 ve LOGARCHMETH2 veritabanı yapılandırma parametrelerinden herhangi biri veya her ikisi de OFF olarak ayarlanmadıysa veritabanı kurtarılabilir.

• İzinler - Qlik kullanıcısına aşağıdaki izinler verilmelidir:

  • SYSADM veya DBADM

  • DATAACCESS

• IBM DB2 for LUW'dan veri yakalamayı etkinleştirmek için kaynak tabloların aşağıdaki gibi oluşturulması gerekir:

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

  Bu işlemi gerçekleştirmek üzere connector ayarlarında VERİ YAKALAMA DEĞİŞİKLİKLERİNİ otomatik olarak etkinleştir (yönetici ayrıcalığı gerektirir) seçeneğini işaretleyerek Veri Hareketi ağ geçidi ürününü yapılandırabilir ya da işlemi manuel olarak yapabilirsiniz.