The information presented in this manual is not warranted by the APC by 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, APC by 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 APC 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 APC BY SCHNEIDER ELECTRIC, OR ANY PARENT, AFFILIATE OR SUBSIDIARY
COMPANY OF APC by 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,
ARISING OUT, OR IN CONNECTION WITH THE USE OF, OR INABILITY TO USE THIS PUBLICATION OR
THE CONTENT, EVEN IF APC BY SCHNEIDER ELECTRIC HAS BEEN EXPRESSLY ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES. APC BY 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 APC by 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.
The APC by Schneider Electric™ Rack Automatic Transfer Switch (ATS) provides reliable, redundant
power to single-corded equipment loads, such as servers. The Rack ATS has two input power cords
supplying power to the connected loads from both a primary and secondary power source. If the primary
source becomes unavailable or goes out of the configured power range, the Rack ATS will switch to
draw power from the secondary source without interrupting critical loads. You can manage a Rack ATS
through its web interface, its command line interface (CLI), StruxureWare™ Data Center Expert, or
Simple Network Management Protocol (SNMP). (To use the PowerNet® MIB with an SNMP browser,
see the PowerNet SNMP Management Information Base (MIB) Reference Guide, available at
www.apc.com.)
Product Features
The Rack ATS has these additional features:
• LED indicators on the front panel of the unit indicate operation conditions such as preferred
source, overload current, and web connectivity. These conditions can also be monitored via the
command line interface (CLI) and web interface.
• Various levels of access: Super User, Administrator, Device User, Read-Only, and Network-Only
User (These are protected by user name and password requirements).
• A multiple-user login feature, which allows up to four users to be logged in simultaneously.
• Event and data logging. The event log is accessible by Telnet, Secure CoPy (SCP), File Transfer
Protocol (FTP), serial connection, or web browser (using HTTPS access with SSL, or using HTTP
access). The data log is accessible by web browser, SCP, or FTP.
• SNMP traps, Syslog messages, and e-mail notifications based on the severity level or category of
the Rack ATS and NMC system event.
• Security protocols for authentication and encryption.
• The ability to monitor sources and set source-transfer parameters via web and CLI interfaces.
• Set alarm thresholds that provide network and visual alarms to help you prevent overloaded
circuits.
• Internal protection against short circuits. (See “Internal Protections” on page 2 for details.)
NOTE: It is always recommended that you connect each ATS source to a Double Conversion
On-Line Uninterruptible Power Supply (UPS).
1Rack ATS AP44xx User Manual
Internal Protections
pdu0777a
Source A
Source B
Load
ATS 1
Source A
Source B
Load
ATS 2
Source A
Source B
Load
ATS 3
ATS models may include the following internal protections:
• Input relays in every model open
when their source is disconnected to
prevent electric backfeed from one
input cord into another (ATS 1).
• Two or four non-replaceable fuses
(depending on the model) protect the
ATS from short circuits (ATS 2).
• Some 2U models have circuit
breakers for bank overload
protection (ATS 3).
The rack ATS does not include power surge protection. To protect your ATS from external power surges,
it is always recommended that you connect each ATS source to a Double Conversion On-Line
Uninterruptible Power Supply (UPS).
How Switching Works
1. You configure the ATS to accept power that meets the needs of your equipment by adjusting the
following settings (see “Configuration Tab” on page 70 for more details).
– Line VRMS: the ideal voltage for your equipment. Acceptable line voltages vary per ATS
model and can be found on your ATS specification sheet (visit www.apc.com).
– Transfer limits: The maximum and minimum voltages the ATS will accept before switching to
the other source. These are meant to allow for small, acceptable surges and drops in power.
The ATS should not run near the upper transfer limit for long periods of time.
– Transfer ranges: Pre-defined sets of transfer limits. You can configure up to three transfer
ranges.
– Sensitivity: How long the ATS waits to determine whether or not it will switch sources.
High sensitivity provides extra responsiveness for delicate equipment. Low sensitivity prevents
excessive switching in cases of fluctuating power inputs.
Rack ATS AP44xx User Manual2
2. The ATS constantly monitors the quality and amount of power coming from sources A and B. If
pdu0776a
Source A
Source B
Attached Equipment
Source A
Source B
Attached Equipment
Source A
Source B
Attached Equipment
Source A is providing power to the attached equipment, while Source B is isolated from
the attached equipment.
Firmware detects that Source A is out of the user-specified transfer range. The input
power from Source A is removed by disengaging the relays. (This allows for
out-of-phase switching and significantly reduces the opportunity for relay welding.)
Source B relays are engaged; Source B provides power to the attached equipment.
one source begins to supply power that does not meet your settings, the ATS will disqualify that
source.
a. If the disqualified source is not in use, the ATS will generate an alarm indicating
redundancy has been lost.
b. If the disqualified source is in use, the ATS will switch to draw power from the other
available source.
c. If a preferred source is set, the ATS will wait 30 seconds to monitor that source. After 30
seconds, if the preferred source become stable again, the ATS will switch back to the
preferred source. Below is an illustration of how the switch happens
NOTE: The entire switching process (described in step 2) takes a maximum of 10
milliseconds (ms) at high sensitivity, and 12 ms at low sensitivity.
3Rack ATS AP44xx User Manual
Types of User Accounts
The Rack ATS has various levels of access (Super User, Administrator, Device User, Read-Only User,
and Network-Only User), which are protected by user name and password requirements. Up to four
users are allowed to log on to the same Rack ATS simultaneously (available in AOS version 6.1.3 or
later).
• An Administrator or the Super User can use all of the menus in the web interface 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 or an Administrator are both
apc.
– The Super User or an Administrator can manage another Administrator's account (enable,
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 are unavailable.
• A Read-Only User has access to the same menus as a Device User, but without the ability 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.
A Network-Only User can only log on using the web interface and CLI (telnet, not serial). A NetworkOnly User has read/wright access to the network related menus only.
Getting Started
To start using the Rack ATS:
1. Install the Rack ATS using the Installation and Quick Start on www.apc.com.
2. Apply power and connect to your network. Follow the directions in the Installation and Quick
Start.
3. Establish your network settings.
4. Begin using the Rack ATS with one of the following:
– The front panel. See “Front Panel” on page 11.
NOTE: The front panel allows you to view Rack ATS settings, but not configure them.
– The CLI. See “Command Line Interface” on page 14.
– The web interface. See “Web Interface” on page 62.
Rack ATS AP44xx User Manual4
Establish Network Settings
IPv4 Initial Setup
You must define three TCP/IP settings for the Rack ATS before it can operate on the network:
• The IP address of the Rack ATS
• The subnet mask of the Rack ATS
• The IP address of the default gateway (only needed if you are going off segment)
Caution: Do NOT use the loopback address (127.0.0.1) as the default gateway. Doing so disables the
network connection of the Rack ATS. 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 at a Rack ATS,
see.“DHCP response options” on page 79
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 IPv6 using the CLI, the web
interface, or DHCP.
TCP/IP Configuration Methods
Use one of the following methods to define the TCP/IP settings needed by the Rack ATS:
• Device IP Configuration Wizard (see “Device IP Configuration Wizard” on this page).
• BOOTP or DHCP server (see “DHCP and BOOTP configuration” on page 6).
• Local computer (see “Local access to the CLI” on page 7).
• Networked computer (see “Remote access to the CLI” on page 8).
.ini file utility
You can use the .ini file export utility to export .ini file settings from a configured Rack ATS to an
unconfigured Rack ATS. For more information, see “Create and import settings with the config file” on
page 94.
Device IP Configuration Wizard
The Device IP Configuration Wizard runs on Microsoft® Windows® 2000, Windows Server® 2003,
Windows Server 2012, and on 32- and 64-bit versions of Windows XP
2008, Windows 7, Windows 8, and Windows 10 operating systems. The Device IP Configuration Wizard
supports cards that have firmware version 3.0.x or higher and is for IPv4 only.
To install the Device IP Configuration Wizard:
1. Go to www.apc.com.
2. Download the latest version of the Device IP Configuration Wizard.
3. Run the executable file (DeviceIPConfigurationWizard.exe).
NOTE: If you leave the Start a Web browser when finished option enabled, you can use apc
for both the user name and password to access the Rack ATS through your browser.
®
, Windows Vista®, Windows
When Installed, the Device IP configuration Wizard is available through the Windows Start menu
options.
5Rack ATS AP44xx User Manual
Configure TCP/IP settings with the Wizard. : The Device IP Configuration Wizard can discover Rack
ATSs that do not have an IP address assigned. Once discovered, you can configure the IP address
settings for the Network Management Cards (NMCs).You can also search for devices already on the
network by entering an IP range to define the search. The Utility scans the IP addresses in the defined
range and discovers Rack ATSs that already have a DHCP-assigned IP address.
NOTE: For detailed information on the Utility, visit the Knowledge Base on the support page on
www.apc.com and search for FA156064 (the ID of the relevant article).
NOTE: To use the DHCP Option 12 (AOS 5.1.5 or higher), see Knowledge Base ID FA156110.
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 the Rack ATS. 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
“Create and import settings with the config file” on page 94.
If neither of these servers is available, see “Device IP Configuration Wizard” on page 5.
BOOTP. : For the Rack ATS to use a BOOTP server to configure its TCP/IP settings, it must find a
properly configured RFC951-compliant BOOTP server.
1. In the BOOTPTAB file of the BOOTP server, enter the Rack ATS’s MAC address, IP address,
subnet mask, and default gateway, and, optionally, a bootup file name. Look for the MAC address
on the bottom of the Rack ATS.
2. When the Rack ATS reboots, the BOOTP server provides it with the TCP/IP settings.
– If you specified a bootup file name, the Rack ATS attempts to transfer that file from the
BOOTP server using TFTP or FTP. The Rack ATS assumes all settings specified in the bootup
file.
– If you did not specify a bootup file name, you can configure the other settings of the Rack ATS
remotely through its web interface (see “Web Interface” on page 62) or CLI (see “Remote
access to the CLI” on page 8) The default user name and password are apc for both
interfaces. To create a bootup file, see your BOOTP server documentation.
Rack ATS AP44xx User Manual6
DHCP. You can use an RFC2131/RFC2132-compliant DHCP server to configure the TCP/IP settings for
the Rack ATS.
1. The Rack ATS sends out a DHCP request that uses the following to identify itself:
– A Vendor Class Identifier (APC by default)
– A Client Identifier (by default, the MAC address of the Rack ATS)
– A User Class Identifier (by default, the identification of the application firmware installed on the
Rack ATS)
– A Host Name (by default, apcXXYYZZ with XXYYZZ being the last six digits of the ATS serial
number). 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 Rack ATS needs for network communication. The DHCP offer also includes the Vendor
Specific Information option (DHCP option 43). The Rack ATS can be configured to ignore DHCP
offers that do not encapsulate the APC cookie in DHCP option 43 using the following
hexadecimal format. (The Rack ATS does not require this cookie by default.)
Option 43 = 01 04 31 41 50 43
– The first byte (01) is the code.
– 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.
NOTE: By selecting the Require vendor specific cookie to accept DHCP Address check
box in the web interface, you can require the DHCP server to provide an “APC” cookie, which
supplies information to the Rack ATS.
Local access to the CLI
You can use a local computer to connect to the ATS and access the CLI.
1. Select a serial port at the local computer and disable any service that uses that port.
2. Use the communication cable to connect the selected port to the serial port on the front panel of
the ATS.
3. Run a terminal program (such as HyperTerminal®) and configure the selected port for 9600 bps,
8 data bits, no parity, 1 stop bit, and no flow control. Save the changes.
4. Press
5. Use apc for the user name and password.
6. See “Configure TCP/IP settings in the CLI” on page 8 to finish the configuration.
ENTER up to 3 times to display the User Name prompt.
7Rack ATS AP44xx User Manual
Remote access to the CLI
From any computer on the same network as the Rack ATS, you can use ARP and Ping to assign an IP
address to the Rack ATS, and then use Telnet to access the CLI of that Rack ATS and configure the
other TCP/IP settings.
NOTE: After the IP address of the Rack ATS is configured, you can access the Rack ATS using Telnet or
SSH, without first using ARP and Ping. You must enable SSH before using it, so Telnet is required for
initial CLI configuration.
1. Use ARP to define an IP address for the Rack ATS and use the MAC address of the Rack ATS in
the ARP command. For example, to define an IP address of 156.205.14.141 for a Rack ATS that
has a MAC address of 00 c0 b7 63 9f 67, use one of the following commands:
– Windows command format:
arp -s 156.205.14.141 00-c0-b7-63-9f-67
– LINUX command format:
arp -s 156.205.14.141 00:c0:b7:63:9f:67
NOTE: The MAC address can be found on the bottom of the ATS.
2. Use Ping with a size of 113 bytes to assign the IP address defined by the ARP command. For
example:
– Windows command format:
ping 156.205.14.141 -l 113
– LINUX command format:
ping 156.205.14.141 -s 113
3. Use Telnet to access the Rack ATS at its newly assigned IP address. (For example:
telnet 156.205.14.141) Use apc for both user name and password.
(See “Remote access to the CLI” on page 14)
See “Configure TCP/IP settings in the CLI” on page 8 to finish the configuration.
Configure TCP/IP settings in the CLI
1. Log on to the CLI. See “Log on to the CLI” on page 14.
2. Contact your network administrator to obtain the IP address, subnet mask, and default gateway
for the Rack ATS.
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
tcpip -i 156.205.14.141
4. Type exit, and then press
ENTER. The Rack ATS restarts to apply the changes.
ENTER:
Rack ATS AP44xx User Manual8
Network Management with Other Applications
These applications and utilities work with a Rack ATS that is connected to the network.
• PowerNet
SETs and GETs and use SNMP traps
• StruxureWare Data Center Expert — Provide enterprise-level power management and
management of agents, Rack ATSs, and environmental monitors.
• Device IP Configuration Utility — Configure the basic settings of one or more Rack ATSs over the
network (see “Device IP Configuration Utility”).
• Security Wizard — Create components needed to help with security for the Rack ATSs when you
are using Secure Sockets Layer (SSL) and related protocols and encryption routines.
Management Information Base (MIB) with a standard MIB browser — Perform SNMP
Recover from a Lost Password
You can use a local computer (a computer that connects to the Rack ATS 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 (APC by Schneider Electric part number 940-0144A) to the selected port
on the computer and to the Serial port on the Rack ATS.
3. Run a terminal program (such as HyperTerminal
8 data bits, no parity, 1 stop bit, and no flow control.
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 from apc
8. Type quit or exit, and then press
9. Reconnect any serial cable you disconnected, and restart any service you disabled.
ENTERup to 3 times 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. When the LED begins flashing, immediately press the
Reset button a second time to temporarily reset the user name and password to their defaults.
ENTER, repeatedly if necessary, to display the User Name prompt again, then use 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.)
to a password of your choice:
user -n <user name> -pw <user password>
For example, to change the Super User password to XYZ type:
user -n apc -cp apc -pw XYZ
ENTERto log off.
®
) and configure the selected port for 9600 bps,
9Rack ATS AP44xx User Manual
Watchdog Features
Overview
To detect internal problems and recover from unanticipated inputs, the Rack ATS uses internal, systemwide 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 Rack ATS implements internal watchdog mechanisms to protect itself from becoming inaccessible
over the network. For example, if the Rack ATS 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 an ATS that discovers an active network interface connection
at start-up.
Resetting the network timer
To ensure that the Rack ATS does not restart if the network is quiet for 9.5 minutes, the Rack ATS
attempts to contact the default gateway every 4.5 minutes. If the gateway is present, it responds to the
Rack ATS, 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
Rack ATS from restarting.
Rack ATS AP44xx User Manual10
Front Panel
Serial
10 /100
USB
Preference
A/B
Automatic
Transfer Switch
B
1
4
78
:
2
35
6
<
=
>
9;
- OK
- Warning
- Overload
x
Reset
NOTE: Your Rack ATS is configured so the display back light turns off after 10 minutes of inactivity.
Press any display navigation button to illuminate the back light.
ItemFunction
Preference A/B ButtonPress to set a preferred source: the first press sets source A, the second
Source A and B LEDsIndicate preferred source. If no source is preferred, both LEDs are
Input Connector LEDsProvide information about input voltage from each source. If the RMS
Output Connector LEDsIndicate which source is being used for the output (only one path will be
Output LEDShows that voltage is available at the output of the ATS.
LCD DisplayView ATS status, settings, and product information. See “Front Panel
Display navigation buttonsOn the LCD Display, icons indicate the purpose of adjacent buttons.
press sets source B, and the third press sets no preference.
illuminated. You can also see preferred source on the LCD Display.
input voltage and measured frequency are within the selected tolerance
range, the corresponding indicator will be illuminated. In a normal
operating condition (full source redundancy) both sets of LEDs are
illuminated.
illuminated at any time). Together, the Source Preference LEDs, the
Connector LEDs, and the Output LED show the power flow through the
ATS .
Screens” on page 13 for more information on LCD display screens.
Home: Press to move through monitor screens or return to monitor
screens from sub-menus.
Netwo rk
pdu0733b
Down: Press to move through monitor screens or menu items.
Select: Press to select menu items or navigate to the main menu from
monitor screens.
Load Status LEDSee “Load Status LED” on page 12
Network Status LEDSee “Network Status LED” on page 12
10/100 Base-T ConnectorConnects the ATS to the network.
10/100 Status LED See “10/100 Status LED” on page 12.
USB portUse USB drives for firmware upgrades.
Serial portConnect your computer to the ATS for local access to the command line
Reset switchRestarts ATS network and serial communication.
interface. Use the supplied Serial Communication cable (APC by
Schneider Electric part number 940-0144A).
11Rack ATS AP44xx User Manual
Load Status LED
This LED identifies overload and warning conditions for the ATS. For more information on warning
conditions, see “Configure warning thresholds” on page 71.
ConditionDescription
GreenThe Rack ATS current is below the Near Overload Warningthreshold.
YellowThe Rack ATS current is above the Near Overload Warningthreshold.
RedThe Rack ATS current is above the Overload Alarmthreshold.
Network Status LED
This LED indicates the network status.
ConditionDescription
OffThe device that connects the Rack ATS to the network is off or not
Flashing GreenThe Rack ATS is receiving data packets from the network at 10 Megabits
Flashing OrangeThe Rack ATS is receiving data packets from the network at 100
Solid Green or OrangeThe Rack ATS is receiving no network traffic.
operating correctly.
per second (Mbps).
Megabits per second (Mbps).
10/100 Status LED
This LED indicates the network status of the Rack ATS.
ConditionDescription
OffThe Rack ATS is connected to an unknown network.
Solid greenThe Rack ATS has valid TCP/IP settings.
Flashing greenThe Rack ATS does not have valid TCP/IP settings.
Solid orangeA hardware failure has been detected in the Rack ATS.
Flashing orangeThe Rack ATS is making BOOTP requests.
Flashing Orange
and Green
(alternating)
1
If you do not use a BOOTP or DHCP server, see “TCP/IP Configuration Methods” on
page 5 for more options.
The Rack ATS is making DHCP requests.
1
Rack ATS AP44xx User Manual12
Front Panel Screens
The front panel LCD Display automatically rotates between 4 monitor screens. You can move through
these screens manually by pressing Home or Down , or go to the Main Menu by pressing Select
.
Monitor Screens
Load Status (color): View the total ATS load in amps. A status symbol next to the total load indicates
the status of the ATS (see “Device status icons” on page 64). Meters show the load for the ATS (T) and
for individual banks (1, 2).The placement of the vertical line on colored meters indicates the current load
status:
• green = normal
• yellow = near overload
• red = overload
NOTE: If a low load threshold was configured, meters will also include a blue segment to indicate low
load.
Source Status: View power measurements for both sources. The active power source is green, and the
preferred source has a checked box next to it. When alarms happen, an Alarm Status bar will appear
across the top of this screen.
Load Status (no color): Meters indicate the amount of available load being used in the ATS (T) and in
individual banks (1, 2). The total load is also listed in Amperes (A). A status symbol next to the total load
indicates the status of the ATS (see “Device status icons” on page 64).
Preferred Source: The preferred power source is green, and the secondary source is black. When
alarms happen, an Alarm Status bar will appear across the top of the screen.
Menu Screens
When alarms are present, an Alarm Status bar will appear across the top of all menu screens. After 30
seconds without activity, the LCD display will revert to the main Monitor Screens.
Feed Info: Select Feed A or B to view available power for each power source. Select Preferred Source
to view ATS Preference settings (the preferred source will be green).
Network: View IPv4 address, press Down once to view the IPv6 address, or press Down twice to
view the MAC address.
Software Info: View the installed versions of AOS, APP, and ATS Controller.
SKU/Serial#: View the SKU number and serial number for your Rack ATS.
Alarm Status: View the number of each kind of alarm. If a down arrow is present at the bottom of the
screen, press Down for more detail. Otherwise, press Down to refresh the screen. If an alarm has
been cleared and no alarms are present, the Alarm Status screen will say “All Alarms Cleared”.
13Rack ATS AP44xx User Manual
Command Line Interface
You can use the command line interface (CLI) to configure, manage, and monitor the status of the Rack
ATS. Additionally, the CLI enables you to create scripts for automated operation. You can configure all
parameters of a Rack ATS (including those for which there are not specific CLI commands) by using the
CLI to transfer an INI file to the Rack ATS. 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 Rack ATS.
Local access to the CLI
For local access, use a computer that connects to the Rack ATS through the serial port to access the
CLI:
1. Select a serial port at the computer and disable any service that uses that port.
2. Connect the serial cable (APC by Schneider Electric part number 940-0144A) from the selected
serial port on the computer to the Serial port on the Rack ATS.
3. Run a terminal program (e.g., HyperTerminal) and configure the selected port for 9600 bps, 8
data bits, no parity, 1 stop bit, and no flow control.
4. Press
ENTER. At the prompts, enter your user name and password.
Remote access to the CLI
You can choose to access the CLI through Telnet and/or SSH, depending on which is enabled. Telnet is
enabled by default, though you do not have to enable either. A Super User or Administrator can enable
or disable either of these access methods through the CLI (see “console” on page 23) or the web
interface (see “Configure CLI access” on page 84).
Telnet for basic access. Telnet provides the basic security of authentication by user name and
password, but not the high-security benefits of encryption.
To use Telnet to access the command line interface:
1. At a command prompt, type telnet and the IP address for the Rack ATS (for example, telnet
139.225.6.133, when the Rack ATS uses the default Telnet port of 23), and press
If the Rack ATS 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 require extra commands).
2. Enter the user name and password (by default, apc and apc for the Super User and
Administrator, or device and apc for a Device User).
3. If you cannot remember your user name or password, see “Recover from a Lost Password” on
page 9.
SSH for high-security access. If you use the high security of SSL for the web interface, use SSH for
access to the command line interface. SSH encrypts user names, passwords, and transmitted data. The
interface, user accounts, and user access rights are the same whether you access the command line
interface through SSH or Telnet, but to use SSH, you must first configure SSH and have an SSH client
program installed on your computer. See the Security Handbook on www.apc.com for more information
on configuring and using SSH.
ENTER.
Rack ATS AP44xx User Manual14
About the Main Screen
Schneider Electric Network Management Card AOS vx.x.x
(c)Copyright 2016 All Rights Reserved ATS4g App vx.x.x
-------------------------------------------------------------------------Name : Test Lab Date : 06/30/2016
Contact : Don Adams Time : 5:58:30
Location : Building 3 User : Administrator
Up Time : 0 Days, 21 Hours, 21 Minutes Stat : P+ N4+ N6+ A+
Type ? For command listing
Use tcpip for IP address (-i), subnet (-s), and gateway (-g)
apc>
The following screen is displayed when you log on to the CLI of a Rack ATS.
• 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 (for example,
a Rack ATS).
Network Management Card AOS vx.x.x
ATS4g APPvx.x.x
• Three fields identify the system name, contact person, and location of the Rack ATS.
Name : Test Lab
Contact : Don Adams
Location : Building 3
• An Up Time field reports how long the Rack ATS 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: 6/30/2016
Time: 5:58:30
• The User field identifies whether you logged in through the Super User, Administrator, Device
User, Read-Only, or Network-Only account.
* The N4 and N6 values can be different from one another: you could, for example, have
N4- N6+.
A+
A–
A?
A!
The APC operating system (AOS) is functioning properly.
IPv6
only
IPv4 and
IPv6*
The application is functioning properly.
The application has a bad checksum.
The application is initializing.
The application is not compatible with the AOS.
Description
The network is functioning properly.
A BOOTP request cycle is in progress.
The Rack ATS failed to connect to the network.
Another device is using the Rack ATS IP address.
NOTE: If P+ is not displayed, contact the APC by Schneider Electric Customer Care Center by going to
www.apc.com or by calling 1 (877) 342-5173.
Using the CLI
At the CLI, you can use commands to configure the Rack ATS. To use a command, type the command
and press
are case-sensitive.
ENTER. Commands and arguments are valid in lowercase, uppercase, or mixed case. Options
While using the CLI, you can also do the following:
• Type help or ? and press
ENTER to view a list of available commands, based on your account
type.
• To obtain information about the purpose and syntax of a specified command, type the command,
a space, and ? or the word help.
• Press the
the
• Type at least one letter of a command and press the
UP arrow key to view the command that was entered most recently in the session. Use
UP and DOWN arrow keys to scroll through a list of up to ten previous commands.
TAB key to scroll through a list of valid
commands that match the text you have typed in the command line.
• Type bye, exit or quit to close the connection to the CLI.
Rack ATS AP44xx User Manual16
Command Syntax
ItemDescription
-Options are preceded by a hyphen.
< >Definitions of options are enclosed in angle brackets.
[ ]If a command accepts multiple options or an option accepts mutually exclusive arguments, the values
|A vertical line between items enclosed in brackets or angle brackets indicates that the items are
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:
Example of a command that accepts mutually exclusive arguments for an option:
For example:
may be enclosed in brackets.
mutually exclusive. You must use one of the items.
-dp <device password>
1. Enter the ftp command, the port option, and the argument 5010:
ftp -p 5010
2. After the first command succeeds, enter the ftp command, the enable/disable option, and the
enable selection:
ftp -S enable
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.
17Rack ATS AP44xx User Manual
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
CodeMessage
E000
E001
E002
E100
E101
E102
E103
E104
E105
E106
E200
E201
E202
E203
E204
Success
Successfully Issued
Reboot required for change to take effect
Command failed
Command not found
Parameter Error
Reported when there is any problem with the arguments supplied to the command:
too few, too many, wrong type, etc.
Command Line Error
User Level Denial
Command Prefill
Data Not Available
Input error. Only reported when an error occurs during the execution of a command.
No Response. Reported when a sensor fails to respond.
User already exists
User does not exist
User does not have access to this command.
Rack ATS AP44xx User Manual18
Network Management Card Command Descriptions
? or help
Access: Super User, Administrator, Device User, Read Only, Network Only
Description: View a list of all the CLI commands available to your account type, or view help text for a
apc> alarmcount -p all
E000: Success
AlarmCount: 7
Error Message: E000, E102
21Rack ATS AP44xx User Manual
boot
Access: Super User, Administrator
Description: Allows the user to get/set the network startup configuration of the device, such as setting
boot mode.
Parameters:
Optio
nArgumentDescription
-b<dhcp | bootp | manual>
-c<enable | disable>
-v <vendor class>
-i <client id>
-u <user class>
Define how the TCP/IP settings will be configured when the
Rack ATS turns on, resets, or restarts. See “Configure TCP/IP
and communication settings for IPv4 and IPv6” on page 79 for
information about each boot mode setting.
dhcp
boot mode only: Enable or disable the requirement that
the DHCP server provide the APC cookie.
dhcp
boot mode only: the Vendor Class is APC.
dhcp
boot mode only: the MAC address of the NMC, Which
uniquely identifies it on the network.
dhcp
boot mode only: the name of the application firmware
module.
Example: Using a DHCP server to obtain network settings: