Oracle® Fusion Middleware WebLogic Scripting Tool Command Reference 11g Release 1 (10.3.1) Part Number E13813-01 |
|
|
View PDF |
This chapter describes WSLT commands for Oracle SOA Suite. These commands enable you to use WLST to configure SOA composite applications.
Note:
To use these commands, you must invoke WLST from the Oracle home in which the component has been installed. See "Using Custom WLST Commands" in the Oracle Fusion Middleware Administrator's Guide.This chapter includes the following sections:
For additional details about deployment, configuration plans, and test suites, see Oracle Fusion Middleware Developer's Guide for Oracle SOA Suite.
WLST commands are divided into the categories shown in Table 10-1.
Table 10-1 Oracle SOA Suite Command Categories
Command category | Description |
---|---|
Deploy and undeploy SOA composite applications. |
|
Start, stop, activate, retire, assign a default revision version, and list deployed SOA composite applications. |
|
Attach, extract, generate, and validate configuration plans for SOA composite applications. |
|
Validate human workflow tasks. |
|
Compile SOA composite applications. |
|
Package SOA composite applications into archive files to deploy. |
|
Test SOA composite applications prior to deployment in a production environment. |
Use the deployment commands, listed in Table 10-2, to deploy and undeploy SOA composite applications.
Table 10-2 Deployment Commands for WLST Configuration
Use this command... | To... | Use with WLST... |
---|---|---|
Deploy a SOA composite application. |
Offline |
|
Undeploy a SOA composite application. |
Offline |
Command Category: Deployment Commands
Use with WLST: Offline
Deploys a SOA composite application to the Oracle WebLogic Server. This command does not package the artifact files of the application for deployment. See SOA Composite Application Packaging Commands for instructions on packaging a SOA composite application.
sca_deployComposite(serverURL, sarLocation, overwrite, user, password,forceDefault, configplan)
Argument | Definition |
---|---|
serverURL |
URL of the server that hosts the SOA Infrastructure application (for example, http://myhost10:7001 ). |
sarLocation |
Absolute path to one the following:
|
overwrite |
Optional. Indicates whether to overwrite an existing SOA composite application file.
|
user |
Optional. User name to access the composite deployer servlet when basic authentication is configured. |
password |
Optional. Password to access the composite deployer servlet when basic authentication is configured. |
forceDefault |
Optional. Indicates whether to set the new composite as the default.
|
configplan |
Absolute path of a configuration plan to be applied to a specified SAR file or to all SAR files included in the ZIP file. |
The following example deploys the HelloWorld
application.
wls:/mydomain/ServerConfig> sca_deployComposite("http://myhost10:7001", "/tmp/sca_HelloWorld_rev1.0.jar")
The following example deploys the HelloWorld
application as the default version.
wls:/mydomain/ServerConfig> sca_deployComposite("http://myhost10:7001", "/tmp/sca_HelloWorld_rev1.0.jar", true)
The following example deploys the HelloWorld
application with a required user name when basic authentication is configured. You are then prompted to provide the password for this user name.
wls:/mydomain/ServerConfig> sca_deployComposite("http://myhost10:7001", "/tmp/sca_HelloWorld_rev1.0.jar", user="weblogic") Password:
The following example deploys the HelloWorld
application and applies the configuration plan named deployplan.xml
.
wls:/mydomain/ServerConfig> sca_deployComposite("http://myhost10:7001", "/tmp/sca_HelloWorld_rev1.0.jar", forceDefault=false, configplan="/tmp/deployplan.xml")
The following example deploys the HelloWorld
ZIP file, which can include multiple SARs, MARs, or both.
wls:/mydomain/ServerConfig> sca_deployComposite("http://myhost:7001", "/tmp/HelloWorld.zip")
Command Category: Deployment Commands
Use with WLST: Offline
sca_undeployComposite(serverURL, compositeName, revision, user, password)
Argument | Definition |
---|---|
serverURL |
URL of the server that hosts the SOA Infrastructure application (for example, http://myhost10:7001 ). |
compositeName |
Name of the SOA composite application. |
revision |
Revision ID of the SOA composite application. |
user |
Optional. User name to access the composite deployer servlet when basic authentication is configured. |
password |
Optional. Password to access the composite deployer servlet when basic authentication is configured. |
The following example undeploys the HelloWorld
application.
wls:/mydomain/ServerConfig> sca_undeployComposite("http://myhost10:7001", "HelloWorld", "1.0")
The following example undeploys the HelloWorld
application with a required user name when basic authentication is configured. You are then prompted to provide the password for this user name.
wls:/mydomain/ServerConfig> sca_undeployComposite("http://myhost10:7001", "HelloWorld", "1.0", user="weblogic") Password:
Use the management commands, listed in Table 10-3, to start, stop, activate, retire, assign a default revision version, and list deployed SOA composite applications.
Table 10-3 SOA Composite Application Management Commands for WLST Configuration
Use this command... | To... | Use with WLST... |
---|---|---|
Start a previously stopped SOA composite application. |
Offline |
|
Stop a SOA composite application. |
Offline |
|
Activate a previously retired SOA composite application. |
Offline |
|
Retire a SOA composite application. |
Offline |
|
Assign the default revision version to a SOA composite application. |
Offline |
|
List the deployed SOA composite applications. |
Offline |
Command Category: Application Management Commands
Use with WLST: Offline
sca_startComposite(host, port, user, password, compositeName, revision, label)
Argument | Definition |
---|---|
host |
Hostname of the Oracle WebLogic Server (for example, myhost ). |
port |
Port of the Oracle WebLogic Server (for example, 7001 ). |
user |
User name for connecting to the running server to get mBean information (for example, weblogic ). |
password |
Password for the user name. |
compositeName |
Name of the SOA composite application. |
revision |
Revision of the SOA composite application. |
label |
Optional. Label of the SOA composite application. The label identifies the metadata service (MDS) artifacts associated with the application. If the label is not specified, the system finds the latest one. |
Command Category: Application Management Commands
Use with WLST: Offline
sca_stopComposite(host, port, user, password, compositeName, revision, label)
Argument | Definition |
---|---|
host |
Hostname of the Oracle WebLogic Server (for example, myhost ). |
port |
Port of the Oracle WebLogic Server (for example, 7001 ). |
user |
User name for connecting to the running server to get mBean information (for example, weblogic ). |
password |
Password for the user name. |
compositeName |
Name of the SOA composite application. |
revision |
Revision of the SOA composite application. |
label |
Optional. Label of the SOA composite application. The label identifies the MDS artifacts associated with the application. If the label is not specified, the system finds the latest one. |
Command Category: Application Management Commands
Use with WLST: Offline
Activates a retired SOA composite application and its instances. You can then create new instances.
sca_activateComposite(host, port, user, password, compositeName, revision, label)
Argument | Definition |
---|---|
host |
Hostname of the Oracle WebLogic Server (for example, myhost ). |
port |
Port of the Oracle WebLogic Server (for example, 7001 ). |
user |
User name for connecting to the running server to get mBean information (for example, weblogic ). |
password |
Password for the user name. |
compositeName |
Name of the SOA composite application. |
revision |
Revision of the SOA composite application. |
label |
Optional. Label of the SOA composite application. The label identifies the MDS artifacts associated with the application. If the label is not specified, the system finds the latest one. |
Command Category: Application Management Commands
Use with WLST: Offline
Stops and retires a SOA composite application and all its running instances. If the process life cycle is retired, you cannot create a new instance. Existing instances are allowed to complete normally.
sca_retireComposite(host, port, user, password, compositeName, revision, label)
Argument | Definition |
---|---|
host |
Hostname of the Oracle WebLogic Server (for example, myhost ). |
port |
Port of the Oracle WebLogic Server (for example, 7001 ). |
user |
User name for connecting to the running server to get mBean information (for example, weblogic ). |
password |
Password for the user name. |
compositeName |
Name of the SOA composite application. |
revision |
Revision of the SOA composite application. |
label |
Optional. Label of the SOA composite application. The label identifies the MDS artifacts associated with the application. If the label is not specified, the system finds the latest one. |
Command Category: Application Management Commands
Use with WLST: Offline
Sets a SOA composite application revision as the default version. This revision is instantiated when a new request comes in.
sca_assignDefaultComposite(host, port, user, password, compositeName, revision)
Argument | Definition |
---|---|
host |
Hostname of the Oracle WebLogic Server (for example, myhost ). |
port |
Port of the Oracle WebLogic Server (for example, 7001 ). |
user |
User name for connecting to the running server to get mBean information (for example, weblogic ). |
password |
Password for the user name. |
compositeName |
Name of the SOA composite application. |
revision |
Revision of the SOA composite application. |
Command Category: Application Management Commands
Use with WLST: Offline
sca_listDeployedComposites(host, port, user, password)
Argument | Definition |
---|---|
host |
Hostname of the Oracle WebLogic Server (for example, myhost ). |
port |
Port of the Oracle WebLogic Server (for example, 7001 ). |
user |
User name for connecting to the running server to get mBean information (for example, weblogic ). |
password |
Password for the user name. |
Use the configuration plan management commands, listed in Table 10-4, to attach, extract, generate, and validate configuration plans for SOA composite applications.
Table 10-4 Configuration Plan Management Commands for WLST Configuration
Use this command... | To... | Use with WLST... |
---|---|---|
Attach the configuration plan file to the SOA composite application JAR file. |
Offline |
|
Extract a configuration plan packaged with the JAR file for editing. |
Offline |
|
Generate a configuration plan for editing. |
Offline |
|
Validate the configuration plan. |
Offline |
Command Category: Configuration Plan Management Commands
Use with WLST: Offline
Attaches the configuration plan file to the SOA composite application file. If a plan already exists in the file, it is overwritten with this new plan.
sca_attachPlan(sar, configPlan, overwrite, verbose)
Argument | Definition |
---|---|
sar |
Absolute path of the SAR file. |
configPlan |
Absolute path of the configuration plan file. |
overwrite |
Optional. Indicates whether to overwrite an existing configuration plan in the SAR file.
|
verbose |
Optional. Indicates whether to print more information about the configuration plan attachment.
|
The following example attaches the configplan.xml
configuration plan file to the HelloWorld
application.
wls:/mydomain/ServerConfig> sca_attachPlan("/tmp/sca_HelloWorld_rev1.0.jar", "/tmp/configplan.xml")
The following example overwrites the existing configuration plan with configplan.xml
file in the HelloWorld
application.
wls:/mydomain/ServerConfig> sca_attachPlan("/tmp/sca_HelloWorld_rev1.0.jar", "/tmp/configplan.xml", overwrite=true)
Command Category: Configuration Plan Management Commands
Use with WLST: Offline
Extracts a configuration plan packaged with the SOA composite application file for editing, This is an optional step. If no plan exists, this is the same as creating a new file with sca_generatePlan
.
sca_extractPlan(sar, configPlan, overwrite, verbose)
Argument | Definition |
---|---|
sar |
Absolute path of a SAR file. |
configPlan |
Absolute path of a configuration plan file to which to be extracted. |
overwrite |
Optional. Indicates whether to overwrite an existing configuration plan file in the SAR file.
|
verbose |
Optional. Indicates whether to print more information about configuration plan extraction.
|
The following example extracts the configplan.xml
file for editing from the HelloWorld
application.
wls:/mydomain/ServerConfig> sca_extractPlan("/tmp/sca_HelloWorld_rev1.0.jar", "/tmp/configplan.xml")
The following example extracts the configplan.xml
file for editing from the HelloWorld
application. This command also overwrites the existing plan.
wls:/mydomain/ServerConfig> sca_extractPlan("/tmp/sca_HelloWorld_rev1.0.jar", "/tmp/configplan.xml", overwrite=true)
Command Category: Configuration Plan Management Commands
Use with WLST: Offline
sca_generatePlan(configPlan, sar, composite, overwrite, verbose)
Argument | Definition |
---|---|
configPlan |
Absolute path of the configuration plan file to be generated. |
sar |
Absolute path of the SAR file. |
composite |
Absolute path of the composite.xml file in the expanded (unzipped) SAR directory. |
overwrite |
Optional. Indicates whether to overwrite an existing configuration plan file:
|
verbose |
Indicates whether to print more information about plan generation:
|
The following example generates the myplan.xml
configuration plan file for the HelloWorld
application.
wls:/mydomain/ServerConfig> sca_generatePlan("/tmp/myplan.xml", sar="/tmp/sca_HelloWorld_rev1.0.jar")
The following example generates the myplan2.xml
configuration plan file for the HelloWorld
application. The myplan2.xml
file overwrites the existing plan.
wls:/mydomain/ServerConfig> sca_generatePlan("/tmp/myplan2.xml", composite="/tmp/HelloWorld_rev1.0/composite.xml", overwrite=true)
Command Category: Configuration Plan Management Commands
Use with WLST: Offline
Validates the configuration plan. This command identifies all search and replacement changes to be made during deployment. Use this option for debugging only.
sca_validatePlan(reportFile, configPlan, sar, composite, overwrite, verbose)
Argument | Definition |
---|---|
reportFile |
Absolute path of the report file to be generated. Validation results are written to this file. |
configPlan |
Absolute path of the configuration plan file. |
sar |
Optional. The absolute path of the SAR file. |
composite |
Optional. The absolute path of the composite.xml file in the expanded (unzipped) SAR directory. |
overwrite |
Optional. Indicates whether to overwrite an existing configuration plan file:
|
verbose |
Optional. Indicates whether to print more information about configuration plan validation.
|
The following example validates the configplan.xml
configuration plan file for the HelloWorld
application.
wls:/mydomain/ServerConfig> sca_validatePlan("/tmp/myreport.xml", "/tmp/configplan.xml", sar="/tmp/sca_HelloWorld_rev1.0.jar")
The following example validates the configplan.xml
configuration plan file for the HelloWorld
application. The configplan.xml
plan overwrites the existing plan.
wls:/mydomain/ServerConfig> sca_validatePlan("/tmp/myreport.xml", "/tmp/configplan.xml",composite="/tmp/HelloWorld_rev1.0/composite.xml", overwrite=true)
Use the task validation command, listed in Table 10-5, to validate human workflow tasks.
Table 10-5 Task Validation Command for WLST Configuration
Use this command... | To... | Use with WLST... |
---|---|---|
Validate a human workflow task. |
Offline |
Command Category: Task Validation Commands
Use with WLST: Offline
Validates a human workflow task contained in the .task
file that you created when designing a human task in the Human Task Editor.
sca_validateTask(taskFile, outXml, displayLevel)
Argument | Definition |
---|---|
taskFile |
Absolute path to the task definition file (.task ). |
outXml |
Absolute path to an output XML file. |
displayLevel |
Optional. The level of information to display. The default value is 1 . |
Use the compilation commands, listed in Table 10-6, to compile SOA composite applications.
Table 10-6 SOA Composite Application Compilation Commands for WLST Configuration
Use this command... | To... | Use with WLST... |
---|---|---|
Set JVM system properties. |
Offline |
|
Compile a SOA composite application. |
Offline |
Command Category: Application Compilation Commands
Use with WLST: Offline
Sets JVM system properties. This command can also set secure socket layer (SSL) system properties before using sca_deployComposite
and sca_undeployComposite
over SSL.
sca_setProp(propName, propValue)
Argument | Definition |
---|---|
propName |
Property name. |
propValue |
Property value. |
Command Category: Application Compilation Commands
Use with WLST: Offline
Compiles a SOA composite application.
Note:
Thesca_compile
command requires the oracle.home
property to find the ant-sca-compile.xml
script. This must be set once. You can use the scac_setProp
command or the oracleHome
property to set a value.sca_compile(composite, outXml, error, appHome, displayLevel, oracleHome, configDir)
Argument | Definition |
---|---|
composite |
Absolute path of a composite file in the expanded (unzipped) SAR directory. |
outXml |
Optional. Absolute path of an output XML file. |
error |
Optional. Absolute path of an error file. |
appHome |
Optional. Absolute path of the application home directory. This property is required if you have shared data. |
displayLevel |
Optional. The level of information to display. The default value is 1 . |
oracleHome |
Optional. The oracle.home property. |
The following example compiles the FirstComposite
application.
wls:/mydomain/ServerConfig> sca_compile("/tmp/FirstComposite_ rev1.0/composite.xml", displayLevel=2)
The following example compiles the FirstComposite
application and captures details in the myout.xml
file. The error.out
file captures any errors.
wls:/mydomain/ServerConfig> sca_compile("/tmp/FirstComposite_ rev1.0/composite.xml", outXml="/tmp/myout.xml", error="error.out")
The following example compiles the FirstComposite
application. The oracleHome
property is set to find the ant-sca-compile.xml
script.
wls:/mydomain/ServerConfig> sca_compile("/tmp/FirstComposite_ rev1.0/composite.xml", displayLevel=2, oracleHome="/scratch/myusername/beahome/AS11gR1SOA")
Use the packaging command, listed in Table 10-7, to package SOA composite applications into a composite SAR file.
Table 10-7 SOA Composite Application Packaging Command for WLST Configuration
Use this command... | To... | Use with WLST... |
---|---|---|
Package the SOA composite application files into a composite SAR file. |
Offline |
Command Category: Application Packaging Commands
Use with WLST: Offline
Packages the SOA composite application files into a composite SAR file. This command performs the following operations:
Calls sca_compile
to compile the composite artifacts in ${compositeDir}
.
Calls javac
to compile any source code under ${compositeDir}/src
.
Replaces the revision in ${compositeDir}/composite.xml
.
Packages the artifacts to create sca_${compositeName}_rev${revision}.jar
in ${compositeDir}/deploy
.
Note:
Thesca_package
command requires oracle.home
to find the ant-sca-package.xml
script. This must be set once. You can use the scac_setProp
command or oracleHome
property to set this property.sca_package(compositeDir, compositeName, revision, appHome, oracleHome, configDir)
Argument | Definition |
---|---|
compositeDir |
Absolute path of a directory that contains composite artifacts. |
compositeName |
Name of the composite. |
revision |
Revision ID of the composite. |
appHome |
Optional. Absolute path of the application home directory. This property is required if you have shared data. |
oracleHome |
Optional. The oracle.home property. |
The following example packages the OrderBookingComposite
application. The appHome
property is set because this application uses shared data.
wls:/mydomain/ServerConfig> sca_package("/tmp/app_data/OrderBookingComposite", "OrderBookingComposite", "1.0", appHome="/tmp/app_data")
The following example packages the HelloSOAComposite
application.
wls:/mydomain/ServerConfig> sca_package ("/tmp/HelloSOAApplication/HelloSOAComposite", "HelloSOAComposite", "1.0")
The following example packages the HelloSOAComposite
application. The oracleHome
property is set to find the ant-sca-compile.xml
script.
wls:/mydomain/ServerConfig> sca_package ("/tmp/HelloSOAApplication/HelloSOAComposite", "HelloSOAComposite", "1.0", oracleHome="/scratch/myusername/beahome/AS11gR1SOA")
Use the SOA composite application test command, listed in Table 10-8, to test a SOA composite applications.
Table 10-8 SOA Composite Application Test Command for WLST Configuration
Use this command... | To... | Use with WLST... |
---|---|---|
Test deployed SOA composite applications. |
Offline |
Command Category: Application Test Commands
Use with WLST: Offline
Tests deployed SOA composite applications prior to deployment in a production environment. You create suites of tests in Oracle JDeveloper. The sca_test
command calls ant-sca-test.xml
.
sca_test('compositeName', 'revision', 'testsuiteName', 'jndiPropFile', oracleHome='oracleHome', javaHome='javaHome')
Argument | Definition |
---|---|
compositeName |
Name of the SOA composite application. |
revision |
Revision ID of the SOA composite application. |
testsuiteName |
Name of the test suite. |
jndiPropFile |
Absolute path to the JNDI property file. |
oracleHome |
Optional. The oracle.home system property. |
javaHome |
Optional. The java.passed.home system property. |