Erstellen eines „ IBM App Connect Enterprise “-Integrationsserver-Images unter Docker auf IBM z/OS Container Extensions ( zCX ) unter Verwendung der mitgelieferten JCL

Erstellen Sie unter „ IBM z/OS® Container Extensions“ ( zCX ) mithilfe der bereitgestellten JCL-Datei ein Image für den „ IBM® App Connect Enterprise “-Integrationsserver unter „ Docker “.

Informationen zu dieser Task

Sie können mit der bereitgestellten JCL ein eigenes Docker-Image für den Integrationsserver erstellen. Das Image muss der zCX-Instanz zur Verfügung gestellt werden. Wenn Sie kein eigenes Image mit der bereitgestellten JCL erstellen möchten, können Sie ein beliebiges Image verwenden, das für die s390x-Architektur erstellt wurde. Die folgenden Alternativen sind verfügbar:

Sie können ein vorhandenes Image in einer Docker-Registry verwenden, mit der Ihre zCX-Instanz verbunden ist. Weitere Informationen finden Sie unter Docker -Registrys in der Onlinedokumentation zu IBM z/OS .
Sie können ein Docker-Image aus einem .tar -Archiv im Dateisystem z/OS UNIX System Services laden. Weitere Informationen finden Sie unter Docker -Image aus einer TAR-Datei im Dateisystem z/OS UNIX System Services laden.
Sie können Ihr eigenes Docker -Image erstellen, indem Sie Ihre eigenen Verarbeitungsmethoden verwenden, wie im Abschnitt Eigenes Docker -Image erstellenbeschrieben.

Wenn Sie das mitgelieferte JCL zum Erstellen Ihres „Integration Server Docker “-Images verwenden, ist die Funktion aktiviert, die anonyme Nutzungsdaten für Ihre „ IBM App Connect Enterprise “-Installation übermittelt. Wenn Sie es vorziehen, keine anonymen Nutzungsdaten bereitzustellen, müssen Sie Ihr eigenes Bild erstellen und diese Funktion deaktivieren. Sie können anonyme Nutzungsdaten deaktivieren, indem Sie den Parameter " disable-anonymous-usage-statistics für den Befehl " ace verwenden, wie im Befehl ace beschrieben, oder indem Sie den Befehl " ibmint modify installation --disable-anonymous-usage-statistics eingeben, wie im Befehl ibmint modify installation beschrieben.

Vorgehensweise

Gehen Sie wie folgt vor, um Ihr eigenes Docker-Image für den Integrationsserver mit der bereitgestellten JCL zu erstellen:

Laden Sie ein IBM App Connect Enterprise Linux® on IBM Z -Paket aus Passport Advantage / PassportAdvantage Express-Übersicht herunter und platzieren Sie es im UNIX System Services- Dateisystem auf z/OS.

Verwenden Sie zum Übertragen des Pakets nicht Secure Copy Protocol (SCP). SCP geht von Textdateien aus, und deshalb werden Binärdateien, die zwischen EBCDIC- und ASCII-Betriebssystemen hin- und her kopiert werden, während des Kopiervorgangs beschädigt.
Setzen Sie die Umgebungsvariablen in der Umgebungsdatei ' ENVFILE, wie in Umgebungsvariablen in STDENV und BIPENVS beschrieben.
- Stellen Sie die Umgebungsvariable ACE_OPERATION_MODE so ein, dass sie mit der von Ihnen erworbenen Lizenzvereinbarung übereinstimmt. Zum Beispiel:
```
ACE_OPERATION_MODE=advanced
```
  Weitere Informationen zu den Betriebsarten finden Sie unter Betriebsarten.
- Legen Sie die Umgebungsvariablen für den Zugriff auf „ zCX “ sowie die Umgebungsvariablen fest, die für die Erstellung eines „ IBM App Connect Enterprise Integration Server“-Images unter Docker auf IBM z/OS Container Extensions ( zCX ) erforderlich sind.
  
  Weitere Informationen zu den Zugriffsoptionen finden Sie unter Konfigurieren des SSH-Zugangs für IBM z/OS Container Extensions ( zCX ).
- Geben Sie die Position des heruntergeladenen Pakets Linux on IBM Z an. Zum Beispiel:
```
ACE_DOWNLOAD_PACKAGE_DIR=/u/aceadmin
```
- Geben Sie den Namen des heruntergeladenen Pakets Linux on IBM Z an. Zum Beispiel:
```
ACE_DOWNLOAD_PACKAGE_NAME=ace-12.0.1.0.tar.gz
```
- Wenn Sie eine BAR-Datei einschließen möchten, stellen Sie sie in das Dateisystem UNIX System Services unter z/OS und legen Sie die Umgebungsvariablen ACE_DOCKER_IMAGE_BAR_DIRund ACE_DOCKER_IMAGE_BAR_NAMEfest. Zum Beispiel:
```
ACE_DOCKER_IMAGE_BAR_DIR=/u/aceadmin/bars
```
```
ACE_DOCKER_IMAGE_BAR_NAME=zcx.bar
```
- Wenn Sie eine server.conf.yaml -Datei einschließen möchten, stellen Sie sie in das Dateisystem von UNIX System Services unter z/OS und legen Sie die Umgebungsvariablen ACE_DOCKER_IMAGE_YAML_DIRund ACE_DOCKER_IMAGE_YAML_NAMEfest. Zum Beispiel:
```
ACE_DOCKER_IMAGE_YAML_DIR=/u/aceadmin
```
```
ACE_DOCKER_IMAGE_YAML_NAME=server.conf.yaml
```
- Wenn Sie einen MQClient einbinden möchten, laden Sie die Deb-Installationspakete für „ IBM MQ “ unter v9.2 oder spätere Client-Versionen für „ IBM MQ “ auf z Systems unter Ubuntu von Fix Central herunter. Speichern Sie das heruntergeladene Image im Dateisystem von UNIX System Services unter z/OS. Legen Sie die Umgebungsvariablen ACE_DOCKER_IMAGE_MQCLIENT_TAR_DIR und ACE_DOCKER_IMAGE_MQCLIENT_TAR_NAME fest. Zum Beispiel:
```
ACE_DOCKER_IMAGE_MQCLIENT_TAR_DIR=/u/aceadmin/tars
```
```
ACE_DOCKER_IMAGE_MQCLIENT_TAR_NAME=9.2.0.0-IBM-MQC-UbuntuLinuxS390X.tar.gz
```
- Geben Sie den Namen des Images an, das erstellt werden soll, und geben Sie einen Tag an, indem Sie die Umgebungsvariablen ACE_IMAGE und ACE_TAG festlegen. Zum Beispiel:
```
ACE_IMAGE=ace_jenkins_2020-06-15_09:59:01.957539
```
```
ACE_TAG=testing
```
Wählen Sie zwischen zwei Methoden für den Zugriff auf den aktiven Integrationsserver. Welche Methode Sie wählen, hängt davon ab, welche Zugriffsrechte Sie den Benutzern gewähren möchten, die Befehle unter IBM App Connect Enterprise ausführen.
Weitere Informationen finden Sie unter Konfigurieren des Zugriffs auf Integrationsserver, die in IBM z/OS Container Extensions ( zCX ) laufen.
Passen Sie den JCL-Job BIPXBLD an, wie in Anpassen der JCL beschrieben.
Übergeben Sie den JCL-Job BIPXBLD , um das Image zu erstellen.

Nächste Schritte

Sie können dann entweder JCL- oder „ z/OS “-Konsolenbefehle verwenden, um Ihre Integrationsserver zu verwalten und „ IBM App Connect Enterprise “-Befehle auszuführen, wie in den Artikeln „Verwaltung von IBM App Connect Enterprise auf IBM z/OS -Container-Erweiterungen ( zCX ) mithilfe von JCL“ und „Verwaltung von IBM App Connect Enterprise auf IBM z/OS -Container-Erweiterungen ( zCX ) mithilfe von „ IBM z/OS “-Konsolenbefehlen“ beschrieben.