# salt.modules.drac

Manage Dell DRAC

salt.modules.drac.change_password(username, password, uid=None)

  Change users password

  CLI Example:

      salt dell drac.change_password [USERNAME] [PASSWORD] [UID - optional]
      salt dell drac.change_password diana secret

salt.modules.drac.create_user(username, password, permissions, users=None)

  Create user accounts

  CLI Example:

      salt dell drac.create_user [USERNAME] [PASSWORD] [PRIVILEGES]
      salt dell drac.create_user diana secret login,test_alerts,clear_logs

  DRAC Privileges

    - login : Login to iDRAC

    - drac : Configure iDRAC

    - user_management : Configure Users

    - clear_logs : Clear Logs

    - server_control_commands : Execute Server Control Commands

    - console_redirection : Access Console Redirection

    - virtual_media : Access Virtual Media

    - test_alerts : Test Alerts

    - debug_commands : Execute Debug Commands

salt.modules.drac.delete_user(username, uid=None)

  Delete a user

  CLI Example:

      salt dell drac.delete_user [USERNAME] [UID - optional]
      salt dell drac.delete_user diana 4

salt.modules.drac.email_alerts(action)

  Enable/Disable email alerts

  CLI Example:

      salt dell drac.email_alerts True
      salt dell drac.email_alerts False

salt.modules.drac.list_users()

  List all DRAC users

  CLI Example:

      salt dell drac.list_users

salt.modules.drac.nameservers(*ns)

  Configure the nameservers on the DRAC

  CLI Example:

      salt dell drac.nameservers [NAMESERVERS]
      salt dell drac.nameservers ns1.example.com ns2.example.com

salt.modules.drac.network_info()

  Return Network Configuration

  CLI Example:

      salt dell drac.network_info

salt.modules.drac.server_hardreset()

  Performs a reset (reboot) operation on the managed server.

  CLI Example:

      salt dell drac.server_hardreset

salt.modules.drac.server_poweroff()

  Powers down the managed server.

  CLI Example:

      salt dell drac.server_poweroff

salt.modules.drac.server_poweron()

  Powers up the managed server.

  CLI Example:

      salt dell drac.server_poweron

salt.modules.drac.server_pxe()

  Configure server to PXE perform a one off PXE boot

  CLI Example:

      salt dell drac.server_pxe

salt.modules.drac.server_reboot()

  Issues a power-cycle operation on the managed server. This action is similar to pressing the power button on the system's front panel to power down and then power up the system.

  CLI Example:

      salt dell drac.server_reboot

salt.modules.drac.set_network(ip, netmask, gateway)

  Configure Network

  CLI Example:

      salt dell drac.set_network [DRAC IP] [NETMASK] [GATEWAY]
      salt dell drac.set_network 192.168.0.2 255.255.255.0 192.168.0.1

salt.modules.drac.set_permissions(username, permissions, uid=None)

  Configure users permissions

  CLI Example:

      salt dell drac.set_permissions [USERNAME] [PRIVILEGES] [USER INDEX - optional]
      salt dell drac.set_permissions diana login,test_alerts,clear_logs 4

  DRAC Privileges

    - login : Login to iDRAC

    - drac : Configure iDRAC

    - user_management : Configure Users

    - clear_logs : Clear Logs

    - server_control_commands : Execute Server Control Commands

    - console_redirection : Access Console Redirection

    - virtual_media : Access Virtual Media

    - test_alerts : Test Alerts

    - debug_commands : Execute Debug Commands

salt.modules.drac.set_snmp(community)

  Configure SNMP community string

  CLI Example:

      salt dell drac.set_snmp [COMMUNITY]
      salt dell drac.set_snmp public

salt.modules.drac.syslog(server, enable=True)

  Configure syslog remote logging, by default syslog will automatically be enabled if a server is specified. However, if you want to disable syslog you will need to specify a server followed by False

  CLI Example:

      salt dell drac.syslog [SYSLOG IP] [ENABLE/DISABLE]
      salt dell drac.syslog 0.0.0.0 False

salt.modules.drac.system_info()

  Return System information

  CLI Example:

      salt dell drac.system_info