OpenNebula · josepselga · May 27, 2025
diff --git a/source/intro_release_notes/release_notes/whats_new.rst b/source/intro_release_notes/release_notes/whats_new.rst
@@ -43,7 +43,7 @@ Ecosystem
 KVM
 ================================================================================
 
-- Feature 1
+- Add support for the ``SERIAL`` disk attribute. This allows specifying a ``SERIAL`` value in :ref:`Image <img_template>` and :ref:`VM Templates <template>`, including support for automatic generation (SERIAL="auto").
 - Feature 2
 
 

diff --git a/source/management_and_operations/references/img_template.rst b/source/management_and_operations/references/img_template.rst
@@ -59,7 +59,8 @@ The following attributes can be defined in the template:
 +--------------------------+--------------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | ``VCENTER_IMPORTED\*``   | \-                       | Optional                 | ``YES``                                                                                                                                                                | vCenter: This attribute is set to ``YES`` automatically when an IMAGE has been imported e.g an imported template. If set to YES, OpenNebula won't remove from vCenter this image when the image is deleted from OpenNebula.                                                                                                                                                      |
 +--------------------------+--------------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-
+| ``SERIAL``               | Optional                 | \-                       | ``auto``, any string.                                                                                                                                                  | If present, a serial number will be added to virtual hard drive. If set to "auto", the serial number will be generated automatically. (<vm_id>-<disk_id>) If set to a specific value, that value will be used as the serial number.                                                                                                                                                      |
++--------------------------+--------------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 
 .. warning:: Be careful when ``PATH`` points to a compressed bz2 image, since although it will work, OpenNebula will not calculate its size correctly.
 

diff --git a/source/management_and_operations/references/template.rst b/source/management_and_operations/references/template.rst
@@ -380,6 +380,10 @@ Persistent and Clone Disks
 | ``OPENNEBULA_MANAGED``          | If set to yes, in vCenter this DISK represents a virtual disk that was                                                                    | \-                                | O (can be inherited from Datastore) | \-                                 |
 |                                 | imported when a template was imported.                                                                                                    |                                   |                                     |                                    |
 +---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+-------------------------------------+------------------------------------+
+| ``SERIAL``                      | If present, a serial number will be added to virtual hard drive.                                                                          | O                                 | \-                                  | \-                                 |
+|                                 | If set to "auto", the serial number will be generated automatically. (<vm_id>-<disk_id>)                                                  |                                   |                                     |                                    |
+|                                 | If set to a specific value, that value will be used as the serial number.                                                                 |                                   |                                     |                                    |
++---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+-------------------------------------+------------------------------------+
 
 .. _template_volatile_disks_section:
 
@@ -434,6 +438,10 @@ Volatile DISKS
 +--------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------+-----------+
 | ``VCENTER_DISK_TYPE``    | Possible values (careful with the case): thin, thick, .... More information `in the VMware documentation <https://code.vmware.com/doc/preview?id=4206/doc/vim.VirtualDiskManager.VirtualDiskType.html>`__.                                      | \-                            | O         |
 +--------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------+-----------+
+| ``SERIAL``               | If present, a serial number will be added to virtual hard drive.                                                                                                                                                                                | O                             | \-        |
+|                          | If set to "auto", the serial number will be generated automatically. (<vm_id>-<disk_id>)                                                                                                                                                        |                               |           |
+|                          | If set to a specific value, that value will be used as the serial number.                                                                                                                                                                       |                               |           |
++--------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------+-----------+
 
 .. _template_disks_device_mapping:
-Original file line number
+Diff line change
@@ Expand Up / @@ -59,7 +59,8 @@ The following attributes can be defined in the template: @@
     +--------------------------+--------------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
     | ``VCENTER_IMPORTED\*``   | \-                       | Optional                 | ``YES``                                                                                                                                                                | vCenter: This attribute is set to ``YES`` automatically when an IMAGE has been imported e.g an imported template. If set to YES, OpenNebula won't remove from vCenter this image when the image is deleted from OpenNebula.                                                                                                                                                      |
     +--------------------------+--------------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+    | ``SERIAL``               | Optional                 | \-                       | ``auto``, any string.                                                                                                                                                  | If present, a serial number will be added to virtual hard drive. If set to "auto", the serial number will be generated automatically. (<vm_id>-<disk_id>) If set to a specific value, that value will be used as the serial number.                                                                                                                                                      |
+    +--------------------------+--------------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
     .. warning:: Be careful when ``PATH`` points to a compressed bz2 image, since although it will work, OpenNebula will not calculate its size correctly.
@@ Expand Down @@