當使用 wsadmin Scripting 時,AdminApp 物件 install、installInteractive、edit、editInteractive、update 和 updateInteractive 指令的選項
這個主題列出 AdminApp 物件的 install、installInteractive、edit、editInteractive、update 和 updateInteractive 指令所能使用的選項。
您可以利用 AdminApp 物件的指令來安裝、編輯、更新和管理您的應用程式配置。 這個主題提供其他用來搭配 install、installInteractive、edit、editInteractive、update 和 updateInteractive 指令,以管理應用程式的選項。 除非另有附註,否則,這個主題列出的選項適用於所有這些指令。
您可以在批次模式下使用選項來設定或更新配置值。 為了識別要設定或更新哪一個配置物件,會使用唯讀欄位的值來尋找對應的配置物件。 所有的唯讀欄位值都必須符合現有的配置物件,否則指令會失敗。
您可以利用型樣比對來簡化提供所需特定複雜選項值的作業。 型樣比對只適用於必要欄位或唯讀欄位。
- ActSpecJNDI
- allowDispatchRemoteInclude
- allowPermInFilterPolicy
- allowServiceRemoteInclude
- 應用程式名稱
- BackendIdSelection
- BindJndiForEJBBusiness
- BindJndiForEJBMessageBinding
- BindJndiForEJBNonMessageBinding
- blaname
- buildVersion
- Cell
- clientMode
- 叢集
- 內容
- contenturi
- contextroot
- CorrectOracleIsolationLevel
- CorrectUseSystemIdentity
- createMBeansForResources
- CtxRootForWebMod
- 自訂
- CustomActivationPlan
- DataSourceFor10CMPBeans
- DataSourceFor20CMPBeans
- DataSourceFor10EJBModules
- DataSourceFor20EJBModules
- defaultbinding.cf.jndi
- defaultbinding.cf.resauth
- defaultbinding.datasource.jndi
- defaultbinding.datasource.password
- defaultbinding.datasource.username
- defaultbinding.ee.defaults
- defaultbinding.ejbjndi.prefix
- defaultbinding.force
- defaultbinding.strategy.file
- defaultbinding.virtual.host
- depl.extension.reg(已淘汰)
- deployejb
- deployejb.classpath
- deployejb.complianceLevel
- deployejb.dbschema
- deployejb.dbtype
- deployejb.dbaccesstype
- deployejb.rmic
- deployejb.sqljclasspath
- deployws
- deployws.classpath
- deployws.jardirs
- distributeApp
- EmbeddedRar
- enableClientModule
- EnsureMethodProtectionFor10EJB
- EnsureMethodProtectionFor20EJB
- filepermission
- installdir(已淘汰)
- installed.ear.destination
- JSPCompileOptions
- JSPReloadForWebMod
- MapEJBRefToEJB
- MapEnvEntryForApp
- MapEnvEntryForClientMod
- MapEnvEntryForEJBMod
- MapEnvEntryForWebMod
- MapInitParamForServlet
- MapJaspiProvider
- MapMessageDestinationRefToEJB
- MapModulesToServers
- MapResEnvRefToRes
- MapResRefToEJB
- MapRolesToUsers
- MapRunAsRolesToUsers
- MapSharedLibForMod
- MapWebModToVH
- MetadataCompleteForModules
- ModuleBuildID
- noallowDispatchRemoteInclude
- noallowPermInFilterPolicy
- noallowServiceRemoteInclude
- 節點
- nocreateMBeansForResources
- nodeployejb
- nodeployws
- nodistributeApp
- noenableClientModule
- noreloadEnabled
- nopreCompileJSPs
- noprocessEmbeddedConfig
- nouseAutoLink
- nouseMetaDataFromBinary
- nousedefaultbindings
- novalidateSchema
- 作業
- processEmbeddedConfig
- preCompileJSPs
- reloadEnabled
- reloadInterval
- SharedLibRelationship
- 伺服器
- 目標
- 更新
- update.ignore.new
- update.ignore.old
- useAutoLink
- usedefaultbindings
- useMetaDataFromBinary
- validateinstall
- validateSchema
- 詳細
- WebServicesClientBindDeployedWSDL
- WebServicesClientBindPortInfo
- WebServicesClientBindPreferredPort
- WebServicesServerBindPort
- WebServicesClientCustomProperty
- WebServicesServerCustomProperty
ActSpecJNDI
- RARModule: <rar module name>
- uri: <rar name>,META-INF/ra.xml
- Object identifier: <messageListenerType>
- JNDI 名稱:null
ra.xml
檔中指定 Destination
內容,將 Destination
內容的內部檢查類型設為 javax.jms.Destination
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您必須提供遺漏資訊或需要更新的列或項目的資料。
批次模式用法範例
$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
allowDispatchRemoteInclude 選項可讓企業應用程式透過標準要求分派器機制,將併入項目分派給受管理節點環境中不同 Java 虛擬機器的 Web 模組之間的資源。
批次模式用法範例
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
allowPermInFilterPolicy 選項指定即使應用程式包含過濾原則中的原則許可權,應用程式伺服器也應該繼續執行應用程式部署程序。 這個選項不需要值。
allowServiceRemoteInclude
allowServiceRemoteInclude 選項可供企業應用程式處理 allowDispatchRemoteInclude
選項設為 true
的企業應用程式所發出的併入要求。
批次模式用法範例
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)
appname
appname 選項指定應用程式的名稱。 預設值是應用程式的顯示名稱。
BackendIdSelection
BackendIdSelection 選項指定具有儲存器管理持續性 (CMP) Bean 之 Enterprise Bean Java 保存檔 (JAR) 模組的後端系統 ID。 Enterprise Bean JAR 模組可以利用應用程式組合工具,依照指定來支援多個後端配置。 在安裝期間,請利用這個選項來變更後端系統 ID。
批次模式用法範例
$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
BindJndiForEJBBusiness 選項會將含有商業介面的 EJB 模組連結到 JNDI 名稱。 請確定含有商業介面的每個 EJB 模組都連結了一個 JNDI 名稱。
- 模組:Ejb1
- Bean:MessageBean
- URI:sample.jar,META-INF/ejb-jar.xml
- 商業介面:com.ibm.sample.business.bnd.LocalTargetOne
- JNDI 名稱:[]: ejblocal:ejb/LocalTargetOne
如果您利用 BindJndiForEJBNonMessageBinding 選項來指定目標資源 JNDI 名稱,就不要在 BindJndiForEJBBusiness 選項中指定商業介面 JNDI 名稱。 如果未指定目標資源 JNDI 名稱,請指定商業介面 JNDI 名稱。 如果您並未指定商業介面 JNDI 名稱,執行時期會提供儲存器預設值。
如果是無介面視圖,商業介面值是空字串 (""
)。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您必須提供遺漏資訊或需要更新的列或項目的資料。
批次模式用法範例
$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
BindJndiForEJBMessage連結選項會將訊息驅動 Enterprise Bean 連結至接聽器埠名稱或啟動規格「Java 命名和目錄介面 (JNDI)」名稱。 請利用這個選項來提供遺漏的資料或更新作業。 當訊息驅動 Enterprise Bean 連結啟動規格 JNDI 名稱時,您也可以指定目的地 JNDI 名稱和鑑別別名。
BindJndiForEJBMessage連結選項的每一個元素由下列欄位組成 :EJBModule、EJB、uri、 listenerPort、JNDI、 jndi.dest和 actspec.auth。 部分欄位可以指派值: listenerPort、JNDI、 jndi.dest及 actspec.auth。
- 模組:Ejb1
- Bean:MessageBean
- URI:ejb-jar-ic.jar,META-INF/ejb-jar.xml
- 接聽器埠:[null]:
- JNDI 名稱:[eis/MessageBean]:
- 目的地 JNDI 名稱:[jms/TopicName]:
- ActivationSpec 鑑別別名:[null]:
如果未以註釋方式,或未在部署描述子中提供 destinationLookup 啟動配置內容,且 IBM 連結檔中沒有目的地 JNDI 名稱,會從對應的訊息參照中收集預設的「目的地 JNDI 名稱」。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您必須提供遺漏資訊或需要更新的列或項目的資料。
批次模式用法範例
$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
BindJndiForEJBNonMessageBinding 選項會將 Enterprise Bean 連結至「Java 命名和目錄介面 (JNDI)」名稱。 請確定您的應用程式或模組中的每個非訊息驅動 Enterprise Bean 都連結了一個 JNDI 名稱。 請利用這個選項來提供遺漏的資料或更新作業。
- 模組:Ejb1
- Bean:MessageBean
- URI:ejb-jar-ic.jar,META-INF/ejb-jar.xml
- 目標資源 JNDI 名稱:[com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC]
- 本端起始位置 JNDI 名稱:[null]
- 遠端起始位置 JNDI 名稱:[null]
Enterprise JavaBeans (EJB) 3.0 以及更新版本模組有特殊限制。 如果您指定目標資源 JNDI 名稱,就不要指定本端起始位置或遠端起始位置 JNDI 名稱。 另外,您也不能在 BindJndiForEJBBusiness 選項中,指定商業介面欄位的 JNDI。 如果未指定目標資源 JNDI 名稱,本端和遠端起始位置 JNDI 名稱欄位就是選用的。 如果未指定本端和遠端 JNDI 名稱,執行時期會提供儲存器預設值。
如果未使用 EJB 3.0 模組,您必須指定目標資源 JNDI 名稱。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您必須提供遺漏資訊或需要更新的列或項目的資料。
批次模式用法範例
使用 Jacl:
$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 "" "" }}}
使用 Jython:
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
請利用 blaname 選項來指定系統用來建立 Java EE 應用程式的商業層次應用程式名稱。 這個選項是選用的。 如果未指定值,系統會將名稱設為 Java EE 應用程式名稱。 只有 install 指令可以使用這個選項。
buildVersion
buildVersion 選項會顯示應用程式 EAR 檔的建置版本。 您無法修改這個選項,因為它是唯讀的。 如果您在 MANIFEST.MF
應用程式 EAR 檔中指定了建置版本,這個選項會傳回應用程式 EAR 的建置版本資訊。
Cell
cell 選項指定 Cell 名稱來安裝或更新整個應用程式,或更新應用程式以便新增模組。 如果您想要更新整個應用程式,只有在應用程式包含已安裝的應用程式中沒有的新模組時,這個選項才適用。
批次模式用法範例
使用 Jacl:
$AdminApp install "/apps/myapps/installableApps/JobbankTargetEJBApp.ear" {-cell cellName}
使用 Jython:
AdminApp.install('/apps/myapps/installableApps/JobbankTargetEJBApp.ear', '[-cell cellName]')
clientMode
clientMode 選項指定是否將用戶端模組部署至隔離的部署目標 (isolated
)、部署管理程式的聯合節點 (federated
) 或應用程式伺服器 (server_deployed
)。 如果您指定這個選項,只會將用戶端模組安裝到 8.0 版或更新版本的部署目標。
預設值是 isolated
。
用戶端部署模式選項會影響 java:
查閱的處理方式。 所有 Java URL 名稱空間(廣域、應用程式、模組和元件)都在隔離的用戶端程序的本端中。 名稱空間所在的伺服器,是在「聯合」和「已部署的伺服器」用戶端程序中。 所選作為用戶端模組目標的伺服器或叢集,決定了這些名稱空間的建立位置。 所有對象是「聯合」或「已部署的伺服器」用戶端模組的 java:
查閱,都會導向目標伺服器或叢集。 用戶端模組實際上不會在目標伺服器或叢集中執行。 多個相同用戶端模組的實例,全部都會共用「聯合」和「已部署的伺服器」模式中的元件名稱空間。 選擇「聯合」模式只是宣告利用「Java 網路啟動通訊協定 (JNLP)」來啟動用戶端模組的意圖,但對於「聯合」和「已部署的伺服器」這兩個模式而言,「Java 命名和目錄介面 (JNDI)」機制是相同的。
叢集
cluster 選項指定叢集名稱來安裝或更新整個應用程式,或更新應用程式以便新增模組。 此選項僅適用於 WebSphere® Application Server Network Deployment 環境。 如果您想要更新整個應用程式,只有在應用程式包含已安裝的應用程式中沒有的新模組時,這個選項才適用。 您無法同時使用 -cluster 和 -server 選項。
如果您想要部署應用程式,以及在部署期間指定 HTTP 伺服器,使應用程式出現在產生的 plugin-cfg.xml
檔中,那麼您必須先以 -cluster 為目標來安裝應用程式。 安裝好應用程式之後,在您儲存之前,請利用 AdminApp 物件的 edit 指令來新增其他對映到 Web 伺服器。
批次模式用法範例
使用 Jacl:
$AdminApp install "myapp.ear" {-cluster clusterName}
使用 Jython:
AdminApp.install('/myapp/myapp.ear', '[-cluster clusterName]')
內容
contents 選項指定含有要更新之內容的檔案。 例如,依內容類型而定,這個檔案可能是 EAR 檔、模組、局部 zip 或單一檔案。 檔案路徑必須是在 Scripting 用戶端的本端。 除非您指定了 delete
選項,否則 contents
選項是必要的。
contenturi
contenturi 選項指定應用程式中要新增、更新或移除之檔案的 URI。 這個選項只適用於 update 指令。 如果內容類型是 file
或 modulefile
,就需要 contenturi
選項。 其他內容類型會忽略這個選項。
contextroot
contextroot 選項指定安裝獨立式 Web 應用程式保存檔 (WAR) 時所用的環境定義根目錄。
CorrectOracleIsolationLevel
CorrectOracleIsolationLevel 選項指定 Oracle 類型提供者的隔離層次。 請利用這個選項來提供遺漏的資料或更新作業。 每個項目的最後一個欄位指定隔離層次。 有效的隔離層次值為:2
或 4
。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您只需要提供遺漏資訊或需要更新的列或項目的資料。
批次模式用法範例
$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
CorrectUseSystemIdentity 選項會將「執行系統身分」取代為「執行身分角色」。 您安裝的 Enterprise Bean 包含一個執行系統身分。 您可以選擇性地將這個身分改成執行身分角色。 請利用這個選項來提供遺漏的資料或更新作業。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您必須提供遺漏資訊或需要更新的列或項目的資料。
批次模式用法範例
$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
createMBeanForResources 選項指定在部署目標上啟動應用程式時,建立應用程式中所定義之所有資源(如:Servlet、JavaServer Pages (JSP) 檔和 Enterprise Bean 等)的 MBean。 這個選項不需要值。 預設值是 nocreateMBeanForResources 選項。
CtxRootForWebMod
application.xml
檔中所定義的環境定義根目錄。 執行預設連結之後,這個選項的現行內容如下:- Web 模組:xxx
- URI:xxx
- ContextRoot: <context root>
批次模式用法範例
使用 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}}}
使用 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']]])
自訂
自訂選項利用 name=value
格式來指定名稱值配對。 請利用 custom
選項,將各選項傳遞給應用程式部署延伸。 請參閱應用程式部署延伸說明文件,以瞭解可用的自訂選項。
CustomActivationPlan
CustomActivationPlan 選項指定用來執行應用程式的預設執行時期元件中,所要新增或移除的執行時期元件。 請只在應用程式伺服器無法檢查應用程式來取得所有必要的執行時期元件時,才使用這個選項。
批次模式用法範例
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 ""]]')
元件 | WS_ComponentToAdd 值 |
---|---|
EJB 儲存器 | WS_EJBContainer |
Portlet 儲存器 | WS_PortletContainer |
JavaServer Faces (JSF) | WS_JSF |
SIP 儲存器 | WS_SipContainer |
補償範圍服務 | WS_Compensation |
應用程式設定檔 | WS_AppProfile |
活動階段作業 | WS_ActivitySession |
國際化 | WS_I18N |
啟動 Bean | WS_StartupService |
DataSourceFor10CMPBeans
DataSourceFor10CMPBeans 選項指定個別的 1.x 儲存器管理持續性 (CMP) Bean 的選用資料來源。 請利用這個選項來提供遺漏的資料或更新作業。
將特定資料來源對映至 CMP Bean 會置換含有 Enterprise Bean 的模組之預設資料來源。 DataSourceFor10CMPBeans 選項的每個元素都由下列欄位組成:EJBModule、EJB、uri、JNDI、userName、password、login.config.name 和 auth.props。 在這些欄位中,您可以指派下列欄位值:JNDI、userName、password、login.config.name 和 auth.props。
- 模組:Increment CMP 1.1 EJB
- Bean:IncCMP11
- URI:IncCMP11.jar,META-INF/ejb-jar.xml
- 目標資源 JNDI 名稱:[DefaultDatasource]:
- 使用者名稱:[null]:
- 密碼:[null]:
- 登入配置名稱:[null]: 請利用這個選項來建立自訂登入配置。 用戶端可以利用 JAAS 來建立登入設計。
- 內容:[null]: 請利用這個選項來建立自訂登入配置。 用戶端可以利用 JAAS 來建立登入設計。
如果 login.config.name 設為 DefaultPrincipalMapping,就會利用 com.ibm.mapping.authDataAlias 這個名稱來建立內容。 內容值由 auth.props 來設定。 如果 login.config 名稱未設為 DefaultPrincipalMapping,則 auth.props 可以指定多個內容。 字串格式為 websphere:name= <name1>,value=<value1>,description=<desc1>。 請使用加號 (+) 來指定多個內容。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您必須提供遺漏資訊或需要更新的列或項目的資料。
批次模式用法範例
使用 Jacl:
$AdminApp install myapp.ear {-DataSourceFor10CMPBeans {{"Increment CMP 1.1 EJB" IncCMP11
IncCMP11.jar,META-INF/ejb-jar.xml myJNDI user1 password1 loginName1 authProps1}}}
搭配型樣比對來使用 Jacl:
$AdminApp install myapp.ear {-DataSourceFor10CMPBeans {{.* .* IncCMP11.jar,.*
myJNDI user1 password1 loginName1 authProps1}}}
使用 Jython:
AdminApp.install('myapp.ear', ['-DataSourceFor10CMPBeans', [["Increment CMP 1.1 EJB",
'IncCMP11', 'IncCMP11.jar,META-INF/ejb-jar.xml', 'myJNDI', 'user1',
'password1', 'loginName1', 'authProps1']]])
搭配型樣比對來使用 Jython:
AdminApp.install('myapp.ear', ['-DataSourceFor10CMPBeans', [['.*', '.*',
'IncCMP11.jar,.*', 'myJNDI', 'user1', 'password1', 'loginName1', 'authProps1']]])
DataSourceFor20CMPBeans
DataSourceFor20CMPBeans 選項指定個別的 2.x 儲存器管理持續性 (CMP) Bean 的選用資料來源。 請利用這個選項來提供遺漏的資料或更新作業。
將特定資料來源對映至 CMP Bean 會置換含有 Enterprise Bean 的模組之預設資料來源。 DataSourceFor20CMPBeans 選項的每個元素都由下列欄位組成:EJBModule、EJB、uri、JNDI、resAuth、login.config.name 和 auth.props。 在這些欄位中,您可以指派下列欄位值:JNDI、resAuth、login.config.name 和 auth.props。
- 模組:Increment Enterprise Bean
- Bean:Increment
- URI:Increment.jar,META-INF/ejb-jar.xml
- 目標資源 JNDI 名稱:[null]:
- 資源權限:[每一個應用程式]:
- 登入配置名稱:[null]: 請利用這個選項來建立自訂登入配置。 用戶端可以利用 JAAS 來建立登入設計。
- 內容:[]: 請利用這個選項來建立自訂登入配置。 用戶端可以利用 JAAS 來建立登入設計。
如果 login.config.name 設為 DefaultPrincipalMapping,就會利用 com.ibm.mapping.authDataAlias 這個名稱來建立內容。 內容值由 auth.props 來設定。 如果 login.config 名稱未設為 DefaultPrincipalMapping,則 auth.props 可以指定多個內容。 字串格式為 websphere:name= <name1>,value=<value1>,description=<desc1>。 請使用加號 (+) 來指定多個內容。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您只需要提供遺漏資訊或需要更新的列或項目的資料。
批次模式用法範例
$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
DataSourceFor10EJBModules 選項指定包含 1.x 儲存器管理持續性 (CMP) Bean 之 Enterprise Bean 模組的預設資料來源。 請利用這個選項來提供遺漏的資料或更新作業。
DataSourceFor10EJBModules 選項的每個元素都由下列欄位組成:EJBModule、uri、JNDI、userName、password、login.config.name 和 auth.props。 在這些欄位中,您可以指派下列欄位值:JNDI、userName、password、login.config.name 和 auth.props。
- 模組:Increment CMP 1.1 Enterprise Bean
- uri:IncCMP11.jar,META-INF/ejb-jar.xml
- 目標資源 JNDI 名稱:[DefaultDatasource]:
- 使用者名稱:[null]:
- 密碼:[null]:
- 登入配置名稱:[null]: 請利用這個選項來建立自訂登入配置。 用戶端可以利用 JAAS 來建立登入設計。
- 內容:[null]: 請利用這個選項來建立自訂登入配置。 用戶端可以利用 JAAS 來建立登入設計。
如果 login.config.name 設為 DefaultPrincipalMapping,就會利用 com.ibm.mapping.authDataAlias 這個名稱來建立內容。 內容值由 auth.props 來設定。 如果 login.config 名稱未設為 DefaultPrincipalMapping,則 auth.props 可以指定多個內容。 字串格式為 websphere:name= <name1>,value=<value1>,description=<desc1>。 請使用加號 (+) 來指定多個內容。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您必須提供遺漏資訊或需要更新的列或項目的資料。
批次模式用法範例
$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
DataSourceFor20EJBModules 選項指定包含 2.x 儲存器管理持續性 (CMP) Bean 之 Enterprise Bean 2.x 模組的預設資料來源。 請利用這個選項來提供遺漏的資料或更新作業。
DataSourceFor20EJBModules 選項的每個元素都由下列欄位組成:EJBModule、uri、JNDI、resAuth、login.config.name 和 auth.props。 在這些欄位中,您可以指派下列欄位值:JNDI、resAuth、login.config.name、auth.props 和延伸資料來源內容。
- 模組:Increment Enterprise Bean
- URI:Increment.jar,META-INF/ejb-jar.xml
- 目標資源 JNDI 名稱:[DefaultDatasource]:
- 資源權限:[每一個應用程式]:
- 登入配置名稱:[null]: 請利用這個選項來建立自訂登入配置。 用戶端可以利用 JAAS 來建立登入設計。
- 內容:[]: 請利用這個選項來建立自訂登入配置。 用戶端可以利用 JAAS 來建立登入設計。
- 延伸資料來源內容: []: 請使用這個選項,讓使用異質儲存區的資料來源可以連接至 DB2® 資料庫。 內容型樣如下:
property1=value1+property2=value2
。
這項作業每個項目的最後一個欄位都用來指定資源權限值。 資源權限的有效值如下:per connection factory
或 container
。
如果 login.config.name 設為 DefaultPrincipalMapping,就會利用 com.ibm.mapping.authDataAlias 這個名稱來建立內容。 內容值由 auth.props 來設定。 如果 login.config 名稱未設為 DefaultPrincipalMapping,則 auth.props 可以指定多個內容。 字串格式為 websphere:name= <name1>,value=<value1>,description=<desc1>。 請使用加號 (+) 來指定多個內容。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您必須提供遺漏資訊或需要更新的列或項目的資料。
批次模式用法範例
$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
defaultbinding.cf.jndi 選項指定預設 Connection Factory 的「Java 命名和目錄介面 (JNDI)」名稱。
defaultbinding.cf.resauth
defaultbinding.cf.resauth 選項指定 Connection Factory 的 RESAUTH。
defaultbinding.datasource.jndi
defaultbinding.datasource.jndi 選項指定預設資料來源的「Java 命名和目錄介面 (JNDI)」名稱。
defaultbinding.datasource.password
defaultbinding.datasource.password 選項指定預設資料來源的密碼。
defaultbinding.datasource.username
defaultbinding.datasource.username 選項指定預設資料來源的使用者名稱。
defaultbinding.ee.defaults
defaultbinding.ee.defaults 選項指定 Java EE預先配置的預設資源選項。
defaultbinding.ejbjndi.prefix
defaultbinding.ejbjndi.prefix 選項指定 Enterprise Bean「Java 命名和目錄介面 (JNDI)」名稱的字首。
如果要在 z/OS® 平台上使用 defaultbinding.ejbjndi.prefix 選項,您也必須指定 usedefaultbindings 選項。 如果未指定使用 usedefaultbindings 選項,預設值就是 nousedefaultbindings 選項。
defaultbinding.force
defaultbinding.force 選項指定預設連結置換現行連結。
defaultbinding.strategy.file
defaultbinding.strategy.file 選項指定自訂預設連結策略檔。
defaultbinding.virtual.host
defaultbinding.virtual.host 選項指定虛擬主機的預設名稱。
depl.extension.reg(已淘汰)
deployejb
deployejb 選項指定在安裝期間執行 EJBDeploy 工具。 這個選項不需要值。 EJBDeploy 工具只在 EJB 1.x 或 2.x 模組安裝期間執行。 安裝 EJB 3.x 版模組期間,並不會執行 EJB 部署工具。
當要安裝或更新的 EAR 或模組包含 Java Platform, Enterprise Edition (Java EE) 7 應用程式部署描述子、EJB 3.2 模組部署描述子或 Web 3.1 模組部署描述子時,會忽略這個選項。
如果您利用 EJBDeploy 工具來預先部署應用程式企業保存檔 (EAR),則預設值是 nodeployejb
。 否則,預設值是 deployejb
。
- EAR 檔是利用 Rational® Application Developer 等組合工具來組合的,且組合期間未執行 EJBDeploy 工具。
- EAR 檔不是利用 Rational Application Developer 等組合工具來組合的。
- 使用 5.0 版以前的應用程式組合工具 (AAT) 版本組合了 EAR 檔。
如果 EJB 模組包裝在 Web 保存檔 (WAR) 中,您不需要使用這個 deployejb 選項。
對於此選項,僅安裝至 9.0版 部署目標,其 Java SDK 層次與部署管理程式相同或更高。
deployejb.classpath
deployejb.classpath 選項指定 EJBDeploy 工具的額外類別路徑。
deployejb.complianceLevel
deployejb.complianceLevel 選項指定 EJBDeploy 工具的 JDK 相符性層次。
1.4 (default) 5.0 6.0
如需目前支援的 JDK 相符性層次清單,請執行 ejbdeploy -?
指令。
deployejb.dbschema
deployejb.dbschema 選項指定 EJBDeploy 工具的資料庫綱目。
deployejb.dbtype
deployejb.dbtype 選項指定 EJBDeploy 工具的資料庫類型。
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
下列資料庫支援「Java 的結構化查詢語言 (SQLJ)」:DB2UDB_V82、DB2UDB_V81、DB2UDBOS390_V7 和 DB2UDBOS390_V8。如需支援的資料庫供應商類型清單,請執行 ejbdeploy -?
指令。
deployejb.dbaccesstype
deployejb.dbaccesstype 選項指定 EJBDeploy 工具的資料庫存取類型。 有效值如下:SQLj
和 JDBC
。 預設值為 JDBC
。
deployejb.rmic
deployejb.rmic 選項指定要用於 EJBDeploy 工具的額外 RMIC 選項。
deployejb.sqljclasspath
deployejb.sqljclasspath 選項指定 SQLJ 轉換器類別的位置。
deployws
deployws 選項指定在安裝期間部署 Web 服務。 這個選項不需要值。
預設值如下:nodeployws
。
對於此選項,僅安裝至 9.0版 部署目標,其 Java SDK 層次與部署管理程式相同或更高。
deployws.classpath
deployws.classpath 選項指定部署 Web 服務時所用的額外類別路徑。
如果要指定多個項目的類別路徑,請利用搭配 CLASSPATH 環境變數使用時所用的相同分隔字元來分開各個項目。
使用冒號 (:) 來分開各個項目。
deployws.jardirs
deployws.jardirs 選項指定部署 Web 服務時所用的額外延伸目錄。
distributeApp
distributeApp 選項指定應用程式管理元件配送應用程式二進位檔。 這個選項不需要值。 這個設定是預設值。
EmbeddedRar
EmbeddedRar 選項會將 Java 2 Connector 物件連結到 JNDI 名稱。 您必須將應用程式或模組中的每個 Java 2 Connector 物件(如:J2C Connection Factory、J2C 啟動規格和 J2C 管理物件)連結到 JNDI 名稱。 EmbeddedRar 選項的每一個元素都包含下列欄位: RARModule
、 uri
、 j2cid
、 j2c.name
、 j2c.jndiName
。 您可以將下列值指派給欄位: 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
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您必須提供遺漏資訊或需要更新的列或項目的資料。
If the ID is not unique in the ra.xml file, -<number> will be added. 例如,javax.sql.DataSource-2。
批次模式用法範例
$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
enableClientModule 選項指定部署用戶端模組。 如果要部署的檔案有一或多個要部署的用戶端模組,請選取這個選項。 如果您選取這個選項,則只能將用戶端模組安裝到 8.0 版或更新版的部署目標。
這個選項不需要值。 預設值是 noenableClientModule。 依預設,在部署期間,會忽略 enableClientModule 選項,不會部署用戶端模組。
EnsureMethodProtectionFor10EJB
EnsureMethodProtectionFor10EJB 選項會選取 1.x Enterprise Bean 未受保護之方法的方法保護。 請指定保留方法未受保護的狀態,或指派會拒絕所有存取的保護。 請利用這個選項來提供遺漏的資料或更新作業。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您必須提供遺漏資訊或需要更新的列或項目的資料。
批次模式用法範例
$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']]])
這項作業每個項目的最後一個欄位都用來指定保護值。 有效的保護值包括:methodProtection.denyAllPermission
。 如果您想要保留方法未受保護的狀態,這個值也可以保留空白。
EnsureMethodProtectionFor20EJB
EnsureMethodProtectionFor20EJB 選項會選取 2.x Enterprise Bean 未受保護之方法的方法保護。 請指定將安全角色指派給未受保護的方法、新增方法到排除清單中,或將方法標示為已清除。 您可以用逗號來區隔各個角色名稱,來指派多個角色給一個方法。 請利用這個選項來提供遺漏的資料或更新作業。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您必須提供遺漏資訊或需要更新現有資料的列或項目的資料。
批次模式用法範例
使用 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}}}
搭配型樣比對來使用 Jacl:
$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']]])
這項作業每個項目的最後一個欄位都用來指定保護值。 有效的保護值包括:methodProtection.uncheck
、methodProtection.exclude
,或用逗點區隔的安全角色清單。
filepermission
.*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755
批次模式用法範例
$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(已淘汰)
installed.ear.destination
選項取代了這個選項。installed.ear.destination
installed.ear.destination 選項指定用來放置應用程式二進位檔的目錄。
JSPCompileOptions
- Web 模組:xxx
- URI:xxx
- JSP Class Path: <jsp class path>
- 使用完整套件名稱:Yes | No
- JDK 來源層次:xx
- 停用 JSP 執行時期編譯:Yes | No
對於「使用完整套件名稱」和「停用 JSP 執行時期編」,請以語言環境專用的語言來指定 Yes
或 No
。 產品支援值 AppDeploymentOption.Yes
和 AppDeploymentOption.No
,而不是 Yes
和 No
。 不過,建議您以語言環境的語言來指定 Yes
或 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}}}
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
- Web 模組:xxx
- URI:xxx
- JSP enable class reloading: <Yes | No>
- JSP reload interval in seconds: <jsp reload internal number>
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。
對於 JSP 啟用重新載入類別功能,請以語言環境專用的語言來指定 Yes
或 No
值。 產品支援值 AppDeploymentOption.Yes
和 AppDeploymentOption.No
,而不是 Yes
和 No
。 不過,建議您以語言環境的語言來指定 Yes
或 No
。
批次模式用法範例
$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']]])
不過, Java EE 5 或更新版本的模組可以存在於包含Java EE 5 之前的檔案且使用 .xmi 副檔名的應用程式內。
ibm-webservices-ext.xmi、 ibm-webservices-bnd.xmi、 ibm-webservicesclient-bnd.xmi、 ibm-webservicesclient-ext.xmi及 ibm-portlet-ext.xmi 檔案會繼續使用 .xmi 副檔名。
MapEJBRefToEJB
MapEJBRefToEJB 選項會將 Enterprise Java 參照對映至 Enterprise Bean。 您必須將您的應用程式所定義的每個 Enterprise Bean 參照對映至某個 Enterprise Bean。 使用此選項來提供遺漏資料或更新作業。
如果是從 EJB 3.x、Web 2.4 或 Web 2.5 模組進行 EJB 參照,JNDI 名稱便是選用的。 如果您指定 useAutoLink 選項,JNDI 名稱就是選用的。 執行時期提供儲存器預設值。 EJB 3.0 或更新版本的模組不能包含儲存器管理或 Bean 管理持續性的 Entity Bean。 如果將儲存器管理或 Bean 管理持續性的 Entity Bean 包裝在 Java EE 應用程式的 EJB 3.x 模組中,安裝會失敗。 您只能將儲存器管理或 Bean 管理持續性的 Bean 包裝在 EJB 2.1 或更早版本的模組中。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您只需要提供遺漏資訊或您想要更新其現有資料的列或項目的資料。
批次模式用法範例
使用 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}}}
搭配型樣比對來使用 Jacl:
$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]]]')
搭配型樣比對來使用 Jython:
AdminApp.install('myapp.ear', ['-MapEJBRefToEJB',
[['.*', '.*', '.*', '.*', '.*', 'MyBean']]])
MapEnvEntryForApp
MapEnvEntryForApp 選項會編輯應用程式的 env-entry 值。 您可以利用這個選項來編輯 application.xml 檔中的 env-entry 值。
- 名稱:xxx
- 類型:xxx
- 說明:xxx避免麻煩: 在執行預設連結之後,如果值是 null 值,您必須將值變更為 .* ,才能執行這項作業。 .* 值是萬用字元值,任何說明都會成為相符項目。 如果您將值保留為 null,則當您執行 MapEnvEntryFor應用程式作業時,會發生異常狀況。
- Value: <env-entry value>
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。
批次模式用法範例
$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']]])
如果說明中有換行字元,請使用下列語法:
$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
MapEnvEntryForClientMod 選項會編輯用戶端模組的 env-entry 值。 您可以利用這個選項來編輯用戶端模組 application-client.xml 檔中的環境項目值。
- 用戶端模組:xxx
- URI:xxx
- 名稱:xxx
- 類型:xxx
- 說明:xxx
- Value: <env-entry value>
請利用 AdminApp 物件的 taskInfo 指令來取得用戶端模組所需資料的相關資訊。
批次模式用法範例
$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']]])
如果說明中有換行字元,請使用下列語法:
$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForClientMod {{.* .* .*
(?s).* newValue}}}
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForClientMod',
[['.*', '.*', '.*', '(?s).*', '*', '*' 'newValue']]])
MapEnvEntryForEJBMod
MapEnvEntryForEJBMod 選項會編輯 EJB 模組的 env-entry 值。 您可以利用這個選項來編輯 EJB 模組 ejb-jar.xml 中的環境項目值。
- 模組:xxx
- URI:xxx
- Bean:xxx
- 名稱:xxx
- 類型:xxx
- 說明:xxx避免麻煩: 在執行預設連結之後,如果值是 null 值,您必須將值變更為 .* ,才能執行這項作業。 .* 值是萬用字元值,任何說明都會成為相符項目。 如果您將值保留為 null,當您執行 MapEnvEntryForEJBMod 作業時,會發生 WASX7017E 和 WASX7111E 異常狀況。
- Value: <env-entry value>
如果 EJB 模組使用 EJB 3.0 或更新的版本,就只會從 XML 部署描述子中移入這個選項的內容。 您無法利用這個選項,從註釋取得部署資訊。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。
批次模式用法範例
$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']]])
如果說明中有換行字元,請使用下列語法:
$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForEJBMod {{.* .* .*
(?s).* newValue}}}
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForEJBMod',
[['.*', '.*', '.*', '(?s).*', '*', '*' 'newValue']]])
MapEnvEntryForWebMod
MapEnvEntryForWebMod 選項會編輯 Web 模組的 env-entry 值。 您可以利用這個選項來編輯 web.xml 檔中的 env-entry 值。
- Web 模組:xxx
- URI:xxx
- 名稱:xxx
- 類型:xxx
- 說明:xxx避免麻煩: 在執行預設連結之後,如果值是 null 值,您必須將值變更為 .* ,才能執行這項作業。 .* 值是萬用字元值,任何說明都會成為相符項目。 如果您將值保留為 null,當您執行 MapEnvEntryForWebMod 作業時,會發生 WASX7017E 和 WASX7111E 異常狀況。
- Value: <env-entry value>
如果 Web 模組使用 Servlet 2.5,就只會從 XML 部署描述子中移入這個選項的內容。 您無法利用這個選項,從註釋取得部署資訊。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。
批次模式用法範例
$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']]])
如果說明中有換行字元,請使用下列語法:
$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
- Web 模組:xxx
- URI:xxx
- Servlet:xxx
- 名稱:xxx
- 說明:null
- Value: <initial parameter value>
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。
批次模式用法範例
$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
- 模組:xxx
- URI:xxx
- 使用 JASPI: 是 | 否 | 繼承
- JASPI 提供者名稱:xxx
對於「使用 JASPI」,請以語言環境專用的語言來指定 Yes
、No
或 Inherit
值。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您必須提供遺漏資訊或需要更新的列或項目的資料。
批次模式用法範例
$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
MapMessageDestinationRefToEJB 選項會從已安裝的資源配接器中,將訊息目的地參照對映至管理物件的 Java 命名和目錄介面 (JNDI) 名稱。 您必須將您的應用程式所定義的每個訊息目的地參照對映至某個管理物件。 請利用這個選項來提供遺漏的資料或更新作業。
- 模組:ejb-jar-ic.jar
- Bean:MessageBean
- URI:ejb-jar-ic.jar,META-INF/ejb-jar.xml
- 訊息目的地物件:jms/GSShippingQueue
- 目標資源JNDI 名稱:[jms/GSShippingQueue]:
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您必須提供遺漏資訊或需要更新的列或項目的資料。
批次模式用法範例
$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
MapModulesToServers 選項指定應用程式包含的模組要安裝到其中的應用程式伺服器。 您可以將模組安裝在同一部伺服器中,或將它們散佈在若干伺服器中。 使用此選項來提供遺漏資料或更新至作業。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您必須提供遺漏資訊或需要更新的列或項目的資料。
批次模式用法範例
下列範例會將 Increment.jar 安裝到一部伺服器:
$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] ]]')
下列範例會安裝 Increment.jar,並將它對映到部署管理程式所管理的兩部伺服器:
$AdminApp install Increment.jar {-MapModulesToServers
{{ "Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
WebSphere:cell=mycell,node=mynode,server=server1+WebSphere:cell=mycell,node=mynode,server=server2}}}
AdminApp.install('Increment.jar', '[ -MapModulesToServers
[[ "Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
WebSphere:cell=mycell,node=mynode,server=server1+WebSphere:cell=mycell,node=mynode,server=server2]]]')
下列範例為已安裝的應用程式新增 server2
和 server3
:
$AdminApp install myapp.ear {-MapModulesToServers {{.* .*
+WebSphere:cell=mycell,node=mynode,server=server2+WebSphere:cell=mycell,node=mynode,server=server3}}
-appname myapp -update -update.ignore.old}
AdminApp.install('myapp.ear', ['-MapModulesToServers', [['.*', '.*',
'+WebSphere:cell=mycell,node=mynode,server=server2+WebSphere:cell=mycell,node=mynode,server=server3']],
'-appname', 'myapp', '-update', '-update.ignore.old'])
下列範例會從已安裝的應用程式中移除 server1
:
$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
MapResEnvRefToRes 選項會將資源環境參照對映至資源。 您必須將您的應用程式所定義的每個資源環境參照對映至某個資源。 請利用這個選項來提供遺漏的資料或更新作業。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您必須提供遺漏資訊或需要更新的列或項目的資料。
批次模式用法範例
$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
MapResRefToEJB 選項會將資源參照對映至資源。 您必須將您的應用程式所定義的每個資源參照對映至某個資源。 請利用這個選項來提供遺漏的資料或更新作業。
- 模組:Ejb1
- Bean:MailEJBObject
- URI:deplmtest.jar,META-INF/ejb-jar.xml
- 資源參照:jms/MyConnectionFactory
- 資源類型:javax.jms.ConnectionFactory
- 目標資源 JNDI 名稱:[jms/MyConnectionFactory]:
- 登入配置名稱:[null]: 請利用這個選項來建立自訂登入配置。 用戶端可以利用 JAAS 來建立登入設計。
- 內容:[]: 請利用這個選項來建立自訂登入配置。 用戶端可以利用 JAAS 來建立登入設計。
- 延伸資料來源內容: []: 請使用這個選項,以便使用異質儲存區的資料來源可以連接至 DB2 資料庫。 內容型樣如下:property1=value1+property2=value 2。
Java 2 Connector (J2C) 用 DefaultPrincipalMapping 登入配置,來將使用者對映至 J2C 鑑別資料項目中所定義之主體 。 如果 login.config.name 設為 DefaultPrincipalMapping,就會利用 com.ibm.mapping.authDataAlias 這個名稱來建立內容。 內容值由 auth.props 來設定。 如果 login.config 名稱未設為 DefaultPrincipalMapping,則 auth.props 可以指定多個內容。 字串格式如下:websphere:name= <name1>,value=<value1>,description=<desc1>
。 請利用加號 (+
) 來指定多個內容。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您必須提供遺漏資訊或需要更新的列或項目的資料。
批次模式用法範例
$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
MapRolesToUsers 選項會將使用者對映至角色。 您必須從網域使用者登錄中,將應用程式或模組所定義的每個角色對映至使用者或群組。 您可以使用垂直線 (|) 來區隔單一角色,以指定多個使用者或群組。 使用此選項來提供遺漏資料或更新作業。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您必須提供遺漏資訊或需要更新的列或項目的資料。
批次模式用法範例
$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 "" ""}
對應於下列項目:
選項 | 說明 |
---|---|
"All Role" |
代表角色名稱 |
No |
指允許每個人存取 (yes/no) |
Yes |
指允許所有已鑑別的使用者存取 (yes/no) |
"" |
指對映的使用者 |
"" |
指對映的群組 |
"AllAuthenticatedInTrustedRealms" |
指將存取權授與授信網域範圍中任何有效的使用者。 |
"Mapped users access ids" |
指對映的使用者存取 ID |
"Mapped groups access ids" |
指對映的群組存取 ID |
MapRunAsRolesToUsers
MapRunAsRolesToUsers 選項會將執行身分角色對映至使用者。 您安裝的 Enterprise Bean 包含預先定義的執行身分角色。 當與另一個 Enterprise Bean 互動時,必須以特定角色來執行以便於識別的 Enterprise Bean,會使用執行身分角色。 請利用這個選項來提供遺漏的資料或更新作業。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您必須提供遺漏資訊或需要更新的列或項目的資料。
批次模式用法範例
使用 Jacl:
$AdminApp install myapp.ear {-MapRunAsRolesToUsers {{UserRole user1
password1} {AdminRole administrator administrator}}}
使用 Jython:
AdminApp.install('myapp.ear', '[-MapRunAsRolesToUsers [[UserRole user1
password1][AdminRole administrator administrator]]]')
MapSharedLibForMod
- 模組:xxx
- URI:META-INF/application.xml
- 共用程式庫:<share libraries>
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。
批次模式用法範例
$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
MapWebModToVH 選項會選取 Web 模組的虛擬主機。 請指定應用程式包含的 Web 模組要安裝到其中的虛擬主機。 您可以將 Web 模組安裝在相同虛擬主機中,或將它們散佈於若干主機。 請利用這個選項來提供遺漏的資料或更新作業。
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。 您必須提供遺漏資訊或需要更新的列或項目的資料。
批次模式用法範例
$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
MetadataCompleteForModules 選項可讓每個 Java EE 5 或更新版本的模組寫出完整的部署描述子,包括註釋中的部署資訊。 之後,系統會將模組的部署描述子標示為已完成。
metadata-complete
屬性設為 true
,會使得產品在部署描述子中將 @EJB
註釋不正確地呈現為 <ejb-ref>
,而不是 <ejb-local-ref>
。 如果是 Web 模組,將 metadata-complete
屬性設為 true
,可能導致發生 InjectionException 錯誤。 如果必須將 metadata-complete
屬性設為 true
,請利用下列方法來避免發生錯誤:不使用共用程式庫、將共用程式庫置於應用程式伺服器的
classes 或 lib 目錄中,或在部署描述子中完整指定 meta 資料。- 模組:EJBDD_1.jar
- URI:EJBDD_1.jar,META-INF/ejb-jar.xml
- 鎖定部署描述子:[false]:
- 模組:EJBNoDD_2.jar
- URI:EJBNoDD_2.jar,META-INF/ejb-jar.xml
- 鎖定部署描述子:[false]:
請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。
批次模式用法範例
使用 Jacl:
$AdminApp install myapp.ear {-MetadataCompleteForModules
{{EJBDD_1.jar EJBDD_1.jar,META-INF/ejb-jar.xml false}}}
搭配型樣比對來使用 Jacl:
$AdminApp install myapp.ear
{-MetadataCompleteForModules {{.* EJBDD_1.jar,.* false}}}
使用 Jython:
AdminApp.install('myapp.ear', ['-MetadataCompleteForModules',
[['EJBDD_1,jar', 'EJBDD_1.jar,META-INF/ejb-jar.xml', 'false']]])
搭配型樣比對來使用 Jython:
AdminApp.install('myapp.ear',
['-MetadataCompleteForModules', [['.*', 'EJBDD_1.jar,.*', 'false']]]
ModuleBuildID
ModuleBuildID 選項會顯示應用程式 EAR 檔中模組的建置 ID。 您無法修改這個選項,因為它是唯讀的。 如果您已在模組或應用程式 EAR 檔的 MANIFEST.MF
中指定建置 ID ,這個選項會傳回模組的建置資訊。 建置資訊由模組名稱、模組 URI 和建置 ID 組成。
- 模組:CacheClient
- URI:CacheClient.jar,META-INF/application-client.xml
- 建置 ID:alpha
- 模組:MailConnector
- URI:Mail.rar,META-INF/ra.xml
- 建置 ID:abc
- 模組:CacheWeb1
- URI:CacheWeb1.war,WEB-INF/web.xml
- 建置 ID:alpha
- 模組:JspWeb1
- URI:JspWeb1.war,WEB-INF/web.xml
- 建置 ID:v1.0
- 模組:Servlet
- URI:Servlet.war,WEB-INF/web.xml
- 建置 ID:0.5
批次模式用法範例
使用 Jython:
print AdminApp.taskInfo('/temp/Cache2.ear', 'ModuleBuildID')
noallowDispatchRemoteInclude
noallowDispatchRemoteInclude 選項會停用企業應用程式透過標準要求分派器機制,將 includes
分派給受管理節點環境中不同 Java 虛擬機器的 Web 模組之間的資源。
noallowPermInFilterPolicy
noallowPermInFilterPolicy 選項指定當應用程式包含過濾原則中的原則許可權,就不繼續執行應用程式部署程序。 這個選項是預設值,不需要值。
noallowServiceRemoteInclude
noallowServiceRemoteInclude 選項會使企業應用程式無法處理 allowDispatchRemoteInclude 選項設為 true
的企業應用程式所發出的併入要求。
節點
node 選項指定節點名稱來安裝或更新整個應用程式,或更新應用程式以便新增模組。 如果您想要更新整個應用程式,只有在應用程式包含已安裝的應用程式中沒有的新模組時,這個選項才適用。
批次模式用法範例
使用 Jacl:
$AdminApp install "/myapp.ear" {-node nodeName}
使用 Jython:
AdminApp.install('/myapp/myapp.ear', '[-node nodeName]')
nocreateMBeansForResources
nocreateMBeanForResources 選項指定在部署目標上啟動應用程式時,不建立應用程式中所定義之所有資源(如:Servlet、JavaServer Pages 檔和 Enterprise Bean 等)的 MBean。 這個選項是預設值,不需要值。
nodeployejb
nodeployejb 選項指定在安裝期間,不執行 EJBDeploy 工具。 這個選項是預設值,不需要值。
nodeployws
nodeployws 選項指定在安裝期間,不部署 Web 服務。 這個選項是預設值,不需要值。
nodistributeApp
nodistributeApp 選項指定應用程式管理元件不配送應用程式二進位檔。 這個選項不需要值。 預設值是 distributeApp 選項。
noenableClientModule
noenableClientModule 選項指定不部署用戶端模組。 這個選項不需要值。 這是預設值。 預設值是不部署用戶端模組。 請利用 enableClientModule 選項來部署用戶端模組。
noreloadEnabled
noreloadEnabled 選項會停用類別的重新載入。 這個選項是預設值,不需要值。 如果要指定掃描應用程式的檔案系統來尋找已更新的檔案,以便動態重新載入變更,請使用 reloadEnabled 選項。
nopreCompileJSPs
nopreCompileJSPs 選項指定不前置編譯 JavaServer Pages 檔。 這個選項是預設值,不需要值。
noprocessEmbeddedConfig
noprocessEmbeddedConfig 選項指定系統應該忽略應用程式所包含的內嵌配置資料。 這個選項不需要值。 如果應用程式企業保存檔 (EAR) 不包含內嵌的配置資料,noprocessEmbeddedConfig 選項就是預設值。 否則,預設值是 processEmbeddedConfig 選項。
nouseAutoLink
nouseAuto「鏈結」選項指定不使用 useAuto「鏈結」選項,也不自動解析 EJB 3.0 之前的 EJB 模組版本,以及 2.4版之前的 Web 模組版本中的 Enterprise JavaBeans (EJB) 參照。
nouseMetaDataFromBinary
nouseMetaDataFromBinary 選項指定執行時期所用的 meta 資料,如:部署描述子、連結、延伸,等等,是取自配置儲存庫。 這個選項是預設值,不需要值。 請利用這個選項來指示,執行時期所用的 meta 資料是取自企業保存檔 (EAR)。
nousedefaultbindings
nousedefaultbindings 選項指定不使用安裝架構的預設連結。 這個選項是預設值,不需要值。
novalidateSchema
novalidateSchema 選項指定不對照已發佈的 Java EE 部署描述子綱目來驗證部署描述子。 這個選項不需要值。 這是預設值。 預設值是不驗證部署描述子。
作業
add
- 新增內容。addupdate
- 根據應用程式內容是否存在來新增或更新內容。delete
- 刪除內容。update
- 更新現有的內容。
如果內容類型是 file 或 modulefile,operation 選項就是必要的。 如果內容類型值是 app
,operation 選項的值就必須是 update
。 當內容類型為 app
時,會忽略 contenturi 選項。
批次模式用法範例
下列範例顯示如何利用 update 指令的選項,來更新整個部署的企業應用程式:
$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 ]' )
下列範例顯示如何利用 update 指令的選項,來更新已部署應用程式中的單一檔案:
使用 Jacl:
$AdminApp update app1 file {-operation update
-contents /apps/app1/my.xml -contenturi app1.jar/my.xml}
使用 Jython 字串:
AdminApp.update('app1', 'file', '[-operation update
-contents /apps/app1/my.xml -contenturi app1.jar/my.xml]')
使用 Jython 清單:
AdminApp.update('app1', 'file', ['-operation', 'update', '-contents',
'/apps/app1/my.xml', '-contenturi', app1.jar/my.xml'])
其中 AdminApp
是 Scripting 物件,update
是指令,app1
是要更新的應用程式名稱,file
是內容類型,operation
是 update 指令的選項,update
是 operation
選項的值,contents
是 update 指令的選項,/apps/app1/my.xml
是 contents
選項的值,contenturi
是 update 指令的選項,app1.jar/my.xml
是 contenturi
選項的值。
processEmbeddedConfig
processEmbeddedConfig 選項會處理應用程式所包含的內嵌配置資料。 這個選項不需要值。 如果應用程式企業保存檔 (EAR) 包含內嵌的配置資料,這個選項就是預設值。 否則,預設值是 nonprocessEmbeddedConfig 選項。
這項設定會影響加強型 EAR 檔的安裝。 加強型 EAR 檔會在您匯出已安裝的應用程式時產生。 加強型 EAR 檔內含由 resource.xml 和 variables.xml
等檔案組成的內嵌配置。 此選項會從 EAR 檔將內嵌配置載入應用程式範圍。
如果您從現行 Cell 以外的 Cell 中匯出應用程式,且在初次安裝應用程式時,並未指定 installed.ear.destination 選項的 $(CELL)
變數,請使用 nonprocessEmbeddedConfig 選項,以在 profile_root/installedApps/current_cell_name 目錄中展開加強型 EAR 檔。 否則,請使用此 processEmbeddedConfig 選項,在 profile_root/installedApps/original_cell_name 目錄中展開加強型 EAR 檔,其中 original_cell_name 是初次安裝應用程式所在的 Cell。 如果初次安裝應用程式時,針對 installed.ear.destination 選項指定了 $(CELL)
變數,安裝作業便會在 profile_root/installedApps/current_cell_name 目錄中展開加強型 EAR 檔。
preCompileJSPs
preCompileJSPs 選項指定前置編譯 JavaServer Pages 檔。 這個選項不需要值。 預設值是 nopreCompileJSPs。 如果您想要前置編譯 JavaServer Pages 檔,請將它指定為安裝作業的一部分。 預設值是不前置編譯 JavaServer Pages 檔。 在部署期間,系統不處理 preCompileJSPs 選項,JavaServer Pages 檔不會進行前置編譯。 這個旗標是利用組合工具來自動設定。
對於此選項,僅安裝至 9.0版 部署目標,其 Java SDK 層次與部署管理程式相同或更高。
reloadEnabled
reloadEnabled 選項指定將掃描應用程式檔案系統來尋找已更新的檔案,以便動態重新載入變更。 如果啟用這個選項且應用程式類別已變更,則應用程式會停止並重新啟動,以重新載入更新過的類別。 這個選項不是預設值且不需要值。 預設值是 noreloadEnabled 選項。
reloadInterval
reloadInterval 選項指定掃描應用程式檔案系統來尋找已更新檔案的時段(秒)。 有效範圍是大於零。 預設值是 3 秒。
SharedLibRelationship
SharedLibRelationship 選項會將資產或組合單元 ID 指派為每個 Java EE 模組的共用程式庫。
- 模組:EJB3BNDBean.jar
- URI:EJB3BNDBean.jar,META-INF/ejb-jar.xml
- 關係 ID:請指定資產或組合單元 ID,例如,
[WebSphere:cuname=sharedLibCU1,cuedition=1.0]
或WebSphere:assetname=sharedLibAsset1.jar
- 組合單元名稱:請選擇性地指定資產關係 ID 的組合單元名稱。 如果您未指定組合單元名稱,系統會使用與資產相同的名稱。 []
- 相符目標:[Yes]:
- 如果您指定資產,系統會在 Java EE 應用程式所屬的商業層次應用程式中,建立一個含有這個資產的組合單元。
- 如果您指定了組合單元名稱的值,系統位置會使每個名稱與對應的關係 ID 值相符。
- 如果關係 ID 是一個組合單元 ID,系統會忽略對應的組合單元名稱。
- 如果關係 ID 是一個資產 ID,系統會利用相對應的組合單元名稱來建立組合單元。
如果要指定多個資產或組合單元 ID,請用加號字元 (+
),將各個值隔開。
當 edit 指令用於 Java EE 應用程式時,您可以用一組新的組合單元關係 ID 來置換關係,也可以新增或移除現有的組合單元關係。 當使用 edit 指令時,您無法指定資產關係。 請將組合單元 ID 的第一個字元指定為加號 (+
),以新增到關係中,或指定數字記號 (#
),將組合單元 ID 從現有的關係中移除。 例如,+cuname=cu2.zip
組合單元語法會將 cu2
組合單元加到關係中。 #cuname=cu1.zip+cuname=cu2.zip
組合單元語法會將 cu1
和 cu2
組合單元從關係中移除。
批次模式用法範例
使用 Jacl:
$AdminApp install myapp.ear {-SharedLibRelationship {{EJB3BNDBean.jar
EJB3BNDBean.jar,META-INF/ejb-jar.xml WebSphere:cuname=sharedLibCU1 "" Yes}}}
搭配型樣比對來使用 Jacl:
$AdminApp install myapp.ear {-SharedLibRelationship {{.*
EJB3BNDBean.jar,.* WebSphere:cuname=sharedLibCU1 "" Yes}}}
使用 Jython:
AdminApp.install('myapp.ear', ['-SharedLibRelationship',
[['EJB3BNDBean,jar', 'EJB3BNDBean.jar,META-INF/ejb-jar.xml',
'WebSphere:cuname=sharedLibCU1,' '', 'Yes']]])
搭配型樣比對來使用 Jython:
AdminApp.install('myapp.ear', ['-SharedLibRelationship', [['.*',
'EJB3BNDBean.jar,.*', 'WebSphere:cuname=sharedLibCU1', '', 'Yes']]]
伺服器
- 安裝新的應用程式。
- 以應用程式的更新版本來取代現有的應用程式。 在這個狀況之下,只有在應用程式的更新版本包含已安裝應用程式版本中沒有的新模組時,server 選項才有意義。
- 新增模組到現有的應用程式中。
您無法同時使用 -cluster 和 -server 選項。 如果您想要部署應用程式,以及在部署期間指定 HTTP 伺服器,使應用程式出現在產生的 plugin-cfg.xml 檔中,那麼您必須先以 -cluster 為目標來安裝應用程式。 安裝好應用程式之後,在您儲存之前,請利用 AdminApp 物件的 edit 指令來新增其他對映到 Web 伺服器。
批次模式用法範例
使用 Jacl:
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
{-server server1}
使用 Jython:
AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
'[-server server1]')
目標
target 選項指定 AdminApp 物件安裝功能的目標。 以下是 target 選項的範例:WebSphere:cell=mycell,node=mynode,server=myserver
+
,以 MapModulesToServers 選項來新增目標;執行時期無法正確解析對映至部署目標的網域。批次模式用法範例
下列範例指定 server1
作為應用程式安裝的目標伺服器:
使用 Jacl:
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
{-appname MyApp -target WebSphere:cell=myCell,node=myNode,server=server1}
使用 Jython:
AdminApp.install("app_server_root/installableApps/DynaCacheEsi.ear",
["-appname", "MyApp", "-target", "WebSphere:cell=myCell,node=myNode,server=server1"])
下列範例指定 server1
和 server2
作為應用程式安裝的目標伺服器:
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
{-appname MyApp -target
WebSphere:cell=myCell,node=Node1,server=server1+WebSphere:cell=Cell1,node=myNode,server=server2}
AdminApp.install("app_server_root/installableApps/DynaCacheEsi.ear",
["-appname", "MyApp", "-target",
"WebSphere:cell=myCell,node=Node1,server=server1+WebSphere:cell=Cell1,node=myNode,server=server2"])
下列範例會從安裝的應用程式中移除 server3:
$AdminApp install
app_server_root/binaries/DefaultApplication.ear {-appname MyApp
-target -WebSphere:cell=GooddogCell,node=BaddogNode,server=server3
-update -update.ignore.old}
AdminApp.install("app_server_root/binaries/DefaultApplication.ear",
["-appname", "MyApp",
"-target", "-WebSphere:cell=GooddogCell,node=BaddogNode,server=server3",
"-update", "-update.ignore.old"])
下列範例會將 server4 新增到已安裝的應用程式中:
$AdminApp update app {-appname MyApp
-target +WebSphere:cell=GooddogCell,node=GooddogNode,server=server4
-contents app_server_root/binaries/DefaultApplication.ear
-operation update -update.ignore.old}
AdminApp.update("app", ["-appname", "MyApp",
"-target", "+WebSphere:cell=GooddogCell,node=GooddogNode,server=server4",
"-contents", "app_server_root/binaries/DefaultApplication.ear",
"-operation", "update", "-update.ignore.old"])
更新
update 選項會以新版的企業保存檔 (EAR) 來更新已安裝的應用程式。 這個選項不需要值。
要更新的應用程式 (由 appname 選項指定) 必須已安裝在 WebSphere Application Server 配置中。 更新動作會將新舊版本的連結合併起來,將舊版解除安裝,然後安裝新版本。 新版 EAR 檔或模組的連結資訊優先於舊版中對應的連結資訊。 如果新版遺漏了連結的任何元素,就會使用舊版中對應的元素。
update.ignore.new
update.ignore.new 選項指定在更新動作期間,舊版應用程式或模組的連結資訊優先於新版中對應的連結資訊。 如果舊版遺漏了連結的任何元素,就會使用新版中的元素。 換言之,如果應用程式或模組的舊版連結存在,就會忽略新版中的連結。 否則,將允許使用而不忽略新的連結。 這個選項不需要值。
- install 指令的 update 選項。
- modulefile 或 app,作為 update 指令的內容類型。
update.ignore.old
- install 指令的 update 選項。
- modulefile 或 app,作為 update 指令的內容類型。
useAutoLink
請利用 useAuto鏈結選項來自動解析 EJB 3.0之前的 EJB 模組版本,以及 2.4版之前的 Web 模組版本中的 Enterprise JavaBeans (EJB) 參照。 如果啟用 useAutoLink 選項,您可以選擇性地指定 MapEJBRefToEJB 選項的 JNDI 名稱。 應用程式中的每個模組都必須共用一個共同的目標,才能啟用自動鏈結支援。
批次模式用法範例
使用 Jacl:
$AdminApp install /myapp.ear {-useAutoLink}
使用 Jython:
AdminApp.install('myapp.ear','[-useAutoLink]')
usedefaultbindings
usedefaultbindings 選項指定使用安裝架構的預設連結。 這個選項不需要值。 預設值是 nousedefaultbindings。
如果要使用現有的接聽器埠,而不使用或建立新的啟動規格,請判斷 EJB JAR 版本是否早於 2.1。 當您指定 -usedefaultbindings 選項來部署應用程式時,系統會自動建立及使用啟動規格。 如果啟動規格存在,系統會忽略接聽器埠,改用啟動規格。 如果要使用已定義的接聽器埠來部署 EJB JAR 版本大於或等於 2.1 的應用程式,而不使用新的啟動規格,請在相關設定檔內容目錄的 wsadmin.properties 檔中,將 com.ibm.websphere.management.application.dfltbndng.mdb.preferexisting 系統內容設為 true
。
useMetaDataFromBinary
useMetaDataFromBinary 選項指定執行時期所用的 meta 資料,如:部署描述子、連結、延伸,等等,是取自 EAR 檔。 這個選項不需要值。 預設值是 nouseMetaDataFromBinary
,表示執行時期所用的 meta 資料是來自配置儲存庫。
validateinstall
- off - 指定不進行應用程式部署驗證。 此值為預設值。
- warn - 執行應用程式部署驗證,即使報告了警告或錯誤訊息,也繼續應用程式部署程序。
- fail - 執行應用程式部署驗證,當報告警告或錯誤訊息時,不繼續應用程式部署程序。
validateSchema
validateSchema 選項指定對照已發佈的 Java EE 部署描述子綱目來驗證部署描述子。 當選取這個應用程式部署選項時,產品會分析每個部署描述子來判斷部署描述子的 Java EE 規格版本,選取適當的綱目,然後對照 Java EE 部署描述子綱目來檢查部署描述子。 驗證錯誤會產生錯誤訊息。
這個選項不需要值。 預設值是 novalidateSchema。 依預設,在部署期間,會忽略 validateSchema 選項,產品不會驗證部署描述子。
詳細
verbose 選項會導致在安裝期間顯示其他訊息。 這個選項不需要值。
WebServicesClientBindDeployedWSDL
WebServicesClientBindDeployedWSDL 選項用來識別您正在修改的用戶端 Web 服務。 範圍設定欄位包括:模組、EJB 和 Web 服務。 已部署的 WSDL 檔名稱是這項作業的單一可變值。 它指出用戶端所用的「Web 服務說明語言 (WSDL)」。
「模組」欄位識別應用程式內的企業或 Web 應用程式。 如果模組是 Enterprise Bean,EJB 欄位就識別模組內的特定 Enterprise Bean。 Web 服務欄位識別 Enterprise Bean 或 Web 應用程式模組內的 Web 服務。 此 ID 對應於 WSDL 檔中的 wsdl: service 屬性,其字首為 service/
; 例如 service/WSLoggerService2.
已部署的 WSDL 屬性會相對於用戶端模組來命名 WSDL 檔。 Web 應用程式已部署的 WSDL 範例如下:WEB-INF/wsdl/WSLoggerService
。
批次模式用法範例
$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
WebServicesClientBindPortInfo 選項用來識別您在修改之用戶端 Web 服務的埠。 範圍設定欄位包括:模組、EJB、Web 服務和埠。 這項作業的可變值包括: Sync Timeout
、 BasicAuth ID
、 BasicAuth
Password
、 SSL Config
和 Overridden Endpoint URI
。 基本鑑別和 Secure Socket Layer (SSL) 欄位會影響傳輸層次安全,而不是「Web 服務安全」。
批次模式用法範例
$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
Port
。- 埠類型 - 識別介面的 WSDL 檔其中的 wsdl:portType 屬性所定義之埠類型的 QName ("{namespace} localname")。
- 埠 - 識別含喜好設定之實作的 WSDL 檔,其中的 wsdl:service 屬性內的 wsdl:port 屬性所定義之埠的 QName。
批次模式用法範例
$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
WebServicesServerBindPort 選項會設定 Web 服務埠的兩個屬性。 不可變的值用來識別您在修改之 Web 服務的埠。 範圍欄位包括:模組、Web 服務和埠。 可改變的值包括: WSDL Service Name
和 Scope
。
範圍決定了實作 Java Bean 的生命週期。 有效值包括:Request
(每個要求的新實例)、Application
(每個 web-app 一個實例),以及 Session
(每個 HTTP 階段作業的新實例)。
scope 屬性不適用於 Java 訊息服務 (JMS) 所傳輸的 Web 服務。 scope 屬性不適用於 Enterprise Bean。
當多個服務有相同的埠名稱時,WSDL 服務名稱可用來識別服務。 WSDL 服務名稱以 QName 字串來表示,例如:{namespace}localname
。
批次模式用法範例
$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
WebServicesClientCustomProperty 選項支援配置 Web 服務用戶端連結檔之說明的名稱值參數。 不可變的值用來識別您在修改之 Web 服務的埠。 範圍欄位包括:模組、Web 服務和埠。 可變的值包括:name
和 value
。
name
和 value
值的格式都包含一個代表多個名稱/值配對的字串,並以 +
字元為分隔字元。 例如,name 字串 = "n1+n2+n3";value 字串 = "v1+v2+v3";產生名稱/值配對:{{"n1" "v1"}, {"n2" "v2"}, {"n3" " v3"}}。
批次模式用法範例
$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
WebServicesServerCustomProperty 選項支援配置 Web 服務伺服器連結檔之說明的名稱值參數。 範圍設定欄位包括:模組、EJB 和 Web 服務。 這項作業可變的值包括:name
和 value
。
這些值的格式都包含一個代表多個名稱/值配對的字串,以加號 (+) 字元為分隔字元。 例如,name 字串 = "n1+n2+n3";value 字串 = "v1+v2+v3";產生名稱/值配對:{{"n1" "v1"}, {"n2" "v2"}, {"n3" " v3"}}。
批次模式用法範例
$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']]])