Application administration scripts

The scripting library provides multiple script procedures to automate your application configurations. See the usage information for scripts that start and stop applications. You can run each script individually or combine procedures to create custom automation scripts for your environment.

Each application management script procedure is located in the app_server_root/scriptLibraries/application/V70 directory. Use the following script procedures to start and stop applications:

startApplicationOnSingleServer

This script starts an application on a single server.

To run the script, specify the application name, node name, and server name arguments, as defined in the following table:
Table 1. startApplicationOnSingleServer argument descriptions . Run the script to start an application on a server.
Argument Description
appName Specifies the name of the application to start.
nodeName Specifies the name of the node on which the application is deployed.
serverName Specifies the name of the application server on which the application is deployed.

Syntax

AdminApplication.startApplicationOnSingleServer(appName, nodeName, serverName)

Example usage

AdminApplication.startApplicationOnSingleServer("myApp", "myNode", "myServer")

startApplicationOnAllDeployedTargets

This script starts an application on all deployed nodes.

To run the script, specify the application name and node name arguments, as defined in the following table:
Table 2. startApplicationOnAllDeployedTargets argument descriptions . Run the script to start an application on all deployable targets.
Argument Description
appName Specifies the name of the application to start.
nodeName Specifies the name of the node on which the application is deployed.

Syntax

AdminApplication.startApplicationOnAllDeployedTargets(appName, nodeName)

Example usage

AdminApplication.startApplicationOnAllDeployedTargets("myApp", "myNode")

startApplicationOnCluster

This script starts an application on a cluster.

To run the script, specify the application name and cluster name arguments, as defined in the following table:
Table 3. startApplicationOnCluster argument descriptions . Run the script to start an application on a cluster.
Argument Description
appName Specifies the name of the application to start.
clusterName Specifies the name of the cluster on which the application is deployed.

Syntax

AdminApplication.startApplicationOnCluster(appName, clusterName)

Example usage

AdminApplication.startApplicationOnCluster("myApp", "myCluster")
Avoid trouble: AdminApplication.startApplicationOnCluster only runs on a fully started cluster. An exception is raised with an error code of WASL6044E if you run AdminApplication.startApplicationOnCluster when the cluster is in a partially started or stopped state.

stopApplicationOnSingleServer

This script stops an application on a single server.

To run the script, specify the application name, node name, and server name arguments, as defined in the following table:
Table 4. stopApplicationOnSingleServer argument descriptions . Run the script to stop an application on a server.
Argument Description
appName Specifies the name of the application to stop.
nodeName Specifies the name of the node on which the application is deployed.
serverName Specifies the name of the application server on which the application is deployed.

Syntax

AdminApplication.stopApplicationOnSingleServer(appName, nodeName, serverName)

Example usage

AdminApplication.stopApplicationOnSingleServer("myApp", "myNode", "myServer")

stopApplicationOnAllDeployedTargets

This script stops an application on all deployed nodes.

To run the script, specify the application name, cell name, and node name arguments, as defined in the following table:
Table 5. stopApplicationOnAllDeployedTargets argument descriptions . Run the script to stop an application on all deployment targets.
Argument Description
appName Specifies the name of the application to stop.
nodeName Specifies the name of the node on which the application is deployed.

Syntax

AdminApplication.stopApplicationOnAllDeployedTargets(appName, nodeName)

Example usage

AdminApplication.stopApplicationOnAllDeployedTargets("myApp", "myNode")

stopApplicationOnCluster using wsadmin scripting

This script stops an application on a cluster.

To run the script, specify the application name and cluster name arguments, as defined in the following table:
Table 6. stopApplicationOnCluster argument descriptions . Run the script to stop an application on a cluster.
Argument Description
appName Specifies the name of the application to stop.
clusterName Specifies the name of the cluster on which the application is deployed.

Syntax

AdminApplication.stopApplicationOnCluster(appName, clusterName)

Example usage

AdminApplication.stopApplicationOnCluster("myApp", "myCluster")