docs/docsite/rst/scenario_guides/vmware_rest_scenarios/vm_hardware_tuning.rst


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150

.. _vmware_rest_vm_hardware_tuning:

*******************************
How to modify a virtual machine
*******************************

.. contents::
  :local:


Introduction
============

This section shows you how to use Ansible to modify an existing virtual machine.

Scenario requirements
=====================

You've already followed :ref:`vmware_rest_create_vm` and created a VM.

How to add a CDROM drive to a virtual machine
=============================================

In this example, we use the ``vcenter_vm_hardware_*`` modules to add a new CDROM to an existing VM.

Add a new SATA adapter
______________________

First we create a new SATA adapter. We specify the ``pci_slot_number``. This way if we run the task again it won't do anything if there is already an adapter there.

.. literalinclude:: task_outputs/Create_a_SATA_adapter_at_PCI_slot_34.task.yaml

Result
______

.. literalinclude:: task_outputs/Create_a_SATA_adapter_at_PCI_slot_34.result.json

Add a CDROM drive
_________________

Now we can create the CDROM drive:

.. literalinclude:: task_outputs/Attach_an_ISO_image_to_a_guest_VM.task.yaml

Result
______

.. literalinclude:: task_outputs/Attach_an_ISO_image_to_a_guest_VM.result.json


.. _vmware_rest_attach_a_network:

How to attach a VM to a network
===============================

Attach a new NIC
________________

Here we attach the VM to the network (through the portgroup). We specify a ``pci_slot_number`` for the same reason.

The second task adjusts the NIC configuration.

.. literalinclude:: task_outputs/Attach_a_VM_to_a_dvswitch.task.yaml

Result
______

.. literalinclude:: task_outputs/Attach_a_VM_to_a_dvswitch.result.json

Adjust the configuration of the NIC
___________________________________

.. literalinclude:: task_outputs/Turn_the_NIC's_start_connected_flag_on.task.yaml

Result
______

.. literalinclude:: task_outputs/Turn_the_NIC's_start_connected_flag_on.result.json

Increase the memory of the VM
=============================

We can also adjust the amount of memory that we dedicate to our VM.

.. literalinclude:: task_outputs/Increase_the_memory_of_a_VM.task.yaml

Result
______

.. literalinclude:: task_outputs/Increase_the_memory_of_a_VM.result.json

Upgrade the hardware version of the VM
======================================

Here we use the ``vcenter_vm_hardware`` module to upgrade the version of the hardware: 

.. literalinclude:: task_outputs/Upgrade_the_VM_hardware_version.task.yaml

Result
______

.. literalinclude:: task_outputs/Upgrade_the_VM_hardware_version.result.json

Adjust the number of CPUs of the VM
===================================

You can use ``vcenter_vm_hardware_cpu`` for that:

.. literalinclude:: task_outputs/Dedicate_one_core_to_the_VM.task.yaml

Result
______

.. literalinclude:: task_outputs/Dedicate_one_core_to_the_VM.result.json

Remove a SATA controller
========================

In this example, we remove the SATA controller of the PCI slot 34.

.. literalinclude:: task_outputs/Remove_SATA_adapter_at_PCI_slot_34.result.json

Result
______

.. literalinclude:: task_outputs/Remove_SATA_adapter_at_PCI_slot_34.result.json

Attach a floppy drive
=====================

Here we attach a floppy drive to a VM.

.. literalinclude:: task_outputs/Add_a_floppy_disk_drive.task.yaml

Result
______

.. literalinclude:: task_outputs/Add_a_floppy_disk_drive.result.json

Attach a new disk
=================

Here we attach a tiny disk to the VM. The ``capacity`` is in bytes.

.. literalinclude:: task_outputs/Create_a_new_disk.task.yaml

Result
______

.. literalinclude:: task_outputs/Create_a_new_disk.result.json