User’s Guide
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
Contents
Introduction--1 Product Features. . . 1 Getting Started. . . 4Establishing Network Settings. . . 5
Recovering from a Lost Password. . . 9
Rack PDU Front Panel--11
Command Line Interface--15
About the Command Line Interface . . . 15
Logging on to the Command Line Interface. . . 15
About the Main Screen. . . 18
Using the Command Line Interface . . . 21
Command Syntax. . . 22
Command Response Codes. . . 23
Network Management Card Command Descriptions . . . 24
Device Command Descriptions . . . 46
Web Interface--84
Supported Web Browsers . . . 84
Logging On to the Web Interface . . . 85
Web Interface Features . . . 88
About the Home Tab . . . 91
Device Management--94
About the Device Manager Tab . . . 95
Viewing the load status and peak load. . . 95
Configuring Load Thresholds . . . 96
Configuring the Name and Location of the Rack PDU . . . 97
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
Resetting Peak Load and kWh. . . 98
Configure and Control Outlet Groups . . . 98
Outlet Settings for Outlets and Outlet Groups . . . 108
Scheduling Outlet Actions. . . 112
Outlet Manager Menu. . . 116
Environment--117
Configuring Temperature and Humidity Sensors. . . 118
Configuring Dry Contact Inputs. . . 120
Logs--121
Using the Event and Data Logs . . . 122
Administration: Security--130
Local Users . . . 131
Remote Users . . . 132
Configuring the RADIUS Server. . . 134
Inactivity Timeout . . . 135
Administration: Notification--136
Event Actions. . . 137
Active, Automatic, Direct Notification . . . 140
Administration: Network Features--148
TCP/IP and Communication Settings. . . 149
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
iiiAdministration: General Options--167
Identification . . . 167
Set the Date and Time . . . 168
Use an .ini File. . . 170
Event Log and Temperature Units . . . 171
Reset the Rack PDU. . . 172
Configure Links. . . 173
About the Rack PDU . . . 173
How to Export Configuration Settings--174
Retrieving and Exporting the .ini File. . . 174
The Upload Event and Error Messages . . . 178
File Transfers--180
How to Upgrade Firmware . . . 180
Firmware File Transfer Methods. . . 182
Verifying Upgrades and Updates . . . 185
Troubleshooting--186
Rack PDU Access Problems . . . 186
Appendix A: List of Supported Commands--188
Appendix B: Security Handbook--193
Content and Purpose of This Appendix . . . 193
Security Features. . . 194
Authentication. . . 198
Encryption. . . 199
Creating and Installing Digital Certificates. . . 202
Firewalls . . . 206
Using the Rack PDU Security Wizard. . . 207
Create a Root Certificate and Server Certificates. . . 210
Create a Server Certificate and Signing Request . . . 214
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
Command Line Interface Access and Security. . . 220
Telnet and Secure Shell (SSH). . . 221
Web Interface Access and Security: HTTP and HTTPS (with SSL) . . 222
Supported RADIUS Functions and Servers . . . 225
Configure the Rack PDU . . . 226
Configure the RADIUS Server . . . 228
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
1Introduction
Product Features
The Dell® Managed Rack Power Distribution Unit (PDU) is a stand-alone,
network-manageable power distribution device. The Rack PDU provides real-time remote monitoring of connected loads. User-defined alarms warn of potential circuit overloads. The Rack PDU provides full control over outlets through remote commands and user interface settings.
You can manage a Rack PDU through its Web interface, its command line interface (CLI), or Simple Network Management Protocol (SNMP):
• Access the Web interface using Hypertext Transfer Protocol or using secure HTTP (HTTPS) with Secure Sockets Layer (SSL). See Logging On to the Web Interface. • Access the command line interface through a serial connection, Telnet, or Secure
Shell (SSH). See About the Command Line Interface.
• Use an SNMP browser and the Dell Management Information Base (MIB) to manage your Rack PDU.
Rack PDUs have these additional features:
• Peak load, and power and energy monitoring for all connected loads. • Voltage, current, and power monitoring for phases.
• Power monitoring for each outlet.
• Configurable alarm thresholds that provide network and visual alarms to help avoid overloaded circuits.
• Four levels of user access accounts: Administrator, Device User, Read-Only User, and Outlet User.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
• Up to twenty-four independent outlet user accounts.
• Event and data logging. The event log is accessible by Telnet, Secure CoPy (SCP), File Transfer Protocol (FTP), serial connection, or Web browser (using HTTPS access with SSL, or using HTTP access). The data log is accessible by Web browser, SCP, or FTP.
• E-mail notifications for Rack PDU and system events.
• SNMP traps, Syslog messages, and e-mail notifications based on the severity level or category of the Rack PDU and system events.
• Security protocols for authentication and encryption.
Access priorities for logging on
Only one user at a time can log on to the Rack PDU. The priority for access, beginning with the highest priority, is as follows:
• Local access to the command line interface from a computer with a direct serial connection to the Rack PDU
• Telnet or Secure Shell (SSH) access to the command line interface from a remote computer
• Web access
The Rack PDU does not provide power surge protection. To ensure that the device is protected from power failure or power surges, connect the Rack PDU to an uninterruptible power supply (UPS).
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
3Types of user accounts
The Rack PDU has four levels of access (Administrator, Device User, Read-Only User, and Outlet User), which are protected by user name and password requirements. • An Administrator can use all of the menus in the Web interface and all of the
commands in the command line interface. The default user name and password are both admin.
• A Device User can access only the following:
– In the Web interface, the menus on the Device Manager tab, the Environment
tab, and the event and data logs, accessible under the Events and Data headings on the left navigation menu of the Logs tab. The event and data logs display no button to clear the log.
– In the command line interface, the equivalent features and options. The default user name and password are both device.
• A Read-Only User has the following restricted access: – Access through the Web interface only.
– Access to the same tabs and menus as a Device User, but without the capability to change configurations, control devices, delete data, or use file transfer options. Links to configuration options are visible but disabled. The event and data logs display no button to clear the log.
The default user name and password are both readonly.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
• An Outlet User has the following restricted access:
– Access through the Web interface and command line interface.
– Access to the same menus as a Device User, but with limited capability to change configurations, control devices, delete data, or use file transfer options. Links to configuration options are visible but are disabled. The Outlet User has access to the Outlet Control menu option that allows the user to control the outlets assigned by the Administrator. Outlet Users cannot clear the event or data logs.
The user name and password are defined by the Administrator during the process of adding a new Outlet User.
Getting Started
To start using the Rack PDU:
1. Install the Rack PDU using the Rack Power Distribution Unit Installation
Instructions that were shipped with your Rack PDU.
2. Apply power and connect to your network. Follow the directions in the Rack
Power Distribution Unit Installation Instructions.
3. Establish network settings. (See Establishing Network Settings.) 4. Begin using the Rack PDU by way of one of the following:
• Web Interface
• Command Line Interface
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
5Establishing Network Settings
You must configure the following TCP/IP settings before the Rack PDU can operate on a network:
• IP address of the Rack PDU • Subnet mask
• Default gateway
TCP/IP configuration methods
Use one of the following methods to define the TCP/IP settings needed by the Rack PDU:
• BOOTP and DHCP configuration
• Command Line Interface
If a default gateway is unavailable, use the IP address of a computer that is located on the same subnet as the Rack PDU and that is usually running. The Rack PDU uses the default gateway to test the network when traffic is very light.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
BOOTP and DHCP configuration
The default TCP/IP configuration setting, DHCP, assumes that a properly configured DHCP server is available to provide TCP/IP settings to Rack PDUs. You can also configure the setting for BOOTP.
A user configuration (INI) file can function as a BOOTP or DHCP boot file. For more information, see Use an .ini File.
BOOTP. For the Rack PDU to use a BOOTP server to configure its TCP/IP settings, it must find a properly configured RFC951-compliant BOOTP server.
In the BOOTPTAB file of the BOOTP server, enter the Rack PDU’s MAC address, IP address, subnet mask, and default gateway, and, optionally, a bootup file name. Look for the MAC address on the bottom of the Rack PDU or on the Quality Assurance slip included in the package.
When the Rack PDU reboots, the BOOTP server provides it with the TCP/IP settings. • If you specified a bootup file name, the Rack PDU attempts to transfer that file from
the BOOTP server using TFTP or FTP. The Rack PDU assumes all settings specified in the bootup file.
• If you did not specify a bootup file name, you can configure the other settings of the Rack PDU remotely through its Web Interface or Command Line Interface.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
7DHCP. You can use an RFC2131/RFC2132-compliant DHCP server to configure the TCP/IP settings for the Rack PDU.
1. The Rack PDU sends out a DHCP request that uses the following to identify itself:
• A Vendor Class Identifier
• A Client Identifier (by default, the MAC address of the Rack PDU)
• A User Class Identifier (by default, the identification of the application firmware installed on the Rack PDU)
2. A properly configured DHCP server responds with a DHCP offer that includes all the settings that the Rack PDU needs for network communication. The DHCP offer also includes the Vendor Specific Information option (DHCP option 43). The Rack PDU can be configured to ignore DHCP offers that do not
encapsulate the vendor cookie in DHCP option 43 using the following
hexadecimal format. (The Rack PDU does not require this cookie by default.)
Option 43 = 01 04 31 41 50 43
Where:
• The first byte (01) is the code. • The second byte (04) is the length.
• The remaining bytes (31 41 50 43) are the vendor cookie.
This section summarizes the Rack PDU’s communication with a DHCP server. For more detail about how a DHCP server can configure the network settings for a Rack PDU, see DHCP response options.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
Command Line Interface
1. Log on to the command line interface. See Logging on to the Command Line Interface.
2. Contact your network administrator to obtain the IP address, subnet mask, and default gateway for the Rack PDU.
3. Use these three commands to configure network settings. (Text in italics indicates a variable.)
a. tcpip -i yourIPaddress b. tcpip -s yourSubnetMask c. tcpip -g yourDefaultGateway
For each variable, type a numeric value that has the format xxx.xxx.xxx.xxx. For example, to set a system IP address of 156.205.14.141, type the following command and press ENTER:
tcpip -i 156.205.14.141
4. Type exit. The Rack PDU restarts to apply the changes.
Note: By selecting the Require vendor specific cookie to accept DHCP Address check box in the Web interface, you can require the
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
9Recovering from a Lost Password
You can use a local computer (a computer that connects to the Rack PDU or other device through the serial port) to access the command line interface.
1. Select a serial port at the local computer, and disable any service that uses that port.
2. Connect the provided serial cable to the selected port on the computer and to the Serial port at the Rack PDU.
3. Run a terminal program (such as HyperTerminal®) and configure the selected port for 9600 bps, 8 data bits, no parity, 1 stop bit, and no flow control.
4. Press ENTER, repeatedly if necessary, to display the User Name prompt. If you
are unable to display the User Name prompt, verify the following: – The serial port is not in use by another application.
– The terminal settings are correct as specified in step 3. – The correct cable is being used as specified in step 2.
5. Press the Reset button. The Status LED will flash alternately orange and green. Press the Reset button a second time immediately while the LED is flashing to reset the user name and password to their defaults temporarily.
6. Press ENTER, repeatedly if necessary, to display the User Name prompt again, then use, dell, for the user name and password. (If you take longer than 30 seconds to log on after the User Name prompt is redisplayed, you must repeat step 5 and log on again.)
7. At the command line interface, use the following commands to change the User Name and Password settings, both of which are now dell:
user -an yourAdministratorName user -ap yourAdministratorPassword
For example, to change the Administrator user name to Don Adams, type:
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
11Rack PDU Front Panel
Item Function
1 Dry contact inputs Connector for two dry contact devices. 2 Phase LEDs
Note: for single-phase Rack PDUs, only one LED is present.
When no alarms are present, the LED display shows a phase current, and a green Phase LED indicates for which phase. The system
automatically cycles through each phase, displaying the phase current for three seconds. If an alarm is present for one phase, the applicable Phase LED turns on and stays on while the alarm condition is present. The LED will illuminate orange for a Warning alarm or red for a Critical alarm. If an alarm is present for more than one phase, the system will automatically cycle through each phase with an alarm, illuminating the Phase LEDs for three seconds.
3 LED display Shows the phase current for the currently illuminated Phase LED.
pd
u05
36
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
4 Function button • To manually display the current for each phase, repeatedly press the button. The current displays for 30 seconds or until you press the button again. (This functionality is not available for single-phase Rack PDUs.)
• To display the IP address, press and hold for five seconds until IP appears; then release. On the LED display, the address will appear two digits at a time and then the cycle will repeat.
• To invert the display, press and hold for ten seconds until the AA pattern appears. Continue holding the button until AA is oriented as desired then release the button.
5 10/100 base-T connector Port for connecting the Rack PDU to the network.
6 10/100 LED See 10/100 LED.
7 Network status LED See Network Status LED.
8 Outlet status LED Illuminates green when the outlet is energized. (Each outlet has an outlet LED.)
9 Temp/humidity sensor port Port for connecting a Rack PDU Temperature Sensor (G853N) or a Rack PDU Temperature/ Humidity Sensor (H621N).
: RJ-45 serial port Port for connecting the Rack PDU to a terminal emulator program for local access to the command line interface. Use the supplied serial cable.
; Reset button To restart the interface of the Rack PDU without
affecting the outlets, press and release the Reset button.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
13Network Status LED
Condition Description
Off One of the following situations exists:
• The Rack PDU is not receiving input power.
• The Rack PDU is not operating properly. It may need to be repaired or replaced.
Solid Green The Rack PDU has valid TCP/IP settings.
Flashing Green The Rack PDU does not have valid TCP/IP settings. Solid Orange A hardware failure has been detected in the Rack PDU. Flashing Orange The Rack PDU is making BOOTP requests.
Flashing Orange and Green (alternating)
If the LED is flashing slowly, the Rack PDU is making DHCP requests.
If the LED is flashing rapidly, the Rack PDU is starting up. 1. If you do not use a BOOTP or DHCP server, see Establishing Network Settings to
configure the TCP/IP settings of the Rack PDU.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
10/100 LED
Condition DescriptionOff One or more of the following situations exists: • The Rack PDU is not receiving input power.
• The cable that connects the Rack PDU to the network is disconnected or defective.
• The device that connects the Rack PDU to the network is turned off.
• The Rack PDU itself is not operating properly. It may need to be repaired or replaced.
Solid green The Rack PDU is connected to a network operating at 10 Megabits per second (Mbps).
Solid orange The Rack PDU is connected to a network operating at 100 Mbps.
Flashing Green The Rack PDU is receiving or transmitting data packets at 10 Mbps.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
15Command Line Interface
About the Command Line Interface
You can use the command line interface to view the status of and manage the Rack PDU. In addition, the command line interface enables you to create scripts for
automated operation. An Administrator has full access to the command line interface, a Device user and Outlet user have limited access, and a Read-Only user is completely restricted. (For additional details, see Types of user accounts.)
You can configure all parameters of a Rack PDU (including those for which there are not specific CLI commands) by using the CLI to transfer an INI file to the Rack PDU. The CLI uses XMODEM to perform the transfer. However, you cannot read the current INI file through XMODEM.
Logging on to the Command Line Interface
To access the command line interface, you can use either a local (serial) connection or a remote (Telnet or SSH) connection with a computer on the same network as the Rack PDU.
Remote access to the command line interface
You can access the command line interface through Telnet or SSH. Telnet is enabled by default. Enabling SSH disables Telnet.
To enable or disable these access methods, use the Web interface. On the
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
Telnet for basic access. Telnet provides the basic security of authentication by user name and password, but not the high-security benefits of encryption.
To use Telnet to access the command line interface:
1. From a computer on the same network as the Rack PDU, at a command prompt, type telnet and the IP address for the Rack PDU (for example, telnet
139.225.6.133, when the Rack PDU uses the default Telnet port of 23), and
press ENTER.
If the Rack PDU uses a non-default port number (from 5000 to 32768), you must include a colon or a space, depending on your Telnet client, between the IP address (or DNS name) and the port number. (These are commands for general usage: some clients do not allow you to specify the port as an arguement and some may require extra commands.)
2. Enter the user name and password (by default, admin and admin for an Administrator, or device and device for a Device User).
SSH for high-security access. If you use the high security of SSL for the Web interface, use SSH for access to the command line interface. SSH encrypts user names, passwords, and transmitted data. The interface, user accounts, and user access rights are the same whether you access the command line interface through SSH or Telnet, but to use SSH, you must first configure SSH and have an SSH client program installed on your computer.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
17Local access to the command line interface
For local access, use a computer that connects to the Rack PDU through the serial port to access the command line interface:
1. Select a serial port at the computer and disable any service that uses that port. 2. Connect the supplied serial cable from the selected serial port on the computer to
the serial port on the Rack PDU.
3. Run a terminal program (e.g., HyperTerminal) and configure the selected port for 9600 bps, 8 data bits, no parity, 1 stop bit, and no flow control.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
About the Main Screen
Following is an example of the main screen, which is displayed when you log on to the command line interface of a Rack PDU:
Dell Corporation Network Management Card AOS vx.x.x (c)Copyright 2009 All Rights Reserved RPDUD PPPP vx.x.x Name : Test Lab Date : 10/30/2009 Contact : Don Adams Time : 5:58:30
Location : Building 3 User : Administrator Up Time : 0 Days, 21 Hours, 21 Minutes Stat : P+ N+ A+
cli>
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
19Main screen information fields:
• Two fields identify the operating system (AOS) and application (APP) firmware versions. The application firmware name identifies the type of device that connects to the network. In the preceding example, the application firmware for the Rack PDU is displayed.
Network Management Card AOS vx.x.x RPDUD vx.x.x
• Three fields identify the system name, contact person, and location of the Rack PDU. (In the control console, use the System menu to set these values.)
Name: Test Lab Contact: Don Adams Location: Building 3
• An Up Time field reports how long the Rack PDU has been running since it was last turned on or reset.
Up Time: 0 Days, 21 Hours, 21 Minutes
• Two fields identify when you logged in, by date and time.
Date: 10/30/2009 Time: 5:58:30
• A User field identifies whether you logged in through the Administrator or Device
user account. (The Read-Only User account cannot access the command line interface.)
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
• A Stat field reports the Rack PDU status.
Stat : P+ N+ A+
P+ The Dell operating system is functioning properly.
IPv4 only IPv6 only IPv4 and IPv6* Description
N+ N+ N4+N6+ The network is functioning properly. N? N6? N4?N6? A BOOTP request cycle is in progress.
N– N6– N4-N6- The Rack PDU failed to connect to the network. N! N6! N4!N6! Another device is using the Rack PDU IP address.
* The N4 and N6 values can be different from one another: you could, for example, have N4- N6+.
A+ The application is functioning properly. A– The application has a bad checksum. A? The application is initializing.
A! The application is not compatible with the AOS.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
21Using the Command Line Interface
At the command line interface, use commands to configure the Rack PDU. To use a command, type the command and press ENTER. Commands and arguments are valid in lowercase, uppercase, or mixed case. Options are case-sensitive.
While using the command line interface, you can also do the following:
• Type ? and press ENTER to view a list of available commands, based on your account type.
• To obtain information about the purpose and syntax of a specified command, type the command, a space, and ? or the word help. For example, to view RADIUS
configuration options, type:
radius ?
or
radius help
• Press the UP arrow key to view the command that was entered most recently in the session. Use the UP and DOWN arrow keys to scroll through a list of up to ten previous commands.
• Type at least one letter of a command and press the TAB key to scroll through a list of valid commands that match the text you typed in the command line.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
Command Syntax
Example of a command that supports multiple options:
user [-an <admin name>] [-ap <admin password>]
In this example, the user command accepts the option -an, which defines the Administrator user name, and the option -ap, which defines the Administrator password. To change the Administrator user name and password to XYZ: 1. Type the user command, one option, and the argument XYZ:
user -ap XYZ
2. After the first command succeeds, type the user command, the second option, and the argument XYZ:
user -an XYZ
Item Description
- Options are preceded by a hyphen.
< > Definitions of options are enclosed in angle brackets. For example:
-dp <device password>
[ ] If a command accepts multiple options or an option accepts mutually exclusive arguments, the values may be enclosed in brackets.
| A vertical line between items enclosed in brackets or angle
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
23Example of a command that accepts mutually exclusive arguments for an option:
alarmcount -p [all | warning | critical]
In this example, the option -p accepts only three arguments: all, warning, or critical. For example, to view the number of active critical alarms, type:
alarmcount -p critical
The command will fail if you type an argument that is not specified.
Command Response Codes
The command response codes enable scripted operations to detect error conditions reliably without having to match error message text:
The CLI reports all command operations with the following format: E [0-9] [0-9] [0-9] : Error Message
Code Message Code Message
E000 Success E105 Command Prefill
E001 Successfully Issued E106 Data not available E002 Reboot required for
change to take effect
E107 Serial communication with the Rack PDU has been lost
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
Network Management Card Command
Descriptions
?
Access: Administrator, Device User, Outlet User
Description: View a list of all the CLI commands available to your account type. To view help text for a specific command, type the command followed by a question mark.
Example: To view a list of options that are accepted by the alarmcount command, type:
alarmcount ?
about
Access: Administrator, Device User, Outlet User
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
25alarmcount
Access: Administrator, Device User, Outlet User
Description:
Example: To view all active warning alarms, type:
alarmcount -p warning
Option Arguments Description
-p all View the number of active alarms reported by the Rack PDU. Information about the alarms is provided in the event log. warning View the number of active warning alarms.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
boot
Access: Administrator only
Description: Define how the Rack PDU will obtain its network settings, including the IP address, subnet mask, and default gateway. Then configure the BOOTP or DHCP server settings.
Example: To use a DHCP server to obtain network settings: 1. Type boot -b dhcp
2. Enable the requirement that the DHCP server provide the vendor cookie:
boot -c enable
Option Argument Description -b
<boot mode>
dhcp | bootp | manual
Define how the TCP/IP settings will be configured when the Rack PDU turns on, resets, or restarts. See TCP/IP and Communication Settings for information about each boot mode setting.
-c enable | disable dhcp and dhcpBootp boot modes only. Enable or disable the requirement that the DHCP server provide the vendor cookie.
The default values for these three settings generally do not need to be changed: -v <vendor class>: DELL
-i <client id>: The MAC address of the Rack PDU, which uniquely identifies it on the network
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
27cd
Access: Administrator, Device User, Outlet User
Description: Navigate to a folder in the directory structure of the Rack PDU.
Example 1: To change to the ssh folder and confirm that an SSH security certificate was uploaded to the Rack PDU:
1. Type cd ssh and press ENTER.
2. Type dir and press ENTER to list the files stored in the SSH folder.
Example 2: To return to the main directory folder, type:
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
console
Access: Administrator only
Description: Define whether users can access the command line interface using Telnet, which is enabled by default, or Secure Shell (SSH), which provides protection by transmitting user names, passwords, and data in encrypted form. You can change the Telnet or SSH port setting for additional security. Alternately, disable network access to the command line interface.
Example 1: To enable SSH access to the command line interface, type:
console -S ssh
Example 2: To change the Telnet port to 5000, type:
console -pt 5000
Option Argument Description -S disable | telnet |
ssh
Configure access to the command line interface, or use the disable command to prevent access. Enabling SSH enables SCP and disables Telnet.
-pt <telnet port n> Define the Telnet port used to communicate with the Rack PDU (23 by default).
-ps <SSH port n> Define the SSH port used to communicate with the Rack PDU (22 by default).
-b 2400 | 9600 | 19200 | 38400
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
29date
Access: Administrator only
Definition: Configure the date used by the Rack PDU.
Example 1: To display the date using the format yyyy-mm-dd, type: date -f yyyy-mm-dd
Example 2: To define the date as October 30, 2009, using the format configured in the preceding example, type:
date -d “2009-10-30”
Example 3: To define the time as 5:21:03 p.m., type: date -t 17:21:03
To configure an NTP server to define the date and time for the Rack PDU, see Set the Date and Time.
Option Argument Description
-d <“datestring”> Configure the current date. Use the date format specified by the date -f command.
-t <00:00:00> Configure the current time, in hours, minutes, and seconds. Use the 24-hour clock format.
-f mm/dd/yy | dd.mm.yyyy | mmm-dd-yy | dd-mmm-yy | yyyy-mm-dd
Select the numerical format in which to display all dates in this user interface. Each letter m (for month), d (for day), and y (for year) represents one digit. Single-digit days and months are displayed with a leading zero.
-z <time zone offset>
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
delete
Access: Administrator only
Description: Delete a file in the file system.
dir
Access: Administrator, Device User, Outlet User
Description: View the files and folders stored on the Rack PDU.
Argument Description <file
name>
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
31dns
Access: Administrator only
Definition: Configure the manual Domain Name System (DNS) settings.
Parameter Argument Description -OM enable |
disable
Override the manual DNS. -p <primary DNS
server>
Set the primary DNS server. -s <secondary
DNS server>
Set the secondary DNS server. -d <domain
name>
Set the domain name. -n <domain
name IPv6>
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
eventlog
Access: Administrator, Device User, Outlet User
Description: View the date and time you retrieved the event log, the status of the Rack PDU, and the status of sensors connected to the Rack PDU. View the most recent device events and the date and time they occurred. Use the following keys to navigate the event log:
exit
Access: Administrator, Device User, Outlet User
Description: Exit from the command line interface session.
format
Access: Administrator only
Description: Reformat the file system of the Rack PDU and erase all security certificates, encryption keys, configuration settings, and the event and data logs.
Key Description
ESC Close the event log and return to the command line interface.
ENTER Update the log display. Use this command to view events that were recorded after you last retrieved and displayed the log.
SPACEBAR View the next page of the event log.
B View the preceding page of the event log. This command is not available at the main page of the event log.
D Delete the event log. Follow the prompts to confirm or deny the deletion. Deleted events cannot be retrieved.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
33FTP
Access: Administrator only
Description: Enable or disable access to the FTP server. Optionally, change the port setting to the number of any unused port from 5001 to 32768 for added security.
Example: To change the TCP/IP port to 5001, type:
ftp -p 5001
help
Access: Administrator, Device User, Outlet User
Description: View a list of all the CLI commands available to your account type. To view help text for a specific command, type the command followed by the help.
Example 1: To view a list of commands available to a Device User, type:
help
Example 2: To view a list of options that are accepted by the alarmcount command, type:
alarmcount help
Option Argument Definition -p <port
number>
Define the TCP/IP port that the FTP server uses to
communicate with the Rack PDU (21 by default). The FTP server uses both the specified port and the port one number lower than the specified port.
-S enable | disable
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
netstat
Access: Administrator, Device User, Outlet User
Description: View the status of the network and all active IPv4 and IPv6 addresses.
ntp
Access: Administrator
Definition: View and configure the network time protocol parameters.
Example 1: To enable the override of manual setting, type: ntp -OM enable
Example 2: To specify the primary NTP server, type:
ntp -p 150.250.6.10
Option Argument Definition -OM enable |
disable
Override the manual settings. -p <primary NTP
server>
Specify the primary server. -s <secondary
NTP server>
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
35ping
Access: Administrator, Device User
Description. Determine whether the device with the IP address or DNS name you specify is connected to the network. Four inquiries are sent to the address.
Example: To determine whether a device with an IP address of 150.250.6.10 is connected to the network, type:
ping 150.250.6.10
portSpeed
Access: Administrator
Description:
Example: To configure the TCP/IP port to communicate using 100 Mbps with half-duplex communication (communication in only one direction at a time), type:
portspeed -s 100H
Argument Description <IP address or DNS
name>
Type an IP address with the format xxx.xxx.xxx.xxx, or the DNS name configured by the DNS server.
Option Arguments Description -s auto | 10H |
10F | 100H | 100 F
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
prompt
Access: Administrator, Device User
Description: Configure the command line interface prompt to include or exclude the account type of the currently logged-in user. Any user can change this setting; all user accounts will be updated to use the new setting.
Example: To include the account type of the currently logged-in user in the command prompt, type:
prompt -s long
quit
Access: Administrator, Device User, Outlet User
Description: Exit from the command line interface session (this works the same as the exit command).
Option Argument Description
-s long The prompt includes the account type of the currently logged-in user.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
37radius
Access: Administrator only
Description: View the existing RADIUS settings, enable or disable RADIUS
authentication, and configure basic authentication parameters for up to two RADIUS servers.
For a summary of RADIUS server configuration and a list of supported RADIUS servers, see Configuring the RADIUS Server. Additional authentication parameters for RADIUS servers are available at the Web interface of the Rack PDU. See RADIUS for more information.
For detailed information about configuring your RADIUS server, see Appendix B: Security Handbook.
Option Argument Description -a local |
radiusLocal | radius
Configure RADIUS authentication:
local—RADIUS is disabled. Local authentication is enabled. radiusLocal—RADIUS, then Local Authentication.
RADIUS and local authentication are enabled. Authentication is requested from the RADIUS server first. If the RADIUS server fails to respond, local authentication is used.
radius—RADIUS is enabled. Local authentication is
disabled. -p1
-p2
<server IP> The server name or IP address of the primary or secondary RADIUS server.
NOTE: RADIUS servers use port 1812 by default to
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
Example 1:To view the existing RADIUS settings for the Rack PDU, type radius and press
ENTER.
Example 2: To enable RADIUS and local authentication, type:
radius -a radiusLocal
Example 3: To configure a 10-second timeout for a secondary RADIUS server, type:
radius -t2 10
reboot
Access: Administrator only
Description: Restart the interface of the Rack PDU.
-s1 -s2
<server secret>
The shared secret between the primary or secondary RADIUS server and the Rack PDU.
-t1 -t2
<server timeout>
The time in seconds that the Rack PDU waits for a response from the primary or secondary RADIUS server.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
39resetToDef
Access: Administrator only
Description:
Example: To reset all of the configuration changes except the TCP/IP settings for the Rack PDU, type:
resetToDef -p keepip
snmp, snmpv3
Access: Administrator only
Description: Enable or disable SNMP 1 or SNMP 3.
Example: To enable SNMP version 1, type:
snmp -S enable
Option Arguments Description
-p all | keepip Reset all configuration changes, including event actions, device settings, and, optionally, TCP/IP configuration settings.
Option Arguments Description -S enable |
disable
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
system
Access: Administrator only
Description: View and set the system name, the contact, the location and view up time as well as the date and time, the logged-on user, and the high-level system status P, N, A (see About the
Main Screen for more information about system status).
Example 1: To configure the device location as Test Lab, type:
system -l “Test Lab”
Example 2: To configure the system name as Don Adams, type:
system -n “Don Adams”
Option Argument Description -n <system
name>
Define the device name, the name of the person responsible for the device, and the physical location of the device.
NOTE: If you define a value with more than one word, you
must enclose the value in quotation marks. -c <system
contact> -l <system
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
41tcpip
Access: Administrator only
Description: View and manually configure these network settings for the Rack PDU:
Example 1: To view the network settings of the Rack PDU, type tcpip and press
ENTER.
Example 2: To manually configure an IP address of 150.250.6.10 for the Rack PDU, type:
tcpip -i 150.250.6.10
Option Argument Description
-i <IP address> Type the IP address of the Rack PDU, using the format xxx.xxx.xxx.xxx
-s <subnet mask> Type the subnet mask for the Rack PDU.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
tcpip6
Access: Administrator only
Description: Enable IPv6 and view and manually configure these network settings for the Rack PDU:
Example 1: To view the network settings of the Rack PDU, type tcpip6 and press
ENTER.
Example 2: To manually configure an IPv6 address of
2001:0:0:0:0:FFD3:0:57ab for the Rack PDU, type: tcpip -i 2001:0:0:0:0:FFD3:0:57ab
Option Argument Description
-S enable | disable Enable or disable IPv6.
-man enable | disable Enable manual addressing for the IPv6 address of the Rack PDU.
-auto enable | disable Enable the Rack PDU to automatically configure the IPv6 address.
-i <IPv6 address> Set the IPv6 address of the Rack PDU. -g <IPv6 gateway> Set the IPv6 address of the default gateway. -d6 router | stateful |
stateless | never
Set the DHCPv6 mode, with parameters of router
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
43user
Access: Administrator only
Description: Configure the user name, password, and inactivity timeout for the Administrator, Device User, and Read-Only User account types.
Example 1: To change the Administrator user name to XYZ, type:
user -an XYZ
Example 2: To change the log off time to 10 minutes, type:
user -t 10
For information on the permissions granted to each account type, see Types of user accounts.
Option Argument Description -an -dn -rn <admin name> <device name> <read-only name>
Set the case-sensitive user name for each account type. The maximum length is 10 characters.
-ap -dp -rp <admin password> <device password> <read-only password>
Set the case-sensitive password for each account type. The maximum length is 32 characters. Blank passwords (passwords with no characters) are not allowed.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
web
Access: Administrator only
Description: Enable access to the Web interface using HTTP or HTTPS.
For additional security, you can change the port setting for HTTP and HTTPS to any unused port from 5000 to 32768. Users must then use a colon (:) in the address field of the browser to specify the port number. For example, for a port number of 5000 and an IP address of 152.214.12.114, type:
http://152.214.12.114:5000
Example: To prevent all access to the Web interface, type:
web -S disable
Option Argument Definition -S disable | http |
https
Configure access to the Web interface. When HTTPS is enabled, data is encrypted during transmission and authenticated by digital certificate.
-ph <http port #> Define the TCP/IP port used by HTTP to communicate with the Rack PDU (80 by default).
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
45xferINI
Access: Administrator only
Description: Use XMODEM to upload an INI file while you are accessing the command line interface through a serial connection. After the upload completes:
• If there are any system or network changes, the command line interface restarts and you must log in again.
• If you selected a baud rate for the file transfer that is not the same as the default baud rate for the Rack PDU, you must reset the baud rate to the default to reestablish communication with the Rack PDU.
xferStatus
Access: Administrator only
Description: View the result of the last file transfer.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
Device Command Descriptions
devLowLoad
Access: Administrator, Device User
Description: Set or view the low-load threshold in Kilowatts for the device.
Example 1: To view the low-load threshold, type:
cli> devLowLoad E000: Success 0.5 kW
Example 2: To set the low-load threshold to 1 kW, type:
cli> devLowLoad 1.0 E000: Success
devNearOver
Access: Administrator, Device User
Description: Set or view the near-overload threshold in kilowatts for the device.
Example 1: To view the near-overload threshold, type:
cli> devNearOver E000: Success 20.5 kW
Example 2: To set the near-overload threshold to 21.3 kW, type:
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
47devOverLoad
Access: Administrator, Device User
Description: Set or view the overload threshold in kilowatts for the device.
Example 1: To view the overload threshold, type:
cli> devOverLoad E000: Success 25.0 kW
Example 2: To set the overload threshold to 25.5 kW, type:
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
devReading
Access: Administrator, Device User
Description: View the total power in kilowatts or total energy in kilowatt-hours for the device.
Example 1: To view the total power, type:
cli> devReading power E000: Success
5.2 kW
Example 2: To view the total energy, type:
cli> devReading energy E000: Success
200.1 kWh
Argument Definition
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
49devStartDly
Access: Administrator, Device User
Description: Set or view the amount of time (in seconds) to be added to each outlet’s Power On Delay after power is applied to the Rack PDU. Allowed values are within the range of 1 to 300 seconds or never (never turn on).
Example 1: To view the cold start delay, type:
cli> devStartDly E000: Success 5 seconds
Example 2: To set the cold start delay to six seconds, type:
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
humLow
Access: Administrator, Device User
Description: Set or view the low humidity threshold as a percent of the relative humidity.
Example 1: To view the low humidity threshold, type:
cli> humLow E000: Success 10 %RH
Example 2: To set the low humidity threshold, type:
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
51humMin
Access: Administrator, Device User
Description: Set or view the minimum humidity threshold as a percent of the relative humidity.
Example 1: To view the minimum humidity threshold, type:
cli> humMin E000: Success 6 %RH
Example 2: To set the minimum humidity threshold, type:
cli> humMin 8 E000: Success
humReading
Access: Administrator, Device User, Outlet User
Description: View the humidity value from the sensor.
Example: To view the humidity value, type:
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
inNormal
Access: Administrator, Device User
Description: View the normal state for each dry contact input.
Example: To view the normal state for each dry contact input, type:
cli> inNormal E000: Success 1: Open
2: Open
inReading
Access: Administrator, Device User
Description: View the current state of each dry contact input.
Example: To view the state of the dry contact inputs, type:
cli> inReading E000: Success 1: Open
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
53olAssignUsr
Access: AdministratorDescription: Assign control of outlets to an outlet user that exists in the local database.
Example 1: To assign a user named Bobby to outlets 3, 5 through 7, and 10, type:
cli> olAssignUsr 3,5-7,10 bobby E000: Success
Example 2: To assign a user named Billy to all outlets, type:
cli> olAssignUsr all billy E000: Success
Argument Description all All device outlets. <outlet
name>
The name configured for a specific outlet. (See olName.) <outlet#> A single number or a range of numbers separated with a
dash, or a comma-separated list of single outlet numbers and number ranges.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
olCancelCmd
Access: Administrator, Device User, and Outlet User, but only for outlets to which the user is assigned.
Description: Cancels all pending commands for an outlet or group of outlets.
Example: To cancel all commands for outlet 3, type:
cli> olCancelCmd 3 E000: Success
Argument Description all All device outlets. <outlet
name>
The name configured for a specific outlet. (See olName.) <outlet#> A single number or a range of numbers separated with a
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
55olDlyOff
Access: Administrator, Device User, and Outlet User, but only for outlets to which the user is assigned.
Description: Turns off an outlet or group of outlets after the Power Off Delay (see
olOff).
Example 1: To turn off outlets 3, 5 through 7, and 10, type:
cli> olDlyOff 3,5-7,10 E000: Success
Example 2: To turn off all outlets, type:
cli> olDlyOff all E000: Success
Argument Description all All device outlets. <outlet
name>
The name configured for a specific outlet. (See olName.) <outlet#> A single number or a range of numbers separated with a
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
olDlyOn
Access: Administrator, Device User, and Outlet User, but only for outlets to which the user is assigned.
Description: Turns on an outlet or group of outlets after the Power On Delay (see
olOnDelay).
Example 1: To turn on outlets 3, 5 through 7, and 10, type:
cli> olDlyOn 3,5-7,10 E000: Success
Example 2: To turn on an outlet with the configured name of Outlet1, type:
cli> olDlyOn outlet1 E000: Success
Argument Description all All device outlets. <outlet
name>
The name configured for a specific outlet. (See olName.) <outlet#> A single number or a range of numbers separated with a
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
57olDlyReboot
Access: Administrator, Device User, and Outlet User, but only for outlets to which the user is assigned.
Description: Cycles power to an outlet or a group of outlets. The specified outlets will be turned off based on the configured Power Off Delay (see olOffDelay). After the longest Reboot Duration (see olRbootTime) of the selected outlets, the outlets will then begin to turn on based on the configured Power On Delays (see olOnDelay) set for the specified outlets.
Example 1: To cycle power to outlets 3, 5 through 7, and 10, type:
cli> olDlyReboot 3,5-7,10 E000: Success
Example 2: To cycle power to an outlet with the configured name of Outlet1, type:
cli> olDlyReboot outlet1 E000: Success
Argument Description all All device outlets. <outlet
name>
The name configured for a specific outlet. (See olName.) <outlet#> A single number or a range of numbers separated with a
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
olGroups
Access: Administrator, Device User, and Outlet User.
Description: List the outlet synchronization groups defined on the rack PDU. (see
Configure and Control Outlet Groups for more information.)
Example: To list outlets synchronization groups, type:
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
59olLowLoad
Access: Administrator, Device User, and Outlet User, but only for outlets to which the user is assigned.
Description: Set or view the outlet low load warning threshold.
Example 1: To set the low load threshold to 2 watts for all outlets, type:
cli> olLowLoad all 2 E000: Success
Example 2: To view the low load threshold for outlets 3 and 5 through 7, type:
cli> olLowLoad 3,5-7 E000: Success 3: BobbysServer: 2 W 5: BillysServer: 2 W 6: JoesServer: 2 W 7: JacksServer: 2 W Argument Description all All device outlets. <outlet
name>
The name configured for a specific outlet. (See olName.) <outlet#> A single number or a range of numbers separated with a
dash, or a comma-separated list of single outlet numbers and number ranges.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
olName
Access: Administrator, Device User, and Outlet User, but only for outlets to which the user is assigned.
Description: Set or view the name configured for an outlet.
Example: To configure the name for outlet 3 to BobbysServer, type:
cli> olName 3 BobbysServer E000: Success 3: BobbysServer 5: BillysServer 6: JoesServer 7: JacksServer Argument Description all All device outlets.
<outlet#> A single number or a range of numbers separated with a dash, or a comma-separated list of single outlet numbers and number ranges.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
61olNearOver
Access: Administrator, Device User, and Outlet User, but only for outlets to which the user is assigned.
Description: Set or view the outlet near overload warning threshold.
Example 1: To view the near overload threshold for outlets 3 and 5 through 7, type:
cli> olNearOver 3,5-7 E000: Success 3: BobbysServer: 5 W 5: BillysServer: 6 W 6: JoesServer: 5 W 7: JacksServer: 4 W
Example 2: To set the near overload threshold for outlets 3 and 5 through 7 to six watts, type:
cli> olNearOver 3,5-7 6 E000: Success 3: BobbysServer: 6 W 5: BillysServer: 6 W 6: JoesServer: 6 W 7: JacksServer: 6 W Argument Description all All device outlets. <outlet
name>
The name configured for a specific outlet. (See olName.) <outlet#> A single number or a range of numbers separated with a
dash, or a comma-separated list of single outlet numbers and number ranges.
USER’S GUIDE
Ma
na
ge
d R
a
ck
PD
U
olOff
Access: Administrator, Device User, and Outlet User, but only for outlets to which the user is assigned.
Description: Turn off an outlet or group of outlets without any delay.
Example 1: To turn off outlets 3 and 5 through 7, type:
cli> olOff 3,5-7 E000: Success
Argument Description all All device outlets. <outlet
name>
The name configured for a specific outlet. (See olName.) <outlet#> A single number or a range of numbers separated with a