Rack Power Distribution Units and In-Line
Current Meters
User Guide
AP7XXXB
990-5848C-001
Publication Date: 11/2021
Page 2
Schneider Electric Legal Disclaimer
The information presented in this manual is not warranted by the Schneider Electric to
be authoritative, error free, or complete. This publication is not meant to be a substitute
for a detailed operational and site specific development plan. Therefore, Schneider
Electric assumes no liability for damages, violations of codes, improper installation,
system failures, or any other problems that could arise based on the use of this
Publication.
The information contained in this Publication is provided as is and has been prepared
solely for the purpose of evaluating data center design and construction. This
Publication has been compiled in good faith by Schneider Electric. However, no
representation is made or warranty given, either express or implied, as to the
completeness or accuracy of the information this Publication contains.
IN NO EVENT SHALL SCHNEIDER ELECTRIC, O
SUBSIDIARY COMPANY OF SCHNEIDER ELECTRIC OR THEIR RESPECTIVE
OFFICERS, DIRECTORS, OR EMPLOYEES BE LIABLE FOR ANY DIRECT,
INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL, OR INCIDENTAL DAMAGES
(INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS,
CONTRACT, REVENUE, DATA, INFORMATION, OR BUSINESS INTERRUPTION)
RESULTING FROM
INABILITY TO USE THIS PUBLICATION OR THE CONTENT, EVEN IF SCHNEIDER
ELECTRIC HAS BEEN EXPRESSLY ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES. SCHNEIDER ELECTRIC RESERVES THE RIGHT TO MAKE
CHANGES OR UPDATES WITH RESPECT TO OR IN THE CONTENT OF THE
PUBLICATION OR THE FORMAT THEREOF AT ANY TIME WITHOUT NOTICE.
Copyright, intellectual, and all other proprietary rights in the content (including but not
limited to software, audio, video, text, and photographs) rests with Schneider Electric
or its licensors. All rights in the content not expressly granted herein are reserved. No
rights of any kind are licensed or assigned or shall otherwise pass to persons
accessing this information.
This Publication shall not be for resale in whole or in part.
, ARISING OUT, OR IN CONNECTION WITH THE USE OF, OR
R ANY PARENT, AFFILIATE OR
Page 3
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Introduction
The AP7XXXB Series covered in this manual includes the following equipment:
AP78XXB Metered Rack PDU
AP79XXB Switched Rack PDU
AP71XXB In-Line Current Meter
NOTE: Depending on the features of your device, some of the information in this manual will not
apply.
The APC Rack PDU and In-Line Current Meter provides real-time remote monitoring of connected
loads. User-defined alarms warn of potential circuit overloads.
You can manage a Rack PDU or In-Line Current Meter through its Web User Interface (UI), its
Command Line Interface (CLI), Data Center Expert, or Simple Network Management Protocol
(SNMP). (To use the PowerNet M
Management Information Base (MIB) Reference Guide, available at www.apc.com.) The devices
have these additional features:
Phase current, peak current
•
• Bank current and peak current (for models that support breaker banks).
• Configurable alarm thresholds that provide network and visual alarms to help avoid overloaded
circuits.
IB with an SNMP browser, see the PowerNet SNMP
• Various levels of access: Super User, Administrator, Device User, Read-Only, Outlet User, and
Network-Only User (These are protected by user name and password requirements).
• Multiple user login
•
Individual outlet control (AP79XXB Switched only).
• Configurable power delays (AP79XXB Switched only).
• 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/
TLS, or using HTTP access). The data log is accessible by Web browser, SCP, or FTP.
E-mail notifications for device and Network Management Card (NMC) system events.
•
• SNMP traps, Syslog messages, and e-mail notifications based on the severity level or category
of the device and NMC system event.
• Security protocols for authentication and encryption.
• Cisco EnergyWise certified (Rack PDUs with NMC2s, firmware v6.x.x or later).
feature which allows up to four users to be logged in simultaneously.
NOTE: The device does not provide power surge protection. To ensure that the device is
protected from power failure or power surges, connect the device to a Schneider Electric
Uninterruptible Power Supply (UPS).
990-5848C-0017
Page 10
Rack PDU and In-Line Current Meter AP7XXXB User Guide
About Network Management Cards
A Network Management Card (NMC) is a piece of hardware that allows products to operate on a
network. There are two generations of NMC: NMC2 and NMC3. Rack PDUs with an NMC2 have
firmware v6.x.x or later. Rack PDUS wtih an NMC3 have firmware v1.x.x.1 or later.
At the time of this publication, the latest Security Handbook for devices with an NMC2 is
990-4910E, and the latest Security Handbook
find security handbooks and other documents for your Rack PDU on www.apc.com.
for devices with an NMC3 is 990-91251D. You can
Types of User Accounts
The device has various levels of access (Super User, Administrator, Device User, Read-Only User,
Outlet User, and Network-Only User), which are protected by user name and password
requirements. Up to four users are allowed to login to the same device simultaneously (available in
AOS version 6.1.3 or later).
NOTE: You will be prompted to enter a new password the first time you connect to the RPDU with
the Super User account. The Administrator, Device User, Read-Only User, and Network-Only user
accounts are disabled by default, and cannot be enabled until the Super User default password
is changed.
(apc)
• An Administrator or the Super User can use all of the menus in the UI and all of the
commands in the CLI. Administrator user types can be deleted, but the Super User cannot be
deleted.
The default user name and password for the Super User are both apc.
- The Super User or A
disable, change password, etc).
• A Device User has read and write access to device-related screens. Administrative functions
like session management under the Security menu and Firewall under Logs appear grayed
out.
A Read-Only User has the following restricted access:
•
- Access to the same 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.
An Outlet User has the following restricted access:
•
- Access through the Web User 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 only 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.
A Network-Only User (remote user) can only log on using the Web UI and CLI (Telnet or
•
SSH). A user with network-only access has read/write permission to the network related
menus only.
dministrator can manage another Administrator's account (enable,
8990-5848C-001
Page 11
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Watchdog Features
Overview
To detect internal problems and recover from unanticipated inputs, the device uses internal,
system-wide watchdog mechanisms. When it restarts to recover from an internal problem, a
Network Interface Restarted event is recorded in the event log.
Network interface watchdog mechanism
The device implements internal watchdog mechanisms to protect itself from becoming
inaccessible over the network. For example, if the device does not receive any network traffic for
9.5 minutes (either direct traffic, such as SNMP, or broadcast traffic, such as an Address
Resolution Protocol [ARP] request), it assumes that there is a problem with its network interface
and restarts. The network interface watchdog mechanism is only enabled on a device that
discovers an active network interface connection at start-up.
Resetting the network timer
To ensure that the device does not restart if the network is quiet for 9.5 minutes, the device
attempts to contact the default gateway every 4.5 minutes. If the gateway is present, it responds to
the device and the response restarts the 9.5-minute timer. If your application does not require or
have a gateway, specify the IP address of a computer that is running on the network and is on the
same subnet. The network traffic of that computer will restart the 9.5-minute time frequently
enough to prevent the device from restarting.
EnergyWise
A device with an NMC2 (firmware v6.x.x or later) can become a Cisco EnergyWise Entity. This
entity reports power usage and alarms in the EnergyWise Domain.
To exercise this capability, plug the device network port into a Cisco switch/router that supports the
EnergyWise Domain. Log into the Web User Interface of the device and navigate to the
Configuration/R
The task will generate unique parent and children names, default roles, keywords and importance
values that comply with EnergyWise requirements. Customization of the aforementioned is
supported by clicking on any of the underlined entities to navigate to a configuration web page.
The EnergyWise port, domain name and shared secret may also be modified, but must be
coordinated with the same parameters in the Cisco gear.
The device implementation supports a single parent, multiple children hierarchy. The parent may
exist as a standalone device. The parent usage reports the power consumed by the devices
themselves. The children report either inlet power or, in the case of monitored outlets, the power
consumed at the outlet. Both parent and children report a usage level (0-10 scale). The parent and
let usage are always reported as 10 or “On”. In the case of switched outlets the actual state of
in
the switch is reported and may also be altered by the Cisco device.
The remaining configurable items are string variables that may be modified as needed and are
retained across power cycles or reboots.
For more information see: www.cisco.com/en/us/products/ps10195/index.html.
PDU/EnergyWise web page. Click on the enable radio button to initiate the task.
NOTE: Rack PDUs with NMC3s (firmware v1.x.x.1 or later) can not become Cisco EnergyWise
Entities.
990-5848C-0019
Page 12
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Getting Started
To start using the device:
1. Install the device using the Installation Instructions that were shipped with your product.
2. Apply power and connect to your network. Follow the directions in the Installation Instructions.
3. Establish network settings
4. Begin using the device by way of one of the following:
- “Web User Interface” on page 82
- “Command Line Interface” on page 17
- “Device Display Pan
els” on page 1
Establish Network Settings
IPv4 initial setup
You must define three TCP/IP settings for the device before it can operate on the network:
• The IP address of the device
• The subnet mask of the device
• The IP address of the default gateway (only needed if you are going off segment)
NOTE: Do NOT use the loopback address (127.0.0.1) as the default gateway. Doing so disables
the Network Management Card. To enable again, you must log on using a serial connection and
reset the TCP/IP settings to their defaults.
For detailed information on how to use a DHCP server to configure the TCP/IP settings,
HCP response options” on page 112
see.“D
IPv6 initial setup
IPv6 network configuration provides flexibility to accommodate your requirements. IPv6 can be
used anywhere an IP address is entered on this interface. You can configure manually,
automatically, or using DHCP.
4
TCP/IP configuration methods
Use one of the following methods to define the TCP/IP settings needed by the device:
• “Device IP Configuration Wizard” on page 139
• “DHCP and BOOTP configuration”
• “Command Line Interface” on page 17
.ini file utility
You can use the .ini file export utility to export .ini file settings from configured units to one or more
unconfigured units. For more information, see “C
on page 128.
10990-5848C-001
reating and importing settings with the config file”
Page 13
Rack PDU and In-Line Current Meter AP7XXXB User Guide
DHCP and BOOTP configuration
The default TCP/IP configuration setting, DHCP, assumes that a properly configured DHCP server
is available to provide TCP/IP settings to Rack PDU. 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 “Creating and importing settings with the config file” on page 128.
If neither of these servers is available, see “D
evice IP Configuration Wizard” on page 139.
BOOTP: For the product to use a BOOTP server to configure its TCP/IP settings, it must find a
In the BOOTPTAB file of the BOOTP server, enter the product’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 product or on the Quality Assurance slip included in the package.
When the unit reboots, the BOOTP
• If you specified a bootup file name, the unit attempts to transfer that file from the BOOTP
server using TFTP or FTP. The unit 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 unit
remotely through its “W
page 17; the user name and password are both apc, by default. To create a bootup file, see
your BOOTP server documentation.
eb User Interface” on page 82 or “Command Line Interface” on
server provides it with the TCP/IP settings.
DHCP: You can use an RFC2131/RFC2132-compliant DHCP server to configure the TCP/IP
settings for your device. This section summarizes the unit’s communication with a DHCP server.
For more detail about how a DHCP server can configure the network settings for your device, see
“DHCP response options” on page 1
1. The device sends out a DHCP request that uses the following to identify itself:
- A Vendor Class Identifier (APC by default)
12.
- A Client Identifier (by default, the MAC address of the device)
- A User Class Identifier (by default, the identification of the application firmware installed on
the device)
- A Host Name (by default, apcXXYYZZ with XXYYZZ being the last six digits of the de
SKU). This is known as DHCP Option 12.
2. A properly configured DHCP server responds with a DHCP offer that includes all the settings
that the product needs for network communication. The DHCP offer also includes the Vendor
Specific Information option (DHCP option 43). The product can be configured to ignore DHCP
offers that do not encapsulate the APC cookie in DHCP option 43 using the following
hexadecimal format. (The product does not require this cookie by default.)
Option 43 = 01 04 31 41 50 43
Where:
- The first byte (01)
- The second byte (04) is the length.
- The remaining bytes (31 41 50 43) are the APC cookie.
See your DHCP server documentation to add code to the Vendor Specific Information option.
is the code.
vice
NOTE: By selecting the Require vendor specific cookie to accept DHCP Address check
box in the Web User Interface, you can require the DHCP server to provide an “APC” cookie,
which supplies information to the device.
990-5848C-00111
Page 14
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Network Management with Other Applications
These applications and utilities work with a device (Rack PDU or In-Line Current Meter) which is
connected to the network.
• PowerNet
®
Management Information Base (MIB) with a standard MIB browser — Perform
SNMP SETs and GETs and use SNMP traps
• Data Center Expert — Provide enterprise-level power management and management of
agents, environmental monitors, and Rack PDUs or In-Line Current Meters.
• EcoStruxure IT — Provide cloud-based monitoring of your Rack PDU or In-Line Current Meter
via SNMP.
• Device IP Configuration Utility — Configure the basic settings of one or more devices (Rack
PDU or In-Line Current Meter) over the network, see “Device IP Configuration Utility”
• Security Wizard — Create components needed to help with security for the units when you are
using Secure Sockets Layer (SSL/TLS) or Transport Layer Security (TLS) and related
protocols and encryption routines.
Command Line Interface (CLI)
1. Log on to the CLI. See “Log on to the CLI” on page 17.
2. Contact your network administrator to obtain the IP address, subnet mask, and default
gateway for the product.
3. Use these three commands to configure network settings. (Text in italics indicates a variable.)
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 E
NTER:
tcpip -i 156.205.14.141
4. Type exit. The unit restarts to apply the changes.
12990-5848C-001
Page 15
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Recovering from a Lost Password
Resetting a Rack PDU/In-Line Current Meter will reset the unit to its default configuration. You
should export the .ini file after configuring your Rack PDU and keep it in a safe place. If you have
this file saved, you will be able to retrieve your configuration after a lost password event.
NMC2 (firmware v6.x.x or later)
You can use a local computer (a computer that connects to the 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 serial cable (Schneider Electric part number 940-0144A) to the selected port on
the computer and to the Serial port on the device.
3. Run a terminal program (such as Tera Term
port for 9600 bps, 8 data bits, no parity, 1 stop bit, and no flow control.
®
or HyperTerminal®) and configure the selected
4. Press
5. Press the Reset button. The Status LED will flash alternately orange and green within 5 to 7
6. Press
7. At the Command Line Interface, use the following commands to change the Password
. Type quit or exit to log off, reconnect any serial cable you disconnected, and restart any
8
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.
seconds of pressing the Reset button. Press the Reset button a second time immediately
when the LED begins flashing to reset the user name and password to their defaults
temporarily.
ENTER, repeatedly if necessary, to display the User Name prompt again, then use the
default, apc, for the user name and password. (If you take longer than 30 seconds to log on
after the User Name prompt is re-displayed, you must repeat step 5 and log on again.)
setting, which is apc at this stage:
user -n <user name> -p
For example, to change the Super User password to XYZ type:
user -n apc -cp apc -pw XYZ
service you disabled.
w <user password>
NMC3 (firmware v1.x.x.1 or later)
You can use any secure interface to complete the recovery process. This includes the local CLI by
serial connection, remote CLI by SSH, or Web by HTTPS, all of which are covered in this manual.
1. Hold down the Reset button for 20-25 seconds, ensuring the Status LED is pulsing green
during this time. When the Status LED changes to orange, release the Reset button to allow
the Rack PDU to complete its reboot process.
2. Access the device through one of the secure interfaces to set your custom password and
configure the device. After resetting the device to defaults, the first log in can be completed
with the default user name (a
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Device Display Panels
Press a nd hold
to invert display
- OK
- Warni n
- Over load
Press a nd hold
to invert display
Link - Rx/Tx
Serial Port
Link - Rx/Tx
- OK
- Overload
L1
- Warni n
- Over load
Press a nd hold
to invert display
select line.
Press and hold
to inve rt display.
- OK
L3L2
Serial Port
Link - Rx/Tx
Serial Port
Link - Rx/Tx
P7850B
P7950B
- OK
- Overload
Am
select line.
Press and hold
to inve rt display.
Link - Rx/Tx
s
Serial Port
14990-5848C-001
Page 17
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Display Panel Description
ItemFunction
Load Indicator LEDsIndicates the status of the device load.
Input Selector
Main Menu button
10/100 Base-T ConnectorConnects the device to the network.
Network status LEDSee “N
10/100 LEDSee “10/100 LED” on page 16.
RJ-12 Serial Port
Display
On 3-phase models, press the input selector to monitor the
current of the next phase or bank. For banked models, press the
input selector to monitor the current of the next bank. For either
1- or 3-phase units, press and hold the input selector to display
the IP address of the device or to invert the display. After five
seconds, the IP address is displayed; after ten seconds, the
displayed numbers invert.
Press to view the device electrical input.
etwork Status LED” on page 15.
Port for connecting the device to a terminal emulator program
for local access to the Command Line Interface. Use the
supplied serial cable (Schneider Electric part number
940-0144A).
Displays the current (amps) for the phase or bank indicated by
the illuminated Load Indicator LED. On 3-phase models, the
Digital Display will cycle through the phases or banks,
displaying the current for each phase or bank for 3 seconds. If
an internal communication failure occurs (for either a 1- or 3phase model), the Digital Display displays E
clear by pressing the input selector.
r, which you can
Reset button
Network Status LED
ConditionDescription
Off
Solid GreenThe device has valid TCP/IP settings.
Solid Orange
Flashing GreenThe device does not have valid
Flashing OrangeThe device is making BOOTP requests.
Alternately flashing green
and orange
1. If you do not use a BOOTP or DHCP server, see “Establish Network Settings”
TCP/IP settings of the device.
2. To use a DHCP server, see “TCP/IP and Communication Settings” on page 112.
Resets the management interface without affecting the outlet
status.
One of the following situations exists:
• The device is not receiving input power.
• The device is not operating properly. It may need to be repaired or
replaced. Contact Customer Support.
A hardware failure has been detected in the device. Contact Customer
Support.
TCP/IP settings.
2
If the LED is flashing slowly, the device is making DHCP
If the LED is flashing rapidly, the device is starting up.
on page 10 to configure the
requests1.
990-5848C-00115
Page 18
Rack PDU and In-Line Current Meter AP7XXXB User Guide
10/100 LED
ConditionDescription
One or more of the following situations exists:
• The device is not receiving input power.
• The cable that connects the device to the network is disconnected or
Off
defective
• The device that connects the device to the network is turned off.
• The device itself is not operating properly. It may need to be repaired or
replaced. Contact Customer Support.
Solid green
Solid orangeThe device is connected to a network operating at 100 Mbps.
Flashing green
Flashing orange
Load indicator LED
The load indicator LED identifies overload and warning conditions for the device.
ConditionDescription
Solid GreenOK. No overload (critical) or near overload (warning) alarms are present.
Solid Yellow
Flashing RedOverload. At least one overload critical alarm is present.
The device is connected to a network operating at 10 Megabits per second
(Mbps).
The device is receiving or transmitting data packets at 10 Mbps
(NMC2, firmware v6.x.x or later).
NMC2 (firmware v6.x.x or later): The device is receiving or transmitting data packets at
100 Mbps.
NMC3 (firmware v1.x.x.1 or later): The Rack PDU is receiving or transmitting data
packets at 10 Mbps or 100 Mbps.
Warning. At least one near overload warning alarm is present, but no overload
critical alarms are present.
16990-5848C-001
Page 19
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Command Line Interface
About the Command Line Interface (CLI)
NOTE: Depending on the features of your device, some of the CLI commands will not
apply.
You can use the Command Line Interface to view the status of and configure and manage the
device. In addition, the Command Line Interface enables you to create scripts for automated
operation. You can configure all parameters of a device (including those for which there are not
specific CLI commands) by using the CLI to transfer an INI file to the device. The CLI uses
XMODEM to perform the transfer, however, you cannot read the current INI file through XMODEM.
Log on to the CLI
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 device.
Local access to the Command Line Interface
For local access, use a computer that connects to the device 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 serial cable (Schneider Electric part number 940-0144A) from the selected serial
port on the computer to the Serial port on the Rack PDU.
3. Run a terminal program (e.g., Tera Term or HyperTerminal) and configure the selected port for
9600 bps, 8 data bits, no parity, 1 stop bit, and no flow control.
ENTER. It may take multiple (up to three) attempts to get a prompt to appear. At the prompt,
Press
enter your user name and password (by default, apc and apc for the Super User). If this is your
first log on, you will be prompted to change the default password.
990-5848C-00117
Page 20
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Remote access to the Command Line Interface
You can choose to access the Command Line Interface remotely through Telnet and/or SSH. SSH
is enabled by default. You can use the console command (page 31) to enable or disable either
Telnet or SSH.
If needed, you can also use the Web UI to enable or disable either Telnet or SSH. On the
Configuration tab, select Network from the menu to open the Console Access page. Click to
check the desired Enable box. Click Apply to save your changes or C
ancel to leave the page.
Telnet for basic access: Telnet provides the basic security of authentication by user name and
password, but not the high-security benefits of encryption. Telnet is disabled by default.
To use Telnet to access the Command Line Interface:
1. From a computer that has access to the network on which the device is installed, at a
command prompt, type telnet
139.225.6.133, when the device uses the default Telnet port of 23), and press
If the device 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 argument and some types of Linux might want extra commands).
2. Enter the user name and password (by default, apc and apc for the Super User).
If you cannot remember your user name or password, see “R
Password” on page 13.
and the IP address for the device (for example, telnet
ENTER.
ecovering from a Lost
SSH for high-security access: If you use the high security of SSL/TLS for the Web User
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. SSH is
enabled by default.
18990-5848C-001
Page 21
Rack PDU and In-Line Current Meter AP7XXXB User Guide
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 device.
Schneider Electric Network Management Card AOS
(c) Copyright 2022 All Rights ReservedRPDU 2g APPvx.x.x
----------------------------------------------------------------------------Name: Test LabDate : 1/26/22
Contact: Don AdamsTime : 5:58:30
Location: Building 3User : Administrator
Up Time: 0 Days 21 Hours 21 MinutesStat
Type ? For command listing
Use tcpip for IP address (-i), subnet (-s), and gateway (-g)
apc>
• 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
example above, the application firmware for the device is displayed.
Network Management Card AOSvx.x.x
RPDU 2g vx.x.x
• Three fields identify the system name, contact person, and location of the device.
Name : Test Lab
Contact : Don Adams
Location : Building 3
990-5848C-00119
Page 22
Rack PDU and In-Line Current Meter AP7XXXB User Guide
• An Up Time field reports how long the Management Interface 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: 1/26/22
Time: 5:58:30
• The User field identifies whether you logged in through the Super User, Administrator or
Device Manager account.
User: Administrator
• A Stat field reports the Rack PDU status.
Stat:P+ N4+ N6+ A+
P+ The APC operating system (AOS) is functioning properly.
IPv4
only
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+T
A–The application has a bad checksum.
A?The application is initializing.
A!The application is not compatible with the AOS.
NOTE: If P+ is not displayed, contact the Schneider Electric Customer Care Center at
www.apc.com.
The remaining fields show which protocols and user accounts are enabled.
•
IPv6
only
IPv4 and
IPv6*
he application is functioning properly.
Description
20990-5848C-001
Page 23
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Using the CLI
At the Command Line Interface, you can use commands to configure the device. 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
• 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
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
commands that match the text you typed in the command line.
• Type exit or quit to close the connection to the Command Line Interface.
UP arrow key to view the command that was entered most recently in the session.
ENTER to view a list of available commands, based on your account type.
TAB key to scroll through a list of valid
990-5848C-00121
Page 24
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Command Syntax
ItemDescription
-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 brackets
indicates that the items are mutually exclusive. You must use one of the
items.
Example of a command that supports multiple options:
ftp [-p <port number>] [-S <enable | disable>]
In this example, the ftp command accepts the option -p, which defines the port number, and the
option -S, which enables or disables the FTP feature.
To change the FTP port number to 5010, and enable FTP:
1. Type the ftp command, the port option, and the argument 5010:
ftp -p 5010
2. After the first command succeeds, type the ftp command, the enable/disable option, and the
enable s
ftp -S enable
election:
Example 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.
22990-5848C-001
Page 25
Rack PDU and In-Line Current Meter AP7XXXB User Guide
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
CodeMessageCodeMessage
E000SuccessE200Input Error
E001Successfully IssuedE201No ResponseE002Reboot required for change to take effectE202User already exists
E100C
E101Command not foundE204
E102Parameter ErrorE205Exceeds Maximum Users
E103Command Line ErrorE206Invalid value
E104User Level DenialE207
E105Command PrefillE208
E106Data Not AvailableE209
E107
E108
ommand failedE203User does not exist
User does not have access to this
command
Outlet Command Error: Device not
initialized.
Outlet Command Error: Previous
command is pending.
Outlet Command Error: Database rejected
request.
Serial communication with the
has been lost
PDU
EAPoL disabled due to invalid/encrypted
certificate.
Rack
E210Outlet Command Error: Outlet restricted.
990-5848C-00123
Page 26
Rack PDU and In-Line Current Meter AP7XXXB User Guide
CLI Commands for Rack PDUs by SKU/type
AP71XXB: InLine Current Meter
AP78XXB: Metered Rack PDU (horizontal)
AP79XXB: Switched Rack PDU (horizontal)
AP88XX: Metered Rack PDU (vertical)
APF88XX Configurable Metered Rack PDU
AP86XX: MBO with Switching (vertical)
APF86XX: Configurable MBO with Switching
AP84XX: MBO Rack PDU (vertical)
APF84XX: Configurable MBO Rack PDU
AP89XX: Switched Rack PDU
APF89XX: Configurable Switched Rack PDU
CommandDescription
alarmListDisplay the alarms that are present on the device or another device in a
Network Port Sharing group.
bkLowLoadSet or read the bank low load threshold.xxxxxx
bkNearOverSet or read the bank near overload threshold.xxxxxx
bkOverLoadSet or read the bank overload thresholdxxxxxx
bkPeakCurrRead the bank peak current.xxxxxx
bkReadingDisplays a reading/measurement from a bank(s).xxxxxx
bkRestrictnSet or read the overload restriction feature to prevent outlets from
turning on when the overload alarm threshold is violated.
devLowLoadSet or read the device low load warning threshold.xxxx
devNearOverSet or read the device near overload threshold.xxxx
devOverLoadSet or read the device overload threshold.xxxx
devPeakLoadDisplay the device peak load.xxxx
devReadingDisplays the total power or energy the device is drawing.xxxx
devStartDlySet or read the device cold start delay.xxx
dispIDSet or read the Display ID.xxxx
energyWiseConfiguration Optionsxxxxxxx
humAlGenSet or read whether humidity alarms are enabled or disabled.xxxx
humHystSet or read the humidity hysteresis value.xxxx
humLowSet or read the low humidity threshold.xxxx
humMinSet or read the minimum humidity threshold.xxxx
humReadingDisplay the humidity reading from the sensor.xxxx
lcdControl the LCD Display.xxxx
lcdBlinkBlink the LCD Display.xxxx
logToFlashBackup log files to USB flash.xxxx
olAssignUsrAssign outlets to a user that exists in the local database.xxxx
olCancelCmdCancel all pending commands for an outlet or group of outlets.xxx
olDlyOffTurns off an outlet or group of outlets after power off delay.xxx
olDlyOnTurns on an outlet or group of outlets after power on delay.xxx
olDlyRebootDelayed Cycle power to an outlet or a group of outlets.xxx
olGroupsList the outlet synchronization groups defined on the switched rack
PDU.
olLowLoadSet or view the outlet low-load threshold in kilowatts.xx
xxxxxxx
xxx
xxx
24990-5848C-001
Page 27
Rack PDU and In-Line Current Meter AP7XXXB User Guide
CommandDescription
olNameSet or display a name assigned to an outlet.x xxx
olNearOverSet or view the outlet near-overload threshold in kilowatts.xx
olOffTurn an outlet or group of outlets off.xxx
olOffDelaySet or read the power off delay time.xxx
olOnTurn an outlet or group of outlets on.xxx
olOnDelaySet or read the power on delay time.xxx
olOverLoadSet or view the outlet overload threshold in kilowatts.xx
olPeakLoadDisplay the peak current measurement from a bank(s).xx
olRbootTimeSet or read the outlet reboot duration time.xxx
olReadingDisplays a reading/measurement from an outlet or a group of outlets.xx
olRebootCycles power to an outlet or group of outlets.xxx
olStatusDisplay the status of selected outlets.xxx
olTypeDisplays the type and rating of selected outlets.xxx
olUnasgnUsrUnassign outlets to a user that exists in the local database.xxxx
phBal*Set or read the phase load balance threshold.xxxx
phBalAlGen*Set or read whether phase load balance alarms are enabled or
disabled.
phLowLoadSet or read the phase low load threshold.xxxxxxx
phNearOverSet or read the phase near overload threshold.xxxxxxx
phOverLoadSet or read the phase overload threshold.xxxxxxx
phPeakCurrRead the peak current reading/measurement from a phase(s).xxxxxxx
phReadingView the current, voltage, or power for a phase. xxxxxxx
phRestrictnSet or read the overload restriction feature to prevent outlets from
turning on when the overload alarm threshold is violated.
phTophVoltsRead the phase-to-phase voltage on 3-phase devices.xxxx
prodInfoDisplays information about the rack PDUxxxxxxx
sensorNameSet or display the name assigned to the temperature or temperature/
humidity sensor.
tempAlGenSet or read whether temperature alarms are enabled or disabled.xxxx
tempHighSet or read the temperature high threshold.xxxx
tempMaxSet or read the temperature max threshold.xxxx
tempHystSet or read the temperature threshold hysteresis value.xxxx
tempPeak Display the peak temperature reading of the sensor.xxxx
tempReadingDisplay the temperature reading from the sensor.xxxx
tempStatusDisplay the status of the sensor.xxxx
userAddAdd an outlet user to the local user database.xxxx
userDeleteRemove an outlet user from the local user database.xxxx
userListList the users and outlets assigned to them.xxxx
userPasswdSet a user password.xxxx
*Phase balance commands only applies to models with two or more metered phases.
xxxx
xxx
xxxx
990-5848C-00125
Page 28
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Network Management Card Command Descriptions
? or help
Access: Super User, Administrator, Device User, Outlet User, Read Only
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.
------------------------------Vendor class: <device class>
Client id: XX XX XX XX XX XX
User class: <user class>
After IP assignment: gotoDhcpOrBootp
Using a DHCP server to obtain network settings:
Define how the TCP/IP settings will be configured when
the device turns on, resets, or restarts. See “T
Communication Settings” on page 112 for information
about each boot mode setting.
dhcp and dhcpBootp boot modes only. Enable or
disable the requirement that the DHCP server provide
the APC cookie.
The MAC address of the device’s NMC, Which uniquely
identifies it on the network.
CP/IP and
DHCP Settings
------------Retry then stop: 4
DHCP cookie is: enable
BOOTP Settings
-------------Retry then fail: never
On retry failure: prevSettings
Error Message: E000, E102
28990-5848C-001
Page 31
Rack PDU and In-Line Current Meter AP7XXXB User Guide
cd
Access: Super User, Administrator, Device User, Outlet User, Read Only
Description: Allows the user to set the working directory of the file system. The working directory
is set back to the root directory ‘/’ when the user logs out of the CLI.
Parameters: <dicrectory name>
Example: apc> cd logs
E000: Success
apc> cd /
E000: Success
Error Message: E000, E102
cipher
NOTE: Not available on Rack PDUs with NMC3s (firmware v1.x.x.1 or later).
Access: Super User, Administrator
Description: Enable or disable cryptographic algorithms for Web UI sessions. You cannot
enable or disable these algorithms directly from the Web UI. You must reboot your appliance after
enabling or disabling algorithms for changes to take effect.
There are three categories of algorithms: Authentication algorithms, Block Cipher algorithms, and
MAC algorithms. Available and Blocked Cipher Suites are also listed.
NOTE: Disabling the only algorithm will block all SSL/TLS sessions.
Parameters:
OptionArgumentDescription
-3des<enable | disable>Triple-DES
-aes<enable | disable>AES
-dh<enable | disable>DH
-rsake<enable | disable>RSA Key Exchange
-rsaau<enable | disable>RSA Authentication
-sha1<enable | disable>SHA
-sha2<enable | disable>SHA256
-ecdhe<enable | disable>ECDHE
Example 1: Disable the triple-DES block cipher.
apc> cipher -3des disable
E002: Success
Reboot required for change to take effect.
990-5848C-00129
Page 32
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Example 2: Retrieve a list of each available cryptographic algorithm and its status.
--------------------(the settings above disable the suites listed here)
None
Error Message: E000, E102
clrrst
Access: Super User, Administrator
Description: Clear reset reason.
Example: None
Error Message: None
30990-5848C-001
Page 33
Rack PDU and In-Line Current Meter AP7XXXB User Guide
console
Access: Super User, Administrator
Description: Define whether users can access the Command Line Interface using Telnet, which
is disabled by default, or Secure SHell (SSH), which is enabled by default 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.
Parameters:
OptionArgumentDescription
-S
-t
-pt<telnet port n>
-ps<SSH port n>
-b
Example 1:
<enable | disable>
(ssh)
<enable | disable>
(telnet)
2400 | 9600 | 19200 |
38400
To enable SSH access to the Command Line Interface, type:
console -S ssh
Enable or Disable SSH access to the device. Enabling
SSH enables SCP.
Enable or Disable Telnet access to the device.
Define the Telnet port used to communicate with the
Rack PDU (23 by default).
Define the SSH port used to communicate with the Rack
PDU (22 by default).
onfigure the speed of the serial port connection (9600
C
bps by default).
Example 2: To change the Telnet port to 5000, type:
Rack PDU and In-Line Current Meter AP7XXXB User Guide
date
Access: Super User, Administrator
Definition: Get and set the date and time of the system.
To configure an NTP server to define the date and time for the device, see “Date/Time screen” on
page 127.
Parameters:
OptionArgumentDescription
-d
-t<00:00:00>
-f
-z<time zone offset>
<“datestring”
>
mm/dd/yy |
dd.mm.yyyy |
-dd-yy |
mmm
dd-mmm-yy |
yyyy-mm-dd
Example 1:
date -f yyyy-mm-dd
To display the date using the format yyyy-mm-dd, type:
Set the current date. The format must match the current -f setting.
Configure the current time, in hours, minutes, and seconds. Use the
24-hour clock format.
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.
Set the difference with GMT in order to specify your time zone. This
enables you to synchronize with other people in different time zones.
Example 2: To define the date as January 30, 2019, using the format configured in the preceding
example, type:
date -d “2019-01-30”
Example 3: To define the time as 5:21:03 p.m., type:
date -t 17:21:03
Error Message: E000, E100, E102
delete
Access: Super User, Administrator
Description: Delete a file in the file system.
Parameters:
ArgumentDescription
<file name>Type the name of the file to delete.
Example:
apc> delete /db/prefs.dat
E000: Success
Error Messages: E000, E102
32990-5848C-001
Page 35
Rack PDU and In-Line Current Meter AP7XXXB User Guide
dir
Access: Super User, Administrator, Device User, Outlet User, Read Only
Description: Displays the content of the working directory.
Parameters: None
Example: apc> dir
E000: Success
--wx-wx-wx 1 apc apc 3145728 Jan 3 2019 aos.bin
--wx-wx-wx 1 apc apc 3145728 Jan 4 2019 app.bin
-rw-rw-rw- 1 apc apc 45000 Jan 6 2019 config.ini
drwxrwxrwx 1 apc apc 0 Jan 3 2019 db/
drwxrwxrwx 1 apc apc 0 Jan 3 2019 ssl/
drwxrwxrwx 1 apc apc 0 Jan 3 2019 ssh/
drwxrwxrwx 1 apc apc 0 Jan 3 2019 logs/
drwxrwxrwx 1 apc apc 0 Jan 3 2019 sec/
drwxrwxrwx 1 apc apc 0 Jan 3 2019 dbg/
drwxrwxrwx 1 apc apc 0 Jan 3 2019 pdu/
Error Messages: E000
990-5848C-00133
Page 36
Rack PDU and In-Line Current Meter AP7XXXB User Guide
dns
Access: Super User, Administrator
Definition: Configure the manual Domain Name System (DNS) settings.
Parameters:
OptionArgumentDescription
-OMenable | disableOverride the manual DNS.
-p
-s
-d<domain name>Set the domain name.
-n<domain name IPv6>Set the domain name IPv6.
-h<host name>S
-y <enable | disable>System-hostname sync
<primary DNS
server>
<secondary DNS
server>
Set the primary DNS server.
Set the secondary DNS server.
et the host name.
Example:
apc> dns
E000: Success
Active Primary DNS Server: x.x.x.x
Active Secondary DNS Server: x.x.x.x
Override Manual DNS Settings: enabled
Primary DNS Server: x.x.x.x
Secondary DNS Server: x.x.x.x
Domain Name: example.com
Domain Name IPv6: example.com
System Name Sync: Enabled
Host Name: ExampleHostName
Error Message: E000, E102
34990-5848C-001
Page 37
Rack PDU and In-Line Current Meter AP7XXXB User Guide
----------------------------------- “Device Mame”: Communication Established
Date Time Event
-------------------------------------------------------------- 01/06/2019 13:17:22 System: Set Time.
01/06/2019 13:16:57 System: Configuration change. Date format
preference.
01/06/2019 13:16:49 System: Set Date.
01/06/2019 13:16:35 System: Configuration change. Date format
preference.
01/06/2019 13:16:08 System: Set Date.
01/05/2019 13:15:30 System: Set Time.
01/05/2019 13:15:00 System: Set Time.
01/05/2019 13:13:58 System: Set Date.
01/05/2019 13:12:22 System: Set Date.
01/05/2019 13:12:08 System: Set Date.
01/05/2019 13:11:41 System: Set Date.
<ESC>- Exit, <ENTER>- Refresh, <SPACE>- Next, <D>- Delete
Update the log display. Use this command to view events that were recorded after
you last retrieved and displayed the log.
View the next page of the event log.
View the preceding page of the event log. This command is not available at the main
page of the event log.
Delete the event log. Follow the prompts to confirm or deny the deletion. Deleted
events cannot be retrieved.
Error Message: E000, E100
990-5848C-00137
Page 40
Rack PDU and In-Line Current Meter AP7XXXB User Guide
exit, quit, or bye
Access: Super User, Administrator, Device User, Outlet User, Read Only
Description: Exit from the CLI session. The exit, quit, and bye commands all close the CLI
session.
Parameters: None
Example:
apc> exit
Bye
Error Message: None
firewall
Access: Super User, Administrator
Description: Establishes a barrier between a trusted, secure internal network and another
network.
Parameters:
ParametersArgumentDescription
-S<enable | disable>Enable or disable the Firewall.
-f<file name to activate>
-t
-feNo argument. List onlyShows active file errors.
-teNo argument. List onlyShows test file errors.
-cNo argument. Cancel a firewall test.
-rNo argument. List onlyShows active firewall rules.
-lN
-YNo argument. Skip firewall test prompt.
Error Message:
<file name to test>
<duration time in minutes>
o argument. List onlyShows firewall activity log.
E000, E102
Name of the firewall to
activate.
Name of firewall to test and
duration time in minutes.
38990-5848C-001
Page 41
Rack PDU and In-Line Current Meter AP7XXXB User Guide
format
Access: Super User, Administrator
Description: Allows the user to format the FLASH file system. This will delete all configuration
data (including network settings), event and data logs, certificates and keys, and reset the card to
the factory defaults. See “resetToDef” on page 47.
NOTE: The user must confirm by entering “YES” when prompted.
Parameters: None
Example:
apc> format
Format FLASH file system
Warning: This will delete all configuration data,
event and data logs, certs and keys.
Enter 'YES' or ‘Y’ to continue or <ENTER> to cancel:
apc>
Error Message: None
990-5848C-00139
Page 42
Rack PDU and In-Line Current Meter AP7XXXB User Guide
ftp
Access: Super User, Administrator
Description: Get/set the ftp configuration data,
NOTE: The system will reboot if any configuration is changed.
Parameters:
OptionArgumentDefinition
lang
<port number>
-p
-Senable | disableConfigure access to the FTP server.
Define the TCP/IP port that the FTP server uses to
communicate with the device (21 by default). The FTP server
uses both the specified port and the port one number lower
than the specified port.
Error Message: E000, E102
Access: Super User, Administrator, Device User, Outlet User
Description: Displays the language in use
Parameters: None
Example: : apc>lang
E000: Success
Languages
enUs - English
Error Message: None
40990-5848C-001
Page 43
Rack PDU and In-Line Current Meter AP7XXXB User Guide
lastrst
Access: Super User, Administrator
Description: Last reset reason
Parameters: : None
Example: apc> lastrst
00 Reset Cleared
E000: Success
Error Message: E000, E102
ledblink
Access: Super User, Administrator
Description: Sets the blink rate to the LED on the device.
Parameters: <time> = Number of minutes to blink the LED
Example: apc> ledbllink 1
E000: Success
logzip
Error Message: E000, E102
Access: Super User, Administrator
Description: Places large logs into a zip file before sending.
Parameters:
[-m <email recipient>] (email recipient number (1-4))
Example:
apc> logzip
Generating files
Compressing files into /dbg/debug_ZA1023006009.tar
E000: Success
Error Message: E000, E102
990-5848C-00141
Page 44
Rack PDU and In-Line Current Meter AP7XXXB User Guide
netstat
Access: Super User, Administrator
Description: Displays incoming and outgoing network connections.
Parameters: None
Example: :
apc> netstat
Current IP Information:
Family mHome Type IPAddress Status
IPv6 4 auto FE80::2C0:B7FF:FE51:F304/64 configured
IPv6 0 manual ::1/128 configured
IPv4 0 manual 127.0.0.1/32 configured
Error Message: E000, E102
42990-5848C-001
Page 45
Rack PDU and In-Line Current Meter AP7XXXB User Guide
ntp
Access: Super User, Administrator
Description: Synchronizes the time of a computer client or server.
Parameters:
OptionArgumentDefinition
-OMenable | disableOverride the manual settings.
-p<primary NTP server>Specify the primary server.
ping
-s
Example 1:
ntp -OM enable
<secondary NTP
server>
To enable the override of manual setting, type:
Specify the secondary server.
Example 2: To specify the primary NTP server, type:
ntp -p 150.250.6.10
Error Message: E000, E102
Access: Super User, Administrator, Device User
Description: Perform a network ‘ping’ to any external network device.
Parameters:
ArgumentDescription
<IP address or DNS name>
Example:
E000: Success
Reply from 192.168.1.50: time(ms)= <10
Reply from 192.168.1.50: time(ms)= <10
Reply from 192.168.1.50: time(ms)= <10
Reply from 192.168.1.50: time(ms)= <10
apc> ping 192.168.1.50
Type an IP address with the format xxx.xxx.xxx.xxx, or the
DNS name configured by the DNS server.
Error Message: E000, E100, E102
990-5848C-00143
Page 46
Rack PDU and In-Line Current Meter AP7XXXB User Guide
portSpeed
Access: Super User, Administrator
Description: Allows the user to get/set the network port speed.
NOTE: The system will reboot if any configuration is changed.
Parameters:
OptionArgumentsDescription
auto | 10H |
-s
H = Half Duplex
F = Full Duplex
Example:
E000: Success
Port Speed: 10 Half_Duplex
apc> portspeed -s 10h
E000: Success
apc> portspeed
E000: Success
Port Speed: 10 Half_Duplex
apc> portspeed -s auto
E000: Success
10F | 100H |
100 F
apc> portspeed
Error Message: E000, E102
Define the communication speed of the Ethernet port. The
auto command enables the Ethernet devices to negotiate to
transmit at the highest possible speed. See “Port Speed” on
page 114 for more information about the port speed settings.
10 = 10 Meg Bits
100 = 100 Meg Bits
prompt
Access: Super User, Administrator, Device User
Description: Allows the user to change the format of the prompt, either short or long.
Parameters:
OptionArgumentDescription
-s
long
shortThe default setting. The prompt is four characters long: APC>
The prompt includes the account type of the currently logged-in
user.
Example:
apc> prompt –s long
E000: Success
Administrator@apc>prompt –s short
E000: Success
Error Message: E000, E102
44990-5848C-001
Page 47
Rack PDU and In-Line Current Meter AP7XXXB User Guide
pwd
Access: Super User, Administrator, Device User, Read Only
Description: Used to output the path of the current working directory.
Parameters: None
Example:
apc> pwd
/
apc> cd logs
E000: Success
apc> pwd
/logs
Error Message: E000, E102
990-5848C-00145
Page 48
Rack PDU and In-Line Current Meter AP7XXXB User Guide
radius
Access: Super User, Administrator
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
“Configure the RADIUS Server” on page 107.
Additional authentication parameters for RADIUS servers are available at the Web User Interface
of the device. See“
information.
For detailed information about configuring your RADIUS server, see the Security Handbook,
available at www.apc.com.
Parameters:
OptionArgumentDescription
-a
Configuration > Security > Remote Users > RADIUS” on page 106for more
Configure RADIUS authentication:
local—RADIUS is disabled. Local authentication is enabled.
local |
radiusLocal
| radius
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.
The server name or IP address of the primary or secondary
RADIUS server.
-p1
-p2
-s1
-s2
-t1
-t2
Example 1:
<server IP>
<server
secret>
<server
timeout>
To view the existing RADIUS settings for the device, type radius and press ENTER.
NOTE: RADIUS servers use port 1812 by default to
authenticate users. To use a different port, add a colon followed
by the new port number to the end of the RADIUS server name
or IP address. The device supports ports 1812, 5000 to 32768.
he shared secret between the primary or secondary RADIUS
T
server and the device.
he time in seconds that the device waits for a response from
T
the primary or secondary RADIUS server.
Example 2: To enable RADIUS and local authentication, type:
apc> radius -a radiusLocal
E000: Success
Example 3: To configure a 10-second timeout for a secondary RADIUS server, type:
apc> radius -t2 10
E000: Success
Error Message: E000, E102
46990-5848C-001
Page 49
Rack PDU and In-Line Current Meter AP7XXXB User Guide
reboot
Access: Super User, Administrator
Description: Restart the NMC interface of the device only. Forces the network device to reboot.
User must confirm this operation by entering a “YES” or “Y” after the command has been entered.
Parameters: None
Example:
apc> reboot
E000: Success
Reboot Management Interface
Enter 'YES' or ‘Y’ to continue or <ENTER> to cancel : <user enters
‘YES’ or ‘Y’>
Rebooting...
Error Message: E000, E100
resetToDef
Access: Super User, Administrator
Description: Reset all parameters to their default. Deletes all accounts and clears event and
data logs. Resets all configuration changes, including event actions, device settings, and,
optionally, TCP/IP configuration settings.
Parameters:
OptionArgumentsDescription
all = all configuration data, including the IP address.
-pall | keepip
Example:
type:
resetToDef -p keepip
Enter 'YES' or ‘Y’ to continue or <ENTER> to cancel : <user enters
‘YES’ or ‘Y’>
all User Names, Passwords.
Please wait...
Please reboot system for changes to take effect!
To reset all of the configuration changes except the TCP/IP settings for the device,
keepip = all configuration data, except the IP address.
Reset all configuration changes, including event actions, device
settings, and, optionally, TCP/IP configuration settings.
Error Message: E000, E100
990-5848C-00147
Page 50
Rack PDU and In-Line Current Meter AP7XXXB User Guide
session
Access: Super User, Administrator
Description: Records who is logged in, the serial, time and ID.
Index: 1
Receiver IP: x.x.x.x
Community: public
Trap Type: SNMPV1
Generation: disabled
Auth Traps: enabled
User Name: apc snmp profile1
Language: enUs - English
Error Message: E000, E102
990-5848C-00153
Page 56
Rack PDU and In-Line Current Meter AP7XXXB User Guide
system
Access: Super User, Administrator
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” on page 19 for more information about system status).
Parameters:
OptionArgumentDescription
-n<system-name>Define the device name, the name of the person
-c<system-contact>
-l<system-location>
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.
These values are also used by Data Center Expert and
the device’s SNMP agent.
-m<system-message>
nable | disable>]
<e
-s
Example 1:
apc> system -l “Test Lab”
E000: Success
(system-hostname
sync)
To set the device location as Test Lab, type:
When defined, a custom message will appear on the
log on screen for all users.
Allow the host name to be synchronized with the
system name so both fields automatically contain the
same value.
NOTE: When enabling this feature, the system name
identifier can no longer contain a space character
(since it will be synchronized to the host name field).
Example 2: To view the device name, type:
apc> system -n
E000: Success
Name: : Rack 2 in Room #222
Error Message: E000, E102
54990-5848C-001
Page 57
Rack PDU and In-Line Current Meter AP7XXXB User Guide
tcpip
Access: Super User, Administrator
Description: View and manually configure these network settings for the device:
Parameters:
OptionArgumentDescription
-i<IP address>
-s<subnet mask>Type the subnet mask for the device.
-g<gateway>
-d<domain name>Type the DNS name configured by the DNS server.
-h<host name>Type the host name that the device will use.
-Senable | disableEnable or disable IPv4.
Example 1:
apc> tcpip
E000: Success
IP Address: 192.168.1.50
MAC Address: XX XX XX XX XX XX
Subnet Mask: 255.255.255.0
Gateway: 192.168.1.1
Domain Name: example.com
Host Name: HostName
To view the network settings of the device, type tcpip and press ENTER.
Type the IP address of the device, using the format
xxx.xxx.xxx.xxx
Type the IP address of the default gateway. Do not use
the loopback address (127.0.0.1) as the default gateway.
Example 2: To view the IP address of the device, type:
apc> tcpip -i
E000: Success
IP Address: 192.168.1.50
Example 3: To manually configure an IP address of 192.168.1.49 for the device, type:
apc> tcpip -i 192.168.1.49
E000: Success
Reboot required for change to take effect
Error Message: E000, E102
990-5848C-00155
Page 58
Rack PDU and In-Line Current Meter AP7XXXB User Guide
tcpip6
Access: Super User, Administrator
Description: Enable IPv6 and view and manually configure these network settings for the
device:
Parameters:
OptionArgumentDescription
-Senable | disableEnable or disable IPv6.
-manenable | disable
-auto
-i<IPv6 address>Set the IPv6 address of the device.
-g<IPv6 gateway>Set the IPv6 address of the default gateway.
-d6
Example:
apc> tcpip6
E000: Success
IPv6: enabled
Manual Settings: disabled
IPv6 Address: ::/64
MAC Address: XX XX XX XX XX XX
Gateway: ::
IPv6 Manual Address: disabled
IPv6 Autoconfiguration: enabled
DHCPv6 Mode: router controlled
enable | disable
router | statefull
| stateless |
never
To view the network settings of the device, type tcpip6 and press ENTER.
Enable manual addressing for the IPv6 address of the
device.
Enable the device to automatically configure the IPv6
address.
Set the DHCPv6 mode, with parameters of router
controlled, statefull (for address and other information,
they maintain their status), stateless (for information
other than address, the status is not maintained), never.
Error Message: E000, E102
56990-5848C-001
Page 59
Rack PDU and In-Line Current Meter AP7XXXB User Guide
user
Access: Super User, Administrator
Description: Configure the user name, password, and inactivity timeout for each account type.
You can’t edit a user name, you must delete it and then create a new user. For information on the
permissions granted to each account type, see “Types of User Accounts” on page 8.
Parameters:
OptionArgumentDescription
-n<user>
-pw<user password>
-pe <user permission>
Specify these options for a user.
-d
-e enable | disable
-st
-srenable | disable
-el enable | disableIndicate the Event Log color coding.
-lf tab | csvIndicate the format for exporting a log file.
-ts us | metric
-df <mm/dd/yyyy |
-lg
-del <user name>Delete a user.
-l Display the current user list.
<user description>
<session timeout>
dd.mm.yyyy
yy | dd-mmm-yy |
yyyy-mm-dd>
<language code (e.g.
enUs)>
| mmm-dd-
Enab
le overall access.
Specify how long a session lasts waits before
logging off a user when the keyboard is idle.
Bypass RADIUS by using the serial console (CLI)
connection, also known as Serial Remote
Authentication Override
Indicate the temperature scale, Fahrenheit or
Celsius.
Specify a date format.
Specify a user language.
Example:
E000: Success
Access: Enabled
User Name: apc
Password: <hidden>
User Permission: Super User
User Description: User Description
Session Timeout: 3 minutes
Serial Remote Authentication Override: Disabled
Event Log Color Coding: Enabled
Export Log Format: Tab
Temperature Scale: Metric
Date Format: mm/dd/yyyy
Language: English (enUs)
Outlets: All
apc> user -n apc
Error Message: E000, E102
990-5848C-00157
Page 60
Rack PDU and In-Line Current Meter AP7XXXB User Guide
userdflt
Access: Super User, Administrator
Description: Complimentary function to “user” establishing default user preferences. There are
two main features for the default user settings:
• Determine the default values to populate in each of the fields when the Super User or
Administrator-level account creates a new user. These values can be changed before the
settings are applied to the system.
• For remote users (user accounts not stored in the system that are remotely authenticated such
as RADIUS) these are the values used for those that are not provided by the authenticating
server. For example, if a RADIUS server does not provide the user with a temperature
preference, the value defined in this section will be used.
By default, user will be enabled or disabled
upon creation. Remove (Enable) from the end
Specify the user's permission level and account
type.
Provide a default session timeout.
Number of incorrect login attempts a user has
before the system disables their account. Upon
reaching this limit, a message is displayed
informing the user the account has been
locked. The Super User or an Administratorlevel account is needed to re-enable the
account to allow the user to log back in.
NOTE: A Super User account cannot be locked
out, but can be manually disabled if necessary.
<interval in days>Required password change interval
e)
Specify the log export format, tab or CSV.
Specify the user's temperature scale. This
setting is also used by the system when a user
preference is not available (for example, email
notifications).
Specify the user's preferred date format.
User language
Page 61
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Example: apc> userdflt
E000: Success
Access: Disabled
User Permission: Administrator
User Description: User Description
Session Timeout: 3 minutes
Bad Login Attempts: 0
Event Log Color Coding: Enabled
Export Log Format: Tab
Temperature Scale: Metric
Date Format: mm/dd/yyyy
Language: English (enUs)
Strong Passwords: Disabled
Require Password Change: 0 day(s) (Disabled)
Error Message: E000, E102
web
Access: Super User, Administrator
Description: Enable access to the Web User 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
Parameters:
OptionArgumentDefinition
-h enable | disable
-senable | disable
-ph
-ps<https port #>
-mp<minimum protocol>
Example 1:
apc> web -h disable -s disable
<http port #>
To prevent all access to the Web User Interface, type:
Enable or disable access to the user interface for HTTP.
HTTP is disabled by default.
Enable or disable access to the user interface for
HTTPS. HTTPS is enabled by default.
When HTTPS is enabled, data is encrypted during
transmission and authenticated by digital certificate.
Specify the TCP/IP port used by HTTP to communicate
with the device (80 by default). The other available range
is 5000–32768.
Specify the TCP/IP port used by HTTPS to communicate
with the device (443 by default). The other available
range is 5000–32768.
Choices are: SSL3.0 | TLS1.0 | TLS1.1 |
TLS1.2
990-5848C-00159
Page 62
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Example 2: To define the TCP/IP port used by HTTP, type:
Acceptable arguments are none, near, and over.
To specify phases, choose from the following options.
Type: all, a single phase, a range, or a comma-separated list of phases.
phase#
list of single phase number and/or number ranges.
= A single number or a range of numbers separated with a dash or a comma separated
Example 1: To set the overload restriction for phase three to none, type:
apc> bkRestrictn 3 none
E000: Success
Example 2: To view the overload restrictions for all phases, type:
apc> bkRestrictn all
E000: Success
1: over
2: near
3: none
Error Messages: E000, E102
64990-5848C-001
Page 67
Rack PDU and In-Line Current Meter AP7XXXB User Guide
devStartDly
Access: Super User, Administrator, Device User
Description: Set or view the amount of time in seconds, which is added to each outlet’s Power
On Delay before the outlet will turn on after power is applied to the Switched Rack PDU. Allowed
values are within the range of 1 to 300 seconds or Never (never turn on).
Parameters: [time | never]
ArgumentDefinition
energyWise
[time | “never”]
time = Cold start delay time in whole seconds or “never”; case
insensitive.
Example 1: To view the cold start delay, type:
apc> devStartDly
E000: Success
5 seconds
Example 2: To set the cold start delay to six seconds, type:
apc> devStartDly 6
E000: Success
Error Messages: E000, E102
NOTE: Not supported on Rack PDUs with NMC3s (firmware V1.x.x.1 or later).
Access: Super User, Administrator, Device User, Outlet User
Description: Cisco IOS® software for monitoring, controlling, and reporting the energy use of
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Shared Secret: <hidden>
Toolkit Version: (rel2_7)1.2.0
Name (P): apc51F304
Name (C1): apc51F304.1.Outlet1
Name (C2): apc51F304.1.Outlet2
Name (C3): apc51F304.1.Outlet3
Name (C4): apc51F304.1.Outlet4
Name (C5): apc51F304.1.Outlet5
Name (C6): apc51F304.1.Outlet6
Name (C7): apc51F304.1.Outlet7
Name (C8): apc51F304.1.Outlet8
Role (P): Rack Power Distribution Unit
Role (C1): Outlet
Role (C2): Outlet
Role (C3): Outlet
Role (C4): Outlet
Role (C5): Outlet
Role (C6): Outlet
Role (C7): Outlet
Role (C8): Outlet
Keywords (P): apc,pdu,rackpdu
Keywords (C1): apc,pdu,rackpdu,outlet
Keywords (C2): apc,pdu,rackpdu,outlet
Keywords (C3): apc,pdu,rackpdu,outlet
Keywords (C4): apc,pdu,rackpdu,outlet
Keywords (C5): apc,pdu,rackpdu,outlet
Keywords (C6): apc,pdu,rackpdu,outlet
Keywords (C7): apc,pdu,rackpdu,outlet
Keywords (C8): apc,pdu,rackpdu,outlet
Importance (P): 1
Importance (C1): 1
Importance (C2): 1
Importance (C3): 1
Importance (C4): 1
Importance (C5): 1
Importance (C6): 1
Importance (C7): 1
Importance (C8): 1
Error Message: None
66990-5848C-001
Page 69
Rack PDU and In-Line Current Meter AP7XXXB User Guide
olAssignUsr
Access: Super User, Administrator
Description: Assign control of outlets to an outlet user that exists in the local database.
Parameters: <all | outlet name | outlet#> <user>
ArgumentDefinition
allAll device outlets.
olCancelCmd
<outlet name>The name configured for a specific outlet. (See “olName” on page 7
<outlet#>
<user>A user that exists in the local database. (See “userAdd” on page 79.)
A single number or a range of numbers separated with a dash, or a
comma-separated list of single outlet numbers and number ranges.
0.)
Example 1: To assign a user named Bobby to outlets 3, 5 through 7, and 10, type:
apc> olAssignUsr 3,5-7,10 bobby
E000: Success
Example 2: To assign a user named Billy to all outlets, type:
apc> olAssignUsr all billy
E000: Success
Error Message: E000, E102
Access: Super User, 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.
Parameters: <all | outlet name | outlet#>
ArgumentDefinition
allAll device outlets.
<outlet name>The name configured for a specific outlet. (See “olName” on page 70.)
<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.
Example: To cancel all commands for outlet 3, type:
apc> olCancelCmd 3
E000: Success
Error Message: E000, E102, E104
990-5848C-00167
Page 70
Rack PDU and In-Line Current Meter AP7XXXB User Guide
olDlyOff
Access: Super User, 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 “olOffDelay”
on page 71).
Parameters: <all | outlet name | outlet#>
ArgumentDefinition
allAll device outlets.
<outlet name>The name configured for a specific outlet. (See “olName” on page 70.)
olDlyOn
<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.
Example 1: To turn off outlets 3, 5 through 7, and 10, type:
apc> olDlyOff 3,5-7,10
E000: Success
Example 2: To turn off all outlets, type:
apc> olDlyOff all
E000: Success
Error Message: E000, E102, E104
Access: Super User, 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”
on page 72).
Parameters: <all | outlet name | outlet#>
ArgumentDefinition
allAll device outlets.
<outlet name>The name configured for a specific outlet. (See “o
<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.
lName” on page 70.)
Example 1: To turn on outlets 3, 5 through 7, and 10, type:
apc> olDlyOn 3,5-7,10
E000: Success
Example 2: To turn on an outlet with the configured name of Outlet1, type:
apc> olDlyOn outlet1
E000: Success
Error Message: E000, E102, E104
68990-5848C-001
Page 71
Rack PDU and In-Line Current Meter AP7XXXB User Guide
olDlyReboot
Access: Super User, 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” on page 71). After the longest
Reboot Duration (see “E000, E102, E104” on page 72) of the selected outlets, the outlets will
then begin to turn on based on the configured Power On Delays (see “o
for the specified outlets.
Parameters: <all | outlet name | outlet#>
ArgumentDefinition
allAll device outlets.
<outlet name>The name configured for a specific outlet. (See “olName” on page 70.)
lOnDelay” on page 72) set
olGroups
<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.
Example 1: To cycle power to outlets 3, 5 through 7, and 10, type:
apc> olDlyReboot 3,5-7,10
E000: Success
Example 2: To cycle power to an outlet with the configured name of Outlet1, type:
apc> olDlyReboot outlet1
E000: Success
Error Message: E000, E102, E104
Access: Super User, Administrator, Device User, and Outlet User.
Description: The device’s CLI will not allow outlet synchronization groups to be assigned or
managed, except via an INI file put/get. However, outlet group information can be retrieved using
this command. Outlet synchronization groups can also be assigned and managed via the Web
User Interface. An Outlet User can perform control commands on all outlets defined in an outlet
synchronization group as long as one of the outlets has been assigned to them. Outlet
synchronization can occur locally on one device or across the network with multiple devices
depending on configuration. When an outlet is part of a synchronization group it will always be
synchronized with the other members of the group.
Lists the outlet synchronization groups defined on the device. If synchronization of outlets between
devices is enabled, information of those devices is also listed.
Parameters: None
Example: To list outlet synchronization groups on the device, type:
apc> olGroups
Outlet Group Method: Enabled via Network
Outlet Group A:
159.215.6.141Outlets: 2,4-7,9
159.215.6.143Outlets: 2,7,8
Outlet Group B:
159.215.6.141Outlets: 1
159.215.6.166Outlets: 1
E000: Success
Error Message: E000, E102, E104
990-5848C-00169
Page 72
Rack PDU and In-Line Current Meter AP7XXXB User Guide
olName
Access: Super User, Administrator, Device User, Read Only, and Outlet User, but only for outlets
to which the user is assigned.
Description: Set or view the name configured for an outlet.
Parameters: <all | outlet#> [newname]
ArgumentDefinition
allAll device outlets.
olOff
<outlet#>
<newname>T
A single number or a range of numbers separated with a dash, or a
comma-separated list of single outlet numbers and number ranges.
he name for a specific outlet. Use only letters and numbers.
Example: To configure the name for outlet 3 to BobbysServer, type:
apc> olName 3 BobbysServer
E000: Success
Error Message: E000, E102, E104
Access: Super User, 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.
Parameters: <all | outlet name | outlet#>
ArgumentDefinition
allAll device outlets.
<outlet name>The name configured for a specific outlet. (See “olName” on page 70.)
<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.
Example: To turn off outlets 3 and 5 through 7, type:
apc> olOff 3,5-7
E000: Success
Error Message: E000, E102, E104
70990-5848C-001
Page 73
Rack PDU and In-Line Current Meter AP7XXXB User Guide
olOn
Access: Super User, Administrator, Device User, and Outlet User, but only for outlets to which
the user is assigned.
Description: Turn on an outlet or group of outlets without any delay.
Parameters: <all | outlet name | outlet#>
ArgumentDefinition
allAll device outlets.
<outlet name>The name configured for a specific outlet. (See “olName” on page 70.)
olOffDelay
<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.
Example: To turn on outlets 3 and 5 through 7, type:
apc> olOn 3,5-7
E000: Success
Error Message: E000, E102, E104
Access: Super User, Administrator, Device User, and Outlet User, but only for outlets to which
the user is assigned.
Description: Set or view the time delay for the Off Delayed command (see “olDlyOff” on
page 68) and for a Reboot Delayed command (see “olDlyReboot” on page 69).
Parameters: <all | outlet name | outlet#> [time]
ArgumentDefinition
allAll device outlets.
<outlet name>The name configured for a specific outlet. (See “olName” on page 70.)
<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.
<time>A time for the delay within the range of 1 to 7200 seconds (2 hours).
Example 1: To set a 9-second delay for turning off outlets 3 and 5 through 7, type:
apc> olOffDelay 3,5-7 9
E000: Success
Example 2: To view the delay for the Off Delayed command for outlets 3 and 5 through 7, type:
Access: Super User, Administrator, Device User, and Outlet User, but only for outlets to which
the user is assigned.
Description: Cycle power to an outlet or group of outlets without any delays. If more than one
outlet is specified, then those outlets will be cycled together.
Parameters: <all | outlet name | outlet#>
ArgumentDefinition
allAll device outlets.
<outlet name>The name configured for a specific outlet. (See “olName” on page 70.)
<outlet#>
A single number or a range of numbers separated with a dash, or a commaseparated list of single outlet numbers and number ranges.
Example: To reboot outlets 3 and 5 through 7, type:
apc> olReboot 3,5-7
E000: Success
Error Message: E000, E102, E104
990-5848C-00173
Page 76
Rack PDU and In-Line Current Meter AP7XXXB User Guide
olStatus
Access: Super User, Administrator, Device User, and Read Only. Outlet Users also have access,
but only for outlets to which the user is assigned.
Description: View the status of specified outlets.
Parameters: <all | outlet name | outlet#>
ArgumentDefinition
allAll device outlets.
<outlet name>The name configured for a specific outlet. (See “olName” on page 70.)
olUnasgnUsr
<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.
Example: To view the status for outlets 3 and 5 through 7, type:
apc> olStatus 3,5-7
E000: Success
3: BobbysServer: On
5: BillysServer: Off
6: JoesServer: Off
7: JacksServer: On
Error Messages: E000, E102, E104
Access: Super User, Administrator
Description: Unassign outlets to a user that exists in the local database. Outlet permissions for
RADIUS defined users can only be set at the RADIUS server. This command is only available to
the administrator. If an outlet is specified that is not assigned to a user, no error is generated.
Parameters: : <all | outlet name | outlet#> <user>
ArgumentDefinition
allAll device outlets.
<outlet name>The name configured for a specific outlet. (See “olName” on page 70.)
<outlet#>
<user>A user that exists in the local database.
A single number or a range of numbers separated with a dash, or a
comma-separated list of single outlet numbers and number ranges.
Example 1: To remove a user named Bobby from control of outlets 3, 5 through 7, and 10, type:
apc> olUnasgnUsr 3,5-7,10 bobby
E000: Success
Example 2: To remove a user named Billy from control of all outlets, type:
apc> olUnasgnUsr all billy
E000: Success
Error Message: E000, E102
74990-5848C-001
Page 77
Rack PDU and In-Line Current Meter AP7XXXB User Guide
phBal
Access: Super User, Administrator, Device User, Outlet User, Read Only
Description: Sets or reads the phase load balance threshold. Only applies to models with two or
more metered phases.
Parameters: [id#:] [current]= The new phase threshold (Amps).
Example:
apc> phBal 13
E000: Success
apc> phBal
E000: Success
13A
Error Message: E000, E102
phBalAlGen
Access: Super User, Administrator, Device User, Outlet User, Read Only
Description: Sets or reads whether phase load balance alarms are enabled or disabled. Only
applies to models with two or more metered phases.
Parameters: [id#:] [<enable/disable>]
enable = enable phase load balance alarms
disable = disable phase load balance alarms
Example 1:
apc> phBalAlGen enable
E000: Success
apc> phBalAlGen disable
E000: Success
Error Message: E000, E102
990-5848C-00175
Page 78
Rack PDU and In-Line Current Meter AP7XXXB User Guide
phLowLoad
Access: Super User, Administrator, Device User
Description: Set or view the phase low-load threshold. To specify phases, choose from the
following options. Type: all, a single phase, a range, or a comma-separated list of phases.
Parameters: <all | phase#> [current]
phase# = A single number or a range of numbers separated with a dash or a comma; separated
list of single bank number and/or number ranges.
phNearOver
current
= The new phase threshold (Amps).
Example 1: To set the low-load threshold for all phases to 1 A, type:
apc> phLowLoad all 1
E000: Success
Example 2: To view the low-load threshold for phases 1 through 3, type:
apc> phLowLoad 1-3
E000: Success
1: 1 A
2: 1 A
3: 1 A
Error Message: E000, E102
Access: Super User, Administrator, Device User
Description: Set or view the phase near-overload threshold.
Parameters: <all | phase#> [current]
phase# = A single number or a range of numbers separated with a dash or a comma; separated
list of single bank number and/or number ranges.
current
= The new phase threshold (Amps).
Example 1: To set the near-overload threshold for all phases to 10 A, type:
apc> phNearOver all 10
E000: Success
Example 2: To view the near-overload threshold for phases 1 through 3, type:
apc> phNearOver 1-3
E000: Success
1: 10 A
2: 10 A
3: 10 A
Error Message: E000, E102
76990-5848C-001
Page 79
Rack PDU and In-Line Current Meter AP7XXXB User Guide
phOverLoad
Access: Super User, Administrator, Device User
Description: Set or view the phase overload threshold.
Parameters: <all | phase#> [current]
phase# = A single number or a range of numbers separated with a dash or a comma; separated
list of single bank number and/or number ranges.
current = The new phase threshold (Amps).
Example 1: To set the overload threshold for all phases to 13 A, type:
apc> phOverLoad all 13
E000: Success
Example 2: To view the overload threshold for phases 1 through 3, type:
apc> phOverLoad 1-3
E000: Success
1: 13 A
2: 13 A
3: 13 A
phPeakCurr
Error Messages: E000, E102
Access: Super User, Administrator, Device User
Description: Display the peak current measurement from a phase(s).
Parameters: <all | phase#>
phase# = A single number or a range of numbers separated with a dash or a comma; separated
list of single bank number and/or number ranges.
Example:
apc> phPeakCurr 2
E000: Success
2: 0.0 A
apc> phPeakCurr all
E000: Success
1: 0.0 A
2: 0.0 A
3: 0.0 A
Error Messages: E000, E102
990-5848C-00177
Page 80
Rack PDU and In-Line Current Meter AP7XXXB User Guide
phReading
Access: Super User, Administrator, Device User, Read Only
Description: View the current for a phase. You can specify all phases, a single phase, a range,
or a comma-separated list of phases.
Parameters: < all | phase# > < current >
Example: To view the measurement for current for phase 3, type:
apc> phReading 3 current
E000: Success
3: 4 A
Error Message: E000, E102
phRestrictn
Access: Super User, Administrator
Description: Set or view the overload restriction feature to prevent outlets from turning on when
the overload alarm threshold is violated. Acceptable arguments are none, near, and over. To
specify phases, choose from the following options. Type: all, a single phase, a range, or a
comma-separated list of phases.
Parameters: < all | phase#> [none | near | over]
phase# = A single number or a range of numbers separated with a dash or a comma; separated
list of single bank number and/or number ranges.
Example 1: To set the overload restriction for phase three to none, type:
apc> phRestrictn 3 none
E000: Success
Example 2: To view the overload restrictions for all phases, type:
apc> phRestrictn all
E000: Success
1: over
2: near
3: none
Error Message: E000, E102
78990-5848C-001
Page 81
Rack PDU and In-Line Current Meter AP7XXXB User Guide
prodInfo
Access: Super User, Administrator, Device User, Outlet User, Read Only
Description: View information about the device.
Parameters: <all>
Example: To view the product information for this device, type:
apc> prodInfo
E000: Success
AOS X.X.X
Metered Rack PDU X.X.X
Model: AP7XXXB
Name: room555Main
Location: Room 555
Contact: (xxx) 555-1234
Present Outlets: XX
Switched Outlets: XX
Metered Outlets: XX
Max Current: XX A
Phases: X
Banks: X
Uptime: 0 Days 0 Hours 0 Minutes
Network Link: Link Active
userAdd
userDelete
Error Messages: E000
Access: Super User, Administrator
Description: Add an outlet user to the local user database.
The password for the new user will be the same as the user name. To change the password of the
er, use the ‘userPasswd’ command.
us
Parameters: <user>
user = A user that does NOT exists in the local database.
Example: : To add a user named Bobby, type:
apc> userAdd Bobby
E000: Success
Error Message: E000, E102, E202
Access: Super User, Administrator
Description: Remove an outlet user from the local user database.
Parameters: <user>
user = A user that exists in the local database.
Example: : To remove a user named Bobby, type:
apc> userDelete Bobby
E000: Success
Error Message: E000, E102, E202
990-5848C-00179
Page 82
Rack PDU and In-Line Current Meter AP7XXXB User Guide
userPasswd
Access: Super User, Administrator.
Description: Set an outlet User password.The administrator user can change passwords for all
users.
Parameters: <user> <password1> <password2> = User name that will have its password
changed. Password 2 is a confirmation and must be identical to password 1.
Example: To set dobby’s password to “riddle” type:
apc> userPasswd dobby riddle riddle
E000: Success
Error Messages:
E000, E102, E104
80990-5848C-001
Page 83
Rack PDU and In-Line Current Meter AP7XXXB User Guide
userList
Access: Super User, Administrator, Device User, Read Only, and Outlet User, but only for outlets
to which the user is assigned.
Description: List the users and the outlets assigned to them.
When used by the administrator, it lists the users in the local database and the outlet numbers
assigned to them. When used by an outlet user, it lists only that user and their outlets. If the active
user was authenticated via RADIUS, then the user and the outlet permissions are displayed based
on logged user type.
Parameters: None
Example 1: : When logged in as the Administrator, type:
apc> userList
E000: Success
Name User Type Status Outlets
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Web User Interface
Supported Web Browsers
NOTE: Depending on the features of your device, some of the Web User Interface (Web UI)
pages described will not apply.
You can use the latest version of Microsoft
Apple Safari®, or Mozilla Firefox® to access the Rack PDU through its Web UI. Other commonly
available browsers and versions may work but have not been fully tested.
The device cannot work with a proxy server. Before you can use a Web browser to access the
Web User Interface of the device, you must do one of the following:
Configure the Web browser to disable the use of a proxy server for the device.
•
• Configure the proxy server so that it does not proxy the specific IP address of the device.
Log On to the Web User Interface
Overview
You can use the DNS name or System IP address of the device for the URL address of the Web
User Interface. Use your case-sensitive user name and password to log on.
Internet Explorer® (IE) or Edge®, Google Chrome®,
The default user name and password for the Super User are both apc. For all other user types,
there is no default user name or password. The Super User or an Administrator created by the
Super User, must define the user name and password and other account characteristics for these
users.
NOTE: If you are using HTTPS (SSL/TLS) as your access protocol, your login credentials are
compared with information in a server certificate. If the certificate was created with the Security
Wizard, and an IP address was specified as the common name in the certificate, you must use an
IP address to log on to the device. If a DNS name was specified as the common name on the
certificate, you must use a DNS name to log on.
You may receive a message that the Web page is not secure. This is normal, and you can
continue to the
Web UI. The warning is generated because your Web browser does not recognize the default
certificate used for encryption over HTTPS. However, information transmitted over HTTPS is still
encrypted. See the Security Handbook on www.apc.com for more details on HTTPS and
instructions to resolve the warning.
82990-5848C-001
Page 85
Rack PDU and In-Line Current Meter AP7XXXB User Guide
URL address formats
Type the DNS name or IP address of the device in the Web browser’s URL address field and press
ENTER. When you specify a non-default Web server port in Internet Explorer, you must include
http:// or https:// in the URL.
Common browser error messages at log-on:
Error MessageBrowserCause of the Error
First log on
“This page cannot be displayed.”Internet Explorer
“Unable to connect.”Firefox
Web access is disabled, or the
URL was not correct.
URL format examples:
NOTE: HTTP is disabled by default, and HTTPS is enabled by default.
• For a DNS name of Web1:
- http://Web1 if HTTP is your access mode
- https://Web1 if HTTPS (HTTP with SSL/TLS) is your access mode
For a System IP address of 139.225.6.133 and the default Web server port (80):
•
- http://139.225.6.133 if HTTP is your access mode
- https//139.225.6.133 if HTTPS (HTTP with SSL/TLS) is your access mode
• For a System IP address of 139.225.6.133 and a non-default Web server port (5000):
- http://139.225.6.133:5000 if HTTP is your access mode
- https://139.225.6.133:5000 if HTTPS (HTTP with SSL/TL
•
For a System IPv6 address of 2001:db8:1::2c0:b7ff:fe00:1100 and a non-default Web server
port (5000):
http://[2001:db8:1::2c0:b7ff:fe00:1100]:5000 if HTTP is your access mode
S) is your access mode
When you log on to the NMC for the first time, you will be prompted to change the default Super
User account password (apc). After you log in, you will be directed to the Configuration Summary screen. This screen is an overview of all system protocols, and their current values (e.g.
enabled/disabled). You can access this screen at any time afterwards by following the path:
Configuration > Network > Summary.
Limited Status Access
The RPDU Limited Status (Configuration > Network > Web > Access) page provides limited
information, without requiring you to log on. Using a Web browser, access the RPDU’s IP address
to view the log on page. When enabled, there is a "Limited Status" hyperlink toward the lower right
rner of the frame. Clicking on “Limited Status,” instead of the regular user name / password
co
fields, a limited summary of Device and System Information is made available to viewing. A “Log
On” hyper link, as seen immediately above, allows for easy access to the standard Log In page.
990-5848C-00183
Page 86
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Web User Interface Features
Read the following to familiarize yourself with basic Web User Interface features for your device.
Tabs
The following tabs are available:
• Home: Appears when you log on (This is the default tab when you log on. To change the login
page to a different page, click on the green pushpin at the top right side of the browser
window while on the desired page). View active alarms, the load status of the device, and the
most recent device events. For more information, see “A
• Status: Gives the user the status of the device and Network. The RPDU tab covers the status
of alarms, groups, device, phase, bank, and environment. Network tab covers just the
network. See “Status Tab” on page 87.
• Control: The Control tab covers three topics: RPDU, Security and Network. Much more
information is covered under each of these tabs and will be described in the Control tab
section.
Configuration: The Configuration tab covers RPDU, Security, Network, Notification,
•
General and Logs. Much more information is covered under each of these tabs and will be
described in theConfiguration tab section.
bout Home” on page 86.
Device status icons
• Tests: The Tests tab covers RPDU and Network. The Network tab covers LED Blink. This will
be further described later in the Tests section of the document.
Logs: The Logs section covers: Event, Data and Firewall. The Event and Data tabs cover
•
more information which will be further discussed later in the Logs section of the document.
• About: The About section covers RPDU and Network, which will be further discussed later in
the About section of the document.
One or more icons and accompanying text indicate the current operating status of the device:
Symbol Description
Critical: A critical alarm exists, which requires immediate action.
Warning: An alarm condition requires attention and could jeopardize your data
or equipment if its cause is not addressed.
No Alarms: No alarms are present, and the device and NMC are operating
normally.
At the upper right corner of every page, the Web User Interface displays the same icons currently
displayed on the Home page to report device status:
• The No Alarms icon if no alarms exist.
• One or both of the other icons (Critical and Warning) if any alarms exist, and after each icon,
the number of active alarms of
84990-5848C-001
that severity.
Page 87
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Quick Links
At the lower left on each page of the interface, there are three configurable links. By default, the
links access the URLs for these Web pages:
• Link 1: The home page of the APC website
• Link 2: Demonstrations of APC web-enabled products
• Link 3: Information on EcoStruxure IT
Located in the upper right hand corner of each page:
• User name (click to change user preferences)
• Language (if avail
•
Log Off (click to log the current user off of the Web User Interface)
• Help (click to view help contents)
• (click to set the current web page to be the log in home page)
Example:
Log In Home: To make any screen the “home” screen (i.e., the screen that displays first when
you log on), go to that screen, and click the icon in the top right corner.
Click to revert to displaying the Home screen when you log on.
able, click to change language preference)
990-5848C-00185
Page 88
Rack PDU and In-Line Current Meter AP7XXXB User Guide
About Home
The Home page contains the following information: Active Alarms, Load Status and Recent Device
Events. Active Alarms will show if any alarms exist. If no alarms exist, a green check mark with the
words ”No Alarms Present” will show. The Load Status shows a colored bar demonstrating the
level of the Bank, Phase and Device loads. To see the Device Status select the More link at the
bottom of the list.The Recent Device Events box will list the five most recent device Events by the
device by Date, Time and Event.
The Overview view
In the Load Status area, view the load for the phases and banks in amps, as applicable.
In the Rack PDU Parameters box, you will find the Name, Location, Contact, Model Number, Rating, User (type of user account accessing the device) and Uptime (the amount of time the
device has been operating since the last reboot from either a power cycle or a reboot of the
Management Interface).
In the Recent Device Events
dates and times they occurred. A maximum of five Events are shown at one time. Click More
Events to go to the Logs tab to view the entire event log.
box are the Events which have occurred most recently and the
86990-5848C-001
Page 89
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Status Tab
About the Status Tab
Use the Status tab to:
• View the status for the device or the network
• Under the device option, users can access the following: Alarms, Device, Phase, Bank, Outlets
and Environment.
• Select Network to view the current IPv4 and IPv6 settings.
990-5848C-00187
Page 90
Rack PDU and In-Line Current Meter AP7XXXB User Guide
View the Load Status and Peak Load
Path: Status > RPDU
Alarms:
Device: Shows status of device. Lists Properties and Configuration information.
Phase: Shows phase status (only on units with this feature). Delta values for Phase Load
Balance are displayed for models with two or more metered phases.The phase settings can also
be configured via a Configure Phase Settings link at the bottom of the page. Configuration can be
changed as well.
Bank: Shows bank status (only on units with this feature). The bank settings can be changed via
a Configure Bank status link at the bottom of the page.
Outlet: Shows: Outlet Name, Phase, and State.
Switched Outlet: Choose from the following options:
• Scheduling: Shows Scheduled outlet actions.
• Outlet Groups: Shows outlet groups as either enabled or disabled and can also configure.
View the Network Status
Path: Status > Network
The Network screen displays information about your network.
Lists Device Alarm Status.
Current IPv4 Settings
System IP: The IP address of the unit.
Subnet Mask: The IP address of the sub-network.
Default Gateway: The IP address of the router used to connect to the network.
MAC Address: The MAC address of the unit.
Mode: How the IPv4 settings are assigned: Manual, DHCP, or BOOTP.
DHCP Server: The IP address of the DHCP server. This is only displayed if Mode is DHCP.
Lease Acquired: The date/time that the IP address was accepted from the DHCP server.
Lease Expires: The date/time that the IP address accepted from the DHCP server expires and
will need to be renewed.
Current IPv6 Settings
Type: How the IPv6 settings are assigned.
IP Address: The IP address of the unit.
Prefix Length: The range of addresses for the sub-network.
88990-5848C-001
Page 91
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Domain Name System Status
Active Primary DNS Server: The IP address of the primary DNS server.
Active Secondary DNS Server: The IP address of the secondary DNS server.
Active Host Name: The host name of the active DNS server.
Active Domain Name (IPv4/IPv6): The IPv4/IPv6 domain name that is currently in use.
Active Domain Name (IPv6): The IPv6 domain name that is currently in use.
Ethernet Port Speed
Current Speed: The current speed assigned to the Ethernet port.
990-5848C-00189
Page 92
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Control
The Control menu options enable you to take immediate actions affecting active user
management and the security of your network.
90990-5848C-001
Page 93
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Controlling Device Outlets
Path: Control > RPDU > Outlet
Shows Outlet Control, Control Action, and Selected Outlets. Inside the Select Outlet box the
screen will show the Outlet’s Name, its State and its Phase.
NOTE: If you apply an outlet control action to outlets or outlet groups, the following delays are
used for the action:
• For an individual outlet (not in an outlet group), the action uses the delay periods and reboot
duration configured for that outlet.
• For a global outlet group, the action uses the delay periods and reboot duration configured for
the global outlet.
For a local outlet group, the action uses the delay periods configured for the lowest-numbered
•
outlet in the group.
To control the outlets on your device
Mark the checkboxes for each individual outlet or outlet group to control, or select the All Outlets
checkbox.
Select a Control Action from the list, and click Next >>. On the confirmation page that explains
the action, choose to apply or cancel it.
Control actions you can select
OptionDescription
No ActionDo nothing.
On ImmediateApply power to the selected outlets.
On DelayedApply power to each selected outlet according to its value for Power On Delay.
Off ImmediateRemove power from the selected outlets.
Off DelayedRemove power from each selected outlet according to its value for Power Off Delay.
Reboot
Immediate
Reboot Delayed
Cancel Pending
Commands
†
If a local outlet group is selected, only the configured delays and reboot duration of the lowest-numbered
outlet of the group are used. If a global outlet group is selected, only the configured delays and reboot
duration of the global outlet are used.
Remove power from each selected outlet. Then apply power to each of these outlets
according to its value for Reboot Duration.
Remove power from each selected outlet according to its value for Power Off Delay.
Wait until all outlets are off (the highest value for Reboot Duration), and then apply
power to each outlet according to its value for Power On Delay.
Cancel all commands pending for the selected outlets and keep them in the present
state.
NOTE: For global outlet groups, you can cancel a command only from the interface of
the initiator outlet group. The action will cancel the command for the initiator outlet group
and all follower outlet groups.
†
†
†
†
990-5848C-00191
Page 94
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Managing User Sessions
Path: Control > Security > Session Management
The Session Management menu displays all active users currently connected to the Rack PDU.
To view Information about a given user, click their user name. The Session Details screen
displays basic information about the user including what interface they are logged-in to, their IP
address, and user authentication. There is also an option to Terminate Session for the user.
Resetting the Network Interface
Path: Control > Network > Reset/Reboot
This menu gives you the option to reset and reboot various components of the network interface.
Users have the option to Reboot Management Interface,
NOTE: Rebooting the Management Interface only restarts the device’s Network Management
Interface. It does not affect the outlet ON/OFF status.
Reset All: Clear the Exclude TCP/IP checkbox to reset all configuration values; mark the
Exclude TCP/IP checkbox to reset all values except TCP/IP and EAPoL.
Reset Only: (Resetting may take up to a minute) Options include:
• TCP/IP settings: Set TCP/IP Configuration to DHCP & BOOTP, its default setting, request
requiring that the device receive its TCP/IP settings from a DHCP or BOOTP server. See “View
the result of the test DNS in the Last Query Response field.” EAPoL is reset to disabled.
• Event configuration: Reset all changes to event configuration, by event and by group, to their
default settings.
• RPDU to Defaults.
92990-5848C-001
Page 95
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Configuration
About the Configuration Tab
Under the Configuration tab, several menu options are available to make changes to the devices:
• View the load status for the device
• Configure load thresholds for all connected phases and banks.
• Manage and control outlets
• Configure a name and location for the device
• View and manage the peak load measurement
• Click user-configurable links to open web pages for
Configure Load Thresholds
Path: Configuration > RPDU
View the load for the phases and banks. The indicator in the green, yellow, and red meter shows
the current load status: normal, near overload, or overload. If a low load threshold was configured,
the meter will include a blue segment to the left of the green.
NOTE: The device generates an alarm when any bank exceeds its configured value. However, if a
circuit breaker trips, there is no definitive indication that the circuit breaker is open, other than that
the current for that bank will drop. Set the Low Load Warning t
• The default setting for the Low Load Warning is 0 amps. This effectively disables the warning.
With a setting of 0 amps for the Low Load Warning, the Web User Interface will not indicate
that a circuit breaker may have tripped.
A 1 amp detection threshold for the Low Load Warning for Bank Load Management will help to
•
indicate that a circuit breaker may have tripped.
To configure load thresholds
1. To configure load thresholds for the device, phases, or banks, make a selection from the
Configuration > RPDU > Phase and Bank drop-down menu. To configure load thresholds
for outlets, click Configuration and then click an outlet.
specific devices connected to the device
o 1 amp for these reasons:
2. Set Overload Alarm, Near Overload Warning, and Low Load Warning thresholds.
3. Click Apply to save your settings.
Configure Device Name and Location
Path: Configuration > RPDU > Device
The name and location you enter will appear on the Home tab.
1. Enter a name and location and contact.
2. Click Apply to save.
990-5848C-00193
Page 96
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Set the Coldstart Delay for the Device
Path: Configuration > RPDU > Device
The Coldstart Delay is the number of seconds added to each outlet’s Power On Delay before an
outlet will turn on after power is applied to the device. Allowed values are from 1 to 300 seconds,
Immediate, or Never (never turn on).
1. Make a selection for Coldstart Delay.
2. Click Apply.
Set the Overload Outlet Restrictions
Path: Configuration > RPDU > Phase and Bank
Prevent users from applying power to outlets during an overload condition. You can set the
following restrictions for each phase and bank:
• None: Users can apply power to outlets regardless of an Overload Alarm or Near Overload
Warning.
• On Warning: Users cannot apply power to an outlet on the selected phase or bank if the
current for that phase or bank has exceeded the Near Overload Warning threshold.
• On Overload: Users cannot apply power to an outlet on the selected phase or bank if the
current for that phase or bank has exceeded the Overload Alarm threshold.
To set Overload Outlet Restrictions:
1. Click the Configuration tab, then RPDU, then phase or bankfrom the menu.
2. Make selections for Overload Outlet Restriction.
3. Click Apply.
Configure Phase Load Balance
Path: Configuration > RPDU > Phase
The Phase Load Balance alarm is only available for units with two or more metered phases.
Specify a warning threshold (in Amps) between 0 and the maximum phase current rating, then
select Enable under Alarm Generation. O
Warning alarm if the phases are out of balance by more than the specified number of Amps.
nce this feature is enabled, the RPDU will generate a
94990-5848C-001
Page 97
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Configure and Control Outlet Groups
Outlet group terminology
An outlet group consists of outlets that are logically linked together on the same device. Outlets
that are in an outlet group turn on, turn off, and reboot in a synchronized manner:
• A local outlet group consists of two or more outlets on a device. Only the outlets in that group
are synchronized.
• A global outlet group consists of one or more outlets on a device. One outlet is configured as a
global outlet, which logically links the outlet group to outlet groups on up to three other devices.
All outlets in the linked global outlet groups are synchronized.
- For global outlet groups, the initiator outlet group is the group that issued the action.
- For global outlet groups, a follower outlet group is any other outlet group that is
synchronized with the initiator outlet group.
When you apply an outlet control action to outlets that are members of an outlet group, the outlets
are synchronized as follows:
For a global outlet group, use the delay periods and reboot duration configured for the global
•
outlet of the initiator outlet group.
• For a local outlet group, the outlets use the delay periods and reboot duration of the lowestnumbered outlet in the group.
Purpose and benefits of outlet groups
By using groups of synchronized outlets on devices, you can ensure that outlets turn on, turn off,
and reboot in a synchronized manner. Synchronizing control group actions through outlet groups
provides the following benefits.
• Synchronized shutdown and startup of the power supplies of dual-corded servers prevents
erroneous reporting of power supply failures during a planned system shutdown or reboot.
Synchronizing outlets by using outlet groups provides more precise shutdown and restart
•
timing than relying on the delay periods of individual outlets.
• A global outlet is visible to the user interface of any device to which it is linked.
System requirements for outlet groups
To set up and use synchronized outlet control groups:
• You need a computer that can initiate synchronized control operations through the Web User
Interface or Command Line Interface of the devices or through SNMP.
All of the Rack devices must use firmware that has the same version number for both APC’s
•
APC Operating System (AOS) module and the application module.
• All of the devices must be configured with the same “Member Name”.
• If you are using Network mode, you will also need the following items.
- You need a 10/100Base-T TCP/IP network, with an Ethernet hub or switch that has a power
source not shared by the computers or other devices being synchronized.
- All of the devices must be on the same subnet.
- Outlet groups you synchronize must have the same Multicast IP address, outlet group port,
authentication phrase, and encryption phrase. Make sure each Ethernet switch that
connects devices allows Multicast network traffic for that Multicast IP address.
990-5848C-00195
Page 98
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Rules for configuring outlet groups
For a system that uses outlet groups, the following rules apply:
• A device can have more than one outlet group, but an outlet can belong to only one outlet
group.
• A local outlet group, which has no global outlet, must consist of two or more outlets.
• You can synchronize a global outlet group on one device with a global outlet group on each of
three other devices.
- In a global outlet group, you can designate only one outlet to be a global outlet, linking to
outlet groups on other devices for the purpose of synchronization. That global outlet can be
the only outlet in its group, or the group can consist of multiple outlets.
- A global outlet of one outlet group must have the same physical outlet number as the global
outlet of any other outlet group to which it links.
To create and configure outlet groups, you must use the Web User Interface or export
•
configuration file (.ini file) settings from a configured device. The Command Line Interface lets
you display whether an outlet is a member of an outlet group and lets you apply control actions
to an outlet group, but the Command Line Interface does not let you set up or configure an
outlet group.
96990-5848C-001
Page 99
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Enable outlet groups
Path: Configuration > RPDU > Switched Outlet > Outlet Groups
Configure the following parameters, and click Apply.
Enable creation of outlet groups:
ParametersDescription
Device Level
Outlet Group
To create an outlet group, you must enable the desired group method. Choices
are: Disabled, Local Only, and Enabled via Network.
Enable support for global outlet groups (linked groups):
ParametersDescription
To link outlet groups on multiple devices, you must define the same Member
Member Name
name on each of the devices.
NOTE: A maximum of four devices can be configured with the same Member
name
Setting parameters for outlet groups using Network mode:
ParametersDescription
To link outlet groups on multiple devices, you must define the same Multicast IP
Multicast IP
Authentication
Phrase
address on each of the devices.
NOTE: A maximum of four devices can be configured with the same Member
name and Multicast IP address.
A phrase of 15 to 32 ASCII characters that verifies that the device is
communicating with other devices, that the message has not been changed
during transmission, and that the message was communicated in a timely
manner. The authentication phrase indicates that it was not delayed and that it
was not copied and sent again later at an inappropriate time.
Encryption
Phrase
Outlet Group Port
NOTE: Devices attempting to synchronize with Outlet Groups on other devices using network
mode must all have the same Authentication Phrase and Encryption Phrase. The values are
hidden to the user.
A phrase of 15 to 32 ASCII characters that ensures the privacy of the data (by
means of encryption).
The port number on which the device will communicate with other devices. This
must be the same on all devices in a group.
Create a local outlet group
Path: Configuration > RPDU > Switched Outlet > Outlet Groups
1. Make sure outlet groups are enabled. (See “Typical outlet group configurations” on page 99.)
2. Click Create Local Outlet Group.
3. Select the checkboxes of the outlets that will be in the group and assign the group a name in
the Outlet Group Name field. You must select at least two outlets.
990-5848C-00197
Page 100
Rack PDU and In-Line Current Meter AP7XXXB User Guide
Create a global outlet group
Path: Configuration > RPDU > Switched Outlet > Outlet Groups
To set up multiple global outlet groups that link to outlet groups on other devices:
1. Make sure outlet groups are enabled. (See “Typical outlet group configurations” on page 99.)
2. Click Create Global Outlet Groups.
3. Select the checkboxes of the outlets that will be in the group and then click "Apply and Select Global Outlets" to select the global outlet for the group. If there is only one outlet in the
group, it will automatically be assigned as the global outlet.
4. To add outlets to any of the global outlet groups you created, see “E
group”.
Edit or delete an outlet group
Path: Configuration > RPDU > Switched Outlet > Outlet Groups
1. In the Configure Group table, click on the number or name of the outlet group to edit or
delete.
2. When editing an outlet group you can do any of the following:
- Rename the outlet group.
- Add or remove outlets by clicking the checkboxes to mark or unmark them.
NOTE: You cannot remove an outlet from an outlet group that contains only two outlets
unless the remaining outlet is a global outlet.
3. To delete the outlet group, click Delete Outlet Group.
dit or delete an outlet
98990-5848C-001
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.