10 Oracle SOA Suite Custom WLST Commands

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.

Overview of WSLT Command Categories

WLST commands are divided into the categories shown in Table 10-1.

Table 10-1 Oracle SOA Suite Command Categories

Command category Description

Deployment Commands

Deploy and undeploy SOA composite applications.

SOA Composite Application Management Commands

Start, stop, activate, retire, assign a default revision version, and list deployed SOA composite applications.

Configuration Plan Management Commands

Attach, extract, generate, and validate configuration plans for SOA composite applications.

Task Validation Commands

Validate human workflow tasks.

SOA Composite Application Compilation Commands

Compile SOA composite applications.

SOA Composite Application Packaging Commands

Package SOA composite applications into archive files to deploy.

SOA Composite Application Test Commands

Test SOA composite applications prior to deployment in a production environment.


Deployment Commands

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...

sca_deployComposite

Deploy a SOA composite application.

Offline

sca_undeployComposite

Undeploy a SOA composite application.

Offline


sca_deployComposite

Command Category: Deployment Commands

Use with WLST: Offline

Description

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.

Syntax

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:
  • SOA archive (SAR) file.

  • ZIP file that includes multiple SARs, metadata archives (MARs), or both.

  • Enterprise archive (EAR) file that contains a SAR file.

overwrite Optional. Indicates whether to overwrite an existing SOA composite application file.
  • false (default): Does not overwrite the file.

  • true: Overwrites the 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.
  • true (default): Makes it the default composite.

  • false: Does not make it the default composite.

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.

Examples

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")

sca_undeployComposite

Command Category: Deployment Commands

Use with WLST: Offline

Description

Undeploys a currently deployed SOA composite application.

Syntax

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.

Examples

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:

SOA Composite Application Management Commands

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...

sca_startComposite

Start a previously stopped SOA composite application.

Offline

sca_stopComposite

Stop a SOA composite application.

Offline

sca_activateComposite

Activate a previously retired SOA composite application.

Offline

sca_retireComposite

Retire a SOA composite application.

Offline

sca_assignDefaultComposite

Assign the default revision version to a SOA composite application.

Offline

sca_listDeployedComposites

List the deployed SOA composite applications.

Offline


sca_startComposite

Command Category: Application Management Commands

Use with WLST: Offline

Description

Starts a previously stopped SOA composite application.

Syntax

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.

Example

The following example starts revision 1.0 of the HelloWorld application.

wls:/mydomain/ServerConfig> sca_startComposite("myhost", "7001", "weblogic", 
"weblogic", "HelloWorld", "1.0")

sca_stopComposite

Command Category: Application Management Commands

Use with WLST: Offline

Description

Stops a currently running SOA composite application.

Syntax

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.

Example

The following example stops revision 1.0 of the HelloWorld application.

wls:/mydomain/ServerConfig> sca_stopComposite("myhost", "7001", "weblogic", 
"weblogic", "HelloWorld", "1.0")

sca_activateComposite

Command Category: Application Management Commands

Use with WLST: Offline

Description

Activates a retired SOA composite application and its instances. You can then create new instances.

Syntax

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.

Example

The following example activates revision 1.0 of the HelloWorld application.

wls:/mydomain/ServerConfig> sca_activateComposite("myhost", "7001", "weblogic", 
"weblogic", "HelloWorld", "1.0")

sca_retireComposite

Command Category: Application Management Commands

Use with WLST: Offline

Description

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.

Syntax

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.

Example

The following example retires revision 1.0 of the HelloWorld application.

wls:/mydomain/ServerConfig> sca_retireComposite("myhost", "7001", "weblogic",
"weblogic", "HelloWorld", "1.0")

sca_assignDefaultComposite

Command Category: Application Management Commands

Use with WLST: Offline

Description

Sets a SOA composite application revision as the default version. This revision is instantiated when a new request comes in.

Syntax

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.

Example

The following example sets revision 1.0 of the HelloWorld application as the default version.

wls:/mydomain/ServerConfig> sca_assignDefaultComposite("myhost", "7001", 
"weblogic", "weblogic", "HelloWorld", "1.0")

sca_listDeployedComposites

Command Category: Application Management Commands

Use with WLST: Offline

Description

Lists all SOA composite applications deployed to the SOA platform.

Syntax

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.

Example

The following example lists all the deployed SOA composite applications on the server myhost.

wls:/mydomain/ServerConfig> sca_listDeployedComposites('myhost', '7001', 
'weblogic', 'weblogic')

Configuration Plan Management Commands

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...

sca_attachPlan

Attach the configuration plan file to the SOA composite application JAR file.

Offline

sca_extractPlan

Extract a configuration plan packaged with the JAR file for editing.

Offline

sca_generatePlan

Generate a configuration plan for editing.

Offline

sca_validatePlan

Validate the configuration plan.

Offline


sca_attachPlan

Command Category: Configuration Plan Management Commands

Use with WLST: Offline

Description

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.

Syntax

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.
  • false (default): Does not overwrite the plan.

  • true: Overwrites the plan.

verbose Optional. Indicates whether to print more information about the configuration plan attachment.
  • true (default): Prints more information.

  • false: Does not print more information.


Examples

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)

sca_extractPlan

Command Category: Configuration Plan Management Commands

Use with WLST: Offline

Description

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.

Syntax

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.
  • false (default): Does not overwrite the plan.

  • true: Overwrites the plan.

verbose Optional. Indicates whether to print more information about configuration plan extraction.
  • true (default): Prints more information.

  • false: Does not print more information.


Example

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)

sca_generatePlan

Command Category: Configuration Plan Management Commands

Use with WLST: Offline

Description

Generates a configuration plan for editing.

Syntax

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:
  • false (default): Does not overwrite the plan.

  • true: Overwrites the plan.

verbose Indicates whether to print more information about plan generation:
  • true (default): Prints more information.

  • false: Does not print more information.


Examples

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)

sca_validatePlan

Command Category: Configuration Plan Management Commands

Use with WLST: Offline

Description

Validates the configuration plan. This command identifies all search and replacement changes to be made during deployment. Use this option for debugging only.

Syntax

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:
  • false (default): Does not overwrite the plan.

  • true: Overwrites the plan.

verbose Optional. Indicates whether to print more information about configuration plan validation.
  • true (default): Prints more information.

  • false: Does not print more information.


Examples

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)

Task Validation Commands

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...

sca_validateTask

Validate a human workflow task.

Offline


sca_validateTask

Command Category: Task Validation Commands

Use with WLST: Offline

Description

Validates a human workflow task contained in the .task file that you created when designing a human task in the Human Task Editor.

Syntax

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.

Example

The following example validates the WFTaskDefinition.task file of the human task.

wls:/mydomain/ServerConfig> sca_validateTask("/tmp/WFTaskDefinition.task", 
"/tmp/out.xml", displayLevel=2)

SOA Composite Application Compilation Commands

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...

sca_setProp

Set JVM system properties.

Offline

sca_compile

Compile a SOA composite application.

Offline


sca_setProp

Command Category: Application Compilation Commands

Use with WLST: Offline

Description

Sets JVM system properties. This command can also set secure socket layer (SSL) system properties before using sca_deployComposite and sca_undeployComposite over SSL.

Syntax

sca_setProp(propName, propValue)
Argument Definition
propName Property name.
propValue Property value.

Example

The following example sets the property name and property value.

wls:/mydomain/ServerConfig> sca_setProp("oracle.home",
"/scratch/myusername/beahome/AS11gR1SOA")

sca_compile

Command Category: Application Compilation Commands

Use with WLST: Offline

Description

Compiles a SOA composite application.

Note:

The sca_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.

Syntax

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.

Examples

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")

SOA Composite Application Packaging Commands

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...

sca_package

Package the SOA composite application files into a composite SAR file.

Offline


sca_package

Command Category: Application Packaging Commands

Use with WLST: Offline

Description

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:

The sca_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.

Syntax

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.

Examples

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")

SOA Composite Application Test Commands

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...

sca_test

Test deployed SOA composite applications.

Offline


sca_test

Command Category: Application Test Commands

Use with WLST: Offline

Description

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.

Syntax

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.

Examples

The following example runs the OrderBookingMainTestsuite test suite.

wls:/mydomain/ServerConfig> sca_test('OrderBookingComposite', '1.0',
 'OrderBookingMainTestsuite', '/tmp/tmp-jndi.properties',
 oracleHome='/scratch/<user>/beahome/AS11gR1SOA/',
 javaHome='/scratch/<user>/beahome/jdk160_05')