dellemc.openmanage.idrac_network (2.1.5) — module

Configures the iDRAC network attributes.

| "added in version" 2.9.11 of dellemc.openmanage"

Authors: Felix Stephen (@felixs88), Anooja Vardhineni (@anooja-vardhineni)

preview | supported by community

Install collection

Install with ansible-galaxy collection install dellemc.openmanage:==2.1.5


Add to requirements.yml

  collections:
    - name: dellemc.openmanage
      version: 2.1.5

Description

This module allows to configure iDRAC network settings.


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
---
- name: Configure iDRAC network settings.
  dellemc.openmanage.idrac_network:
       idrac_ip:   "192.168.0.1"
       idrac_user: "user_name"
       idrac_password:  "user_password"
       share_name: "192.168.0.1:/share"
       share_password:  "share_pwd"
       share_user: "share_user"
       share_mnt: "/mnt/share"
       register_idrac_on_dns: Enabled
       dns_idrac_name: None
       auto_config: None
       static_dns: None
       setup_idrac_nic_vlan: Enabled
       vlan_id: 0
       vlan_priority: 1
       enable_nic: Enabled
       nic_selection: Dedicated
       failover_network: T_None
       auto_detect: Disabled
       auto_negotiation: Enabled
       network_speed: T_1000
       duplex_mode: Full
       nic_mtu: 1500
       ip_address: "192.168.0.1"
       enable_dhcp: Enabled
       enable_ipv4: Enabled
       static_dns_1: "192.168.0.1"
       static_dns_2: "192.168.0.1"
       dns_from_dhcp: Enabled
       static_gateway: None
       static_net_mask: None

Inputs

    
nic_mtu:
    description: Maximum Transmission Unit of the NIC.
    required: false
    type: int

vlan_id:
    description: Enter the VLAN ID.  The VLAN ID must be a number from 1 through 4094.
    required: false
    type: int

idrac_ip:
    description: iDRAC IP Address.
    required: true
    type: str

share_mnt:
    description: Local mount path of the network share with read-write permission for
      ansible user. This option is mandatory for network shares.
    required: false
    type: str

enable_nic:
    choices:
    - Enabled
    - Disabled
    description: Allows to enable or disable the Network Interface Controller (NIC) used
      by iDRAC.
    required: false
    type: str

idrac_port:
    default: 443
    description: iDRAC port.
    required: false
    type: int

idrac_user:
    description: iDRAC username.
    required: true
    type: str

ip_address:
    description: Enter a valid iDRAC static IPv4 address.
    required: false
    type: str

share_name:
    description: Network share or a local path.
    required: true
    type: str

share_user:
    description: Network share user name. Use the format 'user@domain' or 'domain\\user'
      if user is part of a domain. This option is mandatory for CIFS share.
    required: false
    type: str

static_dns:
    description: Enter the static DNS domain name.
    required: false
    type: str

auto_config:
    choices:
    - Enabled
    - Disabled
    description: Allows to enable or disable auto-provisioning to automatically acquire
      domain name from DHCP.
    required: false
    type: str

auto_detect:
    choices:
    - Enabled
    - Disabled
    description: Allows to auto detect the available NIC types used by iDRAC.
    required: false
    type: str

duplex_mode:
    choices:
    - Full
    - Half
    description: Select the type of data transmission for the NIC.
    required: false
    type: str

enable_dhcp:
    choices:
    - Enabled
    - Disabled
    description: Allows to enable or disable Dynamic Host Configuration Protocol (DHCP)
      in iDRAC.
    required: false
    type: str

enable_ipv4:
    choices:
    - Enabled
    - Disabled
    description: Allows to enable or disable IPv4 configuration.
    required: false
    type: str

static_dns_1:
    description: Enter the preferred static DNS server IPv4 address.
    required: false
    type: str

static_dns_2:
    description: Enter the preferred static DNS server IPv4 address.
    required: false
    type: str

dns_from_dhcp:
    choices:
    - Enabled
    - Disabled
    description: Allows to enable DHCP to obtain DNS server address.
    required: false
    type: str

network_speed:
    choices:
    - T_10
    - T_100
    - T_1000
    description: Select the network speed for the selected NIC.
    required: false
    type: str

nic_selection:
    choices:
    - Dedicated
    - LOM1
    - LOM2
    - LOM3
    - LOM4
    description: Select one of the available NICs.
    required: false
    type: str

vlan_priority:
    description: Enter the priority for the VLAN ID. The priority value must be a number
      from 0 through 7.
    required: false
    type: int

dns_idrac_name:
    description: Name of the DNS to register iDRAC.
    required: false
    type: str

idrac_password:
    aliases:
    - idrac_pwd
    description: iDRAC user password.
    required: true
    type: str

share_password:
    aliases:
    - share_pwd
    description: Network share user password. This option is mandatory for CIFS share.
    required: false
    type: str

static_gateway:
    description: Enter the static IPv4 gateway address to iDRAC.
    required: false
    type: str

static_net_mask:
    description: Enter the static IP subnet mask to iDRAC.
    required: false
    type: str

auto_negotiation:
    choices:
    - Enabled
    - Disabled
    description: Allows iDRAC to automatically set the duplex mode and network speed.
    required: false
    type: str

failover_network:
    choices:
    - ALL
    - LOM1
    - LOM2
    - LOM3
    - LOM4
    - T_None
    description: Select one of the remaining LOMs. If a network fails, the traffic is
      routed through the failover network.
    required: false
    type: str

setup_idrac_nic_vlan:
    choices:
    - Enabled
    - Disabled
    description: Allows to configure VLAN on iDRAC.
    required: false
    type: str

register_idrac_on_dns:
    choices:
    - Enabled
    - Disabled
    description: Registers iDRAC on a Domain Name System (DNS).
    required: false
    type: str