dellemc.openmanage.idrac_server_config_profile – Export or Import iDRAC Server Configuration Profile (SCP)

Note

This plugin is part of the dellemc.openmanage collection (version 3.2.0).

To install it use: ansible-galaxy collection install dellemc.openmanage.

To use it in a playbook, specify: dellemc.openmanage.idrac_server_config_profile.

New in version 2.1.0: of dellemc.openmanage

Synopsis

• Export the Server Configuration Profile (SCP) from the iDRAC or Import from a network share or a local file.

Requirements

The below requirements are needed on the host that executes this module.

• omsdk

• python >= 2.7.5

Parameters

Parameter	Choices/Defaults	Comments
command string	Choices: import export ←	If import, will perform SCP import operations. If export, will perform SCP export operations.
end_host_power_state string	Choices: On ← Off	This option is applicable for import command. If On, End host power state is on. If Off, End host power state is off.
export_format string	Choices: JSON XML ←	Specify the output file format. This option is applicable for export command.
export_use string	Choices: Default ← Clone Replace	Specify the type of server configuration profile (SCP) to be exported. This option is applicable for export command.
idrac_ip string / required		iDRAC IP Address.
idrac_password string / required		iDRAC user password. aliases: idrac_pwd
idrac_port integer	Default: 443	iDRAC port.
idrac_user string / required		iDRAC username.
job_wait boolean / required	Choices: no yes	Whether to wait for job completion or not.
scp_components string	Choices: ALL ← IDRAC BIOS NIC RAID	If ALL, this module will import all components configurations from SCP file. If IDRAC, this module will import iDRAC configuration from SCP file. If BIOS, this module will import BIOS configuration from SCP file. If NIC, this module will import NIC configuration from SCP file. If RAID, this module will import RAID configuration from SCP file.
scp_file string		Name of the server configuration profile (SCP) file. This option is mandatory if command is import. The default format <idrac_ip>_YYmmdd_HHMMSS_scp is used if this option is not specified for import. export_format is used if the valid extension file is not provided for import.
share_name string / required		CIFS or NFS Network Share or a local path.
share_password string		Network share user password. This option is mandatory for CIFS Network Share. aliases: share_pwd
share_user string		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.
shutdown_type string	Choices: Graceful ← Forced NoReboot	This option is applicable for import command. If Graceful, it gracefully shuts down the server. If Forced, it forcefully shuts down the server. If NoReboot, it does not reboot the server.

Notes

Note

• Run this module from a system that has direct access to DellEMC iDRAC.

• This module does not support check_mode.

Examples

---
- name: Import SCP from a network share and wait for this job to get completed
  dellemc.openmanage.idrac_server_config_profile:
    idrac_ip: "192.168.0.1"
    idrac_user: "user_name"
    idrac_password: "user_password"
    command: "import"
    share_name: "192.168.0.2:/share"
    share_user: "share_user_name"
    share_password: "share_user_password"
    scp_file: "scp_filename.xml"
    scp_components: "ALL"
    job_wait: True

- name: Import SCP from a local path and wait for this job to get completed
  dellemc.openmanage.idrac_server_config_profile:
    idrac_ip: "192.168.0.1"
    idrac_user: "user_name"
    idrac_password: "user_password"
    command: "import"
    share_name: "/scp_folder"
    scp_file: "scp_filename.xml"
    scp_components: "ALL"
    job_wait: True

- name: Export SCP to a network share
  dellemc.openmanage.idrac_server_config_profile:
    idrac_ip: "192.168.0.1"
    idrac_user: "user_name"
    idrac_password: "user_password"
    share_name: "192.168.0.2:/share"
    share_user: "share_user_name"
    share_password: "share_user_password"
    job_wait: False

- name: Export SCP to a local path
  dellemc.openmanage.idrac_server_config_profile:
    idrac_ip: "192.168.0.1"
    idrac_user: "user_name"
    idrac_password: "user_password"
    share_name: "/scp_folder"
    job_wait: False

- name: Export SCP to a local path with a specified name for the file
  dellemc.openmanage.idrac_server_config_profile:
    idrac_ip: "192.168.0.1"
    idrac_user: "user_name"
    idrac_password: "user_password"
    share_name: "/scp_folder"
    # extension for filename is considered if provided
    scp_file: "exported_scp_filename"
    export_format: "JSON"
    job_wait: False

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key	Returned	Description
msg string	always	Status of the import or export SCP job. Sample: Successfully imported the Server Configuration Profile
scp_status dictionary	success	SCP operation job and progress details from the iDRAC. Sample: {'Id': 'JID_XXXXXXXXX', 'JobState': 'Completed', 'JobType': 'ImportConfiguration', 'Message': 'Successfully imported and applied Server Configuration Profile.', 'MessageArgs': [], 'MessageId': 'XXX123', 'Name': 'Import Configuration', 'PercentComplete': 100, 'StartTime': 'TIME_NOW', 'Status': 'Success', 'TargetSettingsURI': None, 'retval': True}

Authors

• Jagadeesh N V(@jagadeeshnv)