dellemc.openmanage.idrac_os_deployment role – Role to deploy operating system on the iDRAC servers
Note
This role is part of the dellemc.openmanage collection (version 9.8.0).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it use: ansible-galaxy collection install dellemc.openmanage
.
To use it in a playbook, specify: dellemc.openmanage.idrac_os_deployment
.
Entry point main
– Role to deploy operating system on the iDRAC servers
New in dellemc.openmanage 7.5.0
Synopsis
Role to generate the custom iso using the kickstart configuration file and deploy operating system on the idrac servers.
Parameters
Parameter |
Comments |
---|---|
The Privacy Enhanced Mail (PEM) file that contains a CA certificate to be used for the validation. |
|
Deletes the Custom iso after the OS deployment is finshed. ISO will be delete if delete_custom_iso is Choices:
|
|
Share path to mount the ISO to iDRAC. Share needs to have a write permission to copy the generated ISO. CIFS, NFS, HTTP and HTTPS shares are supported. destination is ignored when is_custom_iso is When the protocol is of When the protocol is of |
|
Target machine address/hostname where the custom iso will be copied. Address/hostname used to mount the iso as a virtual media. hostname is applicable to copy iso using ssh when protocol is hostname will be defaulted to localhost to copy iso when protocol is hostname will be used to mount the virtual media in idrac when protocol is |
|
Custom iso file name. If not specified defaulted to |
|
Custom iso absolute path to be used to mount as a virtual media in idrac. |
|
Target machine absolute path where the custom iso will be copied. mountpoint will be path where http/https is served from when protocol is mountpoint will be local folder mounted with nfs/cifs share when protocol is |
|
HTTP/HTTPS share based on linux/Windows. Choices:
|
|
Password of the http/https/cifs share where customized ISO is used to mount as a virtual media. |
|
Type of the the transfer protocol used to mount the virtual media on to idrac.
Choices:
|
|
Username of the http/https/cifs share where customized ISO is used to mount as a virtual media. |
|
Eject the virtual media (ISO) after the tracking of OS deployment is finished. ISO will be ejected if eject_iso is Choices:
|
|
iDRAC IP Address or hostname. |
|
iDRAC port. Default: |
|
The socket level timeout in seconds. Default: |
|
Time in minutes to wait for the OS deployment to finish. Default: |
|
The operating system name to match the jinja template of the kickstart file. Supported os name is versions for RHEL and ESXI. Jinja template file should exists in the format <os_name_upper>_<os_version_major>.j2 This is required when is_custom_iso is |
|
The operating system version to match the jinja template of the kickstart file. Supported versions for RHEL are 9.x and 8.x and for ESXi is 8.x. Jinja template file should exists in the format <os_name_upper>_<os_version_major>.j2 This is required when is_custom_iso is |
|
iDRAC user password. |
|
HTTP/HTTPS share or local path of the ISO. |
|
HTTP/HTTPS address to download the ISO. Hostname of the http/https/cifs and nfs to mount the custom iso to virtual media. hostname is applicable to download iso only when protocol is hostname is ignored to download the iso when protocol is hostname will be used to attach the virtual media when is_custom_iso is |
|
Specifies the source iso is a custom iso.
when
Choices:
|
|
Name of the iso file. |
|
Absolute local path or http/https share path of the iso. when custom_iso true iso_path should be http, https, nfs or cifs path. |
|
Absolute local path or http/https share path kickstart file. When ks_path is provided role skips the generation of kickstart file and uses the one provided in the input. |
|
Password of the http, https and cifs share. password is applicable only when protocol is password is applicable to mount the custom iso as a virtual media in idrac when protocol is password is ignored when protocol is |
|
Type of the the transfer protocol used to download the iso.
If custom_iso_true is Choices:
|
|
Username of the http, https and cifs share. username is applicable only when protocol is username is applicable to mount the custom iso as a virtual media in idrac when protocol is username is ignored when protocol is |
|
iDRAC username with admin privilages. |
|
If Configure Choices:
|
|
Wait for the OS deployment to finish. Choices:
|