APCconfig.jacl script
Use the APCconfig.jacl script to make persistent changes to the application placement controller configuration.
Purpose
Use the APCconfig.jacl script to modify attributes and custom properties of the application placement controller and dynamic clusters. 
For transitioning users: The WebSphere Virtual Enterprise command that equates to APCconfig.jacl is xd_APCconfig.jacl. If we are making the transition from WebSphere Virtual Enterprise, we 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 wsadmin.sh, 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 the changes. Enclose the procedures in quotation marks. Modify wsadmin to wsadmin.sh or wsadmin.bat, depending on the operating system.
Procedures
To receive a list of the valid attributes that we 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 we 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 we 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"
Related tasks