APC Command Line Interface manual Logging On and Off, User Name and Password, Log-on procedure

Page 9

Logging On and Off

Logging On

User Name and Password

If you are not using a KVM, configure the administrator user name and password through the Web or control console interface of the PDU.

If you are using a KVM, configure the administrator user name and password in the KVM configuration file /etc/pm.APCPDU. The default for both is apc. The pm.APCPDU file is saved to non-volatile memory when you save your configuration. The -coption is then appended to the configured password automatically to log you on to the CLI when you log on to the PDU.

Log-on procedure

To log on to the CLI:

1.Connect to the Switched Rack PDU through Telnet, through SSH version 1 or 2, or serially.

2.At the User Name prompt, enter your user name.

3.At the Password prompt, enter your password (followed by a space and -cif you are not using a KVM), and press ENTER.

Responses to successful and failed log-on

When you attempt to log on to the CLI:

•If the user name and password you entered are valid and the CLI is available, you are logged on to the CLI. The prompt APC> is displayed.

•After three consecutive unsuccessful log-on attempts, the Switched Rack PDU prevents further attempts for two minutes.

•If the CLI is unavailable, the Switched Rack PDU application layer does not start, i.e., the -c option does not work.

•If you log onto the CLI, and the application firmware of the Switched Rack PDU has not finished initializing, the CLI displays the following message and logs you off.

The Switched Rack PDU is still initializing. Please try again later.

•If the administrator password is configured incorrectly (does not meet the PDU criteria for a valid password) in the KVM pm.APCPDU configuration file, the Switched Rack PDU prevents further log-on attempts for 150 seconds. Correct the password configuration before trying to log on again.

Command Line Interface (CLI) User’s Guide

5

Page 8 Page 10
Image 9
Page 8 Page 10
Contents User’s Guide Page Contents Index PDU features not supported by the CLI FeaturesProduct Capabilities ScriptingExporting an .ini File System RequirementsFirmware version required Rack PDUs requiredHow to Enter CLI Commands Using the CommandsCLI reports all errors in the following format Command Error CodesCLI Online Help FormatLog-on procedure User Name and PasswordLogging On and Off Logging OnLog-off procedure Logging OffAutomatic log-off Characters and Fonts Command SyntaxItalic text with no brackets or braces Syntax ExamplesBraces and vertical line Brackets and ellipsesTypes of users who can access the CLI Command ReferenceAuthentication of users User Management OverviewAdduser User Management CommandsOutlet assigned to johnreynolds AssignDeluser Deluser usernamePasswd Unassign outletrange,outletrange... username UnassignOutlet no longer assigned to johnreynolds WhoamiAccess to outlets Outlet OverviewSynchronized outlet groups Outlet Commands OffOff outletrange,outletrange On 1,5-7 On Web ServerWeb Server Outlet turned on Outletgroups Outletnumber outletname Power off delay is time seconds PoweroffdelayOutletnumber outletname Power on delay is time seconds PowerondelayReboot outletrange,outletrange RebootReboot 1,5-7 Reboot Web ServerRebootduration outletrange,outletrange RebootdurationRebootduration outletrange,outletrange...time Outletnumber outletname Reboot duration is time secondsStatus Status outletrange,outletrangeOutletnumberoutletstatusoutletname Access All three account types with access to the CLI Switched Rack PDU CommandsCurrent OK currentAUser outletnumber, outletnumber ListLowloadwarning Lowloadwarning phasenumber currentName Name outlet newnameNearoverloadwarning phasenumber NearoverloadwarningNear overload warning threshold is currentA Overloadalarm phasenumber current OverloadalarmOverload restriction is setting for phasenumber Overloadrestriction phasenumberSetting overload for phasenumber to setting OverloadrestrictionPducoldstartdelay PowerPowerinvolt-ampsVApowerinwattsW Resetdefaultspdu General Management CommandsExit HelpUploadini Start XMODEM-CRC Transfer NowBytes have successfully been transmitted Ver Index On, 16 outletgroups, 17 Outlets Index990-2766 11/2005 APC Worldwide Customer Support

Command Line Interface specifications

The APC Command Line Interface (CLI) is a powerful tool offered by American Power Conversion (APC) for managing and configuring various APC devices, such as uninterruptible power supplies (UPS), power distribution units (PDUs), and cooling solutions. The CLI enables users to perform a wide range of functions, from monitoring device status to configuring settings and automating tasks, all through a command-line environment. This capability is particularly beneficial for system administrators and IT professionals who prefer scripting and automation to manage their energy infrastructure.

One of the main features of the APC CLI is its comprehensive control over device parameters. Users can retrieve important information like battery status, load levels, and input/output voltages directly through command-line queries. This instant access to critical data allows for more efficient troubleshooting and monitoring of system health. Additionally, the CLI supports historical data retrieval, giving users the ability to analyze performance trends over time.

Another significant technology underlying the APC CLI is SNMP (Simple Network Management Protocol). SNMP allows for seamless integration with network management systems, enabling users to manage APC devices alongside other networked hardware. The CLI’s compatibility with SNMP makes it easier to incorporate APC devices into larger monitoring frameworks, enhancing overall system management.

Security is a vital characteristic of the APC CLI, as it often involves sensitive operational data. The interface typically supports user authentication, ensuring that only authorized personnel can access critical functions. Features like secure SSH (Secure Shell) connections provide encrypted communication channels for remote device management, protecting against unauthorized access and data breaches.

The APC CLI also provides batch processing capabilities, allowing users to execute multiple commands in a single session. This feature is particularly useful for large-scale operations where numerous devices need to be configured or monitored simultaneously. Automated scripts can be created to execute routine tasks, significantly reducing administrative overhead and minimizing the risk of human error.

In conclusion, the APC Command Line Interface stands out as an essential tool for efficient energy management. Its rich feature set, powered by modern technologies like SNMP and strong security protocols, enables comprehensive control over APC devices. With automation capabilities and real-time data access, the APC CLI is indispensable for IT professionals aiming to optimize their power management strategies and ensure system reliability.
Top Page Image Contents