Wikis - Title

RACADM Command Line Interface for DRAC

Systems Management

Systems Management
Dell Systems Management Solutions: Dell OpenManage, iDRAC, Repository Manager, Microsoft SCCM, Chassis Managment Controller, and more

Systems Management - Wiki

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:

  1. Go to http://support.dell.com
  2. If prompted, select Start Here under Small Businesses or Enterprise IT.
  3. Enter the Service Tag of the managed system and Submit, or use one of the Choose options to locate your managed system model.
  4. 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.
  5. Expand Systems Management
    1. For Windows Operating Systems, locate the DRAC Tools application.
    2. For Linux operating systems, locate the Linux Remote Access Utilities application.
  6. Click Download File.


 Desc

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 at support.dell.com.

To download Local RACADM:

  1. Go to http://support.dell.com
  2. If prompted, select Start Here under Small Businesses or Enterprise IT.
  3. Enter the Service Tag of the managed system and Submit, or use one of the Choose options to locate your managed system model.
  4. Select Drivers and Downloads > select the Operating System of your Managed System > expand Systems Management. 
  5. 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. 

 

Article revised by Jim Slaughter.

Comments
  • Hi. This doocument is for Windows Server versions.

    What are the steps, downloads for Linux?

  • Really need help w this functionality and dont know where to find how to perform Remote RACADM on Linux platforms

  • Philip's right, these instructions are for Microsoft's victims.

    Worse yet is the part where you point customers to the top level of the support web site. What's the point of having a web site if you can't post URLs?

  • Philip and mumblyjoe,

    Thanks for your feedback. The article has been revised to include Linux instructions as well as additional clarification throughout.

    -Jim

  • The link to the iDRAC6 Documnetation ( support.dell.com/.../index.htm ) is pointing to the 'Enter your ServiceTag" page. Please fix.

  • All links new and previous seem to loop around to "Enter Service Tag" page, more or less rendering them null and void....

    Have found 2 paths, either L-earn to work the path to target by category or use good ol'Mr. Peabodys WAYBAC machine/archive:

    Go to Enter tag page or support.dell.com and choose manuals, to get to same.

    Enter Tag pages at this time seem to present 2 different ways: Enter tag at top, and  choose category at bottom, or Enter Tag to Left, and other options to right (choose last 1:"Choose from a list of all Dell products"):

    Then: Software & Security > Remote Enterprise System Management > Remote Access Controller, find target(s)

    OR

    Right Click link, copy link location and go to WABAC : http://archive.org/web/web.php , search for link, dates etc.  Even if Mr.Peabody doesn't have it, usually will fish out present location

  • BCSTechD and raided ,

    Thanks for your feedback. The documentation link has been updated to point to the new location.

    -Jim

  • Please post a link to the latest RACADM Command Line Reference Guides for iDRAC7 and iDRAC6 versions.

  • Latest RACADM manual can be found on the Dell FTP site, its quite a slow download but if you wait long enough it will appear eventually!

    RACADM Command Line Reference Guide for iDRAC7 1.40.40 and CMC 4.40 (June-2013 )

    CMC is now 4.45 but there isn’t a newer guide as of Feb 2014

    ftp.dell.com/.../poweredge-m1000e_Developer%27s%20Guide6_en-us.pdf

  • This really is one of the biggest time consuming exercises I have faced recently with a Dell server.

    Buy a HP and upgrade it's iLo to see how things should be done.

  • "racadm set" should not force a reboot after a configuration (i.e. "racadm set -t XML -f BIOS.xml"). Making racadm reboot a server does not play nicely with reboot aware system automation. It only works well for ad-hoc configurations. A mass configuration tool should not just work well for ad-hoc execution.

    From "racadm help set":

    -b : Specifies the shutdown type for the host after the import operation

        completes. The parameters are "Graceful" and "Forced" for graceful

        and forced shutdown respectively. If this parameter is not specified,

        graceful shutdown is taken as the default.

  • There's a lot of good commands in Windows 7

    www.atlantaitservice.com/.../useful-windows-7-commands