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:

1. Yönetim Konsolu içinde, Veri ağ geçitleri'ne gidin ve Doğrudan Erişim ağ geçidi'nizi bulun.

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

3. 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 SQL bağlayıcı günlükleri (QvSqlBwConnector-<date + timestamp>)
   • Bağlayıcı aracı günlükleri (connector-agent_logs_<date>)

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

5. 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 Konsolu kaynağından 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:

1. 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).

2. Şu komutları çalıştırın:

   • Yeni anahtarı oluşturun:

     connectoragent qcs generate_keys

   • Anahtarı gösterin:

     connectoragent qcs get_registration

     Anahtar gösterilir:

     

3. Anahtarın tamamını yukarıdaki örnekte gösterildiği gibi kopyalayın.

4. Yönetim Konsolu'da, ilgili satırın sonundaki düğmesine tıklayarak ve Düzenle'yi seçerek veri ağ geçidi ayarlarını açın.

5. Anahtarı Anahtar alanına yapıştırın (geçerli anahtarın yerine) ve ayarları kaydedin.

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

İşlem izolasyonunu açmak için:

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

   Dosya, farklı bağlayıcı türlerine karşılık gelen üç ön ek içerir: ODBC_<property-name>, SAPBW_<property-name> ve SAPSQL_<property-name>.

2. ODBC|SAPBW|SAPSQL_PROCESS_ISOLATION_MODE öğesini Yükle ve ODBC|SAPBW|SAPSQL_MAX_PROCESS_COUNT öğesini 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.

   Bilgi notu

   Varsayılan bağlantı noktası sayısı ve menzil ayarlarıyla [ODBC|SAPBW|SAPSQL]_MAX_PROCESS_COUNT değerini 10'dan büyük olacak şekilde ayarlayamazsınız.

3. configuration.properties dosyasını kaydedin ve Qlik Data Gateway - Doğrudan Erişim hizmetini yeniden başlatın.

İşlem izolasyonunu kapatmak için:

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

2. ODBC|SAPBW|SAPSQL_PROCESS_ISOLATION_MODE öğesini Hiçbiri olarak ayarlayın.

3. 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 9 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=10

Varsayılan bağlantı noktası ayarlarını değiştirirseniz MAX_PROCESS_COUNT değeri 10'u geçebilir. Ancak böyle bir durumda:

• ODBC_PORT veya ODBC_DATA_PORT_RANGE_START ile SAPBW_PORT veya SAPBW_DATA_PORT_RANGE_START arasındaki bağlantı noktası sayısı, ODBC_MAX_PROCESS_COUNT değerine eşit veya bu değerden büyük olmalıdır.

• SAPBW_PORT veya SAPBW_DATA_PORT_RANGE_START ile SAPSQL_PORT veya SAPSQL_DATA_PORT_RANGE_START arasındaki bağlantı noktası sayısı, SAPBW_MAX_PROCESS_COUNT değerine eşit veya bu değerden büyük olmlaıdır.

Yani örneğin ODBC_MAX_PROCESS_COUNT=30 ayarlamak için bağlantı noktası parametreleri şunun gibi görünmelidir:

# ODBC Connector

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=30

ODBC_DATA_PORT_RANGE_START=50260

ODBC_PORT=3005

# SAP BW Connector

SAPBW_PROCESS_ISOLATION_MODE=None

SAPBW_MAX_PROCESS_COUNT=0

SAPBW_DATA_PORT_RANGE_START=50290

SAPBW_PORT=3035

# SAP SQL Connector

SAPSQL_PROCESS_ISOLATION_MODE=None

SAPSQL_MAX_PROCESS_COUNT=0

SAPSQL_DATA_PORT_RANGE_START=50300

SAPSQL_PORT=3045