Nützliche Verwaltungsscripts für WebSphere Application Server

Nützliche Shell-Skripte für IBM WebSphere Application Server

Bei der Installation von IBM WebSphere Application Server (WAS) wird eine beachtliche Anzahl von Shell-Skriptdateien, nämlich über 125, mitgeliefert.

Jedoch sind nicht alle dieser Skripte gleichermaßen nützlich. Gerade für Einsteiger ist es oft schwierig, die wirklich leistungsfähigen Skripte zu identifizieren, die die tägliche Arbeit erheblich erleichtern können.

Im Folgenden habe ich eine Auswahl der hilfreichsten Skripte zusammengestellt, um Ihnen als WebSphere-Administrator den Arbeitsalltag zu vereinfachen.

Diese Skripte wurden in einer IBM WAS ND 8.5.5-Umgebung getestet. Es sollte jedoch keinen Grund geben, warum sie nicht auch in anderen Umgebungen funktionieren sollten.

Deployment Manager, Node Agent und JVM stoppen und starten

stopManager.sh

Mit diesem Befehl können Sie den Deployment Manager anhalten.

  [[email protected] bin]# ./stopManager.sh
  ADMU0116I: Toolinformationen werden in der Datei protokolliert
  /opt/IBM/WebSphere/AppServer/profiles/Dmgr01/logs/dmgr/stopServer.log
  ADMU0128I: Starte Tool mit dem Profil Dmgr01
  ADMU3100I: Konfiguration für Server wird gelesen: dmgr
  ADMU3201I: Server-Stoppanforderung gesendet. Warte auf Stoppstatus.
  ADMU4000I: Server dmgr wurde gestoppt.
  [[email protected] bin]#
  

Hinweis: Dieses Skript muss im DMGR-Profilpfad ausgeführt werden.

startManager.sh

Verwenden Sie diesen Befehl, um den Deployment Manager zu starten.

  [[email protected] bin]# ./startManager.sh
  ADMU0116I: Toolinformationen werden in der Datei protokolliert
  /opt/IBM/WebSphere/AppServer/profiles/Dmgr01/logs/dmgr/startServer.log
  ADMU0128I: Starte Tool mit dem Profil Dmgr01
  ADMU3100I: Konfiguration für Server wird gelesen: dmgr
  ADMU3200I: Server gestartet. Warte auf Initialisierungsstatus.
  ADMU3000I: Server dmgr ist für E-Business geöffnet; Prozess-ID ist 9183
  [[email protected] bin]#
  

Hinweis: Dieses Skript muss im DMGR-Profilpfad ausgeführt werden.

startServer.sh

Um eine JVM zu starten, nutzen Sie startServer.sh mit dem entsprechenden Servernamen, wie im Folgenden gezeigt.

  [[email protected] bin]# ./startServer.sh server1
  ADMU0116I: Toolinformationen werden in der Datei protokolliert
  /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/server1/startServer.log
  ADMU0128I: Starte Tool mit dem Profil AppSrv01
  ADMU3100I: Konfiguration für Server wird gelesen: server1
  ADMU3200I: Server gestartet. Warte auf Initialisierungsstatus.
  ADMU3000I: Server server1 ist für E-Business geöffnet; Prozess-ID ist 10633
  [[email protected] bin]#
  

Hinweis: Der Node Agent muss gestartet sein, bevor eine JVM gestartet werden kann.

stopServer.sh

Um eine JVM herunterzufahren, führen Sie diesen Befehl zusammen mit dem JVM-Namen aus.

  [[email protected] bin]# ./stopServer.sh server1
  ADMU0116I: Toolinformationen werden in der Datei protokolliert
  /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/server1/stopServer.log
  ADMU0128I: Starte Tool mit dem Profil AppSrv01
  ADMU3100I: Konfiguration für Server wird gelesen: server1
  ADMU3201I: Server-Stoppanforderung gesendet. Warte auf Stoppstatus.
  ADMU4000I: Server server1 wurde gestoppt.
  [[email protected] bin]#
  

stopNode.sh

Um einen bestimmten Node Agent zu stoppen, navigieren Sie zu dessen Profil und führen Sie stopNode.sh aus.

  [[email protected] bin]# ./stopNode.sh
  ADMU0116I: Toolinformationen werden in der Datei protokolliert
  /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/nodeagent/stopServer.log
  ADMU0128I: Starte Tool mit dem Profil AppSrv01
  ADMU3100I: Konfiguration für Server wird gelesen: nodeagent
  ADMU3201I: Server-Stoppanforderung gesendet. Warte auf Stoppstatus.
  ADMU4000I: Server nodeagent wurde gestoppt.
  [[email protected] bin]#
  

startNode.sh

Navigieren Sie zum jeweiligen Profil und führen Sie startNode.sh aus, um den Node Agent zu starten.

  [[email protected] bin]# ./startNode.sh
  ADMU0116I: Toolinformationen werden in der Datei protokolliert
  /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/nodeagent/startServer.log
  ADMU0128I: Starte Tool mit dem Profil AppSrv01
  ADMU3100I: Konfiguration für Server wird gelesen: nodeagent
  ADMU3200I: Server gestartet. Warte auf Initialisierungsstatus.
  ADMU3000I: Server nodeagent ist für E-Business geöffnet; Prozess-ID ist 11363
  [[email protected] bin]#
  

serverStatus.sh

Um den Status der JVM zu ermitteln, verwenden Sie dieses Skript mit dem Argument -all.

Dieses Skript muss in der jeweiligen Profilebene ausgeführt werden. Bei der Ausführung auf DMGR-Profilebene wird nur der Status des DMGR angezeigt.

  [[email protected] bin]# ./serverStatus.sh -all
  ADMU0116I: Toolinformationen werden in der Datei protokolliert
  /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/serverStatus.log
  ADMU0128I: Starte Tool mit dem Profil AppSrv01
  ADMU0503I: Rufe Serverstatus für alle Server ab
  ADMU0505I: Server in der Konfiguration gefunden:
  ADMU0506I: Servername: nodeagent
  ADMU0506I: Servername: server1
  ADMU0508I: Der Node Agent "nodeagent" ist GESTARTET
  ADMU0508I: Der Anwendungsserver "server1" ist GESTARTET
  [[email protected] bin]#
  

Backup und Wiederherstellung

backupConfig.sh

Eine der wichtigsten Lektionen im Produktionssupport ist die Erstellung von Backups. Wenn alles schiefgeht, kann ein Backup helfen.

Mit diesem Skript können Sie eine Sicherung Ihrer WebSphere-Umgebungskonfiguration erstellen. Als bewährte Methode wird das Argument -nostop empfohlen, damit das Backup ohne Anhalten des Deployment Managers erstellt wird.

  [[email protected] bin]# ./backupConfig.sh -nostop
  ADMU0116I: Toolinformationen werden in der Datei protokolliert
  /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/backupConfig.log
  ADMU0128I: Starte Tool mit dem Profil AppSrv01
  ADMU5001I: Konfigurationsverzeichnis sichern
  /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config in Datei
  /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin/WebSphereConfig_2015-04-12.zip
  ....................................................................................................................................................................................................................................................................
  ADMU5002I: 933 Dateien erfolgreich gesichert
  [[email protected] bin]#
  

restoreConfig.sh

Wenn Sie Änderungen an der Konfiguration vorgenommen haben und etwas nicht wie erwartet funktioniert, ist es an der Zeit, die Konfiguration wiederherzustellen. Verwenden Sie dazu die Sicherungsdatei.

  [[email protected] bin]# ./restoreConfig.sh WebSphereConfig_2015-04-12.zip -nostop
  ADMU0116I: Toolinformationen werden in der Datei protokolliert
  /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/restoreConfig.log
  ADMU0128I: Starte Tool mit dem Profil AppSrv01
  ADMU5502I: Das Verzeichnis /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config
  existiert bereits; umbenennen in
  /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config.old
  ADMU5504I: Speicherort der Wiederherstellung erfolgreich umbenannt
  ADMU5505I: Datei WebSphereConfig_2015-04-12.zip an Speicherort wiederherstellen
  /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config
  .........................................................................................................................................................................
  ADMU5506I: 933 Dateien erfolgreich wiederhergestellt
  ADMU6001I: App-Vorbereitung starten -
  ADMU6009I: Verarbeitung abgeschlossen.
  ADMU6002I: Asset-Vorbereitung starten -
  ADMU6009I: Verarbeitung abgeschlossen.
  [[email protected] bin]#
  

Gefällt es Ihnen bisher? Lesen Sie weiter für mehr!

Informationen zu Version und Fixpacks abrufen

versionInfo.sh

Dieses Skript zeigt Ihnen die WAS-Version, den Build-Level, das Paket, die Architektur und die installierten Features, die auf Ihrem Server installiert sind.

    [[email protected] bin]# ./versionInfo.sh
    WVER0010I: Copyright (c) IBM Corporation 2002, 2012; Alle Rechte vorbehalten.
    WVER0012I: VersionInfo Reporter Version 1.15.1.48, datiert 2/8/12
    --------------------------------------------------------------------------------
    IBM WebSphere Produktinstallationsstatusbericht
    --------------------------------------------------------------------------------
    Bericht vom Datum und der Uhrzeit 12. April 2015 3:18:41 AM PDT
    Installation
    --------------------------------------------------------------------------------
    Produktverzeichnis       /opt/IBM/WebSphere/AppServer
    Versionsverzeichnis       /opt/IBM/WebSphere/AppServer/properties/version
    DTD-Verzeichnis           /opt/IBM/WebSphere/AppServer/properties/version/dtd
    Protokollverzeichnis       /var/ibm/InstallationManager/logs
    Produktliste
    --------------------------------------------------------------------------------
    NDTRIAL                 installiert
    Installiertes Produkt
    --------------------------------------------------------------------------------
    Name                 IBM WebSphere Application Server Network Deployment
    Version               8.5.5.0
    ID                   NDTRIAL
    Build-Level           gm1319.01
    Build-Datum           14.05.13
    Paket               com.ibm.websphere.NDTRIAL.v85_8.5.5000.20130514_1044
    Architektur         x86-64 (64 Bit)
    Installierte Features   IBM 64-Bit WebSphere SDK für Java
    WebSphere Application Server Full Profile
    EJBDeploy-Tool für Pre-EJB 3.0-Module
    Einbettbarer EJB-Container
    Eigenständige Thin Clients und Ressourcenadapter
    --------------------------------------------------------------------------------
    Ende des Installationsstatusberichts
    --------------------------------------------------------------------------------
    [[email protected] bin]#
  

Hinweis: Folgende Argumente sind möglicherweise von Interesse:

  • -fixpacks: Zeigt Informationen zu Fixpacks an
  • -long: Zeigt alle Fixpacks und Fixes an
  • -ifixes: Um Informationen zu ifixes anzuzeigen

getHistoryReport.sh

Für Audits oder um eine Liste von Komponenten, Fixes oder Refresh Packs mit Daten zu erstellen, können Sie diesen Befehl verwenden. Er erzeugt die Datei historyReport.html im aktuellen Arbeitsverzeichnis (normalerweise der Ordner bin).

getVersionReport.sh

Dieses Skript zeigt die Build-Version und das Build-Datum der WebSphere-Installation an. Dies wird oft vom IBM Support angefordert, um zu untersuchen, ob ein Problem in einer bestimmten Version auftritt.

Cache leeren

Es gibt verschiedene Gründe, den Cache zu leeren. Der häufigste ist nach einem Upgrade. Es gibt zwei Caches, die Sie leeren sollten: 1) JVM 2) OSGi.

clearClassCache.sh

Um den Klassencache der JVM zu leeren, führen Sie dieses Skript aus.

Hinweis: JVMs müssen angehalten werden, bevor der Klassencache gelöscht wird.

osgiCfgInit.sh

Verwenden Sie diesen Befehl, um das OSGi-Profil und den Servercache zu leeren.

  [[email protected] bin]# ./osgiCfgInit.sh
  OSGi-Profilcache erfolgreich bereinigt für /opt/IBM/WebSphere/AppServer/profiles/Dmgr01.
  OSGi-Servercache erfolgreich bereinigt für /opt/IBM/WebSphere/AppServer/profiles/Dmgr01/servers/dmgr.
  [[email protected] bin]#
  

Hinweis: Vergessen Sie nicht, laufende Prozesse zu stoppen, bevor Sie die Caches leeren.

Profile verwalten

managesdk.sh

Wenn Sie mehrere SDKs installiert haben, können Sie die Version wechseln. Sie können dieses Skript auch nutzen, um das verfügbare SDK für Ihr Profil zu finden. Das folgende Beispiel zeigt eine Liste der verfügbaren SDKs.

      [[email protected] bin]# ./managesdk.sh -listAvailable
      CWSDK1003I: Verfügbare SDKs:
      CWSDK1005I: SDK-Name: 1.6_64
      CWSDK1001I: Die angeforderte managesdk-Aufgabe wurde erfolgreich ausgeführt.
      [[email protected] bin]#
      

pmt.sh

PMT (Profile Management Tool) kann verwendet werden, um WebSphere-Profile im GUI-Modus zu erstellen. Das Erstellen von Profilen mit PMT ist sehr einfach – wählen Sie einfach die gewünschte Profilebene und folgen Sie dem Assistenten. Probieren Sie es aus!

syncNode.sh

Wenn Sie die Knotensynchronisation nicht über die Administrationskonsole durchführen können, können Sie syncNode.sh auf Profilebene verwenden. Der Node Agent muss vor der Verwendung dieses Skripts angehalten werden.

Sie müssen ein Argument für den DMGR-Host und die SOAP-Portnummer übergeben.

    [[email protected] bin]# ./syncNode.sh localhost 8879
    ADMU0116I: Toolinformationen werden in der Datei protokolliert
    /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/syncNode.log
    ADMU0128I: Starte Tool mit dem Profil AppSrv01
    ADMU0401I: Starte syncNode-Operation für Knoten localhostNode01 mit Deployment
    Manager localhost: 8879
    ADMU0016I: Konfiguration zwischen Knoten und Zelle synchronisieren.
    ADMU0402I: Die Konfiguration für Knoten localhostNode01 wurde synchronisiert
    mit Deployment Manager localhost: 8879
    [[email protected] bin]#
  
  • localhost = Deployment Manager-Hostname
  • 8879 = DMGR SOAP-Portnummer

Ich hoffe, diese Skripte sind hilfreich für Ihre tägliche Arbeit. Bringen Sie Ihre Karriere auf die nächste Stufe, indem Sie sich mit Cloud Computing beschäftigen.