Cyclades AlterPath PM8, AlterPath PM8i, AlterPath PM10, AlterPath PM10i, AlterPath PM10i-L30A Installation, Administration And User Manual
...Page 1
AlterPath PM Installation,
Administration, and User’s Guide
Cyclades Corporation
3541 Gateway Boulevard
Fremont, CA 94538 USA
1.888.CYCLADES (292.5233)
1.510.771.6100
1.510.771.6200 (fax)
http://www.cyclades.com
Release Date: October 2005
Part Number: PAC0216
Software Version 1.7.1
Page 2
©2005 Cyclades Corporation
Information in this document is subject to change without notice. The following are registered
or registration-pending trademarks of Cyclades Corporation: Cyclades and AlterPath.
All trademarks, trade names, logos and service marks referenced herein, even when not
specifically marked as such, belong to their respective companies and are not to be considered
unprotected by law.
Page 3
Contents
Before You Begin .................................................... xv
Audience ......................................................................................................xvi
Document Organization ..............................................................................xvii
Related Documents ....................................................................................xviii
Typographic and Other Conventions ...........................................................xix
Chapter 1: Introduction ............................................. 1
Description ......................................................................................................2
Alarms and Monitoring ...............................................................................2
Sequential Power Up ...................................................................................2
Support for Daisy Chaining ........................................................................2
Creation of User Accounts ..........................................................................3
Integration with Cyclades Management Products ......................................3
Hardware Configuration Options ....................................................................4
Standalone Configuration ...........................................................................4
Daisy-chained Configuration ......................................................................5
Integrated Configuration .............................................................................6
Accessing the System Console .......................................................................8
Direct Console Access ................................................................................8
Console Access through a Management Device ......................................... 9
Models and Components ................................................................................9
AlterPath PM8 ..........................................................................................10
AlterPath PM8i .........................................................................................11
AlterPath PM10 ........................................................................................12
AlterPath PM10i .......................................................................................13
Page 4
AlterPath PM10i-L30A .............................................................................14
AlterPath PM10i-32A ...............................................................................14
AlterPath PM10i-32Au .............................................................................15
AlterPath PM20 ........................................................................................15
AlterPath PM20i .......................................................................................16
AlterPath PM20i 32A ...............................................................................17
AlterPath PM20i 32Au .............................................................................17
Chapter 2: Installation ............................................. 19
Gathering Required Equipment ....................................................................20
Reviewing the Shipping Box Contents .........................................................20
Modular Input Power Cables for the AlterPath PM ..................................22
AlterPath PM8i-15A and AlterPath PM10i-10A Power Cables ........... 23
AlterPath PM10i-15A Power Cables ....................................................24
AlterPath PM10i-16A and AlterPath PM 20i-16A Power Cables ........ 24
AlterPath PM10i-20A and AlterPath PM 20i-20A Power Cables ........ 25
Optional Outlet Cable Package .................................................................26
Setting Up the AlterPath PM ........................................................................26
Installation Environment ...........................................................................27
Daisy Chaining PMs .....................................................................................31
Plugging Devices Into AlterPath PM Outlets ...............................................32
Powering On the AlterPath PM ....................................................................32
Making a Direct Connection for Console Access .........................................33
Chapter 3: Configuration......................................... 37
Default Configuration Parameters ................................................................38
Initial Configuration Using the Command Prompt .......................................38
Resetting the Admin Password ..................................................................... 41
Upgrading the AlterPath PM Firmware ........................................................43
Chapter 4: Command Line Interface ...................... 49
PM User Interface ......................................................................................... 50
Commands ....................................................................................................52
adduser ......................................................................................................53
alarm ......................................................................................................... 53
iv AlterPath PM Installation, Administration, and User’s Guide
Page 5
assign ......................................................................................................... 54
buzzer status ..............................................................................................55
current .......................................................................................................56
currentprotection .......................................................................................57
cycle .......................................................................................................... 58
deluser .......................................................................................................59
exit .............................................................................................................60
factory_defaults .........................................................................................61
help ............................................................................................................62
id ...............................................................................................................64
interval ......................................................................................................65
list ..............................................................................................................66
lock ............................................................................................................67
name .......................................................................................................... 67
off ..............................................................................................................69
on ...............................................................................................................70
passwd .......................................................................................................70
reboot ........................................................................................................ 71
restore ........................................................................................................ 74
save ........................................................................................................... 75
status .........................................................................................................76
syslog ........................................................................................................ 77
temperature ...............................................................................................78
unassign .....................................................................................................79
unlock ........................................................................................................ 80
ver .............................................................................................................80
whoami ......................................................................................................81
Appendix A: Specifications ....................................83
Electrical and Hardware Specifications ........................................................84
Interface Pinouts ...........................................................................................96
Appendix B: Safety Instructions ............................97
Safety Instructions ........................................................................................98
Sicherheitsanweisungen ................................................................................99
Istruzioni di Sicurezza ................................................................................100
Contents v
Page 6
Instruções de Segurança ..............................................................................102
Instrucciones de seguridad .......................................................................... 103
Instructions de sécurités ..............................................................................105
FCC Warning Statement .............................................................................106
Canadian DOC Notice ................................................................................106
Appendix C: Circuit Breakers ............................... 107
PM Units with One Circuit Breaker ...........................................................108
PM8i and PM10i .........................................................................................108
PM10-L30A ................................................................................................109
PM10i-L30A ...............................................................................................110
PM10i-32A and PM10i-32Au ....................................................................111
PM20-L30A ................................................................................................111
PM20i-L30A ...............................................................................................112
PM20i-32A and PM20i-32Au ....................................................................113
Circuit Breaker Trip Time .......................................................................... 114
Index ....................................................................... 115
vi AlterPath PM Installation, Administration, and User’s Guide
Page 7
Figures
Figure 1-1: Standalone Configuration......................................................4
Figure 1-2: Daisy-chained Configuration.................................................5
Figure 1-3: The AlterPath PM with a Cyclades Management Device .....7
Figure 1-4: AlterPath PM8 ..................................................................... 10
Figure 1-5: AlterPath PM8i.................................................................... 11
Figure 1-6: AlterPath PM10 ...................................................................12
Figure 1-7: AlterPath PM10i Back.........................................................13
Figure 1-8: AlterPath PM10i Front ........................................................13
Figure 1-9: The AlterPath PM20............................................................15
Figure 1-10: The AlterPath PM20i...........................................................16
Figure 2-11: Rack Mounting Holes on the AlterPath PM........................ 29
Figure 2-12: Rack Mount for the AlterPath PM8i....................................30
Figure 2-13: Connecting a Local Work Station to the AlterPath PM....... 33
Figure C-1: PM10-L30A Circuit Breakers ...........................................109
Figure C-2: PM10i-L30A Circuit Breakers .......................................... 110
Figure C-3: PM20-L30A Circuit Breakers ...........................................112
Figure C-4: PM20i-L30A Circuit Breakers .......................................... 113
Page 8
viii AlterPath PM Installation, Administration, and User’s Guide
Page 9
Tables
Table 2-2: AlterPath PM8i-15A and AlterPath PM10i-10A Cables..... 23
Table 2-3: AlterPath PM10i-15A..........................................................24
Table 2-4: AlterPath PM10i-16A and AlterPath PM 20i-16A..............24
Table 2-5: AlterPath PM10i-20A and AlterPath PM 20i-20A..............25
Table 2-6: AlterPath PM Optimum Installation Environment.............. 27
Table A-1: PM8-15A Specifications......................................................84
Table A-2: PM8-20A and PM8-L20A Specifications ...........................85
Table A-3: PM8i-10A Specifications ....................................................86
Table A-4: PM10-15A Specifications....................................................86
Table A-5: PM10-20A and PM10-L20A Specifications ....................... 87
Table A-6: PM10-L30A Specifications .................................................87
Table A-7: PM10i-10A Specifications .................................................. 88
Table A-8: PM10i-15A Specifications .................................................. 88
Table A-9: PM10i-16A Specifications .................................................. 89
Table A-10: PM10i-20A Specifications ..................................................90
Table A-11: PM10i-32A and PM10i-32Au Specifications...................... 90
Table A-12: PM10i-L30A Specifications................................................91
Table A-13: PM20-20A and PM20-L20A Specifications .......................92
Table A-14: PM20-L30A Specifications.................................................92
Table A-15: PM20i-16A Specifications ..................................................93
Table A-16: PM20i-20A and PM20i-L20A Electrical Specifications..... 94
Page 10
Table A-17: PM20i-L30A Specifications................................................94
Table A-18: PM20i-32A and PM20i-32Au Specifications...................... 95
Table C-20: Circuit Breaker Trip Time ................................................. 114
x AlterPath PM Installation, Administration, and User’s Guide
Page 11
Procedures
T
To Mount the AlterPath PM8i, PM10, or PM10i ......................................29
T
To Daisy Chain a PM.................................................................................31
T
To Plug Devices Into AlterPath PM Outlets.............................................. 32
T
To Power On the AlterPath PM.................................................................32
T
To Access the Console...............................................................................34
T
To Log Into the AlterPath PM Through the Console (In Port).................. 35
T
To Change the Default Password...............................................................39
T
To Create Users Using the adduser Command..........................................39
T
To Assign Outlets to Users Using the assign Command ...........................40
T
To Name the Outlets Using the name Command ......................................40
T
To Save the Configuration Using the save Command............................... 40
T
To Reset the Admin Password Using the Loopback Connector................ 41
T
To Upgrade PM Firmware.........................................................................43
Page 12
xii AlterPath PM Installation, Administration, and User’s Guide
Page 13
Commands
adduser.......................................................................................................... 53
alarm ............................................................................................................. 53
assign ............................................................................................................ 54
buzzer status.................................................................................................. 55
current ........................................................................................................... 56
currentprotection........................................................................................... 57
cycle.............................................................................................................. 58
deluser........................................................................................................... 59
exit ................................................................................................................ 60
factory_defaults ............................................................................................ 61
help................................................................................................................ 62
id ................................................................................................................... 64
interval .......................................................................................................... 65
list.................................................................................................................. 66
lock................................................................................................................ 67
name.............................................................................................................. 67
off.................................................................................................................. 69
on .................................................................................................................. 70
passwd........................................................................................................... 70
reboot ............................................................................................................ 71
restore............................................................................................................ 74
save ............................................................................................................... 75
status ............................................................................................................. 76
syslog ............................................................................................................ 77
temperature ................................................................................................... 78
unassign ........................................................................................................ 79
unlock............................................................................................................ 80
Page 14
ver ................................................................................................................. 80
whoami.......................................................................................................... 81
xiv AlterPath PM Installation, Administration, and User’s Guide
Page 15
Before You Begin
This installation, administration, and user’s guide provides background
information and procedures for installing, configuring, and maintaining the
Cyclades AlterPath™ family of Power Management IPDUs (intelligent power
distribution units):
•AlterPath PM8-15A
•AlterPath PM8-20A
• AlterPath PM8-L20A
• AlterPath PM8i-10A
•AlterPath PM10-15A
•AlterPath PM10-20A
• AlterPath PM10-L20A
• AlterPath PM10-L30A
• AlterPath PM10i-10A
• AlterPath PM10i-15A
• AlterPath PM10i-16A
• AlterPath PM10i-20A
• AlterPath PM10i-32A
• AlterPath PM10i-32Au
•AlterPath PM20-20A
• AlterPath PM20-L20A
• AlterPath PM20-L30A
• AlterPath PM20i-16A
• AlterPath PM20i-20A
Page 16
Audience
• AlterPath PM20i-30A
• AlterPath PM20i-30Au
• AlterPath PM20i-L30A
This guide offers procedures for a stand-alone configuration. If you are
integrating your PM with a Cyclades KVM or console management device,
please see the related installation instructions for that product.
Audience
This manual is intended for installers and system administrators of the
AlterPath PM and for users who may be authorized to manage power through
the AlterPath PM. It assumes that the reader understands networking basics
and is familiar with the terms and concepts used in Local and Wide Area
Networking.
This document describes configuration, administration, and use of the
AlterPath PM only. It does not describe how to set up and administer other
external services or servers that the AlterPath PM may access.
xvi AlterPath PM Installation, Administration, and User’s Guide
Page 17
Document Organization
Document Organization
The document contains the chapters listed in the following table.
Table P-1: Document Organization
Chapter Number and Title Description
Chapter 1: Introduction
Chapter 2: Installation
Chapter 3: Configuration
Chapter 4: Command Line Interface
Appendix A: Specifications
Appendix B: Safety Instructions
Appendix C: Circuit Breakers
Index
Defines and explains the overall product
features and uses of the AlterPath PM.
Explains the procedures for installing the
AlterPath PM in addition to explaining how
to daisy chain AlterPath PMs.
Explains the procedures for performing
basic configuration through a console
connection to the AlterPath PM.
Explains how to use the command line
interface and offers syntax, arguments, and
examples for each available command.
Offers detailed electrical and hardware
information on each PM model.
Provides important safety information for
installing and operating the AlterPath PM.
Explains how the circuit breakers work for
each PM model.
Provides a way to look up terms. In the
online version of this manual, clicking the
terms in the index brings you to where they
are used in the manual.
Before You Begin xvii
Page 18
Related Documents
Related Documents
Updated versions of this document will be posted on the downloads section of
the Cyclades website in the “AlterPath PM” section when Cyclades releases
new versions of the software.
A printed version of this document can be ordered under part number
OST0000-U00 through your Cyclades sales representative.
The following document for the Cyclades AlterPath PM is shipped with the
product.
• AlterPath PM Quick Start Guide (hard-copy)
The following manuals for Cyclades AlterPath products mentioned in this
guide are on the Documentation CD shipped with the product, and they are
also available at http://www.cyclades.com/docs
• AlterPath Manager E2000 Manual
• AlterPath ACS Advanced Administration Guide
• AlterPath ACS User’s Guide
• Cyclades-TS User Guide
• AlterPath OnSite Installation, Administration, and User’s Guide
• AlterPath KVM/net Plus Installation, Configuration, and User’s Guide
• AlterPath KVM/net Installation, Configuration, and User’s Guide
• AlterPath KVM Installation, Configuration, and User’s Guide
under their products’ names.
Printed versions of this document and all the above listed documents can be
ordered from your Cyclades sales representative.
Updated versions of this document will be posted at the Cyclades website
when Cyclades releases new versions of the software. See “Additional
Resources” on page xx for information about free software upgrades.
xviii AlterPath PM Installation, Administration, and User’s Guide
Page 19
Typographic and Other Conventions
Typographic and Other Conventions
The following table describes the typographic conventions used in Cyclades
manuals.
Table P-2: Typographic Conventions
Typeface Meaning Example
Links
Hypertext links or URLs Go to: http://www.cyclades.com
Emphasis Titles, emphasized or new words
or terms
Filename or
Command
Names of commands, files, and
directories; onscreen computer
output.
User type What you type in an example,
compared to what the computer
displays
The following table describes other terms and conventions.
Table P-3: Other Terms and Conventions
Term or
Meaning Examples
Convention
Hot keys When hot keys are shown, a plus
(+) appears between two keys that
must be pressed at the same time,
and a space appears between two
keys that must be pressed
sequentially.
See the AlterPath AlterPath PM
Quick Start.
Edit the pslave.conf file.
pm>alarm
Ctrl+k p entered while the user
is connected to a KVM port brings
up an IPDU power management
screen. Ctrl and k must be
pressed at the same time followed
by p.
Navigation
shortcuts
Shortcuts use the “greater than”
symbol (>) to indicate how to
navigate to Web Manager forms or
OSD screens.
Before You Begin xix
Go to Configuration>KVM>
General >IP Users in Expert mode.
Page 20
Typographic and Other Conventions
Additional Resources
The following sections describe technical support, training, and software
upgrades.
Cyclades Technical Support
Cyclades offers free technical support. To find out how to contact the support
center in your region, go to:
technical_support.php.
Cyclades Technical Training
To learn more about Cyclades Technical Training Center and courses offered,
visit http:www.cyclades.com/training
to training@cyclades.com.
Cyclades Software Upgrades
Cyclades offers periodic software upgrades for the AlterPath products free of
charge to current Cyclades customers. You may want to check http://
www.cyclades.com/support/downloads.php#alterpath_pm from time to time
to see if upgrades are available for the AlterPath PM.
http://www.cyclades.com/support/
, call 1-888-292-5233, or send an email
See “Upgrading the AlterPath PM Firmware” on page 43 for instructions on
upgrading the software on your AlterPath PM.
xx AlterPath PM Installation, Administration, and User’s Guide
Page 21
Chapter 1
Introduction
The AlterPath PM is an intelligent power distribution unit (IPDU) that enables
remote power control of servers and network gear. When used in conjunction
with Cyclades console servers or KVM devices, the AlterPath PM delivers
easier management capabilities and faster problem solving by integrating
console/KVM access and power control into one single interface.
The following sections describe general features common to all PM models in
addition to pointing out specific features of certain units.
Page 22
Description
Description
The following sections describe common features among all AlterPath PM
units.
Alarms and Monitoring
The AlterPath PM delivers accurate, real-time global current monitoring of all
connected devices via the user interface screen or locally through an LED
digital display. Users have the ability to set a current alarm threshold that,
once exceeded, will cause the AlterPath PM to sound an alarm or send a
notification message, or both. The LED current display also blinks when the
alarm threshold is exceeded.
Sequential Power Up
The AlterPath PM incorporates a sequential power up feature that prevents all
power outlet receptacles from turning on at once, eliminating the potential of
current surges that could render the equipment inoperable. Together with the
global current monitoring, the sequential power-up feature lets users safely
install more equipment on existing power circuits without the worry of current
overloads.
Support for Daisy Chaining
The IPDU has a fixed number of power-outlet receptacles, but with daisy
chaining capabilities, users can increase capacity by connecting the control
interfaces of several AlterPath PMs in a series.
2 AlterPath PM Installation, Administration, and User’s Guide
Page 23
Description
Creation of User Accounts
The AlterPath PM allows one administrator and up to eight users (not
simultaneously) to connect to it through its RS-232 serial port. After a
successful authentication, it performs the following functions:
• Reads and displays the total current being used by the entire AlterPath PM.
• Manages power outlets (by powering them on and off, locking and
unlocking them, and/or power cycling them).
• Manages users.
• Monitors power variables.
• Can be used as a stand-alone IPDU (independent of any other hardware)
and controlled by any simple terminal access program like Minicom on
Linux or HyperTerminal on Microsoft operating systems.
Integration with Cyclades Management Products
When used with the ACS/TS family, the OnSite, or the KVM family, the
AlterPath PM offers a superior feature set that is not fully covered in this
manual. Please refer to the appropriate Cyclades documentation for more
information on how to use the AlterPath PM with your specific
implementation.
Introduction 3
Page 24
Hardware Configuration Options
Hardware Configuration Options
The AlterPath PM can be used in one of three hardware configurations:
• Standalone – Managed independently of any other hardware device.
See “Standalone Configuration” on page 4.
• Daisy-chained – Multiple slave PMs connected to one another and
managed by one master PM.
See “Daisy-chained Configuration” on page 5.
• Integrated – Managed by a Cyclades TS, AlterPath ACS, AlterPath
OnSite, one of the AlterPath KVM products, or by any other console/
terminal management device.
See “Integrated Configuration” on page 6.
Standalone Configuration
In a standalone configuration, the AlterPath PM operates independently of
any other hardware such as the TS or ACS. The following graphic displays a
PM with the console port connected to a computer running HyperTerminal,
Kermit, or Minicom.
RJ-45 cableRJ-45 to DB-9F adapter
Power Source
User
IN port
Server Switch
Figure 1-1: Standalone Configuration
Note: The previous graphic displays the PM being connected to the local work
station with the RJ-45 to DB-9F adapter that is shipped with the product. If
your work station does not have a DB-9M COM port, you may need to use a
USB serial adapter in order to connect to the computer’s USB port.
4 AlterPath PM Installation, Administration, and User’s Guide
Page 25
Hardware Configuration Options
For specific installation instructions, see “Setting Up the AlterPath PM” on
page 26.
Daisy-chained Configuration
In a daisy-chained configuration, multiple slave PMs are connected to one
another and managed by a single master PM. The PMs are linked together
with RJ-45 cables connected to one PMs OUT port and the other PM’s IN
port. This example shows four AlterPath PMs operating in a daisy-chained
environment. PM #1 is connected to the local work station and is the “master”
PM, while the other three PMs are “slaves.”
RJ-45 to DB-9F adapter
User
IN port
OUT port
Additional AlterPath PM with
up to a total of 128 outlets
can be daisy-chained
PM #1
PM #2
PM #3
PM #4
RJ-45 cable
Server Switch
Figure 1-2: Daisy-chained Configuration
Power Source
Introduction 5
Page 26
Hardware Configuration Options
Note: The previous graphic displays the PM being connected to the local work
station with the RJ-45 to DB-9F adapter that is shipped with the product. If
your work station does not have a DB-9M COM port, you may need to use a
USB serial adapter in order to connect to the computer’s USB port.
The PMs in the previous graphic are configured to be used independently of
any other hardware such as the AlterPath ACS or Cyclades-TS.
Integrated Configuration
In an integrated configuration, the AlterPath PM is configured to work in
conjunction with one of the following Cyclades management products:
•Cyclades-TS
•AlterPath ACS
• AlterPath OnSite
• AlterPath KVM family.
A user connects to the AlterPath PM by accessing the appropriate console port
of the Cyclades management product. In this scenario, software configuration
on and monitoring of the AlterPath PM is done through the Cyclades
management product and not on the PM itself. The setup and configuration
instructions for the Cyclades management products can be found in the
appropriate documentation available at http://www.cyclades.com/support/
downloads.php.
6 AlterPath PM Installation, Administration, and User’s Guide
Page 27
AlterPath OnSite
Hardware Configuration Options
Power Source
PM #1
PM #2
PM #3
PM #4
Additional AlterPath PMs with
up to a total of 128 outlets
can be daisy-chained
Server Switch
Figure 1-3: The AlterPath PM with a Cyclades Management Device
Introduction 7
Page 28
Accessing the System Console
An integrated environment offers the following advantages:
• IT professionals can power off, power on, and reboot network devices
using the same console management session from any location via telnet,
Secure Shell (SSHv2), or through a secure web session. This can all be
done without the need for physical access to the hardware.
• Ethernet connection is available through the Cyclades management
products to which the AlterPath PM is connected. When used with
Cyclades management product, the AlterPath PM allows you, via a
configurable hotkey, to reboot servers without leaving your telnet/ssh
session.
• The AlterPath PM inherits the security of the console server to which it is
connected.
Daisy chaining PMs with the AlterPath ACS or Cyclades-TS is similar to the
daisy-chained configuration as described in “Daisy-chained Configuration”
on page 5; however, in the integrated configuration, the first AlterPath PM is
connected to a Cyclades management device instead of a workstation.
Accessing the System Console
Users and administrators can access the AlterPath PM either by making a
direct console connection to the PM’s IN port or by connecting the PM to a
Cyclades console or KVM management device.
Direct Console Access
While using the PM device independently of other Cyclades devices, local
users can connect directly to the system console port (the “IN” port) of the
AlterPath PM using the console cable with the corresponding adapter(s).
For more information about connecting directly to the PM’s console, see
“Making a Direct Connection for Console Access” on page 33.
8 AlterPath PM Installation, Administration, and User’s Guide
Page 29
Models and Components
Console Access through a Management Device
While integrating the PM device with a Cyclades console or KVM
management device such as the AlterPath ACS or the AlterPath OnSite,
remote users can access the AlterPath PM's console port through one of the
following interfaces:
• Menu-driven interface – After using telnet or SSH to access the console
port equivalent to the managed device on the console server, type the
power management hotkey (Ctrl+p by default) to bring up a power
management menu on the same screen.
• Web interface – Once you are logged into the Web Interface of the
management device, access the power management functionality from a
“Power Management” or “IPDU Power Management” tab on the Web
Manager.
See “Integration with Cyclades Management Products” on page 3 for more
background information on integrating a PM with a Cyclades management
device, or refer to the appropriate user documentation for instructions on
accessing the PM console through your specific Cyclades management
device.
Models and Components
General features, which are common among all products, in the AlterPath PM
family are listed below:
• 128 KB flash memory
•8 KB RAM
• Two RJ-45 RS-232 interfaces
• Digital global current display with 2 digits and 7 segments
• LEDs monitoring ON/OFF status for each port
• Audible over current alarm
• 8-bit Microcontroller-equipped
Introduction 9
Page 30
Models and Components
The following sections list features that are specific to each model:
• “AlterPath PM8” on page 10
• “AlterPath PM8i” on page 11
• “AlterPath PM10” on page 12
• “AlterPath PM10i” on page 13
• “AlterPath PM10i-L30A” on page 14
• “AlterPath PM10i-32A” on page 14
• “AlterPath PM10i-32Au” on page 15
• “AlterPath PM20” on page 15
• “AlterPath PM20i” on page 16
If needed, see Appendix A: “Specifications” for more electrical, hardware,
and environment details about each model. See “Reviewing the Shipping Box
Contents” on page 20 for pictures of the components available with each PM
model.
AlterPath PM8
The AlterPath PM8 has the following features:
• One of the following power plugs:
• 125VAC/15A (NEMA 5-15P)
• 125VAC/20A (NEMA 5-20P)
• 125VAC/20A (NEMA L5-20P)
• Eight 125VAC/15A power receptacles (NEMA 5-15R)
• 125VAC/20A circuit breaker
• Vertical mounting (zero U)
The following graphic depicts the AlterPath PM8.
Figure 1-4: AlterPath PM8
10 AlterPath PM Installation, Administration, and User’s Guide
Page 31
AlterPath PM8i
The AlterPath PM8i has the following features:
• One 240VAC/8A power plug (IEC320-C14)
See “AlterPath PM8i-15A and AlterPath PM10i-10A Power Cables” on
page 23 for a list of which power cables are supplied by region.
• Eight 240VAC/8A power receptacles (IEC320-C14)
• 240VAC/10A supplementary protector
• Vertical (zero U) & Horizontal (1.5 U) mounting
The following graphic depicts the AlterPath PM8i.
OUT Port
Models and Components
Power Outlets (IEC320-C14)
Power Inlet
In Port Digital Current Display
Figure 1-5: AlterPath PM8i
Introduction 11
Page 32
Models and Components
AlterPath PM10
The AlterPath PM10 has the following features:
• One of the following power plugs:
• 125VAC/15A power plug (NEMA 5-15P)
• 125VAC/20A power plug (NEMA 5-20P)
• 125VAC/20A power plug (NEMA L5-20P)
• 125VAC/30A power plug (NEMA L5-30P)
• Ten 125VAC/15A power receptacles (NEMA 5-15R)
• 125VAC/15A/20A/two 15A circuit breakers
• Horizontal mounting (1U)
The following graphic depicts the AlterPath PM10.
IN port
10 NEMA5-15R Power Outlets
OUT port
Digital Current Display
Figure 1-6: AlterPath PM10
12 AlterPath PM Installation, Administration, and User’s Guide
Page 33
AlterPath PM10i
The AlterPath PM10i has the following features:
• One of the following power plugs:
• 240VAC/10A power plug (IEC320-C14)
• 240VAC/16A power plug (IEC320-C20)
• Ten 240VAC/10A power receptacles (IEC320-C13)
• 240VAC/10A/20A supplementary protector
• Horizontal (1U) mounting
The following graphic depicts the back of the AlterPath PM10i.
IN port
Models and Components
10 IEC320-C13 Power Outlets
OUT port
IEC320-C14 Power Inlet
Figure 1-7: AlterPath PM10i Back
The following graphic depicts the back of the AlterPath PM10i.
Digital Current DisplayPower Outlet LEDs
Figure 1-8: AlterPath PM10i Front
Introduction 13
Page 34
Models and Components
AlterPath PM10i-L30A
The AlterPath PM10i L30A has the following features:
• 30A input power cord. L6-30P plug (USA model)
• Ten 240VAC/10A power receptacles (IEC320-C13)
• Two 240VAC/15A magnetic circuit breakers with “press to reset” function
• Horizontal (1U) mounting
Refer to Figure 1-7: AlterPath PM10i Back on page 13 and Figure 1-8:
AlterPath PM10i Front on page 13 for images of the AlterPath PM10i L30A.
AlterPath PM10i-32A
The AlterPath PM10i-32A has the following features:
• 32A input power cord; IEC 309 plug.
• Ten 240VAC/10A power receptacles (IEC320-C13)
• Two 240VAC/16A magnetic circuit breakers with accidental-off protection
function
• Horizontal (1U) mounting
Refer to Figure 1-7: AlterPath PM10i Back on page 13 and Figure 1-8:
AlterPath PM10i Front on page 13 for images of the AlterPath PM10i-32A.
14 AlterPath PM Installation, Administration, and User’s Guide
Page 35
AlterPath PM10i-32Au
The AlterPath PM10i-32Au has the following features:
• 32A unterminated input power cord
• Ten 240VAC/10A power receptacles (IEC320-C13)
• Two 240VAC/16A magnetic circuit breakers with accidental-off protection
function
• Horizontal (1U) mounting
Refer to Figure 1-7: AlterPath PM10i Back on page 13 and Figure 1-8:
AlterPath PM10i Front on page 13 for images of the AlterPath PM10i-32Au.
AlterPath PM20
The AlterPath PM20 is available in three models: PM20-15A, PM20-20A,
and PM20-30A. Each model has the following features:
• One of the following power plugs:
• 125VAC/15A power plug (NEMA 5-15P)
• 125VAC/20A power plug (NEMA 5-20P)
• 125VAC/20A power plug (NEMA L5-20P)
• 125VAC/30A power plug (NEMA L5-30P)
• 20 125VAC/15A power receptacles (NEMA 5-15R)
• 125VAC/20A circuit breaker (15A, 20A, and 30A models)
• Vertical mounting (zero U)
Models and Components
The following graphic depicts the AlterPath PM20.
Figure 1-9: The AlterPath PM20
Introduction 15
Page 36
Models and Components
AlterPath PM20i
The AlterPath PM20i has the following features:
• One of the following power plugs:
• 240VAC/16A power plug (IEC320-C20)
• 240VAC/20A power plug (IEC320-C20)
• Twenty 240VAC/10A power receptacles (IEC320-C13)
• 240VAC/20A supplementary protector with a “press to reset” function on
the L30A models
• 240VAC/15A branch circuit breaker with accidental-off protected feature
(30A model)
• Vertically (0U) mounting
The following graphic depicts the AlterPath PM20i.
Figure 1-10:The AlterPath PM20i
16 AlterPath PM Installation, Administration, and User’s Guide
Page 37
AlterPath PM20i 32A
The AlterPath PM20i 32A has the following features:
• 32A input power cord; IEC 309 plug.
• Twenty 240VAC/10A power receptacles (IEC320-C13)
• 240VAC/two 16A magnetic circuit breakers with accidental-off protection
function
• Horizontal (1U) mounting
Refer to Figure 1-10: The AlterPath PM20i on page 16 for an image of the
AlterPath PM20i-32A.
AlterPath PM20i 32Au
The AlterPath PM20i 32Au has the following features:
• 32A unterminated input power cord
• Twenty 240VAC/10A power receptacles (IEC320-C13)
• 240VAC/two 16A magnetic circuit breakers with accidental-off protection
function
• Horizontal (1U) mounting
Models and Components
Refer to Figure 1-10: The AlterPath PM20i on page 16 for an image of the
AlterPath PM20i-32Au.
Introduction 17
Page 38
Models and Components
18 AlterPath PM Installation, Administration, and User’s Guide
Page 39
Chapter 2
Installation
The following sections outline and describe tasks for installing the AlterPath
PM and provide other important installation-related information.
The following table lists the basic installation tasks in the order in which they
should be performed and shows the page numbers where the tasks are
described in more detail.
1
Gathering Required Equipment Page 20
2
Reviewing the Shipping Box Contents Page 20
3
Setting Up the AlterPath PM Page 26
4
(Optional) Daisy Chaining PMs Page 31
5
Plugging Devices Into AlterPath PM Outlets Page 32
6
Powering On the AlterPath PM Page 32
7
Making a Direct Connection for Console Access Page 33
8
Finishing configuration and managing the connected devices Page 37
Page 40
Gathering Required Equipment
Gathering Required Equipment
Collect the following equipment prior to installing and configuring the
AlterPath PM in standalone configuration:
• One or more RJ-45 to RJ-45 straight-through cables.
• An RJ-45 to DB-9F straight-through adapter.
• A PC running a terminal emulation program.
See the following section “Reviewing the Shipping Box Contents” on page 20
for the list of other necessary items that come with the AlterPath PM.
Reviewing the Shipping Box Contents
All AlterPath PM models are shipped with the PM itself along with the items
shown in Table 2-1. The entry for each part provides an illustration, its part
number (P/N), description, and purpose. You can use check boxes to check off
each item, and you can use the part numbers from this table to reorder any of
the parts.
Table 2-1: PM Shipping Box Contents, Part Numbers, and Description
5
20 AlterPath PM Installation, Administration, and User’s Guide
Item P/N Description Purpose
PAC0226 Documentation CD PDF copies of this guide and
all other Cyclades product
documents.
PAC 02 25 AlterPath PM
Quick Start Guide
Basic installation guide for
experienced users in printed
format.
Page 41
Reviewing the Shipping Box Contents
Table 2-1: PM Shipping Box Contents, Part Numbers, and Description (Continued)
5
Item P/N Description Purpose
CAB0018 RJ-45 to RJ-45 7ft.
CAT5 cable
ADB0036 RJ-45 to DB-9F
straight-through
adapter
Used for the following:
• Along with an adapter, to
connect a terminal or PC to
the IN port. See “To Access
the Console” on page 34.
• To connect to a Cyclades
console or KVM
management device.
• To connect to another
AlterPath PM in a daisy
chain. See “To Daisy Chain
a PM” on page 31.
Along with an RJ-45 cable,
used to connect a terminal or
PC to a PC’s COM port. See
“To Access the Console” on
page 34.
CON0132 RJ-45 loopback
connector
Installation 21
In the case that the
administrator forgets the
admin's password, this is
used to place in the OUT port
to gain temporary access to
the box using the factory
default password.
See “To Reset the Admin
Password Using the
Loopback Connector” on
page 41.
Page 42
Reviewing the Shipping Box Contents
Table 2-1: PM Shipping Box Contents, Part Numbers, and Description (Continued)
5
Item P/N Description Purpose
HAR0220 2 mounting
brackets with
8 screws (2 spares)
See the following sections for a list of additional items shipped with specific
AlterPath PM models.
Use to mount the AlterPath
PM to a rack or wall. See
“To Mount the AlterPath
PM8i, PM10, or PM10i” on
page 29.
Modular Input Power Cables for the AlterPath PM
If your PM model does not have a fixed power input cable, it may ship with
one of the modular cables listed in the following sections. Depending on your
site’s location, the modular input power cables included in the box vary. See
the following sections to find the input cable that should ship with your PM
product:
• “AlterPath PM8i-15A and AlterPath PM10i-10A Power Cables” on
page 23
• “AlterPath PM10i-15A Power Cables” on page 24
• “AlterPath PM10i-16A and AlterPath PM 20i-16A Power Cables” on
page 24
Note: The AlterPath PM 10i-32Au ships with an unterminated power cord. If necessary,
your Cyclades representative can provide guidelines on approved power plug
installation.
22 AlterPath PM Installation, Administration, and User’s Guide
Page 43
Reviewing the Shipping Box Contents
AlterPath PM8i-15A and AlterPath PM10i-10A Power Cables
The following table lists the power cables available for the AlterPath PM 8i15A and AlterPath PM10i-10A by region.
Table 2-2: AlterPath PM8i-15A and AlterPath PM10i-10A Cables
5
Cable P/N Country/Region
CAB0089 US
CAB0055 Australia and New
Zealand
CAB0087 Continental Europe
Installation 23
CAB0088 United Kingdom
and Ireland
Page 44
Reviewing the Shipping Box Contents
AlterPath PM10i-15A Power Cables
The following table lists the power cables available for the AlterPath PM10i15A.
Table 2-3: AlterPath PM10i-15A
5
Cable P/N Country/Region
CAB0191 US
AlterPath PM10i-16A and AlterPath PM 20i-16A Power Cables
The following table lists the power cables available for the AlterPath PM10i16A and AlterPath PM 20i-16A.
Table 2-4: AlterPath PM10i-16A and AlterPath PM 20i-16A
5
Cable P/N Country/Region
CAB193 Continental Europe
24 AlterPath PM Installation, Administration, and User’s Guide
CAB0192
Australia and New
Zealand
Page 45
Reviewing the Shipping Box Contents
Table 2-4: AlterPath PM10i-16A and AlterPath PM 20i-16A
5
Cable P/N Country/Region
CAB0194
United Kingdom
and Ireland
AlterPath PM10i-20A and AlterPath PM 20i-20A Power Cables
The following table lists the power cables available for the AlterPath PM10i20A and AlterPath PM 20i-20A.
Table 2-5: AlterPath PM10i-20A and AlterPath PM 20i-20A
5
Cable P/N Type
CAB197 US
NEMA L6-20P
CAB0195 US
NEMA 5-20P
Installation 25
Page 46
Setting Up the AlterPath PM
Table 2-5: AlterPath PM10i-20A and AlterPath PM 20i-20A
5
Cable P/N Type
CAB0198 US
Optional Outlet Cable Package
The following cable packages can be ordered separately for the IEC PM
models:
• 8-outlet cables (C13 male to C14 female) (ACS0040).
• 10-outlet cables (C13 male to C14 female) (ACS00046).
Setting Up the AlterPath PM
You can mount the AlterPath PM on a rack or wall or place it on a desktop or
other flat surface. Two brackets are supplied with six Phillips screws for
attaching the brackets to the AlterPath PM for mounting.
NEMA L5-20P
• If you are not mounting the AlterPath PM, place the AlterPath PM on a
desk or table.
• If you are mounting the AlterPath PM, obtain a Phillips screwdriver and
appropriate nuts and bolts before starting the following procedure.
Note: When mounting an AlterPath PM 0U model to a wall stud, securely mount it
by using a #10 or larger screw or use a drywall fastener rated min. 25 lb (11.34
kg).
The following graphics depict the orientation of the brackets for front rack
mounting AlterPath PM.
26 AlterPath PM Installation, Administration, and User’s Guide
Page 47
Setting Up the AlterPath PM
Bracket
Installation Environment
When installing AlterPath PM, ensure that the following environment
specifications are met.
Table 2-6: AlterPath PM Optimum Installation Environment
Environment Factor Recommendation
Tem perature
The manufacturer's maximum recommended
ambient temperature for the AlterPath PM is
122 ºF (50 ºC).
Elevated Operating
Ambient Temperature
If the AlterPath PM is installed in a closed or
multi-unit rack assembly, the operating
ambient temperature of the rack environment
may be greater than room ambient
temperature. Therefore, consideration should
be given to installing the equipment in an
environment compatible with the
manufacturer’s maximum rated ambient
temperature. See above.
Reduced Air Flow
Installation of the equipment in a rack should
be such that the amount of air flow required
for safe operation of the equipment is not
compromised.
Installation 27
Page 48
Setting Up the AlterPath PM
Table 2-6: AlterPath PM Optimum Installation Environment
Environment Factor Recommendation
Mechanical Loading
Mounting of the equipment in the rack should
be such that a hazardous condition is not
achieved due to uneven mechanical loading.
Circuit Overloading
Consideration should be given to the
connection of the equipment to the supply
circuit and the effect that overloading of
circuits might have on overcurrent protection
and supply wiring. Appropriate consideration
of equipment nameplate ratings should be
used when addressing this concern.
Reliable Grounding
Reliable grounding of rack-mounted
equipment should be maintained. Particular
attention should be given to supply
connections other than direct connections to
the branch circuit, such as power strips or
extension cords.
Important: Install the AlterPath PM 0U model in a location where there is an adjacent and
accessible wall socket outlet.
28 AlterPath PM Installation, Administration, and User’s Guide
Page 49
Setting Up the AlterPath PM
T To Mount the AlterPath PM8i, PM10, or PM10i
1. Locate the appropriate sets of holes on the PM.
Holes for front mounting
AlterPath PM side
Holes for back mounting
Figure 2-11:Rack Mounting Holes on the AlterPath PM
2. Connect the two supplied brackets to the AlterPath PM, connecting one
bracket to each side of the box.
3. For each bracket, insert a screw through each of the three holes on the
bracket into the appropriate holes at either end of the AlterPath PM.
The following figure shows the bracket flanges on the front of the
AlterPath PM after the brackets are installed.
Brackets
4. Use a Phillips screwdriver to tighten the screws.
5. Use the mounting hardware recommended for your rack to mount the
AlterPath PM on a rack as illustrated in the following graphic.
Installation 29
Page 50
Setting Up the AlterPath PM
Note: The suggested minimum screw size for wall-mounting the AlterPath PM units
is #10 (4.8 mm or 0.19 in or 3/16 in) or larger. The RJ-45 cable included in the
AlterPath PM package is minimum flame rated VW-1 or FT-1 and has a
maximum length of 10 feet (3 meters).
Nodes
Switch
Router
PBX
PM8i, PM10 or PM10i
AlterPath ACS or
Cyclades TS
Ethernet
UPS
UNIX server
Figure 2-12:Rack Mount for the AlterPath PM8i
30 AlterPath PM Installation, Administration, and User’s Guide
Page 51
Daisy Chaining PMs
You can manage a maximum of 128 outlets from a single work station by
connecting slave PMs to the master PM device. See “Making a Direct
Connection for Console Access” on page 33 for more details.
T To Daisy Chain a PM
This procedure assumes that a master PM is already connected to a work
station or to a Cyclades console or KVM device.
1. Connect one end of an RJ-45 cable to the OUT port of the main AlterPath
PM, which is connected to a work station or to a Cyclades console or
KVM device (master).
2. Connect the other end of the RJ-45 cable to the IN port of the secondary
AlterPath PM (slave).
3. To connect another PM to the slave, connect one end of an RJ-45 cable to
the OUT port of the last PM in the chain.
4. Repeat Step 3 until you have connected the desired number of PMs.
Daisy Chaining PMs
You can control up to 128 power outlets in any combination of PM
models.
Installation 31
Page 52
Plugging Devices Into AlterPath PM Outlets
Plugging Devices Into AlterPath PM Outlets
In order to control power on a device, the device must be plugged into at least
one of the AlterPath PM’s power outlets.
T To Plug Devices Into AlterPath PM Outlets
1. Connect a device’s power cable to one of the AlterPath PM's outlets.
2. Repeat step one until all of the AlterPath PM’s power outlets are used.
Powering On the AlterPath PM
Power on the AlterPath PM in order to begin managing power of its connected
devices.
T To Power On the AlterPath PM
• Plug the power cable into an adjacent AC power source.
Important: The AlterPath PM must be powered by a receptacle with adequate circuit
protection.
32 AlterPath PM Installation, Administration, and User’s Guide
Page 53
Making a Direct Connection for Console Access
Making a Direct Connection for Console Access
The system administrator must specify basic settings on the AlterPath PM
before users can connect to and manage the unit and the connected devices. To
prepare to perform necessary basic configuration, make a direct connection to
the AlterPath PM by connecting a terminal or computer to the IN port as
depicted in the following graphic.
RJ-45 to
DB-9F adapter
RJ-45
cable
Local work
station
AlterPath PM
IN port
Figure 2-13:Connecting a Local Work Station to the AlterPath PM
Installation 33
Page 54
Making a Direct Connection for Console Access
T To Access the Console
Perform the following steps to connect a computer to the console port of the
AlterPath PM. This procedure assumes that you know how to use a terminal
emulation program.
On a PC, ensure that HyperTerminal or another terminal emulation program is
installed on the Windows operating system. On a computer running a UNIXbased operating system, such as Solaris or Linux, make sure that a compatible
terminal emulator, such as Kermit or Minicom, is installed.
1. Connect an RJ-45 serial cable to the IN port on the AlterPath PM.
2. Connect the other end of the RJ-45 serial cable to an RJ-45 to DB-9F
adapter shipped with the PM.
3. Connect the adapter to a DB-9 serial port on a computer.
You may need to use a USB serial adapter in order to connect to the
computer.
4. Using a terminal emulation program installed on a computer, start a
session with the following console port settings:
Serial Speed: 9600 bps Stop Bits: 1
Data Length: 8 bits Flow Control: None
Parity: None ANSI emulation
34 AlterPath PM Installation, Administration, and User’s Guide
Page 55
Making a Direct Connection for Console Access
T To Log Into the AlterPath PM Through the
Console (In Port)
1. From your terminal emulation application, log into the console port as
“admin”.
AlterPath PM
Copyright (c) 2002-2005
Cyclades Corporation
V 1.7.1 Oct 4, 2005
[PM]: IPDU: 1
[PM]: OUT: 8
Username:
As shown in the previous screen, the default password is “pm8.” If the
password has been changed from the default, use the new password.
2. If this is a first-time installation, see “Initial Configuration Using the
Command Prompt” on page 38 for instructions on changing the default
password, adding users, and assigning outlets to users.
3. See “Command Line Interface” on page 49, for procedures on logging in
and using the console commands to manage power on connected devices.
Installation 35
Page 56
Making a Direct Connection for Console Access
36 AlterPath PM Installation, Administration, and User’s Guide
Page 57
Chapter 3
Configuration
The AlterPath PM can be configured by any one of three methods:
• Command Prompt
• Browser – Available only when used in an integrated configuration.
• Text-based menu – Available only when used in an integrated
configuration, this menu allows you to invoke the various PM operations
such as cycling, switching on/off, and more.
The following sections offer basic instructions for configuring, restoring the
admin password, and uploading firmware on the AlterPath PM for either the
standalone or the daisy-chained configuration.
For information about integrated use with the AlterPath ACS, Cyclades-TS,
AlterPath KVM family of products, or the AlterPath Onsite, refer to the
AlterPath ACS User Guide, the Cyclades-TS User Guide, the AlterPath KVM/
net Plus Installation, Configuration, and User’s Guide, or the AlterPath
OnSite Installation, Administration, and User’s Guide respectively.
Page 58
Default Configuration Parameters
Default Configuration Parameters
The AlterPath PM’s default configuration is as follows:
• User is admin.
• admin user’s password is pm8.
• All outlets are un-named.
• All outlets are unassigned to user.
• All outlets are turned on.
• All outlets are unlocked.
Initial Configuration Using the Command
Prompt
To configure the AlterPath PM, you must have a work station connected to the
console (In) port on the AlterPath PM and be logged in as the admin user. See
“Making a Direct Connection for Console Access” on page 33 for instructions
on connecting to the console. If needed, refer to Chapter 4. “Command Line
Interface” on page 49 for a description of the command line interface and
reference information on each of the commands described in the following
procedures.
Use the following procedures to perform basic configuration:
To Change the Default Password Page 39
To Create Users Using the adduser Command Page 39
To Assign Outlets to Users Using the assign Command Page 40
To Name the Outlets Using the name Command Page 40
To Save the Configuration Using the save Command Page 40
38 AlterPath PM Installation, Administration, and User’s Guide
Page 59
Initial Configuration Using the Command Prompt
T To Change the Default Password
If the default password “pm8” is still in use, change the admin password.
Important: Changing the default password closes a security hole that could be easily
exploited.
1. Login to the AlterPath PM.
Use the factory default username/password admin/pm8. A maximum of
eight characters (not case sensitive) is allowed.
2. Enter the passwd command.
pm> passwd
3. Enter a new password when prompted.
Password: <new password>
Re-enter password: <new password>
Username/password set for user admin.
pm>
T To Create Users Using the adduser
Command
1. Login to the AlterPath PM.
The PM prompt appears
pm>
2. Enter the
the password when prompted.
pm> adduser jane
Password:
Re-enter password:
Username/password set for user jane.
Configuration 39
adduser command followed by the new username and enter
Page 60
Initial Configuration Using the Command Prompt
T To Assign Outlets to Users Using the assign
Command
1. Login to the AlterPath PM.
The PM prompt appears.
pm>
2. Enter the
pm>assign 2 jane
Outlet 2 assigned to jane.
assign command followed by the outlets and username.
T To Name the Outlets Using the name
Command
1. Login to the AlterPath PM.
The PM prompt appears.
pm>
2. Enter the
name of the outlet.
pm>name 2 chispa
2: Outlet now named chispa
name command followed by the outlet number and desired
T To Save the Configuration Using the save
Command
1. Login to the AlterPath PM.
The PM prompt appears.
pm>
40 AlterPath PM Installation, Administration, and User’s Guide
Page 61
Resetting the Admin Password
2. Enter the save command to save the configuration.
pm>save
Saving configuration to flash on IPDU #1 ... Done.
Saving configuration to flash on IPDU #2 ... Done.
Resetting the Admin Password
In the event the administrator wants to reset the password for the AlterPath
PM (for example, if the administrator forgets the admin password), then the
loopback connector that is shipped with the AlterPath PM can be used for
temporary access to the PM.
T To Reset the Admin Password Using the
Loopback Connector
1. Do one of the following procedures:
a. If you are currently logged into the AlterPath PM as a regular user,
log out by typing exit.
b. If you are already logged into the AlterPath PM as an administrator,
proceed to Step 2.
2. Attach the loopback connector.
Connect the loopback connector shipped with the product to the OUT port
of the AlterPath PM. If necessary, disconnect any cables connected to the
OUT port of the AlterPath PM to allow for the connection of the
loopback.
3. Wait one minute and then check the display.
Configuration 41
Page 62
Resetting the Admin Password
If you are watching the AlterPath PM's console output (using
HyperTerminal or Minicom), messages like the ones shown below are
displayed:
[ALTERPATH PM]: DCD went ON on output port of IPDU #1
[ALTERPATH PM]: Trying to detect loopback cable on
OUT port of ipdu #1
[ALTERPATH PM]: Loopback detected. Changing
administrator password to default.
[ALTERPATH PM]: Please remove the loopback cable now.
4. Remove the loopback connector.
After one minute, you can remove the loopback connector from the OUT
port of the AlterPath PM. Now the password for the user admin is reset to
the default (pm8), and you should be able to log into the AlterPath PM
using the default username/password.
5. Change the password for the admin, if desired, by issuing the following
command:
pm>passwd
6. Execute the
save command to complete the procedure.
7. If you need to recover the password of many AlterPath PMs connected in
a daisy chain, go to Step 1 and perform the procedure on each AlterPath
PM in the chain.
42 AlterPath PM Installation, Administration, and User’s Guide
Page 63
Upgrading the AlterPath PM Firmware
Upgrading the AlterPath PM Firmware
Starting with version 1.1.0, the AlterPath PM firmware can be upgraded
through its “In” port.
The upgrade procedure described here is only valid for units that are currently
running firmware versions 1.3.0 or greater. If your AlterPath PM unit is
running an older firmware version, please follow the instructions in the
manual that corresponds to the firmware currently installed on the AlterPath
PM. Older versions of this manual can be found at:
ftp://ftp.cyclades.com/pub/cyclades/alterpath/pm/doc/
T To Upgrade PM Firmware
1. Download the new AlterPath PM firmware from the Cyclades website.
The latest AlterPath PM firmware is available in the download section of
the Cyclades website, at http://www.cyclades.com/support/
downloads.php
After downloading the AlterPath PM firmware file, save it to the
workstation connected to the AlterPath PM console (IN port).
2. Using either Hyperterminal or Minicom, log into the AlterPath PM as
admin and type in the command
pm> upgrade <ipdu number>
If you are currently logged in as a different user, log out and then login as
admin.
The <ipdu number> is the number of the IPDU to which you want to
upgrade the firmware. If you have only one AlterPath PM unit, type
upgrade 1. If you have, for instance, three units in a daisy chain, type
upgrade 3 or upgrade 2 depending on which unit you want to
upgrade.
If you have a daisy chain and you want to upgrade all units, Cyclades
advises you to start from the last unit and work your way towards the first.
Configuration 43
Page 64
Upgrading the AlterPath PM Firmware
After the upgrade command is executed, the boot loader menu is
displayed at the console, as shown below:
AlterPath PM
Copyright (c) 2002-2005 Cyclades
Corporation
V 1.7.0 Sep 15, 2005
Username: admin
Password:
pm>upgrade 1
-----------------------------
Copyright (c) 2003 Cyclades Corporation
AlterPath PM/KVM Boot Loader Version 1.1
----------------------------Boot Menu
1. Upgrade Firmware.
2. Boot Firmware.
-----------------------------
Enter choice (1 or 2):
3. At the boot loader menu, select the option 1 to upgrade the firmware.
The boot loader erases the firmware currently in the unit and asks you to
upload the new firmware, as shown below:
----------------------------Copyright (c) 2003 Cyclades Corporation
AlterPath PM/KVM Boot Loader Version 1.1
----------------------------Boot Menu
1. Upgrade Firmware.
2. Boot Firmware.
----------------------------Enter choice (1 or 2): 1
Erasing firmware...done.
Downloading image. Please send file in 10
seconds.
44 AlterPath PM Installation, Administration, and User’s Guide
Page 65
Upgrading the AlterPath PM Firmware
4. Use your terminal emulator program to upload the AlterPath PM
firmware file to the AlterPath PM using the Xmodem protocol.
If you are using HyperTerminal in Windows, do the following procedure:
a. From the top menu select Transer>Send.
The Send File popup window appears.
b. Click the Browse button to set the proper path for the AlterPath PM
firmware file located on your work station.
Note: You must browse for the proper file and click the Send button within 10
seconds of selecting Transer>Send. If you fail to do so, an error message will
appear and the transmission will fail. You will then be given another 10second window in which to repeat steps b. through d.
c. Select Xmodem as the protocol.
d. Click on the Send button.
If you are using Minicom in Linux, do the following procedure:
a. From the main screen, press Ctrl A + S (for sending files).
The Upload popup window appears.
Configuration 45
Page 66
Upgrading the AlterPath PM Firmware
b. Select xmodem as the protocol.
The Select a File for Upload screen appears.
c. Browse to and select the AlterPath PM firmware file for upload, and
press the Space key to tag it.
d. Press the Enter key to start the file transfer.
If you use a different terminal emulator, please refer to the documentation
provided by the manufacturer on how to transfer files using the Xmodem
protocol.
46 AlterPath PM Installation, Administration, and User’s Guide
Page 67
Upgrading the AlterPath PM Firmware
If the file transfer is successful, the AlterPath PM console displays the
login prompt. At this point, the upgrade process of the unit is complete;
you may log into the AlterPath PM and perform actions as usual.
----------------------------Enter choice (1 or 2): 1
Erasing firmware...done.
Downloading image. Please send file in 10
seconds.done.
V_1.2.0 - V_1.7.0 compatible
1: Outlet turned on.
2: Outlet turned on.
3: Outlet turned on.
4: Outlet turned on.
5: Outlet turned on.
6: Outlet turned on.
7: Outlet turned on.
8: Outlet turned on.
AlterPath PM
Copyright (c) 2002-2005 Cyclades
Corporation
V 1.7.1 Oct 4, 2005
[PM]: IPDU: 1
[PM]: OUT: 8
Username:
If the file transfer fails, an error message appears on the AlterPath PM
console, and the boot loader menu is displayed again so you can redo the
process.
Configuration 47
Page 68
Upgrading the AlterPath PM Firmware
The screen would be similar to the one shown below:
Erasing firmware...done.
Downloading image. Please send file in 10
seconds. error.
----------------------------Copyright (c) 2003 Cyclades Corporation
AlterPath PM/KVM Boot Loader Version 1.1
----------------------------Boot Menu
1. Upgrade Firmware.
2. Boot Firmware.
----------------------------Enter choice (1 or 2):
In this case, return to Step 3. If the problem persists, contact Cyclades
Technical Support for assistance.
48 AlterPath PM Installation, Administration, and User’s Guide
Page 69
Chapter 4
Command Line Interface
When using the AlterPath PM independently of other Cyclades products,
users and administrators can access the PM command line interface through a
terminal emulation program by making a console connection from a local
computer to the IN port on the PM. See “To Access the Console” on page 34
for instructions.
The following sections describe the PM command line interface and the
commands available to users and administrators:
• PM User Interface
• Commands
Page 70
PM User Interface
PM User Interface
You can access the PM user interface by following the instructions provided
in “To Access the Console” on page 34. The menu that appears after
connecting to the console depends on whether the PM has booted or not
before you connect.
If you connect to the console before powering on the AlterPath PM or reboot
while connected, the Boot Menu appears:
Boot Menu
1. Upgrade Firmware.
2. Boot Firmware.
-----------------------------
Enter choice (1 or 2):
If the PM has already booted before you connect to the AlterPath PM through
the console, the Login prompt appears
AlterPath PM
Copyright (c) 2002-2005 Cyclades
Corporation
V 1.7.1 Oct 4, 2005
[PM]: IPDU: 1
[PM]: OUT: 8
Username:
On the Boot Menu, do one of the following options: Do nothing or enter 2 to
select the Boot Firmware option. The Login prompt appears.
The line
[PM]: IPDU: displays the number of PMs daisy chained. If no PMs
are daisy chained, the value is 1.
The line
[PM]: OUT: displays the total number of outlets on a single PM or
on all daisy-chained PMs.
50 AlterPath PM Installation, Administration, and User’s Guide
Page 71
PM User Interface
After the “Username:” prompt, enter your username.
After the “
Password:” prompt, enter the password for the unsername
entered.
The default user is admin with password “pm8”.
After a successful login, the PM command prompt appears after which you
can use any of the commands described in “Commands” on page 52.
AlterPath PM
Copyright (c) 2002-2005 Cyclades
Corporation
V 1.7.1 Oct 4, 2005
[PM]: IPDU: 1
[PM]: OUT: 8
Username: admin
Password:
pm>
After logging in, the administrator can choose to change his or her password
through the passwd command (seen later). Passwords can be set to null, which
indicates that no password is needed.
To know all the commands supported by the PM, review the following
sections or type the
help command.
Command Line Interface 51
Page 72
Commands
Commands
All commands are available to the admin user, and most commands are
available to regular users as well.
The following commands are available to regular users and the admin user:
Command Page Command Page
alarm
buzzer status
current
currentprotection
cycle
exit
factory_defaults
help
interval
list
lock
off
Page 53
Page 55
Page 56
Page 57
Page 58
Page 60
Page 61
Page 62
Page 65
Page 66
Page 67
Page 69
on
passwd
reboot
restore
save
status
syslog
temperature
unlock
ver
whoami
Page 70
Page 70
Page 71
Page 74
Page 75
Page 76
Page 77
Page 78
Page 80
Page 80
Page 81
The following commands are available only to the admin user:
Command Page Command Page
adduser
assign
deluser
52 AlterPath PM Installation, Administration, and User’s Guide
Page 53
Page 54
Page 59
id
name
unassign
Page 64
Page 67
Page 79
Page 73
adduser
Commands
Adds one username to the internal database. A maximum of eight characters
(not case sensitive) is allowed, and a maximum of eight individual users is
allowed. This command is available to the admin user only.
Syntax
adduser <user>
Arguments
<user> Desired username
Examples
pm>adduser popper
Password:
Re-enter password:
Username/password set for user popper.
pm>
alarm
Sets and reads the current threshold.This command is available to
administrator only.
Syntax
alarm <IPDU#> <threshold>
Arguments
<IPDU#> IPDU number in a daisy chain
<threshold> The current threshold is the maximum allowed
current on the power strip
Command Line Interface 53
Page 74
Commands
assign
Examples
To set the threshold, type:
pm>alarm 1 5.6
Setting alarm threshold on IPDU #1 to 5.6A
pm>alarm 2 7.8
Setting alarm threshold on IPDU #2 to 7.8A
To read the threshold of a single unit, type:
pm>alarm
Alarm threshold on IPDU #1 is 5.6A
Alarm threshold on IPDU #2 is 7.8A
Assigns an outlet to a given user. The user is then be able to manage such
outlets. This command is available to the administrator user only.
Syntax
assign <outlet number> <user>
Arguments
<outlet number> Outlet number, such as “5”, outlet name such as
“sunfire”, or group of outlets such as “1, 3-5”
<user> Desired username
54 AlterPath PM Installation, Administration, and User’s Guide
Page 75
Examples
To assign outlet 4, 6, 7, and 8 to user tess, type:
pm>assign 4, 6-8 tess
4: Outlet assigned to tess.
6: Outlet assigned to tess.
7: Outlet assigned to tess.
8: Outlet assigned to tess.
buzzer status
Displays or changes the buzzer notification status. A buzzer may when there
is an overcurrent situation.
Syntax
buzzer status <status|on|off>
Commands
Arguments
status Displays the buzzer status
on Enables buzzer
off Disables buzzer
Examples
To get the current status of the buzzer notification, type:
pm>buzzer status
Buzzer is ON on IPDU #1
Buzzer is ON on IPDU #2
Command Line Interface 55
Page 76
Commands
current
To turn on or off the buzzer notification, type:
pm>buzzer on
Buzzer turned ON on IPDU #1
Buzzer turned ON on IPDU #2
pm>buzzer off
Buzzer turned OFF on IPDU #1
Buzzer turned OFF on IPDU #2
Displays the total current drawn by AlterPath PM units and the maximum
current the unit has drawn (current peak). It can also be used to clear the saved
peak current value.
Syntax
current <IPDU#> reset
Arguments
<IPDU#> IPDU number in a daisy chain
reset Clears the saved peak current value
Examples
To get the current status for all units, type:
pm> current
IPDU #1: True RMS current: 2.2A. Maximum current:
9.4A
IPDU #2: True RMS current: 2.0A. Maximum current:
10.2A
56 AlterPath PM Installation, Administration, and User’s Guide
Page 77
To get the current status for a specific unit, type:
pm> current 2
IPDU #2: True RMS current: 2.4A. Maximum current:
10.2A
To reset maximum current drawn, type:
pm>current reset
IPDU #1: Clearing maximum recorded current to zero.
IPDU #2: Clearing maximum recorded current to zero.
currentprotection
Turns on and off the over current protection feature. The overcurrent
protection does not let any outlet be turned on if the current drawn by the unit
is greater than the current threshold configured with the command alarm. This
command can also be used to display the current protection status.
Commands
Syntax
currentprotection <status|on|off>
Arguments
status Displays the current protection status
on Enables over current protection
off Disables over current protection
Examples
To display current protection status for all units, type:
pm>currentprotection status
IPDU #1: Overcurrent protection is OFF.
IPDU #2: Overcurrent protection is OFF.
Command Line Interface 57
Page 78
Commands
cycle
To enable current protection status for all units, type:
pm>currentprotection ON
IPDU #1: Overcurrent protection turned ON.
IPDU #2: Overcurrent protection turned ON.
To disable current protection status for all units, type:
pm>currentprotection off
IPDU #1: Overcurrent protection turned OFF.
IPDU #2: Overcurrent protection turned OFF.
Power cycles an outlet or groups of outlets. You can use the outlet number or
the outlet name (see command name for details).
Syntax
cycle all|<outlet number>
Arguments
all Turns off all outlets
<outlet number> Outlet number, such as “5”, outlet name such as
“sunfire”, or group of outlets such as “1, 3-5”
Examples
To cycle one outlet, type:
pm> cycle 3
3: Outlet turned off.
3: Outlet turned on.
58 AlterPath PM Installation, Administration, and User’s Guide
Page 79
deluser
Commands
To cycle multiple outlets, type:
pm>cycle 2, 3, 5-7
2: Outlet turned off.
3: Outlet turned off.
5: Outlet turned off.
6: Outlet turned off.
7: Outlet turned off.
2: Outlet turned on.
3: Outlet turned on.
5: Outlet turned on.
6: Outlet turned on.
7: Outlet turned on.
Deletes one username from the internal database. This command is available
to the administrative user only.
Syntax
deluser <user>
Arguments
<user> Desired username
Examples
To delete the user rog, type:
pm>deluser rog
Username deleted.
Command Line Interface 59
Page 80
Commands
exit
Exits the session.
Syntax
exit
Arguments
N/A
Examples
To exit the current session, type:
pm>exit
AlterPath PM
Copyright (c) 2002-2005 Cyclades
Corporation
V 1.7.1 Oct 4, 2005
Username:
60 AlterPath PM Installation, Administration, and User’s Guide
Page 81
factory_defaults
Resets the unit to its factory configuration so that all outlets are on, unlocked,
unnamed, and no users are created. When used with a daisy chain, this
command resets all units in the chain.
Syntax
factory_defaults
Arguments
N/A
Examples
To reset the factory defaults, type:
pm>factory_defaults
Setting configuration to defaults on IPDU
#1
1: Outlet turned on.
2: Outlet turned on.
3: Outlet turned on.
4: Outlet turned on.
5: Outlet turned on.
6: Outlet turned on.
7: Outlet turned on.
8: Outlet turned on.
Saving configuration to flash on IPDU #1
... done.
Commands
Command Line Interface 61
Page 82
Commands
help
Displays the system help message for all commands or for a single command
when specified.
Syntax
<command> help
or
help
Arguments
<command> Any available command
Examples
To view the system help message for a specific command, type the command
and then type “help”:
pm>syslog help
Usage: syslog on | off
Turn the syslog messages on the console on or off
62 AlterPath PM Installation, Administration, and User’s Guide
Page 83
Commands
To view the system help message for all commands, type:
pm>help
Available commands:
cycle deluser factory_defaults
interval list lock
help name off
on passwd reboot
restore save status
syslog temperature ver
unassign unlock whoami
buzzer current currentprotection
adduser alarm assign
id
NOTE: To get detailed help on the commands listed
above type
'<command> help';
NOTE: Some commands accept as input a data type
called
<outletString>. <outletString> is a string
representing
one or more outlets. This string can be:
- one single outlet.
Examples: on 3 (turn on outlet 3);
off router (turn off the outlet
called
router).
- a group of outlets.
Examples: status 1,3,5 (get status of outlets
1,
3 and 5);
cycle 2-7 (cycle the outlets 2, 3, 4,
5, 6, 7)
lock 2,5-7 (lock the outlets 2, 5, 6
and 7).
Command Line Interface 63
Page 84
Commands
id
Sets or displays the ID of a PM unit that you are directly connected to. A
maximum of eight characters (not case sensitive) is allowed. Spaces, numbers,
and special characters are allowed.
This command is available to the administrator user only.
This command does not work in a daisy chain.
Syntax
id <PM name>
or
id
Arguments
<PM name> Desired name of the PM
Examples
To set a PM ID to RDservers, type:
pm>id RDservers
PM id = RDservers
To display the name of the connected PM, type:
pm>id
PM id = RDservers
64 AlterPath PM Installation, Administration, and User’s Guide
Page 85
interval
Commands
Configures the power up interval for each outlet in the system. The power up
interval of an outlet is the time the unit will wait, after turning this outlet on, to
turn on any other outlet.
Syntax
interval <outlet number> <duration>
Arguments
<duration> Sets the power up interval of outlets.
Default value is 0.5.
<outlet number> Outlet number, such as “5”, outlet name such as
“sunfire”, or group of outlets such as “1, 3-5”
Examples
To display the interval, type:
pm>interval 1
To set the interval, type:
pm>interval 2, 4-6 2.4
2: Outlet cycle interval set to 2.40.
4: Outlet cycle interval set to 2.40.
5: Outlet cycle interval set to 2.40.
6: Outlet cycle interval set to 2.40.
Command Line Interface 65
Page 86
Commands
list
pm>list
---------------------------------------------------User Outlets
---------------------------------------------------kant 1,5
diderot 2,6
russel 3,7
tao 4,8
----------------------------------------------------
List users created and outlets assigned to each user (for the administrator), or
just the outlets assigned to the user logged in at the moment (for the regular
user).
Syntax
list
Arguments
N/A
Examples
To list user names in the internal database, type:
To list the usernames in the internal database, type:
pm>list
---------------------------------------------------User Outlets
---------------------------------------------------kant 1,5
---------------------------------------------------pm>
66 AlterPath PM Installation, Administration, and User’s Guide
Page 87
lock
Commands
Locks an outlet or group of outlets in the current state. The response to this
command is a list of status lines, one per power port.
Syntax
lock <outlet number>
Arguments
<outlet number> Outlet number, such as “5”, outlet name such as
“sunfire”, or group of outlets such as “1, 3-5”
Examples
To lock outlets 1, 2, and 6, type:
pm>lock 2,6,1
1: Outlet locked.
2: Outlet locked.
6: Outlet locked.
name
Names an outlet. A maximum of 16 alphabetic and numeric characters (not
case sensitive) is allowed with these exceptions:
• The hyphen (-), percent (%), and comma (,) characters are not allowed.
• Numeric characters are not allowed as the first character of a name.
This command is available to the administrator user only.
Syntax
name <outlet number> <name>
Command Line Interface 67
Page 88
Commands
Arguments
<outlet number> Outlet number, such as “5”
<name> Desired outlet name
Examples
To name outlet 4 as nowhere, type:
pm>name 4 nowhere
4: Outlet now named nowhere
68 AlterPath PM Installation, Administration, and User’s Guide
Page 89
off
Commands
Turns an outlet or group of outlets off.
Syntax
off all|<outlet number>
Arguments
all Turns off all outlets
<outlet number> Outlet number, such as “5”, outlet name such as
“sunfire”, or group of outlets such as “1, 3-5”
Examples
To turn all outlets off, type:
pm>off all
1: Outlet turned off.
2: Outlet turned off.
3: Outlet turned off.
4: Outlet turned off.
5: Outlet turned off.
6: Outlet turned off.
7: Outlet turned off.
8: Outlet turned off.
To turn off all outlets but 1 and 8, type:
pm>off 2-7
2: Outlet turned off.
3: Outlet turned off.
4: Outlet turned off.
5: Outlet turned off.
6: Outlet turned off.
7: Outlet turned off.
Command Line Interface 69
Page 90
Commands
on
Turns an outlet or a group of outlets on. If more than one outlet is selected
there will be an interval between outlets being powered on, the interval is
defined by the
interval command.
Syntax
on all|<outlet number>
Arguments
all Turns off all outlets
<outlet number> Outlet number, such as “5”, outlet name such as
“sunfire”, or group of outlets such as “1, 3-5”.
Examples
To turn on outlets 1, 3, 4, and 5, type:
passwd
pm>on 1, 3-5
1: Outlet turned on.
3: Outlet turned on.
4: Outlet turned on.
5: Outlet turned on.
Sets a password. The Administrator has a default password (pm8), which can
be changed. Regular users can change or set only their own password. The
Administrator can change his or her own password or any regular user’s
password.
Syntax
passwd <newpassword>
70 AlterPath PM Installation, Administration, and User’s Guide
Page 91
Commands
Arguments
<newpassword> A maximum of eight characters (not case sensitive) is
allowed.
Examples
To change the password for user alpha, type:
pm>passwd alpha
Password:
Re-enter password:
Username/password set for user alpha.
To change the admin password, type:
pm>passwd
Password: <new password>
Re-enter password:
Username/password set for user admin.
reboot
Reboots the PM units. You can also reboot a specific unit number. Issuing the
reboot command with out a parameter reboots the first unit in a chain, not all
the units in a chain.
Syntax
reboot
or
reboot <IPDU#>
Arguments
<IPDU#> IPDU number in a daisy chain
Command Line Interface 71
Page 92
Commands
pm>reboot
----------------------------Copyright (c) 2005 Cyclades Corporation
PM/KVM Boot Loader Version 1.1
----------------------------Boot Menu
1. Upgrade Firmware.
2. Boot Firmware.
----------------------------Enter choice (1 or 2): Timeout...
Booting...
Starting AlterPath PM
Retrieving configuration
Examples
To reboot the first unit of the chain, or to reboot the unit in stand alone mode,
type:
1: Outlet turned on.
2: Outlet turned on.
3: Outlet turned on.
4: Outlet turned on.
5: Outlet turned on.
6: Outlet turned on.
7: Outlet turned on.
8: Outlet turned on.
AlterPath PM
Copyright (c) 2002-2005 Cyclades Corporation
V 1.7.1 Oct 4, 2005
[PM]: IPDU: 1
[PM]: OUT: 8
Username:
72 AlterPath PM Installation, Administration, and User’s Guide
Page 93
To reboot the a specific IPDU in the chain, type:
pm>reboot 4
----------------------------Copyright (c) 2005 Cyclades Corporation
PM/KVM Boot Loader Version 1.1
----------------------------Boot Menu
1. Upgrade Firmware.
2. Boot Firmware.
----------------------------Enter choice (1 or 2): Timeout...
Booting...
Starting AlterPath PM
Retrieving configuration
1: Outlet turned on.
2: Outlet turned on.
3: Outlet turned on.
4: Outlet turned on.
5: Outlet turned on.
6: Outlet turned on.
7: Outlet turned on.
8: Outlet turned on.
Commands
AlterPath PM
Copyright (c) 2002-2005 Cyclades Corporation
V 1.7.1 Oct 4, 2005
[PM]: IPDU: 4
[PM]: OUT: 8
Username:
Command Line Interface 73
Page 94
Commands
restore
Restores the configuration currently saved in flash.
Syntax
restore
Arguments
N/A
Examples
To restore the configuration currently saved in flash, type:
pm>restore
1: Outlet turned on.
2: Outlet turned on.
3: Outlet turned on.
4: Outlet turned on.
5: Outlet turned on.
6: Outlet turned on.
7: Outlet turned on.
8: Outlet turned on.
74 AlterPath PM Installation, Administration, and User’s Guide
Page 95
save
Commands
Saves the current configuration in the flash device built in to all AlterPath PM
units. This command saves the username/password database and the specific
information pertaining to each outlet such as outlet name, outlet assignments,
outlet state.
If you save your configuration to flash it will be restored after the next reboot.
If you do not save your configuration to flash you will lose it all after the next
reboot.
Syntax
save
Arguments
N/A
Examples
To save the configuration to flash, type:
pm>save
Saving configuration to flash on IPDU #1 ... Done.
Saving configuration to flash on IPDU #2 ... Done.
An error message will be displayed if there is an error while writing the
configuration to flash.
Command Line Interface 75
Page 96
Commands
status
pm>status 1
Outlet Name Status Interval (s) Users
1 linux Unlocked ON 0.50 nei
Displays the status of selected outlets.
Syntax
status <outlet number>
Arguments
<outlet number> Outlet number, such as “5”, outlet name such as
“sunfire”, or group of outlets such as “1, 3-5”
Examples
76 AlterPath PM Installation, Administration, and User’s Guide
Page 97
syslog
Commands
Displays or changes the syslog notification status.
Syntax
syslog on|off
Arguments
on Enables message to be displayed in the console when
there is an over current situation
off Disables the message notification
Examples
To get the current status of the syslog notification use syslog, type:
pm>syslog
Syslog is ON on IPDU #1
Syslog is ON on IPDU #2
To turn on and off the syslog notification use
type:,
pm>syslog on
Syslog turned ON on IPDU #1
Syslog turned ON on IPDU #2
pm>syslog off
Syslog turned OFF on IPDU #1
Syslog turned OFF on IPDU #2
Command Line Interface 77
syslog on or syslog off
Page 98
Commands
temperature
This command displays the AlterPath PM unit’s surrounding temperature and
the maximum temperature the unit has registered (temperature peak). It can
also be used to clear the saved peak temperature value.
Syntax
temperature <IPDU#>|reset
Arguments
<IPDU#> IPDU number in a daisy chain
reset Resets the maximum temperature registered
Examples
To get the temperature for all units in a daisy chain, type:
pm> temperature
IPDU #1: Temperature: 36.1°C (96.9°F). Maximum:
36.1°C (96.9°F).
IPDU #2: Temperature: 20.0°C (68.0°F). Maximum:
25.0°C (77.0°F).
To get the temperature for specific unit, provide the unit number as an
argument, type:
pm> temperature 2
IPDU #2: Temperature: 20.0°C (68.0°F). Maximum:
25.0°C (77.0°F)
78 AlterPath PM Installation, Administration, and User’s Guide
Page 99
pm>temperature reset
IPDU #1: Clearing maximum recorded temperature to
zero.
IPDU #2: Clearing maximum recorded temperature to
zero.
unassign
Commands
To reset the maximum temperature registered, use reset as a argument, type:
Removes the assignment of an outlet or group of outlets from a given user.
This command is available to the administrator user only.
Syntax
unassign <outlets> <user>
Arguments
<outlet number> Outlet number, such as “5”, outlet name such as
“sunfire”, or group of outlets such as “1, 3-5”
<user> Desired username
Examples
To unassign outlet 2 and 4 from user diderot, type:
pm>unassign 2,4 diderot
2: Outlet no longer assigned to diderot.
4: Outlet no longer assigned to diderot.
Command Line Interface 79
Page 100
Commands
unlock
Unlocks an outlet or group of outlets in the current state. The response to this
command is a list of status lines, one per power port.
Syntax
unlock <outlet number>
Arguments
<outlet number> Outlet number, such as “5”, outlet name such as
“sunfire”, or group of outlets such as “1, 3-5”
Examples
To unlock outlets 2, 3, and 8, type:
pm>unlock 2,3,8
2: Outlet unlocked.
3: Outlet unlocked.
8: Outlet unlocked.
ver
Shows the current software version.
Syntax
ver <IPDU#>
Arguments
<IPDU#> IPDU number in a daisy chain
80 AlterPath PM Installation, Administration, and User’s Guide
Loading...