# Wymagania wstępne

Poniższa sekcja opisuje wymagania wstępne, których spełnienia wymaga łącznik źródła SAP ODP.

Zanim będzie można umieszczać lub replikować dane, należy spełnić następujące wymagania wstępne:

* Zainstaluj wymagany SAP Java Connector na serwerze bramy Brama danych ruchu danych

  Informacja

  Jest to wymagane tylko wtedy, gdy pracujesz z bramą Brama danych ruchu danych. Informacje o zaletach bramy Brama danych ruchu danych i o okolicznościach, w których jest wymagana, zawiera temat [Brama danych Qlik — ruch danych](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm).

* Przyznaj wymagane uprawnienia w źródle danych

* Skonfiguruj łącznik źródła danych

## ODP API

Punkt końcowy SAP ODP wykorzystuje interfejs ODP API 2.0, który jest dostępny na następujących i wyższych poziomach składników SAP basis:

* PI\_BASIS 730 SP 14 (część SAP NetWeaver 7.30 SP 14)

* PI\_BASIS 731 SP 16 (część SAP NetWeaver 7.03 SP 16 i 7.31 SP 16)

* PI\_BASIS 740 SP 11 (część SAP NetWeaver 7.40 SP 11)

* SAP\_BW 750 SP 0 (w tym poprzednie pakiety PI\_BASIS)

InformacjaSAP\_BASIS i PI\_BASIS można stosować wymiennie. W nowszych systemach komponent ten nazywa się SAP\_BASIS.

Więcej informacji zawiera SAP Note 1931427.

Informacje na temat zwalniania ekstraktorów, aby były dostępne dla interfejsu ODP API, zawiera SAP Note 2232584.

## Konfiguracja sterowników

Sterownik driver można zainstalować za pomocą Narzędzia do instalacji sterowników (zalecane) lub ręcznie. Instalacji ręcznej należy próbować tylko w mało prawdopodobnym przypadku wystąpienia problemu z Narzędziem do instalacji sterowników.

### Używanie Narzędzia do instalacji sterowników w celu instalacji sterownika

W tej sekcji opisano, jak zainstalować wymagany SAP Java Connector. Proces ten obejmuje uruchomienie skryptu, który automatycznie pobierze, zainstaluje i skonfiguruje wymagany SAP Java Connector. W razie potrzeby można także uruchamiać skrypty, aby zaktualizować i odinstalować SAP Java Connector.

### Przygotowanie instalacji

* Na serwerze bramy Data Movement musi być zainstalowane środowisko Python 3.6 lub nowsze.

  Środowisko Python jest preinstalowane w większości dystrybucji systemu Linux. Aby sprawdzić, która wersja środowiska Pythona jest zainstalowana w Twoim systemie, uruchom następujące polecenie:

  python3 --version

* Pobierz łącznik SAP Java Connector <wersja> „sapjco<wersja>.zip” z portalu pomocy SAP. Obsługiwaną wersję można znaleźć w sekcji binary-artifacts w pliku /opt/qlik/gateway/movement/drivers/manifests/sapodp.yaml. Po zakończeniu pobierania skopiuj plik do:

  /opt/qlik/gateway/movement/drivers/sapodp

### Instalowanie aplikacji SAP Java Connector

Aby pobrać i zainstalować SAP Java Connector:

1. Zatrzymaj usługę Data Movement gateway:

   sudo systemctl stop repagent

2. Opcjonalnie potwierdź, że usługa została zatrzymana:

   sudo systemctl status repagent

   Status powinien być następujący:

   Active: inactive (dead) since <timestamp> ago

3. Na urządzenie bramy Data Movement zmień katalog roboczy na:

   opt/qlik/gateway/movement/drivers/bin

4. Wykonaj następujące polecenie:

   Składnia:

   ./install sapodp

   Jeśli SAP Java Connector nie może zostać pobrany (ze względu na ograniczenia dostępu lub problemy techniczne), zostanie wyświetlony komunikat informujący, skąd pobrać SAP Java Connector i dokąd go skopiować na urządzenie bramy Data Movement. Po wykonaniu tej czynności ponownie uruchom polecenie install sapodp.

   W przeciwnym razie zostanie wyświetlona umowa licencyjna dotycząca SAP Java Connector.

5. Wykonaj jedną z poniższych czynności:

   * Naciśnij klawisz [Enter] wielokrotnie, aby powoli przewinąć treść umowy licencyjnej.
   * Naciśnij klawisz spacji wielokrotnie, aby szybko przewinąć treść umowy licencyjnej.
   * Naciśnij klawisz „q”, aby zamknąć tekst umowy licencyjnej i wyświetlić opcje jej akceptacji.

6. Wykonaj jedną z poniższych czynności:

   * Wpisz „y” i naciśnij klawisz [Enter], aby zaakceptować umowę licencyjną i rozpocząć instalację.

   * Wpisz „n” i naciśnij klawisz [Enter], aby odrzucić umowę licencyjną i zakończyć instalację.

   * Wpisz „v” i naciśnij klawisz [Enter], aby ponownie wyświetlić umowę licencyjną.

   Zostanie zainstalowany SAP Java Connector.

7. Poczekaj na zakończenie instalacji (wskazane komunikatem „Ukończono!”), a następnie uruchom usługę Data Movement gateway:

   sudo systemctl start repagent

8. Opcjonalnie potwierdź, że usługa została uruchomiona:

   sudo systemctl status repagent

   Status powinien być następujący:

   Active: active (running) since <timestamp> ago

### SAP Java Connector — aktualizacja

Uruchom polecenie aktualizacji, jeśli chcesz odinstalować SAP Java Connector w poprzedniej wersji, zanim zainstalujesz dostarczony SAP Java Connector.

Aby pobrać i zaktualizować SAP Java Connector:

1. Zatrzymaj usługę Data Movement gateway:

   sudo systemctl stop repagent

2. Opcjonalnie potwierdź, że usługa została zatrzymana:

   sudo systemctl status repagent

   Status powinien być następujący:

   Active: inactive (dead) since <timestamp> ago

3. Na urządzenie bramy Data Movement zmień katalog roboczy na:

   opt/qlik/gateway/movement/drivers/bin

4. Wykonaj następujące polecenie:

   Składnia:

   ./update sapodp

   Jeśli SAP Java Connector nie może zostać pobrany (ze względu na ograniczenia dostępu lub problemy techniczne), zostanie wyświetlony komunikat informujący, skąd pobrać SAP Java Connector i dokąd go skopiować na urządzenie bramy Data Movement. Po wykonaniu tej czynności ponownie uruchom polecenie update sapodp.

   W przeciwnym razie zostanie wyświetlona umowa licencyjna dotycząca SAP Java Connector.

5. Wykonaj jedną z poniższych czynności:

   * Naciśnij klawisz [Enter] wielokrotnie, aby powoli przewinąć treść umowy licencyjnej.
   * Naciśnij klawisz spacji wielokrotnie, aby szybko przewinąć treść umowy licencyjnej.
   * Naciśnij klawisz „q”, aby zamknąć tekst umowy licencyjnej i wyświetlić opcje jej akceptacji.

6. Wykonaj jedną z poniższych czynności:

   * Wpisz „y” i naciśnij klawisz [Enter], aby zaakceptować umowę licencyjną i rozpocząć instalację.
   * Wpisz „n” i naciśnij klawisz [Enter], aby odrzucić umowę licencyjną i zakończyć instalację.
   * Wpisz „v” i naciśnij klawisz [Enter], aby wyświetlić umowę licencyjną od początku.

   Stary SAP Java Connector zostanie odinstalowany, a zainstalowany zostanie nowy SAP Java Connector.

7. Poczekaj na zakończenie instalacji (wskazane komunikatem „Ukończono!”), a następnie uruchom usługę Data Movement gateway:

   sudo systemctl start repagent

8. Opcjonalnie potwierdź, że usługa została uruchomiona:

   sudo systemctl status repagent

   Status powinien być następujący:

   Active: active (running) since <timestamp> ago

### SAP Java Connector — odinstalowywanie

Uruchom polecenie odinstalowania, jeśli chcesz odinstalować SAP Java Connector.

Aby odinstalować SAP Java Connector:

1. Zatrzymaj wszystkie zadania skonfigurowane do korzystania z tego łącznika.

2. Na urządzenie bramy Data Movement zmień katalog roboczy na:

   opt/qlik/gateway/movement/drivers/bin

3. Wykonaj następujące polecenie:

   Składnia:

   ./uninstall sapodp

   Sterownik SAP Java Connectorzostanie odinstalowany.

### Instalowanie sterownika ręcznie

Sterownik driver należy instalować ręcznie tylko wtedy, gdy automatyczna instalacja nie zakończyła się pomyślnie.

Pobierz SAP Java Connector 3.x (64-bit) for Linux z strony https://support.sap.com/en/product/connectors/jco.html.

Następnie otwórz wiersz poleceń i wykonaj następujące czynności:

1. Zatrzymaj usługę Data Movement gateway:

   sudo systemctl stop repagent

2. Opcjonalnie potwierdź, że usługa została zatrzymana:

   sudo systemctl status repagent

   Status powinien być następujący:

   Active: inactive (dead) since <timestamp> ago

3. Zmień katalog roboczy na opt/qlik/gateway/movement/bin i uruchom następujące polecenie:

   source arep\_login.sh

   Spowoduje to ustawienie ścieżki instalacji bramy Data Movement.

4. Rozpakuj pobrany plik do wybranego przez siebie folderu.

   Folder ten powinien zawierać pliki Sapjco3.jar i libsapjco3.so.

5. Skopiuj te pliki do następującej lokalizacji w Data Movement gateway katalogu instalacyjnym:

   <katalog\_instalacji\_Data Movement gateway>/endpoint\_srv/endpoints/SAP.

6. Uruchom usługę Data Movement gateway:

   sudo systemctl start repagent

7. Opcjonalnie potwierdź, że usługa została uruchomiona:

   sudo systemctl status repagent

   Status powinien być następujący:

   Active: active (running) since <timestamp> ago

Informacja

Aby łącznik SAP ODP stał się dostępny do wybrania, należy najpierw zainstalować biblioteki łączników Java i ponownie uruchomić usługę Data Movement gateway.

## Obsługa tabel STXL

Aby udostępnić tabelę STXL do wyodrębnienia przy użyciu punktu końcowego SAP ODP, należy utworzyć niestandardowy ekstraktor w transakcji RSO2 w graficznym interfejsie użytkownika SAP. Ten ekstraktor może być następnie wywoływany przez punkt końcowy SAP ODP.

## Konfiguracja SLT w SAP

Aby móc replikować dane, należy najpierw zdefiniować parametry, których SAP Landscape Transformation Replication Server będzie używać do replikacji danych z systemu źródłowego do docelowego. Informacje te określa się w konfiguracji. Konfiguracja zawiera informacje o systemie źródłowym, systemie docelowym i odpowiednich połączeniach.

Konfigurację tworzy się w systemie SAP Landscape Transformation Replication Server. Aby utworzyć konfigurację, otwórz SAP LT Replication Server Cockpit (transakcja LTRC) i wybierz opcję Create Configuration (Utwórz konfigurację).

Tworzenie konfiguracji obejmuje następujące kroki:

1. Na karcie Specify General Data (Określ ogólne dane) podaj następujące informacje:

   * Configuration Name (Nazwa konfiguracji): określ nazwę konfiguracji. Ta nazwa jest używana dla schematu tworzonego automatycznie w systemie docelowym.

   * Description (Optional) (Opis (opcjonalnie)): opcjonalnie możesz wprowadzić opis konfiguracji.

2. Na karcie Specify Source System (Określ system źródłowy) wybierz opcję RFC Connection (Połączenie RFC) i podaj następujące informacje:

   * RFC Destination (Miejsce docelowe RFC): wprowadź NONE (Brak).
   * Allow Multiple Usage: (Zezwól na wielokrotne użycie): wybierz tę opcję.

3. Na karcie Specify Target System (Określ system docelowy) wybierz opcję Other (Inny) i podaj następujące informacje:

   * Scenario: (Zastosowanie): wybierz Operational Data Provisioning (ODP) (Aprowizacja danych operacyjnych (ODP)) z listy rozwijanej.
   * Queue Alias (Alias kolejki): określ nazwę.

4. Na karcie Specify Transfer Settings (Określ ustawienia transferu) określ ustawienia transferu odpowiednie dla Twojego środowiska. W obszarze Job Options (Opcje zadania) zalecamy ustawienie co najmniej pięciu zadań przesyłania danych, ładowania początkowego i obliczeń.

5. Na karcie Review and Create (Sprawdź i utwórz) przejrzyj ustawienia i utwórz konfigurację.

6. Przyznaj [Wymagane uprawnienia](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/SourcesConnections/SAP-ODP/sap-odp-permissions.htm).

Po utworzeniu konfiguracji możesz przystąpić do konfiguracji odpowiednich ustawień łącznika.