RACADM Command Line Interface for DRAC
![]()
Terminology
Managed System- The commandfunctionalityofRACADMprovidesalmostDellPowerEdgeServercontaining the functionalitythatyoucangetthroughiDRACorDRAC,ortheDellBladeChassiscontainingtheChassisManagementController(CMC).
ManagementStation-Acomputerusedforaccessing the iDRACGraphicalUserInterface,DRAC,orCMCremotely.
iDRAC-IntegratedDellRemoteAccessController.AvailableonnewerandcurrentgenerationsofDellPowerEdgeServers (GUI).11Gand12G).
DRAC-DellRemoteAccessController.AvailableonoldergenerationsofDellPowerEdgeServers.
Overview
The Dell RACADM (Remote Access Controller Admin) utility is a command line tool that allows for
remote orlocal management of Dell Servers via the iDRAC /or DRAC(DellRemoteAccessController). RacadmcommandsarealsoavailableforRACADM
providessimilar functionalitytotheiDRAC/DRACGraphicalUserInterface(GUI).The Dell blades Chassis Management Controller (CMC.)
RACADM.EXEallowsCMC)canalsobemanagedremotelywithRACADM.
RACADMcommandscanberunremotelyfromamanagementstationand/orlocallyonthemanagedsystem.
RACADMcommandsallow you to view managed serversystem information, perform power operations on the managed serversystem, perform firmware updates on the DRACiDRAC and server, set system time, and more. Because RACADM is run from a command line interface (CLI), systemssystem administrators can create scripts that control and update Dell systems in a one-to-many fashion.
ThecommandfunctionalityofRACADMprovidesalmostSee the functionalitythatyoucangetthroughlinksto the iDRACGraphicalUserInterface(GUI).
WhereCanIDownload RACADM ?
Youcangetdocumentationat the DellRACADMutilityaspartend of theDellOpenManageDeploymentToolkitthisarticleforacompletelistingoffeaturesforyourproductversion.
The different RACADM command-lineutilities
ThefollowingRACADMutilities areavailable:
RemoteRACADM- utility canberunisinstalled on either a management stationand/or.
LocalRACADM-utilityisinstalled on the managed system.
SSH/Telnet/SerialRACADM(alsoknownasFirmwareRACADM)-utilityisbuiltintotheiDRAC,DRAC,andCMCfirmware.
NOTES:
LocalRACADMisnotrequiredifyouwillbemanagingyourserverfromamanagementstationviaRemoteRACADM.RemoteRACADMandLocalRACADMcannotbeinstalledatthesametimeonthesame system.
LocatingandInstallingRACADMutilities
RemoteRACADM-SupportsexecutingRACADMcommandsfromaremotemanagement
stationsuchasalaptopordesktopcomputer. It is available on the Dell OpenManage Systems Management Tools and Documentation DVD or at support.dell.com.
TheRACADMutilitysupportsthefollowinginterfaces:
- Local—Supportsexecuting
TodownloadRemote RACADM commands from themanagedserver’soperatingsystem.YoumustinstalltheOpenManagesoftwareonthemanagedservertorunlocalRACADMcommands. Fromsupport.dell.com, choosedriversselectDrivers and downloadsDownloads> choose your
server > selecttheOperatingSystem
ofyourManagementStation> expand ‘systemsmanagement’Systems
Management> select ‘DellToolkit’
- SSHtheapplicationthatappliestoDRACTools(forWindowsOperatingSystems) orTelnet—AlsoreferredasFirmwareRacadmLinuxRemoteAccessUtilities(forLinuxOperatingSystems)>DownloadFile.Firmware
Remote RACADM isaccessiblebyloggingintoiDRAC7Installation-WindowsManagement
Station
Ifdownloaded,extractthedownloadedfileandrun<path>\DRAC.msi
-OR-
If using SSHortelnet.Youdonothavetospecify the iDRAC7IPDVD, usernameorpasswordto run FirmwareRACADMcommands.Similar<path>\SYSMGMT\ManagementStation\windows\DRAC\DRAC.msi
Acceptthelicenseagreement>Next>Selectthefolder to LocalRACADMinstall
to>Next>Install>Finish.
Openanadministrativecommand
prompt, aftertyperacadmandpressEnter.
If you enterget the RACADM prompthelpinstructionsitisinstalledcorrectly.
RemoteRACADMInstallation-LinuxManagement
Station
Ifdownloaded, directlyrunextract the commandswithoutdownloadedfileandcdtothedirectory
containingtherpmfiles:
<path>/linux/rac/<linux
distributionname>/<i386orx86_64>
-OR-
IfusingtheDVD, cdtothe
directorycontainingtherpmfiles:<path>/SYSMGMT/ManagementStation/linux/rac/<linux_distribution_name>/<i386
orx86_64>
Fromthei386orx86_64directory,run:
rpm-ivh*.rpm
Openashellpromptwithroot
privileges,typeracadmandpressEnter.
Ifyouget the RACADM prefixhelpinstructionsitisinstalledcorrectly.
- Remote—
NOTE:Theracadm
executableislocatedunder/opt/dell/srvadmin/sbin.Youmayneedtologout
andlogbackintoresetthePATHenvironmentvariabletoincludethislocation.
LocalRACADM- Supports executing RACADM commands fromaremotemanagementstationsuchasalaptopordesktop.YoumustinstalltheDRACToolsutility from theOpenManagesoftware
managedsystem’soperatingsystem.Itisavailable on the remotecomputertorunRemoteRACADMcommandsDellOpenManage
SystemsManagementToolsandDocumentationDVDoratsupport.dell.com. From
TodownloadlocalRACADMfromsupport.dell.com, choosedriversselectDrivers and downloadsDownloads> choose your
server > selectyourOperatingSystem
> expand ‘systemsmanagement’SystemsManagement
> select ‘DRACTools’
RACADMSupportDellOpenManageServer
AdministratorManagedNode>Download
File.
Dothefollowingonthemanagedsystemcontainingthe
iDRAC/DRAC:
Local RACADM supportsDRAC5Installation-Windows
Ifdownloaded, iDRACextractthedownloadedfileandrun<path>\windows\setup.exe
-OR-
IfusingtheDVD, iDRAC6Express/Enterpriserun<path>\SYSMGMT\srvadmin\windows\setup.exe
Aftertheprerequisitechecker
runs, iDRAC7Express/EnterpriseclickServerAdministrator.
ClickNext>Acceptthelicenseagreement>Next>selectCustom>
Next.
Ataminimum, andCMCmakesureRemoteAccessControllerwillbe
installed>Next>Install>Finish.
RACADMsupports32bit
Openanadministrativecommand
prompt,typeracadm and 64bitWindowsOperatingsystems(testedtoworkonWindows2008R2x64)pressEnter.
Ifyougetthe RACADM forLinuxhelpinstructionsit is testedtoworkoninstalledcorrectly.
LocalRACADMInstallation - RedHatEnterprise LinuxServerversion5(32-
Ifdownloaded,extractthedownloadedfile and 64-bit)
-RedHatEnterpriseLinuxServerversion6(64-bit)run<path>/linux/supportscripts/srvadmin-install.sh
-SUSE(R)LinuxEnterpriseServerversion10(64-bit)OR-
IfusingtheDVD,run<path>/SYSMGMT/srvadmin/linux/supportscripts/srvadmin-install.sh
Acceptthelicenseagreementand,ataminimum,selectoption5 - SUSE(R)LinuxEnterpriseServerversion11RemoteAccessCoreComponentfrom
themenu.
Openashellpromptwithroot
privileges,typeracadmandpressEnter.
IfyougettheRACADMhelpinstructionsitisinstalledcorrectly.
NOTE:Theracadm
executableislocatedunder/opt/dell/srvadmin/sbin.Youmayneedtolog
out/logbackintoresetthePATHenvironmentvariabletoincludethis
location.
SSH/Telnet/SerialRACADM (64-bit)Firmware RACADMDocumentation
For)
-ThisutilityisbuiltintotheiDRAC,DRACorCMCfirmwareandthereisnoseparatedownloadorinstallationrequired.Seeyouruser'sguide
forconnectingviathesemethods.
Onceconnected,typeracadmhelpfortheonlinehelp
instructions.
NOTE:
Onsomeinterfacesif
youtyperacadmandpressEnter,
youwillbetakento a racadm>
prompt.Commandscanthenbeenteredfromthispromptwithoutthe"racadm"prefix.Toexitthe
prompt,typequitoruseCtrl+C.
SyntaxUsage
ThefollowingshowsanexampleofasimpleRACADMcommand,getsysinfo,
witheachinterface.See
thedocumentationsectionbelowforlinkstodocumentationcontainingthe full
list of RACADM commandsandadetaileddescription.
RemoteRACADM
RemoteRACADMcommandsmustincludetheipaddressorhostname of thecapabilities
idrac,andtheidracusernameandpassword.
racadm-r<ipaddressorhostname>-u<username>-p<password>
getsysinfo
racadm-r10.1.1.1-uroot-pcalvingetsysinfo
NOTE:Remoteracadmuses
thewebserverSSLcertificate of the utilityiDRACtoauthenticatethesession.You
willreceiveawarningmessageifcertificateshavenotbeenconfiguredorif
thecertificateisinvalid.However, readthecommandwillexecutenormallyfollowing
themessage.Ifyouwishtohaltthecommandoncertificateerrors,usethe-S
optioninthecommand.ForinformationonconfiguringcertificatesontheiDRAC,
see the user'sguideforyouriDRACatthelinkbelow.
LocalRACADM
Youdonothavetospecifytheipaddress,username,orpasswordinLocal
RACADMcommands.
racadmgetsysinfo
SSH/Telnet/Serial(Firmware)
RACADM
Youdonothavetospecifytheipaddress,username,orpasswordinFirmware
RACADM commands.
racadmgetsysinfo
or
racadm<Enter>
racadm>>getsysinfo
RACADM Documentation
See
theRACADMCommandLineReferenceGuide
attheappropriatelinkbelow for iDRAC7 (newestwas1.0.0asof25May2012.) iDRAC7detailedinformationonsupportedRACADM
commandsandfeatures.Thisguide is available onforiDRAC7,iDRAC6,and the 12thGenerationDellPowerEdgeServersCMC.
For iDRAC6DRAC5, whichthisinformation is presentoncombinedwith the 11thGenerationUser'sGuide.
See
theReadmefileattheappropriate
linkbelowforacompletelisting of PowerEdgeserverssupportedoperatingsystems.
To
locateaparticulardocument, viewselect the RACADMDocumentationappropriatelink for yourhardware,
thenselectyourfirmwareversion,thenyourlanguage.