Ana içeriğe geç Tamamlayıcı içeriğe geç

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ı

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.

  • 5050 (Bağlayıcı Aracısı REST API'si)
  • 9027 (DCAAS REST API'si)
  • 3005 (ODBC Bağlayıcısı REST API'si)
  • 50060 (ODBC Bağlayıcısı gRPC'si)
  • 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.

Bilgi notuEk modül yüklemek gerekmez. Qlik Data Gateway - Direct Access, yalnızca Windows tarafından zaten onaylanmış ve doğrulanmış modüller listesine eklenmiş modülleri kullanır. Qlik Data Gateway - Direct Access, .NET Runtime üzerinden yalnızca FIPS ile doğrulanmış şifreli algoritmaları kullanmayı zorlar.

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.

Bilgi notuNot: Yönetim etkinlik merkezinde gerçekleştirilmesi gereken veri ağ geçidi prosedürleri, kiracı yöneticisi izni gerektirir.

Qlik Data Gateway - Doğrudan Erişim kurulum adımları

Doğrudan Erişim Ağ Geçidi akış diyagramı - kurulum adımları

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

Bilgi notuDoğrudan Erişim ağ geçidi 1.6.4. ve sonraki sürümleri tarafından desteklenir

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.

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.

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.

Bilgi notuAcceptEula parametresinin "yes" olarak ayarlanması gereklidir. AcceptEula parametresini "yes" olarak ayarladığınızda Qlik Müşteri Sözleşmesi koşullarını kabul etmiş olursunuz.

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

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

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

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

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

Bilgi notuOrtamınızın bu tür bir güvenlik cihazı kullanıp kullanmadığından emin değilseniz lütfen BT yöneticinize başvurun.

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.

connectoragent qcs generate_keys

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: 

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.

Ağ geçidi uyumlu kaynak bağlantısı örneği

Ağ geçidi uyumlu kaynak bağlantısı örneği
Bilgi notuAğ geçidi uyumlu veri kaynakları için Veri bağlantısı ekle diyalog penceresinde, kullanılacak ağ geçidini seçmenize izin veren ilave bir Doğrudan Erişim ağ geçidi alanı bulunur.

Desteklenen veri kaynakları

  • ODBC kaynakları. Daha fazla bilgi için bk. ODBC veritabanları ‒ Qlik Cloud (yalnızca İngilizce).
  • SAP BW ve SAP SQL kaynakları. Doğrudan Erişim ağ geçidi 1.2.0 veya daha sonraki bir sürümü gerektirir.

    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.

 

Bu sayfa size yardımcı oldu mu?

Bu sayfa veya içeriği ile ilgili bir sorun; bir yazım hatası, eksik bir adım veya teknik bir hata bulursanız, bize bildirin, düzeltelim!