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


Application placement custom properties

Custom properties modify the application placement controller configuration. You can use these settings to tune the application placement controller behavior beyond the settings that are in the administrative console.




Related tasks
Creating dynamic clusters
Configuring dynamic application placement
[Version 6.0.1 and later]

cpuUtilizationThreshold custom property

Use the cpuUtilizationThreshold custom property to define the percentage of CPU power that you can use on each node in a cell.

The cpuUtilizationThreshold custom property defines the percentage of CPU power that is used on the nodes in your environment. The default value is 100, which means that 100% of the CPU can be used on each node in the cell. For configurations that involve z/OS nodes, you must set this value to less than 100.

The application placement controller attempts to compute placements so that the utilization of any node does not exceed the defined threshold. The application placement controller considers all processes, including processes that are not related to WebSphere Application Server or WebSphere Extended Deployment when making these calculations.

[For z/OS operating system] Important: This property must be defined and must be set to a value less than 100 for configurations that involve z/OS nodes.
You can set this property on the cell to apply to all the nodes in the cell or you can specify the value for a particular node in your configuration. To define the property to specify the threshold for all nodes in the cell, perform the following steps:
  1. In the administrative console, click Operational policies > Autonomic managers > Application placement controller > Custom properties > New.
  2. Type the name of the custom property as cpuUtilizationThreshold.
  3. Specify the percentage of CPU power to use on each node in the cell.
  4. Click Apply and save your configuration.
[Version 6.0.1 and later]

GenerateUniquePorts custom property

Use the GenerateUniquePorts custom property to generate unique ports for each dynamic cluster member.

[For z/OS operating system] By default, dynamic cluster members on distributed nodes are created with unique ports, while z/OS nodes do not have unique ports. On the z/OS platform, port numbers are usually set symmetrically according to specific range of numbers. The first dynamic cluster member always has unique ports, and these port numbers are applied to the other dynamic cluster members. You can set this property on the node group or on an individual node.
  • Setting the custom property on the node group:
    1. In the administrative console, click System administration > Node groups > node_group_name > Custom properties > New.
    2. Type GenerateUniquePorts as the name of the custom property.
    3. Specify the value as true or false. By specifying true, unique ports are generated for each dynamic cluster member. By specifying false, unique ports are created for the first dynamic cluster member, and subsequent dynamic cluster members use the same ports.
  • Setting the custom property on a node:
    1. In the administrative console, click System administration > Node groups > node_group_name > Custom properties > New.
    2. Type GenerateUniquePorts.node_name as the name of the custom property, where the node_name variable is the name of the node in the node group.
    3. Specify the value as true or false. By specifying true, unique ports are generated for each dynamic cluster member on the specified node. By specifying false, unique ports are created for the first dynamic cluster member on the node, and subsequent dynamic cluster members use the same ports.
Table 1. GenerateUniquePorts custom property default values
default (z/OS) false
Attention: If vertical stacking is enabled for a z/OS dynamic cluster, the port allocation strategy is forced to true, to generate unique ports for each dynamic cluster member.
default (distributed platforms) true

HttpSessionRebalanceOff custom property

Use the HttpSessionRebalanceOff custom property to disable HTTP session rebalancing.

With WebSphere Extended Deployment Version 6.0 or later, HTTP session rebalancing is automatically enabled. You can use HTTP session rebalancing to reassign existing session affinities to new servers that become available for processing the given Web application. See HTTP session rebalancing for more information.

Use the HttpSessionRebalanceOff custom property if you want to return your configuration to the old HTTP session behavior, where session affinities are established with a particular application server and are not reassigned to any new servers that become available.

You might consider disabling HTTP session rebalancing if your session sizes are large. If your sessions are large, the cost of moving the sessions to a new server might be more than the benefit of taking the workload off of the original server. You can use Performance Monitoring Infrastructure (PMI) data to make the decision to turn off session rebalancing. You might see in your PMI data that response time, memory utilization, and CPU utilization increases on specific servers to transfer the session information. See the WebSphere Application Server Network Deployment Information Center for more information about analyzing PMI data and best practices for using HTTP sessions.

If you leave session rebalancing on, as sessions become more evenly distributed, and memory and CPU utilization also become more evenly distributed across the servers in the cluster. If a cluster is more balanced, it is easier for WebSphere Extended Deployment to make autonomic decisions.

Perform the following steps to disable HTTP session rebalancing:

  1. In the administrative console, click Servers > Dynamic clusters > dynamic_cluster_name > Custom properties > New.
  2. Type the name as HttpSessionRebalanceOff and set the value to true.
  3. Click Apply and save your configuration.

To turn session rebalancing back on, delete the custom property.

memoryProfiler.isDisabled custom property

Under the default operation, the application placement controller profiles dynamic clusters online to determine their memory usage. You can disable this default operation by setting the memoryProfiler.isDisabled custom property to true. When the memory profiler is disabled, the application placement controller assumes a default memory usage value. This memory usage value is computed as 64k + 1.2 maxHeapSize, where maxHeapSize is the maximum heap size setting in the server template of the dynamic cluster.

Perform the following steps to disable the memory profiler:
  1. In the administrative console, click Operational Policies > Autonomic Managers > Application Placement Controller > Custom Properties > New.
  2. Type the name as memoryProfiler.isDisabled and set the value to true.
  3. Click Apply and save your configuration.

numVerticalInstances custom property

Use this custom property to define the number of dynamic cluster instances on a node.

Use this custom property only if the nodes in your dynamic cluster are heterogeneous and vary in power. If the nodes in your dynamic cluster are homogenous, you can define the number of dynamic cluster instances one time in the administrative console.

See Configuring vertical stacking for more information.

[Version 6.0.2 and later]

proactiveIdleStop custom property

Use this custom property to stop dynamic cluster instances during periods of inactivity.

This custom property adds function to the Stop all instances during periods of inactivity setting in the administrative console. With the administrative console setting, instances stop only if other clusters in the cell need the resources that are being used by the inactive instances. You also specify an amount of time to wait before stopping instances for the cluster. By setting this custom property, inactive instances stop even if the resources are not required elsewhere in the environment. The custom property goes idle in the amount of time that you specified in the administrative console setting.

You can set this custom property on all dynamic clusters by creating the custom property on the cell level. You can also create the custom property on a single dynamic cluster. If the property is set on both the cell and the dynamic cluster, the dynamic cluster setting is used.

  1. Click Servers > Dynamic clusters > dynamic_cluster_name. Verify that the Stop all instances during periods of inactivity option is selected for your dynamic cluster and that you have the Time to wait before stopping instances specified. If this option is not selected, then the custom property that you create is ignored.
  2. Click Custom properties > New or System administration > Cell > Custom properties > New.
  3. Type the name as proactiveIdleStop and set the value to true. By default, this custom property is disabled.
  4. Click Apply and save your configuration.
[Version 6.0.1 and later]

reservedMemoryFixed and reservedMemoryPercent custom properties

Use these custom properties to define how much memory on each node to reserve for processes that are not related to WebSphere Application Server or WebSphere Extended Deployment.

When these properties are defined, the total memory on a node for processes that are not related to WebSphere Application Server or WebSphere Extended Deployment can be calculated using the following formula:
reservedMemoryFixed + reservedMemoryPercent * (totalNodeMemory - reservedMemoryFixed)
Property name Definition Default
reservedMemoryFixed A fixed amount of memory to reserve. 64 MB
reservedMemoryPercent A percentage of memory to reserve. 5%
You can define these custom properties across the entire cell to apply to all nodes in the cell, or on individual nodes. To define these custom properties for all nodes in the cell, perform the following steps:
  1. In the administrative console, click Operational Policies > Autonomic Managers > Application Placement Controller > Custom Properties > New.
  2. Type the name of the custom property, either reservedMemoryFixed or reservedMemoryPercent.
  3. Specify the reserved memory value to apply to all nodes in the cell.
  4. Click Apply and save your configuration.
To define the custom properties for a particular node in your cell, perform the following steps:
  1. In the administrative console, click Operational Policies > Autonomic Managers > Application Placement Controller > Custom Properties > New.
  2. Type the name of the custom property, either reservedMemoryFixed.node_name or reservedMemoryPercent.node_name, where node_name is the name of your node. For example, if your node is named node1, the names of your custom properties are reservedMemoryFixed.node1 and reservedMemoryPercent.node1.
  3. Specify the reserved memory value to apply for the specified node.
  4. Click Apply and save your configuration.

useNodeFreeMemory

Use this custom property to define a replacement to the reservedMemory default custom property. It will use the node's free memory statistic, plus the memory calculated for any dynamic cluster instances already residing, to calculate the memory available for launching additional DC instances.

To define the custom property for a particular node in your cell, perform the following steps:
  1. In the administrative console, click Operational Policies > Autonomic Managers > Application Placement Controller > Custom Properties > New.
  2. Type the name of the custom property useNodeFreeMemory.
  3. Specify true as the value to apply to all nodes in the cell.
  4. Click Apply and save your configuration.


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/rodplacecustprop.html