PlacementControllerProcs.jacl script
Use the PlacementControllerProcs.jacl script to modify the application placement runtime configuration.
Depending on our administrative role, we are allowed specific privileges when configuring the autonomic managers. To use this script to configure the autonomic managers, we must have administrator privileges. Use the PlacementControllerProcs.jacl script to modify an entire series of application placement controller configuration options. We can complete the following operations on the runtime configuration.
- Enable or disable the application placement controller
- Make the specified node managed or unmanaged by the application placement controller
- Enable or disable a dynamic cluster
- Retrieve or set the values of additional settings
This script modifies only the runtime configuration of the application placement controller. To make persistent changes to the configuration, use the APCconfig.jacl script.
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
The PlacementControllerProcs.jacl script is in the app_server_root/bin directory.
To run the PlacementControllerProcs.jacl script with the wsadmin utility.
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 our changes. Enclose the procedures in quotation marks (").
Procedures
To see a list of all the available procedures.
wsadmin -profile PlacementControllerProcs.jacl -c "help"
The following procedures are available.
- anyFailedServerOperations
- Display a list of failed starts by servers that the application placement controller tried to start.
- closeLockMultiAPCGate removeAPCID
- Closes and locks a gate for a multiple application placement controller setup. The APCGate mechanism can optionally be used to ensure that multiple placement controllers in different Intelligent Management systems do not run their decision-making cycles at the same time. Enabling the APCGate mechanism is important when multiple separate Intelligent Management cells are sharing the same physical hardware.
- deferFailedServerOperations
- Disables the enablement of maintenance mode on any servers that failed to start by the application placement controller.
- disable
- Disables the application placement controller.
- disableDynamicCluster dynamic_cluster_name
- Set the specified dynamic cluster to run manually.
- disableNode node
- Makes the specified node unmanaged by the application placement controller.
- enable
- Enable the application placement controller.
- enableDynamicCluster dynamic_cluster_name
- Set the specified dynamic cluster to run automatically.
- enableNode node
- Enable the application placement controller for the specified node.
- findBestLocation cell node server
- Returns one of three values that indicates an action to take when we attempt to stop a server that is a member of a dynamic cluster. This procedure returns one of the following values:
- null: We can stop the server that was passed into the procedure without problems.
- server name: We should not stop the server name that you passed into the procedure.
- alternate server name: If the name of another server is returned, we should stop that server first.
- getApprovalTimeOut
- When running in supervised mode, returns the amount of time to wait for an administrator to approve a task before the task times out.
- getMinTimeBetweenPlacementChange
- Return the minimum time between two consecutive placement changes.
- getNodeName
- Display the node on which the application placement controller is running.
- getServerOperationTimeOut
- Return the amount of time after which the start and stop operation performed on the server is considered a failure, if not completed.
- handleFailedServerOperations
- Places any servers into maintenance mode that did not start when the application placement controller tried to start the server.
- isNodeInUse node
- Checks if a node is still in use after it is in maintenance mode.
- isPrimary
- Returns if this node is the primary node where the application placement controller is running.
- isEnabled
- Returns if the application placement controller is enabled.
- openMultiAPCGate remoteAPCID
- Opens the gate for a multiple application placement controller setup.
- recomputePlacement
- Triggers the application placement controller to compute its optimization and perform any necessary placement changes.
- setMinTimeBetweenPlacementChange time
- Set the minimum time, in minutes, between two consecutive placement changes.
- setServerOperationTimeOut timeout
- Set the timeout, in minutes, after which the start or stop operation performed on the server is considered a failure, if not completed.
- setApprovalTimeOut approval_timeout
- Set the amount of time, in minutes, to wait for the administrator approval when operating in supervised mode before considering the task denied.
- unlockMultiAPCGate remoteAPCID
- Unlocks the gate for a multiple application placement controller setup.
- enableElasticity
- Enable elasticity mode in the application placement controller. Valid arguments are true or false.
- isElasticityModeEnabled
- Specifies whether elasticity mode is enabled. The return value is either true or false.
- elasticityMode
- Set the runtime tasks for application placement elasticity as supervised or automatic. Valid arguments are 0 for automatic or 1 for supervised.
- getElasticityMode
- Specifies if application placement elasticity is set to supervised or automatic. The return value is either 0 or 1.
- elasticityModeTimeOut
- Amount of time, in minutes, an elasticity action is allowed to complete before it is considered a failure. For example, if to set the operation timeout value to 30 minutes, specify the procedure as elasticityModeTimeOut 30 0.
- getElasticityTimeOutMins
- Return the amount of time, in minutes, an elasticity action is allowed to complete before it is considered a failure.
Overview of application placement Configure dynamic application placement Monitor and tuning the application placement controller Intelligent Management: administrative roles and privileges