Przeskocz do zawartości głównej Przejdź do treści uzupełniającej
Zasoby Qlik

Rozwiązywanie problemów Brama dostępu bezpośredniego

W tej sekcji opisano różne czynności, które można wykonać w celu rozwiązania problemów z Brama dostępu bezpośredniego.

Przeglądanie i pobieranie plików dziennika

Pliki dziennika dostarczają informacji o operacjach Brama dostępu bezpośredniego. Qlik Pomoc techniczna może Cię poprosić o dostarczenie plików dziennika w celu rozwiązania problemów. Pliki dziennika można przeglądać lub pobierać w Podglądzie dziennika. W normalnych okolicznościach nie ma powodu, aby sprawdzać pliki dziennika, ale jeśli wystąpią powtarzające się awarie lub inne problemy, pliki dziennika często pomogą określić ich przyczynę.

InformacjaWyświetlanie i pobieranie dzienników wymaga roli Może używać danych.

Aby otworzyć Podgląd dziennika:

  1. W funkcji Konsola zarządzania przejdź do pozycji Bramy danych i znajdź Brama dostępu bezpośredniego.

  2. Kliknij na końcu wiersza i wybierz pozycję Zobacz dzienniki.

    Zostanie otwarte okno Podgląd dziennika.

  3. Z listy rozwijanej w lewym górnym rogu wybierz typ dziennika, o którego przejrzenie lub pobranie poprosił Cię zespół pomocy technicznej Qlik.

    Dostępne są następujące dzienniki:

    • Dzienniki Brama dostępu bezpośredniego (DirectAccessAgent)
    • Dzienniki DCaaS (dcaas_logs)
    • Dzienniki łącznika opartego na ODBC (odbc-connector_logs)
    • Dzienniki łącznika SAP BW (QvSAPBwConnector-<data + znacznik czasu>)
    • Dzienniki łącznika SAP SQL (QvSqlBwConnector-<data + znacznik czasu>)
    • Dzienniki agenta łącznika (connector-agent_logs_<data>)

  4. Z sąsiedniej listy rozwijanej wybierz dziennik, który chcesz wyświetlić lub pobrać. Pliki dzienników są uporządkowane od najnowszego (aktualnie aktywnego pliku dziennika) do najstarszego. Po wybraniu pliku dziennika można użyć przycisków i , aby przejść odpowiednio na początek lub koniec pliku dziennika.

    WskazówkaWidok pliku dziennika nie jest aktualizowany automatycznie o najnowsze komunikaty. Aby zaktualizować widok, kliknij ikonę w celu przejścia do końca pliku dziennika odświeżonego o najnowsze komunikaty.

  5. Aby pobrać plik dziennika, kliknij Pobierz.

    Plik zostanie pobrany na komputer lub pojawi się monit o jego zapisanie, w zależności od ustawień przeglądarki.

Otwieranie dzienników Brama dostępu bezpośredniego na komputerze z Brama dostępu bezpośredniego

Oprócz możliwości pobierania dzienników Brama dostępu bezpośredniego (DirectAccessAgent) z funkcji Konsola zarządzania można je także otwierać bezpośrednio z komputera z Brama dostępu bezpośredniego. W przypadku domyślnej instalacji dzienniki te znajdują się w następującym folderze:

C:\Program Files\Qlik\ConnectorAgent\data\logs

Zmiana poziomu szczegółowości rejestrowania

OstrzeżenieZmień poziom rejestrowania tylko wtedy, gdy poprosi o to przedstawiciel pomocy technicznej Qlik.

W razie potrzeby możesz przeglądać i zmieniać poziom szczegółowości rejestrowania dzienników Brama dostępu bezpośredniego (DirectAccessAgent). W tym celu uruchom następujące polecenia z podfolderu ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent w przypadku domyślnej instalacji).

  • Aby wyświetlić bieżący poziom rejestrowania, wykonaj:

    connectoragent configuration getloggers

  • Aby ustawić poziom rejestrowania na Trace, wykonaj:

    connectoragent configuration setloggers -l Root -v DEBUG

  • Aby ustawić poziom rejestrowania na Verbose, wykonaj:

    connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

Aktualizacja klucza rejestracyjnego

W mało prawdopodobnym przypadku uszkodzenia klucza lub jeśli pojawi się podejrzenie nieautoryzowanego dostępu do serwera bramy danych, może być konieczna zmiana klucza rejestracyjnego.

Aby zaktualizować klucz rejestracyjny:

  1. Na serwerze bramy dostępu bezpośredniego otwórz wiersz poleceń i zmień katalog roboczy na podfolder ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent w przypadku domyślnej instalacji).

  2. Wykonaj następujące polecenia:

    • Wygeneruj nowy klucz:

      connectoragent qcs generate_keys

    • Wyświetl klucz:

      connectoragent qcs get_registration

      Klucz jest pokazany:

  3. Skopiuj cały klucz, jak pokazano w powyższym przykładzie.

  4. W Konsola zarządzania otwórz ustawienia bramy danych, klikając przycisk na końcu odpowiedniego wiersza i wybierając pozycję Edytuj.

  5. Wklej klucz w polu Klucz (zastępując obecny klucz) i zapisz ustawienia.

  6. Wróć do serwera bramy dostępu bezpośredniego i ponownie uruchom usługę Brama danych Qlik — dostęp bezpośredni zgodnie z opisem w temacie Zarządzanie usługą Brama danych Qlik — dostęp bezpośredni.

Łagodzenie awarii łącznika podczas przeładowywania

Izolacja procesów umożliwia administratorom mającym bezpośredni dostęp do systemu operacyjnego serwera bramy kontrolowanie liczby procesów dostępnych do przeładowania w zależności od typu łącznika. Rozłożenie przeładowań na wiele procesów łącznika zwiększa poziom izolacji przez zmniejszenie liczby przeładowań działających jednocześnie w każdym procesie łącznika. To z kolei może poprawić ogólną stabilność Brama dostępu bezpośredniego w przypadku awarii łącznika.

Informacja

Wymaga Brama dostępu bezpośredniego w wersji 1.6.1 lub nowszej.

Aby włączyć izolację procesu:

  1. Otwórz plik C:\ProgramData\Qlik\Gateway\configuration.properties. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy zaznaczona jest opcja Pokaż ukryte pliki, foldery i dyski.

    Plik zawiera trzy prefiksy odpowiadające różnym typom łączników: ODBC_<nazwa-właściwości>, SAPBW_<nazwa-właściwości>, and SAPSQL_<nazwa-właściwości>.

  2. Ustaw ODBC|SAPBW|SAPSQL_PROCESS_ISOLATION_MODE na L\oad i ODBC|SAPBW|SAPSQL_MAX_PROCESS_COUNT na N.

    Gdzie:

    N= Jeden proces polecenia + Liczba jednoczesnych procesów przeładowania do przydzielenia. Na przykład wartość 10 oznaczałaby maksymalnie 9 równoczesnych przeładowań.

    Informacja

    Nie można ustawić wartości [ODBC|SAPBW|SAPSQL]_MAX_PROCESS_COUNT większej niż 10 z domyślnym numerem portu i ustawieniami zakresu.

  3. Zapisz plik configuration.properties i uruchom ponownie usługę Brama danych Qlik — dostęp bezpośredni.

Aby wyłączyć izolację procesu:

  1. Otwórz plik C:\ProgramData\Qlik\Gateway\configuration.properties. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy zaznaczona jest opcja Pokaż ukryte pliki, foldery i dyski.

  2. Ustaw ODBC|SAPBW|SAPSQL_PROCESS_ISOLATION_MODE na None.

  3. Zapisz plik configuration.properties i uruchom ponownie usługę Brama danych Qlik — dostęp bezpośredni.

Przykłady izolacji procesu łącznika ODBC

Poniższy fragment pliku configuration.properties pokazuje, jak włączyć izolację procesu łącznika ODBC dla maksymalnie 9 przeładowań:

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=10

Jeśli zmienisz domyślne ustawienia portu, wartość MAX_PROCESS_COUNT może przekroczyć 10. Jednak w tym przypadku:

  • Liczba portów między ODBC_PORT lub ODBC_DATA_PORT_RANGE_START a SAPBW_PORT lub SAPBW_DATA_PORT_RANGE_START musi być równa lub większa niż ODBC_MAX_PROCESS_COUNT

  • Liczba portów między SAPBW_PORT lub SAPBW_DATA_PORT_RANGE_START a SAPSQL_PORT lub SAPSQL_DATA_PORT_RANGE_START musi być równa lub większa niż SAPBW_MAX_PROCESS_COUNT

Na przykład, aby ustawić ODBC_MAX_PROCESS_COUNT=30, parametry portu powinny wyglądać mniej więcej tak:

# 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

Czy ta strona była pomocna?

Jeżeli natkniesz się na problemy z tą stroną lub jej zawartością — literówkę, brakujący krok lub błąd techniczny — daj nam znać, co możemy poprawić!

Przekaż tu opinię