WebSphere Extended Deployment, Version 6.0.x
             Operating Systems: AIX, HP-UX, Linux, Solaris, Windows, z/OS


Application placement controller runtime configuration script

Use the PlacementControllerProcs.jacl script to modify the application placement runtime configuration.

Purpose

Depending on your administrative role, you are allowed specific privileges when configuring the autonomic managers. To use this script to configure the autonomic managers, you must have administrator privileges.

The PlacementControllerProcs.jacl script is provided with the product. At installation time, the script is copied onto the installation target machine in the <install_root>\bin directory. Use the PlacementControllerProcs.jacl script to modify an entire series of application placement controller configuration options. With the PlacementControllerProcs.jacl script you can:

This script modifies only the runtime configuration of the application placement controller. To make persistent changes to the configuration, use the xd_APCconfig.jacl script. See Changing application placement configurations with scripting for more information.

Usage

To run the PlacementControllerProcs.jacl script with the wsadmin utility, use this command:

wsadmin -profile PlacementControllerProcs.jacl -c "insert_proc_parameters"

In place of the insert_proc_parameters variable, use the name of the procedure and the proper variable values to complete your changes. You must enclose the procedures in quotation marks ("). You might have to modify the wsadmin command to wsadmin.sh or wsadmin.bat, depending upon your operating environment.
You can also launch the scripting client first. Use the Getting started with scripting topic for more information. In the wsadmin utility, type:
wsadmin> source PlacementControllerProcs.jacl
wsadmin> procedure variables
In place of procedure, insert the procedure. In place of variables, provide the variables to support your procedure.

Procedures

You can use the following command to see a list of all the available procedures:

wsadmin -profile PlacementControllerProcs.jacl -c "help"

The following procedures are available:
Table 1. PlacementControllerProcs.jacl script procedures
Procedure Description
enable Enables the application placement controller.
disable Disables the application placement controller.
disableNode node_name Makes the specified node unmanaged by the application placement controller.
disableNode node_group_name node_name Makes the node unmanaged as a member of the node group.
findBestNodeToDisable Finds the best node to disable.
isNodeInUse node_name Checks if a node is still in use after it is in maintenance mode.
enableNode node_name Makes the specified node managed by the application placement controller.
enableDynamicCluster node_group_name dynamic_cluster_name Sets the specified dynamic cluster to run automatically.
enableDynamicCluster dynamic_cluster_name Sets the specified dynamic cluster to run automatically.
disableDynamicCluster node_group_name dynamic_cluster_name Sets the specified dynamic cluster to run manually.
disableDynamicCluster dynamic_cluster_name Sets the specified dynamic cluster to run manually.
isEnabled Returns if the application placement controller is enabled.
getNodeName Displays the node on which the application placement controller is running.
setMinTimeBetweenPlacementChange time Sets the minimum time, in minutes, between two consecutive placement changes.
setServerOperationTimeOut timeout Sets the timeout, in minutes, after which the start or stop operation that is performed on the server is considered a failure, if not completed.
setApprovalTimeOut approval_timeout Sets the amount of time, in minutes, to wait for the administrator approval when operating in supervised mode before considering the task denied.
getMinTimeBetweenPlacementChange Returns the minimum time between two consecutive placement changes.
getServerOperationTimeOut Returns the amount of time after which the start and stop operation that is performed on the server is considered a failure, if not completed.
getApprovalTimeOut Returns the amount of time to wait for an administrator to approve a task when running in supervised mode.
recomputePlacement Triggers the application placement controller to compute its optimization and perform any necessary placement changes.
showFailedServerStarts Displays a list of servers that failed to start before the configured server operation timeout.



Related concepts
Overview of application placement for HTTP, IIOP and JMS
Related tasks
Configuring dynamic application placement
Monitoring and tuning the application placement controller
Related reference
Administrative roles and privileges
Reference topic    

Terms of Use | Feedback

Last updated: Nov 30, 2007 4:05:14 PM EST
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r0/index.jsp?topic=/com.ibm.websphere.xd.doc/info/reference/todappscripts.html