The Set Memory for VM action in vRealize Operations Manager is used to add or remove memory on virtual machines. You increase the memory to address performance problems or decrease the memory to reclaim resources.

How the Action Works

The Set Memory for VM action determines the power state of the target virtual machines, takes a snapshot if you request it, powers off the machine if required and requested, changes the memory to the new value, and returns the virtual machines their original power states.

An alternative form of the Set Memory for Virtual Machine action is available for automation. This action can run when the virtual machine is powered on or off.

Use this version of the action if the automated action has permission to power off the virtual machine, and hot add of memory is not enabled on the virtual machine. With hot add enabled, you can add memory, but you cannot remove it.

This version of the action would be required if a virtual machine is powered on and the amount of memory must be reduced.

This version of the action has the Power Off Allowed flag set to true. You can select this Power Off Allowed version of the action when you create or edit alerts and associate the alert with a recommendation. When the Power Off Allowed version of this action is automated, you do not select this version of the action.

If Hot Plug is enabled on the virtual machines, then power off is not required. If power off is required and VMware Tools are installed, then the virtual machines are shut down before they are powered off.

Where You Run the Action

You can run the Rebalance Container action from the Actions menu for a data center or custom data center, or you can provide it as a recommended action on an alert.

For the supported objects and object levels, this action is available in the following locations in vRealize Operations Manager:

  • Embedded just below the top menu.

  • On the toolbar when you click Environment in the menu, select an object, click the Details tab and click Views.

  • On the toolbar when you click Environment in the menu, select an object, click the Environment tab, and select an object in the list view.

  • In the Inventory Explorer list when you click Administration in the menu, click Configuration > Inventory Explorer, click the List tab, and select an object in the list.

  • In configured alert recommendations.

  • In the Object List and Topology Graph dashboard widgets.

Action Options

Review the following information about the virtual machines to ensure that you are submitting the action for the correct objects.

Option

Description

Selected objects

Check box indicates whether the action is applied to the object. To not run the action on one or more objects, deselect the associated check boxes. This option is available when two or more objects are selected.

If you modify a value, the check box is selected. The check box must be selected to enable the OK button.

Name

Name of the virtual machine as it appears in the environment inventory.

New (MB)

Requested amount of memory in megabytes. The value must be a multiple of 4, and must not be less than 4. If the value is less than 4 or is not a multiple of 4, the amount of memory does not change, and Recent Tasks displays the action as failed.

  • When the virtual machine power state is PoweredOn, the memory hot plug configuration limits of the virtual machine are factored into the requested amount and might result in a different configured memory than requested.

  • If memory hot plug is not enabled, the request fails unless you also select Power Off Allowed.

  • If memory hot plug is enabled, the configured memory is adjusted to be a multiple of the virtual machine hot plug memory increment, and at least that increment more than the current virtual machine memory configuration. The adjusted memory configuration must also be no more than the hot plug memory limit.

If the memory hot plug constraints of the virtual machine cannot be satisfied, the amount of memory does not change, and Recent Tasks displays the action as failed unless you also you also select Power Off Allowed. If Power Off Allowed is selected, the action first attempts to satisfy the memory reconfiguration request without powering off the virtual machine, and only powers off the virtual machine if it is necessary to reconfigure the memory.

Current (MB)

Amount of memory in megabytes that is currently configured on the virtual machine.

Power State

Indicates whether the virtual machine is powered on or powered off.

Power Off Allowed

If selected, the action shuts down or powers off the virtual machine before modifying the value. If VMware Tools is installed and running, the virtual machine is shut down. If VMware Tools is not installed or not running, the virtual machine is powered off without regard for the state of the operating system.

In addition to whether the action shuts down or powers off a virtual machine, you must consider whether the object is powered on and what settings are applied.

See Working With Actions That Use Power Off Allowed.

Snapshot

Creates a snapshot of the virtual machine before modifying the memory. Use this option if you need a snapshot to which you can revert the virtual machine if the action does not produce the expected results.

The name of the snapshot is supplied in the Recent Tasks messages for the action.

If the memory is changed with Memory Hot Plug enabled, then the snapshot is taken with the virtual machine is running, which consumes more disk space.

Host

Name of the host on which the virtual machine is running.

Adapter Instance

Name of the VMware Adapter as it is configured in vRealize Operations Manager. The adapter manages the communication with the vCenter Server instance.

After you click OK, the next dialog box provides the task ID and a link to the task list.

Table 1. Task ID Dialog Box

Option

Description

Recent Tasks

To view the status of the job and verify that the job finished, click Recent Tasks.

OK

To close the dialog box without further action, click OK.