WebSphere-Variablen erstellen, bearbeiten und löschen

Mit Hilfe von WebSphere-Variablen können Einstellungen für Attribute mit dem Datentyp "String" (Zeichenfolge) bereitgestellt werden, die in einer der Produktkonfigurationsdateien enthalten sind.

Vorbereitungen

Da Anwendungen keinen direkten Zugriff auf WebSphere-Variablen haben, wird eine Fehlernachricht, z. B. "Unknown Variable" (Variable nicht bekannt), zurückgegeben, wenn Sie eine WebSphere-Variable in einer Anwendung definieren. Falls Sie eine WebSphere-Variable aus einer Anwendung heraus referenzieren möchten, nehmen Sie folgende Methode in die Anwendung auf, um die Zeichenfolge zu erweitern, die die WebSphere-Variable enthält.

Probleme vermeiden: Wenn Sie WebSphere -Variablen erweitern, benötigen Sie Administratorberechtigungen.

private String expandVariable(String s) throws
javax.management.JMException {  
com.ibm.websphere.management.AdminService as = 
com.ibm.websphere.management.AdminServiceFactory.getAdminService 
();  

String server = as.getProcessName();  

java.util.Set result = as.queryNames(new javax.management.ObjectName("*:*,type=AdminOperations,process=" 
+ server), null);  

return (String)as.invoke((javax.management.ObjectName) 
result.iterator().next(),"expandVariable",new Object[] 
{"${"+s+"}"}, new String[] {"java.lang.String"});

Auf ähnliche Weise können Sie die folgenden Codezeilen in eine Scriptdatei einschließen, wenn Sie einen Scriptbefehl für die Erweiterung von WebSphere-Variablen verwenden möchten.

Mit Jacl:

set mbean [$AdminControl completeObjectName WebSphere:*,type=AdminOperations]
$AdminControl invoke $mbean expandVariable {{"${APP_INSTALL_ROOT}"}}

Mit Jython:

AdminOperations = AdminControl.completeObjectName('WebSphere:*,type=AdminOperations')
print AdminControl.invoke(AdminOperations, 'expandVariable', '${APP_INSTALL_ROOT}')

Informationen zu dieser Task

Mit WebSphere-Variablen werden häufig Dateipfade angegeben. Der Artikel "Variableneinstellungen" enthält weitere Einzelheiten zur Spezifikation von Variablen und zu den Produktkomponenten, die diese Variablen verwenden.

WebSphere-Variablen können auch verwendet werden, um Folgendes zu konfigurieren:

Pfadnamen des Produkts, wie z. B. JAVA_HOME und APP_INSTALL_ROOT
bestimmte zellenweite bzw. clusterweite Anpassungswerte
den Location Service
Umgebungsvariablen.

Der Scoping-Mechanismus für Variablen in WebSphere ermöglicht die Definition einer Variablen auf Knoten-, Cluster, Zellen- oder Serverebene. Damit ist es möglich, eine Einstellung für alle Server in einem Knoten, einem Cluster oder einer Zelle festzulegen, anstatt für jeden Server einzeln eine Einstellung anzugeben.

Zum Definieren einer neuen Variablen, müssen Sie den Wert einer vorhandenen Variablen ändern bzw. eine vorhandene Variable löschen. Führen Sie dazu die folgenden Schritte aus:

Vorgehensweise

Klicken Sie in der Administrationskonsole auf Umgebung > WebSphere -Variablen .
Wählen Sie den Geltungsbereich der Variablen in der Liste der verfügbaren Geltungsbereiche aus.

Wenn Sie eine neue Variable erstellen, wird diese im ausgewählten Geltungsbereich erstellt. Wenn Sie dieselbe Variable auf mehreren Ebenen definieren, wird die die differenziertere Einstellung verwendet. Geben Sie beispielsweise dieselbe Variable auf Zellenebene und Knotenebene an, überschreit die Einstellung der Knotenebene die Einstellung der Zellenebene.

Das Zuweisen von Variablen zu Geltungsbereichen ist besonders wichtig beim Testen von Datenquellenobjekten. Das Zuweisen von Geltungsbereichen zu Variablen kann beispielsweise bewirken, dass in einer Testverbindung ein Fehler in der Datenquelle auftritt, der zur Laufzeit nicht auftritt, und umgekehrt.
Erstellt eine neue Variable.
1. Klicken Sie auf Neu.
2. Geben Sie einen Namen, einen Wert und optional eine Beschreibung für die Variable an.
  
  Der Anwendungsserver verwendet interne Variablen von WebSphere® Application Server für eigene Zwecke. Die Präfixe, die angeben, dass eine Variable intern ist, sindWAS_DAEMON_<server custom property>,WAS_DAEMON_ONLY_<server custom property>und imWAS_SERVER_ONLY_<server custom property>. Variablen mit diesen Tags sind nicht für Sie bestimmt. Sie sind ausschließlich für die Verwendung durch die Serverlaufzeit reserviert. Das Ändern dieser Variablen kann zu unerwarteten Fehlern führen.
  
  Mit WebSphere-Variablen können Sie die Dämonkonfiguration ändern. Indem Sie einer Dämonkennung eine angepasste Servereigenschaft anhängen, weisen Sie diese Variable explizit diesem Dämon zu. Geben Sie Folgendes ein:DAEMON_<server custom property>im Feld Name . Wenn Sie beispielsweiseDAEMON_ras_trace_outputlocationim Feld "Name" undSYSOUTIm Feld Wert können Sie die Traceausgabe des betreffenden Dämons an SYSPRINT übertragen.
  
  Sie können WebSphere-Variablen erstellen, die Ersetzung unterstützen. Wenn Sie beispielsweise${<variable name>}im Feld Name den Wert von<variable name>wird zum Namen Ihrer neuen WebSphere -Variablen. Wenn Sie beispielsweise${JAVA_HOME}Als Name Ihrer Variablen ist der Name der erstellten WebSphere -Variablen das Java™ -Ausgangsverzeichnis.
3. Klicken Sie auf OK.
4. Klicken Sie in der Navigation der Administrationskonsole auf Umgebung > WebSphere -Variablen und überprüfen Sie, ob die Variable in der Liste der Variablen für den ausgewählten Bereich angezeigt wird.
  
  Die Administrationskonsole kompensiert keine Eingabefehler. Die Variable wird ignoriert, wenn sie nicht ordnungsgemäß referenziert wird.
Ändern Sie die Einstellung für eine vorhandene Variable.
1. Klicken Sie auf den Namen der Variablen, die Sie ändern möchten.
2. Ändern Sie den Inhalt des Felds "Werte".
  
  Das Feld "Werte" ist für einige Variablen, die bei der Installation des Produkts automatisch definiert werden, schreibgeschützt, weil das Ändern der für diese Variablen angegebenen Werte zu Verarbeitungsfehlern führen könnte.
3. Klicken Sie auf OK.
Löschen Sie eine vorhandene Variable.
1. Wählen Sie die Variable aus, die Sie löschen möchten.
2. Klicken Sie auf Löschen.
3. Klicken Sie auf OK.
4. Vergewissern Sie sich, dass diese Variable aus der Liste der Variablen für den ausgewählten Geltungsbereich entfernt wurde.
Speichern Sie Ihre Konfiguration.
Stoppen Sie die betroffenen Server, und starten Sie diese anschließend erneut, damit die an der Variablenkonfiguration vorgenommene Änderung wirksam wird.

Wenn sich die vorgenommene Änderung auf einen Knoten auswirkt, müssen Sie alle Server auf diesem Knoten stoppen und erneut starten. Wenn sich die vorgenommene Änderung auf eine Zelle Knoten auswirkt, müssen Sie alle Server in dieser Zelle stoppen und erneut starten.