Rozwiązywanie problemów z 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ę.

Aby otworzyć Podgląd dziennika:

1. W centrum aktywności Administrowanie 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 ODP (QvSapConnectorPackage-<process_id>)
   • 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 centrum aktywności Administrowanie 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

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 centrum aktywności Administrowanie 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.

Wydłużenie czasu trwania sesji przeładowania

Jeśli połączenie pomiędzy Brama dostępu bezpośredniego a Qlik Cloud będzie bezczynne przez co najmniej 20 sekund, operacja przeładowania może czasami zakończyć się niepowodzeniem z następującym komunikatem o błędzie:

Invalid object name '#<TempTableName>' (indicating that the Brama dostępu bezpośredniego temp tables are unavailable).

Domyślny czas trwania sesji wynosi 20 sekund, ale jeśli ten błąd często się pojawia, możesz wydłużyć czas sesji następująco:

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

2. Znajdź parametr ODBC_RELOAD_SESSION_LIFE i zwiększ jego wartość odpowiednio do potrzeb.
3. Zapisz plik configuration.properties i uruchom ponownie usługę Brama danych Qlik — dostęp bezpośredni.

Wydłużenie limitu czasu żądań ładowania

Gdy wystąpią przerwy w działaniu sieci, przeładowanie może się zakończyć niepowodzeniem i mogą wystąpić następujące błędy:

Connector error: The session does not exist (DirectAccess-1509)

Connector error: The stream session expired for the load data request (DirectAccess-1012)

Jeżeli powyższe błędy występują często, spróbuj ustawić parametr EXTEND_FIRST_REQUEST_TIMEOUT na 5–10 minut.

Wykonaj następujące czynności:

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

2. Znajdź parametr EXTEND_FIRST_REQUEST_TIMEOUT i zwiększ jego wartość do 5–10 minut. Wartość domyślna to 0.
3. Zapisz plik configuration.properties i uruchom ponownie 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.

Wyłączanie izolacji procesu

Pomoc techniczna Qlik może Cię poprosić o wyłączenie izolacji procesów w celu rozwiązywania problemów.

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 opcję [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE (Koloruj wszystkie wiersze wg warunku) na wartość None (Wskazane wiersze).

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

Włączanie izolacji procesów lub zmiana liczby jednoczesnych przeładowań

Aby włączyć izolację procesów lub zmienić liczbę jednoczesnych przeładowań:

1. Otwórz C:\ProgramData\Qlik\Gateway\configuration.properties jako administrator. 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 łącznika:ODBC_<property-name>, SAPBW_<property-name>, SAPSQL_<property-name> i SAPPACKAGE_<property-name>

2. Ustaw [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE na Load i [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_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ń.

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 12 przeładowań:

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=13

 

Począwszy od wersji Brama dostępu bezpośredniego 1.6.7, wartość MAX_PROCESS_COUNT może przekroczyć 10 bez konieczności zmiany innych ustawień. Aby w pełni odizolować przeładowania z określonym typem łączników (tj. nie więcej niż jedno przeładowywanie na proces łącznika), wartość ta powinna wynosić minimum 30, ale może być konieczne ustawienie jej nawet na 60, w zależności od obciążenia.

Przechowywanie uszkodzonych lub brakujących fragmentów danych do przyszłego przeładowania

W przypadku każdej operacji przeładowania Brama dostępu bezpośredniego może zapisać uszkodzone lub brakujące fragmenty danych w pamięci i przenieść je na dysk. Jest to szczególnie przydatne, jeśli nie korzystasz z automatycznego odzyskiwania i często napotykasz na błędy 4025, 4020 i 4021. Funkcję tę można włączyć, ustawiając próg rozmiaru pamięci podręcznej na potrzeby przenoszenia uszkodzonych lub brakujących fragmentów danych na dysk (do każdego przeładowania). Po osiągnięciu określonego progu brama przekaże dalsze zaszyfrowane fragmenty na dysk komputera bramy Brama dostępu bezpośredniego.

Aby ustawić rozmiar pamięci podręcznej:

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

2. Ustaw RELOAD_CACHE_MEMORY_MB na N (wartość domyślna to 0, co oznacza, że funkcja nie jest włączona).

   Gdzie:

   N = rozmiar, jaki może osiągnąć fragment danych przed przeładowaniem.

   InformacjaWłączenie tej funkcji zwiększy zużycie pamięci na komputerze z Brama dostępu bezpośredniego, dlatego zalecamy monitorowanie wpływu na pamięć, gdy jest ona włączona. W większości sytuacji ustawienie wartości RELOAD_CACHE_MEMORY_MB na 100 powinno wystarczyć.
3. Zapisz plik configuration.properties i uruchom ponownie usługę Brama danych Qlik — dostęp bezpośredni.