Das Admin Center ist eine Webbenutzerschnittstelle, die in
Servern mit Liberty Version 8.5.5.2 und höher ausgeführt wird. Konfigurieren Sie die Datei server.xml, nachdem Sie Liberty installiert und einen Server erstellt haben.
Vorbereitende Schritte
Installieren Sie WebSphere Application Server Liberty mit Liberty
Administrative Center ("Admin Center"). Informationen zu den verschiedenen Möglichkeiten, Assets wie das
Admin Center zu installieren, finden Sie unter Liberty Repository-Assets installieren. Die schnellste Methode, das Admin Center zu installieren, ist die Ausführung des Befehls installUtility oder des Befehls featureManager:
- Installieren Sie WebSphere Application Server Liberty Version 8.5.5.2 oder höher, sofern noch nicht geschehen.
Einschränkung: Stellen Sie sicher, dass Sie eine JVM (Java Virtual Machine) verwenden, die Liberty-Produkte und SSL (Secure Sockets Layer) unterstützt. Verwenden Sie keine IBM JVM, die im Lieferumfang eines WebSphere Application Server Traditional-Produkts vorhanden ist, wie z. B.
Network Deployment, für Ihre Liberty-Installation mit dem Admin Center. Die mit einem traditionellen Produkt bereitgestellte IBM JVM verweist standardmäßig auf
Sicherheitsklasssen, die nur mit einem traditionellen Produkt verfügbar sind, und nicht auf Sicherheitsklassen, die
vom Admin Center benötigt werden.
Wenn Sie eine in einem traditionellen Produkt verfügbare IBM JVM verwenden, kann dies dazu führen, dass das Admin Center nicht in einem Browser angezeigt werden kann.
- Öffnen Sie ein Befehlsfenster im Hauptverzeichnis der Liberty-Installation. Öffnen Sie beispielsweise ein Befehlsfenster in c:\wlp.
- Führen Sie einen Befehl zum Installieren des Features adminCenter-1.0 aus.
Führen Sie für Version 8.5.5.6 oder höher den Befehl
installUtility
aus:
bin/installUtility install adminCenter-1.0
Führen Sie für
Version 8.5.5.5 oder früher den Befehl
featureManager
aus:
bin/featureManager install adminCenter-1.0 --when-file-exists=ignore
- Führen Sie für die Liberty-Entwickleredition einen Befehl zum Installieren des Features
collectiveController-1.0 aus.
Führen Sie für Version 8.5.5.6 oder höher den Befehl
installUtility aus:
bin/installUtility install collectiveController-1.0
Führen Sie für
Version 8.5.5.5 oder früher den Befehl
featureManager
aus:
bin/featureManager install collectiveController-1.0 --when-file-exists=ignore
Dieser Schritt gilt nur für die Entwickleredition
und nicht für die Network-Deployment-, z/OS- oder Core-Editionen von Liberty. Optional können Sie das Feature collectiveController-1.0 installieren, bevor Sie das Feature
adminCenter-1.0 installieren.
Weitere Informationen finden Sie auf der WASdev-Website, wenn Sie das Register Downloads auswählen und das
Liberty-Repository für das Asset "Admin Center" suchen.
Wenn Sie das Admin Center auf Hosts installieren möchten, die nicht auf das
internetbasierte Liberty-Repository zugreifen können, installieren Sie Liberty und das Feature "Admin Center" zunächst auf einem Host, der auf das Internet zugreifen kann. Übertragen Sie anschließend die Installation auf die Zielhosts. In den folgenden Abschnitten wird die Paketierung erläutert.
Informationen zu diesem Vorgang
Sie können das Admin Center in eigenständigen Servern und in Verbundcontrollern konfigurieren. Dieser Abschnitt hat als Hauptthema die Konfiguration eines eigenständigen Liberty-Servers.
Wenn Sie das Admin Center in einem Verbundcontroller aktivieren möchten, finden Sie weitere Informationen hierzu
unter
Liberty-Verbund konfigurieren.
Stellen Sie sicher, dass die Datei server.xml des Verbundcontrollers das Feature <feature>adminCenter-1.0</feature> in der Feature-Manager-Konfiguration enthält und im httpEndpoint-Element ein Wert für host, wie z. B. host="*", definiert ist, sodass alle Hosts auf den Verbundcontroller zugreifen können.
Vorgehensweise
- Wenn Ihre Liberty-Installation keinen Server enthält, erstellen Sie einen Liberty-Server.
Erstellen Sie beispielsweise in einem Befehlsfenster im Verzeichnis wlp/bin einen Server mit dem Namen myServer.
server create myServer
Der Beispielbefehl fügt dem Verzeichnis wlp/usr/servers/myServer Serverdateien hinzu.
- Öffnen Sie die Datei server.xml des Liberty-Servers in einem Editor und konfigurieren Sie den Server für das Admin Center.
- Fügen Sie dem Feature-Manager das Feature adminCenter-1.0 hinzu.
<featureManager>
<feature>adminCenter-1.0</feature>
</featureManager>
Wenn Sie zeitgerechte Aktualisierungen zu den Server- und Anwendungsstatus im Tool "Untersuchen" erhalten möchten, fügen Sie auch das Feature
websocket-1.1 oder das Feature websocket-1.0 der Serverkonfiguration hinzu.
<featureManager>
<feature>adminCenter-1.0</feature>
<feature>websocket-1.1</feature>
</featureManager>
WebSocket stellt eine von der Größe unabhängige Liveansicht der Topologie zur Verfügung. Ohne das WebSocket-Feature führt das Admin Center in regelmäßigen Abständen Abfragen nach Änderungen durch.
- Fügen Sie zum Konfigurieren einer sicheren Anmeldung einen oder mehrere Benutzer hinzu. Beispiel:
<quickStartSecurity userName="admin" userPassword="adminpwd" />
Wenn Benutzernamen oder Kennwörter nicht-englische Zeichen enthalten, erstellen Sie die Datei
jvm.options für den Server und legen Sie als Standardclientcodierung die UTF-8-Codierung fest:
-Ddefault.client.encoding=UTF-8
Weitere Informationen zur Datei
jvm.options finden Sie unter
Liberty-Umgebung anpassen.
- Wenn Sie Keystore-Dateien mit Berechtigungsnachweisen für die Serverauthentifizierung schützen möchten, definieren Sie einen Keystore und ordnen Sie ihm ein Kennwort zu.
<keyStore id="defaultKeyStore" password="Liberty"/>
Eine Beispieldatei server.xml, die einen Administrator und einen Benutzer ohne Administratorberechtigung sowie einen Keystore definiert, finden Sie in diesem Abschnitt unter
Beispiel. Informationen zum Definieren mehrerer Benutzer mit Verwaltungsaufgaben finden Sie unter Beispiel: BasicRegistry und Rollenzuordnung in Liberty verwenden.
- Wenn Sie auf das Admin Center über ein Smartphone, ein Tablet oder einen fernen Computer zugreifen möchten, stellen Sie sicher, dass
in der Datei server.xml das host-Attribut des httpEndpoint-Elements auf * (Stern) oder einen definierten Hostnamen gesetzt ist. Standardmäßig ist das Attribut host auf localhost gesetzt.
<httpEndpoint id="defaultHttpEndpoint"
host="*"
httpPort="9080"
httpsPort="9443" />
- Speichern Sie die Änderungen an der Datei server.xml.
Wenn Sie für nicht-englische Zeichen als Standardclientcodierung die UTF-8-Codierung in der Datei jvm.options festgelegt haben und
die Benutzerregistry in den Elementen quickStartSecurity oder basicRegistry angegeben ist, die Benutzernamen und Kennwörter
in der Datei server.xml speichern, dann speichern Sie die Datei server.xml in der UTF-8-Codierung.
- Wenn der
Server nicht aktiv ist, starten Sie den Server.
Setzen Sie beispielsweise in einem Befehlsfenster im Verzeichnis wlp/bin den Befehl run oder start ab.
server run myServer
Suchen Sie nach Servernachrichten, aus denen hervorgeht, dass die Webanwendung adminCenter aktiv ist. Wenn das Admin Center aktiv ist, können Sie
in einem Web-Browser die URL zur Anwendung eingeben und sich anmelden. Weitere Informationen hierzu finden Sie unter
Am Admin Center anmelden.
Hinweis: Das Video Setting up Admin Center veranschaulicht den Vorgang. [Transkript]
Beispiel: Datei "server.xml" mit zwei definierten berechtigten Benutzern
<server description="new server">
<!-- Features aktivieren -->
<featureManager>
<feature>adminCenter-1.0</feature>
</featureManager>
<!-- Hostnamen definieren, den der Verbund verwenden soll.
Wenn der Hostname geändert werden muss, muss der Server aus dem Verbund
entfernt und erneut aufgenommen werden. -->
<variable name="defaultHostName" value="localhost" />
<!-- Administrator und einen Benutzer ohne Administratorberechtigung definieren -->
<basicRegistry id="basic">
<user name="admin" password="adminpwd" />
<user name="nonadmin" password="nonadminpwd" />
</basicRegistry>
<!-- 'admin' dem Administrator zuordnen -->
<administrator-role>
<user>admin</user>
</administrator-role>
<keyStore id="defaultKeyStore" password="Liberty" />
<httpEndpoint id="defaultHttpEndpoint"
host="*"
httpPort="9080"
httpsPort="9443" />
</server>