Qlik Data Gateway - Doğrudan Erişim uygulaması kurulumu

Bu başlık, Qlik Data Gateway - Doğrudan Erişim ön koşullarını özetler, kurulum talimatlarını içerir ve Qlik Data Gateway - Doğrudan Erişim ile çalışırken dikkat etmeniz gereken kısıtlamaları ve noktaları anlatır.

Qlik Data Gateway - Doğrudan Erişim kullanırken en iyi uygulamalar

Qlik Data Gateway - Doğrudan Erişim kullanırken başarılı bir deneyim için aşağıdaki en iyi uygulamalara uyulması önemle tavsiye edilir:

• Mevcut kaynaklara aşırı yüklenme riskini artıracağından ve sistem kararlılığını etkileyeceğinden, geliştirme, kullanıcı kabul testi ve üretim için aynı Doğrudan Erişim ağ geçidi öğesini kullanmayın. İş perspektifinden bakıldığında, yetersiz kaynaklar ve azalan kararlılığın birleşimi, üretim uygulama verilerinin gecikmeli olarak güncellenmesine neden olabilir.
• Optimum performans için Doğrudan Erişim ağ geçidi öğesini veri kaynağınıza mümkün olduğunca yakın bir sunucuya kurun.

• Doğrudan Erişim ağ geçidi aşağıdaki sistem gereksinimlerinde belirtildiği gibi özel bir Windows Sunucusuna kurulmalıdır. Bunu gerçek veritabanı sunucusuna veya Qlik DataTransfer, Qlik Sense Desktop ve Qlik Sense Enterprise dahil ancak bunlarla sınırlı olmamak üzere diğer Qlik ürünlerinin yanına kurmayın.

Sistem önkoşulları

Bu bölümde, Qlik Data Gateway - Doğrudan Erişim kullanımı için yazılım, bağlantı noktası ve donanım gereksinimleri açıklanır.

Yazılım önkoşulları

• Doğrudan Erişim ağ geçidi, güvenlik duvarınızın arkasında yer alan bir Windows Server makinesine yüklenmelidir. Sunucunuz, veri kaynağınıza erişim sağlayabilmelidir.

  Desteklenen Windows Server sürümleri:

  • 2016
  • 2019
  • 2022

• Üç farklı .NET sürümünün yüklenmesi gerekir. Yalnızca aşağıdaki .NET sürümlerini yükleyin:

  • .NET 4.8: Yükleme için gereklidir.

  • .NET 6.0.x Runtime (x64) ve ASP.NET Core Runtime 6.0.x (x64) (en son düzeltme)

    Haber notuDoğrudan Erişim ağ geçidi 1.6.8'den itibaren .NET 6.0.x artık gerekli değildir.

  • .NET 8.0.x Runtime (x64) ve ASP.NET Core Runtime 8.0.x (x64) (en son düzeltme)

  Bilgi notuDoğrudan Erişim ağ geçidi 1.6.6 ve 1.6.7 için hem 6.0.x hem 8.0.x sürümü .NET ve ASP.NET Core Runtime gerekir.

  Yüklü duruma olan .NET sürümlerini doğrulama talimatları için bk. https://docs.microsoft.com/en-us/dotnet/framework/migration-guide/how-to-determine-which-versions-are-installed.

• Microsoft Visual C++ 2015-2022 Redistributable (x64). Doğrudan Erişim ağ geçidi kurulumu, yüklü olmadığını algılarsa yeniden dağıtılabilir bileşeni yüklemenizi ister.

SAP veri kaynaklarını kullanırken ek yazılım önkoşulları

• Qlik Data Gateway için SAP NetWeaver RFC SDK yükleme - Doğrudan Erişim (yalnızca İngilizce) bölümünde açıklanan şekilde Qlik Data Gateway - Doğrudan Erişim makinesine SAP NetWeaver RFC SDK yükleyin.
• Qlik Data Gateway - Doğrudan Erişim makinesine Microsoft Visual C++ 2013 Yeniden Dağıtılabilir (x64) yükleyin.

Gerekli bağlantı noktaları ve protokoller

Aşağıdaki bölüm gerekli bağlantı noktalarını listelemektedir.

Giden bağlantı noktaları

HTTPS/TCP-443, <tenant-id>.<region>.qlikcloud.com ile giden iletişim için açılmalıdır.

Dahili bağlantı noktaları

Dahili veri ağ geçidi işlemleri tarafından iletişim için kullanılan bağlantı noktalarının bir listesi aşağıda verilmiştir. Bu bağlantı noktalarından herhangi bir başka bir uygulama tarafından kullanılıyorsa diğer uygulamayı yeniden yapılandırın veya kaldırın.

Genel bağlantı noktaları

• 5050 (Bağlayıcı Aracısı REST API'si)
• 9027 (DCAAS REST API'si)

ODBC bağlantı noktaları

• 3005 (ODBC Bağlayıcısı REST API'si)
• 50060 (ODBC Bağlayıcısı gRPC'si)

SAP bağlantı noktaları

• 3007 (SAP BW Bağlayıcı REST API)
• 3008 (SAP SQL Bağlayıcı REST API)
• 3009 (SAP ODP Bağlayıcı REST API)
• 50070 (SAP BW Bağlayıcı gRPC)
• 50080 (SAP SQL Bağlayıcı gRPC)
• 50090 (SAP ODP Bağlayıcı gRPC)

WSS protokolü

Doğrudan Erişim ağ geçidi, HTTPS'ye ek olarak WSS (WebSocket Secure) protokolünü de kullanır. Bu nedenle, güvenlik duvarınızın ve proxy sunucunuzun (kullanmayı düşünüyorsanız) giden WSS bağlantılarına izin verecek şekilde ayarlandığından emin olun.

Önerilen minimum donanım

• 8 çekirdek

• 32 GB bellek

• 5 GB depolama alanı

Sistem şifreleme

Qlik Cloud Government, yalnızca Windows öğesi FIPS 140-2 onaylı işlem modunda (FIPS modu) çalışacak şekilde yapılandırıldığında Qlik Data Gateway - Direct Access kullanımını destekler. FIPS modunu etkinleştirmek için Windows politikasını etkinleştirin: Sistem şifreleme: Şifreleme, karma oluşturma ve imzalama için FIPS ile uyumlu algoritmalar kullanın. Daha fazla bilgi için FIPS 140-2 onaylı işlem modunda Windows kullanma prosedürünün 3. adımına bakın.

Qlik Data Gateway - Doğrudan Erişim yükleme

Direct Access gateway'i kurma işlemi, gerek Yönetim etkinlik merkezinde gerekse Direct Access gateway sunucusunda gerçekleştirilmesi gereken yordamlar içerir.

Birinci aşama: Qlik Data Gateway - Doğrudan Erişim indirme

1. Yönetim etkinlik merkezindeki Veri ağ geçitleri öğesini seçin.

   Mevcut veri ağ geçitleri her ağ geçidi hakkında temel bilgiler gösteren bir tabloda listelenir.

2. Dağıt araç çubuğu düğmesine tıklayın.

   Veri Ağ Geçidini Dağıt diyalog penceresi açılır.

3. Data Gateway - Doğrudan Erişim öğesini seçin, Qlik Müşteri Anlaşması'nı kabul edin ve İndir'e tıklayın. Direct Access gateway kurulum dosyası (qlik-data-gateway-direct-access.exe) makinenize indirilecek.

İkinci aşama: Doğrudan Erişim ağ geçidi öğesini veri kaynaklarınızı koruyan güvenlik duvarının arkasındaki bir sunucuya yükleyin

Bu aşama, Doğrudan Erişim ağ geçidi yüklemeyi içerir.Doğrudan Erişim ağ geçidi uygulamasını etkileşimli olarak veya sessiz bir şekilde yükleyebilirsiniz.

Doğrudan Erişim ağ geçidi uygulamasını etkileşimli olarak yükleme

1. İndirme tamamlandığında, kurulum dosyasını güvenlik duvarının arkasındaki bir Windows Server makinesine kopyalayın. Makinenin veri kaynaklarınız ile iletişim kurabildiğinden emin olun.

2. Kurulum Sihirbazı'nı başlatmak için dosyayı açın. Kurulum tamamlanana dek İleri'ye tıklamaya devam edin.
   

   Bilgi notu

   • Doğrudan Erişim ağ geçidi için Microsoft .NET 6.x ve .NET 8.x gereklidir. Kurulum daha önceki bir sürümün yüklü olduğunu algılarsa gerekli sürümü yüklemeniz istenir. .NET yüklemesi tamamlandığında, Doğrudan Erişim ağ geçidi makinesini yeniden başlatmanız ve Doğrudan Erişim ağ geçidi kurulumunu yeniden çalıştırmanız gerekir.

   • Kurulum, yüklü olmadığını algılarsa Microsoft Visual C++ 2015-2022 Redistributable (x64) bileşenini yüklemenizi ister.

   • Kurulum sırasında isteğe bağlı olarak varsayılan yükleme yolunu (C:\Program Files\Qlik\ConnectorAgent) değiştirebilirsiniz.

Doğrudan Erişim ağ geçidi uygulamasını sessiz bir şekilde yükleme, yükseltme ve kaldırma

Doğrudan Erişim ağ geçidi uygulamasını sessiz bir şekilde yüklemek, örneğin Doğrudan Erişim ağ geçidi uygulamasını kuruluşunuzda birkaç makineye yüklemeniz gerekiyorsa faydalı olacaktır.

Önkoşullar

Etkileşimli yüklemenin aksine bu, yükleme sırasında yapılamadığından, sessiz yüklemeye başlamadan önce tüm önkoşul yazılımların doğru sürümlerini yüklediğinizden emin olun.

Doğrudan Erişim ağ geçidi uygulamasını yükleme veya yükseltme

Bir CMD komutunu yönetici olarak açın ve yürütülebilir Doğrudan Erişim ağ geçidi dosyasını içeren klasörden şu komutu çalıştırın:

qlik-data-gateway-direct-access.exe /S InstallPath="full-path" AcceptEula=yes

full-path öğesinin örneğin "C:\TMP\Qlik" gibi tırnak işareti içinde gerçek yükleme yoluyla değiştirilmesi gerekir.

Doğrudan Erişim ağ geçidi kaldırma

Bir CMD komutunu yönetici olarak açın ve yürütülebilir Doğrudan Erişim ağ geçidi dosyasını içeren klasörden şu komutu çalıştırın:

qlik-data-gateway-direct-access.exe /S /uninstall

Yüklemeyle ilgili sorunları giderme

Yükleme günlük dosyaları, hataları gidermenize (veya Qlik Desteği almanıza) yardımcı olacak bilgiler sağlar. Günlük dosyasının tam yolu:

C:\Users\<user>\AppData\Local\Temp\Qlik Data Gateway - Direct Access_<Timestamp>.log

Üçüncü aşama: Doğrudan Erişim ağ geçidi kurma

Bu aşama Qlik Cloud kiracı URL'nizi ayarlamayı, isteğe bağlı olarak bir proxy sunucu ayarlamayı ve bir kayıt anahtarı oluşturmayı içerir. Anahtarı, Yönetim etkinlik merkezinde veri ağ geçidi anahtarı ayarlarına kopyalamanız gerekir (aşağıdaki 3. aşama). Anahtar Direct Access gateway ile Qlik Cloud kiracısı arasında kimlik doğrulamalı bir bağlantı kurmak için kullanılır.

Doğrudan Erişim ağ geçidi makinesinde yönetici olarak bir Komut İstemi açın ve çalışma dizinini ConnectorAgent alt klasörüne çevirin (varsayılan yükleme ile C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent).

Ardından aşağıda açıklandığı gibi devam edin.

Qlik Cloud kiracısını ayarlama

Bağlanılacak Qlik Cloud kiracısını seçin. Kiracıya bir proxy sunucusu aracılığıyla bağlanmak için ilgili parametreleri komut satırına aşağıda gösterildiği gibi ekleyin.

Proxy sunucu olmadan Qlik Cloud kiracısını ayarlama komutu:

Söz Dizimi:

connectoragent qcs set_config --tenant_url your-qlik-cloud-tenant-url

Örnek:

connectoragent qcs set_config --tenant_url mytenant.us.qlikcloud.com

Proxy sunucu ile Qlik Cloud kiracısını ayarlama komutu:

Söz Dizimi:

connectoragent qcs set_config --tenant_url your-qlik-cloud-tenant-url --proxy_url http://host:port --proxy_username username --proxy_password password

Örnek:

connectoragent qcs set_config --tenant_url mytenant.us.qlikcloud.com --proxy_url http://myproxy:1212 --proxy_username admin --proxy_password f56weqs@

Proxy sınırlamaları hakkında bilgi için bk. Qlik Cloud uygulamasına proxy sunucu üzerinden bağlanma.

CA paketini ayarlama

CA paketi, Qlik Cloud kiracısının kimliğini doğrular ve böylece güvenilir bir bağlantı sağlar.

CA paketini kimin ayarlaması gerekir?

CA paketinin yalnızca aşağıdaki olmanız durumunda ayarlanması gerekir:

• Bir Qlik Cloud Government müşterisi
• Proxy gibi davranan ve Internet'ten alınan sertifika bilgilerini kendi CA kök sertifikalarıyla değiştiren bir güvenlik cihazı kullanan Qlik Cloud ticari müşterisi

Hangi paketi kullanmalıyım?

Müşteriler ya Qlik CA paketini kullanmalı ya da kendi CA paketlerini aşağıdaki şekilde getirmelidir:

• Qlik CA paketini sağlar: Standart ortama sahip Qlik Cloud Government müşterileri tarafından kullanılmalıdır. Standart ortam, proxy gibi davranan ve Internet'ten alınan sertifika bilgilerini kendi CA kök sertifikalarıyla değiştiren bir güvenlik cihazı içermeyen ortamdır.

  Varsayılan Doğrudan Erişim ağ geçidi yüklemesinde, CA paketi dosyası aşağıdaki konumda bulunabilir: C:\Program Files\Qlik\ConnectorAgent\caBundle\qcg_ca_bundle.pem

  Bilgi notuCA paket dosyasını yeniden adlandırabilirsiniz ancak dosyanın .pem uzantısına sahip olduğundan emin olun (örneğin, qlikcerts.pem). Ardından aşağıda açıklanan komutları çalıştırın.
• Müşteriler kendi CA paketini getirirler: Müşterinin ortamı proxy gibi davranan ve Internet'ten alınan sertifika bilgilerini kendi CA kök sertifikalarıyla değiştiren bir güvenlik cihazı kullanıyorsa bu komut kullanılmalıdır. Bu sertifikalar otomatik olarak imzalanmışsa CA paketini ayarlama komutuna ek olarak CA paketine izin verme komutunu da çalıştırmanız gerekir. Bu komutların her ikisi de aşağıda açıklanmaktadır. Bu hem Qlik Cloud Government müşterileri hem de Qlik Cloud ticari müşterileri için geçerlidir.

CA paketini ayarlama komutu

CA sertifika paketini ayarlamak için aşağıdaki komutu çalıştırın:

Söz Dizimi:

connectoragent qcs set_config --ca_bundle_path path-to-ca-bundle-file

Örnek:

connectoragent qcs set_config --ca_bundle_path c:\ca\cacerts.pem

CA paketine izin verme komutu

Bazı ortamlar proxy gibi davranan ve Internet'ten alınan sertifika bilgilerini kendi CA kök sertifikalarıyla değiştiren bir güvenlik cihazı kullanırdeğişkenlerini silin. Bu komutun yalnızca güvenlik cihazının kendisinin otomatik olarak imzalanmış bir sertifika kullanması durumunda çalıştırılması gerekir. Böyle bir durumda, aşağıdaki komutu çalıştırmazsanız CA paketine güvenilmeyebilir:

connectoragent qcs set_config --ca_bundle_allow_invalid_certs true

Kayıt anahtarını oluşturma ve gösterme

Anahtar Doğrudan Erişim ağ geçidi ile Qlik Cloud kiracısı arasında kimlik doğrulamalı bir bağlantı kurmak için kullanılır.

Kayıt anahtarını oluşturma komutu

connectoragent qcs generate_keys

Kayıt anahtarını gösterme komutu

connectoragent qcs get_registration

Anahtar gösterilir.

Anahtarın tamamını yukarıdaki örnekte gösterildiği gibi kopyalayın. Sonraki aşamada anahtarı Yönetim etkinlik merkezine yapıştırmanız gerekecek.

Dördüncü aşama: Yönetim etkinlik merkezine dönün ve veri ağ geçidini kaydedin.

1. Yönetim etkinlik merkezindeki Veri ağ geçitleri öğesini seçin.

   Mevcut veri ağ geçitleri her ağ geçidi hakkında temel bilgiler gösteren bir tabloda listelenir.

2. Oluştur araç çubuğu düğmesine tıklayın.

   Veri ağ geçidi oluştur diyalog penceresi açılır.

   

3. Veri ağ geçidi için bir ad belirtin.

4. İsteğe bağlı olarak veri ağ geçidi için bir açıklama girebilirsiniz.

5. Veri ağ geçidi tür açılır listesinden Doğrudan Erişim'i seçin.

6. Aşağı açılan İlişkili alan listesinden bir alan seçin.

   Doğrudan Erişim ağ geçidini bir alan ile ilişkilendirirken aşağıdakilerin farkında olmalısınız:

   • Veri ağ geçitleri yalnızca Paylaşılan veya Yönetilen alanlarda oluşturulabilir
   • Başka bir alandan veri ağ geçidi kullanan bir alandan veri bağlantısı oluşturabilmek için veri ağ geçidi alanında Veri tüketebilir rolüne sahip olmanız gerekir.

   • Veri ağ geçitleri oluşturabilmek için kullanıcının bir alanın sahibi olması veya Yönetebilir rolü olması gerekir. Ek olarak, kullanıcı Professional veya Full User yetkilendirmesi öğesine ihtiyaç duyar. Professional yetkilendirmesi öğesini manuel olarak veya Yönetim etkinlik merkezinde Profesyonel erişimin dinamik atanmasını etkinleştir'i açarak atayın.

     Kullanıcı yetkilendirmeleri ve profesyonel erişimin dinamik atanması hakkında daha fazla bilgi için bk. Kullanıcı yetkilendirmelerini yönetme

   • Veri ağ geçitleri yalnızca tek bir alanla ilişkilendirilebilir.

7. Daha önce oluşturduğunuz anahtarı Anahtar alanına yapıştırın.

8. Oluştur'a tıklayın.

   Veri ağ geçidi Veri ağ geçitleri listesine eklenir ve etkinleştirilir.

Beşinci aşama: Doğrudan Erişim ağ geçidi sunucusunda Qlik Data Gateway - Doğrudan Erişim hizmetini başlatın

Doğrudan Erişim ağ geçidi sunucusunda, hizmeti başlatmak için aşağıdakilerden birini yapın:

• Windows Hizmetleri konsolunu açın ve Qlik Data Gateway - Doğrudan Erişim hizmetini başlatın.

• Yönetici olarak bir Komut İstemi açın ve çalışma dizinini ConnectorAgent alt klasörüne çevirin (varsayılan yükleme ile C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent). Sonra şu komutu çalıştırın:

  connectoragent service start

  Hizmetin başarıyla başlatıldığını belirten bir doğrulama mesajı gösterilir.

Ayrıca bkz. Hizmeti farklı bir hesapla çalıştırma

Altıncı aşama: Veri kaynağına bir bağlantı ekleyin

Ağ geçidinizi Veri ağ geçitleri listesinde bulun ve Durum'unun "Bağlandı" olduğundan emin olun (geçerli durumu görmek için tarayıcınızı yenilemeniz gerekebilir). Bundan sonra veri kaynağınıza bir bağlantı eklemeye geçebilirsiniz.

Veri kaynağından veri yüklemenin birkaç yolu vardır: 

• Alanlardaki veri kaynaklarını ekleme ve yönetme

• Veri Yöneticisi ile veri yükleme ve yönetme

• Kodlarla veri yükleme ve dönüştürme

Mevcut veri kaynaklarının listesi, ağ geçidi bağlantılarını destekleyen veri kaynakları için yinelenen girişler içerecektir. Ağ geçidi uyumlu veri kaynakları, kaynağından adından sonra ayraçlar içinde görünen "Doğrudan Erişim ağ geçidi üzerinden" ifadesiyle tanınabilir.

Desteklenen veri kaynakları

• ODBC kaynakları. Daha fazla bilgi için bkz. ODBC veritabanları ‒ Qlik Cloud (yalnızca İngilizce).

• SAP BW, SAP SQL ve SAP ODP kaynakları. Doğrudan Erişim ağ geçidi 1.2.0 veya sonraki sürümü gerekir.

  Bu kaynaklara yönelik bağlantı ayarlama hakkında bilgi için bk. SAP NetWeaver (yalnızca İngilizce).

Genel sınırlamalar ve dikkat edilmesi gereken noktalar

• Doğrudan Erişim ağ geçidi yalnızca tek bir kiracıya bağlanabilir.
• Herhangi bir nedenle Qlik uygulamasının yeniden yüklenmesi sırasında Doğrudan Erişim ağ geçidi sunucusu yeniden başlatılırsa yeniden yükleme başarısız olur. Verileri yenilemek için Qlik uygulama yeniden yüklemesini yeniden başlatın.

• Yeniden yükleme komut dosyası sorguları 500.000 karakteri aşamaz.

  Komut dosyalarını yeniden yükleme hakkında bilgi için bkz. Komut dosyalarını yeniden yükleme.