Registrieren und Konfigurieren der Unterstützt. V. ab V8.1 von Sun Cluster HA für Sun Java System Application Server

Im folgenden Verfahren wird beschrieben, wie Sun Cluster HA für Sun Java System Application Server mit dem Befehl scrgadm registriert und konfiguriert wird. Diese Anleitungen beschreiben die Einstellungen der in Anhang A, Eigenschaften der Unterstützt. V. ab V8.1 von Sun Cluster HA für Sun Java System Application Server beschriebenen Erweiterungseigenschaften.

Sowohl die Domain Administration Server-Komponente (DAS) als auch die Node Agent-Komponente (NA) sind als Failover-Dienst konfiguriert.

Allgemeine Informationen zum Registrieren und Konfigurieren von Datendiensten finden Sie in Tools for Data Service Resource Administration in Sun Cluster Data Services Planning and Administration Guide for Solaris OS.

Einstellen der Erweiterungseigenschaften von Sun Cluster HA für Sun Java System Application Server

Die nachfolgenden Abschnitte enthalten Anweisungen zur Registrierung und Konfiguration von Ressourcen. Die Anweisungen in diesem Abschnitt betreffen nur die für Sun Cluster HA für Sun Java System Application Server erforderlichen Erweiterungseigenschaften. Informationen zu allen Erweiterungseigenschaften von Sun Cluster HA für Sun Java System Application Server finden Sie in Anhang A, Eigenschaften der Unterstützt. V. ab V8.1 von Sun Cluster HA für Sun Java System Application Server . Einige Erweiterungseigenschaften können Sie dynamisch aktualisieren. Andere Eigenschaften können Sie nur dann aktualisieren, wenn Sie eine Ressource erstellen oder deaktivieren. Der Eintrag unter "Einstellbar" gibt an, wann die Eigenschaft aktualisiert werden kann.

Zur Einstellung einer Erweiterungseigenschaft einer Ressource geben Sie mit dem Befehl scrgadm(1M), der die Ressource erstellt oder ändert, die folgende Option an:

-x property=value

-x property

Die Erweiterungseigenschaft, die Sie einstellen möchten

value

Der Wert, den Sie für die Erweiterungseigenschaft einstellen

Zur Konfiguration bereits erstellter Ressourcen können Sie auch nach den in Kapitel 2, Administering Data Service Resources in Sun Cluster Data Services Planning and Administration Guide for Solaris OS beschriebenen Verfahren vorgehen.

So registrieren und konfigurieren Sie Sun Cluster HA für Sun Java System Application Server als Failover-DAS-Komponente und als Failover-NA-Komponente

In So konfigurieren und aktivieren Sie Netzwerkressourcen haben Sie bereits die Failover-Ressourcengruppen für die DAS-Komponente und die NA-Komponente erstellt, den Ressourcengruppen Failover-IP-Adressen und logische Hosts hinzugefügt und die Ressourcengruppen online gebracht.

Schritte

1. Melden Sie sich als Superbenutzer bei einem Cluster-Mitglied an.

2. Registrieren Sie den Ressourcentyp der DAS-Komponente.

   # scrgadm -a -t SUNW.jsas

   -a

   Fügt den Ressourcentyp für die DAS-Komponente hinzu.

   -t SUNW.jsas

   Gibt den vordefinierten Namen des Ressourcentyps an.

3. Fügen Sie die DAS-Ressourceninstanz der Failover-Ressourcengruppe hinzu, die Sie für die Netzwerkressourcen erstellt haben.

   Informationen zu den Erweiterungseigenschaften dieses Ressourcentyps finden Sie unter Erweiterungseigenschaften von SUNW.jsas.

   # scrgadm -a -j DAS-resource -g DAS-resource-group \ -t SUNW.jsas \ -y Network_resources_used=logical-hostname \ -x Adminuser=DAS-admin-username \ -x Domain_name=domain-name \ -x Passwordfile=password-file \ -x Confdir_list=install-directory \ -x Domaindir=domain-directory \ -x Monitor_Uri_List=http://logical-hostname[:port][/path]

   -a

   Fügt eine Ressource hinzu.

   -j DAS-resource

   Gibt den DAS-Ressourcennamen an.

   -g DAS-resource-group

   Gibt die Ressourcengruppe der DAS-Komponente an.

   -t SUNW.jsas

   Gibt den Ressourcentyp der DAS-Komponente an.

   -y Network_resources_used =logical-hostname

   Gibt die vom DAS verwendete Failover-IP-Adresse an.

   -x Adminuser= DAS-admin-username

   Gibt den Benutzernamen des DAS-Administrators an.

   -x Domain_name= domain-name

   Gibt den Domain-Namen an.

   -x Passwordfile= password-file

   Gibt den vollständigen Pfad der Datei an, die das DAS-Administratorpasswort sowie das Masterpasswort enthält.

   -x Confdir_list= install-directory

   Gibt den vollständigen Pfad des Installationsverzeichnisses von Sun Java System Application Server an. Der Standardwert dieser Erweiterungseigenschaft ist /opt/SUNWappserver . Dies ist das Standardinstallationsverzeichnis.

   -x Domaindir= domain-directory

   Gibt den vollständigen Pfad des Domänenverzeichnisses an. Diese Erweiterungseigenschaft muss nicht eingestellt werden, wenn das Domänenverzeichnis das bei der Installation von Sun Java System Application Server angegebene Standardverzeichnis ist.

   -x Monitor_Uri_List =logical-hostname[:port][/path]

   (Optional) Gibt eine kommagetrennte Liste der URIs an, über die der Sun Cluster HA für Sun Java System Application Server Anforderungen stellt. Die Erweiterungseigenschaft Monitor_Uri_List ist erforderlich, wenn die Eigenschaft Port_list nicht eingestellt ist. Port_list ist eine der Standardeigenschaften einer Ressource. Sie gibt eine Liste der Portnummern an, die von einem Server überwacht werden. Eine ausführliche Beschreibung der Eigenschaft Port_list finden Sie unter Resource Properties in Sun Cluster Data Services Planning and Administration Guide for Solaris OS.

4. Registrieren Sie den Ressourcentyp der Node Agent-Komponente.

   # scrgadm -a -t SUNW.jsas-na

   -a

   Fügt den Ressourcentyp der NA-Komponente hinzu

   -t SUNW.jsas-na

   Gibt den vordefinierten Namen des Ressourcentyps an.

5. Fügen Sie die Node Agent-Ressourceninstanz der Failover-Ressourcengruppe hinzu, die Sie für die Netzwerkressourcen erstellt haben.

   Informationen zu den Erweiterungseigenschaften dieses Ressourcentyps finden Sie unter Erweiterungseigenschaften von SUNW.jsas-na.

   # scrgadm -a -j NA-resource -g NA-resource-group \ -t SUNW.jsas-na \ -y Resource_Dependencies=DAS-resource \ -x Adminuser=DAS-admin-username \ -x Confdir_list=install-directory \ -x Adminhost=DAS-hostname \ -x Adminport=DAS-port \ -x Agentdir=NA-directory \ -x Passwordfile=password-file

   -a

   Fügt eine Ressource hinzu.

   -j NA-resource

   Gibt den Ressourcennamen des Node Agent an.

   -g NA-resource-group

   Gibt die Ressourcengruppe der Node Agent-Komponente an.

   -t SUNW.jsas-na

   Gibt den Ressourcentyp der Node Agent-Komponente an.

   -y Resource_Dependencies =DAS-resource

   Legt fest, dass zum Starten der Node Agent-Ressource die DAS-Ressource online sein muss.

   -x Adminuser= DAS-admin-username

   Gibt den Benutzernamen des DAS-Administrators an.

   -x Confdir_list= install-directory

   Gibt den vollständigen Pfad des Installationsverzeichnisses von Sun Java System Application Server an. Der Standardwert dieser Erweiterungseigenschaft ist /opt/SUNWappserver . Dies ist das Standardinstallationsverzeichnis.

   -x Adminhost= DAS-hostname

   Gibt den Hostnamen des Domain Administration Server an.

   -x Adminport= DAS-port

   Gibt den Port an, der vom DAS überwacht wird.

   -x Agentdir= NA-directory

   Gibt den vollständigen Pfad des Node Agent-Verzeichnisses an.

   -x Passwordfile= password-file

   Gibt den vollständigen Pfad der Datei an, die das DAS-Administratorpasswort sowie das Masterpasswort enthält.

Beispiele für die Registrierung und Konfiguration der Failover-DAS-Komponente in Sun Cluster HA für Sun Java System Application Server

In diesen Beispielen wird Folgendes vorausgesetzt: Die DAS-Ressourcengruppe ist bereits erstellt, die Failover-IP-Adresse wurde der Ressourcengruppe hinzugefügt und die Ressourcengruppe ist bereits online.

Beispiel 1–1 Erstellen einer einfachen DAS-Ressource

In diesem Beispiel werden die Standardwerte der Erweiterungseigenschaften verwendet.

# scrgadm -a -t SUNW.jsas

# scrgadm -a -j das-rs  -g das-rg  \
-t SUNW.jsas \
-y Network_resources_used=IP1 \
-x Adminuser=admin \
-x Domain_name=new-domain \
-x Passwordfile=/global/disk1/passwordfile

In diesem Beispiel werden die folgenden Werte verwendet.

• Der Ressourcenname ist das-rs.

• Die Ressourcengruppe ist das-rg.

• Der Benutzername des Administrators ist admin.

• Der Domänenname ist new-domain.

• Der vollständige Pfad der Passwortdatei ist /global/disk1/passwordfile.

• Der Anwendungsserver wurde im Standardinstallationsverzeichnis /opt/SUNWappserver installiert. Dies ist der Standardwert der Erweiterungseigenschaft Confdir_list.

• Die Domäne wurde in dem Verzeichnis installiert, das Sie bei der Installation angegeben haben. Der Pfad dieses Verzeichnisses wird in der Datei /opt/SUNWappserver/appserver/config/asenv.conf durch die Variable AS_DEF_DOMAINS festgelegt. Die Binärdateien können im lokalen Dateisystem gespeichert werden, das Domänenverzeichnis muss sich jedoch im globalen Dateisystem befinden.

Beispiel 1–2 Erstellen einer DAS-Ressource durch Angabe des Installationsverzeichnisses und des Domänenverzeichnisses

In diesem Beispiel sind der Anwendungsserver und die Domäne nicht in den Standardverzeichnissen installiert.

# scrgadm -a -t SUNW.jsas

# scrgadm -a -j das-rs  -g das-rg  \
-t SUNW.jsas \
-y Network_resources_used=IP1 \
-x Adminuser=admin \
-x Domain_name=new-domain \
-x Passwordfile=/global/disk1/passwordfile \
-x Confdir_list=/global/disk1/SUNWappserver \
-x Domaindir=/global/disk1/my-domain

In diesem Beispiel werden die folgenden Werte verwendet.

• Der Ressourcenname ist das-rs.

• Die Ressourcengruppe ist das-rg.

• Der Benutzername des Administrators ist admin.

• Der Domänenname ist new-domain.

• Der vollständige Pfad der Passwortdatei ist /global/disk1/passwordfile.

• Der Anwendungsserver ist im Verzeichnis /global/disk1/SUNWappserver installiert.

• Das Domänenverzeichnis ist /global/disk1/my-domain.

Beispiel 1–3 Erstellen einer DAS-Ressource und Angabe einer Liste der zu überwachenden URIs

In diesem Beispiel gibt die Erweiterungseigenschaft Monitor_Uri_Lis die URI an, die von den Anwendungen auf dem Anwendungsserver überwacht wird. Der Fehler-Monitor überwacht diese URI, um die Funktionalität des Anwendungsservers zu überprüfen.

# scrgadm -a -t SUNW.jsas

# scrgadm -a -j das-rs  -g das-rg  \
-t SUNW.jsas \
-y Network_resources_used=IP1 \
-x Adminuser=admin \
-x Domain_name=new-domain \
-x Passwordfile=/global/disk1/passwordfile \
-x Confdir_list=/global/disk1/SUNWappserver \
-x Domaindir=/global/disk1/my-domain \
-x Monitor_Uri_List=http://IP1:4848/web-service

In diesem Beispiel werden die folgenden Werte verwendet.

• Der Ressourcenname ist das-rs.

• Die Ressourcengruppe ist das-rg.

• Der Benutzername des Administrators ist admin.

• Der Domänenname ist new-domain.

• Der vollständige Pfad der Passwortdatei ist /global/disk1/passwordfile.

• Der Anwendungsserver ist im Verzeichnis /global/disk1/SUNWappserver installiert.

• Das Domänenverzeichnis ist /global/disk1/my-domain.

• Die zu überwachende URI ist http://IP1:4848/web-service.

Beispiel für die Erstellung der Failover-Node Agent-Komponente in Sun Cluster HA für Sun Java System Application Server

Für dieses Beispiel wird die folgende Konfiguration vorausgesetzt (die Failover-IP-Adressen werden durch logische Hostnamen angegeben).

• Node Agent NA1 und die zugehörigen Serverinstanzen I1 und I2 überwachen die Failover-IP-Adresse IP1.

• Node Agent NA2 und die zugehörigen Serverinstanzen I3 und I4 überwachen ebenfalls die Failover-IP-Adresse IP1.

• Node Agent NA3 und die zugehörigen Serverinstanzen I5 und I6 überwachen die Failover-IP-Adresse IP2.

• Node Agent NA4 und die zugehörigen Serverinstanzen I7 und I8 überwachen ebenfalls die Failover-IP-Adresse IP2.

Beispiel 1–4 Erstellen der Failover-Node Agent-Ressourcen

1. Zum Registrieren des Ressourcentyps der Node Agents führen Sie den folgenden Befehl aus.

   # scrgadm -a -t SUNW.jsas-na

2. Zum Erstellen der Failover-Ressourcengruppe na-rg1, die die Failover-IP-Adresse IP1 und die Node Agent-Ressource für die Node Agents NA1 und NA2 enthalten soll, führen Sie den folgenden Befehl aus.

   # scrgadm -a -g na-rg1

3. Zum Erstellen der Failover-Ressourcengruppe na-rg2, die die Failover-IP-Adresse IP2 und die Node Agent-Ressource für die Node Agents NA3 und NA4 enthalten soll, führen Sie den folgenden Befehl aus.

   # scrgadm -a -g na-rg2

4. Zum Hinzufügen der Failover-IP-Adressenressource IP1 zur Ressourcengruppe na-rg1 führen Sie den folgenden Befehl aus.

   # scrgadm -a -L -g na-rg1 -l IP1

5. Zum Hinzufügen der Failover-IP-Adressenressource IP2 zur Ressourcengruppe na-rg2 führen Sie den folgenden Befehl aus.

   # scrgadm -a -L -g na-rg2 -l IP2

6. Zum Erstellen der Node Agent-Ressource na-rs1 in der Ressourcengruppe na-rg1 führen Sie den folgenden Befehl aus.

   ---

   Hinweis –

   Für alle Node Agents, die für eine Failover-IP-Adresse konfiguriert sind, wird nur eine Node Agent-Ressource erstellt. Der Datendienst erkennt automatisch die Node Agents, die für die Failover-IP-Adresse der Failover-Ressourcengruppe konfiguriert sind.

   In diesem Beispiel sind die Node Agents NA1 und NA2 mit ihren Serverinstanzen (I1, I2, I3 und I4) auf IP1 konfiguriert, weshalb nur eine Ressource, na-rs1, für NA1 und NA2 erstellt wird.

   ---

   • Führen Sie den folgenden Befehl aus, wenn Sie die Standardwerte der Erweiterungseigenschaften verwenden.

     # scrgadm -a -j na-rs1 -g na-rg1 \ -t SUNW.jsas-na \ -y Resource_Dependencies=das-rs \ -x Adminhost=host-1 \ -x Adminuser=admin \ -x Agentdir=/global/dg1/na-dir \ -x Passwordfile=/global/dg1/p

   • Führen Sie den folgenden Befehl aus, wenn Sie nicht das Standardinstallationsverzeichnis und den Standardverwaltungsport verwenden.

     # scrgadm -a -j na-rs1 -g na-rg1 \ -t SUNW.jsas-na \ -y Resource_Dependencies=das-rs \ -x Adminhost=host-1 \ -x Adminuser=admin \ -x Agentdir=/global/dg1/na-dir \ -x Passwordfile=/global/dg1/p \ -x Confdir_list=/global/disk1/appserver-install-dir \ -x Adminport=6162

7. Zum Erstellen der Node Agent-Ressource na-rs2 in der Ressourcengruppe na-rg2 führen Sie den folgenden Befehl aus.

   ---

   Hinweis –

   Für alle Node Agents, die für eine Failover-IP-Adresse konfiguriert sind, wird nur eine Node Agent-Ressource erstellt. Der Datendienst erkennt automatisch die Node Agents, die für die Failover-IP-Adresse der Failover-Ressourcengruppe konfiguriert sind.

   In diesem Beispiel sind die Node Agents NA3 und NA4 mit ihren Serverinstanzen (I5, I6, I7 und I8) auf IP2 konfiguriert, weshalb nur eine Ressource, na-rs2, für NA3 und NA4 erstellt wird.

   ---

   • Führen Sie den folgenden Befehl aus, wenn Sie die Standardwerte der Erweiterungseigenschaften verwenden.

     # scrgadm -a -j na-rs2 -g na-rg2 \ -t SUNW.jsas-na \ -y Resource_Dependencies=das-rs \ -x Adminhost=host-1 \ -x Adminuser=admin \ -x Agentdir=/global/dg1/na-dir \ -x Passwordfile=/global/dg1/p

   • Führen Sie den folgenden Befehl aus, wenn Sie nicht das Standardinstallationsverzeichnis und nicht den Standardverwaltungsport verwenden.

     # scrgadm -a -j na-rs2 -g na-rg2 \ -t SUNW.jsas-na \ -y Resource_Dependencies=das-rs \ -x Adminhost=host-1 \ -x Adminuser=admin \ -x Agentdir=/global/dg1/na-dir \ -x Passwordfile=/global/dg1/p \ -x Confdir_list=/global/disk1/appserver-install-dir \ -x Adminport=6162

8. Um die Node Agent-Ressourcengruppe na-rg1 online zu bringen, führen Sie den folgenden Befehl aus.

   # scswitch -Z -g na-rg1

   Dadurch aktivieren Sie die folgenden Ressourcen.

   • Node Agent NA1 und die unter NA1 konfigurierten Serverinstanzen I1 und I2.

   • Node Agent NA2 und die unter NA2 konfigurierten Serverinstanzen I3 und I4.

9. Um die Node Agent-Ressourcengruppe na-rg2 online zu bringen, führen Sie den folgenden Befehl aus.

   # scswitch -Z -g na-rg2

   Dadurch aktivieren Sie die folgenden Ressourcen.

   • Node Agent NA3 und die unter NA3 konfigurierten Serverinstanzen I5 und I6.

   • Node Agent NA4 und die unter NA4 konfigurierten Serverinstanzen I7 und I8.