dellemc.openmanage.idrac_os_deployment – Boot to a network ISO image
Note
This plugin is part of the dellemc.openmanage collection (version 3.6.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
.
New in version 2.1.0: of dellemc.openmanage
Requirements
The below requirements are needed on the host that executes this module.
omsdk
python >= 2.7.5
Parameters
Parameter |
Comments |
---|---|
It is the time taken in minutes for the ISO image file to be exposed as a local CD-ROM device to the host server. When the time expires, the ISO image gets automatically detached. Default: 1080 |
|
iDRAC IP Address. |
|
iDRAC user password. |
|
iDRAC port. Default: 443 |
|
iDRAC username. |
|
Network ISO name. |
|
CIFS or NFS Network share. |
|
Network share user password. This option is mandatory for CIFS Network Share. |
|
Network share user in the format ‘user@domain’ or ‘domain\user’ if user is part of a domain else ‘user’. This option is mandatory for CIFS Network Share. |
Notes
Note
Run this module from a system that has direct access to DellEMC iDRAC.
This module does not support
check_mode
.
Examples
---
- name: Boot to Network ISO
dellemc.openmanage.idrac_os_deployment:
idrac_ip: "192.168.0.1"
idrac_user: "user_name"
idrac_password: "user_password"
share_name: "192.168.0.0:/nfsfileshare"
iso_image: "unattended_os_image.iso"
expose_duration: 180
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
Details of the boot to network ISO image operation. Returned: always Sample: {“DeleteOnCompletion”: “false”, “InstanceID”: “DCIM_OSDConcreteJob:1”, “JobName”: “BootToNetworkISO”, “JobStatus”: “Success”, “Message”: “The command was successful.”, “MessageID”: “OSD1”, “Name”: “BootToNetworkISO”, “Status”: “Success”, “file”: “192.168.0.0:/nfsfileshare/unattended_os_image.iso”, “retval”: true} |
|
Over all device information status. Returned: on error Sample: “Failed to boot to network iso” |
Authors
Felix Stephen (@felixs88)
Jagadeesh N V (@jagadeeshnv)