Skip to main content

VMware: Modify Memory Size

Description

VMware: Modify Memory Size Plugin step modifies the available memory size of a virtual machine.

Configurations

No.Field NameDescription
1Step NameName of the step. This name has to be unique in a single workflow.
Configuration:
1vCenter Server Base URLSpecify the vCenter Server Base URL to connect to vCenter. (e.g.: https://vmware.example.com)

Note: If vCenter IP is given instead of vCenter server name, it throws certificate error, because the certificate contains entry of vCenter server in FQDN (Fully Qualified Domain Name) format.
2PortSpecify the vCenter server port. (Default port is 443).
This field should be an integer and value should be less than 65536.
3UsernameSpecify a Username to authenticate vCenter server.
Password:The password to authenticate vCenter server.
4Accept value as variable/staticLeave checkbox unchecked to accept Password value from a field in the previous steps of the stream using a drop down list.
Else enable checkbox for Password field to appear as Text box.
5vCenter PasswordPassword is entered using a widget. The widget handles both Text (static value or environment variable) and Combo (drop down containing values from previous steps). This field is mandatory.

If checkbox above is enabled Password field appears as Text box and accepts static or variable values. Else if checkbox above is disabled Password field appears as a drop down to select fields from previous steps.

Please Note: Field values can only be accessed when workflow is in running state.
Button: Test ConnectionVerifies whether the connection is available or not.
For the purpose of verification, fields coming from previous steps are not allowed since field values can only be accessed when workflow is in running state. Static values and environment variables are allowed.

Input Tab:

No.Field NameDescription
1Virtual Machine Name/UUIDSpecify the Name/UUID of the virtual machine to modify memory size.
This field data type is String. This field is mandatory.

Notes:
• Refer Get VM UUID in the VMWare Plugin introduction for steps to fetch the VM UUID.
• If two or more virtual machines with the same name appear in the vCenter Server inventory, then you may provide the UUID which is unique to each VM.
• If VM name contains ‘%’ special character then to execute the plugin step, provide VM name by replacing ‘%’ character with ‘%25’.
2Button: GetOn click of this button, if the connection is successfully established it populates the list of Virtual Machine Names on the vCenter server.

Note: If VM name contains ‘%’ special character then on click of ‘Get’ button, the VM name is returned by replacing ‘%’ character with ‘%25’. You may leave it like that.
3New Memory SizeSpecify the new Memory Size.
This field data type is integer. This field is mandatory. Notes:

1. Ensure that the virtual machine is using hardware version 7 or later.

2. The minimum memory size is 4MB for virtual machines that use BIOS firmware. Virtual machines that use EFI firmware require at least 96MB of RAM or they cannot power on.

3. When the virtual machine is Powered-Off, you can set any number of memory size through this plugin step (using REST API). If the virtual machine memory is greater than the host memory size, swapping occurs, which can have a severe effect on virtual machine performance. The memory size must be a multiple of 4MB.

4. Ensure that the virtual machine has a guest operating system that supports memory hot-add functionality.
4Modify Size By UnitAllowed values: ‘MB’ or ‘GB’. Memory size will be modified in the given size unit.
This field data type is string. This field is mandatory.

Common Buttons:

No.Field NameDescription
1OKClick this button to check and save the field values. If any required field values are missing, it will display a validation error message; else, if all the required field values are provided, it will save the field values.
2CancelClick this button to cancel the window and not save any values.