APCconfig.jacl script

Use the APCconfig.jacl script to make persistent changes to the application placement controller configuration.

Purpose

You can use the APCconfig.jacl script to modify attributes and custom properties of the application placement controller and dynamic clusters.
For transitioning users For transitioning users: The WebSphere® Virtual Enterprise command that equates to APCconfig.jacl is xd_APCconfig.jacl. If you are making the transition from WebSphere Virtual Enterprise, you can continue to use the xd_APCconfig.jacl command, which operates the same as the APCconfig.jacl command.trns

Location

The APCconfig.jacl script is in the app_server_root/bin directory.

Usage

To change the configuration, you must have configurator or administrator administrative privileges.

To run the APCconfig.jacl script with the wsadmin tool, use the following command:
wsadmin.sh -profile APCconfig.jacl -c "insert_proc"

In place of the insert_proc variable, use the name of the procedure and the proper variable values to complete your changes. Enclose the procedures in quotation marks. Modify the wsadmin command to wsadmin.sh or wsadmin.bat, depending on your operating system.

Procedures

To receive a list of the valid attributes that you can set on the application placement controller or dynamic cluster, run the following wsadmin command:
 $AdminConfig show [$AdminConfig getid "/DynamicCluster:clustername/"]

The following procedures are available:

setAPCAttribute attribute_value
Sets the defined attribute and value on the application placement controller. For a list of the valid attributes for the application placement controller, run the following wsadmin command:
$AdminConfig show [$AdminConfig getid "/AppPlacementController:/"]
getAPCAttribute attribute_name
Displays the specified application placement controller attribute and value.
setAPCCustomProperty property value description
Sets the specified application placement controller custom property name, value, and description. For more information about custom properties that you can set on the application placement controller, read about application placement custom properties . For example, the following command sets the numVerticalInstances custom property:
wsadmin.sh -profile APCconfig.jacl -c "setAPCCustomProperty numVerticalInstances.myNode 3 verticalstacking"
getAPCCustomProperty custom_property_name
Gets the value and description for the specified application placement controller custom property. For example, the following command gets the value of the numVerticalInstances custom property:
wsadmin.sh -profile APCconfig.jacl -c "getAPCCustomProperty numVerticalInstances.myNode"
setDynamicClusterAttribute dynamic_cluster_name attribute_value
Sets the defined attribute and value for the specified dynamic cluster. For a list of the valid attributes for dynamic clusters, run the following wsadmin command:
$AdminConfig show [$AdminConfig getid "/DynamicCluster:clustername/"]
getDynamicClusterAttribute dynamic_cluster_name attribute
Displays the value for the specified dynamic cluster attribute.
setDynamicClusterCustomProperty dynamic_cluster_name custom_property_name value description
Sets a custom property on the specified dynamic cluster. For more information about custom properties that you can set on dynamic clusters, read about dynamic cluster custom properties. For example, the following command sets the HTTPsessionRebalanceOff custom property:
wsadmin.sh -profile APCconfig.jacl -c "setDynamicClusterCustomProperty my_dyncluster HTTPSessionRebalanceOff true disablerebalancing"
getDynamicClusterCustomProperty dynamic_cluster_name property
Gets the value of the specified custom property for a dynamic cluster. For example, the following command gets the value of the HTTPSessionRebalanceOff custom property:
wsadmin.sh -profile APCconfig.jacl -c "getDynamicClusterCustomProperty my_dyncluster HTTPSessionRebalanceOff"
Reference topic    

Terms and conditions for information centers | Feedback

Last updated: March 19, 2013 10:03 PM CST
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-nd-mp&topic=rwve_odappscript2
File name: rwve_odappscript2.html