Use the PlacementControllerProcs.jacl script to modify the application placement runtime configuration.
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.
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.wsadmin> source PlacementControllerProcs.jacl wsadmin> procedure variablesIn place of procedure, insert the procedure. In place of variables, provide the variables to support your procedure.
wsadmin -profile PlacementControllerProcs.jacl -c "help"
The following procedures are available: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. |