The Set Memory for VM action in vRealize Operations Cloud 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 perform several tasks. The action determines the power state of the target virtual machines, takes a snapshot when you request it and powers off the machine if necessary and you request it. As well, the action 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 is installed, then the virtual machines are shut down before they are powered off.

Where You Run the Action

For the supported objects and object levels, this action is available in the following locations in vRealize Operations Cloud:
  • 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 list when you click Administration in the menu, click Inventory, then 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 CPU

Number of CPUs when the action is completed. If the value is less than 1 or a value not supported for the virtual machine in vCenter Server, and the virtual machine is powered on and Hot Add is not enabled, the number of CPUs does not change and Recent Tasks shows the action as failed. If the virtual machine is powered off when you submit an unsupported value, the task reports success, but the virtual machine will fail when you run a power on action.

The value that appears is the calculated suggested size. If the target virtual machine is new or offline, this value is the current number of CPUs. If vRealize Operations Cloud has been monitoring the virtual machine for six or more hours, depending on your environment, the value that appears is the CPU Recommended Size metric.

Current CPU

Number of configured CPUs.

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 section in vRealize Operations Cloud Configuration Guide. .

Snapshot

Creates a snapshot before changing the number of CPUs. 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 CPU is changed with CPU 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 Cloud. 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
OK To close the dialog box without further action, click OK.
Recent Tasks To view the status of the job and verify that the job finished, click Recent Tasks.