Sorun giderme Doğrudan Erişim ağ geçidi
Bu bölümde, Doğrudan Erişim ağ geçidi uygulamasında sorun gidermek için gerçekleştirebileceğiniz çeşitli eylemler açıklanır.
Günlük dosyalarının görüntülenmesi ve indirilmesi
Günlük dosyaları, Doğrudan Erişim ağ geçidi işlemleri hakkında bilgi sağlar. Qlik Destek, sorun giderme amacıyla sizden günlük dosyaları sağlamanızı isteyebilir. Günlük dosyalarını, Günlük görüntüleyicide görüntüleyebilir veya indirebilirsiniz. Normal koşullar altında, günlük dosyalarını incelemeye gerek yoktur ancak tekrarlayan hatalar veya başka sorunlar yaşıyorsanız günlük dosyaları genellikle sebebi belirlemenize yardımcı olur.
Günlük görüntüleyiciyi açmak için:
-
Yönetim etkinlik merkezinde, Veri ağ geçitleri'ne gidin ve size ait Doğrudan Erişim ağ geçidi öğesini bulun.
-
Satırın sonundaki simgesine tıklayın ve Günlükleri görüntüle'yi seçin.
Günlük görüntüleyici penceresi açılır.
-
Sol üstte bulunan açılır listeden Qlik Desteğinin sizden görüntülemenizi veya indirmenizi istediği günlük türünü seçin.
Aşağıdaki günlükler kullanılabilir:
- Doğrudan Erişim ağ geçidi günlükleri (DirectAccessAgent)
- DCaaS günlükleri (dcaas_logs)
- ODBC tabanlı bağlayıcı günlükleri (odbc-connector_logs)
- SAP BW bağlayıcı günlükleri (QvSAPBwConnector-<date + timestamp>)
- SAP ODP bağlayıcı günlükleri (QvSapConnectorPackage-<process_id>)
- SAP SQL bağlayıcı günlükleri (QvSqlBwConnector-<date + timestamp>)
- Bağlayıcı aracı günlükleri (connector-agent_logs_<date>)
-
Bitişik açılır listeden görüntülemek veya indirmek istediğiniz günlüğü seçin. Günlük dosyaları, en yeniden (o anda etkin günlük dosyası) en eskiye doğru sıralanmıştır. Bir günlük dosyası seçtikten sonra günlük dosyasının başına veya sonuna atlamak için sırasıyla ve düğmelerini kullanabilirsiniz.
İpucu notuGünlük dosyasının görünümü, en son mesajları içerecek şekilde otomatik olarak güncellenmez. Görüntüyü güncellemek üzere günlük dosyasının sonuna atlamak için öğesine tıkladığınızda en son mesajlarla güncellenecektir. -
Günlük dosyasını indirmek için İndir'e tıklayın.
Dosya ya bilgisayarınıza indirilir ya da tarayıcı ayarlarınıza bağlı olarak dosyayı kaydetmeniz istenir.
Doğrudan Erişim ağ geçidi günlüklerini Doğrudan Erişim ağ geçidi makinesinde açma
Doğrudan Erişim ağ geçidi (DirectAccessAgent) günlüklerini Yönetim etkinlik merkezinden indirebilir ve aynı zamanda doğrudan Doğrudan Erişim ağ geçidi makinesinde açabilirsiniz. Varsayılan yükleme ile bu günlüklerin konumu şudur:
C:\Program Files\Qlik\ConnectorAgent\data\logs
Günlük ayrıntı düzeyini değiştirme
Doğrudan Erişim ağ geçidi (DirectAccessAgent) günlüklerinin ayrıntı düzeyini gerektiğinde görüntüleyebilir ve değiştirebilirsiniz. Bunu yapmak için ConnectorAgent alt klasöründen (varsayılan yükleme ile C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent) aşağıdaki komutları çalıştırın.
-
Geçerli günlük düzeyini görüntülemek için şunu çalıştırın:
connectoragent configuration getloggers -
Günlük düzeyini Trace olarak ayarlamak için şunu çalıştırın:
connectoragent configuration setloggers -l Root -v DEBUG -
Günlük düzeyini Verbose olarak ayarlamak için şunu çalıştırın:
connectoragent configuration setloggers -l Root –v DETAILED_DEBUG
Kayıt anahtarını güncelleme
Düşük bir olasılık olmakla birlikte kayıt anahtarının bozulması veya veri ağ geçidi sunucusuna yetkisiz bir kullanıcı tarafından erişildiğinden şüphelenmeniz halinde anahtarı değiştirmek gerekebilir.
Kayıt anahtarını güncellemek için:
- Doğrudan Erişim ağ geçidi sunucusunda yönetici olarak bir Komut İstemi açın ve çalışma dizinini ConnectorAgent alt klasörü olarak değiştirin (varsayılan yükleme ile C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent).
-
Şu komutları çalıştırın:
-
Yeni anahtarı oluşturun:
connectoragent qcs generate_keys
-
Anahtarı gösterin:
connectoragent qcs get_registration
Anahtar gösterilir:
-
-
Anahtarın tamamını yukarıdaki örnekte gösterildiği gibi kopyalayın.
-
Yönetim etkinlik merkezinde, ilgili satırın sonundaki düğmesine tıklayarak ve Düzenle'yi seçerek veri ağ geçidi ayarlarını açın.
-
Anahtarı Anahtar alanına yapıştırın (geçerli anahtarın yerine) ve ayarları kaydedin.
-
Doğrudan Erişim ağ geçidi sunucusuna geri dönün ve Qlik Data Gateway - Doğrudan Erişim hizmetini Qlik Data Gateway - Doğrudan Erişim hizmetini yönetme bölümünde anlatıldığı gibi yeniden başlatın.
Yeniden yükleme oturumu süresini uzatma
Doğrudan Erişim ağ geçidi ile Qlik Cloud arasındaki bağlantı 20 saniye veya daha uzun bir süredir boştaysa yeniden yükleme işlemi bazen aşağıdaki hatayı vererek başarısız olabilir:
Invalid object name '#<TempTableName>' (indicating that the Doğrudan Erişim ağ geçidi temp tables are unavailable).
Varsayılan oturum süresi 20 saniyedir, ancak bu hatayı sıklıkla alıyorsanız oturum süresini aşağıdaki gibi uzatabilirsiniz:
-
C:\ProgramData\Qlik\Gateway\configuration.properties dosyasını yönetici olarak açın. Bu işlemi Windows Explorer üzerinden yapıyorsanız Gizli dosyaları, klasörleri ve sürücüleri göster seçeneğinin seçili olduğundan emin olun.
- ODBC_RELOAD_SESSION_LIFE parametresini bulun ve değerini gereken şekilde artırın.
- configuration.properties dosyasını kaydedin ve Qlik Data Gateway - Doğrudan Erişim hizmetini yeniden başlatın.
Yükleme talepleri için zaman aşımını uzatma
Ağ kesintileri gerçekleştiğinde yeniden yüklemeler aşağıdaki hataları vererek başarısız olabilir:
Connector error: The session does not exist (DirectAccess-1509)
Connector error: The stream session expired for the load data request (DirectAccess-1012)
Yukarıdaki hatalarla sık sık karşılaşıyorsanız EXTEND_FIRST_REQUEST_TIMEOUT parametresini 5-10 dakika olarak ayarlamayı deneyin.
Bunu yapmak için:
-
C:\ProgramData\Qlik\Gateway\configuration.properties dosyasını yönetici olarak açın. Bu işlemi Windows Explorer üzerinden yapıyorsanız Gizli dosyaları, klasörleri ve sürücüleri göster seçeneğinin seçili olduğundan emin olun.
- EXTEND_FIRST_REQUEST_TIMEOUT parametresini bulun ve değerini 5-10 dakikaya artırın. Varsayılan 0'dır.
- configuration.properties dosyasını kaydedin ve Qlik Data Gateway - Doğrudan Erişim hizmetini yeniden başlatın.
Yeniden yükleme sırasında bağlayıcı çökmelerini ortadan kaldırma
İşlem izolasyonu, ağ geçidi sunucu işletim sistemine doğrudan erişimi olan yöneticilerin bağlayıcı türü başına yeniden yüklemeler için kaç işlemin bulunduğunu kontrol etmesine izin verir. Yeniden yüklemeleri birden fazla bağlayıcı işlemine dağıtmak, her bir bağlayıcı işleminde eş zamanlı olarak gerçekleşen yeniden yüklemelerin sayısını azaltarak izolasyon düzeyini artırır. Daha sonra bu, bağlayıcı çökmelerinin gerçekleştiği durumlarda genel Doğrudan Erişim ağ geçidi kararlılığı artırabilir.
Doğrudan Erişim ağ geçidi 1.6.1 veya daha yeni bir sürümü gerektirir.
İşlem izolasyonunu kapatma
Qlik Desteği, sorun giderme amacıyla işlem izolasyonunu kapatmanızı isteyebilir.
İşlem izolasyonunu kapatmak için:
- C:\ProgramData\Qlik\Gateway\configuration.properties dosyasını açın. Bu işlemi Windows Explorer üzerinden yapıyorsanız Gizli dosyaları, klasörleri ve sürücüleri göster seçeneğinin seçili olduğundan emin olun.
-
[ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE (Tüm satırları koşula göre renklendir) seçeneğini None (Belirtilen satırlar) olarak ayarlayın.
- configuration.properties dosyasını kaydedin ve Qlik Data Gateway - Doğrudan Erişim hizmetini yeniden başlatın.
İşlem izolasyonunu açma veya eş zamanlı yeniden yükleme sayısını ya da eş zamanlı yeniden yüklemeleri değiştirme
İşlem izolasyonunu açmak veya eş zamanlı yeniden yükleme sayısını ya da eş zamanlı yeniden yüklemeleri değiştirmek için:
-
C:\ProgramData\Qlik\Gateway\configuration.properties dosyasını yönetici olarak açın. Bu işlemi Windows Explorer üzerinden yapıyorsanız Gizli dosyaları, klasörleri ve sürücüleri göster seçeneğinin seçili olduğundan emin olun.
Dosya, farklı bağlayıcı türlerine karşılık gelen üç önek içerir: ODBC_<property-name>, SAPBW_<property-name>, SAPSQL_<property-name> ve SAPPACKAGE_<property-name>.
-
[ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE değerini Load olarak ve [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_MAX_PROCESS_COUNT değerini N olarak ayarlayın.
Burada:
N = Bir komut işlemi + Atanacak eş zamanlı yeniden yükleme işlemlerinin sayısı. Yani örneğin 10 değeri, maksimum 9 eş zamanlı yeniden yüklemeyi ifade edecektir.
- configuration.properties dosyasını kaydedin ve Qlik Data Gateway - Doğrudan Erişim hizmetini yeniden başlatın.
ODBC bağlayıcı işlem izolasyonu örnekleri
Aşağıdaki configuration.properties dosya alıntısı, en fazla 12 yeniden yükleme işlemi için ODBC bağlayıcı işlem izolasyonunun nasıl etkinleştirileceğini göstermektedir:
ODBC_PROCESS_ISOLATION_MODE=Load
ODBC_MAX_PROCESS_COUNT=13
Doğrudan Erişim ağ geçidi sürüm 1.6.7'den itibaren, MAX_PROCESS_COUNT değeri diğer ayarları değiştirmeye gerek kalmadan 10'u aşabilir. Belirli bir bağlayıcı türüyle yeniden yüklemeleri tamamen izole etmek için (yani, bağlayıcı işlemi başına birden fazla yeniden yükleme olmaması), bu değer en az 30 olarak ayarlanmalıdır, ancak iş yüküne bağlı olarak 60'a kadar yükseltmeniz gerekebilir.
Gelecekte yeniden yükleme için bozuk veya eksik veri yığınlarını saklama
Her bir yeniden yükleme işlemi için Doğrudan Erişim ağ geçidi, bozuk veya eksik veri yığınlarını bellekte saklayabilir ve diske yükleyebilir. Bu özellikle, otomatik kurtarmayı kullanmıyor ve 4025, 4020 ve 4021 hatalarıyla sık sık karşılaşıyorsanız faydalıdır. Bozuk veya eksik veri yığınlarını diske yüklemek için (yeniden yükleme başına) önbellek boyut eşiğini ayarlayarak bu özelliği açın. Belirtilen eşiğe ulaşıldığında ağ geçidi, sonraki şifrelenmiş yığınları Doğrudan Erişim ağ geçidi makinesinin diskine yükleyecektir.
Önbellek boyutunu ayarlamak için:
C:\ProgramData\Qlik\Gateway\configuration.properties dosyasını yönetici olarak açın. Bu işlemi Windows Explorer üzerinden yapıyorsanız Gizli dosyaları, klasörleri ve sürücüleri göster seçeneğinin seçili olduğundan emin olun.
RELOAD_CACHE_MEMORY_MB değerini N olarak ayarlayın (Varsayılan 0'dır ve bu, yeteneğin etkinleştirilmediği anlamına gelir).
Burada:
N = Bir veri yığınının boyutu, yeniden yüklenmeden önce eşiğe ulaşabilir.
Bilgi notuBu yeteneğin etkinleştirilmesi, Doğrudan Erişim ağ geçidi makinesindeki bellek kullanımını artırır, bu nedenle etkin olduğunda bellek üzerindeki etkiyi izlemenizi öneririz. RELOAD_CACHE_MEMORY_MB değerini 100 olarak ayarlamak çoğu durum için yeterli olacaktır.- configuration.properties dosyasını kaydedin ve Qlik Data Gateway - Doğrudan Erişim hizmetini yeniden başlatın.