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