Direkt zu Hauptinhalt

Quickstart Guide On-Premise

Wichtig

Dieser 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 ausgeführt werden. Die Links zu den entsprechenden Artikeln finden Sie im Text unterhalb der Checkliste.

Checkliste​

Im Folgenden finden Sie eine Checkliste, in der Sie die einzelnen Schritte einfach abhaken können, sobald Sie, Ihr IT-Team und/oder SAP-Basis-Team diese durchgeführt haben. In der Spalte Verantwortung sehen Sie zudem, wer die jeweilige Aufgabe zu erledigen hat.

⬇️ Checkliste herunterladen (PDF)

Checkliste Quickstart Guide On-Premise
SchrittAufgabeVerantwortungErledigt?
1SAP-System
1.1RFC-Modul InstallationKunde (SAP-Basis)⬚
1.2SAP User BereitstellungKunde (SAP-Basis)⬚
1.3OPTIONAL – SNC-KonfigurationKunde (SAP-Basis)⬚
1.4OPTIONAL – Test RFC FunktionsmodulKunde (SAP-Basis)⬚
2SQL-Server
2.1BenutzerzuweisungKunde (IT-Team)⬚
2.2Anlegen der Application-DatenbankKunde (IT-Team)⬚
2.3Filegroup-GrößenbestimmungKunde (IT-Team)⬚
2.4OPTIONAL – Installation der Machine Learning Services für R-IntegrationKunde (IT-Team)⬚
3Application Server
3.1Serverbereitstellung und ZugriffKunde (IT-Team)⬚
3.2Netzwerkverbindungen (SAP-System & SQL-Server)Kunde (IT-Team)⬚
3.3OPTIONAL – Beschaffung von SSL-ZertifikatenKunde (IT-Team)⬚
3.4OPTIONAL – Konfiguration AD-Umgebung für Single-Sign-OnKunde (IT-Team)⬚
3.5OPTIONAL – Installation der SNC-LösungKunde (IT-Team)⬚
3.6Installation der RFC-BibliothekenKunde (IT-Team)⬚
3.7Bereitstellung der InstallationsdateienKunde⬚
3.8Ausführung des Installersdab & Kunde⬚
3.9Erstkonfigurationdab & Kunde⬚
3.10Einrichtung für Client-Zugriffdab & Kunde⬚

1. SAP-System (von Ihnen im Voraus bereitgestellt)​

Das SAP-System ist das erste wichtige Element und gleichzeitig 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 User Bereitstellung​

Es muss sichergestellt werden, dass die SAP-User die notwendigen Berechtigungen erhalten. Im diesem Artikel (Abschnitt Permissions) finden Sie die SAP-Berechtigungen, die Sie vergeben müssen. Die notwendigen Schritte zum Test des Funktionsmoduls /DABEXP/RFC_SAPCONNECTOR finden Sie zudem im Abschnitt Testing dieser Anleitung.

1.3 SNC-Konfiguration - OPTIONAL​

Wenn SNC für die Absicherung oder Authentifizierung der Verbindung verwendet werden soll, sind die entsprechenden Einstellungen am SAP-System vorzunehmen. Da es viele unterschiedliche SNC-Lösungen gibt, können wir an dieser Stelle keine allgemeingültigen Vorgaben machen und empfehlen, das Thema mit Ihrem SAP-Team zu besprechen. Weitere Informationen finden Sie in der SAP Help Portal: Transport Layer Security auf SAP NetWeaver AS für ABAP | SAP Help Portal

1.4 RFC-Funktionsmodul Tester - OPTIONAL​

Sie können den dab FunctionModuleTester nutzen, um sowohl die Verbindung des RFC-Moduls als auch die Funktionalität des installierten RFC-Funktionsmoduls zu testen. Befolgen Sie dazu diesen Artikel.


2. SQL-Server (von Ihnen im Voraus bereitgestellt) – nur für Analytic Tasks oder Extraktion nach SQL erforderlich​

Der SQL-Server erfüllt zwei verschiedene Aufgaben:

  • Application-Datenbank: In dieser Datenbank werden alle Benutzereinstellungen gespeichert, die für einen reibungslosen Betrieb notwendig sind
  • Verarbeitungsdatenbank(en): Diese Datenbanken enthalten später Ihre extrahierten und verarbeiteten Daten

2.1 Benutzerzuweisung​

dab Nexus kann sich entweder per Windows-Authentifizierung oder per SQL-Server-Authentifizierung am Datenbankserver anmelden. Der folgende Entscheidungsregel kann Ihnen dabei helfen:

  • dab Nexus und SQL-Server befinden sich auf demselben Server: Windows Authentifizierung empfohlen
  • dab Nexus und SQL-Server liegen auf unterschiedlichen Servern: SQL-Server Authentifizierung empfohlen

Weitere Informationen dazu finden Sie in diesem Artikel.

2.2 Anlegen der Application-Datenbank​

Diese Datenbank dient zur Speicherung der dab Nexus Einstellungen. Wir empfehlen, dab Nexus die Rolle db_owner zuzuweisen. Wenn dab Nexus automatisch Datenbanken für extrahierte und analysierte Daten anlegen soll, muss dab Nexus auf Serverebene auch die Rolle dbcreator erhalten.

Zusätzlich können dab Nexus auf Datenbankebene folgende Rollen zugewiesen werden:

  • db_datareader
  • db_datawriter
  • db_ddladmin

2.3 Filegroup-Größenbestimmung​

Für die Application-Datenbank benötigen wir nur etwa 5–10 GB, die Größe der Verarbeitungsdatenbank hängt hingegen stark von Ihrer Nutzung von dab Nexus ab. Daher können wir hierzu keine allgemeingültige Angabe machen, empfehlen jedoch, zunächst mit 500 GB für die PRIMARY FILEGROUP Ihrer Verarbeitungsdatenbank zu starten und nach einigen Analyse-Durchläufen den Speicherbedarf neu einzuschätzen.

Hinweis

Besprechen Sie im Vorfeld mit Ihrem IT-Team, ob kurzfristig eine Anpassung des Speichers am SQL-Server möglich ist, um Verzögerungen in Test- und Implementierungsphase zu minimieren.

Außerdem sollten Sie den Speicher folgender Elemente auf mindestens ca. 30 % der Größe Ihrer PRIMARY FILEGROUP erhöhen:

Hinweis

dab Nexus ist in diesem Fall eine On-Premise-Software, die auf Ihrer eigenen IT-Infrastruktur betrieben und verwaltet wird. Klären Sie daher vorab mit Ihrer IT-Abteilung etwaige Backup- und Neustartstrategien, falls es diesbezüglich Vorgaben in Ihrem Unternehmen gibt.

2.4 Installation der Machine Learning Servers für R-Integration - OPTIONAL​

Wenn Sie dab AnalyticSuite für SQL gemeinsam mit Machine Learning-Erweiterungen nutzen möchten, müssen auf dem SQL-Server die entsprechenden Machine Learning Services installiert werden. Weitere Anweisungen finden Sie hier.


3. Application Server (von Ihnen im Voraus bereitgestellt)​

Wichtig

Die Schritte 3.1 bis 3.7 sind von Ihnen vorzubereiten. Die Schritte 3.8 bis 3.10 werden von dab gemeinsam mit Ihnen durchgeführt.

In diesem Abschnitt geht es um die Vorbereitung des Application Servers, auf dem dab Nexus ausgeführt wird.

3.1 Serverbereitstellung und Zugriff​

Wichtig

Sie müssen den Server im Voraus bereitstellen. Für die Installation von dab Nexus auf dem Server benötigen Sie Administratorberechtigungen.

Der Server, auf dem dab Nexus installiert werden soll, muss bestimmte Anforderungen erfüllen. Die detaillierten Systemvoraussetzungen finden Sie hier. Neben der grundlegenden Konnektivität achten Sie bitte darauf, dass die Firewall-Konfiguration weder die Verbindung zwischen dab Nexus und dem Zielsystem blockiert noch die Datenverarbeitung beeinflusst. Anweisungen 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 benötigten Daten zu extrahieren. Ihr IT-Team muss sicherstellen, dass das SAP-System vom Application Server aus erreichbar ist.

Erforderliche Netzwerkports (TCP):

  • RFC Application Server: 3300 – 3399
  • RFC Message Server: 3600 – 3699
  • RFC SNC: 4800 – 4899
  • SAProuter: 3299

Weitere Informationen dazu finden Sie in der SAP Help Portal: TCP/IP Ports aller SAP-Produkte | SAP Help Portal

b. SQL-Server Analog zum SAP-System, muss auch der SQL-Server vom Application Server aus erreichbar sein, um die extrahierten Daten analysieren und in Datenbanken speichern zu können. Ihr IT-Team muss sicherstellen, dass die Verbindung zum SQL-Server möglich und das Anlegen von Datenbanken erlaubt ist.

Notwendige Netzwerkports:

  • Standardinstanz: TCP 1433
  • Named Instances oder SQL-Server Browser Service: UDP 1434

Die Portnummern können abweichen. Klären Sie dies bitte mit Ihrem IT-Team. Weitere Informationen finden Sie in der Microsoft Dokumentation: Windows-Firewall konfigurieren für SQL Server-Zugriff – SQL Server | Microsoft Learn

3.3 Beschaffung von SSL-Zertifikaten - OPTIONAL​

Dieser Artikel gibt Ihnen alle nötigen Informationen zur Installation eines SSL-Zertifikats auf Ihrem Server. Bei der Ausstellung von SSL-Zertifikaten können wir keine weitere Unterstützung bieten, da dies stark von Ihren IT-Richtlinien und Prozessen abhängt.

3.4 Konfiguration der AD-Umgebung für Single Sign-On - OPTIONAL​

Falls Sie sich bei dab Nexus per Single Sign-On (SSO) und nicht mit E-Mail-Adresse und Passwort anmelden wollen, können Sie dab Nexus mit einer bestehenden SSO-Lösung integrieren. Wir unterstützen Microsoft Entra ID (vormals Azure Active Directory) und Active Directory Federation Services. Wie das funktioniert, erläutern wir in dieser Anleitung.

3.5 Installation der SAP SNC-Lösung - OPTIONAL​

Wenn Sie die Verbindung zu SAP SNC per RFC benötigen, stellen Sie sicher, dass die SNC-Lösung im Vorfeld installiert und entsprechend konfiguriert wurde. Da diese Lösungen sehr individuell sind, können wir keine allgemeinen Anweisungen geben. Wir möchten Ihnen allerdings zwei häufig genutzte SNC-Lösungen empfehlen:

Da die Einrichtung einer SNC-Lösung je nach Systemlandschaft komplex sein kann, empfehlen wir eine enge Abstimmung zwischen SAP-Basis und IT.

3.6 Installation der RFC-Bibliotheken​

Wichtig

Obwohl dab Nexus librfc32 bis Version 1.17.262 unterstützt (SAP hat diese RFC-Implementierung 2016 abgekündigt und sie erhält keine Updates mehr), empfehlen wir die Installation der 64-bit-Version für höhere Stabilität. Diese Unterstützung endet mit dem Update auf eine 1.18.x-Version von dab Nexus!

Die SAP RFC-Bibliotheken müssen auf dem Application Server installiert werden, damit eine Verbindung zum SAP-System erfolgreich aufgebaut werden kann.

Sie haben zwei Möglichkeiten für die Installation:

  • Installation über SAP GUI: Wenn Sie das SAP GUI selbst oder Ihr IT-Team installieren und dabei die Funktion „Unicode RFC Libraries“ auswählen, werden die zugehörigen Bibliotheken automatisch korrekt installiert.
  • Manuelle Installation: Sie können die relevanten Bibliotheken auch im SAP Software Center herunterladen und manuell installieren. Die entsprechenden Anweisungen finden Sie hier.

3.7 Bereitstellung der Installationsdateien​

Hinweis

Bitte stellen Sie sicher, dass das Installationspaket (als .zip oder bereits entpackt) vor der Installation auf dem Application Server verfügbar ist. Sie können dieses im Kunden-Portal erhalten.

3.8 Ausführung des Installers (durch dab mit Ihnen)​

Hinweis

Die Installation kann zwar eigenständig durchgeführt werden, wir empfehlen jedoch aus Gründen der Fehlervermeidung und schnellen Rückfrage die gemeinsame Installation mit uns.

Wichtig

Die Ausführung des dab Nexus-Setups erfordert Administratorrechte auf dem Application Server. Wenn während der Installation eine Anwendung-URL mit HTTPS gewählt wird, muss zuvor ein SSL-Zertifikat bereitgestellt werden. Andernfalls kann der Windows-Dienst später nicht gestartet werden und dab Nexus ist nicht erreichbar.

Wie die Installation genau abläuft, erfahren Sie in diesem Artikel – Abschnitt Manual Installation of the SAP NetWeaver RFC.

3.9 Erstkonfiguration (durch dab mit Ihnen)​

Hier wird die Configuration.json angepasst. Das heißt, es wird definiert, wie auf den SQL-Server zugegriffen wird (SSO oder Windows-Authentifizierung), welche URL und welcher Port für den Zugriff auf die dab Nexus Anwendung verwendet werden und ob ein Zertifikat genutzt wird. Wie Sie die Configuration.json konfigurieren, erfahren Sie in diesem Artikel.

Der Windows-Dienst für dab Nexus wird anschließend gestartet. Danach folgt die Ersteinrichtung von dab Nexus, einschließlich Lizenzaktivierung und Nutzeranlage.

3.10 Einrichtung für Client-Zugriff (durch dab mit Ihnen)​

Wenn Endanwender auf dab Nexus via Clients zugreifen sollen, sind folgende Vorkehrungen zu treffen:

  • Zugriff auf dab Nexus über Browser