Users Guide
Table Of Contents
- Dell EMC OpenManage Ansible Modules Version 4.0.0 User’s Guide
- Contents
- 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)
- How OpenManage Ansible Modules work with OME
- Running your first OME Playbook
- Manage Devices
- Manage device configuration templates
- Template Service
- Manage the device firmware
- Manage jobs
- Manage users
- Manage identity pool
- Manage application settings
- Manage network configuration
- Manage fabrics
- Manage Profiles
- Device discovery
- Manage Chassis
- Manage Active Directory service and user groups
- Diagnostics
- Modules for Redfish APIs
- Deprecated modules
Deploying operating system
To provision a bare metal server, it is essential to deploy the required operating system in the device before you start using it.
This section describes the process of deploying the operating system on the PowerEdge servers using Ansible.
To automate the process of operating system deployment in an unattended manner using Ansible, the iDRAC's capability is
utilized to transfer the customized ISO to iDRAC for boot.
To perform OS deployment, ensure:
● 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 15. 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.
Return Values
msg:
type: str
description: Over all device information status.
returned: on error
sample: "Failed to boot to network iso"
boot_status:
description: Details of the boot to network ISO image operation.
returned: always
type: dict
42
Modules for iDRAC