APC Command Line Interface manual Command Syntax, Characters and Fonts

Page 11

Command Syntax

Characters and Fonts

Item

Explanation

 

 

Italic

Variables, such as outlet_number, are italicized.

A vertical line between items enclosed in

 

brackets [ ] or braces {}indicates that the items

 

are mutually exclusive; you cannot use more

 

than one of the items.

[ ]

Brackets enclosing an item or series of items

 

indicates that the item or series is optional. Any

 

item not enclosed in brackets or braces is

 

required.

{}

Braces enclosing two or more items, separated

 

by the vertical line character, indicate that the

 

items are mutually exclusive but that you must

 

use one of the items. Any item not enclosed in

 

braces or brackets is required.

 

Large braces have the same meaning as braces

 

{}, but items are “stacked” on separate lines

 

within the large braces to simplify complex

 

syntax.

...

Ellipses following a variable item indicate that

 

additional items of the same type can follow.

All other

All unitalicized text and all punctuation marks

characters

are to be entered literally.

Command Line Interface (CLI) User’s Guide

7

Page 10 Page 12
Image 11
Page 10 Page 12
Contents User’s Guide Page Contents Index Scripting FeaturesPDU features not supported by the CLI Product CapabilitiesRack PDUs required System RequirementsExporting an .ini File Firmware version requiredHow to Enter CLI Commands Using the CommandsFormat Command Error CodesCLI reports all errors in the following format CLI Online HelpLogging On User Name and PasswordLog-on procedure Logging On and OffAutomatic log-off Log-off procedureLogging Off Characters and Fonts Command SyntaxBrackets and ellipses Syntax ExamplesItalic text with no brackets or braces Braces and vertical lineUser Management Overview Command ReferenceTypes of users who can access the CLI Authentication of usersAdduser User Management CommandsDeluser username AssignOutlet assigned to johnreynolds DeluserPasswd Whoami UnassignUnassign outletrange,outletrange... username Outlet no longer assigned to johnreynoldsSynchronized outlet groups Access to outletsOutlet Overview Off outletrange,outletrange Outlet CommandsOff Web Server Outlet turned on On 1,5-7On Web Server Outletgroups Outletnumber outletname Power off delay is time seconds PoweroffdelayOutletnumber outletname Power on delay is time seconds PowerondelayReboot Web Server RebootReboot outletrange,outletrange Reboot 1,5-7Outletnumber outletname Reboot duration is time seconds RebootdurationRebootduration outletrange,outletrange Rebootduration outletrange,outletrange...timeOutletnumberoutletstatusoutletname StatusStatus outletrange,outletrange OK currentA Switched Rack PDU CommandsAccess All three account types with access to the CLI CurrentUser outletnumber, outletnumber ListName outlet newname Lowloadwarning phasenumber currentLowloadwarning NameNear overload warning threshold is currentA Nearoverloadwarning phasenumberNearoverloadwarning Overloadalarm phasenumber current OverloadalarmOverloadrestriction Overloadrestriction phasenumberOverload restriction is setting for phasenumber Setting overload for phasenumber to settingPowerinvolt-ampsVApowerinwattsW PducoldstartdelayPower Help General Management CommandsResetdefaultspdu ExitBytes have successfully been transmitted UploadiniStart XMODEM-CRC Transfer Now 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