Quickstart Guide On-Premise
Dieses Quickstart Guide enthält alle notwendigen (Vor-)Arbeiten, um die Installation von dab Nexus so reibungslos wie möglich zu gestalten. Es ist wichtig, dass die folgenden Aufgaben im Vorfeld von Ihnen, Ihrem SAP-Basis-Team und/oder Ihrem IT-Team durchgeführt werden. Die Links zu den jeweiligen Artikeln finden Sie im Text unterhalb der Checkliste.
Checkliste
Nachfolgend finden Sie eine Checkliste, in der Sie die einzelnen Schritte einfach abhaken können, sobald Sie, Ihr IT-Team und/oder das SAP-Basis-Team diese erledigt haben. In der Spalte Verantwortung sehen Sie zudem, wer für die jeweilige Aufgabe verantwortlich ist.
⬇️ Checkliste herunterladen (PDF)
Checkliste Quickstart Guide On-Premise
| Schritt | Aufgabe | Verantwortung | Erledigt? |
|---|---|---|---|
| 1 | SAP-System | ||
| 1.1 | RFC-Modul Installation | Kunde (SAP-Basis) | ⬚ |
| 1.2 | SAP-Benutzerbereitstellung | Kunde (SAP-Basis) | ⬚ |
| 1.3 | OPTIONAL – SNC-Konfiguration | Kunde (SAP-Basis) | ⬚ |
| 1.4 | OPTIONAL – RFC-Funktionsmodultest | Kunde (SAP-Basis) | ⬚ |
| 2 | SQL-Server | ||
| 2.1 | Benutzerzuordnung | Kunde (IT-Team) | ⬚ |
| 2.2 | Anlage der Anwendungsdatenbank | Kunde (IT-Team) | ⬚ |
| 2.3 | Filegroup-Größenbemessung | Kunde (IT-Team) | ⬚ |
| 2.4 | OPTIONAL – Installation Machine Learning Services für R-Integration | Kunde (IT-Team) | ⬚ |
| 3 | Application Server | ||
| 3.1 | Serverbereitstellung und Zugriff | Kunde (IT-Team) | ⬚ |
| 3.2 | Netzwerkverbindungen (SAP-System & SQL-Server) | Kunde (IT-Team) | ⬚ |
| 3.3 | OPTIONAL – Beschaffung SSL-Zertifikate | Kunde (IT-Team) | ⬚ |
| 3.4 | OPTIONAL – Konfiguration der AD-Umgebung für Single-Sign-On | Kunde (IT-Team) | ⬚ |
| 3.5 | OPTIONAL – Installation der SNC-Lösung | Kunde (IT-Team) | ⬚ |
| 3.6 | Installation der RFC-Bibliotheken | Kunde (IT-Team) | ⬚ |
| 3.7 | Bereitstellung der Installationsdateien | Kunde | ⬚ |
| 3.8 | Ausführung des Installers | dab & Kunde | ⬚ |
| 3.9 | Erstkonfiguration | dab & Kunde | ⬚ |
| 3.10 | Einrichtung für Clientzugriff | dab & Kunde | ⬚ |
1. SAP-System (vorab von Ihnen bereitzustellen)
Das SAP-System ist der erste wichtige Baustein und zugleich die Grundlage Ihrer zukünftigen Daten. Alle für Sie relevanten Daten werden später aus diesem SAP-System extrahiert, analysiert und verarbeitet.
1.1 RFC-Modul Installation
Folgen Sie diesem Artikel, um das RFC-Funktionsmodul /DABEXP/RFC_SAPCONNECTOR in Ihrem SAP-System zu installieren.
1.2 SAP-Benutzerbereitstellung
Es muss sichergestellt sein, dass die SAP-Benutzer über die notwendigen Berechtigungen verfügen. In diesem Artikel (Abschnitt Berechtigungen) finden Sie die SAP-Berechtigungen, die zu vergeben sind. Die erforderlichen Schritte zum Testen des Funktionsmoduls /DABEXP/RFC_SAPCONNECTOR finden Sie zudem im Abschnitt „Testen“ dieser Anleitung.
1.3 SNC-Konfiguration - OPTIONAL
Falls SNC zur Absicherung oder Authentifizierung der Verbindung verwendet werden soll, sind die entsprechenden Einstellungen auf dem SAP-System vorzunehmen. Da es viele verschiedene SNC-Lösungen gibt, können wir an dieser Stelle keine allgemeingültigen Anleitungen bereitstellen und empfehlen, dieses Thema mit Ihrem SAP-Team zu besprechen. Weitere Informationen finden Sie in der SAP-Hilfe Portal: Transport Layer Security on SAP NetWeaver AS for ABAP | SAP Help Portal
1.4 RFC-Funktionsmodul-Tester - OPTIONAL
Sie können den dab FunctionModuleTester dazu verwenden, sowohl die Verbindung des RFC-Moduls als auch die Funktionsfähigkeit des installierten RFC-Funktionsmoduls zu überprüfen. Gehen Sie dazu nach diesem Artikel vor.
2. SQL-Server (vorab von Ihnen bereitzustellen) – nur erforderlich für Analytic Tasks oder wenn Sie nach SQL extrahieren möchten
Der SQL-Server erfüllt zwei verschiedene Aufgaben:
- Anwendungsdatenbank: Alle für den Betrieb notwendigen Benutzereinstellungen werden in dieser Datenbank gespeichert
- Prozessdatenbank(en): Diese Datenbanken enthalten später Ihre extrahierten und verarbeiteten Daten
2.1 Benutzerzuordnung
dab Nexus kann sich mit Windows-Authentifizierung oder SQL-Server-Authentifizierung am Datenbankserver anmelden. Die folgende Regel hilft Ihnen bei der Entscheidung:
- dab Nexus und SQL-Server befinden sich auf demselben Server: Windows-Authentifizierung empfohlen
- dab Nexus und SQL-Server befinden sich auf unterschiedlichen Servern: SQL-Server-Authentifizierung empfohlen
Weitere Informationen finden Sie in diesem Artikel.
2.2 Anlage der Anwendungsdatenbank
Diese Datenbank dient der Speicherung der dab Nexus-Einstellungen. Wir empfehlen, dab Nexus die Rolle db_owner zuzuweisen.
Wenn dab Nexus Datenbanken für die extrahierten und analysierten Daten automatisch anlegen soll, muss dab Nexus auf Serverebene auch die Rolle dbcreator zugewiesen werden.
Zusätzlich können auf Datenbankebene folgende Rollen an dab Nexus vergeben werden:
- db_datareader
- db_datawriter
- db_ddladmin
2.3 Filegroup-Größenbemessung
Während wir für die Anwendungsdatenbank in der Regel nicht mehr als ca. 5–10 GB benötigen, hängt die Größe der Verarbeitungsdatenbank stark davon ab, wie Sie dab Nexus einsetzen. Wir können daher keine allgemeingültige Aussage treffen, empfehlen aber, zum Einstieg 500 GB für den PRIMARY FILEGROUP Ihrer Verarbeitungsdatenbank einzuplanen und den Speicherbedarf nach einigen Analyseläufen zu schätzen.
Klären Sie im Vorfeld mit Ihrem IT-Team, ob eine kurzfristige Speichererweiterung auf dem SQL-Server möglich ist, um Verzögerungen in der Test- und Einführungsphase zu minimieren.
Zudem muss der Speicher folgender Elemente auf mindestens ca. 30 % des PRIMARY FILEGROUP vergrößert werden:
- LOG FILE (je Datenbank): Manage transaction log file size – SQL Server | Microsoft Learn
- tempdb (je Datenbankserver): tempdb database – SQL Server | Microsoft Learn
In diesem Fall handelt es sich bei dab Nexus um eine On-Premise-Software, die auf Ihrer IT-Infrastruktur betrieben und verwaltet wird. Klären Sie daher etwaige Backup- und Wiederanlaufstrategien im Voraus mit Ihrer IT, sofern Ihr Unternehmen entsprechende Richtlinien hat.
2.4 Installation Machine Learning Services für R-Integration - OPTIONAL
Wenn Sie die dab AnalyticSuite für SQL in Verbindung mit Machine-Learning-Erweiterungen nutzen wollen, müssen die entsprechenden Machine Learning Services auf dem SQL-Server installiert werden. Die genaue Vorgehensweise finden Sie hier.
3. Application Server (vorab von Ihnen bereitzustellen)
Die Schritte 3.1 bis 3.7 müssen von Ihrer Seite vorbereitet werden. Die Schritte 3.8 bis 3.10 werden gemeinsam mit dab durchgeführt.
In diesem Abschnitt geht es um die Vorbereitung des Application Servers, auf dem dab Nexus betrieben wird.
3.1 Serverbereitstellung und Zugriff
Der Server muss von Ihnen im Vorfeld bereitgestellt werden. Für die Installation von dab Nexus auf dem Server benötigen Sie Administratorrechte.
Der Server, auf dem dab Nexus installiert wird, muss bestimmte Anforderungen erfüllen. Die detaillierten Systemanforderungen finden Sie hier. Zusätzlich zur grundlegenden Erreichbarkeit stellen Sie sicher, dass die Firewall-Konfiguration weder die Verbindung zwischen dab Nexus und dem Zielsystem blockiert noch deren Daten verändert. Eine Anleitung zur Firewall-Konfiguration finden Sie hier.
3.2 Netzwerkverbindungen
a. SAP-System Der Application Server muss mit dem SAP-System kommunizieren können, um die erforderlichen Daten zu extrahieren. Ihr IT-Team muss sicherstellen, dass das SAP-System vom Application Server aus erreichbar ist.
Benötigte Netzwerkports (TCP) sind:
- RFC Application Server: 3300 – 3399
- RFC Message Server: 3600 – 3699
- RFC SNC: 4800 – 4899
- SAProuter: 3299
Weitere Informationen finden Sie in der SAP-Hilfe Portal: TCP/IP Ports of All SAP Products | SAP Help Portal
b. SQL-Server Auch der SQL-Server muss – wie das SAP-System – vom Application Server aus erreichbar sein, damit die extrahierten Daten analysiert und in Datenbanken gespeichert werden können. Ihr IT-Team muss sicherstellen, dass die Verbindung zum SQL-Server möglich ist und Datenbanken erzeugt werden können.
Erforderliche Netzwerkports:
- Standardinstanz: TCP 1433
- Benannte Instanzen oder SQL Server-Browserdienst: UDP 1434
Die Ports können abweichen. Klären Sie dies vorab mit Ihrem IT-Team. Weitere Informationen finden Sie in der Microsoft-Dokumentation: Configure the Windows Firewall to allow SQL Server access – SQL Server | Microsoft Learn
3.3 Beschaffung von SSL-Zertifikaten - OPTIONAL
Dieser Artikel enthält alle Informationen zur Installation eines SSL-Zertifikats auf Ihrem Server. Zur Ausstellung von SSL-Zertifikaten können wir keine weiteren Hinweise geben, da dies stark von Ihrer IT-Policy und Ihren Prozessen abhängt.
3.4 Konfiguration der AD-Umgebung für Single Sign-On - OPTIONAL
Wenn Sie sich an dab Nexus per Single Sign-On (SSO) statt mit E-Mail-Adresse und Kennwort anmelden möchten, können Sie dab Nexus mit einer bestehenden SSO-Lösung integrieren. Unterstützt werden Microsoft Entra ID (vormals Azure Active Directory) und Active Directory Federation Services. Die genaue Vorgehensweise erläutern wir in dieser Anleitung.
3.5 Installation der SAP SNC-Lösung - OPTIONAL
Wenn Sie eine RFC-Anbindung an SAP SNC benötigen, stellen Sie bitte im Vorfeld sicher, dass die SNC-Lösung installiert und entsprechend konfiguriert ist. Da diese Lösungen sehr individuell sind, können wir keine allgemeingültigen Anleitungen bereitstellen. Verweisen möchten wir aber auf zwei häufig genutzte SNC-Lösungen:
- 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
Da das Einrichten einer SNC-Lösung – je nach Systemlandschaft – mit einigem Aufwand verbunden sein kann, empfehlen wir eine enge Abstimmung zwischen SAP-Basis und IT.
3.6 Installation der RFC-Bibliotheken
Auch wenn dab Nexus die librfc32 bis Version 1.17.262 unterstützt (SAP unterstützt diese RFC-Implementierung seit 2016 nicht mehr und sie erhält somit keine Sicherheitsupdates mehr), empfehlen wir für mehr Stabilität die Nutzung der 64-bit-Version. Mit dem Update auf eine 1.18.x-Version von dab Nexus endet die Unterstützung!
Die SAP RFC-Bibliotheken müssen auf dem Application Server installiert sein, damit Sie erfolgreich eine Verbindung zum SAP-System aufbauen können.
Sie haben für die Installation zwei Möglichkeiten:
- Installation über SAP GUI: Wird SAP GUI von Ihnen bzw. Ihrer IT installiert und die Funktion Unicode RFC Libraries ausgewählt, werden die entsprechenden Bibliotheken automatisch korrekt installiert.
- Manuelle Installation: Sie können die benötigten Bibliotheken auch im SAP Software Center herunterladen und manuell installieren. Die entsprechende Anleitung finden Sie hier.
3.7 Bereitstellung der Installationsdateien
Bitte stellen Sie sicher, dass das Installationspaket (als .zip oder bereits entpackt) vor der Installation auf dem Application Server zur Verfügung steht. Sie erhalten das Paket im Kunden-Portal.
3.8 Ausführung des Installers (durch dab gemeinsam mit Ihnen)
Sie können die Software selbst installieren, wir empfehlen jedoch die gemeinsame Installation, um typische Fehler zu vermeiden und auftretende Fragen direkt zu klären.
Für die Ausführung des dab Nexus Setups werden Administratorrechte auf dem Application Server benötigt. Wird im Rahmen der Installation eine Applikations-URL mit HTTPS gewählt, muss vorab ein SSL-Zertifikat bereitgestellt werden. Andernfalls kann der Windows-Dienst später nicht gestartet werden und dab Nexus ist nicht erreichbar.
Wie genau die Installation funktioniert, erfahren Sie in diesem Artikel – Abschnitt Manual Installation of the SAP NetWeaver RFC.
3.9 Erstkonfiguration (durch dab gemeinsam mit Ihnen)
Hier wird die Configuration.json angepasst. Es wird festgelegt, wie der Zugriff auf den SQL-Server erfolgt (SSO oder Windows-Authentifizierung), mit welcher URL und welchem Port auf die dab Nexus-Anwendung zugegriffen wird und ob ein Zertifikat verwendet wird. Wie Sie die Configuration.json einrichten, erfahren Sie in diesem Artikel.
Der Windows-Dienst von dab Nexus wird gestartet. Im Anschluss erfolgt die Initialisierung von dab Nexus, wozu die Aktivierung der Lizenz und die Benutzeranlage gehören.
3.10 Einrichtung für Clientzugriff (durch dab gemeinsam mit Ihnen)
Wenn Endnutzer über Clients auf dab Nexus zugreifen sollen, sind folgende Voraussetzungen zu schaffen:
- Zugriff auf dab Nexus via Browser