RACADM Command Line Interface for DRAC
SYSTEMS MANAGEMENT – WIKI
Overview
The Dell RACADM (Remote Access Controller Admin) utility is a command line tool that allows for remote or local management of Dell Servers via the iDRAC or DRAC. RACADM provides similar functionality to the iDRAC/DRAC Graphical User Interface (GUI). The Dell Chassis Management Controller (CMC) can also be managed remotely with RACADM.
RACADM commands can be run remotely from a management station and/or locally on the managed system.
RACADM commands allow you to view managed system information, perform power operations on the managed system, perform firmware updates, configure settings and more. Because RACADM is run from a command line interface (CLI), system administrators can create scripts that control and update Dell systems in a one-to-many fashion. See the links to the RACADM documentation at the end of this article for a complete listing of features for your product version.
Terminology
Managed System – The Dell PowerEdge Server containing the iDRAC or DRAC, or the Dell Blade Chassis containing the Chassis Management Controller (CMC).
Management Station – A computer used for accessing the iDRAC, DRAC, or CMC remotely.
iDRAC – Integrated Dell Remote Access Controller. Available on newer and current generations of Dell PowerEdge Servers (11G and 12G).
DRAC – Dell Remote Access Controller. Available on older generations of Dell PowerEdge Servers.
The Different RACADM Utilities
The following RACADM utilities are available:
- Remote RACADM – utility is installed on a management station.
- Local RACADM – utility is installed on the managed system.
- SSH/Telnet/Serial RACADM (also known as Firmware RACADM) – utility is built into the iDRAC, DRAC, and CMC firmware.
NOTES: Local RACADM is not required if you will be managing your server from a management station via Remote RACADM. Remote RACADM and Local RACADM cannot be installed at the same time on the same system.
Locating and Installing RACADM Utilities
Remote RACADM
Remote RACADM supports executing RACADM commands from a remote management station such as a laptop or desktop computer. It is available on the Dell OpenManage Systems Management Tools and Documentation DVD or at support.dell.com.
To download Remote RACADM:
- Go to http://support.dell.com
- If prompted, select Start Here under Small Businesses or Enterprise IT.
- Enter the Service Tag of the managed system and Submit, or use one of the Choose options to locate your managed system model.
- Select Drivers and Downloads > select the Operating System of your Management Station from the drop-down menu. Note: The drop-down menu only contains supported server operating systems. If you are running a supported Windows management station OS (Windows 7 for example), choose a Windows Server version from the drop-down menu instead.
- Expand Systems Management
- For Windows Operating Systems, locate the DRAC Tools application.
- For Linux operating systems, locate the Linux Remote Access Utilities application.
- Click Download File.
Remote RACADM Download – Windows Operating System
Remote RACADM Download – Linux Operating System
Remote RACADM Installation – Windows Management Station
If downloaded, extract the downloaded file and run the .msi file provided. Depending on the version downloaded, the file will be named DRAC.msi, RACTools.msi, or RACTools64Bit.msi.
-OR-
If using the DVD, run <path>\SYSMGMT\ManagementStation\windows\DRAC\<.msi file name>
Accept the license agreement > Next > Select the folder to install to > Next > Install > Finish.
Open an administrative command prompt, type racadm and press Enter. If you get the RACADM help instructions it is installed correctly.
Remote RACADM Installation – Linux Management Station
If downloaded, extract the downloaded file and cd to the directory containing the rpm files:
<path>/linux/rac/<linux distribution name>/<i386 or x86_64>
-OR-
If using the DVD, cd to the directory containing the rpm files:
<path>/SYSMGMT/ManagementStation/linux/rac/<linux_distribution_name>/<i386 or x86_64>
From the i386 or x86_64 directory, run:
rpm -ivh *.rpm
Open a shell prompt with root privileges, type racadm and press Enter. If you get the RACADM help instructions it is installed correctly.
NOTE: The racadm executable is located under /opt/dell/srvadmin/sbin. You may need to log out and log back in to reset the PATH environment variable to include this location.
Local RACADM
Local RACADM supports executing RACADM commands from the managed system’s operating system. It is available on the Dell OpenManage Systems Management Tools and Documentation DVD or atsupport.dell.com.
To download Local RACADM:
- Go to http://support.dell.com
- If prompted, select Start Here under Small Businesses or Enterprise IT.
- Enter the Service Tag of the managed system and Submit, or use one of the Choose options to locate your managed system model.
- Select Drivers and Downloads > select the Operating System of your Managed System > expand Systems Management.
- Locate the OpenManage Server Administrator Managed Node application and click Download File.
Local RACADM Download
Local RACADM Installation – Windows Managed System
If downloaded, extract the downloaded file and run <path>\windows\setup.exe
-OR-
If using the DVD, run <path>\SYSMGMT\srvadmin\windows\setup.exe
After the prerequisite checker runs, click Server Administrator.
Click Next > Accept the license agreement > Next > select Custom > Next.
At a minimum, make sure Remote Access Controller will be installed > Next > Install > Finish.
Open an administrative command prompt, type racadm and press Enter. If you get the RACADM help instructions it is installed correctly.
Local RACADM Installation – Linux Managed System
If downloaded, extract the downloaded file and run:
<path>/linux/supportscripts/srvadmin-install.sh
-OR-
If using the DVD, run:
<path>/SYSMGMT/srvadmin/linux/supportscripts/srvadmin-install.sh
Accept the license agreement and, at a minimum, select option 5 – Remote Access Core Component from the menu.
Open a shell prompt with root privileges, type racadm and press Enter. If you get the RACADM help instructions it is installed correctly.
NOTE: The racadm executable is located under /opt/dell/srvadmin/sbin. You may need to log out/log back in to reset the PATH environment variable to include this location.
SSH/Telnet/Serial RACADM (Firmware RACADM)
SSH/Telnet/Serial RACADM (Firmware RACADM) is built into the iDRAC, DRAC or CMC firmware and there is no separate download or installation required. See your user’s guide for connecting via these methods.
Once connected via SSH, Telnet or Serial, type racadm help for the online help instructions.
NOTE: On some interfaces if you type racadm and press Enter, you will be taken to a racadm>> prompt. Commands can then be entered from this prompt without the “racadm” prefix. To exit the prompt, type quit or use Ctrl+C.
Syntax Usage
The following shows an example of a simple RACADM subcommand, getsysinfo, used with each RACADM utility. See the end of this article for links to documentation containing the full list of RACADM commands.
Remote RACADM
Remote RACADM commands must include the ip address or hostname of the idrac, and the idrac username and password.
racadm -r <ip address or hostname> -u <username> -p <password> <subcommand>
racadm -r 10.1.1.1 -u root -p calvin getsysinfo
NOTE: Remote racadm uses the web server SSL certificate of the iDRAC to authenticate the session. You will receive a warning message if certificates have not been configured or if the certificate is invalid. However, the command will execute normally following the message. If you wish to halt the command on certificate errors, use the -S option in the command. For information on configuring certificates on the iDRAC, see the user’s guide for your iDRAC linked at the end of this article.
Local RACADM
You do not have to specify the ip address, username, or password in Local RACADM commands.
racadm <subcommand>
racadm getsysinfo
SSH/Telnet/Serial (Firmware) RACADM
You do not have to specify the ip address, username, or password in Firmware RACADM commands.
racadm <subcommand>
racadm getsysinfo
or
racadm <Enter> – takes you to a racadm>> prompt
racadm>>getsysinfo
RACADM Documentation
See the RACADM Command Line Reference Guide at the link below for detailed information on supported RACADM commands and features. This guide is available for iDRAC7, iDRAC6, and the CMC. For DRAC5, this information is combined with the DRAC5 User’s Guide.
See the Readme or Release Notes file posted alongside the guide for a complete listing of supported operating systems.
To locate a particular document, go to http://www.dell.com/esmmanuals , select Remote Access Controller (or Chassis Management Controller for CMC), then select your product version.
racadm getniccfg
racadm getsysinfo
racadm setniccfg -s 147.27.15.52 255.255.255.192 147.27.15.62
racadm setniccfg -o
racadm setniccfg -d6
racadm getniccfg
racadm config -g cfgLanNetworking -o cfgDNSServer1 147.27.15.11
racadm config -g cfgLanNetworking -o cfgDNSRacName whv-1-mgmt
racadm config -g cfgLanNetworking -o cfgDNSDomainName isc.tuc.gr
racadm config -g cfglannetworking -o cfgnicselection 0
racadm getconfig -g cfgLanNetworking
racadm set idrac.users.2.password
Adding an iDRAC User
To add a new user to the iDRAC, perform the following steps:
Example
The following example describes how to add a new user named “John” with a “123456” password and login privileges to the iDRAC:
racadm config -g cfgUserAdmin -o cfgUserAdminUserName -i 2 john
racadm config -g cfgUserAdmin -o cfgUserAdminPassword -i 2 123456
racadm config -g cfgUserAdmin -o cfgUserPrivilege -i 2 0x00000001
racadm config -g cfgUserAdmin -o cfgUserAdminEnable -i 2 1
To verify the new user, use one of the following commands:
racadm getconfig -u john
racadm getconfig –g cfgUserAdmin –i 2
racadm quick dirty cheatsheet
iDRAC racadm quick and dirty cheatsheet. racadm command can be issues via iDRAC/CMC/OS if svradmin-racadm is installed. Also you can specify -h option to access remote servers RAC as long as you have network access. Also if you are having problems with racadm “Failed to initialize transport” install openssl-devel. full documentation for iDRAC7 can be found here.
% Get all iDRAC settings in a file
racadm get -f config.txt
If you like you can change the contents of config.txt and apply it back to iDRAC
racadm set -f config.txt
% Set password for root user
racadm set iDRAC.Users.2.Password PASSWORD"
% List all ssh keys for root user
racadm sshpkauth -i 2 -v -k all
% Add ssh key to root user
racadm sshpkauth -i 2 -k 1 "CONTENTS OF PUBLIC KEY"
% Delete ssh key for root user
racadm sshpkauth -i 2 -d -k 1
% Get iDRAC IP config
racadm getniccfg
racadm get iDRAC.NIC
% set iDRAC IP
Using config command:
racadm config -g cfgLanNetworking -o cfgNicEnable 1
racadm config -g cfgLanNetworking -o cfgNicIpAddress x.x.x.x
racadm config -g cfgLanNetworking -o cfgNicNetmask 255.255.255.0
racadm config -g cfgLanNetworking -o cfgNicGateway x.x.x.x
racadm config -g cfgLanNetworking -o cfgNicUseDHCP 0
racadm config -g cfgLanNetworking -o cfgDNSServersFromDHCP 0
racadm config -g cfgLanNetworking -o cfgDNSServer1 y.y.y.y
racadm config -g cfgLanNetworking -o cfgDNSServer2 y.y.y.y
• Using set command:
racadm set iDRAC.Nic.Enable 1
racadm set iDRAC.IPv4.Address x.x.x.x
racadm set iDRAC.IPv4.Netmask 255.255.255.0
racadm set iDRAC.IPv4.Gateway x.x.x.x
racadm set iDRAC.IPv4.DHCPEnable 0
racadm set iDRAC.IPv4.DNSFromDHCP 0
racadm set iDRAC.IPv4.DNS1 y.y.y.y
racadm set iDRAC.IPv4.DNS2 y.y.y.y
% Set iDRAC DNS Name
racadm set iDRAC.NIC.DNSRacName iDRACNAME
% Set iDRAC domain name
racadm set iDRAC.NIC.DNSDomainName DOMAIN.NAME
% Set iDRAC DNS Server
racadm config -g cfgLanNetworking -o cfgDNSServer1 x.x.x.x
racadm config -g cfgLanNetworking -o cfgDNSServer2 y.y.y.y
% Set Front LCD to hostname
racadm set System.LCD.Configuration 16
% Reset iDRAC to factory defaults
racadm racresetcfg
% Reset/Reboot iDRAC
racadm racreset OPTIONS
Options : soft, hard, cold
or
racadm serveraction powercycle
% Get Serial number (service tag)
racadm getsvctag
% Get current system information
racadm getsysinfo
% Configure one-time-boot to PXE
racadm set BIOS.OneTimeBoot.OneTimeBootMode OneTimeBootSeq
racadm set BIOS.OneTimeBoot.OneTimeBootSeqDev NIC.Integrated.1-1-1
% Configure persistent Boot Device
racadm config -g cfgServerInfo -o cfgServerBootOnce 0
racadm config -g cfgServerInfo -i cfgServerFirstBootDevice HDD
% Check boot order list
racadm get BIOS.BiosBootSettings.bootseq
% Disable HyperThreading
racadm set BIOS.ProcSettings.LogicalProc Disabled
% Disable OS to iDRAC pass-thru for iDRAC service module (automatically create a pseudo NIC in OS)
racadm set iDRAC.OS-BMC.AdminState Disabled
% Change SNMP public community string
racadm set iDRAC.SNMP.AgentCommunity NEW STRING
% Disable ASR
racadm config -g cfgRacTuning -o cfgRacTuneAsrEnable 0
% Configure Serial redirection
racadm config -g cfgSerial -o cfgSerialConsoleEnable 1
racadm config -g cfgSerial -o cfgSerialBaudRate 115200
racadm config -g cfgSerial -o cfgSerialCom2RedirEnable 1
racadm config -g cfgSerial -o cfgSerialTelnetEnable 0
racadm config -g cfgSerial -o cfgSerialSshEnable 1
to access console via ssh console com2
% Disable Serial On Lan
racadm config -g cfgImpiSol -o cfgIpmiSolEnable 0
% Change Power Profile
racadm set BIOS.SysProfileSettings PerfPerWattOptimizedOs
% Set AC Power Recovery
racadm set BIOS.SysSecurity.AcPwdRcvry Last
racadm set BIOS.SysSecurity.AcPwdRcvryDelay Immediate
% Get RAID physical Disk information
racadm raid get pdisks
racadm raid get pdisks -o (all information)
racadm raid get pdisks -o -p state,size (specific information)
% Get RAID Virtual Disk Information
Racadm raid get vdisks