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] [PRIVELEGES]
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.getniccfg
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] [PRIVELEGES] [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.getsysinfo