使用 wsadmin Scripting 的 AdminApp 物件指令

• 使用 Jacl：

  $AdminApp getDeployStatus myApplication

• 使用 Jython：

  print AdminApp.getDeployStatus('myApplication')

WASX7095I: The AdminApp object allows application objects to be manipulated including installing, 
uninstalling, editing, and listing.  Most of the commands supported by AdminApp operate in two modes: 
the default mode is one in which AdminApp communicates with the application server to accomplish its 
tasks.  A local mode is also possible, in which no server communication takes place.  The local mode of 
operation is invoked by including the "-conntype NONE" flag in the option string supplied to the command.

The following commands are supported by AdminApp; more detailed information about each of these commands 
is available by using the "help" command of AdminApp and supplying the name of the command as an argument.

edit            			Edit the properties of an application
editInteractive 			Edit the properties of an application interactively
export          			Export application to a file
exportDDL      				Extract DDL from application to a directory
help         	   			Show help information
install         			Installs an application, given a file name and an option string.
installInteractive		Installs an application in interactive mode, given a file name and an option string.
list            			List all installed applications
listModules     			List the modules in a specified 
application options 	Shows the options available, either for a given file, or in general.
taskInfo        			Shows detailed information pertaining to a given installation task for a given file
uninstall       			Uninstalls an application, given an application name and an option string

WASX7102I: Method: uninstall
Arguments: application name, options
Description: Uninstalls application named by "application name" using the options supplied by String 2.
Method: uninstall
Arguments: application name
Description: Uninstalls the application specified by "application name" using default options.

• 下列範例未指定任何引數:

  $AdminApp help

• 下列範例指定作業名稱引數:

  $AdminApp help uninstall

• 下列範例未指定任何引數:

  print AdminApp.help()

• 下列範例指定作業名稱引數:

  print AdminApp.help('uninstall')

• 使用 Jacl：

  $AdminApp install c:/apps/myapp.ear

• 使用 Jython：

  print AdminApp.install('c:/apps/myapp.ear')

print AdminApp.options('myApp.ear')

print AdminApp.help('MapModulesToServers')

• 使用 Jacl：

  $AdminApp installInteractive c:/websphere/appserver/installableApps/jmsample.ear

• 使用 Jython：

  print AdminApp.installInteractive('c:/websphere/appserver/installableApps/jmsample.ear')

ADMA5071I: Distribution status check started for application 
           DefaultApplication.WebSphere:cell=Node03Cell,node=myNode,distribution=true
ADMA5011I: The cleanup of the temp directory for application DefaultApplication is complete.
ADMA5072I: Distribution status check completed for application DefaultApplication.true

ADMA5071I: Distribution status check started for application TEST.WebSphere:cell=myCell,node=myNode,
					distribution=unknown
ADMA5011I: The cleanup of the temp directory for application TEST is complete.
ADMA5072I: Distribution status check completed for application TEST.false

• 使用 Jacl：

  set result [$AdminApp isAppReady 
  DefaultApplication]
  while {$result == "false"} {
     ### Wait 5 seconds before checking again
     after 5000   
  set result [$AdminApp isAppReady DefaultApplication]
  }
  puts "Starting application..."

• 使用 Jython：

  import time
  result = AdminApp.isAppReady('DefaultApplication')
  while (result == "false")
  :   ### Wait 5 seconds before checking again
      time.sleep(5)   
      result = AdminApp.isAppReady
  ('DefaultApplication')
  print("Starting application...")

• 使用 Jacl：

  set result [$AdminApp isAppReady
  DefaultApplication]
  while {$result == "false"} {
     ### Wait 5 seconds before checking again
     after 5000   
     set result [$AdminApp isAppReady
  DefaultApplication]
  }
  puts "Starting application..."

• 使用 Jython：

  import time
  result = AdminApp.isAppReady
  ('DefaultApplication')
  while (result == "false"):
     ### Wait 5 seconds before checking again
     time.sleep(5)   
     result = AdminApp.isAppReady
  ('DefaultApplication')
  print("Starting application...")

目標 (target)

列出安裝在配置中給定目標範圍上的應用程式。

adminconsole 
DefaultApplication 
ivtApp

• 使用 Jacl：

  $AdminApp list

• 使用 Jython：

  print AdminApp.list()

• 使用 Jacl：

  $AdminApp list WebSphere:cell=myCell,node=myNode,server=myServer

• 使用 Jython：

  print AdminApp.list("WebSphere:cell=myCell,node=myNode,server=myServer")

ivtApp#ivtEJB.jar+META-INF/ejb-jar.xml
ivtApp#ivt_app.war+WEB-INF/web.xml

• 使用 Jacl：

  $AdminApp listModules ivtApp

• 使用 Jython：

  print AdminApp.listModules('ivtApp')

WASX7112I: The following options are valid for "ivtApp"
MapRolesToUsers
BindJndiForEJBNonMessageBinding
MapEJBRefToEJB
MapWebModToVH
MapModulesToServers
distributeApp
nodistributeApp
useMetaDataFromBinary
nouseMetaDataFromBinary
createMBeansForResources
nocreateMBeansForResources
reloadEnabled
noreloadEnabled
verbose
installed.ear.destination
reloadInterval

• 使用 Jacl：

  $AdminApp options c:/websphere/appserver/installableApps/ivtApp.ear

• 使用 Jython：

  print AdminApp.options('c:/websphere/appserver/installableApps/ivtApp.ear')

• 使用 Jacl：

  $AdminApp options ivtApp

• 使用 Jython：

  print AdminApp.options('ivtApp')

• 使用 Jacl：

  $AdminApp options ivtApp#ivtEJB.jar+META-INF/ejb-jar.xml

• 使用 Jython：

  print AdminApp.options('ivtApp#ivtEJB.jar+META-INF/ejb-jar.xml')

• 使用 Jacl：

  $AdminApp options c:/websphere/appserver/installableApps/ivtApp.ear updateapp

• 使用 Jython：

  print AdminApp.options('c:/websphere/appserver/installableApps/ivtApp.ear', 'updateapp')

• 使用 Jacl：

  $AdminApp publishWSDL JAXRPCHandlerServer c:/temp/a.zip

• 使用 Jython：

  print AdminApp.publishWSDL('JAXRPCHandlerServer', 'c:/temp/a.zip')

• 使用 Jacl：

  $AdminApp publishWSDL JAXRPCHandlersServer c:/temp/a.zip {{JAXRPCHandlersServerApp.war 
  {{http http://localhost:9080}}}}

• 使用 Jython：

  print AdminApp.publishWSDL('JAXRPCHandlersServer', 'c:/temp/a.zip', '[[JAXRPCHandlersServerApp.war
   [[http http://localhost:9080]]]]')

WASX7410W: This operation may take a while depending on the number of applications installed in your system.
MyApp
MapResRefToEJB :ejb-jar-ic.jar : [eis/J2CCF1]

• 使用 Jacl：

  $AdminApp searchJNDIReferences $node {-JNDIName eis/J2CCF1 -verbose}

• 使用 Jython：

  print AdminApp.searchJNDIReferences(node, '[-JNDIName eis/J2CCF1 -verbose]')

MapWebModToVH: Selecting virtual hosts for web modules
Specify the virtual host where you want to install the web modules that are contained in
your application. Web modules can be installed on the same virtual host or dispersed among several hosts.
Each element of the MapWebModToVH task consists of the following three fields: "webModule," "uri," "virtualHost."
Of these fields, the following fields might be assigned new values: "virtualHost"and the following are 
required: "virtualHost"

The current contents of the task after running default bindings are:
webModule: JavaMail Sample WebApp
uri: mtcomps.war,WEB-INF/web.xml
virtualHost: default_host

• 使用 Jacl：

  $AdminApp taskInfo c:/websphere/appserver/installableApps/jmsample.ear MapWebModToVH

• 使用 Jython：

  print AdminApp.taskInfo('c:/websphere/appserver/installableApps/jmsample.ear', 'MapWebModToVH')

ADMA5017I: Uninstallation of myapp started.
ADMA5104I: Server index entry for myCellManager was updated successfully.
ADMA5102I: Deletion of config data for myapp from config 
repository completed successfully.
ADMA5011I: Cleanup of temp dir for app myapp done.
ADMA5106I: Application myapp uninstalled successfully.

• 使用 Jacl：

  $AdminApp uninstall myApp

• 使用 Jython：

  print AdminApp.uninstall('myApp')

Update of singleFile has started.
ADMA5009I: Application archive extracted at C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a1960f0\ext
Added files from partial ear: [] 
performFileOperation: source=C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a1960f0\ext,
dest=C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a1960f0\mrg, uri= META-INF/web.xml, op= add
Copying file from C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a1960f0\ext/META-INF/web.xml to 
C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a1960f0\mrg\META-INF\web.xml
Collapse list is: []
FileMergeTask completed successfully
ADMA5005I: Application singleFile configured in WebSphere repository
delFiles: []
delM: null
addM: null
Pattern for remove loose and mod:
Loose add pattern: META-INF/[^/]*|WEB-INF/[^/]*|.*wsdl
root file to be copied: META-INF/web.xml to 
C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a191b4e\workspace\cells\BAMBIE\applications\
singleFile.ear\deployments\singleFile/META-INF/web.xml
ADMA5005I: Application singleFile configured in WebSphere repository xmlDoc: [#document: null]
root element: [app-delta: null]
****** delta file name: C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a191b4e\workspace\cells\BAMBIE\applications\
singleFile.ear/deltas/delta-1079548405564
ADMA5005I: Application singleFile configured in WebSphere repository
ADMA6011I: Deleting directory tree C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a1960f0
ADMA5011I: Cleanup of temp dir for app singleFile done.
Update of singleFile has ended.

• 使用 Jacl：
  

  $AdminApp update myApp file {-operation add -contents c:/apps/myApp/web.xml 
  -contenturi META-INF/web.xml}

• 使用 Jython：
  

  print AdminApp.update('myApp', 'file', '[-operation add -contents c:/apps/myApp/web.xml 
  -contenturi META-INF/web.xml]')

• 使用 Jython 清單：
  

  print AdminApp.update('myApp', 'file', ['-operation', 'add', '-contents', 'c:/apps/myApp/web.xml',
   '-contenturi',  'META-INF/web.xml'])

• 使用 Jacl 或 true:

  $AdminApp updateAccessIDs myapp true

• 使用 Jacl for false:

  $AdminApp updateAccessIDs myapp false

• 使用 true的 Jython:

  print AdminApp.updateAccessIDs('myapp', 1)

• 使用 false的 Jython:

  print AdminApp.updateAccessIDs('myapp', 0)

Getting tasks for: myApp
WASX7266I: A was.policy file exists for this application; would you like to display it? [No]

Task[4]: Binding enterprise beans to JNDI names
Each non message driven enterprise bean in your application or module must be bound to a JNDI name.
EJB Module:  Increment EJB module
EJB:  Increment
URI:  Increment.jar,META-INF/ejb-jar.xml
JNDI Name:  [Inc]:

Task[10]: Specifying the default data source for 
EJB 2.x modules
Specify the default data source for 
the EJB 2.x Module containing 2.x CMP beans.

WASX7349I: Possible value for resource authorization is container or per connection factory
EJB Module:  Increment EJB module
URI:  Increment.jar,META-INF/ejb-jar.xml
JNDI Name:  [DefaultDatasource]:
Resource Authorization:  [Per connection factory]:

Task[12]: Specifying data sources for individual 2.x CMP beans
Specify an optional data source for each 2.x CMP bean. Mapping a specific data source to a CMP bean overrides 
the default data source for the module containing the enterprise bean.

WASX7349I: Possible value for resource authorization is container or per connection factory
EJB Module:  Increment EJB module
EJB:  Increment
URI:  Increment.jar,META-INF/ejb-jar.xml
JNDI Name:  [DefaultDatasource]:
Resource Authorization:  [Per connection factory]:container
Setting "Resource Authorization" to "cmpBinding.container"

Task[14]: Selecting Application Servers
Specify the application server where you want to install modules that are contained in your application. 
Modules can be installed on the same server or dispersed among several servers.
Module:  Increment EJB module
URI:  Increment.jar,META-INF/ejb-jar.xml
Server:  [WebSphere:cell=myCell,node=myNode,server=server1]:

Task[16]: Selecting method protections for unprotected methods for 2.x EJB
Specify whether you want to assign security role to the unprotected method, add the method to the exclude list, or mark 
the method as unchecked.
EJB Module:  Increment EJB module
URI:  Increment.jar,META-INF/ejb-jar.xml
Protection Type:  [methodProtection.uncheck]:
Task[18]: Selecting backend ID
Specify the selection for the BackendID
EJB Module:  Increment EJB module
URI:  Increment.jar,META-INF/ejb-jar.xml
BackendId list:  CLOUDSCAPE_V50_1
CurrentBackendId:  [CLOUDSCAPE_V50_1]:

Task[21]: Specifying application options
Specify the various options available to prepare and install your application.
Pre-compile JSP:  [No]:
Deploy EJBs:  [No]:
Deploy WebServices:  [No]:

Task[22]: Specifying EJB deploy options
Specify the options to deploy EJB.
....EJB Deploy option is not enabled.

Task[24]: Copy WSDL files
Copy WSDL files
....This task does not require any user input

Task[25]: Specify options to deploy web services
Specify options to deploy web services
....Web services deploy option is not enabled.
Update of myApp has started.

ADMA5009I: Application archive extracted at C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a48e969\ext/Increment.jar
FileMergeTask completed successfully
ADMA5005I: Application myApp configured in WebSphere repository
delFiles: []
delM: null
addM: [Increment.jar, ]
Pattern for remove loose and mod:
Loose add pattern: META-INF/[^/]*|WEB-INF/[^/]*|.*wsdl
root file to be copied: 
META-INF/application.xml to C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear\deployments\testSM/META-INF/application.xml
del files for full module add/update: []
ADMA6017I: Saved document C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear\deployments\testSM/Increment.jar\META-INF/ejb-jar.xml
ADMA6016I: Add to workspace Increment.jar/META-INF/ejb-jar.xml
ADMA6017I: Saved document C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear\deployments\testSM/Increment.jar\META-INF/MANIFEST.MF
ADMA6016I: Add to workspace Increment.jar/META-INF/MANIFEST.MF
ADMA6017I: Saved document C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear\deployments\testSM/Increment.jar\META-INF/ibm-ejb-jar-bnd.xmi
ADMA6016I: Add to workspace Increment.jar/META-INF/ibm-ejb-jar-bnd.xmi
ADMA6017I: Saved document C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear\deployments\testSM/Increment.jar\META-INF/Table.ddl
ADMA6016I: Add to workspace Increment.jar/META-INF/Table.ddl
ADMA6017I: Saved document C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear\deployments\testSM/Increment.jar\META-INF/ibm-ejb-jar-ext.xmi
ADMA6016I: Add to workspace Increment.jar/META-INF/ibm-ejb-jar-ext.xmi
add files for full module add/update: [Increment.jar/META-INF/ejb-jar.xml, Increment.jar/META-INF/MANIFEST.MF, 
Increment.jar/META-INF/ibm-ejb-jar-bnd.xmi, 
Increment.jar/META-INF/Table.ddl, Increment.jar/META-INF/ibm-ejb-jar-ext.xmi]
ADMA5005I: Application myApp configured in WebSphere repository
xmlDoc: [#document: null]
root element: [app-delta: null]
****** delta file name: C:\asv\b0403.04\WebSphere\AppServer\wstemp\Scriptfb5a487089\workspace\cells\BAMBIE\
applications\testSM.ear/deltas/delta-1079551520393
ADMA5005I: Application myApp configured in WebSphere repository
ADMA6011I: Deleting directory tree C:\DOCUME~1\lavena\LOCALS~1\Temp\app_fb5a48e969
ADMA5011I: Cleanup of temp dir for app myApp done.
Update of myApp has ended.

• 使用 Jacl：
  

  $AdminApp updateInteractive myApp modulefile {-operation add -contents c:/apps/myApp/Increment.jar 
  -contenturi Increment.jar -nodeployejb -BindJndiForEJBNonMessageBinding {{"Increment EJB module" 
  Increment Increment.jar,META-INF/ejb-jar.xml Inc}}}

• 使用 Jython：
  

  print AdminApp.updateInteractive('myApp', 'modulefile', '[-operation add -contents c:/apps/myApp/Increment.jar 
  -contenturi Increment.jar -nodeployejb -BindJndiForEJBNonMessageBinding [["Increment EJB module" 
  Increment Increment.jar,META-INF/ejb-jar.xml Inc]]]')

• 使用 Jython 清單：
  

  bindJndiForEJBValue = [["Increment EJB module", "Increment","Increment.jar,META-INF/ejb-jar.xml", "Inc"]]
  
  print AdminApp.updateInteractive('myApp', 'modulefile', ['-operation', 'add',
   '-contents', 'c:/apps/myApp/Increment.jar', '-contenturi', 'Increment.jar', '-nodeployejb',
   '-BindJndiForEJBNonMessageBinding', bindJndiForEJBValue])

MapModulesToServers
MapWebModToVH
MapRolesToUsers

MapModulesToServers: Selecting Application Servers

Specify the application server where you want to install the modules that are contained in your 
application. Modules can be installed on the same server or dispersed among several servers:   

Module:  adminconsole
URI:  adminconsole.war,WEB-INF/web.xml
Server:  WebSphere:cell=juniartiNetwork,
node=juniartiManager,server=dmgr

• 使用 Jacl：

  $AdminApp view DefaultApplication {-tasknames}

• 使用 Jython：

  print AdminApp.view('DefaultApplication', ['-tasknames'])

• 使用 Jacl：

  $AdminApp view DefaultApplication {-MapModulesToServers}

• 使用 Jython：

  print AdminApp.view('DefaultApplication', ['-MapModulesToServers'])

• 使用 Jacl：

  $AdminApp view DefaultApplication {-AppDeploymentOptions}

• 使用 Jython：

  print AdminApp.view('DefaultApplication', '-AppDeploymentOptions')

• 使用 Jacl：

  $AdminApp view DefaultApplication {-buildVersion}

• 使用 Jython：

  print AdminApp.view('DefaultApplication', '-buildVersion')