Optionen für die Befehle "object install", "installInteractive", "edit", "editInteractive", "update" und "updateInteractive" des Objekts "AdminApp" mit wsadmin-Scripting

ActSpecJNDI

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen Daten für Zeilen oder Einträge angeben, für die Informationen fehlen oder die aktualisiert werden müssen.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install $embeddedEar {-ActSpecJNDI
 {{"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml javax.jms.MessageListener jndi5}
 {"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml javax.jms.MessageListener2 jndi6}}} 

$AdminApp install $embeddedEar {-ActSpecJNDI
 {{.* .*.rar,.* javax.jms.MessageListener jndi5}
 {.*  .*.rar,.*  javax.jms.MessageListener2 jndi6}}} 

AdminApp.install(embeddedEar, ['-ActSpecJNDI',
 [["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageListener', 'jndi5'],
 ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageListener2', 'jndi6']]]) 

AdminApp.install(embeddedEar, ['-ActSpecJNDI',
 [['.*', '.*.rar,.*', 'javax.jms.MessageListener', 'jndi5'],
 ['.*', '.*.rar,.*', 'javax.jms.MessageListener2', 'jndi6']]]) 

allowDispatchRemoteInclude

Der allowDispatchRemoteInclude ermöglicht es einer Unternehmensanwendung, Includes über den standardmäßigen Anforderungsdispatchermechanismus an Ressourcen in Webmodulen zu verteilen, die sich in verschiedenen Java-Virtual-Machines in einer verwalteten Knotenumgebung befinden.

Verwendungsbeispiel für den Stapelmodus

set deployments [$AdminConfig getid /Deployment:RRDEnabledAppname/]
set deploymentObject [$AdminConfig showAttribute $deployments deployedObject]
set rrdAttr [list allowDispatchRemoteInclude true]
set attrs [list $rrdLocalAttr]
$AdminConfig modify $deploymentObject $attrs

deployments = AdminConfig.getid ('/Deployment:RRDEnabledAppname/')
deploymentObject = AdminConfig.showAttribute (deployments, 'deployedObject')
rrdAttr = ['allowDispatchRemoteInclude', 'true']
attrs = [rrdLocalAttr]
AdminConfig.modify (deploymentObject, attrs)

allowPermInFilterPolicy

Die Option allowPermInFilterPolicy gibt an, dass der Anwendungsserver mit dem Anwendungsbereitstellungsprozess fortfahren soll, auch wenn die Anwendung Richtlinienberechtigungen enthält, die in der Filterrichtlinie enthalten sind. Für diese Option ist kein Wert erforderlich.

allowServiceRemoteInclude

Die Option allowServiceRemoteInclude ermöglicht es einer Unternehmensanwendung, eine Include-Anfrage von einer Unternehmensanwendung zu bedienen, bei der die Option allowDispatchRemoteInclude auf true gesetzt ist.

Verwendungsbeispiel für den Stapelmodus

set deployments [$AdminConfig getid /Deployment:RRDEnabledAppname/]
set deploymentObject [$AdminConfig showAttribute $deployments deployedObject]
set rrdAttr [list allowServiceRemoteInclude true]
set attrs [list $rrdAttr]
$AdminConfig modify $deploymentObject $attrs

deployments = AdminConfig.getid ('/Deployment:RRDEnabledAppname/')
deploymentObject = AdminConfig.showAttribute ('deployments', 'deployedObject')
rrdAttr = ['allowServiceRemoteInclude', 'true']
attrs = [rrdAttr] 
AdminConfig.modify (deploymentObject, attrs) 

App-Name

Die Option appname gibt den Namen der Anwendung an. Standardmäßig ist der Anzeigename der Anwendung angegeben.

asyncRequestDispatchType

Gibt den asynchronen Anfragetyp für einen Webcontainer für jede Anwendung an. Die Standardeinstellung ist DISABLED. Weitere Informationen finden Sie unter Einstellungen für asynchrones Dispatching von Anfragen.

BackendIdSelection

Die Option BackendIdSelection gibt die Backend-ID für die Java-Archiv (JAR)-Module der Enterprise Beans an, die über CMP-Beans (container-managed persistence) verfügen. Ein JAR-Modul der Enterprise-Bean kann mehrere Back-End-Konfigurationen wie angegeben mit einem Tool für Anwendungsassemblierung unterstützen. Mit dieser Option können Sie die Back-End-ID während der Installation ändern.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install myapp.ear {-BackendIdSelection 
 {{Annuity20EJB Annuity20EJB.jar,META-INF/ejb-jar.xml DB2UDBNT_V72_1}}} 

$AdminApp install myapp.ear {-BackendIdSelection 
 {{.* Annuity20EJB.jar,.* DB2UDBNT_V72_1}}} 

AdminApp.install('myapp.ear', '[-BackendIdSelection 
 [[Annuity20EJB Annuity20EJB.jar,META-INF/ejb-jar.xml DB2UDBNT_V72_1]]]')

AdminApp.install('myapp.ear', ['-BackendIdSelection',
 [['.*', 'Annuity20EJB.jar,.*', 'DB2UDBNT_V72_1']]])

BindJndiForEJBBusiness

Die Option BindJndiForEJBBusiness bindet EJB-Module mit Geschäftsschnittstellen an JNDI-Namen. Stellen Sie sicher, dass jedes EJB-Modul mit Geschäftsschnittstellen an einen JNDI-Namen gebunden wird.

Wenn Sie den JNDI-Namen der Zielressource mit der Option BindJndiForEJBNonMessageBinding angeben, geben Sie in der Option BindJndiForEJBBusiness keinen JNDI-Namen für eine Geschäftsschnittstelle an. Wenn Sie den JNDI-Namen der Zielressource nicht angeben, können Sie den JNDI-Namen einer Geschäftsschnittstelle angeben. Wenn Sie keinen JNDI-Namen für die Geschäftsschnittstelle angeben, stellt die Laufzeitumgebung einen Standardwert für den Container bereit.

Für eine Ansicht, die keine Schnittstellenansicht ist, ist der Geschäftsschnittstellenwert eine leere Zeichenfolge ("").

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen Daten für Zeilen oder Einträge angeben, für die Informationen fehlen oder die aktualisiert werden müssen.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install $ear {-BindJndiForEJBBusiness {{ ejb_1.jar ejb1 
  ejb_1.jar,META-INF/ejb-jar.xml test.ejb1 jndi1 }}}

$AdminApp install $ear {-BindJndiForEJBBusiness {{ .* .* .*.jar,.* test.ejb1 jndi1 }}}

AdminApp.install(ear, '[-BindJndiForEJBBusiness [[ejb_1.jar ejb1 
  ejb_1.jar,META-INF/ejb-jar.xml test.ejb1 jndi1 ]]]')

AdminApp.install(ear, '[-BindJndiForEJBBusiness [[.* .* .*.jar,.* test.ejb1 jndi1]]]')

BindJndiForEJBMessageBinding

Die Option BindJndiForEJBMessageBinding bindet nachrichtengesteuerte Enterprise Beans an Listener-Port-Namen oder an die Aktivierungsspezifikation Java Naming and Directory Interface (JNDI)-Namen. Verwenden Sie diese Option, um fehlende Daten anzugeben oder eine Task zu aktualisieren. Wenn Sie eine MDB an den JNDI-Namen einer Aktivierungsspezifikation binden, können Sie auch den JNDI-Namen des Ziels und den Authentifizierungsalias angeben.

Jedes Element der Option BindJndiForEJBMessageBinding besteht aus den folgenden Feldern: EJBModule, EJB, uri, listenerPort, JNDI, jndi.dest und actspec.auth. Einigen dieser Felder können Werte zugewiesen werden: listenerPort, JNDI, jndi.dest, Und actspec.auth.

Wenn keine Aktivierungskonfigurationseigenschaft des Typs "destinationLookup" als Annotation oder im Implementierungsdeskriptor angegeben ist und wenn in der IBM Bindungsdatei kein JNDI-Name des Ziels enthalten ist, dann wird der Standard-JNDI-Name des Ziels aus der zugehörigen Nachrichtenreferenz verwendet.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen Daten für Zeilen oder Einträge angeben, für die Informationen fehlen oder die aktualisiert werden müssen.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install $ear {-BindJndiForEJBMessageBinding {{Ejb1 MessageBean 
 ejb-jar-ic.jar,META-INF/ejb-jar.xml myListenerPort jndi1 jndiDest1 actSpecAuth1}}} 

$AdminApp install $ear {-BindJndiForEJBMessageBinding {{.*  .*
  .*.jar,.* myListenerPort jndi1 jndiDest1 actSpecAuth1}}}

AdminApp.install( ear, ['-BindJndiForEJBMessageBinding',
 [['Ejb1', 'MessageBean', 'ejb-jar-ic.jar,META-INF/ejb-jar.xml', 'myListenerPort',
 'jndi1', 'jndiDest1', 'actSpecAuth1']]]) 

AdminApp.install( ear, ['-BindJndiForEJBMessageBinding',
 [['.*', '.*', '.*.jar,.*', 'myListenerPort', 'jndi1', 'jndiDest1', 'actSpecAuth1']]])

BindJndiForEJBNonMessageBinding

Die Option BindJndiForEJBNonMessageBinding bindet Enterprise Beans an Java Naming and Directory Interface (JNDI) Namen. Vergewissern Sie sich, dass jede nicht nachrichtengesteuerte Enterprise-Bean in der Anwendung oder im Modul an den Namen eines Listener-Port gebunden ist. Verwenden Sie diese Option, um fehlende Daten anzugeben oder eine Task zu aktualisieren.

Für Enterprise JavaBeans (EJB) 3.0 und spätere Module gelten besondere Einschränkungen. Wenn Sie den JNDI-Namen der Zielressource angegeben, dürfen Sie die JNDI-Namen der lokalen und fernen Home-Schnittstellen nicht angeben. Sie können auch nicht das Feld JNDI für Geschäftsschnittstellen in der Option BindJndiForEJBBusiness angeben. Wenn Sie den JNDI-Namen der Zielressource nicht angeben, sind die Felder für die JNDI-Namen der lokalen und fernen Home-Schnittstellen optional. Wenn Sie keine JNDI-Namen für die lokalen und fernen Home-Schnittstellen angeben, stellt die Laufzeitumgebung Standardwerte für den Container bereit.

Wenn Sie keine Module der EJB Version 3.0 verwenden, müssen Sie den JNDI-Namen der Zielressource angeben.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen Daten für Zeilen oder Einträge angeben, für die Informationen fehlen oder die aktualisiert werden müssen.

Verwendungsbeispiel für den Stapelmodus

Mit Jacl:

$AdminApp install c:/myapp.ear {-BindJndiForEJBNonMessageBinding {{Ejb1 MessageBean 
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC ""  ""}}}

$AdminApp install /myapp.ear {-BindJndiForEJBNonMessageBinding {{Ejb1 MessageBean 
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC ""  ""}}}

$AdminApp install app_server_rootapps/myapps/installableApps/JobbankTargetEJBApp.ear
 {-BindJndiForEJBNonMessageBinding {{.* .* ResumeBankAppEJB.jar,META-INF/ejb-jar.xml
 ejb/com/app/ResumeBank/ResumeBank "" "" }}}

Mit Jython:

AdminApp.install('C:/myapp.ear', '[-BindJndiForEJBNonMessageBinding [[Ejb1 MessageBean
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC "" ""]]]')

AdminApp.install('myapp.ear', '[-BindJndiForEJBNonMessageBinding [[Ejb1 MessageBean 
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC "" ""]]]')

AdminApp.install('app_server_root/apps/myapps/installableApps/JobbankTargetEJBApp.ear',
 '[ -BindJndiForEJBNonMessageBinding [[ .* .* ResumeBankAppEJB.jar,META-INF/ejb-jar.xml
 ejb/com/app/ResumeBank/ResumeBank "" "" ]] ]' )

blaname

Verwenden Sie die Option blaname , um den Namen der Business-Level-Anwendung anzugeben, unter der das System die Anwendung Java EE erstellt. Diese Option ist optional. Wenn Sie keinen Wert angeben, legt das System den Namen der Geschäftsanwendung als Namen für die Java EE-Anwendung fest. Diese Option ist nur mit dem Befehl install verfügbar.

buildVersion

Die Option buildVersion zeigt die Build-Version einer EAR-Datei einer Anwendung an. Sie können diese Option nicht ändern, weil sie schreibgeschützt ist. Diese Option gibt Informationen zur Build-Version für die EAR-Datei einer Anwendung zurück, wenn Sie die Build-Version in der Datei MANIFEST.MF der Anwendung angegeben haben.

cell

Die Option cell gibt den Zellennamen an, um eine ganze Anwendung zu installieren oder zu aktualisieren, oder um eine Anwendung zu aktualisieren, um ein neues Modul hinzuzufügen. Wenn Sie eine vollständige Anwendung aktualisieren möchten, ist diese Option nur gültig, wenn die Anwendung ein neues Modul enthält, das in der installierten Anwendung noch nicht vorhanden ist.

Verwendungsbeispiel für den Stapelmodus

Mit Jacl:

$AdminApp install "C:/apps/myapps/installableApps/JobbankTargetEJBApp.ear" {-cell cellName}

$AdminApp install "/apps/myapps/installableApps/JobbankTargetEJBApp.ear" {-cell cellName}

Mit Jython:

AdminApp.install('C:/apps/myapps/installableApps/JobbankTargetEJBApp.ear', '[-cell cellName]')

AdminApp.install('/apps/myapps/installableApps/JobbankTargetEJBApp.ear', '[-cell cellName]')

clientMode

Die Option clientMode gibt an, ob Client-Module auf einem isolierten Bereitstellungsziel (isolated), einem Verbundknoten eines Bereitstellungsmanagers (federated) oder einem Anwendungsserver (server_deployed) bereitgestellt werden sollen. Wenn Sie diese Option angeben, installieren Sie die Client-Module nur auf einem Bereitstellungsziel der Version 8.0 oder höher.

Der Standardwert ist isolated.

Die Auswahl des Clientimplementierungsmodus wirkt sich darauf aus, wie java: -Suchvorgänge verarbeitet werden. Alle URL (global, anwendungsbezogen, modulbezogen und komponentenbezogen) sind in isolierten Client-Prozessen lokal. Die Namensbereiche befinden sich auf einem Server in föderierten und serverimplementierten Clientprozessen. Der als Ziel für ein Clientmodul ausgewählte Server legt fest, wo diese Namespaces erstellt werden. Alle java: -Suchen für föderierte oder serverimplementierte Clientmodule werden an den Zielserver übertragen. Das Clientmodul wird im Zielserver nicht ausgeführt. Wenn es mehrere Instanzen desselben Clientmoduls gibt, verwenden alle Instanzen in den Implementierungsmodi "federated" und "server_deployed" den Komponentennamespace. Die Auswahl des Modus "federated" ist lediglich die Erklärung der Absicht, dass das Clientmodul mit Java Network Launching Protocol (JNLP) gestartet werden soll, während die JNDI-Funktionsweise (Java Naming and Directory Interface) der Modi "federated" und "server_deployed" dieselbe bleibt.

contents

Die Option contents gibt die Datei an, die den zu aktualisierenden Inhalt enthält. Je nach Inhaltstyp kann die Datei eine EAR-Datei, ein Modul, eine partielle ZIP-Datei oder eine einzelne Datei sein. Der Pfad zur Datei muss hinsichtlich des Scripting-Client lokal sein. Die Option contents ist erforderlich, es sei denn, die Option delete ist angegeben.

contenturi

Die Option contenturi gibt den URI der Datei an, die Sie einer Anwendung hinzufügen, aktualisieren oder aus ihr entfernen. Diese Option gilt nur für den Befehl update. Die Option contenturi ist erforderlich, wenn der Inhaltstyp file oder modulefile angegeben ist. Diese Option wird für andere Inhaltstypen ignoriert.

contextroot

Die Option contextroot gibt das Kontext-Root an, das Sie bei der Installation einer eigenständigen WAR-Datei (Web Application Archive) verwenden.

CorrectOracleIsolationLevel

Die Option CorrectOracleIsolationLevel gibt den Isolationsgrad für den Anbieter des Typs Oracle an. Verwenden Sie diese Option, um fehlende Daten anzugeben oder eine Task zu aktualisieren. Das letzte Feld des jeweiligen Eintrags gibt die Isolationsstufe an. Gültige Werte für Isolationsstufen sind 2 und 4.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen nur die Daten für Zeilen oder Einträge angeben, für die Informationen fehlen oder die aktualisiert werden müssen.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install myapp.ear {-CorrectOracleIsolationLevel
 {{AsyncSender jms/MyQueueConnectionFactory jms/Resource1 2}}

$AdminApp install myapp.ear {-CorrectOracleIsolationLevel
  {{.*  jms/MyQueueConnectionFactory jms/Resource1 2}}

AdminApp.install('myapp.ear', '[-CorrectOracleIsolationLevel
 [[AsyncSender jms/MyQueueConnectionFactory jms/Resource1 2]]]')

AdminApp.install('myapp.ear', ['-CorrectOracleIsolationLevel',
 [['.*', 'jms/MyQueueConnectionFactory', 'jms/Resource1', 2]]])

CorrectUseSystemIdentity

Die Option CorrectUseSystemIdentity ersetzt RunAs System durch RunAs Rollen. Die Enterprise-Beans, die Sie installieren, enthalten eine RunAs-Systemidentität. Sie können diese ID in eine RunAs-Rolle ändern. Verwenden Sie diese Option, um fehlende Daten anzugeben oder eine Task zu aktualisieren.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen Daten für Zeilen oder Einträge angeben, für die Informationen fehlen oder die aktualisiert werden müssen.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install myapp.ear {-CorrectUseSystemIdentity {{Inc "Increment Bean Jar"
 Increment.jar,META-INF/ejb-jar.xml getValue() RunAsUser2 user2 password2} 
 {Inc "Increment Bean Jar" Increment.jar,META-INF/ejb-jar.xml Increment()
 RunAsUser2 user2 password2}}}

$AdminApp install myapp.ear {-CorrectUseSystemIdentity
 {{.*  .*  .*  getValue() RunAsUser2 user2 password2}
 {.*  .*  .*  Increment() RunAsUser2 user2 password2}}}

AdminApp.install('myapp.ear', '[-CorrectUseSystemIdentity
 [[Inc "Increment Bean Jar" Increment.jar,META-INF/ejb-jar.xml getValue()
 RunAsUser2 user2 password2] 
 [Inc "Increment Bean Jar" Increment.jar,META-INF/ejb-jar.xml Increment()
 RunAsUser2 user2 password2]]]')

AdminApp.install('myapp.ear', ['-CorrectUseSystemIdentity',
 [['.*', '.*', '.*', 'getValue()', 'RunAsUser2', 'user2', 'password2'],
 ['.*', '.*', '.*', 'Increment()', 'RunAsUser2', 'user2', 'password2']]])

createMBeansForResources

Die Option createMBeansForResources legt fest, dass MBeans für alle Ressourcen wie Servlets, JavaServer Pages (JSP)-Dateien und Enterprise Beans, die in einer Anwendung definiert sind, erstellt werden, wenn die Anwendung auf einem Bereitstellungsziel gestartet wird. Für diese Option ist kein Wert erforderlich. Die Standardeinstellung ist die Option nocreateMBeansForResources .

CtxRootForWebMod

Verwendungsbeispiel für den Stapelmodus

Mit Jacl:

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname ivtApp -CtxRootForWebMod
 {{"IVT Application" ivt_app.war,WEB-INF/web.xml /mycontextroot}}}

$AdminApp install myapp.ear {-appname MyApp -CtxRootForWebMod {{.* .* /mycontextroot}}}

Mit Jython:

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'ivtApp ', '-CtxRootForWebMod',
 [["IVT Application", 'ivt_app.war,WEB-INF/web.xml', '/mycontextroot']]])

AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-CtxRootForWebMod',
 [['.*', '.*', '/mycontextroot']]])

custom

Die Option custom gibt ein Name-Wert-Paar im Format name=value an. Verwenden Sie die Option custom, um Optionen an Erweiterungen für die Anwendungsimplementierung weiterzugeben. Die verfügbaren angepassten Optionen sind in der Dokumentation zu den Erweiterungen für die Anwendungsimplementierung aufgeführt.

CustomActivationPlan

Die Option CustomActivationPlan gibt Laufzeitkomponenten an, die zu den Standard-Laufzeitkomponenten, die für die Ausführung der Anwendung verwendet werden, hinzugefügt oder entfernt werden sollen. Verwenden Sie diese Option nur, wenn der Anwendungsserver nicht alle erforderlichen Laufzeitkomponenten durch Überprüfung der Anwendung abrufen kann.

Verwendungsbeispiel für den Stapelmodus

AdminApp.install('Increment.jar','[-CustomActivationPlan [["Increment Enterprise Java Bean"
 Increment.jar,META-INF/ejb-jar.xml WebSphere:specname=WS_ComponentToAdd ""]]')

AdminApp.install('Increment.jar','[-CustomActivationPlan [[.*
 Increment.jar,META-INF/ejb-jar.xml WebSphere:specname=WS_ComponentToAdd ""]]')

DataSourceFor10CMPBeans

Die Option DataSourceFor10CMPBeans spezifiziert optionale Datenquellen für einzelne 1.x container-managed persistence (CMP) Beans. Verwenden Sie diese Option, um fehlende Daten anzugeben oder eine Task zu aktualisieren.

Bei der Zuordnung einer spezifischen Datenquelle zu einer CMP-Bean wird die Standarddatenquelle für das Modul, das die Enterprise-Bean enthält, überschrieben. Jedes Element der Option "DataSourceFor10CMPBeans" besteht aus den folgenden Feldern: EJBModule, EJB, uri, JNDI, userName, password, login.config.name und auth.props. Folgenden dieser Felder können Werte zugeordnet werden: JNDI, userName, password, login.config.name und auth.props.

Wenn "login.config.name" auf "DefaultPrincipalMapping" gesetzt ist, wird eine Eigenschaft mit dem Namen "com.ibm.mapping.authDataAlias" erstellt. Der Wert der Eigenschaft wird von "auth.props" gesetzt. Wenn "login.config.name" nicht auf "DefaultPrincipalMapping" gesetzt ist, kann "auth.props" mehrere Eigenschaften angeben. Das Zeichenfolgeformat ist websphere:name= <name1>,value=<value1>,description=<desc1>. Geben Sie mit dem Pluszeichen (+) mehrere Eigenschaften an.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen Daten für Zeilen oder Einträge angeben, für die Informationen fehlen oder die aktualisiert werden müssen.

Verwendungsbeispiel für den Stapelmodus

Mit Jacl:

$AdminApp install C:/app1.ear {-DataSourceFor10CMPBeans {{"Increment CMP 1.1 EJB"
 IncCMP11 IncCMP11.jar,META-INF/ejb-jar.xml myJNDI user1 password1 loginName1 authProps1}}} 

$AdminApp install myapp.ear {-DataSourceFor10CMPBeans {{"Increment CMP 1.1 EJB" IncCMP11
 IncCMP11.jar,META-INF/ejb-jar.xml myJNDI user1 password1 loginName1 authProps1}}} 

Mit Jacl (Mustererkennung):

$AdminApp install C:/myapp.ear {-DataSourceFor10CMPBeans {{.*  .*  
 IncCMP11.jar,.* myJNDI user1 password1 loginName1 authProps1}}}

$AdminApp install myapp.ear {-DataSourceFor10CMPBeans {{.*  .*  IncCMP11.jar,.*
 myJNDI user1 password1 loginName1 authProps1}}}

Mit Jython:

AdminApp.install('C:/app1.ear', ['-DataSourceFor10CMPBeans', [["Increment CMP 1.1 EJB",
 'IncCMP11', 'IncCMP11.jar,META-INF/ejb-jar.xml', 'myJNDI', 'user1', 'password1',
 'loginName1', 'authProps1']]]) 

AdminApp.install('myapp.ear', ['-DataSourceFor10CMPBeans', [["Increment CMP 1.1 EJB",
 'IncCMP11', 'IncCMP11.jar,META-INF/ejb-jar.xml', 'myJNDI', 'user1',
 'password1', 'loginName1', 'authProps1']]]) 

Mit Jython (Mustererkennung):

AdminApp.install('C:/myapp.ear', ['-DataSourceFor10CMPBeans', [['.*', '.*', 
 'IncCMP11.jar,.*', 'myJNDI', 'user1', 'password1', 'loginName1', 'authProps1']]])

AdminApp.install('myapp.ear', ['-DataSourceFor10CMPBeans', [['.*', '.*',
 'IncCMP11.jar,.*', 'myJNDI', 'user1', 'password1', 'loginName1', 'authProps1']]])

DataSourceFor20CMPBeans

Die Option DataSourceFor20CMPBeans spezifiziert optionale Datenquellen für einzelne 2.x container-managed persistence (CMP) Beans. Verwenden Sie diese Option, um fehlende Daten anzugeben oder eine Task zu aktualisieren.

Bei der Zuordnung einer spezifischen Datenquelle zu einer CMP-Bean wird die Standarddatenquelle für das Modul, das die Enterprise-Bean enthält, überschrieben. Jedes Element der Option "DataSourceFor20CMPBeans" besteht aus den folgenden Feldern: EJBModule, EJB, uri, JNDI, resAuth, login.config.name und auth.props. Den folgenden dieser Felder können Werte zugewiesen werden: JNDI, resAuth, login.config.name und auth.props.

Wenn "login.config.name" auf "DefaultPrincipalMapping" gesetzt ist, wird eine Eigenschaft mit dem Namen "com.ibm.mapping.authDataAlias" erstellt. Der Wert der Eigenschaft wird von "auth.props" gesetzt. Wenn "login.config.name" nicht auf "DefaultPrincipalMapping" gesetzt ist, kann "auth.props" mehrere Eigenschaften angeben. Das Zeichenfolgeformat ist websphere:name= <name1>,value=<value1>,description=<desc1>. Geben Sie mit dem Pluszeichen (+) mehrere Eigenschaften an.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen nur Daten für Zeilen oder Einträge bereitstellen, in denen Informationen fehlen oder die eine Aktualisierung erfordern.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install Increment.jar {-DataSourceFor20CMPBeans
 {{"Increment Enterprise Java Bean" Increment
 Increment.jar,META-INF/ejb-jar.xml jndi1 container "" ""}}} 

$AdminApp install Increment.jar {-DataSourceFor20CMPBeans {{.*  .*
 Increment.jar,.*  jndi1 container "" ""}}}

AdminApp.install('Increment.jar', ['-DataSourceFor20CMPBeans',
 [["Increment Enterprise Java Bean", 'Increment',
 'Increment.jar,META-INF/ejb-jar.xml', 'jndi1', 'container', '', '']]])

AdminApp.install('Increment.jar', ['-DataSourceFor20CMPBeans', [['.*', '.*',
 'Increment', 'Increment.jar,.*', 'jndi1', 'container', '', '']]])

DataSourceFor10EJBModules

Die Option DataSourceFor10EJBModules gibt die Standarddatenquelle für das Enterprise Bean-Modul an, das 1.x container-managed persistence (CMP) beans enthält. Verwenden Sie diese Option, um fehlende Daten anzugeben oder eine Task zu aktualisieren.

Jedes Element der Option "DataSourceFor10EJBModules" besteht aus den folgenden Feldern: EJBModule, EJB, uri, JNDI, userName, password, login.config.name und auth.props. Folgenden dieser Felder können Werte zugeordnet werden: JNDI, userName, password, login.config.name und auth.props.

Wenn "login.config.name" auf "DefaultPrincipalMapping" gesetzt ist, wird eine Eigenschaft mit dem Namen "com.ibm.mapping.authDataAlias" erstellt. Der Wert der Eigenschaft wird von "auth.props" gesetzt. Wenn "login.config.name" nicht auf "DefaultPrincipalMapping" gesetzt ist, kann "auth.props" mehrere Eigenschaften angeben. Das Zeichenfolgeformat ist websphere:name= <name1>,value=<value1>,description=<desc1>. Geben Sie mit dem Pluszeichen (+) mehrere Eigenschaften an.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen Daten für Zeilen oder Einträge angeben, für die Informationen fehlen oder die aktualisiert werden müssen.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install myapp.ear {-DataSourceFor10EJBModules {{"Increment CMP 1.1 EJB"
 IncCMP11.jar,META-INF/ejb-jar.xml yourJNDI user2 password2 loginName authProps}}} 

$AdminApp install myapp.ear {-DataSourceFor10EJBModules
 {{.* IncCMP11.jar,.* yourJNDI user2 password2 loginName authProps}}}

AdminApp.install('myapp.ear', ['-DataSourceFor10EJBModules', [["Increment CMP 1.1 EJB",
 'IncCMP11.jar,META-INF/ejb-jar.xml', 'yourJNDI', 'user2', 'password2', 
 'loginName', 'authProps']]]) 

AdminApp.install('myapp.ear', ['-DataSourceFor10EJBModules',
 [['.*', 'IncCMP11.jar,.*', 'yourJNDI', 'user2', 'password2', 'loginName', 'authProps']]])

DataSourceFor20EJBModules

Die Option DataSourceFor20EJBModules gibt die Standarddatenquelle für das Modul enterprise bean 2.x an, das 2.x container managed persistence (CMP) beans enthält. Verwenden Sie diese Option, um fehlende Daten anzugeben oder eine Task zu aktualisieren.

Jedes Element der Option DataSourceFor20EJBModules besteht aus den folgenden Feldern: EJBModule, uri, JNDI, resAuth,, login.config.name und auth.props. Den folgenden dieser Felder können Werte zugewiesen werden: JNDI, resAuth, login.config.name und erweiterte Datenquelleneigenschaften.

Das letzte Feld in den einzelnen Einträgen dieser Task gibt den Wert für die Ressourcenberechtigung an. Gültige Werte für die Ressourcenberechtigung sind per connection factory oder container.

Wenn "login.config.name" auf "DefaultPrincipalMapping" gesetzt ist, wird eine Eigenschaft mit dem Namen "com.ibm.mapping.authDataAlias" erstellt. Der Wert der Eigenschaft wird von "auth.props" gesetzt. Wenn "login.config.name" nicht auf "DefaultPrincipalMapping" gesetzt ist, kann "auth.props" mehrere Eigenschaften angeben. Das Zeichenfolgeformat ist websphere:name= <name1>,value=<value1>,description=<desc1>. Geben Sie mit dem Pluszeichen (+) mehrere Eigenschaften an.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen nur Daten für Zeilen oder Einträge bereitstellen, in denen Informationen fehlen oder die eine Aktualisierung erfordern.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install Increment.jar {-DataSourceFor20EJBModules
 {{"Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 jndi2 container "" "" ""}}} 

$AdminApp install Increment.jar {-DataSourceFor20EJBModules {{.*
 Increment.jar,.* jndi2 container "" "" ""}}}

set s \"value1,value2\"

"clientApplicationInformation=value1,value2" with "clientapplication=$s"

AdminApp.install('Increment.jar', ['-DataSourceFor20EJBModules',
 [["Increment Enterprise Java Bean", 'Increment.jar,META-INF/ejb-jar.xml',
 'jndi2', 'container', '', '', '']]])

AdminApp.install('Increment.jar', ['-DataSourceFor20EJBModules',
 [['.*', 'Increment.jar,.*', 'jndi2', 'container', '', '', '']]])

'property1="value1,value2"+property2="value3,value4"'

defaultbinding.cf.jndi

Die Option defaultbinding.cf.jndi gibt den Java Naming and Directory Interface (JNDI)-Namen für die Standardverbindungsfabrik an.

defaultbinding.cf.resauth

Die Option defaultbinding.cf.resauth gibt die RESAUTH für die Verbindungsfabrik an.

defaultbinding.datasource.jndi

Die Option defaultbinding.datasource.jndi gibt den Namen des Java Naming and Directory Interface (JNDI) für die Standarddatenquelle an.

defaultbinding.datasource.password

Die Option defaultbinding.datasource.password gibt das Passwort für die Standarddatenquelle an.

defaultbinding.datasource.username

Die Option defaultbinding.datasource.username gibt den Benutzernamen für die Standarddatenquelle an.

defaultbinding.ee.defaults

Die Option defaultbinding.ee.defaults gibt die vorkonfigurierte Standard-Ressourcenoption für Java EE an.

defaultbinding.ejbjndi.prefix

Die Option defaultbinding.ejbjndi.prefix gibt das Präfix für den JNDI-Namen (Java Naming and Directory Interface) der Enterprise Bean an.

defaultbinding.force

Die Option defaultbinding.force gibt an, dass die Standardbindungen die aktuellen Bindungen überschreiben.

defaultbinding.strategy.file

Die Option defaultbinding.strategy.file gibt eine benutzerdefinierte Standard-Bindungsstrategie-Datei an.

defaultbinding.virtual.host

Die Option defaultbinding.virtual.host gibt den Standardnamen für einen virtuellen Host an.

depl.extension.reg (veraltet)

deployejb

Die Option deployejb gibt an, dass das EJBDeploy-Tool während der Installation ausgeführt werden soll. Für diese Option ist kein Wert erforderlich. EJBDeploy wird nur während der Installation von Modulen der EJBDeploy Version 1.x oder 2.x ausgeführt. Das EJB-Implementierungstool wird während der Installation von Modulen der EJB Version 3.x nicht ausgeführt.

Diese Option wird ignoriert, wenn die EAR-Datei oder das Modul, die bzw. das installiert oder aktualisiert werden soll, einen Java EE 7-Anwendungsimplementierungsdeskriptor, einen EJB 3.2-Modulimplementierungsdeskriptor oder einen Web 3.1-Modulimplementierungsdeskriptor enthält.

Wenn Sie die EAR-Datei der Anwendung mit dem Tool "EJBDeploy" vorab implementieren, ist der Standardwert nodeployejb. Andernfalls ist der Standardwert deployejb.

Wenn ein EJB-Modul in einer WAR-Datei (Web Archive) paketiert ist, muss die Option "deployejb" nicht verwendet werden.

Installieren Sie bei dieser Option nur auf einem Bereitstellungsziel der Version 9.0, das die gleiche oder eine höhere Java SDK-Stufe als der Bereitstellungsmanager hat.

deployejb.classpath

Die Option deployejb.classpath gibt einen zusätzlichen Klassenpfad für das EJBDeploy-Tool an.

deployejb.complianceLevel

Die Option deployejb.complianceLevel gibt die JDK-Konformitätsstufe für das EJBDeploy-Tool an.

1.4 (default) 5.0 6.0

Eine Liste der derzeit unterstützten JDK-Kompatibilitätsstufen können Sie mit dem Befehl ejbdeploy -? abrufen.

deployejb.dbschema

Die Option deployejb.dbschema gibt das Datenbankschema für das EJBDeploy-Tool an.

deployejb.dbtype

Die Option deployejb.dbtype gibt den Datenbanktyp für das EJBDeploy-Tool an.

DB2UDB_V81 DB2UDB_V82 DB2UDB_V91 DB2UDB_V95 DB2UDBOS390_V8 DB2UDBOS390_NEWFN_V8 DB2UDBOS390_V9 
 DB2UDBISERIES_V53 DB2UDBISERIES_V54 DB2UDBISERIES_V61  DERBY_V10 DERBY_V101 INFORMIX_V100 INFORMIX_V111 INFORMIX_V115 
 MSSQLSERVER_2005 ORACLE_V10G ORACLE_V11G SYBASE_V15 SYBASE_V125

Eine Liste der derzeit unterstützten Anbieter von Datenbanken erhalten Sie durch Ausführen des Befehls ejbdeploy -?.

deployejb.dbaccesstype

Die Option deployejb.dbaccesstype gibt die Art des Datenbankzugriffs für das EJBDeploy-Tool an. Gültige Werte sind SQLjund JDBC. Die Standardeinstellung ist JDBC.

deployejb.rmic

Die Option deployejb.rmic gibt zusätzliche RMIC-Optionen an, die für das EJBDeploy-Tool verwendet werden sollen.

deployejb.sqljclasspath

Die Option deployejb.sqljclasspath gibt den Speicherort der SQLJ-Übersetzerklassen an.

deployws

Die Option deployws legt fest, dass Webdienste während der Installation bereitgestellt werden sollen. Für diese Option ist kein Wert erforderlich.

Der Standardwert ist nodeployws.

Installieren Sie bei dieser Option nur auf einem Bereitstellungsziel der Version 9.0, das die gleiche oder eine höhere Java SDK-Stufe als der Bereitstellungsmanager hat.

deployws.classpath

Die Option deployws.classpath gibt den zusätzlichen Klassenpfad an, der bei der Bereitstellung von Webdiensten verwendet werden soll.

Wenn Sie die Klassenpfade mehrerer Einträge angeben möchten, verwenden Sie für die Einträge dasselbe Trennzeichen, das auch in der Umgebungsvariablen CLASSPATH verwendet wird.

Verwenden Sie ein Semikolon (;), um die Einträge zu trennen.

Verwenden Sie einen Doppelpunkt (:), um die Einträge zu trennen.

deployws.jardirs

Die Option deployws.jardirs gibt die zusätzlichen Erweiterungsverzeichnisse an, die bei der Bereitstellung von Webdiensten verwendet werden sollen.

distributeApp

Die Option distributeApp legt fest, dass die Anwendungsverwaltungskomponente Anwendungsbinärdateien verteilt. Für diese Option ist kein Wert erforderlich. Dies ist die Standardeinstellung.

EmbeddedRar

Die Option EmbeddedRar bindet Java 2 Connector-Objekte an JNDI-Namen. Sie müssen jedes J2C-Objekt in Ihrer Anwendung oder Ihrem Modul, z. B. J2C-Verbindungsfactorys, J2C-Aktivierungsspezifikationen und J2C-Verwaltungsobjekte, an einen JNDI-Namen binden. Jedes Element der Option EmbeddedRar enthält die folgenden Felder: RARModule, uri, j2cid, j2c.name, j2c.jndiName. Sie können den Feldern die folgenden Werte zuweisen: j2c.name, j2c.jndiName.

Connector module: <rar module name> 
URI: <rar name>,META-INF/ra.xml 
Object identifier: <identifier of the J2C object> 
name: j2cid 
JNDI name: eis/j2cid

J2C connection factory: connectionFactoryInterface
J2C admin object: adminObjectInterface
J2C activation specification: message listener type

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen Daten für Zeilen oder Einträge angeben, für die Informationen fehlen oder die aktualisiert werden müssen.

Wenn die ID in der Datei ra.xml nicht eindeutig ist, wird-< Zahl> hinzugefügt. Beispiel: javax.sql.DataSource-2.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install $embeddedEar {-EmbeddedRar {{"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml 
 javax.sql.DataSource javax.sql.DataSource1 eis/javax.sql.javax.sql.DataSSource1} {"FVT Resource Adapter" 
 jca15cmd.rar,META-INF/ra.xml javax.sql.DataSource2 javax.sql.DataSource2 eis/javax.sql.DataSource2} {"FVT Resource Adapter" 
 jca15cmd.rar,META-INF/ra.xml javax.jms.MessageListener javax.jms.MessageListener1 eis/javax.jms.MessageListener1} {"FVT Resource 
 Adapter" jca15cmd.rar,META-INF/ra.xml javax.jms.MessageLListener2 javax.jms.MessageListener2 eis/javax.jms.MessageListener2} 
 {"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml fvt.adapter.message.FVTMessageProvider 
 fvt.adapter.message.FVTMessageProvider1 eis/fvt.adapter.message.FVTMessageProvider1} {"FVT Resource Adapter" 
 jca15cmd.rar,META-INF/ra.xml fvt.adapter.message.FVTMessageProvider2 fvt.adapter.message.FVTMessageProvider2 
 eis/fvt.adapter.message.FVTMessageProvider2}}} 

$AdminApp install $embeddedEar {-EmbeddedRar {{.*  .*  .*  javax.sql.DataSource1  
 eis/javax.sql.javax.sql.DataSSource1} {.*  .*  .*  javax.sql.DataSource2  eis/javax.sql.DataSource2} {.*  .*  .*  
 javax.jms.MessageListener1  eis/javax.jms.MessageListener1} {.*  .*  .*  javax.jms.MessageListener2  
 eis/javax.jms.MessageListener2} {.*  .*  .*  fvt.adapter.message.FVTMessageProvider1  
 eis/fvt.adapter.message.FVTMessageProvider1} {.*  .*  .*  fvt.adapter.message.FVTMessageProvider2  
 eis/fvt.adapter.message.FVTMessageProvider2}}}

AdminApp.install(embeddedEar, ['-EmbeddedRar', [["FVT Resource Adapter", 
 'jca15cmd.rar,META-INF/ra.xml', 'javax.sql.DataSource', 'javax.sql.DataSource1', 'eis/javax.sql.javax.sql.DataSSource1'], ["FVT 
 Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml javax.sql.DataSource2', 'javax.sql.DataSource2', 'eis/javax.sql.DataSource2'], 
 ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageListener', 'javax.jms.MessageListener1', 
 'eis/javax.jms.MessageListener1'], ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageLListener2', 
 'javax.jms.MessageListener2', 'eis/javax.jms.MessageListener2'], ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml 
 fvt.adapter.message.FVTMessageProvider', 'fvt.adapter.message.FVTMessageProvider1', 
 'eis/fvt.adapter.message.FVTMessageProvider1'], ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 
 'fvt.adapter.message.FVTMessageProvider2', 'fvt.adapter.message.FVTMessageProvider2', 
 'eis/fvt.adapter.message.FVTMessageProvider2']]]) 

AdminApp.install(embeddedEar, ['-EmbeddedRar', [['.*', '.*', '.*', 'javax.sql.DataSource1', 
 'eis/javax.sql.javax.sql.DataSSource1'], ['.*', '.*', '.*', 'javax.sql.DataSource2', 'eis/javax.sql.DataSource2'], ['.*', '.*', 
 '.*', 'javax.jms.MessageListener1', 'eis/javax.jms.MessageListener1'], ['.*', '.*', '.*', 'javax.jms.MessageListener2', 
 'eis/javax.jms.MessageListener2'], ['.*', '.*', '.*', 'fvt.adapter.message.FVTMessageProvider1', 
 'eis/fvt.adapter.message.FVTMessageProvider1'], ['.*', '.*', '.*', 'fvt.adapter.message.FVTMessageProvider2', 
 'eis/fvt.adapter.message.FVTMessageProvider2']]])

enableClientModule

Die Option enableClientModule gibt an, dass Client-Module bereitgestellt werden sollen. Wählen Sie diese Option aus, wenn die zu implementierende Datei ein oder mehrere Clientmodule enthält, die Sie implementieren möchten. Wenn Sie diese Option auswählen, installieren Sie die Clientmodule nur auf einem Implementierungsziel der Version 8.0 oder höher.

Für diese Option ist kein Wert erforderlich. Der Standardwert ist noenableClientModule. Standardmäßig wird die Option enableClientModule bei der Bereitstellung ignoriert und die Client-Module werden nicht bereitgestellt.

EnsureMethodProtectionFor10EJB

Die Option EnsureMethodProtectionFor10EJB wählt den Methodenschutz für ungeschützte Methoden von 1.x enterprise beans aus. Geben Sie an, dass die Methode ungeschützt bleiben soll oder definieren Sie einen Zugriffsschutz, der jeden Zugriff verweigert. Verwenden Sie diese Option, um fehlende Daten anzugeben oder eine Task zu aktualisieren.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen Daten für Zeilen oder Einträge angeben, für die Informationen fehlen oder die aktualisiert werden müssen.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install Increment.jar {-EnsureMethodProtectionFor10EJB
 {{"Increment EJB Module" IncrementEJBBean.jar,META-INF/ejb-jar.xml ""}
 {"Timeout EJB Module" TimeoutEJBBean.jar,META-INF/ejb-jar.xml
 methodProtection.denyAllPermission}}}

$AdminApp install myapp.ear {-EnsureMethodProtectionFor10EJB
 {{.* IncrementEJBBean.jar,.* ""} {.* TimeoutEJBBean.jar,.*
 methodProtection.denyAllPermission}}}

AdminApp.install('Increment.jar', '[-EnsureMethodProtectionFor10EJB
 [["Increment EJB Module" IncrementEJBBean.jar,META-INF/ejb-jar.xml ""]
 ["Timeout EJB Module" TimeoutEJBBean.jar,META-INF/ejb-jar.xml
 methodProtection.denyAllPermission]]]')

AdminApp.install('myapp.ear', ['-EnsureMethodProtectionFor10EJB',
 [['.*', 'IncrementEJBBean.jar,.*', ""], ['.*', 'TimeoutEJBBean.jar,.*', 
 'methodProtection.denyAllPermission']]])

Das letzte Feld in den einzelnen Einträgen dieser Task gibt den Wert für den Zugriffsschutz an. Gültige Werte: methodProtection.denyAllPermission. Sie können das Feld auch leer lassen, wenn die Methode ungeschützt bleiben soll.

EnsureMethodProtectionFor20EJB

Die Option EnsureMethodProtectionFor20EJB wählt den Methodenschutz für ungeschützte Methoden von 2.x enterprise beans aus. Geben Sie an, ob Sie der ungeschützten Methode eine Sicherheitsrolle zuordnen, die Methode der Ausschlussliste hinzufügen oder die Methode abwählen möchten. Sie können mehrere Rollen zuordnen, indem Sie die Namen der Rollen durch Kommata voneinander trennen. Verwenden Sie diese Option, um fehlende Daten anzugeben oder eine Task zu aktualisieren.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen nur Daten für Zeilen oder Einträge bereitstellen, in denen Informationen fehlen oder die eine Aktualisierung erfordern.

Verwendungsbeispiel für den Stapelmodus

Mit Jacl:

$AdminApp install myapp.ear {-EnsureMethodProtectionFor20EJB
 {{CustmerEjbJar customerEjb.jar,META-INF/ejb-jar.xml methodProtection.uncheck}
 {SupplierEjbJar supplierEjb.jar,META-INF/ejb-jar.xml methodProtection.exclude}}}

Mit Jacl (Mustererkennung):

$AdminApp install myapp.ear {-EnsureMethodProtectionFor20EJB
 {{.* customerEjb.jar,.* methodProtection.uncheck}
 {.* supplierEjb.jar,.* methodProtection.exclude}}}

AdminApp.install('myapp.ear', '[-EnsureMethodProtectionFor20EJB 
 [[CustmerEjbJar customerEjb.jar,META-INF/ejb-jar.xml methodProtection.uncheck]
 [SupplierEjbJar supplierEjb.jar,META-INF/ejb-jar.xml methodProtection.exclude]]]')

AdminApp.install('myapp.ear', ['-EnsureMethodProtectionFor20EJB',
 [['.*', 'customerEjb.jar,.*', 'methodProtection.uncheck'],
 ['.*', 'supplierEjb.jar,.*', 'methodProtection.exclude']]])

Das letzte Feld in den einzelnen Einträgen dieser Task gibt den Wert für den Zugriffsschutz an. Die gültigen Werte für den Zugriffsschutz lauten: methodProtection.uncheck, methodProtection.exclude oder eine Liste der Sicherheitsrollen, die mit Kommata als Trennungszeichen angegeben sind.

filepermission

.*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755

Verwendungsbeispiel für den Stapelmodus

$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname MyApp -cell myCell -node myNode -server server1
 -filepermission .*\\.jsp=777#.*\\.xml=755}

AdminApp.install("app_server_root/installableApps/DynaCacheEsi.ear",
 ["-appname", "MyApp", "-cell", "myCell", "-node", "myNode", "-server", "server1",
 "-filepermission", ".*\\.jsp=777#.*\\.xml=755"])

installdir (veraltet)

installed.ear.destination

Die Option installed.ear.destination gibt das Verzeichnis an, in dem die Binärdateien der Anwendung gespeichert werden sollen.

JSPCompileOptions

Geben Sie für "Vollständige Paketnamen verwenden" und "JSP-Laufzeitkompilierung inaktivieren" einen Yes -oder No -Wert in der für die Ländereinstellung spezifischen Sprache an. Das Produkt unterstützt die Werte AppDeploymentOption.Yes und AppDeploymentOption.No anstelle von Yes und No. Es wird jedoch empfohlen, Yes oder No in der Sprache Ihrer Ländereinstellung anzugeben.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -preCompileJSPs -JSPCompileOptions {{"IVT Application"
 ivt_app.war,WEB-INF/web.xml jspcp Yes 15 No}}}

$AdminApp install ivtApp.ear {-appname MyApp -preCompileJSPs -JSPCompileOptions
 {{.* .* jspcp Yes 15 No}}}

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-preCompileJSPs', '-JSPCompileOptions',
 [["IVT Application", 'ivt_app.war,WEB-INF/web.xml', 'jspcp',
 'Yes', 15, 'No']]])

AdminApp.install('ivtApp.ear', ['-appname', 'MyApp', '-preCompileJSPs',
 '-JSPCompileOptions', [['.*', '.*', 'jspcp', 'Yes', 15, 'No']]])

JSPReloadForWebMod

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen.

Geben Sie für das erneute Laden von JSP-Klassen einen Wert für Yes oder No in der Sprache an, die für die Ländereinstellung spezifisch ist. Das Produkt unterstützt die Werte AppDeploymentOption.Yes und AppDeploymentOption.No anstelle von Yes und No. Es wird jedoch empfohlen, Yes oder No in der Sprache Ihrer Ländereinstellung anzugeben.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -JSPReloadForWebMod {{"IVT Application"
 ivt_app.war,WEB-INF/web.xml Yes 5}}}

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -JSPReloadForWebMod {{.* .* Yes 5}}}

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-JSPReloadForWebMod [["IVT Application"
 ivt_app.war,WEB-INF/web.xml Yes 5 ]]'])

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-JSPReloadForWebMod', [['.*', '.*', 'Yes', '5']]])

MapEJBRefToEJB

Die Option MapEJBRefToEJB bildet Enterprise-Java-Referenzen auf Enterprise-Beans ab. Jede in der Anwendung definierte EJB-Referenz muss einer Enterprise-Bean zugeordnet werden. Verwenden Sie diese Option, um fehlende Daten anzugeben oder eine Task zu aktualisieren.

Wenn die EJB-Referenz von einem EJB-Modul der Version 3,x, einem Webmodul der Version 2.4 oder einem Webmodul der Version 2.5 stammt, ist der JNDI-Name optional. Wenn Sie die Option "useAutoLink" angeben, ist der JNDI-Name optional. Die Laufzeitumgebung enthält einen Standardwert für den Container. Ein Modul der EJB Version 3.0 oder höher kann keine CMP- oder BMP-Entity-Beans enthalten. Die Installation schlägt fehl, wenn eine CMP- oder BMP-Entity-Bean in einem Modul der EJB Version 3.x einer Java EE-Anwendung enthalten ist. CMP- und BMP-Beans können nur in Module der EJB Version 2.1 oder früher gepackt werden.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen Angaben lediglich in Zeilen oder Einträgen angeben, in denen Daten fehlen oder die vorhandenen Daten aktualisiert werden müssen.

Verwendungsbeispiel für den Stapelmodus

Mit Jacl:

$AdminApp install techapp.ear {-MapEJBRefToEJB {{"JAASLogin" "" JAASLoginWeb.war,
WEB-INF/web.xml WSsamples/JAASLogin jaasloginejb.SampleBean TechApp/JAASLogin}}
-MapWebModToVH {{"Web Application" Tech.war,WEB-INF/web.xml default_host}}}

Mit Jacl (Mustererkennung):

$AdminApp install C:/myapp.ear {-MapEJBRefToEJB {{.* .* .* .* .* MyBean}}}

$AdminApp install myapp.ear {-MapEJBRefToEJB {{.* .* .* .* .* MyBean}}}

AdminApp.install('techapp.ear','[
-MapEJBRefToEJB [["JAASLogin" "" JAASLoginWeb.war,WEB-INF/web.xml WSsamples/JAASLogin]]
-MapWebModToVH [["Web Application" tech.war,WEB-INF/web.xml default_host]]]')

Mit Jython (Mustererkennung):

AdminApp.install('C:/myapp.ear', ['-MapEJBRefToEJB',
 [['.*', '.*', '.*', '.*', '.*', 'MyBean']]])

AdminApp.install('myapp.ear', ['-MapEJBRefToEJB', 
 [['.*', '.*', '.*', '.*', '.*', 'MyBean']]])

MapEnvEntryForApp

Mit der Option MapEnvEntryForApp wird der env-entry-Wert der Anwendung bearbeitet. Sie können diese Option verwenden, um den Wert von "env-entry" in der Datei application.xml zu bearbeiten.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -MapEnvEntryForApp {{MyApp/appEnvEntry String null newEnvEntry}}}

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp2 -MapEnvEntryForApp {{.* .* .* newEnvEntry}}}

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp3', '-MapEnvEntryForApp', [['MyApp/appEnvEntry', 'String', 'null', 'newEnvEntry']]])

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp4', '-MapEnvEntryForApp', [['.*', '.*', '.*', 'newEnvEntry']]])

wenn die Beschreibung ein Zeilenvorschubzeichen enthält, verwenden Sie die folgende Syntax:

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp5 -MapEnvEntryForApp {{.* .* (?s).* newEnvEntry}}}

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp6', '-MapEnvEntryForApp',
 [['.*', '.*', '(?s).*', 'newEnvEntry']]])

MapEnvEntryForClientMod

Die Option MapEnvEntryForClientMod editiert den env-entry-Wert des Clientmoduls. Sie können diese Option verwenden, um den Wert für Umgebungseinträge im Clientmodul application-client.xml zu bearbeiten.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für das Clientmodul erforderlichen Daten abrufen.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install app_server_root/installableApps/myapp.ear
 {-appname MyApp -MapEnvEntryForClientMod {{"Client Module" client.jar,META-INF/application-client.xml
  clientObject String null newValue}}}

$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForClientMod {{.*  .*  .*
  .* .* newValue}}} 

AdminApp.install('app_server_root/installableApps/myapp.ear',
 ['-appname', 'MyApp', '-MapEnvEntryForClientMod', [["Client Module",
 'client.jar,META-INF/application-client.xml', 'clientObject',
 'String', 'null', 'newValue']]])

AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForClientMod',
 [['.*', '.*', '.*', '.*', '.*', 'newValue']]]) 

wenn die Beschreibung ein Zeilenvorschubzeichen enthält, verwenden Sie die folgende Syntax:

$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForClientMod {{.* .* .*
 (?s).* newValue}}}

AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForClientMod',
 [['.*', '.*', '.*', '(?s).*', '*', '*' 'newValue']]])

MapEnvEntryForEJBMod

Mit der Option "MapEnvEntryForEJBMod" wird der env-entry-Wert des Webmoduls geändert. Sie können diese Option verwenden, um den Wert für Umgebungseinträge im EJB-Modul ejb-jar.xml zu bearbeiten.

Wenn das Webmodul EJB 3.0 oder höher verwendet, wird der Inhalt dieser Option ausschließlich dem XML-Implementierungsdeskriptor entnommen. Mit dieser Option können keine Implementierungsinformationen aus Annotationen abgerufen werden.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -MapEnvEntryForEJBMod {{"IVT EJB Module" ivtEJB.jar,META-INF/ejb-jar.xml
  ivtEJBObject ejb/ivtEJBObject String null newValue}}}

$AdminApp install myapp.jar {-appname MyApp -MapEnvEntryForEJBMod {{.*  .*  .*
  .* .* .* newValue}}} 

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-MapEnvEntryForEJBMod', [["IVT EJB Module",
 'ivtEJB.jar,META-INF/ejb-jar.xml', 'ivtEJBObject', 'ejb/ivtEJBObject',
 'String', 'null', 'newValue']]])

AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForEJBMod',
 [['.*', '.*', '.*', '.*', '.*', '.*', 'newValue']]]) 

wenn die Beschreibung ein Zeilenvorschubzeichen enthält, verwenden Sie die folgende Syntax:

$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForEJBMod {{.* .* .*
 (?s).* newValue}}}

AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForEJBMod',
 [['.*', '.*', '.*', '(?s).*', '*', '*' 'newValue']]])

MapEnvEntryForWebMod

Ändert den env-entry-Wert des Webmoduls. Sie können diese Option verwenden, um den env-entry-Wert in der Datei web.xml zu ändern.

Wenn das Webmodul Servlet 2.5 verwendet, wird der Inhalt dieser Option ausschließlich aus dem XML-Implementierungsdeskriptor entnommen. Mit dieser Option können keine Implementierungsinformationen aus Annotationen abgerufen werden.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -MapEnvEntryForWebMod {{"IVT Application" ivt_app.war,
 WEB-INF/web.xml ivt/ivtEJBObject String null newEnvEntry}}}

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp2 -MapEnvEntryForWebMod {{.* .* .* .* newEnvEntry}}}

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp3', '-MapEnvEntryForWebMod', [["IVT Application",
 'ivt_app.war,WEB-INF/web.xml', 'ivt/ivtEJBObject', 'String', 'null', 'newEnvEntry']]])

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp4', '-MapEnvEntryForWebMod', [['.*', '.*', '.*', '.*', 'newEnvEntry']]])

wenn die Beschreibung ein Zeilenvorschubzeichen enthält, verwenden Sie die folgende Syntax:

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp5 -MapEnvEntryForWebMod {{.* .* .* (?s).* newEnvEntry}}}

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp6', '-MapEnvEntryForWebMod',
 [['.*', '.*', '.*', '(?s).*', 'newEnvEntry']]])

MapInitParamForServlet

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -MapInitParamForServlet {{"IVT Application"
 ivt_app.war,WEB-INF/web.xml ivtservlet pName1 null MyInitParamValue}}} 

$AdminApp install myapp.ear {-appname MyApp -MapInitParamForServlet
 {{.*  .*  .*  .*  .*  MyInitParamValue}}}

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-MapInitParamForServlet', [["IVT Application",
 'ivt_app.war,WEB-INF/web.xml', 'ivtservlet', 'pName1', 'null', 'MyInitParamValue']]])

AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapInitParamForServlet',
 [['.*', '.*', '.*', '.*', '.*', 'MyInitParamValue']]])

MapJaspiProvider

Geben Sie für JASPI verwenden einen Yes-, No-oder Inherit -Wert in der Sprache an, die für die Ländereinstellung spezifisch ist.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen nur Daten für Zeilen oder Einträge bereitstellen, in denen Informationen fehlen oder die eine Aktualisierung erfordern.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install myapp.ear {-MapJaspiProvider {{myapp META-INF/application.xml Yes Provider1} }}

AdminApp.install('myapp.ear', '[-appname myapp
 -MapJaspiProvider [[myapp META-INF/application.xml Yes Provider1] ]]')

MapMessageDestinationRefToEJB

Ordnet Nachrichtenzielreferenzen JNDI-Namen von Verwaltungsobjekten zu. Die Zuordnung erfolgt über die installierten Ressourcenadapter. Jede in der Anwendung definierte Nachrichtenzielreferenz muss einem Verwaltungsobjekt zugeordnet werden. Verwenden Sie diese Option, um fehlende Daten anzugeben oder eine Task zu aktualisieren.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen Daten für Zeilen oder Einträge angeben, für die Informationen fehlen oder die aktualisiert werden müssen.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install BankFull.ear {-MapMessageDestinationRefToEJB {{BankCMRQLEJB
 Sender BankCMRQLEJB.jar,META-INF/ejb-jar.xml BankJSQueue BankJSQueue} }}  

$AdminApp install $earfile {-MapMessageDestinationRefToEJB {{.*  .*  .*  MyConnection
 jndi2} {.* .*  .*  PhysicalTopic jndi3} {.*  .*  .*  jms/ABC jndi4}}} 

AdminApp.install('BankFull.ear', '[ -MapMessageDestinationRefToEJB [[ BankCMRQLEJB
 Sender BankCMRQLEJB.jar,META-INF/ejb-jar.xml BankJSQueue BankJSQueue ]]]' )

AdminApp.install(ear1, ['-MapMessageDestinationRefToEJB', [['.*', '.*', '.*', 'MyConnection', 
 'jndi2'], ['.*', '.*', '.*', 'PhysicalTopic', 'jndi3'], ['.*', '.*', '.*', 'jms/ABC', 'jndi4']]])

MapModulesToServers

Gibt den Anwendungsserver an, auf dem Sie die in Ihrer Anwendung enthaltenen Module installieren möchten. Sie können Module auf einem Server installieren oder auf mehrere Server verteilen. Verwenden Sie diese Option, um fehlende Daten anzugeben oder eine Task zu aktualisieren.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen Daten für Zeilen oder Einträge angeben, für die Informationen fehlen oder die aktualisiert werden müssen.

Verwendungsbeispiel für den Stapelmodus

Der folgende Beispielbefehl installiert Increment.jar auf einem Server:

$AdminApp install Increment.jar {-MapModulesToServers
 {{"Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 WebSphere:cell=mycell,node=mynode,server=server1}}}

AdminApp.install('Increment.jar', '[-MapModulesToServers
 [["Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 WebSphere:cell=mycell,node=mynode,server=server1] ]]')

Der folgende Beispielbefehl entfernt server1 aus der Anwendung, die installiert ist:

$AdminApp edit myapp {-MapModulesToServers
 {{.* .* -WebSphere:cell=mycell,node=mynode,server=server1}}
 -update -update.ignore.old} 

AdminApp.edit('myapp', ['-MapModulesToServers',
 [['.*', '.*', '-WebSphere:cell=mycell,node=mynode,server=server1']]]) 

MapResEnvRefToRes

Ordnet Ressourcenumgebungsreferenzen Ressourcen zu. Jede in der Anwendung definierte Ressourcenumgebungsreferenz muss einer Ressource zugeordnet werden. Verwenden Sie diese Option, um fehlende Daten anzugeben oder eine Task zu aktualisieren.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen Daten für Zeilen oder Einträge angeben, für die Informationen fehlen oder die aktualisiert werden müssen.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install app_server_root/installableApps/sibwsjmsepl.ear {
 -BindJndiForEJBMessageBinding {{ SOAPJMSEndpoint SOAPJMSEndpoint
   SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml lp1 "" "" "" }}
 -MapResEnvRefToRes {{SOAPJMSEndpoint SOAPJMSEndpoint
   SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml jms/WebServicesReplyQCF
   javax.jms.QueueConnectionFactory jndi1}}}

$AdminApp install app_server_root/installableApps/sibwsjmsepl.ear {
 -MapResEnvRefToRes {{.* .* .* .* .* jndi1}}}

AdminApp.install('app_server_root/installableApps/sibwsjmsepl.ear', '[
 -BindJndiForEJBMessageBinding [[ SOAPJMSEndpoint SOAPJMSEndpoint
   SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml lp1 "" "" "" ]]
 -MapResEnvRefToRes [[ SOAPJMSEndpoint SOAPJMSEndpoint
   SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml jms/WebServicesReplyQCF
   javax.jms.QueueConnectionFactory jndi1 ]]]' ) 

AdminApp.install('app_server_root/installableApps/sibwsjmsepl.ear',
 ['-MapResEnvRefToRes', [['.*', '.*', '.*', '.*', '.*', 'jndi1']]])

MapResRefToEJB

Ordnet Ressourcenreferenzen Ressourcen zu. Jede in der Anwendung definierte Ressourcenreferenz muss einer Ressource zugeordnet werden. Verwenden Sie diese Option, um fehlende Daten anzugeben oder eine Task zu aktualisieren.

Die Anmeldekonfiguration "DefaultPrincipalMapping" wird von Java 2 Connector (J2C) verwendet, um Benutzer Principals zuzuordnen, die in J2C-Authentifizierungsdateneinträgen definiert sind. Wenn "login.config.name" auf "DefaultPrincipalMapping" gesetzt ist, wird eine Eigenschaft mit dem Namen "com.ibm.mapping.authDataAlias" erstellt. Der Wert der Eigenschaft wird von "auth.props" gesetzt. Wenn "login.config.name" nicht auf "DefaultPrincipalMapping" gesetzt ist, kann "auth.props" mehrere Eigenschaften angeben. Das Zeichenfolgeformat ist websphere:name= <name1>,value=<value1>,description=<desc1>. Für die Angabe mehrerer Eigenschaften muss ein Pluszeichen (+) verwendet werden.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen Daten für Zeilen oder Einträge angeben, für die Informationen fehlen oder die aktualisiert werden müssen.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install myapp.ear {-MapResRefToEJB 
 {{deplmtest.jar MailEJBObject deplmtest.jar,META-INF/ejb-jar.xml mail/MailSession9
 javax.mail.Session jndi1 login1 authProps1 "clientApplicationInformation=new application"}
 {"JavaMail Sample WebApp" "" mtcomps.war,WEB-INF/web.xml mail/MailSession9 
 javax.mail.Session jndi2 login2 authProps2 ""}}} 

$AdminApp install myapp.ear {-MapResRefToEJB 
 {{deplmtest.jar .*  .*  .*  .*  jndi1 login1 authProps1
 "clientApplicationInformation=new application"}
 {"JavaMail Sample WebApp" .*  .*  .*  .*  jndi2 login2 authProps2 ""}}}

set s \"value1,value2\"

"clientApplicationInformation=value1,value2" with "clientapplication=$s"

AdminApp.install('myapp.ear', ['-MapResRefToEJB', 
 [['deplmtest.jar', 'MailEJBObject', 'deplmtest.jar,META-INF/ejb-jar.xml
 mail/MailSession9', 'javax.mail.Session', 'jndi1', 'login1', 'authProps1',
 'clientApplicationInformation=new application+clientWorkstation=9.10.117.65'],
 ["JavaMail Sample WebApp", "", 'mtcomps.war,WEB-INF/web.xml', 'mail/MailSession9',
 'javax.mail.Session', 'jndi2', 'login2', 'authProps2', '']]]) 

AdminApp.install('myapp.ear', ['-MapResRefToEJB', 
 [['deplmtest.jar', '.*', '.*', '.*', '.*', 'jndi1', 'login1', 'authProps1',
 'clientApplicationInformation=new application+clientWorkstation=9.10.117.65'],
 ["JavaMail Sample WebApp", '', '.*', '.*', '.*', 'jndi2', 'login2',
 'authProps2', '']]])

'property1="value1,value2"+property2="value3,value4"'

MapRolesToUsers

Mit der Option "MapRolesToUsers" werden Benutzer Rollen zugeordnet. Sie müssen jede in der Anwendung oder im Modul definierte Rolle über die Benutzerregistry der Domäne einem Benutzer oder einer Gruppe zuordnen. Sie können mehrere Benutzer oder Gruppen für eine einzelne Rolle angeben, indem Sie sie durch ein Pipe-Zeichen (|) trennen. Beispiel:user1|user2 . Verwenden Sie diese Option, um fehlende Daten anzugeben oder eine Task zu aktualisieren.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen Daten für Zeilen oder Einträge angeben, für die Informationen fehlen oder die aktualisiert werden müssen.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install myapp.ear {-MapRolesToUsers {{"All Role" No Yes "" ""}
 {"Every Role" Yes No "" ""} {DenyAllRole No No user1 group1}}}

AdminApp.install('myapp.ear', '[-MapRolesToUsers [["All Role" No Yes "" ""]
 ["Every Role" Yes No "" ""] [DenyAllRole No No user1 group1]]]')

{{"All Role" No Yes "" ""} steht für Folgendes:

MapRunAsRolesToUsers

Mit der Option "MapRunAsRolesToUsers" RunAs-Rollen Benutzern zugeordnet. Die Enterprise-Beans, die Sie installieren, enthalten vordefinierte RunAs-Rollen. RunAs-Rollen werden von Enterprise-Beans verwendet, die bei der Interaktion mit einer anderen Enterprise-Bean mit einer bestimmten Rolle ausgeführt werden müssen. Verwenden Sie diese Option, um fehlende Daten anzugeben oder eine Task zu aktualisieren.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen Daten für Zeilen oder Einträge angeben, für die Informationen fehlen oder die aktualisiert werden müssen.

Verwendungsbeispiel für den Stapelmodus

Mit Jacl:

$AdminApp install C:/myapp.ear {-MapRunAsRolesToUsers {{UserRole user1 
 password1} {AdminRole administrator administrator}}}

$AdminApp install myapp.ear {-MapRunAsRolesToUsers {{UserRole user1
 password1} {AdminRole administrator administrator}}}

Mit Jython:

AdminApp.install('C:/myapp.ear', '[-MapRunAsRolesToUsers [[UserRole user1 
 password1] [AdminRole administrator administrator]]]')

AdminApp.install('myapp.ear', '[-MapRunAsRolesToUsers [[UserRole user1
 password1][AdminRole administrator administrator]]]')

MapSharedLibForMod

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname DynaCacheEsi -MapSharedLibForMod {{ DynaCacheEsi META-INF/application.xml
 sharedlib1 }{ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml sharedlib2 }}}

$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname DynaCacheEsi -MapSharedLibForMod {{ .* .* sharedlib1 }
 { .* .* sharedlib2 }}}

AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 '[ -MapSharedLibForMod [[ DynaCacheEsi META-INF/application.xml sharedlib1 ]
 [ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml sharedlib2 ]]]' )

AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 '[ -MapSharedLibForMod [[ .* .* sharedlib1 ][ .* .* sharedlib2 ]]]' )

MapWebModToVH

Wählt virtuelle Hosts für Webmodule aus. Geben Sie den virtuellen Host an, auf dem Sie die in Ihrer Anwendung enthaltenen Webmodule installieren möchten. Sie können Webmodule auf einem Server installieren oder sie auf mehrere Server verteilen. Verwenden Sie diese Option, um fehlende Daten anzugeben oder eine Task zu aktualisieren.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen. Sie müssen Daten für Zeilen oder Einträge angeben, für die Informationen fehlen oder die aktualisiert werden müssen.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname DynaCacheEsi
 -MapWebModToVH {{ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml default_host }}}

$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-MapWebModToVH {{ .* .* default_host }}}

AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 '[-MapWebModToVH [[ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml default_host ]]]') 

AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 ['-MapWebModToVH', [['.*', '.*', 'default_host']]])

MetadataCompleteForModules

Die Option MetadataCompleteForModules ermöglicht es jedem Modul ab Java EE 5, den kompletten Deployment-Deskriptor auszuschreiben, einschließlich der Deployment-Informationen aus den Annotationen. Anschließend markiert das System den Implementierungsdeskriptor für das Modul als vollständig.

Mit dem Befehl taskInfo des Objekts AdminApp können Sie Informationen zu den für die Anwendung erforderlichen Daten abrufen.

Verwendungsbeispiel für den Stapelmodus

Mit Jacl:

$AdminApp install c:/myapp.ear {-MetadataCompleteForModules
 {{EJBDD_1.jar EJBDD_1.jar,META-INF/ejb-jar.xml false}}}

$AdminApp install myapp.ear {-MetadataCompleteForModules
 {{EJBDD_1.jar EJBDD_1.jar,META-INF/ejb-jar.xml false}}}

Mit Jacl (Mustererkennung):

$AdminApp install c:/myapp.ear {-MetadataCompleteForModules
 {{.* EJBDD_1.jar,.* false}}}

$AdminApp install myapp.ear 
 {-MetadataCompleteForModules {{.* EJBDD_1.jar,.* false}}}

Mit Jython:

AdminApp.install('c:/myapp.ear', ['-MetadataCompleteForModules', 
 [['EJBDD_1,jar',  'EJBDD_1.jar,META-INF/ejb-jar.xml', 'false']]])

AdminApp.install('myapp.ear', ['-MetadataCompleteForModules',
 [['EJBDD_1,jar',  'EJBDD_1.jar,META-INF/ejb-jar.xml', 'false']]])

Mit Jython (Mustererkennung):

AdminApp.install('c:/myapp.ear', ['-MetadataCompleteForModules', [['.*',
 'EJBDD_1.jar,.*', 'false']]]

AdminApp.install('myapp.ear', 
 ['-MetadataCompleteForModules', [['.*', 'EJBDD_1.jar,.*', 'false']]]

ModuleBuildID

Die Option "ModuleBuildID" zeigt die Build-ID eines Moduls in einer Anwendungs-EAR-Datei an. Sie können diese Option nicht ändern, weil sie schreibgeschützt ist. Diese Option gibt die Buildinformationen für ein Modul zurück, wenn Sie die Build-ID in der Datei MANIFEST.MF eines Moduls oder einer Anwendungs-EAR-Datei angegeben haben. Die Buildinformationen setzen sich aus dem Modulnamen, dem Modul-URI und der Build-ID zusammen.

Verwendungsbeispiel für den Stapelmodus

Mit Jython:

print AdminApp.taskInfo('c:/temp/Cache2.ear', 'ModuleBuildID')

print AdminApp.taskInfo('/temp/Cache2.ear', 'ModuleBuildID')

noallowDispatchRemoteInclude

Die Option noallowDispatchRemoteInclude deaktiviert die Unternehmensanwendung, die includes über Webmodule in verschiedenen virtuellen Java-Maschinen in einer verwalteten Knotenumgebung über den standardmäßigen Request Dispatcher-Mechanismus an Ressourcen verteilt.

noallowPermInFilterPolicy

Mit der Option noallowPermInFilterPolicy wird festgelegt, dass der Anwendungsbereitstellungsprozess nicht fortgesetzt wird, wenn die Anwendung Richtlinienberechtigungen enthält, die in der Filterrichtlinie enthalten sind. Diese Option ist die Standardeinstellung und erfordert keinen Wert.

noallowServiceRemoteInclude

Die Option noallowServiceRemoteInclude deaktiviert die Unternehmensanwendung, die eine Include-Anfrage von einer Unternehmensanwendung bedient, bei der die Option allowDispatchRemoteInclude auf true gesetzt ist. Für diese Option gibt es keinen Standardwert.

Knoten

Gibt den Namen des Knotens an, auf dem eine vollständige Anwendung installiert bzw. aktualisiert oder eine Anwendung mit einem neuen Modul aktualisiert werden soll. Wenn Sie eine vollständige Anwendung aktualisieren möchten, ist diese Option nur gültig, wenn die Anwendung ein neues Modul enthält, das in der installierten Anwendung noch nicht vorhanden ist.

Verwendungsbeispiel für den Stapelmodus

Mit Jacl:

$AdminApp install "C:/myapp.ear" {-node nodeName}

$AdminApp install "/myapp.ear" {-node nodeName}

Mit Jython:

AdminApp.install('C:/myapp/myapp.ear', '[-node nodeName]')

AdminApp.install('/myapp/myapp.ear', '[-node nodeName]')

nocreateMBeansForResources

Die Option nocreateMBeansForResources legt fest, dass MBeans nicht für alle Ressourcen wie Servlets, JavaServer Pages-Dateien und Enterprise Beans erstellt werden, die in einer Anwendung definiert sind, wenn die Anwendung auf einem Bereitstellungsziel startet. Diese Option ist die Standardeinstellung und erfordert keinen Wert.

nodeployejb

Die Option nodeployejb legt fest, dass das EJBDeploy-Tool während der Installation nicht ausgeführt werden soll. Diese Option ist die Standardeinstellung und erfordert keinen Wert.

nodeployws

Die Option nodeployws legt fest, dass während der Installation keine Webdienste bereitgestellt werden sollen. Diese Option ist die Standardeinstellung und erfordert keinen Wert.

nodistributeApp

Die Option nodistributeApp legt fest, dass die Anwendungsverwaltungskomponente keine Anwendungsbinärdateien verteilt. Für diese Option ist kein Wert erforderlich. Die Standardeinstellung ist distributeApp.

noenableClientModule

Die Option noenableClientModule legt fest, dass keine Client-Module bereitgestellt werden. Für diese Option ist kein Wert erforderlich. Dies ist die Standardeinstellung. Standardmäßig werden Clientmodule nicht implementiert. Verwenden Sie die Option enableClientModule , um Client-Module bereitzustellen.

noreloadEnabled

Die Option noreloadEnabled deaktiviert das Nachladen von Klassen. Diese Option ist die Standardeinstellung und erfordert keinen Wert. Um anzugeben, dass das Dateisystem der Anwendung nach aktualisierten Dateien durchsucht werden soll, damit Änderungen dynamisch nachgeladen werden, verwenden Sie die Option reloadEnabled .

nopreCompileJSPs

Die Option nopreCompileJSPs legt fest, dass JavaServer Pages-Dateien nicht vorkompiliert werden sollen. Diese Option ist die Standardeinstellung und erfordert keinen Wert.

noprocessEmbeddedConfig

Die Option noprocessEmbeddedConfig gibt an, dass das System die eingebetteten Konfigurationsdaten, die in der Anwendung enthalten sind, ignorieren soll. Für diese Option ist kein Wert erforderlich. Wenn die EAR-Datei (Application Enterprise Archive) keine eingebetteten Konfigurationsdaten enthält, ist die Option noprocessEmbeddedConfig die Standardeinstellung. Ansonsten ist die Standardeinstellung die Option processEmbeddedConfig .

nouseAutoLink

Die Option nouseAutoLink legt fest, dass die Option useAutoLink nicht verwendet werden soll. Die Option legt auch fest, dass Enterprise JavaBeans (EJB)-Referenzen von EJB-Modulversionen vor EJB 3.0 und von Web-Modulversionen, die vor der Version 2.4 liegen, nicht automatisch aufgelöst werden. Für diese Option gibt es keinen Standardwert.

nouseMetaDataFromBinary

Die Option nouseMetaDataFromBinary gibt an, dass die Metadaten, die zur Laufzeit verwendet werden, z. B. Bereitstellungsdeskriptoren, Bindungen, Erweiterungen usw., aus dem Konfigurations-Repository stammen. Diese Option ist die Standardeinstellung und erfordert keinen Wert. Mit dieser Option können Sie anzeigen, dass die zur Laufzeit verwendeten Daten aus der EAR-Datei stammen müssen.

nousedefaultbindings

Die Option nousedefaultbindings legt fest, dass keine Standardbindungen für die Installation verwendet werden sollen. Diese Option ist die Standardeinstellung und erfordert keinen Wert.

novalidateSchema

Die Option novalidateSchema legt fest, dass die Deployment-Deskriptoren nicht gegen veröffentlichte Java EE Deployment-Deskriptor-Schemata validiert werden. Für diese Option ist kein Wert erforderlich. Dies ist die Standardeinstellung. Standardmäßig werden Implementierungsdeskriptor nicht validiert.

operation

Die Option "operation" ist erforderlich, wenn der Inhaltstyp "file" oder "modulefile" ist. Wenn der Inhaltstyp den Wert app hat, muss die Option "operation" den Wert update haben. Die Option "contenturi" wird ignoriert, wenn der Inhaltstyp app ist.

Verwendungsbeispiel für den Stapelmodus

Die folgenden Beispiele veranschaulichen, wie die Optionen für den Befehl update verwendet werden, um eine vollständige implementierte Unternehmensanwendung zu aktualisieren:

$AdminApp update "IVT Application" app {-operation update
 -contents app_server_root/installableApps/ivtApp.ear}

AdminApp.update('IVT Application', 'app', '[ -operation update
 -contents app_server_root/installableApps/ivtApp.ear ]' )

Das folgende Beispiel veranschaulicht, wie die Optionen für den Befehl update in einer einzelnen Datei in einer implementierten Anwendung verwendet werden sollen:

Mit Jacl:

$AdminApp update app1 file {-operation update -contents 
 C:/apps/app1/my.xml -contenturi app1.jar/my.xml}

$AdminApp update app1 file {-operation update 
 -contents /apps/app1/my.xml -contenturi app1.jar/my.xml}

Mit Jython (String):

AdminApp.update('app1', 'file', '[-operation update -contents 
 C:/apps/app1/my.xml -contenturi app1.jar/my.xml]')

AdminApp.update('app1', 'file', '[-operation update 
 -contents /apps/app1/my.xml -contenturi app1.jar/my.xml]')

Mit Jython (List):

AdminApp.update('app1', 'file', ['-operation', 'update', '-contents', 
 'C:/apps/app1/my.xml', '-contenturi', app1.jar/my.xml'])

AdminApp.update('app1', 'file', ['-operation',  'update', '-contents',
 '/apps/app1/my.xml', '-contenturi', app1.jar/my.xml'])

Für diese Angaben gilt Folgendes: AdminApp ist das Scripting-Objekt, update ist der Befehl, app1 der Name der zu aktualisierenden Anwendung, file der Inhaltstyp, operation ist eine Option des Befehls update, update der Wert der Option operation, contents ist eine Option des Befehls update, /apps/app1/my.xml ist der Wert der Option contents, contenturi ist eine Option des Befehls update, app1.jar/my.xml ist der Wert der Option contenturi.

preCompileJSPs

Die Option preCompileJSPs gibt an, dass die JavaServer Pages-Dateien vorkompiliert werden sollen. Für diese Option ist kein Wert erforderlich. Der Standardwert ist nopreCompileJSPs. Wenn Sie die JavaServer Pages-Dateien vorkompilieren möchten, geben Sie dies als Teil der Installation an. Standardmäßig werden JSP-Dateien nicht vorkompiliert. Die Option preCompileJSPs wird bei der Bereitstellung ignoriert und JavaServer Pages-Dateien werden nicht vorkompiliert. Das Flag wird automatisch von den Assembliertools gesetzt.

Installieren Sie bei dieser Option nur auf einem Bereitstellungsziel der Version 9.0, das die gleiche oder eine höhere Java SDK-Stufe als der Bereitstellungsmanager hat.

processEmbeddedConfig

Die Option processEmbeddedConfig verarbeitet die eingebetteten Konfigurationsdaten, die in der Anwendung enthalten sind. Für diese Option ist kein Wert erforderlich. Wenn die EAR-Datei der Anwendung integrierte Konfigurationsdaten enthält, ist diese Option die Standardeinstellung. Ist dies nicht der Fall, ist die Standardeinstellung die Option nonprocessEmbeddedConfig .

Diese Einstellung wirkt sich auf die Installation erweiterter EAR-Dateien aus. Eine erweiterte EAR-Datei wird beim Export einer installierten Anwendung generiert. Erweiterte EAR-Dateien haben eine integrierte Konfiguration, die sich aus Dateien wie resource.xml und variables.xml zusammensetzt. Diese Option lädt eine integrierte Konfiguration auf Anwendungsebene aus der EAR-Datei.

Wenn Sie die Anwendung aus einer anderen Zelle als der aktuellen Zelle exportiert haben und bei der Erstinstallation der Anwendung die Variable $(CELL) für die Option installed.ear.destination nicht angegeben haben, verwenden Sie die Option nonprocessEmbeddedConfig , um die erweiterte EAR-Datei im Verzeichnis profile_root/installedApps/current_cell_name zu erweitern. Andernfalls verwenden Sie diese Option processEmbeddedConfig , um die erweiterte EAR-Datei im Verzeichnis profile_root/installedApps/original_cell_name zu erweitern, wobei original_cell_name die Zelle ist, auf der die Anwendung zuerst installiert wurde. Wenn Sie bei der Erstinstallation der Anwendung die Variable $(CELL) für die Option installed.ear.destination angegeben haben, wird bei der Installation die erweiterte EAR-Datei in das Verzeichnis profile_root/installedApps/current_cell_name expandiert.

reloadEnabled

Die Option reloadEnabled legt fest, dass das Dateisystem der Anwendung nach aktualisierten Dateien durchsucht wird, so dass Änderungen dynamisch nachgeladen werden. Wenn diese Option aktiviert ist und die Anwendungsklassen geändert werden, wird die Anwendung gestoppt und anschließend erneut gestartet, um die aktualisierten Klassen zu laden. Diese Option ist nicht die Standardeinstellung und erfordert keinen Wert. Die Standardeinstellung ist die Option noreloadEnabled .

reloadInterval

Die Option reloadInterval gibt die Zeitspanne in Sekunden an, in der das Dateisystem der Anwendung nach aktualisierten Dateien durchsucht werden soll. Alle Werte größer als null sind gültig. Die Standardeinstellung sind drei Sekunden.

SharedLibRelationship

Die Option SharedLibRelationship weist Assets oder Composition Unit IDs als gemeinsame Bibliotheken für jedes Java EE Modul zu.

Wenn Sie mehrere Anlagen oder Kompositionseinheiten-IDs angeben möchten, trennen Sie die einzelnen Werte durch ein Pluszeichen (+).

Wenn Sie den Befehl edit für die Java EE-Anwendung verwenden, können Sie die Beziehung mit einer neuen Gruppe von Beziehungs-IDs für die Kompositionseinheit überschreiben, Kompositionseinheitenbeziehungen hinzufügen oder vorhandene Kompositionseinheitenbeziehungen entfernen. Mit dem Befehl edit kann keine Assetbeziehung angegeben werden. Geben Sie das Pluszeichen (+) als erstes Zeichen der Kompositionseinheiten-ID als, um die ID der Beziehung hinzuzufügen, oder geben Sie das Nummernzeichen (#) an, um die Kompositionseinheiten-ID aus vorhandenen Beziehungen zu entfernen. Mit der Kompositionseinheitensyntax +cuname=cu2.zip wird beispielsweise die Kompositionseinheit cu2 der Beziehung hinzugefügt. Mit der Kompositionseinheitensyntax #cuname=cu1.zip+cuname=cu2.zip werden die Kompositionseinheiten cu1 und cu2 aus der Beziehung entfernt.

Verwendungsbeispiel für den Stapelmodus

Mit Jacl:

$AdminApp install myapp.ear {-SharedLibRelationship {{EJB3BNDBean.jar 
 EJB3BNDBean.jar,META-INF/ejb-jar.xml WebSphere:cuname=sharedLibCU1 "" Yes}}}

Mit Jacl (Mustererkennung):

$AdminApp install myapp.ear {-SharedLibRelationship {{.*
 EJB3BNDBean.jar,.* WebSphere:cuname=sharedLibCU1 "" Yes}}}

Mit Jython:

AdminApp.install('myapp.ear', ['-SharedLibRelationship',
 [['EJB3BNDBean,jar', 'EJB3BNDBean.jar,META-INF/ejb-jar.xml',
 'WebSphere:cuname=sharedLibCU1,' '', 'Yes']]])

Mit Jython (Mustererkennung):

AdminApp.install('myapp.ear', ['-SharedLibRelationship', [['.*',
 'EJB3BNDBean.jar,.*', 'WebSphere:cuname=sharedLibCU1', '', 'Yes']]]

Server

Verwendungsbeispiel für den Stapelmodus

Mit Jacl:

$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-server server1}

Mit Jython:

AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 '[-server server1]')

target

Die Option target gibt das Ziel für die Installationsfunktionen des Objekts AdminApp an. Im Folgenden finden Sie ein Beispiel für eine Zieloption : WebSphere:cell=mycell,node=mynode,server=myserver

Verwendungsbeispiel für den Stapelmodus

Das folgende Beispiel gibt server1 als Zielserver für die Anwendungsinstallation an:

Mit Jacl:

$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname MyApp -target WebSphere:cell=myCell,node=myNode,server=server1}

Mit Jython:

AdminApp.install("app_server_root/installableApps/DynaCacheEsi.ear",
 ["-appname", "MyApp", "-target", "WebSphere:cell=myCell,node=myNode,server=server1"])

aktualisieren

Die Update-Option aktualisiert die installierte Anwendung mit einer neuen Version der Unternehmensarchivdatei (EAR). Für diese Option ist kein Wert erforderlich.

Die zu aktualisierende Anwendung, die mit der Option appname angegeben wird, muss bereits in der WebSphere® Application Server konfiguration installiert sein. Die Aktualisierungsaktion mischt Bindungen aus der neuen Version mit Bindungen aus der alten Version, deinstalliert die alte Version und installiert die neue Version. Die Bindungsinformationen aus der neuen Version der EAR-Datei wird den entsprechenden Informationen aus der alten Version vorgezogen. Wenn ein Bindungselement in der neuen Version fehlt, wird das entsprechende Element aus der alten Version verwendet.

update.ignore.new

Die Option "update.ignore.new" Bindungsinformationen aus der installierten Version der Anwendung oder des Moduls werden entsprechenden Bindungsinformationen aus der aktualisierten Version vorgezogen. Wenn ein Bindungselement in der installierten Version fehlt, wird das entsprechende Element aus der aktualisierten Version verwendet. Die Bindungsinformationen aus der aktualisierten Version der Anwendung oder des Moduls werden ignoriert, falls eine Bindung in der installierten Version vorhanden ist. Andernfalls werden die neuen Bindungen berücksichtigt und nicht ignoriert. Für diese Option ist kein Wert erforderlich.

update.ignore.old

useAutoLink

Verwenden Sie die Option useAutoLink , um automatisch Enterprise JavaBeans (EJB)-Referenzen von EJB-Modulversionen vor EJB 3.0 und von Web-Modulversionen vor Version 2.4 aufzulösen. Wenn Sie die Option useAutoLink aktivieren, können Sie optional den JNDI-Namen für die Option MapEJBRefToEJB angeben. Jedes Modul in der Anwendung muss dasselbe Ziel verwenden, damit "autolink" unterstützt wird.

Verwendungsbeispiel für den Stapelmodus

Mit Jacl:

$AdminApp install C:/myapp.ear {-useAutoLink} 

$AdminApp install /myapp.ear {-useAutoLink} 

Mit Jython:

AdminApp.install('C:/myapp.ear','[-useAutoLink]') 

AdminApp.install('myapp.ear','[-useAutoLink]') 

usedefaultbindings

Die Option usedefaultbindings legt fest, dass bei der Installation Standardbindungen verwendet werden sollen. Für diese Option ist kein Wert erforderlich. Die Standardeinstellung ist nousedefaultbindings.

Wenn Sie den vorhandenen Listener-Port verwenden möchten, anstatt eine Aktivierungsspezifikation zu verwenden oder eine neue zu erstellen, müssen Sie feststellen, ob die EJB-JAR-Version älter ist als Version 2.1. Das System erstellt und verwendet automatisch eine Aktivierungsspezifikation, wenn Sie die Option "-usedefaultbindings" zum Implementieren einer Anwendung angeben. Wenn eine Aktivierungsspezifikation vorhanden ist, ignoriert das System den Listener-Port und verwendet stattdessen die Aktivierungsspezifikation. Wenn Sie eine Anwendung mit einer EJB-JAR-Version größer-gleich 2.1 über die definierten Listener-Ports anstelle einer neuen Aktivierungsspezifikation implementieren möchten, setzen Sie die Systemeigenschaft com.ibm.websphere.management.application.dfltbndng.mdb.preferexisting in der Datei wsadmin.properties im Eigenschaftsverzeichnis des gewünschten Profils auf true .

useMetaDataFromBinary

Die Option useMetaDataFromBinary gibt an, dass die Metadaten, die zur Laufzeit verwendet werden, z. B. Bereitstellungsdeskriptoren, Bindungen, Erweiterungen usw., aus der EAR-Datei stammen. Für diese Option ist kein Wert erforderlich. Die Standardeinstellung ist nouseMetaDataFromBinary und bedeutet, dass die zur Laufzeit verwendeten Daten aus dem Konfigurationsrepository stammen müssen.

validateinstall

validateSchema

Die Option validateSchema gibt an, dass die Bereitstellungsdeskriptoren anhand der veröffentlichten Java EE Bereitstellungsdeskriptor-Schemata validiert werden sollen. Wenn diese Option für die Anwendungsimplementierung ausgewählt wird, analysiert das Produkt jeden Implementierungsdeskriptor, um die Version der Java EE-Spezifikation für den Implementierungsdeskriptor zu ermitteln, wählt das geeignete Schema aus und prüft den Implementierungsdeskriptor anschließend anhand des Java EE-Implementierungsdeskriptorschemas. Fehler bei der Validierung verursachen Fehlernachrichten.

Für diese Option ist kein Wert erforderlich. Der Standardwert ist novalidateSchema. Standardmäßig wird die Option validateSchema während der Bereitstellung ignoriert und das Produkt validiert keine Bereitstellungsdeskriptoren.

verbose

Die Option verbose bewirkt, dass während der Installation zusätzliche Meldungen angezeigt werden. Für diese Option ist kein Wert erforderlich.

WebServicesClientBindDeployedWSDL

Die Option WebServicesClientBindDeployedWSDL identifiziert den Client-Webdienst, den Sie ändern. Die Felder für die Zuweisung sind Module, EJB und Web-Service. Der einzige änderbare Wert für diese Task ist der Name der implementierten WSDL-Datei. Dieser Wert gibt die vom Client verwendete Web Services Description Language (WSDL) an.

Das Feld Module gibt die Enterprise- oder Webanwendung in der Anwendung an. Ist das Modul eine Enterprise-Bean, gibt das Feld EJB eine bestimmte Enterprise-Bean im Modul an. Das Feld Web-Service gibt den Web-Service im Enterprise-Bean- oder Webanwendungsmodul an. Diese Kennung entspricht dem Attribut "wsdl:service" in der WSDL-Datei mit dem Präfix service/, z. B. service/WSLoggerService2.

Das implementierte WSDL-Attribut benennt eine WSDL-Datei relativ zum Clientmodul. Ein Beispiel für eine implementierte WSDL für eine Webanwendung: WEB-INF/wsdl/WSLoggerService.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install WebServicesSamples.ear {-WebServicesClientBindDeployedWSDL {{AddressBookW2JE.jar 
 AddressBookW2JE service/WSLoggerService2 META-INF/wsdl/DeployedWsdl1.wsdl}}} 

$AdminApp install WebServicesSamples.ear {-WebServicesClientBindDeployedWSDL {{.*  .*  .*  
 META-INF/wsdl/DeployedWsdl1.wsdl}}}

$AdminApp install WebServicesSamples.ear {
-WebServicesClientBindDeployedWSDL {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
 META-INF/wsdl/DeployedWsdl1.wsdl}} 
-BindJndiForEJBNonMessageBinding {{ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml 
jndi1 "" "" } { "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" }{ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" }} 
-MapWebModToVH {{ "module_name" web_services.war,WEB-INF/web.xml default_host }
 { "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host }
 { "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host }} } 

AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindDeployedWSDL 
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 META-INF/wsdl/DeployedWsdl1.wsdl]]]') 

$AdminApp install WebServicesSamples.ear', '[ 
-WebServicesClientBindDeployedWSDL [[ AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
 META-INF/wsdl/DeployedWsdl1.wsdl ]] 
-BindJndiForEJBNonMessageBinding [[ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml 
jndi1 "" "" ] [ "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" ][ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" ]] 
-MapWebModToVH [[ "module_name" web_services.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host ]]]' ) 

AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindDeployedWSDL',
['.*', '.*', '.*',  'META-INF/wsdl/DeployedWsdl1.wsdl']]])

WebServicesClientBindPortInfo

Gibt den Port eines Client-Web-Service an, den Sie ändern möchten. Die Felder für die Zuweisung sind Module, EJB, Web-service und Port. Zu den veränderlichen Werten für diese Task gehören: Sync Timeout, BasicAuth ID, BasicAuth Password, SSL Configund Overridden Endpoint URI. Die Felder für Basisauthentifizierung und SSL wirken sich auf die Sicherheit auf Transportebene und nicht auf Web Services Security aus.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPortInfo {{AddressBookW2JE.jar 
 AddressBookW2JE service/WSLoggerService2 WSLoggerJMS 3000 newHTTP_ID newHTTP_pwd sslAliasConfig 
 http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS}}} 

$AdminApp install WebServicesSamples.ear {
-WebServicesClientBindPortInfo {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
 WSLoggerJMS 3000 newHTTP_ID newHTTP_pwd sslAliasConfig
 http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS}} 
-BindJndiForEJBNonMessageBinding {{ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml
 jndi1 "" "" }
 { "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" }{ "Address Book Sample
 EJB" com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" }} 
-MapWebModToVH {{ "module_name" web_services.war,WEB-INF/web.xml default_host }
 { "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host }
 { "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host }} } 

$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPortInfo {{.*  .*  .*  .*  3000 
 newHTTP_ID newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS}}}

AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindPortInfo
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS 3000 newHTTP_ID
 newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS]]]') 

AdminApp.install('WebServicesSamples.ear', '[ 
-WebServicesClientBindPortInfo [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS
 3000 newHTTP_ID newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS ]] 
-BindJndiForEJBNonMessageBinding [[ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml jndi1 "" "" ]
 [ "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" ][ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" ]] 
-MapWebModToVH [[ "module_name" web_services.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host ]]]' )

AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindPortInfo',
 [['.*', '.*', '.*', '.*', '3000', 'newHTTP_ID', 'newHTTP_pwd', 'sslAliasConfig',
 'http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS']]])

WebServicesClientBindPreferredPort

Verwendungsbeispiel für den Stapelmodus

$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPreferredPort
 {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS WSLoggerJMSPort}}} 

$AdminApp install WebServicesSamples.ear
{-WebServicesClientBindPreferredPort {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
 WSLoggerJMS WSLoggerJMSPort}}
-BindJndiForEJBNonMessageBinding {{ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml jndi1 "" "" }
 { "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" }{ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" }}
-MapWebModToVH {{ "module_name" web_services.war,WEB-INF/web.xml default_host }
 { "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host }
 { "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host }} } 

$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPreferredPort {{.* .* .* .* 
 WSLoggerJMSPort}}}

AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindPreferredPort 
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS WSLoggerJMSPort]]]') 

AdminApp.install('WebServicesSamples.ear',
'[ -WebServicesClientBindPreferredPort
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS WSLoggerJMSPort ]]
-BindJndiForEJBNonMessageBinding [[ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml jndi1 "" "" ]
 [ "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" ][ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" ]]
-MapWebModToVH [[ "module_name" web_services.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host ]]]' )

AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindPreferredPort',
 [['.*', '.*', '.*', '.*', 'WSLoggerJMSPort']]])

WebServicesServerBindPort

Die Option "WebServicesServerBindPort" definiert zwei Attribute eines Web-Service-Ports. Die unveränderlichen Werte geben den Port eines Web-Service an, den Sie ändern möchten. Die Felder für die Zuweisung sind Module, Web service und Port. Die änderbaren Werte sind WSDL Service Name und Scope.

Die Zuweisung bestimmt den Lebenszyklus für die Implementierung der JavaBean. Die gültigen Werte sind Request (neue Instanz für jede Anforderung), Application (eine Instanz für jede web-app) und Session (neue Instanz für jede HTTP-Sitzung).

Das Attribut scope gilt nicht für Web-Services, die einen JMS-Transport (Java Message Service) verwenden. Das Attribut gilt auch nicht für Enterprise-Beans.

Der Name des WSDL-Service (WSDL service name) gibt einen Service an, wenn mehrere Services mit demselben Portnamen vorhanden sind. Der Name des WSDL-Service wird als QName-Zeichenfolge, z. B. {namespace}localname, angegeben.

Verwendungsbeispiel für den Stapelmodus

$AdminApp install WebServicesSamples.ear {-WebServicesServerBindPort
 {{AddressBookW2JE.jar service/WSLoggerService2 WSLoggerJMS {} Session}}}

$AdminApp install WebServicesSamples.ear {-WebServicesServerBindPort
 {{.*  WSClientTestService WSClientTest Request} {.*  StockQuoteService StockQuote Application}
 {.*  StockQuoteService StockQuote2 Session}}}

AdminApp.install('WebServicesSamples.ear', '[-WebServicesServerBindPort
 [[AddressBookW2JE.jar service/WSLoggerService2 WSLoggerJMS "" Session]]]')

AdminApp.install('WebServicesSamples.ear', ['-WebServicesServerBindPort',
 [['.*', 'WSClientTestService', 'WSClientTest', 'Request'],
 ['.*', 'StockQuoteService', 'StockQuote', 'Application'],
 ['.*', 'StockQuoteService', 'StockQuote2', 'Session']]])

WebServicesClientCustomProperty

Unterstützt die Konfiguration des Name/Wert-Parameters für die Beschreibung der Client-BIND-Datei eines Web-Service. Die unveränderlichen Werte geben den Port des Web-Service an, den Sie ändern möchten. Die Felder für die Zuweisung sind Module, Web service und Port. Die änderbaren Werte sind name und value.

Das Format der Werte name und value umfassen eine Zeichenfolge, die mehrere Name/Wert-Paare angibt. Dabei wird das Zeichen + als Trennzeichen verwendet. Beispiel: Namenfolge = "n1+n2+n3" und Wertefolge = "v1+v2+v3" ergibt folgende Name/Wert-Paare: {{"n1" "v1"}, {"n2" "v2"}, {"n3" " v3"}},

Verwendungsbeispiel für den Stapelmodus

$AdminApp edit WebServicesSamples {-WebServicesClientCustomProperty
 {{join.jar com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest service/StockQuoteService
 STockQuote propname1 propValue1}
{ejbclientonly.jar Exchange service/STockQuoteService STockQuote propname2 propValue2}}}

$AdminApp edit WebServicesSamples {-WebServicesClientCustomProperty
 {{join.jar com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest .* .* propname1 propValue1}
 {ejbclientonly.jar Exchange .* .* propname2 propValue2}}}

AdminApp.edit('WebServicesSamples', ['-WebServicesClientCustomProperty',
 [['join.jar', 'com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest',
 'service/StockQuoteService', 'STockQuote', 'propname1', 'propValue1'],
 ['ejbclientonly.jar', 'Exchange', 'service/STockQuoteService', 'STockQuote',
 'propname2', 'propValue2']]])

AdminApp.edit('WebServicesSamples', ['-WebServicesClientCustomProperty',
 [['join.jar', 'com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest',
 '.*', '.*', 'propname1', 'propValue1'],
 ['ejbclientonly.jar', 'Exchange', '.*', '.*', 'propname2', 'propValue2']]])

WebServicesServerCustomProperty

Unterstützt die Konfiguration des Name/Wert-Parameters für die Beschreibung der Server-BIND-Datei eines Web-Service. Die Felder für die Zuweisung sind Module, EJB und Web-Service. Die änderbaren Werte für diese Task sind name und value.

Das Format dieser Werte ist eine Zeichenfolge, die mehrere Name/Wert-Paare, die Pluszeichen (+) getrennt sind, darstellt. Beispiel: Namenszeichenfolge = "n1+n2+n3" und Wertezeichenfolge = "v1+v2+v3" ergeben folgende Name/Wert-Paare: {{"n1" "v1"}, {"n2" "v2"}, {"n3" " v3"}}.

Verwendungsbeispiel für den Stapelmodus

$AdminApp edit WebServicesSamples {-WebServicesServerCustomProperty
 {{AddressBookW2JE.jar AddressBookService AddressBook
 com.ibm.websphere.webservices.http.responseContentEncoding deflate}}}

$AdminApp edit WebServicesSamples {-WebServicesServerCustomProperty
 {{.* .* .* com.ibm.websphere.webservices.http.responseContentEncoding deflate}}}

AdminApp.edit ( 'WebServicesSamples', '[ -WebServicesServerCustomProperty
 [[AddressBookW2JE.jar AddressBookService AddressBook
 com.ibm.websphere.webservices.http.responseContentEncoding deflate]]]')

AdminApp.edit ( 'WebServicesSamples', ['-WebServicesServerCustomProperty', [['.*', '.*',
 '.*', 'com.ibm.websphere.webservices.http.responseContentEncoding', 'deflate']]])