Racvmcli | Dell Remote Access Controller 4 Firmware Version 1.30

racvmcli

The major capabilities of the Virtual Media command line interface (VM-CLI) utility are:

•Support for removable media devices or image files, consistent with the VM plugins.

•Support for command line option(s) to control/interact with the VM-CLI utility.

•Support for multiple, simultaneously active instances of the utility (with read-only image files only, not when actual floppy/CD devices are used).

•Optional feature: Support for a configuration file containing common options.

•Automatic termination upon disconnection – DRAC firmware boot-onceoption.

Installation

Standard installation methods are used to manage the installation and removal of the racvmcli utility on the Virtual Media client systems:

•For Windows clients, the utility is delivered as part of the RAC Management Station packaging, along with the racadm utility.

•For Linux clients, the VM-CLI utility is delivered as part of the RAC Management Station packaging, along with the racadm utility.

A sample deployment script is included in the packaging that illustrates how you can use the VM-CLI and racadm utilities to perform operating system or patch deployment against multiple target host systems. You can use this script as it is, or as a reference in developing a custom deployment framework that uses Virtual Media features.

Execution Environment

The VM-CLI command executes within the context of one of the following supported operating systems:

1Windows XP

2Windows 2000

3Windows 2003

4Red Hat Linux 9

5Red Hat Linux AS/ES 2

6Red Hat Linux AS/ES 3

7Red Hat Linux AS/ES 4

The use of the VM-CLI utility requires valid DRAC 4 account credentials. The client host operating system must provide support for Secure Sockets Layer (SSL). The VM-CLI utility uses SSL to provide secure communications over its network connection to the DRAC 4 firmware (during initial connection setup).

Configuring and Using Virtual Media

117

Image 117

Dell Remote Access Controller 4 Firmware Version 1.30 manual Racvmcli, Installation, Execution Environment, 117

Contents

W . d e l l . c o m s u p p o r t . d e l l . c o m Firmware Version 1.30 User’s Guide May Contents Configuring Red Hat Enterprise Linux for Configuring the Drac 4 Network SettingsViewing Localized Versions of the Web-Based Interface Removing Drac 4-Related Applications and Drivers Adding and Configuring Drac 4 Users and Alerts Configuring Red Hat Enterprise Linux Minicom forEnabling Microsoft Telnet for Telnet Console Redirection First Steps to Troubleshoot a Remote System Installing the Dell Extension to the Active Directory Users Configuring Active Directory to Access Your DracConfiguring the Drac 4 Active Directory Settings Using Active Directory to Log In To the Drac 100 Enabling and Disabling the Virtual Media Feature 115 Installing Operating Systems Using Virtual Media 114Viewing a List of Serial/Telnet Commands 128 111 Creating Bootable Deployment Image Files 146 Using the racadm Utility to Configure the Drac 137134 136 152 151153 154 165 164166 167 173 172174 175 179 178180 181 194 190197 199 CfgNetTuningNicFullDuplex Read/Write 205 CfgNetTuningNicAutoneg Read/Write 204200 203 217 214218 219 Drac 4 Power Requirements Setting Up Active Directory ObjectsManagement Station COM Port Settings Overall Architecture of Virtual Media 111 Certificate Signing Request Generation Enable email Alert PropertiesWatchdog Information Fields Last Crash Screen Page Buttons DellAssociationObject Class Drac 4 Network Error CodesList of Attributes Added to Log/Verbose Level Options 131 Table A-6 Getconfig Subcommand Options 152 Table A-7 Table A-5 Config Subcommand OptionsTable A-10 Fwupdate Subcommand Options 157 Table A-11 Table A-12 Getssinfo Subcommand Options 159 Table A-13 Table A-33 Setrac Subcommand Options 173 Table A-34 Table A-28 Serveraction Subcommand Options 169 Table A-29Table A-35 Sslcsrgen Subcommand Options 175 Table A-36 Table A-41 Sslcertview Subcommand Options 178 Table A-42 Drac 4 Overview What’s New in Drac 4 in this Release? Drac 4/I Hardware Features RJ-45 Connector Drac 4 Hardware Features Power Requirements Hardware SpecificationsConnectors Lists the power requirements for the Drac Supported Remote Access Connections Drac 4 Security FeaturesLists the features of each type of connection Supported Platforms Supported Operating SystemsSupported Web Browsers Features Other Documents You May Need Drac 4 Overview Software Installation and Configuration Overview Installing the Drac 4 HardwareInstalling and Setting Up the Drac What You Need to Get Started Installing the Software on the Managed System Disabling the Windows Automatic Reboot Option Configuring a Supported Web Browser Installing the Software on the Management StationMount /mnt/cdrom Cd /mnt/cdrom Rpm -ivh linux/rac/*.rpm Rpm -e racadm Installing the Sun Java Plug-In to Use Console Redirection Installing the Sun Java Plug-InInstalling the Sun Java Plug-In to Use Mozilla Viewing Localized Versions of the Web-Based Interface Rpm -iv j2re-14versionnumber-linux-i586.rpm Configuring Drac 4 PropertiesFor example Register the Java plug-in Configuring the Drac 4 Network Settings Using the Option ROM Configuring the Drac 4 Network Settings Waiting for response from Dhcp Server Virtual Media Configuration Options Adding and Configuring Snmp Alerts Adding and Configuring Drac 4 Users Updating the Drac 4 Firmware Clearing the Web Browser Cache With Internet ExplorerClearing the Web Browser Cache With Mozilla Accessing the Drac 4 Through a Network Service racsvc status Where action is start, stop, status, or probeDrac 4 Software Basics for Red Hat Enterprise Linux Additional Information Removing the DracRemoving Drac 4-Related Applications and Drivers Drac 4 NIC Serial and Telnet Console Features F2 = System Setup Configuring the System Setup Program on the Managed System Serial --unit=0 --speed=57600 terminal --timeout=10 serial Append two options to the kernel lineKernel ............. console=ttyS0,57600 Enabling Login to the Console After Boot Co2345respawn/sbin/agetty -h -L 57600 ttyS0 vt100Sample File /etc/innitab TtyS0 Enabling the Serial/Telnet Console on the Drac Racadm config -g group -o object value Racadm getconfig -g groupUsing racadm Remotely Using the Secure Shell SSH Racadm getconfig -g cfgSerialRacadm config -g cfgSerial -o cfgSerialSshEnable AES192-CBC You can change the SSH port with the commandAES128-CBC 3DES-192-CBC Required Pinout for DB-9 Null Modem Cable Signal Name Connecting the DB-9 CablePage Configuring HyperTerminal for Serial Console Redirection Clear the init, reset, connect, and hangupType minicom -c on Page Enabling Microsoft Telnet for Telnet Console Redirection Using a Serial or Telnet Console Accessing the Web-Based Interface Managing and Recovering a Remote SystemLogging Adding and Configuring Drac 4 Users Adding and Configuring Drac 4 Users and AlertsPassword User Properties Property Description User Name Use the information in -3 to enable email alerts Configuring User email Alerts Email Alert Severity Description Informational Go Back To User ConfigurationSevere Alert Description Configuring the Drac 4 NIC Email Alert Settings Duplex ModeCheck box is selected Default Smtp Email Server Drac 4 Network Configuration Page Buttons Configuring Alerts by Severity Adding and Configuring Snmp Alerts Severity Options Description Informational System Fan Sensors Monitors the system fan speed RPMSuch as chassis intrusion Managing a Remote System Snmp Alert Properties PropertyDescription10. Snmp Alerts Page Buttons Action Print Ensuring Drac 4 Network Security Updating the Drac 4 Firmware Type IssuerSerial Key Size From the CA Default certificate you received with your DracUpload Certificate View Server Certificate State S 14. Required CSR Fields Properties Description Locality LManagement Generate 16. Certificate Management Page Buttons Action Print Viewing System Information Service Tag Bios VersionServer Address System Information Recovering and Troubleshooting the Managed System First Steps to Troubleshoot a Remote System Managing Power on a Remote System SEL provides buttons see -24 in the top-right corner Using the SEL 25. Status Indicator Icons Description Using the Drac 4 LogDate/ Time User Viewing the Last System Crash Screen Using the Diagnostic Console Ifconfig 28. Diagnostic Commands Description ArpNetstat Ping IP Address 30. Drac 4 Network Error Codes Description Troubleshooting Network Problems Troubleshooting Alerting Problems RAC189A RAC065A Frequently Asked Questions Managing and Recovering a Remote System Managing and Recovering a Remote System Using the Drac 4 With Microsoft Active Directory Active Directory Schema Extensions Active Directory Object Overview Overview of the RAC Schema Extensions RAC4 Privilege Object User1 User2 User3 Group1 Priv1 AO1 Configuring Active Directory to Access Your Drac Extending the Active Directory SchemaUsing the Dell Schema Extender Click Next to run the Dell Schema Extender Click Finish 840.113556.1.8000.1280.1.1.1.3 Description DellRAC4Privileges Class840.113556.1.8000.1280.1.1.1.4 Description Attributes DellRAC4Privileges DellProduct Class False DelIsLogClearAdmin Ldaptypecaseignorestring Opening the Active Directory Users and Computers Snap-In Adding Drac 4 Users and Privileges to Active DirectoryCreating a RAC Device Object Creating a Privilege Object Creating an Association Object Adding Objects to an Association ObjectSelect the scope for the Association Object Click OK Click Next and click Finish Enabling SSL on a Domain Controller Exporting the Domain Controller Root CA Certificate Select Computer account and click NextClick Finish and click OK Click the Configuration tab and select Network Configuring the Drac Using Active Directory to Log In To the Drac Racadm config -g cfgLanNetworking -o cfgDNSServersFromDHCP100 101 Lists frequently asked questions and answers 102 Racadm sslcertupload -t 0x1 -f websslcert Using Console Redirection Overview103 Current console redirection sessions Maximum console redirection sessions 105 Racadm racreset command Using Console Redirection Frequently Asked Questions AnswerRunning the racadm racreset hard command 106 107 108 Rpm -qa grep radeon7000mdellserver Run Xconfigurator if not previously run before109 Run Xwindows startx 110 Overall Architecture of Virtual Media Managed System 111 Operating System Requirements on the Managed System Installing the Virtual Media Plug-In Using the Virtual Media Feature113 Installing Operating Systems Using Virtual Media Booting From the Virtual Media Racadm config -g cfgRacVirtual -o cfgVirMediaDisable Enabling and Disabling the Virtual Media FeatureCat /var/log/messages grep Virtual 115 Configuring the Virtual Floppy as a Hard Drive Configuring the Virtual Floppy Feature as a Super FloppyRacadm config -g cfgRacVirtual -o cfgFloppyEmulation DELL-VIRTUALS-120 Removable Media Drive Racvmcli InstallationExecution Environment 117 VM-CLI Parameters Interfaces and APIsRacvmcli parameters OS-shell options Drac 4 IP Address 119 UDRAC-user-name Cdevice-name image-file CD/DVD Device or Image File 121 Drive Number 0 failed to Racadm getconfig -gDetect Virtual device Drive Number 1 failed to CfgRacVirtual Other console startup Use the racadm vmdisconnect command toMessages 123 Drive Removable Media Drive Drive Number 0 VirtualfloppyDrive Number 1 Virtualcdrom 124 125 Cat /etc/fstab grep /dev/hde Cat /var/log/messages grepMount /mnt/cdrom1 126 Logging into the Drac Starting a Text Console127 Racadm config -g cfgSerial -o cfgSerialHistorySize number Viewing a List of Serial/Telnet CommandsSetsvctag Firmware Unsupported Command 128 Racadm Command Description Using the racadm CLIPrompt a racadm help more 129 Lists the options for the racadm command Using the racadm CLI RemotelyRacadm Synopsis Racadm Options Racadm Command Options Type the following command to disable the remote capability131 Option Description 132 Racadm Subcommand Descriptions Racadm Error Messages Configuring Multiple Drac 4sConfiguration File Overview 133 Racadm getconfig -f myfile.cfg Creating a Drac 4 Configuration File CfgLanNetworking CfgNicIpAddress=143.154.133.121 Use the racresetcfg subcommand to keep all Drac 4s the sameSee the example in the previous bullet 135 Racadm config -g groupName -o objectName -i index Configuration File ExampleRacadm getconfig -g groupName -i index 136 File contents are as follows Using the racadm Utility to Configure the DracThis file will be updated as follows 137 Racadm getconfig -g cfgUserAdmin -i index Racadm getconfig -u username# cfgUserAdminIndex=XX CfgUserAdminUserName= Before Adding a Drac 4 User Adding a Drac 4 User With Alerting Capabilities 139Specific object 140 Adding a Drac 4 User With Permissions Configuring Drac 4 Network Properties Racadm getconfig -g cfgLanNetworking141 Racadm subcmd Transport Error message Racadm subcmd Error messageRacadm subcmd Firmware Error message 142 143 Requirements Tasks 145 Vmdeploy To create image files from existing bootable media Creating Bootable Deployment Image FilesLinux Users Windows Users Troubleshooting the Drac Troubleshooting147 Troubleshooting Help Racadm help Racadm help subcommandSynopsis Description Arp Config/getconfigClearasrscreen Racadm arp Racadm config -p -c -f filename Racadm config -g Config Subcommand DescriptionRacadm getconfig Filename Racadm Getconfig Table A-6. getconfig Subcommand Options Description Getconfig Subcommand DescriptionFilename command 152 Coredump Table A-7 describes the coredump subcommandExamples Racadm coredump 154 Output Example Coredumpdelete FwupdateCurrent task stack Ipev -#005e0000 binary data FW dcmdCoreDump No Core dump available Table A-10 describes the fwupdate subcommand options 156 Load the update file into the Drac 4 RAMdisk areaTable A-9. fwupdate Subcommand Definition Input 157 Table A-10. fwupdate Subcommand Options Description Racadm -r Racip -u user -p password fwupdate -g -u -a Updating the Firmware158 Table A-12 describes the getssinfo subcommand options Table A-11 describes the getssinfo subcommandGetssninfo Racadm getssninfo -A -u username Web GetsysinfoRoot Thu 06 Mar 143.166.174.19 2004 103239 GMT-0600 Watchdog information/recovery action Table A-15 describes the getsysinfo subcommand optionsFollowing data element is output as a string 161 Restrictions Racadm getsysinfo -A -w -sRacadm getsysinfo -w -s Racadm ifconfig IfconfigGetractime Racadm getractime -u -d Ping NetstatSetniccfg/getniccfg Racadm ping ipaddress Description for setniccfg Table A-21. setniccfg/getniccfg Subcommand DefinitionDescription for getniccfg 165 Racdump GetsvctagExample Racadm getsvctag Racreset Transport Error RC=-1Racadm racreset hard soft graceful delay in seconds Table A-25 describes the racreset subcommand options RacresetcfgTable A-26 describes the racresetcfg subcommand Racadm racresetcfg Racadm serveraction -d delay action Table A-27 describes the serveraction subcommandTable A-27. serveraction SubcommandDefinition Serveraction Table A-29 describes the getraclog command Serveraction command returns without output if successfulTable A-29 Getraclog Command Definition Getraclog Clrraclog Table A-30 describes the getsel commandGetsel Racadm clrraclog Gettracelog ClrselRacadm clrsel Racadm gettracelog Racadm gettracelog -m Racadm setrac -h -o -T -d Setrac Table A-33. setrac Subcommand Options Table A-34 describes the sslcsrgen subcommandTable A-34. sslcsrgen SubcommandDescription Sslcsrgen Table A-35. sslcsrgen Subcommand Options Description Table A-35 describes the sslcsrgen subcommand optionsOptions 175 Sslcertupload Racadm sslcertupload -t type -f filenameRacadm sslcertupload -t 0x1 -f c\cert\cert.txt Sslcertdownload Racadm sslcertdownload -t type -f filenameRacadm sslcertdownload -t 0x1 -f c\cert\cert.txt Sslcertview Output ExamplesRacadm sslcertview -t type -A Testemail 1024 DSU+123431 DSU+153431 RMC Default Certificate Dell IncRound Rock Texas john@dell.com Racadm testemail -i index -u username Racadm testtrap -i index Testtrap Table A-46. vmdisconnect Subcommand Description Table A-46 describes the vmdisconnect subcommandVmdisconnect Racadm vmdisconnect Racadm Subcommand Man Pages IdRacInfo IdRacProductInfo Read OnlyIdRacDescriptionInfo Read Only IdRacVersionInfo Read Only IdRacName Read/WriteIdRacMisc Read/Write IdRacType Read CfgLanNetworkingCfgDNSDomainNameFromDHCP Read/Write CfgDNSDomainName Read/Write CfgDNSRegisterRac Read/Write CfgDNSRacName Read/Write CfgDNSServer1 Read/Write CfgDNSServersFromDHCP Read/WriteCfgDNSServer2 Read/Write 187 CfgNicEnable Read/Write CfgNicIpAddress Read/WriteCfgNicNetmask Read/Write CfgNicGateway Read/Write CfgCurrentLanNetworkingCfgNicUseDhcp Read/Write CfgNicMacAddress Read Only CfgNicCurrentNetmask Read Only CfgNicCurrentIpAddress Read OnlyCfgNicCurrentGateway Read Only CfgNicCurrentDhcpWasUsed Read Only CfgRemoteHosts CfgRhostsSmtpEmailEnable Read/WriteCfgDNSCurrentDomainName Read Only CfgDNSCurrentServer1 Read Only CfgRhostsFwUpdateTftpEnable Read/Write CfgRhostsFwUpdateIpAddr Read/WriteCfgRhostsSmtpServerIpAddr Read/Write CfgRhostsFwUpdatePath Read/Write CfgUserAdminCfgUserAdminPrivilege Read/Write Legal Values CfgUserAdminUserName Read/Write CfgUserAdminPassword Write OnlyTable B-1. Bit Masks for User Privileges CfgUserAdminAlertFilterSysEventMask Read/Write CfgUserAdminAlertFilterRacEventMask Read/WriteCfgUserAdminEmailEnable Read/Write 195 CfgUserAdminEmailCustomMsg Read/Write CfgUserAdminEmailAddress Read/WriteCfgUserAdminIndex Read Only CfgTraps CfgTrapsSnmpCommunity Read/Write CfgTrapsEnable Read/WriteCfgTrapsFilterRacEventMask Read/Write 197 CfgSessionManagement CfgTrapsFilterSysEventMask Read/WriteCfgTrapsIndex Read Only CfgSsnMgtMaxSessions Read/Write CfgSsnMgtSshIdleTimeout Read/WriteCfgSsnMgtMaxSessionsPerUser Read/Write 199 CfgSerialConsoleEnable Read/Write CfgSerialCfgSerialBaudRate Read/Write CfgSerialConsoleQuitKey Read/Write CfgSerialConsoleIdleTimeout Read/WriteCfgSerialConsoleShellType Read/Write 201 CfgSerialConsoleCommand Read/Write CfgSerialConsoleNoAuth Read/WriteCfgSerialHistorySize Read/Write CfgSerialTelnetEnable Read/Write CfgSerialSshEnable Read/WriteCfgSerialCom2RedirEnable Read/Write 203 CfgNetTuningNicAutoneg Read/Write CfgNetTuningCfgNetTuningNic100MB Read/Write CfgSerialTelnet7flsBackspace Read/Write CfgNetTuningNicMtu Read/Write CfgNetTuningNicFullDuplex Read/WriteCfgNetTuningIpTtl Read/Write Legal Values Integer from 1 to Default 0x40 CfgNetTuningTcpSrttBase Read/Write CfgNetTuningIpReassTtl Read/WriteCfgNetTuningTcpSrttDflt Read/Write Legal Values Integer from 6 to Default 0x6 206 CfgNetTuningTcpReXmtMax Read/Write CfgNetTuningTcpReXmtMin Read/WriteCfgNetTuningTcpMsl Read/Write 207 Tuning the Drac 4 for Satellite Connectivity CfgNetTuningIpSubnetsAreLocal Read/WriteWhere value is obtained from Table B-2 Ini files are used Legal Values Boolean, either 1 or 0 True or False Default CfgOobSnmpTrapsEnable Read/WriteCfgOobSnmp CfgOobSnmpAgentCommunity Read/Write CfgOobSnmpAgentEnable Read/Write CfgRacTuningDescription =Disable, 1=Enable transmission of Snmp traps CfgRacTuneHttpPort Read/Write CfgRacTuneSshPort Read/Write CfgRacTuneHttpsPort Read/WriteCfgRacTuneTelnetPort Read/Write 211 CfgRacTuneRemoteRacadmEnable Read/Write CfgRacTuneFwUpdateResetDelay Read/WriteLegal Values 115200, 57600, 19200, Default 212 CfgRacTuneHostCom2BaudRate Read/Write CfgRacTuneConRedirPort Read/Write IfcRacManagedNodeOsIfcRacMnOsHostname Read/Write IfcRacMnOsOsName Read/Write IfcRacMnOsOsType Read Only CfgRacSecurityCfgRacSecCsrCommonName Read/Write CfgRacSecCsrOrganizationName Read/Write CfgRacSecCsrOrganizationUnit Read/Write CfgRacSecCsrLocalityName Read/WriteCfgRacSecCsrStateName Read/Write CfgRacSecCsrEmailAddr Read/Write CfgRacSecCsrCountryCode Read/WriteCfgRacSecCsrKeySize Read/Write Description CSR state Legal Values Or 0 True or False Default Description CfgVirMediaDisable Read/WriteCfgRacVirtual CfgFloppyEmulation Read/Write CfgActiveDirectory CfgVirtualBootOnce Read/WriteCfgVirAtapiSrvPort Read/Write CfgADRacDomain Read/Write CfgADAuthTimeout Read/Write CfgADEnable Read/WriteCfgADRacName Read/Write 219 Drac 4-Generated Event Mask Definitions Event Filter Operation and Event Mask PropertiesCfgADRootDomain Read/Write 220 Racadm -g cfgTraps -o cfgTrapsFilterSysEventMask -i1 System-Generated Alert Mask Definitions221 Miscmask 222 Alert Filter PropertiesStatMask SenMask Email Test Command Alert Test CommandsAlert Data Definitions Racadm testemail -i index Racadm testemail -u username Synopsis Trap Test CommandRacadm testtrap -t -i trap index 224 Other characters Acronym for application programming interfaceAbbreviation for compact disc Acronym for custom factory integration Abbreviation for Dynamic Domain Naming System Abbreviation for Dell Remote Access ControllerAbbreviation for Domain Name System Abbreviation for disk storage unit Abbreviation for local area network Abbreviation for international standards organizationAbbreviation for light-emitting diode Abbreviation for management information base Abbreviation for uninterruptible power supply Abbreviation for remote access controllerRAM disk Acronym for system event log Index 229 Drac 4, removing related applications and drivers 231 Index