Liberty-Server-Host-Informationen überschreiben
Mit dem Feature collectiveMember-1.0 kann ein Server über den Verbundcontroller verwaltet werden. Die meisten Server-Host-Informationen können automatisch erkannt werden. In bestimmten Szenarien müssen Sie jedoch zusätzliche Hostinformationen angeben, damit der Verbundcontroller eine Verbindung zu einem Server herstellen kann.


Fügen Sie der Datei
server.xml das folgende Element hinzu, um die Überschreibung der Hostinformationen zu aktivieren:
<hostAuthInfo rpcPort="SSH-Port"
rpcUser="Benutzer-ID"
rpcUserPassword="Kennwort"
rpcUserHome="Benutzerausgangsverzeichnis"
rpcHost="Hostname"
sudoUser="sudo-Benutzer"
sudoPassword="sudo-Benutzerkennwort"
sshPublicKeyPath="Pfad_des_öffentlichen_Schlüssels"
sshPrivateKeyPath="Pfad_des_privaten_Schlüssels"
sshPrivateKeyPassword="Kennwort_für_privaten_Schlüssel"
useHostCredentials="true_oder_false"/>
- rpcPort
- Dieser Parameter gibt den Port für den RPC-Mechanismus an (standardmäßig ist das SSH-Port 22). Wenn Ihr System einen vom Standard abweichenden Port verwendet, legen Sie diesen Wert dementsprechend fest. Wenn dieser Wert nicht angegeben wird, ist der Standardwert 22.
- rpcUser
- Dieser Parameter gibt die Benutzer-ID an, die vom Verbundcontroller zum Herstellen einer Verbindung mit dem Server verwendet wird. Wenn der Host SSH nicht unterstützt oder die Verwendung von SSH-Schlüsseln nicht gewünscht wird, können Sie mit diesem Parameter einen Benutzer für Betriebssystemanmeldung angeben. Wenn Sie sich beispielsweise mit der Benutzer-ID myID beim Host anmelden, geben Sie rpcUser="myID" an. Wenn dieser Wert nicht angegeben wird, ist der Standardwert System.getProperty("user.name").
- rpcUserPassword
- Dieser Parameter gibt das Kennwort für die angegebene Benutzer-ID an. Wenn Sie sich beispielsweise mit der Benutzer-ID myID und dem Kennwort myPwd beim Host anmelden, geben Sie rpcUser="myID" und rpcUserPassword="myPwd" an. Wenn dieser Wert nicht angegeben wird, generiert der Server ein SSH-Schlüsselpaar, oder er verwendet für die Verbindung das SSH-Schlüsselpaar, das mit den Parametern privateKeyPath und publicKeyPath angegeben wird. Wenn SSH nicht auf dem Server installiert ist (z. B. auf einem Windows- oder OS/400-Betriebssystem), ist das Kennwort erforderlich.
- rpcUserHome
- Dieser Parameter gibt das Ausgangsverzeichnis des Benutzers an. Wenn dieser Wert nicht angegeben wird, ist der Standardwert System.getProperty("user.home"). Wenn rpcUser angegeben wird, müssen Sie auch rpcUserHome angeben.
- rpcHost
- Dieser Parameter gibt den Host an, auf dem der RPC-Mechanismus als empfangsbereit konfiguriert ist. Wird dieser Wert nicht angegeben, ist der Standardwert der Wert der Variablen defaultHostName. Wenn Ihr System einen anderen Host als defaultHostName verwendet, legen Sie diesen Wert entsprechend fest.
- sudoUser
- Wenn dieser Wert angegeben wird, kann der Verbundcontroller Befehle mit den Rechten einer anderen Benutzer-ID ausführen ("sudo") anstelle der Benutzer-ID, die für die Verbindung verwendet wird. Dieser Parameter gilt nur für Server, auf denen ein SSH-Server installiert ist. Dieser Parameter hat keinen Standardwert.
- sudoPassword
- Dieser Parameter gibt das Kennwort für den sudo-Benutzer an, der mit dem Parameter sudoUser angegeben wird. Dieser Parameter gilt nur für Server, auf denen ein SSH-Server installiert ist. Dieser Parameter hat keinen Standardwert.
- sshPublicKeyPath
- Dieser Parameter gibt den Pfad und den Dateinamen einer benutzerdefinierten Datei mit öffentlichem Schlüssel an. Wenn dieser Wert nicht angegeben wird, ist der Standardwert ${server.output.dir}/resources/security/ssh/id_rsa.pub. Wenn die angegebene Datei (oder Standarddatei) nicht vorhanden ist, wird eine neue Datei mit öffentlichem Schlüssel generiert.
- sshPrivateKeyPath
- Dieser Parameter gibt den Pfad und den Dateinamen einer benutzerdefinierten Datei mit privatem Schlüssel an. Wenn dieser Wert nicht angegeben wird, ist der Standardwert ${server.output.dir}/resources/security/ssh/id_rsa. Wenn die angegebene Datei (oder Standarddatei) nicht vorhanden ist, wird eine neue Datei mit privatem Schlüssel generiert.
- sshPrivateKeyPassword
- Dieser Parameter gibt das Kennwort für den privaten Schlüssel an. Dieser Parameter hat keinen Standardwert.
useHostCredentials
Dieser Parameter gibt an, ob Befehle von Verbund-Member-Servern RPC-Berechtigungsnachweise vom Host übernehmen. Die Standardeinstellung ist false, d. h., der Benutzer muss RPC-Berechtigungsnachweise angeben, damit der Controller das Member starten oder stoppen kann. Bei Verwendung der Einstellung true übernehmen Befehle von Verbund-Member-Servern RPC-Berechtigungsnachweise von der Hostregistrierung und ignorieren alle anderen RPC-Berechtigungsnachweise im Konfigurationselement hostAuthInfo.
Beispiele
Szenario 1: Der Server ist auf
einem Windows-Betriebssystem installiert, SSH
ist nicht installiert.
<hostAuthInfo rpcUserPassword="myPassword"/>
Szenario
2: SSH ist auf dem Server installiert, SSH wird an Port 2222 ausgeführt.
<hostAuthInfo rpcPort="2222"/>
Szenario
3: Befehle müssen unter einer anderen Benutzer-ID ausgeführt werden.
<hostAuthInfo sudoUser="anotherUser" sudoPassword="anotherPassword"/>
Szenario
4: Der Server ist auf einem Windows-Betriebssystem installiert, SSH (z. B. Cygwin) ist installiert.
Mit der folgenden Serverkonfiguration stellt der Controller eine Verbindung zum Member-Server mit SSH her.
In diesem Fall ist es nicht erforderlich, die
Windows-Benutzerkontensteuerung zu inaktivieren. Der Parameter
<Ausgangsverzeichnis_des_Benutzers> ist das Standardausgangsverzeichnis des Benutzers, das standardmäßig festgelegt ist,
wie z. B. C:\cygwin\home\bob.
<hostAuthInfo rpcUserHome="<Ausgangsverzeichnis_des_Benutzers>" />
![[8.5.5.4 oder höher]](../ng_v8554.gif)