WebSphere-Variablen erstellen, bearbeiten und löschen

Sie können WebSphere® Variablen, um Einstellungen für alle Attribute des Zeichenfolgendatentyps bereitzustellen, die in den Produktkonfigurationsdateien enthalten sind.

Vorbereitungen

Da Anwendungen nicht direkt auf WebSphere Variablen, wenn Sie eine WebSphere Wenn Sie eine Variable innerhalb einer Anwendung verwenden, wird eine Fehlermeldung wie „Unbekannte Variable“ zurückgegeben. 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 WebSphere Variableneinstellungen Geben Sie weitere Einzelheiten zum Festlegen von Variablen und Produktkomponenten an, die diese 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
  • [z/OS]den Location Service
  • [z/OS]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

  1. Klicken Sie in der Administrationskonsole auf Umgebung > WebSphere -Variablen .
  2. 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.

  3. Erstellen, ändern oder löschen Sie eine Variable.

    • 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.

        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 Variablen WebSphere . Wenn Sie beispielsweise${JAVA_HOME}Als Name Ihrer Variablen ist der Name der erstellten WebSphere -Variablen das Java™ -Ausgangsverzeichnis.

        [z/OS]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 Name Feld undSYSOUTim Wert können Sie die Trace-Ausgabe dieses bestimmten Daemons an SYSPRINT weiterleiten.

    • Ändern Sie die Einstellung für eine vorhandene Variable.
      1. Klicken Sie auf den Namen der Variablen, die Sie ändern möchten.

        [z/OS]Der Anwendungsserver verwendet WebSphere Application Server interne Variablen 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.

      2. Ändern Sie den Inhalt der Werte Feld.

        Der Werte Für einige der Variablen, die bereits bei der Installation des Produkts definiert wurden, sind die Felder "Schreibgeschützt" und "Nur lesen", da das Ändern der für diese Variablen angegebenen Werte zu Fehlern bei der Produktverarbeitung führen kann.

    • 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.
  4. Klicken Sie auf OK.
  5. Überprüfen Sie die Änderung.

    Wenn Sie eine Variable erstellt haben, klicken Sie auf Umfeld >WebSphere Variablen in der Navigation der Verwaltungskonsole 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.

    Wenn Sie eine Variable gelöscht haben, überprüfen Sie, ob die Variable aus der Variablenliste für den ausgewählten Bereich entfernt wurde.

  6. Speichern Sie Ihre Konfiguration.
  7. 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.