ACMP Gateway über AESB installieren

Last modified by Sabrina V. on 2024/08/21 11:16

1. Das Gateway installieren

Version note  Version note:  

Beachten Sie, dass Sie das ACMP Gateway ab der AESB-Version 1.5 nutzen können.

Hinweis  Note:  

In der DMZ sollte der Host für das Gateway mindestens die Windows Version Server 2012 R2 bzw. Windows 8.1 haben.

Bevor Sie mit der Installation starten, sollten Sie für zwei Vorkonfigurationen sorgen:

1. Consolen-Port festlegen

Für zusätzliche Sicherheit des Gateways haben Sie die Möglichkeit, den Port der Console und den Port des Clients zu trennen.

Gehen Sie für diese Einstellung in die ACMP Console über System > Einstellungen > ACMP Server > Allgemein. Unter Port-Einstellungen können Sie den Port für die Console angeben. Starten Sie dann die Console neu, damit Sie bei der Anmeldung den neu gesetzten Port eintragen können. Setzen Sie anschließend noch ein Häkchen in der Checkbox ACMP Console-Verbindungen auf dem Standardport blockieren. Diese Checkbox ist erst dann aktiviert, wenn Sie einen Neustart und das Eintragen des neuen Ports durchgeführt haben.

Port-Einstellungen
Port-Einstellungen

2. Servereinträge in der Settings.ini vornehmen

Stellen Sie vor oder nach der Setup-Installation sicher, dass die ACMP Agenten so konfiguriert werden, dass sie sich zum Gateway verbinden. Grundsätzlich dient dazu eine Konfigurationsdatei, in der Sie die Adressen von einem oder mehreren ACMP Servern einpflegen können. Diese Konfigurationsdatei finden Sie im Installationsverzeichnis des ACMP Servers über ACMP Server > Client > Settings.ini.

a. Konfiguration mit einem einzelnen Servereintrag

Sie können einen einzelnen Server hier eintragen, müssen dann jedoch sicherstellen, dass:

  1. Der Servername intern zu einer lokalen IP-Adresse des ACMP Servers aufgelöst werden kann.
  2. Der Servername extern zu einer öffentlichen IP-Adresse des Gateways aufgelöst werden kann.

Hinweis  Note:  

Beachten Sie, dass in diesem Fall sowohl der ACMP Server als auch das ACMP Gateway später dieselbe Portbelegung nutzen müssen.

Beispiel für eine Settings.ini mit einem Servereintrag
Beispiel für eine Settings.ini mit einem Servereintrag

b. Konfiguration mit zwei Servereinträgen (einen für den ACMP Server/einen für das ACMP Gateway)

Alternativ zur ersten Version können Sie auch mehrere Einträge vornehmen: einen Eintrag für den ACMP Server und einen Eintrag für das ACMP Gateway. Als Servername kann auch direkt die jeweilige IP-Adresse eingetragen werden.

Beispiel für eine Settings.ini mit zwei Servereinträgen
Beispiel für eine Settings.ini mit zwei Servereinträgen

Hinweis  Note:  

Beachten Sie, dass die maximale Serveranzahl unter [Servers] max= mit den Servereinträgen übereinstimmt. Beachten Sie außerdem, dass die Zählung bei 0 beginnt. Es wird somit die Nummer des höchsten Servereintrags angegeben (s. Beispiel für eine Settings.ini mit zwei Servereinträgen).

Haben Sie diese beiden Vorkonfigurationen durchgeführt, können Sie mit der Gateway-Installation fortfahren.

Gehen Sie folgendermaßen vor:

1. Zertifikate in Ordner bereitstellen

Fügen Sie folgende Dateien aus dem ACMP Server Installationsverzeichnis in einen separaten Ordner ein:

ZertifikateDatei
ACMP CA Zertifikatca.crt
ACMP Gateway Zertifikatgateway.crt
ACMP Gateway Schlüsselgateway.pem
(optional) ACMP Gateway Zertifikatpasswortdateipassphrase.txt

Hinweis  Note:  

Die ACMP Gateway Zertifikatpasswortdatei muss eingetragen werden, wenn das Zertifikat ein Passwort voraussetzt. Wenn das Zertifikat dies nicht benötigt, dann muss kein Passwort eingetragen werden.

Den separaten Ordner müssen Sie auf einem System bereitstellen, auf das der AESB Microservice zugreifen kann.

2. Microservice-Paket importieren

Gehen Sie dann in der AESB Console auf das Plugin Microservices > Importieren. Laden Sie die Paketdatei AcmpGatewayMicroservice_6_2_0_44752.mspackmspack hoch und klicken Sie dann auf Importieren.

Hinweis  Note:  

Die Versionsnummer des Microservice-Pakets ist identisch zu Nummerierung der aktuellen ACMP Version. Die Versionsnummer des Microservices ist daher beispielhaft zu verstehen.

Microservice-Paket importieren
Microservice-Paket importieren

3. Microservice-Typ konfigurieren

Das importierte Microservice-Paket befindet sich im Arbeitsbereich unter Microservice-Pakete & -Vorlagen. Klicken Sie auf die Version 6.2.0.44752 und dann auf Hinzufügen in der Ribbonleiste.

Stelle des importierten Microservice-Pakets
Stelle des importierten Microservice-Pakets

4. Gateway Konfiguration anpassen

Im Bereich für die Gateway-Konfiguration tragen Sie nun die Pfade der in Schritt 1 gespeicherten Dateien ein.

Vorlage für das Gateway konfigurieren
Vorlage für das Gateway konfigurieren

Hinweis  Note:  

Beachten Sie, dass hier wirklich nur die Pfade der Dateien eingetragen werden müssen!

Hinweis  Note:  

Die ACMP Gateway Zertifikatpasswortdatei muss eingetragen werden, wenn das Zertifikat ein Passwort voraussetzt. Wenn das Zertifikat dies nicht benötigt, dann muss keine Datei angegeben werden.

Achten Sie auch darauf, dass die Ports korrekt eingetragen werden, sodass der ACMP Agent das Gateway und das Gateway den Server erreichen kann.

Hinweis  Note:  

Vergewissern Sie sich, dass Ihre Firewall diesen Port nicht blockiert!

Klicken Sie dann in der Ribbonleiste auf Speichern.

5. Microservice-Instanz erstellen

Hinweis  Note:  

Der ausgewählte Supervisor sollte für die Anbindung von Clients aus dem Internet auf einem Server in der DMZ laufen. Ggf. müssen Sie dort vorab einen Supervisor installieren und die Ports zur Steuerung via AESB in der Firewall freigeben!

Gehen Sie nun unter Microservice-Pakete auf die neu erstellte Konfigurations-Vorlage AcmpGatewayMicroservice. Ziehen Sie den Eintrag per Drag-and-Drop auf den zugehörigen Supervisor unter Supervisoren & Microservice-Instanzen.

Erstellte Instanz für das Gateway
Erstellte Instanz für das Gateway

Klicken Sie dann in der Ribbonleiste auf Starten. Das Gateway wird nun installiert und gestartet. Danach können sich die ACMP Agenten mit dem Gateway verbinden.

2. Das Gateway updaten

Nach der Installation eines ACMP Updates kann es vorkommen, dass eine Aktualisierung des Gateways erforderlich ist.

I.d.R. werden beim Updaten von ACMP alle Komponenten automatisch aktualisiert. Eine Ausnahme bildet u.a. das ACMP Gateway.

Daher muss bei einem ACMP Update das Gateway manuell aktualisiert werden.

Gehen Sie folgendermaßen vor:

1. Importieren Sie die neue Version des AESB Gateway Paketes im Microservice Workspace (vgl. Schritte 1-3 der Gateway-Installation).

2. Wählen Sie dann im Arbeitsbereich die Microservice-Vorlage des akutell installierten Gateways aus.

3. Klicken Sie in der Toolbar oder über das Kontextmenü die Aktion Microservice-Vorlage migieren an.

4. Es öffnet sich ein Dialog. Die Zielpaketversion sollte die Versionsnummer der neuen Microservice-Vorlage beinhalten. Aktivieren Sie außerdem die Checkbox Vorlagen-IDs beibehalten.

Vorlagen migrieren.png

Neue Vorlage migrieren

5. Klicken Sie dann auf Migrieren.

image (4).png

Neu erstellte Microservice-Instanz

Die neu erstellte ACMP Gateway Microservice-Instanz erscheint nun unter dem Bereich Supervisoren & Microservice-Instanzen.

© Aagon GmbH 2024
Besuchen Sie unsere neue Aagon-Community