Quickstart Guide On-Premise
Ten Quickstart Guide zawiera wszystkie niezbedne czynnosci przygotowawcze, aby instalacja dab Nexus przebiegla mozliwie najplynniej. Nalezy zadbac, aby ponizsze zadania zostaly wykonane przez Panstwa, zespol SAP Basis i/lub dzial IT przed rozpoczeciem instalacji. W tekscie ponizej listy kontrolnej znajduja sie odnosniki do odpowiednich artykulow.
Lista kontrolna
Ponizej znajduje sie lista kontrolna, w ktorej mozna po prostu odznaczac kroki po ich wykonaniu przez Panstwa zespol IT i/lub zespol SAP Basis. W kolumnie Odpowiedzialnosc mozna dodatkowo sprawdzic, kto odpowiada za realizacje danego zadania.
⬇️ Pobierz liste kontrolna (PDF)
1. SAP-System (dostarczane przez Panstwa z wyprzedzeniem)
SAP-System stanowi pierwszy i fundamentalny element Panstwa przyszlych danych. To wlasnie z tego systemu zostana pozyskane, przeanalizowane i przetworzone wszystkie istotne dla Panstwa dane.
1.1 Instalacja Modulu RFC
Aby zainstalowac modul funkcji RFC /DABEXP/RFC_SAPCONNECTOR w SAP-System, prosze postepowac zgodnie z tym artykulem.
1.2 Nadanie uprawnien uzytkownikom SAP
Nalezy upewnic sie, ze uzytkownicy SAP posiadaja odpowiednie uprawnienia. W tym artykule (sekcja Uprawnienia) zamieszczono liste uprawnien SAP, ktore nalezy przydzielic. W sekcji Testowanie tej instrukcji opisano takze czynnosci zwiazane ze sprawdzeniem dzialania modulu funkcji /DABEXP/RFC_SAPCONNECTOR.
1.3 Konfiguracja SNC - OPCJONALNIE
Jesli polaczenie ma byc zabezpieczone lub uwierzytelniane za pomoca SNC, odpowiednie ustawienia musza zostac skonfigurowane w SAP-System. Istnieje wiele roznych rozwiazan SNC, dlatego nie przedstawiamy tu ogolnych wskazowek – zalecamy omowienie tej kwestii z Panstwa zespolem SAP. Dodatkowe informacje znajduja sie w SAP Help Portal: Transport Layer Security on SAP NetWeaver AS for ABAP | SAP Help Portal
1.4 Testowanie Modulu Funkcyjnego RFC - OPCJONALNIE
Do przetestowania zarowno polaczenia modulu RFC, jak i jego poprawnego dzialania, mozna wykorzystac dab FunctionModuleTester. Szczegoly znajduja sie w tym artykule.
2. SQL-Server (dostarczany przez Panstwa z wyprzedzeniem) – wymagany tylko dla Analytic Tasks lub w przypadku ekstrakcji danych do SQL
SQL-Server pelni dwie rozne funkcje:
- Baza danych aplikacji: Przechowywane sa w niej wszelkie ustawienia uzytkownikow niezbedne do zapewnienia prawidlowej pracy systemu
- Bazy danych procesowych: Tu znajda sie pozniej wyekstrahowane i przetworzone Panstwa dane
2.1 Przypisanie uzytkownika
dab Nexus mozna uwierzytelnic na serwerze bazy danych za pomoca uwierzytelniania Windows lub SQL-Server. Kierujac sie ponizsza zasada, latwiej bedzie podjac decyzje:
- dab Nexus i SQL-Server na tym samym serwerze: zalecane uwierzytelnianie Windows
- dab Nexus i SQL-Server na oddzielnych serwerach: zalecane uwierzytelnianie SQL-Server
Wiecej informacji znajduje sie w tym artykule.
2.2 Utworzenie bazy danych aplikacji
Ta baza sluzy do przechowywania ustawien dab Nexus. Zalecamy nadanie dab Nexus roli db_owner.
Jesli dab Nexus ma automatycznie tworzyc bazy danych dla wyekstrahowanych i przeanalizowanych danych, na poziomie serwera nalezy nadac dab Nexus takze role dbcreator.
Mozliwe jest rowniez przydzielenie dab Nexus ponizszych ról na poziomie bazy danych:
- db_datareader
- db_datawriter
- db_ddladmin
2.3 Rozmiar grup plikow
Do bazy danych aplikacji wystarczy ok. 5-10 GB, natomiast rozmiar bazy procesowej zalezy w duzym stopniu od sposobu wykorzystania dab Nexus. Nie mozna tu przedstawic ogolnych wytycznych, lecz na poczatek proponujemy ustawic PRIMARY FILEGROUP bazy procesowej na 500 GB, a nastepnie szacowac potrzeby przestrzeni dyskowej po kilku testowych analizach.
Warto omowic z dzialem IT wczesniejsze przygotowanie na ewentualna potrzebe dynamicznej zmiany rozmiaru pamieci na SQL-Server, aby uniknac opoznien podczas testow i wdrozenia.
Ponadto nalezy zadbac, aby zwiekszyc pamiec dla ponizszych elementow do poziomu co najmniej ok. 30% rozmiaru PRIMARY FILEGROUP:
- LOG FILE (dla kazdej bazy): Manage transaction log file size - SQL Server | Microsoft Learn
- tempdb (na serwer): tempdb database - SQL Server | Microsoft Learn
W tym przypadku dab Nexus to On-Premise oprogramowanie, zarzadzane i uruchamiane na infrastrukturze IT Panstwa firmy. Jesli w firmie obowiazuja odpowiednie polityki, nalezy wczesniej ustalic kwestie tworzenia kopii zapasowych i restartow z dzialem IT.
2.4 Instalacja serwerow Machine Learning pod integracje R - OPCJONALNIE
Jesli chcecie Panstwo korzystac z dab AnalyticSuite for SQL wraz z rozszerzeniami Machine Learning, zainstalowanie odpowiednich Machine Learning Services na SQL-Server jest niezbedne. Instrukcje znajda Panstwo tutaj.
3. Application Server (dostarczany przez Panstwa z wyprzedzeniem)
Kroki od 3.1 do 3.7 musza zostac przygotowane przez Panstwa. Kroki od 3.8 do 3.10 zostana zrealizowane przez dab wspolnie z Panstwem.
Ten rozdzial dotyczy przygotowania Application Server, na ktorym bedzie pracowal dab Nexus.
3.1 Dostarczenie serwera i przyznanie dostepu
Serwer musi zostac zapewniony przez Panstwa przed rozpoczeciem procesu. Do instalacji dab Nexus na serwerze wymagane sa uprawnienia administratora.
Serwer przewidziany pod instalacje dab Nexus powinien spelniac okreslone wymagania. Szczegolowa specyfikacje znajda Panstwo tutaj. Oprocz podstawowej lacznosci nalezy sprawdzic, czy konfiguracja zapory sieciowej nie blokuje polaczenia pomiedzy dab Nexus a systemem docelowym lub nie zmienia przesylanych danych. Instrukcje dotyczace konfiguracji zapory znajduja sie tutaj.
3.2 Polaczenia sieciowe
a. SAP-System
Application server musi moc komunikowac sie z SAP-System, by pobierac dane.
Dzial IT musi zadbac, aby SAP-System byl dostepny z poziomu application server.
Wymagane porty sieciowe (TCP):
- RFC Application Server: 3300-3399
- RFC Message Server: 3600-3699
- RFC SNC: 4800-4899
- SAProuter: 3299
Wiecej informacji w SAP Help Portal: TCP/IP Ports of All SAP Products | SAP Help Portal
b. SQL-Server
Analogicznie jak dla SAP-System, rowniez SQL-Server musi byc dostepny z poziomu application server, aby analizowac wyeksportowane dane i zapisywac je w bazach.
Dzial IT musi zadbac, by polaczenie bylo mozliwe oraz by istniala mozliwosc tworzenia baz danych.
Wymagane porty sieciowe:
- Default Instance: TCP 1433
- Named Instances lub SQL-Server Browser Service: UDP 1434
Porty moga byc inne – nalezy ustalic je z dzialem IT. Szczegoly w dokumentacji Microsoft: Configure the Windows Firewall to allow SQL Server access - SQL Server | Microsoft Learn
3.3 Pozyskanie certyfikatow SSL - OPCJONALNIE
Ten artykul zawiera wszystkie niezbedne informacje dotyczace instalacji certyfikatu SSL na serwerze. Nie udzielamy wsparcia w zakresie generowania certyfikatow SSL, gdyz kwestie te zalezne sa od Panstwa polityk i procesow IT.
3.4 Konfiguracja srodowiska AD dla Single Sign-On - OPCJONALNIE
Jesli zamiast adresu e-mail i hasla preferowane jest logowanie do dab Nexus poprzez Single Sign-On (SSO), mozliwa jest integracja dab Nexus z istniejacym rozwiazaniem SSO. Obslugujemy Microsoft Entra ID (dawniej Azure Active Directory) oraz Active Directory Federation Services. Szczegolowy opis wdrozenia znajduje sie w tej instrukcji.
3.5 Instalacja rozwiazania SAP SNC - OPCJONALNIE
Jesli laczenie z SAP poprzez RFC wymaga SNC, nalezy wczesniej zainstalowac i skonfigurowac wybrane rozwiazanie SNC. Poniewaz rozwiazania te sa mocno indywidualne, nie prezentujemy ogolnych metod konfiguracji. Mozemy natomiast wskazac dwa czesto uzywane rozwiazania:
- Secure Login for SAP Single Sign-On: Secure Login Client Installation | SAP Help Portal
- SAPCRYPTOLIB: 1848999 - Central Note for CommonCryptoLib 8 (SAPCRYPTOLIB) - SAP for Me
Ze wzgledu na czesto skomplikowana architekture systemowa, zalecana jest scisla wspolpraca zespolow SAP Basis i IT podczas wdrozenia SNC.
3.6 Instalacja bibliotek RFC
Mimo iz dab Nexus wspiera jeszcze librfc32 do wersji 1.17.262 (SAP zakonczyl wsparcie tej implementacji RFC w 2016 r., wiec nie otrzymuje ona poprawek), jako ze wersja 64-bitowa zapewnia wieksza stabilnosc, rekomendujemy jej uzycie. Wsparcie konczy sie wraz z aktualizacja do wersji 1.18.x dab Nexus!
SAP RFC libraries musza byc zainstalowane na application server, by mozliwe bylo ustanowienie polaczenia z SAP-System.
Dostepne sa dwie metody instalacji:
- Instalacja przez SAP GUI: Jesli instalacja SAP GUI jest wykonywana przez Panstwa lub dzial IT i wybierane sa funkcje Unicode RFC Libraries, wowczas biblioteki RFC zostana zainstalowane automatycznie.
- Instalacja manualna: Mozna rowniez samodzielnie pobrac odpowiednie biblioteki z SAP Software Center i zainstalowac je recznie. Instrukcja znajduje sie tutaj.
3.7 Udostepnienie plikow instalacyjnych
Przed rozpoczciem instalacji nalezy upewnic sie, ze pakiet instalacyjny (w formacie .zip lub juz rozpakowany) znajduje sie na application server. Pliki te mozna pobrac poprzez customer Portal.
3.8 Uruchomienie instalatora (przez dab razem z Panstwem)
Choc instalacja systemu moze zostac przeprowadzona samodzielnie, rekomendujemy wykonanie jej wspolnie z naszym zespołem – pozwoli to uniknac czestych bledow i na biezaco rozwiazywac pojawiajace sie pytania.
Uruchomienie instalatora dab Nexus wymaga uprawnien administratora na application server. Jesli podczas instalacji zostanie wybrany adres URL aplikacji z HTTPS, wczesniej nalezy dostarczyc certyfikat SSL. W przeciwnym razie pozniej nie bedzie mozliwe uruchomienie uslugi Windows, a dab Nexus bedzie niedostepny.
Dokladny opis instalacji znajduje sie w tym artykule – sekcja Manual Installation of the SAP NetWeaver RFC.
3.9 Konfiguracja wstepna (przez dab razem z Panstwem)
W tym kroku personalizowana jest konfiguracja w pliku Configuration.json. Okresla sie w nim m.in. sposob dostepu do SQL-Server (SSO lub uwierzytelnianie Windows), adres URL i port aplikacji dab Nexus oraz to, czy zostanie uzyty certyfikat. Szczegolowe informacje dotyczace edycji Configuration.json sa dostepne w tym artykule.
Nastepnie uruchamiana jest usluga Windows dla dab Nexus. Kolejnym etapem jest wstepna konfiguracja dab Nexus, obejmujaca aktywacje licencji i utworzenie uzytkownika.
3.10 Konfiguracja dostepu dla klientow (przez dab razem z Panstwem)
Jesli uzytkownicy koncowi maja korzystac z dab Nexus poprzez klienty, nalezy zapewnic spelnienie nastepujacych warunkow:
- Dostep do dab Nexus przez przegladarke