Users Guide
Table Of Contents
- Dell EMC OpenManage Ansible Modules Version 3.0.0 User’s Guide
- Overview
- Getting Started
- Modules for iDRAC
- How OpenManage Ansible Modules work with iDRAC
- Running your first iDRAC Playbook
- Updating Firmware
- Configuring PowerEdge Servers
- Deploying operating system
- Server Inventory
- Server administration tasks
- Storage controller
- Modules for OpenManage Enterprise (OME)
- Modules for Redfish APIs
- Deprecated modules
- Deprecated iDRAC modules
- Install firmware
- View Lifecycle Controller status
- Export or Import Server Configuration Profile
- Configure time zone and NTP on iDRAC
- Configure iDRAC network
- Configure BIOS
- Configure iDRAC users
- Configure RAID
- Configure syslog
- Boot to a network ISO image
- Reset iDRAC
- View Lifecycle controller job status
- Export LC logs
- Delete LC job
- Delete LC job queue
- Deprecated OpenManage Enterprise (OME) modules
- Deprecated iDRAC modules
- Accessing documents from the Dell EMC support site
● Operating system image is injected with required Dell drivers, and unattended response file.
● iDRAC is enabled, configured, and reachable.
● RAID is configured.
Boot to a network ISO image
Module: idrac_os_deployment
Synopsis
This module facilitates the operating system deployment. You can run this module to boot the target system to a bootable ISO
image on a CIFS or NFS share. This module looks for the customized ISO in the configured share location and transfers the
image to iDRAC to load it. On the system reboot, the operating system deployment begins.
Check_mode support: No
Options
Table 23. idrac_os_deployment
Parameter/aliases Required Default Choices Comments
idrac_ip Yes NA NA iDRAC IP Address
idrac_user Yes NA NA iDRAC username
idrac_password/
idrac_pwd
Yes NA NA iDRAC password
idrac_port No 443 NA iDRAC port
iso_image Yes NA NA Network ISO name
share_name Yes NA NA CIFS or NFS Network share
share_user No NA NA
User name required to access the
network share must be provided as either
'user@domain' or 'domain\user'. This option
is mandatory for CIFS network share.
share_password/
share_pwd
No NA NA
Network share user password. This option
is mandatory for CIFS Network shares.
expose_duration No 1080 NA
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
specified time expires, the ISO image gets
automatically detached.
Table 24. Return Values
Name Description Returned Type Output
Boot to Network ISO
Boots to a network ISO
Image
Success String
https://github.com/dell/dellemc-
openmanage-ansible-modules/
tree/devel/output/idrac/
idrac_os_deployment.md
Example
-name: Boot to Network ISO
idrac_os_deployment:
idrac_ip: "192.168.0.1"
idrac_user: "user_name"
idrac_password: "user_password"
share_name: "192.168.0.0:/nfsfileshare"
share_user: "share_user_name"
share_password: "share_user_pwd"
36
Modules for iDRAC