Sie können mit WebSphere Developer Tools eine Referenz auf einen Liberty-Server erstellen, der in einem Docker-Container auf einem fernen Host ausgeführt wird. Sie können diese Referenz zum Bearbeiten Ihrer Serveranforderungen über die Workbench verwenden.
Informationen zu diesem Vorgang
Sie können WebSphere Application Server Liberty installieren und Add-ons von der Download-Site der WASdev-Community in Liberty Repository herunterladen. Nach der Installation von
Liberty können Sie Ihren Docker-Container auswählen. Anschließend können Sie die Sicherheitsberechtigungsnachweise
des Liberty-Servers für den Zugriff auf Ihren fernen Liberty-Server in Ihrem Docker-Container eingeben. Wenn
Sie die Sicherheitsberechtigungsnachweise des Liberty-Servers nicht haben, kann das Tool sie erstellen.
Wenn ein Docker-Befehl das zulässige Zeitlimit überschreitet, während Sie diese Schritte ausführen, können Sie dieses Problem umgehen. Setzen
Sie die Systemeigenschaft com.ibm.ws.st.DockerCommandTimeoutInSeconds auf eine Zeit in Sekunden. Standardmäßig ist diese
Eigenschaft auf 10 gesetzt.
Wichtig: Die Option Server beim nächsten Start bereinigen kann für Liberty-Server, die in einem Docker-Container
ausgeführt werden, nicht ausgewählt werden.
- Öffnen Sie in der Workbench die Ansicht Server, indem Sie auf das Register Server klicken.
Tipp: Wenn die Ansicht Server nicht sichtbar ist, wählen Sie
aus und geben Sie
Server als Filtertext ein.
Wählen Sie anschließend den Eintrag Server aus.
- Klicken Sie mit der rechten Maustaste anklicken in der Serversicht und wählen Sie aus.
- Klicken Sie auf , um Ihren Servertyp auszuwählen.
- Geben Sie den Namen des fernen Hosts im Feld Hostname des Servers ein.
- Klicken Sie auf Weiter.
Anmerkung: Stellen Sie sicher, dass für die Liberty-Laufzeitumgebung dieselben Featuregruppen wie im ausgewählten Liberty-Docker-Image installiert sind. Stellen Sie außerdem sicher, dass sie so konfiguriert wurden, dass sie dieselbe JRE-Version (Java Runtime Environment) verwenden. Die Liberty-Laufzeitumgebung wird in der Entwicklungsumgebung verwendet. Eine Abweichung zwischen der lokalen Systemlaufzeit und der im Liberty-Docker-Image verwendeten JRE kann zu Problemen führen, die von Konfigurationsfehlern bis zu Anwendungsveröffentlichungsproblemen reichen.
- Wenn Sie von den Tools aufgefordert werden, WebSphere Application Server Liberty zu installieren, weil WebSphere Application Server Liberty nicht installiert ist oder weil Sie das Installationsverzeichnis eingeben müssen, führen Sie eine der folgenden Optionen aus.
Überspringen Sie diesen Schritt andernfalls.
Liberty muss installiert sein, damit Sie eine Workbenchreferenz auf einen Liberty-Server in einem Docker-Container auf einem fernen Host
erstellen können.
Wenn Liberty bereits installiert ist, führen Sie die folgenden Schritte aus, um das Installationsverzeichnis auszuwählen:
- Wählen Sie Vorhandene Installation auswählen aus.
- Geben Sie im Feld Pfad das Verzeichnis ein bzw. navigieren Sie zu dem Verzeichnis, in dem Sie
WebSphere Application Server installiert haben.
- Klicken Sie auf der Seite Liberty-Laufzeitumgebung auf Weiter.
Die Anwendungsserverumgebung ist ausgewählt. Überspringen Sie die restlichen Unterschritte dieses Schritts.
Wenn Sie Liberty über eine Archivdatei installieren möchten, die Sie zuvor heruntergeladen haben, führen Sie die folgenden Schritte aus:
- Wählen Sie den Eintrag Aus einem Archiv oder Repository installieren aus und klicken Sie auf Weiter.
- Geben Sie im Feld Ziel das Verzeichnis ein bzw. navigieren Sie zu dem Verzeichnis, in dem Sie die Liberty-Laufzeitumgebung installieren möchten.
Wenn Sie einen nicht vorhandenen Pfad eingeben, wird am Ende der Prozedur automatisch ein Ordner für diesen Pfad erstellt, sobald Sie auf Fertigstellen klicken.
- Wählen Sie den Eintrag Neue Laufzeitumgebung aus einem Archiv installieren aus.
- Geben Sie im Feld Pfad die Archivdatei ein oder suchen Sie im lokalen Dateisystem nach der Datei.
Klicken Sie anschließend auf Weiter.
- Klicken Sie auf der Seite Add-ons installieren auf Installieren oder Installation anstehend, um die Add-on-Archivdateien auszuwählen, die
Sie in der Liberty-Laufzeitumgebung installieren möchten.
Sie können eine Add-on-Archivdatei aus Ihrem lokalen Dateisystem installieren oder herunterladen oder eine Kombination
dieser beiden Vorgehensweisen verwenden, wenn Sie mehrere Add-on-Archivdateien installieren.
Wenn die Workbench mit dem Internet verbunden ist,
wird die Seite Add-ons installieren mit Add-on-Archivdateien gefüllt, die
auf der
Download-Site der WASdev-Community
zum Download verfügbar sind.
Diese Download-Site enthält Add-ons, die Sie in
Liberty Repository auswählen können, wie z. B. Laufzeitfeatures, Beispiele oder
Open-Source-Integration.
Wenn Sie Add-on-Archivdateien aus dem lokalen Dateisystem installieren möchten, führen Sie die folgenden Schritte aus:
- Klicken Sie auf Archiv hinzufügen.
- Geben Sie im Feld
Add-on-Archiv die Add-on-Archivdatei im lokalen Dateisystem ein bzw. navigieren Sie zu dieser Datei.
- Klicken Sie auf OK.
Wenn aus Ihrem lokalen Dateisystem weitere Add-on-Archive installiert werden sollen, wiederholen Sie diese Prozedur
sooft wie erforderlich.
Wenn Sie Add-on-Dateien aus einem angepasten Repository installieren möchten, führen Sie die folgenden Schritte aus:
- Klicken Sie zum Hinzufügen des Repositorys auf Repositorys konfigurieren.
- Klicken Sie auf Neu....
Die Dateien werden dann der Liste der Add-on-Dateien hinzugefügt.
Nachdem Sie
die gewünschte Auswahl auf der Seite Add-ons installieren vorgenommen haben, klicken Sie auf
Weiter.
- Wählen Sie auf der Seite Lizenz akzeptieren
den Eintrag Ich akzeptiere alle Bedingungen der
Lizenzvereinbarungen aus und klicken Sie auf Weiter.
Wenn Sie die kostenfreie Entwickleredition für Liberty herunterladen und installieren möchten, führen Sie die folgenden Schritte aus:
- Wählen Sie den Eintrag Aus einem Archiv oder Repository installieren aus und klicken Sie auf Weiter.
- Geben Sie im Feld Ziel das Verzeichnis ein bzw. navigieren Sie zu dem Verzeichnis, in dem Sie die Liberty-Laufzeitumgebung installieren möchten.
Wenn Sie einen nicht vorhandenen Pfad eingeben, wird am Ende der Hauptprozedur automatisch ein Ordner für diesen Pfad erstellt, sobald Sie auf Fertigstellen klicken.
- Wählen Sie Neue Laufzeitumgebung von ibm.com herunterladen und installieren und
eine Laufzeitumgebungsversion aus und klicken Sie auf Weiter.
- Klicken Sie auf der Seite Add-ons installieren auf Installieren oder Installation anstehend, um die Add-on-Archivdateien auszuwählen, die
Sie in der Liberty-Laufzeitumgebung installieren möchten.
Sie können Add-on-Archivdateien mit einer der folgenden Methoden installieren:
- Aus dem lokalen Dateisystem
- Herunterladen der Dateien
- Kombination der oben genannten beiden Methoden, wenn mehrere Add-on-Archivdateien installiert werden
Wenn die Workbench mit dem Internet verbunden ist,
wird die Seite
Add-ons installieren mit Add-on-Archivdateien gefüllt, die
auf der
Download-Site der WASdev-Community
zum Download verfügbar sind.
Diese Download-Site enthält Add-ons, die Sie in
Liberty Repository auswählen können, wie z. B. Laufzeitfeatures, Beispiele oder
Open-Source-Integration.
Wenn Sie Add-on-Archivdateien aus dem lokalen Dateisystem installieren möchten, führen Sie die folgenden Schritte aus:
- Klicken Sie auf Archiv hinzufügen.
- Geben Sie im Feld
Add-on-Archiv die Add-on-Archivdatei im lokalen Dateisystem ein bzw. navigieren Sie zu dieser Datei.
- Klicken Sie auf OK.
Wenn aus Ihrem lokalen Dateisystem weitere Add-on-Archive installiert werden sollen, wiederholen Sie diese Prozedur
sooft wie erforderlich.
Wenn Sie Add-on-Dateien aus einem angepasten Repository installieren möchten, führen Sie die folgenden Schritte aus:
- Klicken Sie zum Hinzufügen des Repositorys auf Repositorys konfigurieren.
- Klicken Sie auf Neu....
Die Dateien werden dann der Liste der Add-on-Dateien hinzugefügt.
Nachdem Sie
die gewünschte Auswahl auf der Seite Add-ons installieren vorgenommen haben, klicken Sie auf
Weiter.
- Wählen Sie auf der Seite Lizenz akzeptieren
den Eintrag Ich akzeptiere alle Bedingungen der
Lizenzvereinbarungen aus und klicken Sie auf Weiter.
- Wählen Sie auf der Seite Einstellungen des fernen Servers den Typ Server in einem Docker-Container aus.
- Wählen Sie das Betriebssystem für Ihren fernen Server aus.
Einschränkung: Die Tools unterstützen keine Betriebssystemauthentifizierung für Windows-Betriebssysteme.
- Wählen Sie eine Methode für den Zugriff auf den fernen Host aus, geben Sie die Anmeldeinformationen ein und klicken Sie
auf Weiter.
- Wählen Sie auf der Seite Neuer Server in einem Docker-Container
Ihren Docker-Container im Menü Containername aus.
Tipp: Wenn Sie Ihren Docker-Container nicht im Menü Containername
sehen, klicken Sie auf Aktualisieren, um die Liste zu aktualisieren.
- Geben Sie die Sicherheitsberechtigungsnachweise für den Liberty-Server ein.
Ihre Werte für die Felder
Benutzername und
Kennwort müssen einem Benutzer entsprechen,
der in einer Benutzerregistry mit der Administratorrolle definiert ist. Wenn die Tools keine Basisbenutzerregistry finden können, die den angegebenen Benutzer definiert,
zeigen die Tools das Fenster
Security Verification an. Wenn die Tools das Fenster
Security
Verification anzeigen, führen Sie einen der folgenden Schritte aus:
- Wählen Sie Erstellen aus, um eine Basisbenutzerregistry hinzuzufügen, die einen Benutzer mit Ihren Werten und der Administratorrolle definiert.
- Wählen Sie Fortfahren aus, um forzufahren, wenn der Benutzer in einem anderen Typ von Benutzerregistry definiert ist.
- Wählen Sie Abbrechen aus, um Änderungen an den eingegebenen Werten für Benutzername und
Kennwort vorzunehmen.
- Tragen Sie im Feld Sicherer Port den HTTPS-Port ein, der in der Serverkonfiguration angegeben ist.
Tipp: Die Standard-HTTPS-Portnummer ist 9443.
- Klicken Sie auf Fertigstellen.
Nächste Schritte
Einschränkung: Für ferne Liberty-Docker-Server unterstützen die Tools die Serverdienstprogramme nicht.
- Sie können die Serverkonfiguration bearbeiten. Weitere Informationen finden Sie
unter Liberty-Konfiguration mit Entwicklertools bearbeiten.
Einschränkung: Für ferne Server unterstützen die Tools die Angabe von Include-Dateien unter Verwendung absoluter Pfade in der Serverkonfiguration nicht.
Zur Umgehung dieses Problems geben Sie Include-Pfade mit den vordefinierten Servervariablen, wie z. B. server.config.dir und
shared.config.dir, anstatt mit absoluten Pfaden an.
- Klicken Sie zum Starten bzw. Stoppen eines Servers oder zum Hinzufügen bzw. Entfernen von Anwendungen im Server mit der rechten Maustaste auf den Server, um das
Serverkontextmenü zu verwenden, oder verwenden Sie die Schaltflächen in der Leiste der Ansicht Server.
Weitere Informationen finden Sie
unter Server mit Entwicklertools starten und stoppen.
Tipp: Um auf diese Optionen zugreifen zu können,
müssen Sie Ihren Liberty-Server in der Ansicht
Server auswählen. Wenn Sie in der Ansicht
Server einen anderen Eintrag auswählen, ist das Serverkontextmenü nicht verfügbar.
Sie können Ihre Serverumgebungsdateien erstellen und bearbeiten. Weitere Informationen finden Sie in der Produktdokumentation unter Serverumgebungsdateien erstellen und bearbeiten.