Kompositionseinheiten mit wsadmin-Scripting verwalten
Verwenden Sie die Befehle in der Befehlsgruppe "BLAManagement", um Kompositionseinheiten zu verwalten. Verwenden Sie die Beispiele in diesem Artikel, um Kompositionseinheiten hinzuzufügen, zu entfernen, zu bearbeiten, zu exportieren und anzuzeigen.
Vorbereitende Schritte
Es gibt zwei Möglichkeiten zur Ausführung der Beispiele dieser Task. Sie können die Befehlsgruppe "BLAManagement" für das Objekt "AdminTask" verwenden, um Kompositionseinheiten zu verwalten. Alternativ können Sie die Scripts in der Scriptbibliothek "AdminBLA" für die Verwaltung Ihrer Kompositionseinheitenkonfigurationen verwenden.
Informationen zu diesem Vorgang
Kompositionseinheiten können implementierte Assets, andere Geschäftsanwendungen oder externe Artefakte darstellen, die in der Laufzeitumgebung von WebSphere Application Server oder in anderen Laufzeitumgebungen ohne zugeordnete Assets implementiert sind. Geschäftsanwendungen enthalten keine oder mehrere Kompositionseinheiten. Es ist nicht möglich, eine Kompositionseinheit mehreren Geschäftsanwendungen hinzuzufügen, aber Sie können ein einziges Asset verwenden, um mehrere Kompositionseinheiten zu erstellen.
Vorgehensweise
- Fügen Sie Kompositionseinheiten hinzu.
- Starten Sie das wsadmin-Scripting-Tool.
- Fügen Sie Kompositionseinheiten hinzu. Verwenden Sie den Befehl "addCompUnit", um Geschäftsanwendungen Kompositionseinheiten hinzuzufügen.Anmerkung: Wenn das Asset ein EBA-Asset (Enterprise Bundle Archive, Unternehmens-Bundle-Archiv) ist, müssen noch weitere Parameter gesetzt werden.Verwenden Sie den folgenden Beispielbefehl, um das Asset asset1 als Kompositionseinheit in der Geschäftsanwendung myBLA hinzuzufügen und die Implementierung dem Server server1 zuzuordnen:
AdminTask.addCompUnit('-blaID myBLA – cuSourceID asset1 -CUOptions [[.* .* compositionUnit1 "composition unit that is backed by asset1" 0]] -MapTargets [[.* server1]] –ActivationPlanOptions [.* specname=actplan0+specname=actplan1]')
Verwenden Sie den folgenden Beispielbefehl, um das Asset asset2 als Kompositionseinheit in der Geschäftsanwendung myBLA hinzuzufügen und die Implementierung den Servern server1 und testServer zuzuordnen:AdminTask.addCompUnit('-blaID myBLA – cuSourceID asset2 -CUOptions [[.* .* compositionUnit2 "composition unit that is backed by asset2" 0]] -MapTargets [[.* server1+testServer]] –ActivationPlanOptions [.* specname=actplan0+specname=actplan1]')
Verwenden Sie den folgenden Beispielbefehl, um das Asset J2EEAsset als Kompositionseinheit in der Geschäftsanwendung myBLA hinzuzufügen und die Implementierung den Servern server1 und testServer zuzuordnen:AdminTask.addCompUnit('[-blaID myBLA – cuSourceID J2EEAsset –defaultBindingOptions defaultbinding.ejbjndi.prefix=ejb# defaultbinding.virtual.host=default_host# defaultbinding.force=yes – AppDeploymentOptions [-appname defaultapp -installed.ear.destination application_root/myCell/defaultapp.ear] –MapModulesToServers [[defaultapp.war .* WebSphere:cell=cellName,node=nodeName,server=server1][Increment.jar .* Websphere:cell=cellName,node=nodeName,server=testServer]] -CtxRootForWebMod [[defaultapp.war .* myctx/]]]')
Wenn Sie eine Kompositionseinheit bearbeiten, um eine gemeinsam genutzte Bibliothek zu aktualisieren, müssen Sie zuerst alle Java EE-Anwendungen, die von dieser gemeinsam genutzten Bibliothek abhängig sind, manuell stoppen. Starten Sie die Java EE-Anwendungen nach dem Aktualisieren der gemeinsam genutzten Bibliothek erneut. Java EE-Anwendungen werden nicht automatisch erneut gestartet, wenn eine gemeinsam genutzte Bibliothek aktualisiert wird.
Der Befehl gibt, wie im folgenden Beispiel gezeigt, die Konfigurations-IDs der Kompositionseinheit und der neuen Kompositionseinheit zurück, die für das Asset in der Assetbeziehung erstellt wurde:WebSphere:cuname=compositionUnit1 WebSphere:cuname=compositionUnit2 WebSphere:cuname=J2EEAsset
- Sichern Sie die Konfigurationsänderungen. Verwenden Sie den folgenden Beispielbefehl, um Ihre Konfigurationsänderungen zu speichern:
AdminConfig.save()
- Zeigen Sie Kompositionseinheiten und Konfigurationseinstellungen an.
Verwenden Sie die Befehle "listCompUnits" und "viewCompUnits", um die Konfigurations-IDs der Kompositionseinheiten anzuzeigen, die einem bestimmten Suchbereich entsprechen.
Mit dem Befehl "listCompUnits" können Sie alle Kompositionseinheiten in Ihrer Konfiguration oder in einer bestimmten Geschäftsanwendung anzeigen. Der folgende Beispielbefehl zeigt alle Kompositionseinheiten in der Geschäftsanwendung myBLA an:AdminTask.listCompUnits('-blaID blaname=myBLA')
Der Befehl gibt, wie im folgenden Beispiel gezeigt, die Konfigurations-IDs und den Typ des Sicherungsassets aller Kompositionseinheiten zurück, die dem Suchbereich entsprechen:Websphere:cuname=cu1 asset Websphere:cuname=cu4 bla WebSphere:cuname=defaultapp __j2ee
Mit dem Befehl "viewCompUnits" können Sie weitere Konfigurationsdaten zu einer bestimmten Kompositionseinheit einer Geschäftsanwendung anzeigen. Der folgende Beispielbefehl zeigt zusätzliche Informationen zur Kompositionseinheit cu1 für die Geschäftsanwendung myBLA an:AdminTask.viewCompUnit('-blaID myBLA -cuID cu1')
Der Befehl gibt ausführliche Konfigurationsdaten für die Kompositionseinheit zurück, wie das folgende Beispiel zeigt:Specify Composition Unit options (CUOptions) Specify name, description options for Composition Unit. Parent BLA (parentBLA): [WebSphere:blaname=myBLA] Backing Id (backingId): [WebSphere:assetname=asset1.zip] Name (name): [cu1] Description (description): [my description of cu1 composition unit] Starting Weight (startingWeight): [0] Specify servers (MapTargets) Specify targets such as application servers or clusters of application servers where you want to deploy the composition unit contained in the application. Deployable Unit (deplUnit): [default] *Servers (server): [WebSphere:node=myNode,server=server1] Specify Composition Unit activation plan options (ActivationPlanOptions) Specify composition unit activation plan optionsDeployableUnit Name (deplUnit): [default] Activation Plan (activationPlan): [WebSphere:specname=actplan0+WebSphere:specname=actplan1]
Wenn eine Kompositionseinheit ein EBA-Asset (Enterprise Bundle Archive, Unternehmens-Bundle-Archiv) enthält, wird der Status der Kompositionseinheit auch angezeigt. Die gültigen Statuswerte sind im Folgenden beschrieben:- Es wird die neueste OSGi-Anwendungsimplementierung verwendet.
- Es ist noch keine neue OSGi-Anwendungsimplementierung verfügbar, weil die Implementierung Bundles voraussetzt, deren Download noch nicht abgeschlossen ist.
- Die neue OSGi-Anwendungsimplementierung ist verfügbar.
- Die neue OSGi-Anwendungsimplementierung kann nicht angewendet werden, weil Bundle-Downloads fehlgeschlagen sind.
- Bearbeiten Sie Kompositionseinheiten.
- Starten Sie das wsadmin-Scripting-Tool.
- Ändern Sie die Kompositionseinheit. Verwenden Sie den Befehl "editCompUnit", um Optionen für die Kompositionseinheit zu ändern. Sie können diesen Befehl verwenden, um die Anfangswertigkeit der Kompositionseinheit, Implementierungsziele, Optionen für den Aktivierungsplan und Beziehungseinstellungen zu ändern. Beschreibungen der einzelnen Optionen, die Sie ändern können, finden Sie in der Dokumentation zur Befehlsgruppe "BLAManagement" für das Objekt "AdminTask".Anmerkung: Wenn die Kompositionseinheit ein EBA-Asset enthält, können Sie weitere Parameter ändern.Der folgende Beispielbefehl bearbeitet eine Kompositionseinheit, der ein Asset zugeordnet ist, und ersetzt das Implementierungsziel:
AdminTask.editCompUnit('-blaID myBLA – cuID cu1 – CUOptions [[.* .* cu1 cudesc 1]] -MapTargets [[.* server2]] -ActivationPlanOptions [.* #specname=actplan0+specname=actplan2]')
Der Befehl gibt die Konfigurations-ID der Kompositionseinheit zurück, die das System bearbeitet, wie das folgende Beispiel zeigt:WebSphere:cuname=cu1
- Sichern Sie die Konfigurationsänderungen. Verwenden Sie den folgenden Beispielbefehl, um Ihre Konfigurationsänderungen zu speichern:
AdminConfig.save()
- Entfernen Sie Kompositionseinheiten.
- Starten Sie das wsadmin-Scripting-Tool.
- Entfernen Sie Kompositionseinheiten. Verwenden Sie den Befehl "deleteCompUnit", um eine Kompositionseinheit zu entfernen. Beide Parameter für den folgenden Befehl akzeptieren unvollständige Konfigurations-IDs, sofern das System die Zeichenfolge einer eindeutigen ID zuordnen kann:
AdminTask.deleteCompUnit('-blaID myBLA – cuID cu1')
Der Befehl gibt, wie im folgenden Beispiel gezeigt, die Konfigurations-ID der Kompositionseinheit zurück, die vom System gelöscht wird:WebSphere:cuname=cu1
- Sichern Sie die Konfigurationsänderungen. Verwenden Sie den folgenden Beispielbefehl, um Ihre Konfigurationsänderungen zu speichern:
AdminConfig.save()


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_7managecu
Dateiname:txml_7managecu.html