VMWare VSphere Virtual Machine Update CPU Version 1

This handler is designed to update a virtual machine on a VMWare VSphere server that matches the name supplied as a parameter. It logs in to the VSphere server using the server's administrative URL, user ID and password that are set as info_value records for the task. Once logged in, the virtual machine that will be updated is verified to make sure that the machine exists. Then a reconfigure command will be sent to vSphere to update the number of CPUs for the specified VM. Once the signal is sent, the handler waits long enough to catch immediate errors, returns the task id and then exits.

This handler uses the VMWare VI (vSphere) Java API (see http://vijava.sourceforge.net/ for more information). The api is deployed as a Java archive file (jar) and is stored in this handler's vendor directory. If the vijava jar file is stored somewhere else on the classpath, the jar file stored in this handler's vendor directory is not used. It is recommended that there are no vijava jar files stored anywhere on the classpath, and that all VMWare VSphere handlers contain the same vijava jar file in their vendor directory.

Parameters

Name Description
VM Name The name of the VM that you want to update.
Number of CPUs Number of CPUs to be allocated for the VM.

Sample Configuration

Name Description
VM Name Test Task VM
Number of CPUs 2

Results

Name Description
Task Id
task_id

Changelog

VMWarweVSphereVirtualMachineUpdateCPU_V1 (2014-06-17)

  • Initial version. See README for details.


Related Handlers

VMWare VSphere Virtual Machine Clone Advanced
Clones the given virtual machine.
VMWare VSphere Virtual Machine Get Ip Address
Gets an ip address from a Virtual Machine.
VMWare VSphere Virtual Machine PowerOn
Powers on the specified VMWare VSphere virtual machine.
VMWare VSphere Virtual Machine Reset
Resets the specified VMWare VSphere virtual machine. This simulates a hard power off followed by an automatic power on and does not attempt to safely shut down the guest operating system.
VMWare VSphere Virtual Machine Snapshot
Takes a snapshot of the target VMWare VSphere virtual machine matching.
VMWare VSphere Virtual Machine Suspend
Suspends the target VMWare VSphere virtual machine matching.
VMWare VSphere Virtual Machine Update Memory
Clones the given virtual machine.