APCメーカーCommand Line Interfaceの使用説明書/サービス説明書
ページ先へ移動 of 39
User ’ s Guide Command Line Interface for Switched Rack PDUs.
.
Contents Command Line Interface (CLI) User’s Gu ide i Product Capabili ties .......... ................ 1 Features . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Scripting . . . . . . . . . . . . . . . . . . . . . . . . . . 1 PDU features not supported by the CLI .
ii Command Li ne Interf ace (CLI) User’s Gui de Command Reference ........................9 User Management Overview . . . . . . . . . . . . 9 Types of users who can access the CLI . . . 9 Authentication of users . . . . . . . . . . . . . . 9 User Management Commands .
Command Line Interface (C LI) User’s Guide 1 Product Cap abilities Features Scripting The Command Line Interface (CLI) for American Power Conversion (A PC ® ) Switched Rack PDUs enables you to create scripts for automated operation.
2 Command Line Interface (CLI) User’s Guide System Requirement s Firmware version require d T o use the Command Line Interface, your Switched Rack PDU must be running firmware version 2.7.0 for the AOS firmware module and 2.7.3 for the application firmware module.
Command Line Interface (C LI) User’s Guide 3 Using the Commands How to Enter CLI Commands Capit alization in commands and argument s Commands are valid in lo wercase, uppercase, or mixed case, but arguments are case-sensitive unless specified otherwise.
4 Command Line Interface (CLI) User’s Guide Command Error Codes Format The CLI reports all errors in the following form at: E[0-9][0-9][0-9]: Error message The CLI reports all successful command operations with the m essage OK , followed by the output of the command.
Command Line Interface (C LI) User’s Guide 5 Logging On and Off Logging On User Name and Password If you are not using a KVM, configure the administrator u ser name and password through the W eb or control consol e interface of the PDU.
6 Command Line Interface (CLI) User’s Guide Logging Off Log-off proce dure T o lo g of f from the CLI, use one of the fol lowing commands: exit , logout , logoff , quit , or bye .
Command Line Interface (C LI) User’s Guide 7 Command Synt ax Characters and Font s Item Explanation Italic V ariables, such as outlet_number , are italici zed. | A vertical line betw een items encl osed in brackets [ ] or braces {}indic ates that th e items are mutually exclusive; you cannot use more than one of the items.
8 Command Line Interface (CLI) User’s Guide Synt ax Examples It alic text with no bracket s or braces. adduser user_name For the adduser command, you must specify the name of the user to add (indicated in the synt ax by the variable user_name .
Command Line Interface (C LI) User’s Guide 9 Command Reference User Management Overview T ype s of users who can access the CLI The CLI is accessible to three of the four user types supported by the Switched Rack PDU: • The administrator has unrestricted access.
10 Command Line Interface ( CLI) User’s Guide User Management Commands adduser Synt ax: adduser user_name Description: Add an outlet user to the local database. Until an outl et user is explicitly assigned access to specific outlets, that user , by default, has no outlet access.
Command Reference: User Management Command Line Interface (C LI) User’s Guide 11 assign Synt ax: assign outlet|range [, outlet | range ...] user_name Description: Grant access to specifi ed outlets to a user configured in the local dat abase. (Outlet permissions for RADIUS-d efined users can be configured only at the RADIUS server .
Command Reference: User Management Commands 12 Command Line Interface ( CLI) User’s Guide pa s s w d Synt ax: passwd|password [ user_na me ] Description: T o be prompted to change your password, omit u ser_name . As an ad ministrator , specify a user name to be prompted to change that user ’ s password.
Command Reference: User Management Command Line Interface (C LI) User’s Guide 13 unassign Synt ax: unassign outlet | range [, outlet | range ...] user_name Description: Remove access to specified outlets from a user configured in the local database.
14 Command Line Interface ( CLI) User’s Guide Outlet Overview Access to outlet s An administrator or an outlet user can use all the CLI outlet commands to manage outl ets, but an outlet user can use these commands to manage only the outlets to which he or she has been granted access.
Command Line Interface (C LI) User’s Guide 15 Outlet Commands off Synt ax: all off outlet | range [, outlet | range .. .] Description: T urn off one or more outlets. If you specify more than one outlet, the outlets will turn off approximately at the same time.
Command Reference: Outlet Commands 16 Command Line Interface ( CLI) User’s Guide on Syntax: all on outlet | range [, outlet | range ...] Description: T urn on one or more outlets. If you specify more than one outlet, the outlets will turn on approximately at th e same time.
Command Reference: Outlet Commands Command Line Interface (C LI) User’s Guide 17 outletgroup s Synt ax: outletgroups Description: List the outlet synchroni zation groups defined on the Switched Rack PDU. If synchronization of outlets among PDUs is en abled, command output also includes information on those devices.
Command Reference: Outlet Commands 18 Command Line Interface ( CLI) User’s Guide poweroffde lay Synt ax (to read the power-off delay): poweroffdelay [ outlet | range ][, outlet | range ...] Synt ax (to set the power-off delay): poweroffdelay outlet | range [, outlet | range .
Command Reference: Outlet Commands Command Line Interface (C LI) User’s Guide 19 powerondela y Synt ax (to display the power-on delay): powerondelay [ outlet | range ][, outlet | range ...] Synt ax (to set the power-on delay): powerondelay outlet | range [, outlet | range .
Command Reference: Outlet Commands 20 Command Line Interface ( CLI) User’s Guide reboot Synt ax: all reboot outlet | range [, outlet | range ...] Description: Remove and then restore power to one or more outlets. The CLI does not wait for the reb o ot command to comple te before pr oviding output and re-displayi ng the CLI prompt ( APC> ).
Command Reference: Outlet Commands Command Line Interface (C LI) User’s Guide 21 reboot duration Synt ax (to read the reboot duration): rebootduration [ outlet | range ][, outlet | range ...] Synt ax (to set the reboot duration): rebootduration outlet | range [, outlet | range .
Command Reference: Outlet Commands 22 Command Line Interface ( CLI) User’s Guide status status outlet | range [, outlet | range ...] Description: Reads the status (ON or OFF) of outlets that you specify from among the outlets assigned to you. A trailing asterisk (*) aft er the status in the output indicat es that a control action is pending.
Command Line Interface (C LI) User’s Guide 23 Switched Rack PDU Commands current Synt ax: current Description: Displays the total cur rent draw in amps.
Command Reference: Swit ched Rack PDU Commands 24 Command Line Interface ( CLI) User’s Guide list Synt ax: list Description: When the administrator or device manager (device-only user) uses the comm.
Command Reference: Switched Rack PDU Command Line Interface (C LI) User’s Guide 25 lowloadwarning Synt ax (to read the low -load warning thres hold): lowloadwarning [ phase_n umber ] Synt ax (to set the low-load warning threshold): lowloadwarning phase_nu mber current Description: Set or read the low-load warning threshold.
Command Reference: Swit ched Rack PDU Commands 26 Command Line Interface ( CLI) User’s Guide nearoverloadwa rning Syntax (to read the ne aroverload al arm threshol d): nearoverloadwarning [ phase_nu.
Command Reference: Switched Rack PDU Command Line Interface (C LI) User’s Guide 27 overloadalarm Syntax (to read the ov erload alar m thresh old): overloadalarm [ phase_number ] Synt ax (to set the over load alarm threshold): overloadalarm phase_numb er curr ent Description: Set or read the overload alarm threshold.
Command Reference: Swit ched Rack PDU Commands 28 Command Line Interface ( CLI) User’s Guide overloadre striction Synt ax to read the o verload restriction: overloadrestriction [ phase_number ] Synt.
Command Reference: Switched Rack PDU Command Line Interface (C LI) User’s Guide 29 p ducoldst artdelay Synt ax (to read the cold-start delay): pducoldstartdelay Synt ax (to set the cold-start delay).
30 Command Line Interface ( CLI) User’s Guide General Management Commands exit Synt ax: {exit|logout|logoff|quit|by e} Description: Exit from the CLI interface.
Command Reference: General Management Command Line Interface (C LI) User’s Guide 31 uploadini Syntax: uploadini Description: Upload an INI file, usin g XMODEM, when you are accessing the CLI through a serial connection.
Command Reference: Gene ral Management Commands 32 Command Line Interface ( CLI) User’s Guide ver Synt ax: ver Description: Displays informati on about the Switched Rack PDU and its configuratio n. Access: All three user types with access to the CLI.
Command Line Interface (C LI) User’s Guide 33 A adduser , 10 assign , 11 Automatic log-off , 6 B bye , 30 C Commands adduser , 10 assign , 11 bye , 30 current , 23 deluser , 11 editing the command l.
Index 34 Command Line Interface ( CLI) User’s Guide on , 16 outletgroups , 17 Outlets commands , 15 overview , 14 overloadalarm , 27 overloadrestriction , 28 P passwd , 12 pducoldstart delay , 29 po.
*990-2766* APC W orldwide Customer Support Customer support for this or any other APC product is available at no charge in any of the following ways: • V isit the APC W eb site to access documents in the APC Knowledge Base and to subm it customer support requests.
デバイスAPC Command Line Interfaceの購入後に（又は購入する前であっても）重要なポイントは、説明書をよく読むことです。その単純な理由はいくつかあります：
APC Command Line Interfaceをまだ購入していないなら、この製品の基本情報を理解する良い機会です。まずは上にある説明書の最初のページをご覧ください。そこにはAPC Command Line Interfaceの技術情報の概要が記載されているはずです。デバイスがあなたのニーズを満たすかどうかは、ここで確認しましょう。APC Command Line Interfaceの取扱説明書の次のページをよく読むことにより、製品の全機能やその取り扱いに関する情報を知ることができます。APC Command Line Interfaceで得られた情報は、きっとあなたの購入の決断を手助けしてくれることでしょう。
APC Command Line Interfaceを既にお持ちだが、まだ読んでいない場合は、上記の理由によりそれを行うべきです。そうすることにより機能を適切に使用しているか、又はAPC Command Line Interfaceの不適切な取り扱いによりその寿命を短くする危険を犯していないかどうかを知ることができます。
ですが、ユーザガイドが果たす重要な役割の一つは、APC Command Line Interfaceに関する問題の解決を支援することです。そこにはほとんどの場合、トラブルシューティング、すなわちAPC Command Line Interfaceデバイスで最もよく起こりうる故障・不良とそれらの対処法についてのアドバイスを見つけることができるはずです。たとえ問題を解決できなかった場合でも、説明書にはカスタマー・サービスセンター又は最寄りのサービスセンターへの問い合わせ先等、次の対処法についての指示があるはずです。
