Verwaltungsscriptdateien in WebSphere Application Server ausführen

Sie können Verwaltungsscripts in der Entwicklungsumgebung ausführen, ohne zum nicht grafischen Befehlsinterpreter (WebSphere Application Server-Tool "wsadmin") wechseln zu müssen. Verwenden Sie das Startprogramm für Verwaltungsscripts von WebSphere Application Server, um Verwaltungsscriptdateien in WebSphere Application Server auszuführen. Wenn Sie Scriptdateien in der Entwicklungsumgebung ausführen möchten, müssen Sie die Position Ihres Scripts, die Laufzeitumgebung für die Interpretation Ihres Scripts und die Sicherheitseinstellungen angeben, falls Ihr Script auf einem gesicherten Server ausgeführt wird.

Vorbereitende Schritte

Informationen zu diesem Vorgang

Führen Sie die Verwaltungsscriptdateien in WebSphere Application Server aus.

Vorgehensweise

  1. Sie haben die folgenden Möglichkeiten, das Startprogramm für Verwaltungsscripts von WebSphere Application Server zu öffnen:
    • Klicken Sie in der Ansicht "Server" mit der rechten Maustaste auf eine WebSphere Application Server-Instanz und wählen Sie Verwaltung > Verwaltungsscript ausführen aus.
    • Klicken Sie mit der rechten Maustaste auf einen beliebigen Texteditor, z. B. den Jython-Editor, und wählen Sie Ausführen als > Verwaltungsscript aus.
    • Klicken Sie in der Ansicht "Enterprise-Explorer" oder "Navigator" mit der rechten Maustaste auf eine Datei mit einer gültigen Dateierweiterung und wählen Sie Ausführen als > Verwaltungsscript aus.
    • Wählen Sie in der Symbolleiste der Java™- oder Java EE-Perspektive Ausführen > Konfigurationen ausführen > WebSphere Application Server - Script für die Administration und anschließend Neue Startkonfiguration (Screenshot der Schaltfläche Neue Startkonfiguration) aus.
  2. Die Seite Script ist die Hauptseite des Startprogramms für Verwaltungsscripts von WebSphere Application Server.
  3. Führen Sie im Feld Verwaltungsscript einen der folgenden Schritte aus, um die Position Ihrer Scriptdatei anzugeben:
    • Geben Sie den Pfad zu Ihrer Scriptdatei ein.
    • Klicken Sie auf Arbeitsbereich, um zu Ihrer Scriptdatei in Ihrem Arbeitsbereich zu navigieren.
    • Klicken Sie auf Dateisystem, um zu Ihrer Scriptdatei auf Ihrem Dateisystem zu navigieren.
    • Klicken Sie auf Variablen, um den Pfad zu Ihrer Scriptdatei automatisch zu erweitern, wenn in Ihrem Arbeitsbereich eine Ressource ausgewählt wird.
  4. Wählen Sie in der Liste Laufzeitumgebung für Scripterstellung einen Namen einer installierten WebSphere Application Server-Laufzeitumgebung, die auf der Seite Benutzervorgaben (Fenster > Benutzervorgaben > Server > Laufzeitumgebungen) definiert ist, aus. Geben Sie eine Laufzeitumgebung, die sich auf Ihrem lokalen Dateisystem befindet, für die Interpretation Ihrer Scriptdatei an. Wenn die Laufzeitumgebung für die Interpretation Ihrer Scriptdatei nicht in der Dropdown-Liste verfügbar ist, klicken Sie auf Neu, um eine neue WebSphere Application Server-Laufzeitumgebung zu definieren. Der Assistent Neue Serverlaufzeitumgebung wird geöffnet. Sie können zwar beliebige Laufzeitumgebungen mithilfe des Assistenten Neue Serverlaufzeitumgebung erstellen, aber das Startprogramm für Verwaltungsscripts von WebSphere Application Server unterstützt nur die folgenden lokalen Laufzeitumgebungen:
    • WebSphere Application Server Version 6.1 oder höher
    Deshalb werden in der Dropdown-Liste Laufzeitumgebung für Scripterstellung nur die unterstützten Laufzeitumgebungen angezeigt.
  5. Wählen Sie in der Liste Profilname ein Profil aus, das zur zuvor ausgewählten Laufzeitumgebung gehört. Ein Profil ist der Satz der Dateien, die die Laufzeitumgebung definieren. Wenn Sie die Option [Nicht angegeben] auswählen, wählt das Tool das Profil aus, dem die Standardrolle zugeordnet ist.
  6. Geben Sie im Feld für die wsadmin-Argumente eine erweiterte Befehlszeilenaufrufsyntax für den wsadmin-Scripting-Client an. Eine Referenz für die Befehlszeilenaufrufsyntax ist in der WebSphere Application Server-Dokumentation verfügbar. Weitere Details finden Sie im Abschnitt Tool "wsadmin". Das Startprogramm für Verwaltungsscripts von WebSphere Application Server verarbeitet die folgenden Informationen, die an den wsadmin-Scripting-Client übergeben werden:
    • Den Dateinamen und -pfad der Scriptdatei
    • Die Sprache der Scriptdatei
    • Den Namen des WebSphere Application Server-Profils, das für die Ausführung Ihrer Scriptdatei verwendet wird
    • Die Benutzer-ID und das Kennwort für die Authentifizierung beim gesicherten Zielserver
    Geben Sie die Informationen nicht noch mal im Feld für die wsadmin-Argumente an.

    Wenn Sie die Verwaltungsscripts auf einem fernen Server ausführen, geben Sie an, ob Sie einen RMI- (Methodenfernaufruf, Remote Method Invocation) oder einen SOAP-Verbindungstyp und den zugehörigen Portwert verwenden. Wenn die Sicherheit auf dem fernen Server aktiviert ist, geben Sie die Parameter -user und -password an. Verwenden Sie eine der folgenden Befehlssyntaxen im Feld für die wsadmin-Argumente:

    • Verwenden Sie für den SOAP-Verbindungstyp die folgende Syntax:
      -conntype SOAP [-host Hostname]
      [-port Portnummer] [-user Benutzer-ID] [-password Kennwort]

      Beispiel: -conntype SOAP -host mycomputer.mycompany.com -port 8800 -user myUserID -password myPassword

    • Verwenden Sie für den RMI-Verbindungstyp die folgende Syntax:
      -conntype RMI [-host Hostname]
      [-port Portnummer] [-user Benutzer-ID] [-password Kennwort]

      Beispiel: -conntype RMI -host mycomputer.mycompany.com -port 2809 -user myUserID -password myPassword

    Tipp: Wenn Sie Argumente an Ihr Jython-Script übergeben möchten, geben Sie sie nicht in diesem Feld für wsadmin-Argumente an, da das Feld das Ziel für den wsadmin-Scripting-Client ist. Wählen Sie stattdessen die Seite Argumente aus und geben Sie im Textfeld Programmargumente Ihre Programmargumente an.
    Anmerkung: Wenn Sie die Programmargumente für die Ausführung Ihrer Jython-Scripts angeben müssen, beachten Sie, dass der erste Programmparameter beim Debugging für andere Zwecke verwendet wird als beim Ausführen der Jython-Scripts.
  7. Geben Sie im Abschnitt Sicherheit an, ob Ihr Script auf einem gesicherten Server ausgeführt wird, indem Sie eine der folgenden Optionen auswählen.
    Option Bezeichnung
    Keine Sicherheit auf Zielserver Gibt an, dass Ihr Script auf einem nicht gesicherten Server ausgeführt wird.
    Wie in der Datei soap.client.props oder sas.client.props definiert

    Gibt an, dass Ihr Script in einer gesicherten WebSphere Application Server-Instanz ausgeführt wird und Sie Authentifizierungsinformationen in den Dateien "sas.client.props" oder "soap.client.props" für die Kommunikation mit diesem gesicherten Server angegeben haben.

    Die Dateien "sas.client.props" und "soap.client.props" befinden sich im Eigenschaftsverzeichnis für die einzelnen WebSphere Application Server-Profile, z. B. x:/profilePath/properties.

    Wenn Sie einen RMI-Connector verwenden, legen Sie für die folgenden Eigenschaften in der Datei sas.client.props die entsprechenden Werte fest.

    com.ibm.CORBA.loginUserid=
    com.ibm.CORBA.loginPassword=
    Definieren Sie außerdem die folgende Eigenschaft:
    com.ibm.CORBA.loginSource=properties
    Der Standardwert für diese Eigenschaft ist prompt in der Datei "sas.client.props". Wenn Sie den Standardwert übernehmen, wird ein Dialogfenster mit einer Aufforderung zur Kennworteingabe angezeigt. Wird das Script unbeaufsichtigt ausgeführt, scheint es blockiert.
    Wenn Sie einen SOAP-Connector (Simple Object Access Protocol) verwenden, legen Sie entsprechende Werte für die folgenden Eigenschaften in der Datei "soap.client.props" fest:
    com.ibm.SOAP.securityEnabled=true
    com.ibm.SOAP.loginUserid=
    com.ibm.SOAP.loginPassword=
    Definieren Sie optional die folgende Eigenschaft:
    com.ibm.SOAP.loginSource=none
    Der Standardwert für diese Eigenschaft befindet sich in der Datei "soap.client.props". Wenn Sie den Standardwert akzeptieren und keine Werte für loginUserid und loginPassword angeben, wird ein Dialogfenster mit einer Aufforderung zur Kennworteingabe angezeigt. Wird das Script unbeaufsichtigt ausgeführt, scheint es blockiert.
    Anmerkung: Wenn Sie einen Benutzer und ein Kennwort im Abschnitt "Angeben" und in der Datei sas.client.props oder der Datei soap.client.props angeben, überschreibt das Startprogramm für Verwaltungsscripts von WebSphere Application Server die Informationen in der Datei .props.
    Angeben Gibt an, dass Ihr Script auf einem gesicherten Server ausgeführt wird.

    Geben Sie in den Feldern Benutzer-ID und Kennwort die Benutzer-ID und das Kennwort für die Authentifizierung bei diesem gesicherten Zielserver ein.

    Wenn Sie in diesem Abschnitt und in der Datei sas.client.props oder der Datei soap.client.props Benutzer-ID- und Kennwortinformationen angeben, überschreibt das Startprogramm für Verwaltungsscripts von WebSphere Application Server die Informationen in der Datei .props.

    Achtung: Die Verwendung des Felds Kennwort kann zu einem Sicherheitsrisiko führen, da die Kennwortinformationen für das Systemstatusprogramm sichtbar werden, z. B. für den Befehl ps, der von anderen Benutzern gestartet werden kann, um alle aktiven Prozesse anzuzeigen. Verwenden Sie diese Option nicht, wenn das Sicherheitsrisiko ein Problem darstellt. Wählen Sie stattdessen Wie in der Datei soap.client.props oder sas.client props definiert aus und geben Sie die Benutzer-ID- und Kennwortinformationen in der Datei soap.client.props für den SOAP-Connector bzw. in der Datei sas.client.props für den RMI-Connector an. Die Dateien soap.client.props und sas.client.props befinden sich im Eigenschaftsverzeichnis Ihres WebSphere Application Server-Profils.
  8. Klicken Sie auf Anwenden, um Ihre Konfiguration zu speichern. Die entsprechenden VM-Argumente und -Klassenpfade für Ihre ausgewählte WebSphere Application Server-Laufzeitumgebung werden automatisch angegeben.
    Tipp: Wenn Sie Ihre Auswahl für die Liste Laufzeitumgebung für die Scripterstellung ändern, klicken Sie für jede Änderung auf Anwenden, um automatisch die richtigen VM-Argumente und -Klassenpfade für Ihre neu ausgewählte WebSphere Application Server-Laufzeitumgebung anzugeben.
  9. Klicken Sie auf Ausführen, um Ihre Scriptdatei auszuführen.
Symbol das den Typ des Artikels anzeigt. Taskartikel
Nutzungsbedingungen für Information Center | Feedback

Symbol für Zeitmarke Letzte Aktualisierung: 29.04.2014

Dateiname: twsadminlauncher.html