Quickstart Guide Managed App
Dieser Quickstart Guide enthält alle notwendigen Vorarbeiten, um die Installation von dab Nexus so reibungslos wie möglich zu gestalten. Sie, Ihr SAP Basis-Team und Ihr IT-Team sind verantwortlich dafür, alle Schritte in diesem Guide durchzuführen. dab kann auf vorherige Absprache Unterstützung bei der Ersteinrichtung bieten. Aktualisierungen, erneute Bereitstellungen, Migrationen, Umzüge und andere Änderungen im Umfeld oder in den Konfigurationen müssen von Ihrer Organisation geplant und durchgeführt werden. Die Links zu den jeweiligen Artikeln finden Sie unterhalb der Checkliste im Text.
Checkliste
Nachfolgend finden Sie eine Checkliste, in der Sie die einzelnen Schritte einfach abhaken können, sobald sie von Ihnen, Ihrem IT-Team und/oder SAP Basis-Team erledigt wurden. In der Spalte Verantwortung können Sie zudem erkennen, wer für die Ausführung der jeweiligen Aufgabe zuständig ist.
⬇️ Checkliste herunterladen (PDF)
Checkliste Quickstart Guide Managed App
| Schritt | Aufgabe | Verantwortung | Erledigt? |
|---|---|---|---|
| 1 | SAP-System | ||
| 1.1 | RFC-Modul Installation | Kunde (SAP-Basis) | ⬚ |
| 1.2 | SAP-User Bereitstellung | Kunde (SAP-Basis) | ⬚ |
| 2 | Konfiguration der Managed App | ||
| 2.1 | Managed App im Azure Marketplace kaufen | Kunde (IT-Team) | ⬚ |
| 2.2 | Bereitstellung der RFC Libraries | Kunde (IT-Team) | ⬚ |
| 2.3 | Netzwerkverbindungen | Kunde (IT-Team) | ⬚ |
| 2.4 | Verbindung zur Processing Database herstellen | Kunde (IT-Team) | ⬚ |
| 2.5 | Zugriff auf dab Nexus Managed App | Kunde (IT-Team) | ⬚ |
| 2.6 | Resource-ID der Managed App finden | Kunde (IT-Team) | ⬚ |
| 2.7 | OPTIONAL - Fabric Connections einrichten | Kunde (IT-Team) | ⬚ |
| 3 | Erstkonfiguration von dab Nexus | ||
| 3.1 | Erste Einstellungen | Kunde (IT-Team) | ⬚ |
| 4 | Administration der Managed App | ||
| 4.1 | Update über Azure CLI | Kunde (IT-Team) | ⬚ |
1. SAP System (vorab von Ihnen bereitgestellt)
Das SAP-System bildet den ersten wichtigen Bestandteil 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 Installation des RFC-Moduls
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 sein, dass die SAP-User über die notwendigen Berechtigungen verfügen. Im diesem Artikel (Abschnitt Berechtigungen) finden Sie die SAP-Berechtigungen, die Sie zuweisen müssen. Die notwendigen Schritte zum Testen des Funktionsmoduls /DABEXP/RFC_SAPCONNECTOR finden Sie zusätzlich im Abschnitt Testing dieses Guides.
2. Konfiguration der Managed App (vorab von Ihnen bereitgestellt)
2.1 Managed App im Azure Marketplace kaufen
Eventuell ist es erforderlich, dass Sie uns Ihre Azure Subscription ID vorab mitteilen, damit der Plan sichtbar wird. Um Managed App im Azure Marketplace zu erwerben, benötigen Sie einen Microsoft-Account mit Entra ID und die Berechtigung zum Kauf. Sie müssen in der Ziel-Subscription die Rolle Besitzer mit der Möglichkeit zur dauerhaften Rollenzuweisung innehaben.
Die Lizenzierung erfolgt separat.
Öffnen Sie den Azure Marketplace, suchen Sie nach dab und öffnen Sie das Angebot dab Nexus. Wählen Sie einen der verfügbaren Pläne und klicken Sie auf Erstellen.
Grundlagen
- Subscription (Pflicht): Wählen Sie eine Subscription
- Resource Group (Pflicht): Wählen Sie eine bestehende Resource Group oder erstellen Sie eine neue
- Region (Pflicht): Wählen Sie die Region, in der die Ressourcen bereitgestellt werden sollen
- Application Name (Pflicht): Geben Sie einen Namen ein (ohne Leerzeichen, Zahlen oder Sonderzeichen)
- Managed Resource Group (Pflicht): Geben Sie den Namen für die neue Managed Resource Group ein
SKU
- App Service SKU: Wählen Sie eine der verfügbaren Einstellungen aus
- Storage Account SKU: Wählen Sie eine der verfügbaren Einstellungen aus
- Standard LRS = Standard Lokal redundanter Storage
- Standard ZRS = Standard Zonenredundanter Storage
- Standard GRS = Standard Geo-replizierter Storage
Netzwerk
Private Link Auswahl - Aktivieren Sie Use Private Link während der Bereitstellung. Alle abhängigen Services (Key Vault, SQL Server, Storage Account) sind dann ausschließlich über Private Endpoints erreichbar.
- Virtuelles Netzwerk – Wählen Sie ein bestehendes VNet oder lassen Sie bei der Bereitstellung ein neues VNet anlegen.
- Integration Subnetz – Wird vom Managed App-Runtime verwendet. Muss ein dediziertes Subnetz sein.
- Private Endpoint Subnetz – Wird ausschließlich für Private Endpoints verwendet.
- Das Erstellen eines neuen Subnetzes innerhalb eines bestehenden VNets ist nicht unterstützt; Subnetze müssen bereits existieren oder vollständig während der Bereitstellung erstellt werden.
Verschlüsselungsschlüssel
- dab Nexus schützt sensible Daten, darunter auch SAP-Zugangsdaten, durch einen in Azure Key Vault hinterlegten Verschlüsselungsschlüssel. Erzeugen Sie diesen Schlüssel durch Ausführen des angegebenen Befehls.
- Nach Abschluss des Befehls wird der Schlüssel automatisch in die Zwischenablage kopiert. Fügen Sie ihn in die vorgesehenen Verschlüsselungsschlüsselfelder ein.
Tags - OPTIONAL
Sie können hier Namens-/Wert-Paare (Tags) als zusätzliche Information hinterlegen, was die Kategorisierung von Ressourcen erleichtern und bei der Abrechnung unterstützen kann.
Prüfung und Erstellen
Am Ende werden alle gerade konfigurierten Informationen noch einmal angezeigt.
Im Abschnitt Co-Admin Access Permission muss die Box I agree to the terms and conditions above aktiviert werden.
Wenn alles korrekt ist, klicken Sie auf Erstellen.
Die Managed App wird nun bereitgestellt. Die Bereitstellung kann ein paar Minuten dauern.
2.2 Bereitstellung der RFC Libraries
Für den Download der RFC Libraries benötigen Sie Zugriff auf das SAP Softwarecenter.
Sie können die RFC Libraries über diesen Link zum SAP Softwarecenter herunterladen. Alternativ öffnen Sie das SAP Softwarecenter und suchen nach SAP NW RFC SDK 7.50 und wählen die Architektur x86_64 auf Linux. Beachten Sie, dass andere Architekturen nicht unterstützt werden.
Die SAP RFC Libraries müssen so gespeichert werden, dass Sie erfolgreich eine Verbindung zur SAP System aufbauen können. Wählen Sie im Azure Portal das Storage Account in der zuvor gewählten Managed Resource Group aus.
Das Storage Account erlaubt standardmäßig keinen externen Zugriff. Dies kann in den Netzwerkeinstellungen geändert werden.
In manchen Fällen muss Public Network Access aktiviert werden, um Dateien hochladen zu können. Gehen Sie zu Ihrem Storage Account, wählen Sie Sicherheit + Netzwerk > Netzwerk und klicken Sie im Abschnitt 'Public network access' auf Verwalten. Um den Dateiupload zu ermöglichen, klicken Sie auf Ihre Client IPv4-Adresse hinzufügen. Speichern Sie Ihre Änderungen.
Zum Hochladen der DLLs ins Storage Account gehen Sie wie folgt vor:
- Öffnen Sie das Storage Account in der Managed App Resource Group zum Hochladen der Dateien
- Navigieren Sie zu Data storage > File shares > share-dabnexus-home
- Öffnen Sie den Libraries-Ordner (erstellen Sie diesen falls nicht vorhanden – die Groß-/Kleinschreibung ist relevant)
- Durchsuchen Sie die Dateien
- Klicken Sie anschließend auf Upload
Folgende Dateien werden benötigt – sie finden sich im heruntergeladenen Paket im Unterordner nwrfcsdk > lib:
- libicudata.so.50
- libicui18n.so.50
- libicuuc.so.50
- libsapnwrfc.so
- libsapucum.so
2.3 Netzwerkverbindungen
Damit der dab Nexus Managed App eine Verbindung zu Ihrem SAP System herstellen kann, muss das Netzwerk entsprechend konfiguriert werden. Es gibt unterschiedliche Möglichkeiten, die in diesem Artikel ausführlich beschrieben sind. Es kann erforderlich sein, die Option Outbound internet traffic bei der Virtual Network Integration zu aktivieren, um Ihr SAP System über die IP zu erreichen. Dies hängt stark von Ihrer SAP-Landschaft ab.
dab Nexus wird standardmäßig ohne eine Processing Database ausgeliefert, die extrahierte und verarbeitete Daten speichert. Sie können manuell eine der folgenden Lösungen in Azure bereitstellen:
Die zu wählenden SKUs hängen stark vom Anwendungsfall und Datenvolumen in Ihrer SAP System ab. Stellen Sie sicher, dass auf die SQL-Datenbank über das Netzwerk via Managed App zugegriffen werden kann: Sie müssen ggf. die Netzwerkadresse der Managed App in der Azure Firewall eintragen. Danach können Sie SQL Server Authentifizierung aktivieren und die Datenbank wie gewohnt in Nexus integrieren. Mehr dazu finden Sie in diesem Artikel.
2.4 Zugriff auf dab Nexus - Managed App
Um dab Nexus aufzurufen, öffnen Sie das App Service in der Managed Resource Group und klicken anschließend oben auf Browse. Die Erstkonfiguration sollte sich dann im Browser öffnen.
2.5 Resource-ID der Managed App finden
ResourceID ermitteln:
- Melden Sie sich im Azure Portal an
- Öffnen Sie die Managed Resource Group Ihrer dab Nexus Managed App
- Öffnen Sie das App Service
- Wählen Sie Einstellungen > Umgebungsvariablen links
- DABNEXUS_AzureManagedApplication_ResourceId > Wert anzeigen
2.6 Fabric Connections einrichten - OPTIONAL
Bitte beachten Sie, dass die Fabric Connections separat lizenziert werden müssen!
Für die Anbindung von Microsoft Fabric in dab Nexus sind verschiedene Vorbereitungen erforderlich. Dieser Artikel beschreibt alle notwendigen Schritte in Azure. Und dieser Artikel zeigt Ihnen die Einrichtung der Connections in dab Nexus.
3. Erstkonfiguration von dab Nexus (durch Sie)
3.1 Erste Einstellungen
Sie sind verantwortlich für die Durchführung dieser Erstkonfiguration. dab kann nach vorheriger Absprache begleiten.
Wenn Sie dab Nexus zum ersten Mal öffnen, müssen Sie einen Account anlegen. Geben Sie hierzu eine E-Mail-Adresse und ein Passwort ein. Dieser User wird automatisch als Administrator in dab Nexus angelegt und kann weitere User berechtigen. Weitere Informationen zur Erstellung neuer User finden Sie in diesem Artikel. Die übrigen Informationen, z.B. wie Sie Ihr SAP System anbinden, eine Verbindung zur SQL Server aufbauen und Ihre ersten Daten extrahieren, finden Sie in Initial Setup für dab Nexus Managed App.
4. Administration der Managed App (durch Sie)
4.1 Update über Azure CLI
Ihr IT-Team ist verantwortlich für die Administration und das Update der Managed App. Ein Update der Managed App muss über die Azure CLI durchgeführt werden. Das kann entweder über das Azure Portal (empfohlen) oder über eine lokal installierte Azure CLI erfolgen. Alle relevanten Informationen finden Sie in dieser Dokumentation.