This is an automated email from the ASF dual-hosted git repository.
sureshanaparti pushed a commit to branch 4.22
in repository https://gitbox.apache.org/repos/asf/cloudstack-documentation.git
The following commit(s) were added to refs/heads/4.22 by this push:
new 7caec5f6 Make settings such as storage, disk_size, iso_os_type
configurable in the Proxmox extension (#601)
7caec5f6 is described below
commit 7caec5f69fb3fd7c67541d99176358c6b6f9ea10
Author: Abhisar Sinha <[email protected]>
AuthorDate: Mon May 18 17:38:35 2026 +0530
Make settings such as storage, disk_size, iso_os_type configurable in the
Proxmox extension (#601)
---
source/_static/images/proxmox-deploy-instance.png | Bin 131046 -> 179275 bytes
.../adminguide/extensions/inbuilt_extensions.rst | 19 +++++++++++++++----
2 files changed, 15 insertions(+), 4 deletions(-)
diff --git a/source/_static/images/proxmox-deploy-instance.png
b/source/_static/images/proxmox-deploy-instance.png
index 78a067bb..d91eed80 100644
Binary files a/source/_static/images/proxmox-deploy-instance.png and
b/source/_static/images/proxmox-deploy-instance.png differ
diff --git a/source/adminguide/extensions/inbuilt_extensions.rst
b/source/adminguide/extensions/inbuilt_extensions.rst
index d0641e29..c744701e 100644
--- a/source/adminguide/extensions/inbuilt_extensions.rst
+++ b/source/adminguide/extensions/inbuilt_extensions.rst
@@ -127,16 +127,27 @@ To set up the Proxmox Extension, follow these steps in
CloudStack:
* **iso_path**: Full path to the ISO in Proxmox (if `template_type` is
`iso`)
|proxmox-add-iso.png|
- Note: Templates and ISOs should be stored on shared storage when using
multiple Proxmox nodes. Or copy the template/iso to each host's local storage
at the same location.
+ **Note**: Templates and ISOs should be stored on shared storage when using
multiple Proxmox nodes. Or copy the template/iso to each host's local storage
at the same location.
#. **Deploy Instance**
- Deploy an Instance using the Template created above. Optionally, provide
the detail `vm_name` to specify the name of the VM in Proxmox.
- Otherwise, the CloudStack Instance's internal name is used. The VM Id in
Proxmox is mapped to the CloudStack Instance and stored as a detail in
CloudStack DB.
- The Instance will be provisioned on a randomly selected Proxmox host. The
VM will be configured with the MAC address and VLAN ID as defined in CloudStack.
+ Deploy an Instance using the Template/ISO created above.
+
+ The VM Id in Proxmox is mapped to the CloudStack Instance and stored as a
detail in CloudStack DB.
+ The Instance is provisioned on a randomly selected Proxmox host. The VM is
configured with the MAC address and VLAN ID as defined in CloudStack.
+
+ The following external details can be provided optionally, while deploying
the Instance:
+
+ * **vm_name**: Name of the VM in Proxmox. Default: *CloudStack Instance's
internal name*.
+ * **storage**: Name of the storage in Proxmox to use for the VM's disk.
Default: *local-lvm*.
+ * **is_full_clone**: Whether to create a full clone of the template (true)
or a linked clone (false). Default: *false*.
+ * **iso_os_type**: Specify guest operating system if deploying from ISO.
This is used to enable special optimization/features for specific operating
systems. Valid values are: other | wxp | w2k | w2k3 | w2k8 | wvista | win7 |
win8 | win10 | win11 | l24 | l26 | solarisOS. Default: *l26*
+ * **disk_size_gb**: Size of the disk in GB if deploying from ISO. Default:
*64*.
|proxmox-deploy-instance.png|
+ **Note**: Make sure that **is_full_clone** is set to **true** if the
**storage** specified is different from the template's storage when deploying
from template.
+
#. **Lifecycle Operations**
Operations **Start**, **Stop**, **Reboot**, and **Delete** can be performed
on the Instance from CloudStack.
