1. DL manuals
  2. Raritan
  3. Power distribution unit
  4. PX-1000 Series
  5. User Manual

Raritan PX-1000 Series User Manual - Applicable Models

Summary of PX-1000 Series

  • Page 1

    Copyright © 2012 raritan, inc. Dpx2-1000-0d-v2.3-e march 2012 255-80-6105-00 px-1000/2000 series user guide release 2.3.

  • Page 2: Safety Guidelines

    Warning! Read and understand all sections in this guide before installing or operating this product. Warning! Connect this product to an ac power source whose voltage is within the range specified on the product's nameplate. Operating this product outside the nameplate voltage range may result in el...

  • Page 3: Safety Instructions

    1. Installation of this product should only be performed by a person who has knowledge and experience with electric power. 2. Make sure the line cord is disconnected from power before physically mounting or moving the location of this product. 3. This product is designed to be used within an electro...

  • Page 4

    This document contains proprietary information that is protected by copyright. All rights reserved. No part of this document may be photocopied, reproduced, or translated into another language without express prior written consent of raritan, inc. © copyright 2012 raritan, inc. All third-party softw...

  • Page 5

    V contents safety guidelines ii safety instructions iii applicable models xiii what's new in the dominion px user guide xiv chapter 1 introduction 1 product models .............................................................................................................................. 1 product...

  • Page 6

    Contents vi preparing the installation site............................................................................................16 filling out the equipment setup worksheet ..................................................................... 16 checking the branch circuit rating................

  • Page 7

    Contents vii dominion px explorer pane..............................................................................................70 setup button ...................................................................................................................... 73 status bar ......................

  • Page 8

    Contents viii outlet management ................................................................................................................... 133 naming outlets ................................................................................................................134 checking associat...

  • Page 9

    Contents ix copying configurations with bulk configuration ....................................................................... 201 saving a dominion px configuration ..............................................................................202 copying a dominion px configuration................

  • Page 10

    Contents x ip configuration ...............................................................................................................234 lan interface settings.....................................................................................................235 networking mode..................

  • Page 11

    Contents xi turning off the outlet(s)..................................................................................................377 power cycling the outlet(s).............................................................................................378 unblocking a user.......................

  • Page 12

    Contents xii rf code energy monitoring solution ........................................................................................410 appendix f additional dominion px information 411 mac address......................................................................................................

  • Page 13: Applicable Models

    Xiii this user guide is applicable to the px-1000 and px-2000 series, whose model name follows the px2-1nnn or px2-2nnn format, where n is a number. Note: for information on px2-3nnn, px2-4nnn and px2-5nnn series, see the "px2-3000/4000/5000 series" user guide or online help. Applicable models.

  • Page 14: Guide

    Xiv the following sections have changed or information has been added to the dominion px user guide based on enhancements and changes to the equipment and/or user documentation. Installing the usb-to-serial driver (on page 20) connecting blade extension strips (on page 43) connecting ams-m2-z asset ...

  • Page 15

    What's new in the dominion px user guide xv truncated data in the web interface (on page 418) please see the release notes for a more detailed explanation of the changes applied to this version of dominion px..

  • Page 16: Chapter 1

    1 the dominion px is an intelligent power distribution unit (pdu) that allows you to reboot remote servers and other network devices and/or to monitor power in the data center. The intended use of the raritan dominion px is distribution of power to information technology equipment such as computers ...

  • Page 17

    Chapter 1: introduction 2 - power factor - active energy (wh) - unbalanced load percentage the ability to monitor the following at the circuit breaker level: - status (closed/open) - current drawn (a) - current remaining (a) the ability to monitor environmental factors such as external temperature a...

  • Page 18

    Chapter 1: introduction 3 the ability to configure and set values through snmp, including power threshold levels the ability to save one dominion px device's configuration settings and then deploy those settings to other dominion px devices led display orientation adjustment support support for ssh ...

  • Page 19

    Chapter 1: introduction 4 zero u products the dominion px device screws, brackets and/or buttons for zero u a null-modem cable with db9 connectors on both ends (raritan number: 254-01-0006-00) (optional) cable retention clips for the inlet (for some models only) cable retention clips for outlets (fo...

  • Page 20: Chapter 2

    5 this chapter describes how to rackmount a dominion px device. To mount a zero u px-1000 series pdu, you can use either two buttons or l-brackets that raritan provided. In this chapter rackmount safety guidelines ...................................................................5 circuit breaker o...

  • Page 21

    Chapter 2: rack-mounting the pdu 6 mounting zero u models using l-brackets if your pdu has circuit breakers implemented, read circuit breaker orientation limitation (on page 5) before mounting it. To mount zero u models using l-brackets: 1. Align the baseplates on the rear of the dominion px device....

  • Page 22

    Chapter 2: rack-mounting the pdu 7 5. Using rack screws, fasten the dominion px device to the rack through the l-brackets. Mounting zero u models using button mount if your pdu has circuit breakers implemented, read circuit breaker orientation limitation (on page 5) before mounting it. To mount zero...

  • Page 23

    Chapter 2: rack-mounting the pdu 8 2. Make the baseplates grasp the dominion px device lightly. Use the included l-shaped hex key to loosen the hex socket screws until the baseplate is "slightly" fastened. 3. Screw each mounting button in the center of each baseplate. The recommended torque for the ...

  • Page 24

    Chapter 2: rack-mounting the pdu 9 mounting zero u models using claw-foot brackets if your pdu has circuit breakers implemented, read circuit breaker orientation limitation (on page 5) before mounting it. To mount zero u models using claw-foot brackets: 1. Align the baseplates on the rear of the dom...

  • Page 25

    Chapter 2: rack-mounting the pdu 10 5. Using rack screws, fasten the dominion px device to the rack through the claw-foot brackets. Mounting zero u models using two rear buttons the following describes how to mount a pdu using two buttons only. If your pdu has circuit breakers implemented, read circ...

  • Page 26

    Chapter 2: rack-mounting the pdu 11 3. Screw a button in the screw hole near the bottom. The recommended torque for the button is 1.96 n·m (20 kgf·cm). 4. Screw a button in the screw hole near the top. The recommended torque for the button is 1.96 n·m (20 kgf·cm). 5. Ensure that the two buttons can ...

  • Page 27

    Chapter 2: rack-mounting the pdu 12 mounting zero u models using l-brackets and buttons this section describes how to mount a pdu using l-brackets and two buttons. If your pdu has circuit breakers implemented, read circuit breaker orientation limitation (on page 5) before mounting it. To mount zero ...

  • Page 28

    Chapter 2: rack-mounting the pdu 13 3. Repeat steps 1 to 2 to screw another l-bracket to the bottom of the device. 4. After both l-brackets are installed on the device, you can choose either of the following ways to mount the device in the rack.  using rack screws, fasten the device to the rack thr...

  • Page 29

    Chapter 2: rack-mounting the pdu 14 2. Repeat step 1 for securing the other rackmount bracket to the other side of the dominion px. 3. Insert one end of the cable-support bar into the l-shaped hole of the rackmount bracket, and align the hole on the end of the bar with the threaded hole adjacent to ...

  • Page 30: Chapter 3

    15 this chapter explains how to install a dominion px device and configure it for network connectivity. In this chapter before you begin ....................................................................................15 installing cable retention clips on the inlet (optional).......................

  • Page 31

    Chapter 3: installation and configuration 16 preparing the installation site 1. Make sure the installation area is clean and free of extreme temperatures and humidity. Note: if necessary, contact raritan technical support for the maximum operating temperature for your model. See maximum ambient oper...

  • Page 32

    Chapter 3: installation and configuration 17 installing cable retention clips on the inlet (optional) if your dominion px device is designed to use a cable retention clip, install the clip before connecting a power cord. A cable retention clip prevents the connected power cord from coming loose or f...

  • Page 33

    Chapter 3: installation and configuration 18 for a pdu with fuses, ensure that all fuses are inserted and seated properly. If there are any fuse covers, ensure that they are closed. Note: not all dominion px devices have overcurrent protection mechanisms. 2. Connect each dominion px device to an app...

  • Page 34

    Chapter 3: installation and configuration 19 connecting the dominion px to a computer to configure the dominion px using a computer, it must be connected to the computer with an rs-232 serial interface. These diagrams show the serial port location on different types of pdus. Zero u models: 1u models...

  • Page 35

    Chapter 3: installation and configuration 20 1. Connect one end of the null-modem cable to the rs-232 port labeled console / modem on the dominion px. 2. Connect the other end of the null-modem cable to the serial port (com) on the computer. To make a usb connection: 1. Connect one end of a regular ...

  • Page 36

    Chapter 3: installation and configuration 21  on a cd disc with sp2 included, it is extracted from i386\sp2.Cab.  on a cd without an sp, it is extracted from i386\driver.Cab. 3. Connect the dominion px's usb cable to the computer. 4. The computer detects the new device and the "found new hardware ...

  • Page 37

    Chapter 3: installation and configuration 22 see this diagram for the ethernet port location on zero u models. For 1u/2u models, the ethernet port is usually located on the back except for a few models. This diagram shows the port on the back. For 2u models, the ethernet port is located on the front...

  • Page 38

    Chapter 3: installation and configuration 23 initial network configuration after the dominion px device is connected to your network, you must provide it with an ip address and some additional networking information. This section describes the initial configuration via a serial or usb connection. No...

  • Page 39

    Chapter 3: installation and configuration 24 where is either wired for wired connection (default) or wireless for wireless connection. B. For the wired network mode, you may configure the lan interface settings. In most scenarios, the default setting (auto) works well and should not be changed unles...

  • Page 40

    Chapter 3: installation and configuration 25 to set use this command authentication method network wireless authmethod where is psk for pre-shared key or eap for extensible authentication protocol. Psk network wireless psk where is the psk string. Eap outer authentication network wireless eapouterau...

  • Page 41

    Chapter 3: installation and configuration 26 to set use this command ip protocol network ip proto where is v4only for enabling ipv4, v6only for enabling ipv6 or both for enabling both ipv4 and ipv6 protocols. Ip address returned by the dns server network ip dnsresolverpreference where is preferv4 fo...

  • Page 42

    Chapter 3: installation and configuration 27  for the static ipv4 configuration, configure these parameters. To set use this command static ipv4 address network ipv4 ipaddress address> where is the ip address you want to assign. Subnet mask network ipv4 subnetmask where is the subnet mask. Gateway ...

  • Page 43

    Chapter 3: installation and configuration 28 where is enable or disable. See the table below for the ipv6 commands for manually specifying dns servers.  for the static ipv6 configuration, you should configure the following parameters. Note that the ip address must follow the ipv6 format. To set use...

  • Page 44

    Chapter 3: installation and configuration 29 command description show network show network parameters. Show network ip all show all ip configuration parameters. Show network wireless details show all wireless parameters. (perform this command only when you enable the wireless mode.) tip: you can als...

  • Page 45

    Chapter 3: installation and configuration 30 2. Determine which device is used as the master device.  the master device must be connected to the lan via a standard category 5e/6 utp cable. 3. Connect the usb-a port of the master device to the usb-b port of another dominion px device via an usb cabl...

  • Page 46

    Chapter 3: installation and configuration 31 number device role master device the first slave device the second slave device the third slave device note: on a master device, the networking mode shows "wired." on a slave device, the networking mode shows "wired(usb)," which indicates it is connected ...

  • Page 47

    Chapter 3: installation and configuration 32 installing cable retention clips on outlets (optional) if your dominion px device is designed to use a cable retention clip, install the clip before connecting a power cord. A cable retention clip prevents the connected power cord from coming loose or fal...

  • Page 48

    Chapter 3: installation and configuration 33 3. Plug the power cord into the outlet, and press the clip toward the power cord until it holds the cord firmly. The clip's central area holding the plug should face downwards toward the ground, like an inverted "u". This allows gravity to keep the clip i...

  • Page 49

    Chapter 3: installation and configuration 34 to connect environmental sensors via an optional px sensor hub: 1. Connect a raritan sensor hub to the dominion px device. A. Plug one end of the raritan-provided phone cable (4-wire, 6-pin, rj-12) into the in port (port 1) of the hub. B. Plug the other e...

  • Page 50

    Chapter 3: installation and configuration 35 about contact closure sensors raritan's contact closure sensor (dpx-cc2-tr) can detect the open-and-closed status of the connected detectors/switches. This feature requires the integration of at least a discrete (on/off) detector/switch to work properly. ...

  • Page 51

    Chapter 3: installation and configuration 36 note: each button controls the spring of each corresponding termination point. 3. Fully insert each wire of both third-party detectors/switches into each termination point.  plug both wires of a detector/switch into the two termination points to the left...

  • Page 52

    Chapter 3: installation and configuration 37  normally open: the open status of the connected detector/switch is considered normal.  normally closed: the closed status of the connected detector/switch is considered normal. This is the default. 5. To set the normal state for channel 2, repeat step ...

  • Page 53

    Chapter 3: installation and configuration 38 how to connect differential air pressure sensors you can have a raritan differential air pressure sensor connected to the dominion px device if the differential air pressure data is desired. With this sensor, the temperature around the sensor can be also ...

  • Page 54

    Chapter 3: installation and configuration 39 combining asset sensors each tag port on the asset sensors corresponds to a rack unit and can be used to locate the it devices on a specific rack (or cabinet). For each rack, you can attach asset sensors up to 64u long, consisting of one master and multip...

  • Page 55

    Chapter 3: installation and configuration 40  make sure that the u-shaped sheet metal adjacent to the male din connector is inserted into the rear slot of the master asset sensor. Screw up the u-shaped sheet metal to reinforce the connection. 2. Connect another 8u slave asset sensor to the one bein...

  • Page 56

    Chapter 3: installation and configuration 41 connecting asset sensors to the dominion px you need both of asset sensors and asset tags for tracking it devices. Asset tags, which are affixed to it devices, provide an id number for each it device, while the asset sensors transmit id numbers and positi...

  • Page 57

    Chapter 3: installation and configuration 42 the dominion px device supplies power to the asset sensor assembly through the category 5e/6 cable. All leds on the asset sensor assembly may cycle through different colors during the power-on process if the asset sensor's firmware is being upgraded by th...

  • Page 58

    Chapter 3: installation and configuration 43 connecting blade extension strips for blade servers, which are contained in a single chassis, you can use a blade extension strip to track individual blade servers. Raritan's blade extension strip functions similar to a raritan asset sensor but requires a...

  • Page 59

    Chapter 3: installation and configuration 44 note: each tag pot on the blade extension strip is labeled a number, which is displayed as the slot number in the dominion px's web interface. To install a blade extension strip: 1. Connect the tag connector cable to the blade extension strip.  plug the ...

  • Page 60

    Chapter 3: installation and configuration 45 b. Plug the tag connector of the asset tag into the tag port on the blade extension strip. 4. Repeat the above step until all blade servers in the chassis are connected to the blade extension strip via asset tags. 5. Plug the tag connector of the blade ex...

  • Page 61

    Chapter 3: installation and configuration 46 connecting ams-m2-z asset sensors (optional) the ams-m2-z is a special type of asset sensor that functions the same as regular master asset sensors with the following differences. It provides two rj-45 connectors. Multiple ams-m2-z asset sensors can be da...

  • Page 62

    Chapter 3: installation and configuration 47 c. Connect the other end of the cable to the rj-45 connector labeled "input" on another ams-m2-z. D. Repeat the above steps to daisy chain additional ams-m2-z. See ams-m2-z daisy-chain limitations (on page 47) for the maximum number of ams-m2-z asset sens...

  • Page 63

    Chapter 3: installation and configuration 48 connecting a logitech webcam (optional) the dominion px supports logitech ® quickcam ® pro 9000 webcams connected to it, allowing you to view video or snapshots of the area surrounding the webcam. The dominion px supports up to one webcam. After connectin...

  • Page 64

    Chapter 3: installation and configuration 49 connecting a schroff lhx heat exchanger (optional) to remotely monitor and administer the schroff ® lhx-20 or lhx-40 heat exchangers through the dominion px device, you must establish a connection between the heat exchanger and the dominion px device. Not...

  • Page 65: Chapter 4

    50 this chapter explains how to use the dominion px device. It describes the leds and ports on the pdu, and explains how to use the led display panel. It also explains how the circuit breaker (overcurrent protector) works and when the beeper sounds. In this chapter panel components ....................

  • Page 66

    Chapter 4: using the pdu 51 px-1000 series these pdus are not outlet-switching capable models so all outlets are always in the on state. Outlet leds are not available. Px-2000 series these models are outlet-switching capable pdus. A small led is adjacent to each outlet to indicate the state of the r...

  • Page 67

    Chapter 4: using the pdu 52 for most of 1u and 2u models, there are 7 ports located on front and back panels respectively. - front panel ports: 1u 2u - back panel ports: the only port difference between zero u, 1u and 2u models is that zero u models provide only one sensor port while 1u and 2u model...

  • Page 68

    Chapter 4: using the pdu 53 port used for... Console/ modem establishing a serial connection between a computer and the dominion px device: this is a standard dte rs-232 port. You can use a null-modem cable with two db9 connectors on both ends to connect the dominion px device to the computer. Senso...

  • Page 69

    Chapter 4: using the pdu 54 led display the led display is located on the side where outlets are available. These diagrams show the led display on different types of pdus. Note that the led display might slightly vary according to the pdu you purchased. Zero u models: 1u models: 2u models:.

  • Page 70

    Chapter 4: using the pdu 55 the led display consists of: a row displaying three digits a row displaying two digits up and down buttons five leds for measurement units a zero u model can detect its own orientation through the built-in tilt sensor and automatically changes the direction of the alphanu...

  • Page 71

    Chapter 4: using the pdu 56 leds for measurement units five small led indicators are on the led display: four measurement units leds and one sensor led. The measurement units vary according to the readings that appear in the three-digit row. They are: amp (a) for current volt (v) for voltage kilowat...

  • Page 72

    Chapter 4: using the pdu 57 ap: this indicates the selected inlet's active power. Ul: this represents the selected inlet or outlet's unbalanced load, which is only available for a three-phase pdu. During the firmware upgrade, some dominion px models may show bx in the two-digit row to indicate the r...

  • Page 73

    Chapter 4: using the pdu 58 reset button the reset button is located inside the small hole near the two-digit row. The dominion px device can be reset to its factory default values using this button when a serial connection is available. See resetting to factory defaults (on page 393). Without the s...

  • Page 74

    Chapter 4: using the pdu 59 circuit breakers the dominion px models rated over 20a (north american) or 16a (international) contain branch circuit breakers. These circuit breakers automatically trip (disconnect power) when the current flowing through the circuit breaker exceeds its rating. If the cir...

  • Page 75

    Chapter 4: using the pdu 60 resetting the handle-type circuit breaker your handle-type circuit breakers may look slightly different from the images shown in this section, but the reset procedure remains the same. To reset the handle-type breakers: 1. Lift the hinged cover over the breaker. 2. Check ...

  • Page 76

    Chapter 4: using the pdu 61 fuse some dominion px devices are implemented with fuses instead of circuit breakers. A fuse blows to protect associated outlets if it detects the overload. If your pdu uses fuses, you must replace it with a new one when it blows or malfunctions. The rating of the new fus...

  • Page 77

    Chapter 4: using the pdu 62 3. Push the cover of the fuse holder to expose the fuse. 4. Take the fuse out of the holder. 5. Insert a new fuse into the holder. There is no orientation limit for fuse insertion. 6. Close the fuse holder and the hinged cover in a reverse order. Fuse replacement on 1u mo...

  • Page 78

    Chapter 4: using the pdu 63 to replace a fuse on the 1u pdus: 1. Disconnect the pdu's power cord from the power source. 2. Remove the desired fuse from the pdu's fuse carrier using a flat screwdriver. A. Rotate the fuse knob counterclockwise until its slot is inclined to 45 degrees. B. Take this kno...

  • Page 79

    Chapter 4: using the pdu 64 5. Verify whether this knob's head is aligned with the fuse carrier. If its head is higher or lower than the fuse carrier, re-install it. Number description inappropriate installations appropriate installation 6. Connect the pdu's power cord to the power source and verify...

  • Page 80: Chapter 5

    65 this chapter explains how to use the web interface to administer a dominion px. In this chapter supported web browsers........................................................................65 logging in to the web interface ..............................................................66 logout....

  • Page 81

    Chapter 5: using the web interface 66 logging in to the web interface to log in to the web interface, you must enter a user name and password. The first time you log in to the dominion px, use the default user name (admin) and password (raritan). You are then prompted to change the password for secu...

  • Page 82

    Chapter 5: using the web interface 67 note: depending on your hardware configuration, elements shown on the dominion px page may appear slightly different from this image. Changing your password normal users can change their own passwords if they have the change own password permission. See setting ...

  • Page 83

    Chapter 5: using the web interface 68 4. Click ok to save the changes. Tip: if you have the administrator privileges, you can change other users' passwords. See modifying a user profile (on page 106). Logout after finishing your tasks with the dominion px, you should log out to prevent others from a...

  • Page 84

    Chapter 5: using the web interface 69 introduction to the web interface the web interface provides two panes, a menu bar, a status bar, an add page icon, and a logout button throughout every page. Number web interface element menus dominion px explorer pane setup button* status bar add page icon log...

  • Page 85

    Chapter 5: using the web interface 70 menus there is a menu bar across the top of the page. You can click any menu to select the desired menu item from the drop-down list. Four menus are available for managing different tasks or showing information. User management contains menu items for managing u...

  • Page 86

    Chapter 5: using the web interface 71 first level second level third level feature port folder one of the following is displayed, depending on your configuration: none asset strip power cim lhx-20 lhx-40 webcam management snapshots webcam * the pdu folder is named "my px" by default. The name change...

  • Page 87

    Chapter 5: using the web interface 72 the arrow then turns into a black, gradient arrow , and icons representing individual components appear below the group folder. Repeat step 2 for other component groups you want to expand. The expanded tree looks similar to this image. Collapsing the tree you ca...

  • Page 88

    Chapter 5: using the web interface 73 the arrow then turns into a white arrow , and all items below the pdu folder disappear. To hide some tree items: 1. Click the black, gradient arrow prior to the component group folder that you want to collapse, or double-click the folder. The arrow then turns in...

  • Page 89

    Chapter 5: using the web interface 74 tip: the presence of the device name and ip address in the status bar indicates the connection to the dominion px device. If the connection is lost, it shows " " instead. Login name: this is the user name you used to log in to the web interface. Last login time:...

  • Page 90

    Chapter 5: using the web interface 75 add page icon the add page icon , located on the top of the data pane, lets you open data pages of multiple tree items without overriding any opened page. To open new data pages: 1. Click the add page icon . A new tab along with a blank data page appears. 2. Cli...

  • Page 91

    Chapter 5: using the web interface 76 2. When the mouse pointer turns into a two-way arrow, drag the border horizontally to widen or shrink the pane. More information this section explains additional web interface elements or operations that are useful. Warning icon if the value you entered in a spe...

  • Page 92

    Chapter 5: using the web interface 77 color state red the meaning of the red color varies depending on the sensor type: for a numeric sensor, this color indicates the reading drops below the lower critical threshold or rises above the upper critical threshold. For a discrete (on/off) sensor, this co...

  • Page 93

    Chapter 5: using the web interface 78 changing the view of a list some dialogs and data pages contain a list or table, such as the manage users dialog shown below. You may change the number of displayed columns or re-sort the list for better viewing the data. Note the column or sorting changes are n...

  • Page 94

    Chapter 5: using the web interface 79 2. When the mouse pointer turns to a two-way arrow, drag the border horizontally to widen or shrink the column. Changing the sorting by default, a list or table is sorted against the first column in the ascending order. You can re-sort the list in a reverse orde...

  • Page 95

    Chapter 5: using the web interface 80 browser-defined shortcut menu a shortcut menu, which is built in the web browser, may appear when right-clicking anywhere in the dominion px web interface. The shortcut menu functions are defined by the browser. For example, the back command on the internet expl...

  • Page 96

    Chapter 5: using the web interface 81 viewing the dashboard when you log in to the web interface, the dashboard page is displayed by default. This page provides an overview of the dominion px device's status. The page is divided into various sections according to the component type, such as inlet an...

  • Page 97

    Chapter 5: using the web interface 82 for the background color meanings in this section, see the yellow- or red-highlighted reading (on page 76). Device management using the web interface, you can retrieve basic hardware and software information, give the dominion px a new device name, set the syste...

  • Page 98

    Chapter 5: using the web interface 83 tab data hardware revision, and so on. Network the pdu specific network information, such as the current networking mode, ipv4 and/or ipv6 addresses and so on. This tab also indicates whether the pdu is part of an usb cascading configuration. See cascading the p...

  • Page 99

    Chapter 5: using the web interface 84 3. Type a new name in the device name field. 4. Click ok to save the changes. Modifying the network configuration the network settings you can change via the web interface include wired, wireless, ipv4 and/or ipv6 settings. Modifying the network interface settin...

  • Page 100

    Chapter 5: using the web interface 85 6. Click ok to save the changes. Tip: you can check the lan status in the current state field, including the speed and duplex mode. Wireless network settings wireless ssid, psk and bssid parameters were set during the installation and configuration process. See ...

  • Page 101

    Chapter 5: using the web interface 86 option description eap - peap peap stands for protected extensible authentication protocol. The following authentication data is required:  inner authentication: only microsoft's challenge authentication protocol version 2 (mschapv2) is supported, allowing auth...

  • Page 102

    Chapter 5: using the web interface 87 selecting the internet protocol the dominion px device supports two types of internet protocols -- ipv4 and ipv6. You can enable either or both internet protocols. After enabling the desired internet protocol(s), all but not limited to the following protocols wi...

  • Page 103

    Chapter 5: using the web interface 88 2. Click the ipv4 settings tab. 3. In the ip auto configuration field, click the drop-down arrow, and select the desired option from the list. Option description dhcp to auto-configure the dominion px, select dhcp. With dhcp selected, you can enter a preferred d...

  • Page 104

    Chapter 5: using the web interface 89 modifying the ipv6 settings you must enable the ipv6 protocol before you can modify the ipv6 network settings. See selecting the internet protocol (on page 87). To modify the ipv6 settings: 1. Choose device settings > network. The network configuration dialog ap...

  • Page 105

    Chapter 5: using the web interface 90 role of a dns server as internet communications are carried out on the basis of ip addresses, appropriate dns server settings are required for mapping domain names (host names) to corresponding ip addresses, or the dominion px may fail to connect to the given ho...

  • Page 106

    Chapter 5: using the web interface 91 3. Click ok to save the changes. Changing the ssh settings you can enable or disable the ssh access to the command line interface, or change the default tcp port for the ssh service. In addition, you can decide to log in using either the password or the public k...

  • Page 107

    Chapter 5: using the web interface 92 configuring the snmp settings you can enable or disable snmp communication between an snmp manager and the dominion px device. Enabling snmp communication allows the manager to retrieve and control the power status of each outlet. Besides, you may need to config...

  • Page 108

    Chapter 5: using the web interface 93 7. Click ok to save the changes. Important: you must download the snmp mib for your dominion px to use with your snmp manager. Click download mib in this dialog to download the desired mib file. For more details, see downloading snmp mib (on page 227). To config...

  • Page 109

    Chapter 5: using the web interface 94 enabling service advertisement the dominion px advertises all enabled services that are reachable using the ip network. This feature uses dns-sd (domain name system-service discovery) and mdns (multicast dns). The advertised services are discovered by clients th...

  • Page 110

    Chapter 5: using the web interface 95 3. If the daylight saving time applies to your time zone, verify the automatic daylight saving time adjustment checkbox is selected. If the daylight saving time rules are not available for the selected time zone, the checkbox is not configurable. 4. Choose one o...

  • Page 111

    Chapter 5: using the web interface 96 how to use the calendar the calendar icon next to the date field is a convenient tool to quickly change the year, month and date. To select a date using the calendar: 1. To change the year shown in the calendar, do either of the following:  press ctrl+up arrow ...

  • Page 112

    Chapter 5: using the web interface 97  click or on the top of the calendar to switch between months.  click , which is adjacent to the year, to show a list of years and months. Select the desired month from the list to the left and click ok. 3. To select a date, click that date on the calendar.  ...

  • Page 113

    Chapter 5: using the web interface 98 device type description asset strip raritan asset sensors. Power cim raritan power cim, d2cim-pwr. This cim is used to connect the dominion px to the raritan digital kvm switch, dominion kx ii. Lhx-20 schroff ® lhx-20 heat exchanger. This device type is availabl...

  • Page 114

    Chapter 5: using the web interface 99 note: the pdu folder is named "my px" by default. The name changes after customizing the device name. See naming the pdu (on page 83). 2. Click setup in the settings section. The pdu setup dialog appears. 3. Type an integer number in the altitude field. Dependin...

  • Page 115

    Chapter 5: using the web interface 100 2. To enable the data logging feature, select the "enable" checkbox in the enable data logging field. 3. Type a number in the measurements per log entry field. Valid range is from 1 to 600. The default is 60. 4. Verify that all sensor logging is enabled. If not...

  • Page 116

    Chapter 5: using the web interface 101 a. Type the recipient's email address in the recipient email addresses field. Use a comma to separate multiple email addresses. B. Click send test email. 9. Click ok to save the changes. 10. Check if the recipient(s) receives the email successfully. Setting the...

  • Page 117

    Chapter 5: using the web interface 102 rebooting the dominion px device you can remotely reboot the dominion px device via the web interface. To reboot the device: 1. Choose maintenance > unit reset. The reset device dialog appears. 2. Click yes to reset the dominion px. 3. A message appears with a ...

  • Page 118

    Chapter 5: using the web interface 103 2. Click new. The create new user dialog appears. 3. Type the information about the user in the corresponding fields. Note that user name, password and confirm password fields are required. Field type this... User name the name the user enters to log in to the ...

  • Page 119

    Chapter 5: using the web interface 104 field description security level click the drop-down arrow to select a preferred security level from the list:  noauthnopriv: no authentication and no privacy.  authnopriv: authentication and no privacy.  authpriv: authentication and privacy. This is the def...

  • Page 120

    Chapter 5: using the web interface 105 field description privacy protocol click the drop-down arrow and select the desired privacy protocol from the list. Two protocols are available:  des (default)  aes-128 7. Click the ssh tab to enter the public key if the public key authentication for the ssh ...

  • Page 121

    Chapter 5: using the web interface 106 11. Click ok to save the changes. Modifying a user profile you can change any user profile's information except for the user name. To modify a user profile: 1. Choose user management > users. The manage users dialog appears. 2. Select the user by clicking it. 3...

  • Page 122

    Chapter 5: using the web interface 107 4. A message appears, prompting you to confirm the operation. Click yes to confirm the deletion. Changing the user list view you may change the number of displayed columns or re-sort the list for better viewing the data. See changing the view of a list (on page...

  • Page 123

    Chapter 5: using the web interface 108 5. Click the privileges tab to assign one or multiple permissions. A. Click add. The "add privileges to new role" dialog appears. B. Select the permission you want from the privileges list. C. If the permission you selected contains any argument setting, the ar...

  • Page 124

    Chapter 5: using the web interface 109 7. To add any permissions, do this: a. Click add. The add privileges to role 'xxx' dialog appears, where xxx is the role name. B. Select the permission you want from the privileges list. C. If the permission you selected contains any argument setting, the argum...

  • Page 125

    Chapter 5: using the web interface 110 changing the role list view you may change the number of displayed columns or re-sort the list for better viewing the data. See changing the view of a list (on page 78). Access security control the dominion px provides tools to control access. You can require h...

  • Page 126

    Chapter 5: using the web interface 111 2. Set the default policy. See changing the default policy (on page 111). 3. Create firewall rules specifying which addresses to accept and which ones to discard. See creating firewall rules (on page 112). Changes made to firewall rules take effect immediately....

  • Page 127

    Chapter 5: using the web interface 112  accept: accepts traffic from all ipv4 addresses.  drop: discards traffic from all ipv4 addresses, without sending any failure notification to the source host.  reject: discards traffic from all ipv4 addresses, and an icmp message is sent to the source host ...

  • Page 128

    Chapter 5: using the web interface 113 to create firewall rules: 1. Choose device settings > security > ip access control. The configure ip access control settings dialog appears. 2. Click the ipv4 tab for creating firewall rules, or click the ipv6 tab for creating ipv6 firewall rules. 3. Ensure the...

  • Page 129

    Chapter 5: using the web interface 114 5. When finished, the rules appear in the configure ip access control settings dialog. 6. Click ok to save the changes. The rules are applied. Editing firewall rules when an existing firewall rule requires updates of ip address range and/or policy, modify them ...

  • Page 130

    Chapter 5: using the web interface 115 8. Click ok to quit the configure ip access control settings dialog, or the changes are lost. Sorting firewall rules the rule order determines which one of the rules matching the same ip address is performed. To sort the firewall rules: 1. Choose device setting...

  • Page 131

    Chapter 5: using the web interface 116 setting up user login controls you can set up login controls to make it more difficult for hackers to access the dominion px and the devices connected to it. You can arrange to lock persons out after a specified number of failed logins, limit the number of pers...

  • Page 132

    Chapter 5: using the web interface 117 enabling login limitations login limitations determine whether more than one person can use the same login name at the same time, and how long users are permitted to stay idle before being forced to log out. To enable login limitations: 1. Choose device setting...

  • Page 133

    Chapter 5: using the web interface 118 minimum length = 8 characters maximum length = 32 characters at least one lowercase character = required at least one uppercase character = required at least one numeric character = required at least one special character = required number of restricted passwor...

  • Page 134

    Chapter 5: using the web interface 119 2. Set the default policy. See changing the default policy (on page 119). 3. Create rules specifying which addresses to accept and which ones to discard when the addresses are associated with a specific role. See creating role-based access control rules (on pag...

  • Page 135

    Chapter 5: using the web interface 120 c. Select the action you want from the default policy drop-down list.  allow: accepts traffic from all ipv6 addresses regardless of the user's role.  deny: drops traffic from all ipv6 addresses regardless of the user's role. 4. Click ok to save the changes. C...

  • Page 136

    Chapter 5: using the web interface 121 action do this... Insert a rule between two existing rules  select the rule above which you want to insert a new rule. For example, to insert a rule between rules #3 and #4, select #4.  click insert. The "insert new rule" dialog appears.  type a starting ip ...

  • Page 137

    Chapter 5: using the web interface 122 sorting role-based access control rules similar to firewall rules, the order of role-based access control rules determines which one of the rules matching the same ip address is performed. To sort role-based access control rules: 1. Choose device settings > sec...

  • Page 138

    Chapter 5: using the web interface 123 setting up an ssl certificate having an x.509 digital certificate ensures that both parties in an ssl connection are who they say they are. To obtain a certificate for the dominion px, create a certificate signing request (csr) and submit it to a certificate au...

  • Page 139

    Chapter 5: using the web interface 124 field type this information common name the fully qualified domain name (fqdn) of your dominion px device. Email address an email address where you or another administrative user can be reached. Note: all fields in the subject section are mandatory, except for ...

  • Page 140

    Chapter 5: using the web interface 125 installing a ca-signed certificate after the ca provides a signed certificate according to the csr you submitted, you must install it on the dominion px device. To install the certificate: 1. Choose device settings > security > ssl certificate. The manage ssl c...

  • Page 141

    Chapter 5: using the web interface 126 field type this information key length select the key length (bits) from the drop-down list in this field. A larger key length enhances the security, but slows down the dominion px device's response. Self sign ensure this checkbox is selected, which indicates t...

  • Page 142

    Chapter 5: using the web interface 127 3. Select the "upload key and certificate" checkbox. The key file and certificate file fields appear. 4. In the key file field, click browse to select the private key file. 5. In the certificate file field, click browse to select the certificate file. 6. Click ...

  • Page 143

    Chapter 5: using the web interface 128 setting up ldap authentication for security purposes, users attempting to log in to the dominion px must be authenticated. The dominion px supports the access using one of the following authentication mechanisms: local database of user profiles on the dominion ...

  • Page 144

    Chapter 5: using the web interface 129  if using a microsoft active directory server, consult your ad administrator for the name of the active directory domain. Bind distinguished name (dn) and password (if anonymous bind is not used) the base dn of the server (used for searching for users) the log...

  • Page 145

    Chapter 5: using the web interface 130 8. Ssl port - the default is 636. Either use the default port or specify another port. This field is enabled when the "ldap over ssl" checkbox is selected. 9. Use only trusted ldap server certificates - select this checkbox if you would like to use a trusted ld...

  • Page 146

    Chapter 5: using the web interface 131  user entry object class  user search subfilter (also called basesearch) note: the dominion px will preoccupy the login name attribute and user entry object class with default values, which should not be changed unless required. 17. Active directory domain - ...

  • Page 147

    Chapter 5: using the web interface 132 2. Select the ldap/ldaps server whose priority you want to change. 3. Click "move up" or "move down" until the selected server reaches the desired position in the list. 4. Click ok to save the changes. Testing the ldap server connection you can test the connect...

  • Page 148

    Chapter 5: using the web interface 133 4. A message appears, prompting you to confirm the operation. Click yes to confirm the deletion. 5. Click ok to save the changes. Disabling the ldap authentication when the remote authentication service is disabled, the dominion px authenticates users against t...

  • Page 149

    Chapter 5: using the web interface 134 naming outlets you can give each outlet a unique name up to 32 characters long to identify the equipment connected to it. The customized name is followed by the label in parentheses. Note: in this context, the label refers to the outlet number, such as 1, 2, 3 ...

  • Page 150

    Chapter 5: using the web interface 135 all outlets are listed with associated circuit breakers shown in the overcurrent protector column. Outlet switching this section only applies to outlet-switching capable pdus. You can change the power status of one or multiple outlets with one click in the web ...

  • Page 151

    Chapter 5: using the web interface 136  to select multiple outlets, select the checkbox of each desired outlet one by one.  to select a single outlet, select that outlet's checkbox. 4. Click on, off, or cycle. 5. A dialog for confirming the operation appears. Click yes and all outlets switch on, o...

  • Page 152

    Chapter 5: using the web interface 137 note: the pdu folder is named "my px" by default. The name changes after customizing the device name. See naming the pdu (on page 83). 2. Click the outlets folder, and the outlets page opens in the right pane. 3. Click the outlet you want in the right pane, and...

  • Page 153

    Chapter 5: using the web interface 138  last known: restores all outlets to their previous power states before the dominion px device was powered off. 4. Click ok to save the changes. Setting the outlet-specific default state this section only applies to outlet-switching capable pdus. By default, t...

  • Page 154

    Chapter 5: using the web interface 139 changing the cycling power-off period this section only applies to outlet-switching capable pdus. Power cycling the outlet(s) turns the outlet(s) off and then back on. You can adjust the length of the time it takes for the outlets to turn back on after they are...

  • Page 155

    Chapter 5: using the web interface 140 tip: when there are a large number of outlets, set the value to a lower number so that you can avoid a long wait before all the outlets are available again. Changing the outlet-specific cycling power-off period this section only applies to outlet-switching capa...

  • Page 156

    Chapter 5: using the web interface 141 setting the initialization delay this section only applies to outlet-switching capable pdus. The outlet initialization delay determines how long the dominion px device waits before providing power to all outlets during power cycling or after recovering from a t...

  • Page 157

    Chapter 5: using the web interface 142 setting the inrush guard delay this section only applies to outlet-switching capable pdus. When electrical devices are turned on, they can initially draw a very large current known as inrush current. Inrush current typically lasts for 20-40 milliseconds. The in...

  • Page 158

    Chapter 5: using the web interface 143  click the pdu folder, and then the setup button in the outlet sequence section. Note: the pdu folder is named "my px" by default. The name changes after customizing the device name. See naming the pdu (on page 83). The outlet sequence setup dialog appears, wi...

  • Page 159

    Chapter 5: using the web interface 144  click the pdu folder, and then the setup button in the outlet sequence section. 2. Click the delay column of the outlet where a delay is intended after this outlet is turned on, delete the existing value and type a new number in seconds. The number can be a d...

  • Page 160

    Chapter 5: using the web interface 145 3. To mark an outlet as "non-critical," select it from the list in the "critical outlets" pane, and click to move it into the "non-critical outlets" pane. To make multiple selections, press ctrl+click or shift+click to highlight multiple ones. 4. To mark an out...

  • Page 161

    Chapter 5: using the web interface 146 activating or deactivating the load shedding mode this section only applies to outlet-switching capable pdus. When entering the load shedding mode, dominion px turns off all non-critical outlets. When exiting from the load shedding mode, dominion px turns on al...

  • Page 162

    Chapter 5: using the web interface 147 note: during the load shedding mode, this icon appears on all non-critical outlets on the outlets page, and you cannot turn on any of them. Inlet and circuit breaker management you can name each inlet and circuit breaker or monitor their status. Naming the inle...

  • Page 163

    Chapter 5: using the web interface 148 tip: this dialog can be also triggered by clicking setup on the overcurrent protectors page when the overcurrent protectors folder is selected in the dominion px explorer pane. 4. Type a new name in the name field. 5. Click ok to save the changes. Monitoring th...

  • Page 164

    Chapter 5: using the web interface 149 monitoring circuit breakers each circuit breaker on the dominion px device delivers power to a bank of outlets, and draws power from one or two lines. You can view the circuit breaker's details, including its:  label (number)  name  status (closed/open)  li...

  • Page 165

    Chapter 5: using the web interface 150 setting power thresholds setting and enabling the thresholds causes the dominion px to generate alert notifications when it detects that any component's power state crosses the thresholds. There are four thresholds for each sensor: lower critical, lower warning...

  • Page 166

    Chapter 5: using the web interface 151  to enable any threshold, select the corresponding checkbox. To disable a threshold, deselect the checkbox.  after any threshold is enabled, type an appropriate numeric value in the accompanying text box. 7. To enable the deassertion hysteresis for all thresh...

  • Page 167

    Chapter 5: using the web interface 152  after any threshold is enabled, type an appropriate numeric value in the accompanying text box. 7. To enable the deassertion hysteresis for all thresholds, type a numeric value other than zero in the deassertion hysteresis field. See what is deassertion hyste...

  • Page 168

    Chapter 5: using the web interface 153  to enable any threshold, select the corresponding checkbox. To disable a threshold, deselect the checkbox.  after any threshold is enabled, type an appropriate numeric value in the accompanying text box. 7. To enable the deassertion hysteresis for all thresh...

  • Page 169

    Chapter 5: using the web interface 154 example: when hysteresis is useful this example demonstrates when a deassertion hysteresis is useful. The current critical threshold for the inlet is set to 19 amps (a). The current draw rises to 20a, triggering a current critical alert. The current then contin...

  • Page 170

    Chapter 5: using the web interface 155 configuring event rules a benefit of the product's intelligence is its ability to notify you of and react to a change in conditions. This event notification or reaction is an "event rule." the dominion px is shipped with two built-in event rules, which cannot b...

  • Page 171

    Chapter 5: using the web interface 156 creating actions the dominion px comes with two built-in actions: system event log action: this action records the selected event in the internal log when the event occurs. System snmp trap action: this action sends snmp traps to one or multiple ip addresses af...

  • Page 172

    Chapter 5: using the web interface 157 option description send snapshots via smtp this option notifies one or multiple persons of the selected events by emailing the snapshots captured by a connected logitech ® quickcam ® pro 9000 webcam (if any).  in the "recipients email addresses" field, specify...

  • Page 173

    Chapter 5: using the web interface 158 option description send smtp message this option notifies one or multiple persons of the selected events by emailing a message.  in the "recipients email addresses" field, specify the email address(es) of the recipient(s). Use a comma to separate multiple emai...

  • Page 174

    Chapter 5: using the web interface 159 option description record snapshots to webcam storage this option starts or stops a specific webcam from taking snapshots when the event occurs.  in the webcam field, select the webcam that is intended to take snapshots when the event occurs.  in the action f...

  • Page 175

    Chapter 5: using the web interface 160 option description switch outlet this option turns on, off or power cycles a specific outlet.  in the operation field, select an operation for the selected outlet(s). Turn outlet on: turns on the selected outlet. Turn outlet off: turns off the selected outlet....

  • Page 176

    Chapter 5: using the web interface 161 3. Click new action. 4. In the "action name" field, type a new name for the action. The default name is new action , where is a sequential number. 5. In the action field, click the drop-down arrow, and select the desired action from the list. To create the acti...

  • Page 177

    Chapter 5: using the web interface 162 4. Select "send smtp message" from the actions drop-down in the action settings section of the dialog. 5. Select the use custom log message checkbox. 6. Build the message in the open text field that is provided by entering custom information. If needed, use pla...

  • Page 178

    Chapter 5: using the web interface 163 placeholder definition [lhxpowersupply id] the id of an lhx power supply [lhxsensorid] the id of an lhx sensor probe [state] the human readable state of an asset strip [value] the new value of a parameter [version] the firmware version the device is upgrading t...

  • Page 179

    Chapter 5: using the web interface 164 default log messages following are default log messages triggered and emailed to specified recipients when dominion px events occur (are true) or, in some cases, do not occur (are false). See creating actions (on page 156) for information configuring email mess...

  • Page 180

    Chapter 5: using the web interface 165 event/context default assertion message when the event = true default assertion message when the event = false* device > an ldap error occured an ldap error occured: [ldaperrordesc]. Device > usb slave connected usb slave connected. Usb slave disconnected. Devi...

  • Page 181

    Chapter 5: using the web interface 166 event/context default assertion message when the event = true default assertion message when the event = false* upper critical threshold '[inlet]' asserted 'above upper critical'. Critical'. Inlet > * > sensor > * > above upper warning threshold sensor '[inlets...

  • Page 182

    Chapter 5: using the web interface 167 event/context default assertion message when the event = true default assertion message when the event = false* outlet > * > sensor > * > above upper warning threshold sensor '[outletsensor]' on outlet '[outlet]' asserted 'above upper warning'. Sensor '[outlets...

  • Page 183

    Chapter 5: using the web interface 168 event/context default assertion message when the event = true default assertion message when the event = false* warning threshold 'below lower warning'. Deasserted 'below lower warning'. Overcurrent protector > * > sensor > * > below lower critical threshold se...

  • Page 184

    Chapter 5: using the web interface 169 event/context default assertion message when the event = true default assertion message when the event = false* server monitoring > * > unreachable server '[server]' is unreachable. Server '[server]' is reachable. Energywise > enabled user '[username]' from hos...

  • Page 185

    Chapter 5: using the web interface 170 event/context default assertion message when the event = true default assertion message when the event = false* lhx > sensor > unavailable sensor '[lhxsensorid]' on lhx at [porttype] port '[portid]' unavailable. Sensor '[lhxsensorid]' on lhx at [porttype] port ...

  • Page 186

    Chapter 5: using the web interface 171 event/context default assertion message when the event = true default assertion message when the event = false* power supply '[lhxpowersupplyid]'. Lhx > threshold air inlet the air inlet temperature threshold on lhx at [porttype] port '[portid]' was crossed. Th...

  • Page 187

    Chapter 5: using the web interface 172 5. Click event to select an event for which you want to trigger an action. A pull-down menu showing all types of events appears.  select the desired event type from the pull-down menu, and if a submenu appears, continue the navigation until the desired event i...

  • Page 188

    Chapter 5: using the web interface 173 event types radio buttons sensor availability available radio buttons include "unavailable," "available" and "both."  unavailable: the dominion px takes the action only when the chosen sensor is not detected and becomes unavailable.  available: the dominion p...

  • Page 189

    Chapter 5: using the web interface 174 event types radio buttons server monitoring event available radio buttons include "monitoring started," "monitoring stopped," and "both."  monitoring started: the dominion px takes the action only when the monitoring of any specified server starts.  monitorin...

  • Page 190

    Chapter 5: using the web interface 175 note: the outlet power state change events are available only for outlet-switching capable pdus. 7. In the actions field, click the drop-down arrow, select the desired action from the list, and click the add action button to add the action. The added action wil...

  • Page 191

    Chapter 5: using the web interface 176 sample outlet-level event rule in this example, we want dominion px to send snmp traps to the snmp manager both when any sensor reading of outlet 3 crosses any threshold and when it returns to normal. To do that we would set up an event rule like this: event: e...

  • Page 192

    Chapter 5: using the web interface 177 2. Select "inlet i1" from the submenu because that is the inlet in question. 3. Select "sensor" to refer to sensor readings. 4. Select "any sub-event" because we want to specify all events related to all types of inlet sensors and thresholds, such as current, v...

  • Page 193

    Chapter 5: using the web interface 178 after the new action for enabling the load shedding mode is created, you can create an event rule that can trigger the load shedding mode when the contact closure sensor enters the alarmed state. This sample event rule looks like this: event: events > external ...

  • Page 194

    Chapter 5: using the web interface 179 example 1 this example illustrates an event rule which continuously causes the pdu to send out smtp messages. Event selected action included device > sending smtp message failed send smtp message example 2 this example illustrates an event rule which continuous...

  • Page 195

    Chapter 5: using the web interface 180 2. On the rules tab, select the event rule that you want to modify in the left pane. 3. To disable the event rule, deselect the enabled checkbox. 4. To change the event, click the desired tab in the event field and select a different item from the pull-down men...

  • Page 196

    Chapter 5: using the web interface 181 note: if you do not click save before quitting the current settings page, a message appears. Then click yes to save the changes, discard to abort the changes or cancel to return to the current settings page. 6. Click close to quit the dialog. Deleting an event ...

  • Page 197

    Chapter 5: using the web interface 182 viewing the local event log you can view up to 2,000 historical events that occurred to the dominion px device in the local event log. When the log already contains 2,000 entries, each new entry overwrites the oldest entry. To display the local log: 1. Choose m...

  • Page 198

    Chapter 5: using the web interface 183 2. Click clear event log. 3. Click close to quit the dialog. Viewing connected users you can see which users are connected to the dominion px device and their status. If you have administrator privileges, you can terminate any user's connection to the dominion ...

  • Page 199

    Chapter 5: using the web interface 184 monitoring server accessibility you can monitor whether specific it devices are alive by having the dominion px device continuously ping them. An it device's successful response to the ping commands indicates that the it device is still alive and can be remotel...

  • Page 200

    Chapter 5: using the web interface 185 6. To add more it devices, repeat steps 2 to 5. 7. Click close to quit the dialog. Editing ping monitoring settings you can edit the ping monitoring settings for any it device whenever it requires changes. To modify the ping monitoring settings for an it device...

  • Page 201

    Chapter 5: using the web interface 186 : this icon denotes that the monitoring for the corresponding server is enabled. : this icon denotes that the monitoring for the corresponding server is disabled. 3. The column labeled "status" indicates the accessibility of each monitored server. Status descri...

  • Page 202

    Chapter 5: using the web interface 187 note: numeric sensors use numeric values to indicate the environmental or internal conditions while discrete (on/off) sensors use alphabetical characters to indicate the state. Only numeric sensors have the threshold settings. Identifying environmental sensors ...

  • Page 203

    Chapter 5: using the web interface 188 managing environmental sensors the dominion px starts to retrieve an environmental sensor's reading and/or state and records the state transitions after the environmental sensor is managed. The dominion px device can manage a maximum of 16 environmental sensors...

  • Page 204

    Chapter 5: using the web interface 189 tip: the information in parentheses following each id number indicates whether the number has been assigned to any sensor. If it has been assigned to a sensor, it shows that sensor's serial number. Otherwise, it shows the term "unused." 6. Click ok. The dominio...

  • Page 205

    Chapter 5: using the web interface 190  vibration: the detector/switch is designed to detect the vibration in the floor. 6. Type a new name in the name field. 7. Describe the sensor's location by assigning alphanumeric values to the x, y and z coordinates. See describing the sensor location (on pag...

  • Page 206

    Chapter 5: using the web interface 191 3. In the "external sensors z coordinate format" field, click the drop-down arrow and select an option from the list.  rack units: the height of the z coordinate is measured in standard rack units. When this is selected, you can type a numeric value in the rac...

  • Page 207

    Chapter 5: using the web interface 192 viewing sensor data readings of the environmental sensors will display in the web interface after these sensors are properly connected and managed. The dashboard page shows the information for managed environmental sensors only, while the external sensors page ...

  • Page 208

    Chapter 5: using the web interface 193  state  channel (for a contact closure sensor only) sensor measurement accuracy raritan environmental sensors are with the following factory specifications. Calibration is not required for environmental sensors. Temperature: +/-2% humidity: +/-5% differential...

  • Page 209

    Chapter 5: using the web interface 194 "unavailable" state the unavailable state means the connectivity to the sensor is lost. The dominion px pings all managed sensors at regular intervals in seconds. If it does not detect a particular sensor for three consecutive scans, the unavailable state is di...

  • Page 210

    Chapter 5: using the web interface 195 tip: a contact closure sensor's led is lit after entering the alarmed state. If the sensor module has two channels for connecting two switches, two leds are available. Check which contact closure switch is in the "abnormal" status according to the channel numbe...

  • Page 211

    Chapter 5: using the web interface 196 2. Click external sensors in the dominion px explorer pane, and the external sensors page opens in the right pane. 3. Click the sensor you want to unmanage on the external sensors page. 4. Click release. After a sensor is removed from management, the id number ...

  • Page 212

    Chapter 5: using the web interface 197 5. Type the total number of rack units the selected asset sensor has in the "number of rack units" field. This field shows 48 by default. 6. Determine how to number all rack units on the asset sensor by selecting an option in the numbering mode.  top-down: the...

  • Page 213

    Chapter 5: using the web interface 198 4. Click setup on the asset sensor page. The setup dialog for that asset sensor appears. 5. To change the led color denoting the presence of a connected tag, either click a color in the color palette or type the hexadecimal rgb value of the color in the "color ...

  • Page 214

    Chapter 5: using the web interface 199  led mode: select on to have the led stay lit, off to have it stay off, "slow blinking" to have it blink slowly, or "fast blinking" to have it blink quickly.  led color: if you select on, "slow blinking" or "fast blinking" in the led mode field, select an led...

  • Page 215

    Chapter 5: using the web interface 200 3. Double-click that rack unit or click the white arrow prior to the folder icon. The arrow then turns into a black, gradient arrow , and all tag ports appear below the folder. To collapse a blade extension strip:  double-click the blade extension strip folder...

  • Page 216

    Chapter 5: using the web interface 201 4. Click extended device info, where the asset sensor data is displayed. 5. Click close to quit the dialog. Copying configurations with bulk configuration the bulk configuration feature lets you save the settings of a configured dominion px device to your pc. Y...

  • Page 217

    Chapter 5: using the web interface 202 saving a dominion px configuration a source device is an already configured dominion px device that is used to create a configuration file containing the settings that can be shared between dominion px devices. These settings include user and role configuration...

  • Page 218

    Chapter 5: using the web interface 203 copying a dominion px configuration a target device is an dominion px device that loads another dominion px device's configuration file. Copying an dominion px configuration to a target device adjusts that dominion px device's settings to match those of the sou...

  • Page 219

    Chapter 5: using the web interface 204  length or height: feet (ft)  air pressure: psi determine the desired measurement unit when creating user profiles. See creating a user profile (on page 102). To change the measurement unit setting, you must have the administrator privileges. To set the prefe...

  • Page 220

    Chapter 5: using the web interface 205 managing the webcam images or videos if you connect a logitech ® quickcam ® pro 9000 webcam to the dominion px device, you can visually monitor the environment close to the dominion px. See connecting a logitech webcam (optional) (on page 48). Snapshots or vide...

  • Page 221

    Chapter 5: using the web interface 206 2. Double-click on the webcam you want to edit. The webcam image or video opens in a new tab. 3. Click setup. 4. Edit the information as needed. Changes to the resolution do not apply to existing, stored images - it applies only to images and videos taken after...

  • Page 222

    Chapter 5: using the web interface 207  to change the image resolution, click setup. Select a different resolution from the resolution drop-down list. The image is updated with the latest snapshot while the resolution changes.  to take a snapshot of the image, click the store snapshot to webcam st...

  • Page 223

    Chapter 5: using the web interface 208 the snapshot or video remains open in a secondary live preview window in the user a's dominion px interface. So long as the secondary live preview window is open in user a's interface, even after user a logs out of the dominion px interface or the session times...

  • Page 224

    Chapter 5: using the web interface 209 saving snapshots if it is intended to keep the currently-displayed webcam snapshot, you can manually save it onto the dominion px. Warning: the stored snapshots are lost when you reset the dominion px so make sure it is fine to clear up the snapshot history bef...

  • Page 225

    Chapter 5: using the web interface 210 network diagnostics the dominion px provides the following tools in the web interface for diagnosing potential networking issues. Ping trace route list tcp connections tip: these network diagnostic tools are also available through cli. See network troubleshooti...

  • Page 226

    Chapter 5: using the web interface 211 listing tcp connections you can use the "list tcp connections" to display a list of tcp connections. To trace the route for a host: 1. Choose maintenance > network diagnostics > list tcp connections. The tcp connections dialog appears. 2. Click close to quit th...

  • Page 227

    Chapter 5: using the web interface 212 downloading diagnostic information important: this function is for use by raritan field engineers or when you are directed by raritan technical support. You can download the diagnostic file from the dominion px device to a client machine. The file is compressed...

  • Page 228

    Chapter 5: using the web interface 213 2. Enable the support of lhx heat exchanger on the dominion px. See enabling the lhx support (on page 213). 3. Configure the connected heat exchanger. See configuring the lhx device (on page 213). 4. Now you can remotely monitor or control the connected lhx hea...

  • Page 229

    Chapter 5: using the web interface 214 correctly displaying the lhx device there are two ways to have the dominion px show the correct lhx model in the web interface. Auto detection: set the mode of the feature port to auto to let the dominion px automatically detects the device type. Manual assignm...

  • Page 230

    Chapter 5: using the web interface 215 configuring temperature and fan thresholds an lhx heat exchanger is implemented with various sensors for detecting the air temperature, water temperature, and fan speed. You can set thresholds for these sensors so that the dominion px alerts you when any sensor...

  • Page 231

    Chapter 5: using the web interface 216 viewing the summary both the dashboard and feature port page display the summary of the connected lhx heat exchangers, including the heat exchanger's name and status, if the lhx device is detected or manually assigned to the feature port. If the lhx heat exchan...

  • Page 232

    Chapter 5: using the web interface 217 if any lhx sensor reading reaches or crosses the critical or warning threshold, that sensor reading row is highlighted in red or yellow. See the yellow- or red-highlighted reading (on page 76). Alert states and lhx event log when an lhx heat exchanger is physic...

  • Page 233

    Chapter 5: using the web interface 218 device states and icon variations the dominion px web interface changes icons to represent different statuses of the connected lhx heat exchanger. Icons device status the heat exchanger is turned on and operating normally. The heat exchanger is turned off. The ...

  • Page 234

    Chapter 5: using the web interface 219 firmware upgrade you may upgrade your dominion px device to benefit from the latest enhancements, improvements and features. The dominion px firmware files are available on the raritan website's firmware and documentation section ( http://www.Raritan.Com/suppor...

  • Page 235

    Chapter 5: using the web interface 220  in the web interface, all logged-in users see the dominion px time out message, and the "disconnected" state is shown in the status bar.  the user management operation, if any, is forced to suspend. 7. When the update is complete, a message appears, indicati...

  • Page 236

    Chapter 5: using the web interface 221 viewing firmware update history the firmware upgrade history, if available, is permanently stored on the dominion px device. This history indicates when a firmware upgrade event occurred, the prior and new versions associated with the firmware upgrade event, an...

  • Page 237

    Chapter 5: using the web interface 222 updating the asset sensor firmware after connecting the asset sensor to the dominion px device, it automatically checks its own firmware version against the version of the asset sensor firmware stored in the dominion px firmware. If two versions are different, ...

  • Page 238

    Chapter 5: using the web interface 223 2. To view the content of any topic, click the topic in the left pane. Then its content is displayed in the right pane. 3. To select a different topic, do any of the following:  to view the next topic, click the next icon in the toolbar.  to view the previous...

  • Page 239: Chapter 6

    224 this snmp section helps you set up the dominion px for use with an snmp manager. The dominion px can be configured to send traps to an snmp manager, as well as receive get and set commands in order to retrieve status and configure some basic settings. In this chapter enabling snmp .................

  • Page 240

    Chapter 6: using snmp 225  type the read/write community string in the write community string field. Usually the string is "private." 3. Select the "enable" checkbox in the "snmp v3" field to enable communication with an snmp manager using snmp v3 protocol. Tip: you can permit or disallow a user to...

  • Page 241

    Chapter 6: using snmp 226 configuring snmp traps the dominion px automatically keeps an internal log of events that occur. See configuring event rules (on page 155). These events can also be used to send snmp traps to a third party manager. To configure the dominion px to send snmp traps: 1. Choose ...

  • Page 242

    Chapter 6: using snmp 227 snmp gets and sets in addition to sending traps, the dominion px is able to receive snmp get and set requests from third-party snmp managers. Get requests are used to retrieve information about the dominion px, such as the system location, and the current on a specific outl...

  • Page 243

    Chapter 6: using snmp 228  pdu2-mib: the snmp mib file for dominion px's power management.  assetmanagement-mib: the snmp mib file for asset management. The "usb console inf file" link lets you download the usb-to-serial driver that may be required only when the pdu is connected to a computer via ...

  • Page 244

    Chapter 6: using snmp 229 snmp sets and thresholds some objects can be configured from the snmp manager using snmp set commands. Objects that can be configured have a max-access level of "read-write" in the mib. These objects include threshold objects, which causes the dominion px to generate a warn...

  • Page 245: Chapter 7

    230 this section explains how to use the command line interface (cli) to administer a dominion px device. In this chapter about the interface ................................................................................230 logging in to cli ...........................................................

  • Page 246

    Chapter 7: using the command line interface 231 with hyperterminal you can use any terminal emulation programs for local access to the command line interface. This section illustrates hyperterminal, which is part of windows operating systems prior to windows vista. To log in using hyperterminal: 1. ...

  • Page 247

    Chapter 7: using the command line interface 232 6. You are now logged in to the command line interface and can begin administering the dominion px device. With ssh or telnet you can remotely log in to the command line interface using an ssh or telnet client, such as putty. Note: putty is a free prog...

  • Page 248

    Chapter 7: using the command line interface 233 different cli modes and prompts depending on the login name you use and the mode you enter, the system prompt in the cli varies. User mode: when you log in as a normal user, who does not have full permissions to configure the dominion px device, the > ...

  • Page 249

    Chapter 7: using the command line interface 234 showing information you can use the show commands to view current settings or status of the dominion px device or part of it, such as the ip address, networking mode, firmware version, circuit breaker state, inlet ratings, and so on. Some "show" comman...

  • Page 250

    Chapter 7: using the command line interface 235 lan interface settings this command shows the lan interface information only, such as lan interface speed, duplex mode, and current lan interface status. # show network interface networking mode this command shows whether the current networking mode is...

  • Page 251

    Chapter 7: using the command line interface 236 network service settings this command shows the network service settings only, including the telnet setting, tcp ports for http, https and ssh services, and snmp settings. # show network services variables: is one of the options: all, http, https, teln...

  • Page 252

    Chapter 7: using the command line interface 237 outlet information this command syntax shows the outlet information. # show outlets to show detailed information, add the parameter "details" to the end of the command. # show outlets details variables: is one of the options: all, or a number. Option d...

  • Page 253

    Chapter 7: using the command line interface 238 inlet information this command syntax shows the inlet information. # show inlets to show detailed information, add the parameter "details" to the end of the command. # show inlets details variables: is one of the options: all, or a number. Option descr...

  • Page 254

    Chapter 7: using the command line interface 239 circuit breaker information this command is only available for pdus with overcurrent protection mechanism implemented. This command syntax shows the circuit breaker information. # show ocp to show detailed information, add the parameter "details" to th...

  • Page 255

    Chapter 7: using the command line interface 240 environmental sensor information this command syntax shows the environmental sensor's information. # show externalsensors to show detailed information, add the parameter "details" to the end of the command. # show externalsensors details variables: is ...

  • Page 256

    Chapter 7: using the command line interface 241 inlet sensor threshold information this command syntax shows the specified inlet sensor's threshold-related information. # show sensor inlet to show detailed information, add the parameter "details" to the end of the command. # show sensor inlet detail...

  • Page 257

    Chapter 7: using the command line interface 242 inlet pole sensor threshold information this command is only available for a three-phase pdu except for an inline monitor (px2-3000 series). This command syntax shows the specified inlet pole sensor's threshold-related information. # show sensor inletp...

  • Page 258

    Chapter 7: using the command line interface 243 displayed information: without the parameter "details," only the reading, state, threshold, deassertion hysteresis and assertion timeout settings of the specified inlet pole sensor are displayed. With the parameter "details," more sensor information is...

  • Page 259

    Chapter 7: using the command line interface 244 environmental sensor threshold information this command syntax shows the specified environmental sensor's threshold-related information. # show sensor externalsensor to show detailed information, add the parameter "details" to the end of the command. #...

  • Page 260

    Chapter 7: using the command line interface 245 security settings this command shows the security settings of the dominion px. # show security to show detailed information, add the parameter "details" to the end of the command. # show security details displayed information: without the parameter "de...

  • Page 261

    Chapter 7: using the command line interface 246 without the parameter "details," only four pieces of user information are displayed: user name, "enabled" status, snmp v3 access privilege, and role(s). With the parameter "details," more user information is displayed, such as the telephone number, e-m...

  • Page 262

    Chapter 7: using the command line interface 247 load shedding settings this section only applies to outlet-switching capable pdus. This command shows the load shedding settings. # show loadshedding displayed information: the load shedding state is displayed along with non-critical outlets. Note: the...

  • Page 263

    Chapter 7: using the command line interface 248 asset sensor settings this command shows the asset sensor settings, such as the total number of rack units (tag ports), asset sensor state, numbering mode, orientation, available tags and led color settings. # show assetstrip variables: is one of the o...

  • Page 264

    Chapter 7: using the command line interface 249 rack unit settings of an asset sensor for the raritan asset sensor, a rack unit refers to a tag port. This command shows the settings of a specific rack unit or all rack units on an asset sensor, such as a rack unit's led color and led mode. # show rac...

  • Page 265

    Chapter 7: using the command line interface 250 blade extension strip settings this command shows the information of a blade extension strip, including the total number of tag ports, and if available, the id (barcode) number of any connected tag. # show bladeslot variables: is the number of the feat...

  • Page 266

    Chapter 7: using the command line interface 251 reliability error log this command shows the reliability error log. # show reliability errorlog variables: is one of the options: 0 (zero) or any other integer number. Option description 0 displays all entries in the reliability error log. Tip: you can...

  • Page 267

    Chapter 7: using the command line interface 252 example 1 - basic security information the diagram shows the output of the show security command. Example 2 - in-depth security information more information is displayed when typing the show security details command. Example 3 - basic pdu information t...

  • Page 268

    Chapter 7: using the command line interface 253 example 4 - in-depth pdu information more information is displayed when typing the show pdu details command. Configuring the dominion px device and network to configure the dominion px device or network settings through the cli, you must log in as the ...

  • Page 269

    Chapter 7: using the command line interface 254 important: to apply new configuration settings, you must issue the "apply" command before closing the terminal emulation program. Closing the program does not save any configuration changes. See quitting the configuration mode (on page 374). Pdu config...

  • Page 270

    Chapter 7: using the command line interface 255 setting the outlet power-on sequence this section only applies to outlet-switching capable pdus. This command syntax sets the outlet power-on sequence when the pdu powers up. Config:# pdu outletsequence variables: is one of the options: default, or a c...

  • Page 271

    Chapter 7: using the command line interface 256 config:# pdu outletsequencedelay :;:; :;... Separate outlet numbers and their delay settings with a colon. Outlets followed by delays are separated with a semicolon. Variables: , , and the like are individual outlet numbers or a range of outlets. , , a...

  • Page 272

    Chapter 7: using the command line interface 257 option description lastknownstate restores all outlets to the previous status before powering down the dominion px device when the pdu powers up again. Example the following command causes all outlets to return to the last power state before powering d...

  • Page 273

    Chapter 7: using the command line interface 258 setting the inrush guard delay time this section only applies to outlet-switching capable pdus. This command syntax sets the inrush guard delay. Config:# pdu inrushguarddelay variables: is a delay time between 100 and 100000 milliseconds. Example the f...

  • Page 274

    Chapter 7: using the command line interface 259 specifying non-critical outlets this section only applies to outlet-switching capable pdus. This command syntax determines critical and non-critical outlets. It is associated with the load shedding mode. See setting non-critical outlets and load sheddi...

  • Page 275

    Chapter 7: using the command line interface 260 for more information, see setting data logging (on page 99). Example the following command enables the data logging feature. Config:# pdu dataretrieval enable setting the data logging measurements per entry this command syntax defines the number of mea...

  • Page 276

    Chapter 7: using the command line interface 261 example the following command determines that the dominion px device is located at 1500 meters above sea level. Config:# pdu devicealtitude 1500 setting the z coordinate format for environmental sensors this command syntax enables or disables the use o...

  • Page 277

    Chapter 7: using the command line interface 262 changing the led display orientation this command syntax determines the orientation of the value shown on the led display of a zero u pdu. Config:# pdu displayorientation variables: is one of the options: automatic, flipped or normal. Option descriptio...

  • Page 278

    Chapter 7: using the command line interface 263 setting the networking mode if your dominion px device is implemented with both of the wired and wireless networking mechanisms, you must determine which mechanism is enabled for network connectivity before further configuring networking parameters. Th...

  • Page 279

    Chapter 7: using the command line interface 264 enabling ipv4 or ipv6 this command syntax determines which ip protocol is enabled on the dominion px. Config:# network ip proto variables: is one of the options: v4only, v6only or both. Mode description v4only enables ipv4 only on all interfaces. This ...

  • Page 280

    Chapter 7: using the command line interface 265 example the following command determines that only ipv4 addresses returned by the dns server are used. Config:# network ip dnsresolverpreference preferv4 setting the wireless parameters you must configure wireless parameters, including service set iden...

  • Page 281

    Chapter 7: using the command line interface 266 setting the authentication method this command syntax sets the wireless authentication method to either psk or extensible authentication protocol (eap). Config:# network wireless authmethod variables: is one of the authentication methods: psk or eap. M...

  • Page 282

    Chapter 7: using the command line interface 267 setting the eap parameters when the wireless authentication method is set to eap, you must configure eap authentication parameters, including outer authentication, inner authentication, eap identity, password, and ca certificate. Setting the outer auth...

  • Page 283

    Chapter 7: using the command line interface 268 setting the eap identity this command syntax determines the eap identity. Config:# network wireless eapidentity variables: is your user name for the eap authentication. Example the following command sets the eap identity to "eap_user01." config:# netwo...

  • Page 284

    Chapter 7: using the command line interface 269 d. Press enter. Tip: to remove an existing ca certificate, simply press enter without typing or pasting anything when the system prompts you to input the certificate contents. 3. If the certificate is valid, the system shows the command prompt "config:...

  • Page 285

    Chapter 7: using the command line interface 270 miicjtccafigawibagiemaygrzalbgkqhkig9w0baqqwrtelmak ga1uebhmcvvmxnja0bgnvbaotlu5hdglvbmfsieflcm9uyxv0aw nzigfuzcbtcgfjzsbbzg1pbmlzdhjhdglvbjamfxe5nja1mjgxm zq5mdurmdgwmbcrotgwnti4mtm0ota1kza4mdawzzelmakga1ue bhmcvvmxnja0bgnvbaotlu5hdglvbmfsieflcm9uyxv0...

  • Page 286

    Chapter 7: using the command line interface 271 configuring the ipv4 parameters an ipv4 configuration command begins with network ipv4. The commands are case sensitive so ensure you capitalize them correctly. Setting the ipv4 configuration mode this command syntax determines the ip configuration mod...

  • Page 287

    Chapter 7: using the command line interface 272 example the following command sets the preferred host name to "my-host." config:# network ipv4 preferredhostname my-host setting the ipv4 address after selecting the static ip configuration mode, you can use this command syntax to assign a permanent ip...

  • Page 288

    Chapter 7: using the command line interface 273 setting the ipv4 gateway after selecting the static ip configuration mode, you can use this command syntax to specify the gateway. Config:# network ipv4 gateway variables: is the ip address of the gateway. The value ranges from 0.0.0.0 to 255.255.255.2...

  • Page 289

    Chapter 7: using the command line interface 274 setting the ipv4 secondary dns server after selecting the static ip configuration mode, you can use this command syntax to specify the secondary dns server. Config:# network ipv4 secondarydnsserver variables: is the ip address of the secondary dns serv...

  • Page 290

    Chapter 7: using the command line interface 275 example the following command overrides the dhcp-assigned dns server with the one you specified. Config:# network ipv4 overridedns enable configuring the ipv6 parameters an ipv6 configuration command begins with network ipv6. The commands are case sens...

  • Page 291

    Chapter 7: using the command line interface 276 setting the ipv6 address after selecting the static ip configuration mode, you can use this command syntax to assign a permanent ip address to the dominion px device. Config:# network ipv6 ipaddress variables: is the ip address being assigned to your d...

  • Page 292

    Chapter 7: using the command line interface 277 setting the ipv6 primary dns server after selecting the static ip configuration mode, you can use this command syntax to specify the primary dns server. It is required to enable overriding the auto-assigned dns server before you can specify the dns ser...

  • Page 293

    Chapter 7: using the command line interface 278 overriding the ipv6 dhcp-assigned dns server after specifying the primary/secondary dns server, you can use this command to override the dhcp-assigned dns server with the one you specified. Config:# network ipv6 overridedns variables: is one of the opt...

  • Page 294

    Chapter 7: using the command line interface 279 option description 10mbps the lan speed is always 10 mbps. 100mbps the lan speed is always 100 mbps. Example the following command lets the dominion px determine the optimal lan interface speed through auto-negotiation. Config:# network interface lanin...

  • Page 295

    Chapter 7: using the command line interface 280 changing the http port this command syntax changes the http port. Config:# network services http variables: is a tcp port number between 1 and 65535. The default http port is 80. Example the following command sets the http port to 81. Config:# network ...

  • Page 296

    Chapter 7: using the command line interface 281 enabling or disabling telnet this command syntax enables or disables the telnet service. Config:# network services telnet enabled variables: is one of the options: true or false. Option description true the telnet service is enabled. False the telnet s...

  • Page 297

    Chapter 7: using the command line interface 282 enabling or disabling ssh this command syntax enables or disables the ssh service. Config:# network services ssh enabled variables: is one of the options: true or false. Option description true the ssh service is enabled. False the ssh service is disab...

  • Page 298

    Chapter 7: using the command line interface 283 enabling or disabling snmp v1/v2c this command syntax enables or disables the snmp v1/v2c protocol. Config:# network services snmp v1/v2c variables: is one of the options: enable or disable. Option description enable the snmp v1/v2c protocol is enabled...

  • Page 299

    Chapter 7: using the command line interface 284 setting the snmp read community this command syntax sets the snmp read-only community string. Config:# network services snmp readcommunity variables: is a string comprising 4 to 64 ascii printable characters. The string cannot include spaces. Example t...

  • Page 300

    Chapter 7: using the command line interface 285 example the following command sets the snmp mib-ii syscontact to "john_krause." config:# network services snmp syscontact john_krause setting the sysname value this command syntax sets the snmp sysname mib-ii value. Config:# network services snmp sysna...

  • Page 301

    Chapter 7: using the command line interface 286 enabling or disabling modbus this command syntax enables or disables the modbus protocol. Config:# network services modbus enabled variables: is one of the options: true or false. Option description true the modbus agent is enabled. False the modbus ag...

  • Page 302

    Chapter 7: using the command line interface 287 changing the modbus port this command syntax changes the modbus port. Config:# network services modbus port variables: is a tcp port number between 1 and 65535. The default modbus port is 502. Example this following command changes the modbus port. Con...

  • Page 303

    Chapter 7: using the command line interface 288 determining the time setup method this command syntax determines the method to configure the system date and time. Config:# time method variables: is one of the time setup options: manual or ntp. Mode description manual the date and time settings are c...

  • Page 304

    Chapter 7: using the command line interface 289 example the following command sets the primary time server to 192.168.80.66. Config:# time ntp firstserver 192.168.80.66 specifying the secondary ntp server this command syntax specifies the primary time server if synchronization with the ntp server is...

  • Page 305

    Chapter 7: using the command line interface 290 example the following command overrides the dhcp-specified ntp servers with the customized ntp servers, including the primary and secondary ntp servers. Config:# time ntp overridedhcpprovidedserver true security configuration commands a security config...

  • Page 306

    Chapter 7: using the command line interface 291 modifying the firewall control parameters there are different commands for modifying firewall control parameters. Ipv4 commands to enable or disable the ipv4 firewall control feature, use this command syntax: config:# security ipaccesscontrol ipv4 enab...

  • Page 307

    Chapter 7: using the command line interface 292 option description reject discards traffic from all ip addresses, and an icmp message is sent to the source host for failure notification. Tip: you can combine both commands to modify all firewall control parameters at a time. See multi-command syntax ...

  • Page 308

    Chapter 7: using the command line interface 293 config:# security ipaccesscontrol ipv4 rule add -- or -- config:# security ipaccesscontrol ipv4 rule add ipv6 commands to add a new rule to the bottom of the ipv6 rules list, use this command syntax: config:# security ipaccesscontrol ipv6 rule add to a...

  • Page 309

    Chapter 7: using the command line interface 294 is one of the options: insertabove or insertbelow. Option description insertabove inserts the new rule above the specified rule number. Then: new rule's number = the specified rule number insertbelow inserts the new rule below the specified rule number...

  • Page 310

    Chapter 7: using the command line interface 295 config:# security ipaccesscontrol ipv4 rule modify policy the command syntax to modify all contents of an existing ipv4 rule: config:# security ipaccesscontrol ipv4 rule modify ipmask policy ipv6 commands the command syntax to modify an ipv6 rule's ip ...

  • Page 311

    Chapter 7: using the command line interface 296 option description reject discards traffic from the specified ip address(es), and an icmp message is sent to the source host for failure notification. Example the following command modifies all contents of the 5th ipv4 rule. Config:# security ipaccessc...

  • Page 312

    Chapter 7: using the command line interface 297 https access this command determines whether the https access to the dominion px web interface is forced. If yes, all http access attempts are automatically directed to https. Config:# security enforcehttpsforwebaccess variables: is one of the options:...

  • Page 313

    Chapter 7: using the command line interface 298 single login limitation this command syntax enables or disables the single login feature, which controls whether multiple logins using the same login name simultaneously is permitted. Config:# security loginlimits singlelogin variables: is one of the o...

  • Page 314

    Chapter 7: using the command line interface 299 example the following command enables the password aging feature. Config:# security loginlimits passwordaging enable password aging interval this command syntax determines how often the password should be changed. Config:# security loginlimits password...

  • Page 315

    Chapter 7: using the command line interface 300 user blocking there are different commands for changing different user blocking parameters. These commands begin with security userblocking. To determine the maximum number of failed logins before blocking a user, use this command syntax: config:# secu...

  • Page 316

    Chapter 7: using the command line interface 301 strong passwords the strong password commands determine whether a strong password is required for login, and what a strong password should contain at least. A strong password command begins with security strongpasswords . You can combine multiple stron...

  • Page 317

    Chapter 7: using the command line interface 302 example this command syntax determines a password must comprise at least 8 characters. Config:# security strongpasswords minimumlength 8 maximum password length this command syntax determines the maximum length of the password. Config:# security strong...

  • Page 318

    Chapter 7: using the command line interface 303 uppercase character requirement this command syntax determines whether a strong password includes at least a uppercase character. Config:# security strongpasswords enforceatleastoneuppercasecharacter variables: is one of the options: enable or disable....

  • Page 319

    Chapter 7: using the command line interface 304 special character requirement this command syntax determines whether a strong password includes at least a special character. Config:# security strongpasswords enforceatleastonespecialcharacter variables: is one of the options: enable or disable. Optio...

  • Page 320

    Chapter 7: using the command line interface 305 role-bassed access control in addition to firewall access control based on ip addresses, you can configure other access control rules that are based on both ip addresses and users' roles. An ipv4 role-based access control command begins with security r...

  • Page 321

    Chapter 7: using the command line interface 306 config:# security rolebasedaccesscontrol ipv6 defaultpolicy variables: is one of the options: true or false. Option description true enables the role-based access control feature. False disables the role-based access control feature. Is one of the opti...

  • Page 322

    Chapter 7: using the command line interface 307 adding a role-based access control rule depending on where you want to add a new rule in the list, the command syntax for adding a rule varies. Ipv4 commands to add a new rule to the bottom of the ipv4 rules list, use this command syntax: config:# secu...

  • Page 323

    Chapter 7: using the command line interface 308 is one of the options: insertabove or insertbelow. Option description insertabove inserts the new rule above the specified rule number. Then: new rule's number = the specified rule number insertbelow inserts the new rule below the specified rule number...

  • Page 324

    Chapter 7: using the command line interface 309 config:# security rolebasedaccesscontrol ipv4 rule modify role to modify an ipv4 rule's policy, use this command syntax: config:# security rolebasedaccesscontrol ipv4 rule modify policy to modify all contents of an existing ipv4 rule, use this command ...

  • Page 325

    Chapter 7: using the command line interface 310 config:# security rolebasedaccesscontrol ipv6 rule modify startipaddress endipaddress role policy variables: is the number of the existing rule that you want to modify. Is the starting ip address. Is the ending ip address. Is one of the existing roles....

  • Page 326

    Chapter 7: using the command line interface 311 config:# security rolebasedaccesscontrol ipv6 rule delete variables: is the number of the existing rule that you want to remove. Example the following command removes the 7th ipv6 rule. Config:# security rolebasedaccesscontrol ipv6 rule delete 7 outlet...

  • Page 327

    Chapter 7: using the command line interface 312 changing an outlet's default state this section only applies to outlet-switching capable pdus. This command syntax determines the initial power condition of an outlet after the pdu powers up. Config:# outlet stateondevicestartup variables: is the numbe...

  • Page 328

    Chapter 7: using the command line interface 313 setting an outlet's cycling power-off period this section only applies to outlet-switching capable pdus. This command syntax determines the power-off period of the power cycling operation for a specific outlet. Config:# outlet cyclingpoweroffperiod var...

  • Page 329

    Chapter 7: using the command line interface 314 changing the inlet name this command syntax names an inlet. Config:# inlet name "" variables: is the number of the inlet that you want to configure. For a single-inlet pdu, is always the number 1. The value is an integer between 1 and 50. Is a string c...

  • Page 330

    Chapter 7: using the command line interface 315 example the command assigns the name "email servers cb" to the circuit breaker 3. Config:# ocp 3 name "email servers cb" environmental sensor configuration commands an environmental sensor configuration command begins with externalsensor. You can confi...

  • Page 331

    Chapter 7: using the command line interface 316 specifying the sensor type raritan's contact closure sensor (dpx-cc2-tr) supports the connection of diverse third-party detectors/switches, and you must specify the type of connected detector/switch for proper operation. Use this command syntax when yo...

  • Page 332

    Chapter 7: using the command line interface 317 setting the x coordinate this command syntax specifies the x coordinate of an environmental sensor. Config:# externalsensor xlabel "" variables: is the id number of the environmental sensor that you want to configure. The id number is assigned and show...

  • Page 333

    Chapter 7: using the command line interface 318 setting the z coordinate this command syntax specifies the z coordinate of an environmental sensor. Config:# externalsensor zlabel "" variables: is the id number of the environmental sensor that you want to configure. The id number is assigned and show...

  • Page 334

    Chapter 7: using the command line interface 319 changing the sensor description this command syntax provides a description for a specific environmental sensor. Config:# externalsensor description "" variables: is the id number of the environmental sensor that you want to configure. The id number is ...

  • Page 335

    Chapter 7: using the command line interface 320 setting the inlet's upper critical threshold this command syntax configures the upper critical threshold of an inlet. Config:# sensor inlet uppercritical variables: is the number of the inlet that you want to configure. For a single-inlet pdu, is alway...

  • Page 336

    Chapter 7: using the command line interface 321 setting the inlet's upper warning threshold this command syntax configures the upper warning threshold of an inlet. Config:# sensor inlet upperwarning variables: is the number of the inlet that you want to configure. For a single-inlet pdu, is always t...

  • Page 337

    Chapter 7: using the command line interface 322 setting the inlet's lower critical threshold this command syntax configures the lower critical threshold of an inlet. Config:# sensor inlet lowercritical variables: is the number of the inlet that you want to configure. For a single-inlet pdu, is alway...

  • Page 338

    Chapter 7: using the command line interface 323 setting the inlet's lower warning threshold this command syntax configures the lower warning threshold of an inlet. Config:# sensor inlet lowerwarning variables: is the number of the inlet that you want to configure. For a single-inlet pdu, is always t...

  • Page 339

    Chapter 7: using the command line interface 324 setting the inlet's deassertion hysteresis this command syntax configures the deassertion hysteresis value of an inlet. Config:# sensor inlet hysteresis variables: is the number of the inlet that you want to configure. For a single-inlet pdu, is always...

  • Page 340

    Chapter 7: using the command line interface 325 setting the inlet's assertion timeout this command syntax configures the assertion timeout value of an inlet. Config:# sensor inlet assertiontimeout variables: is the number of the inlet that you want to configure. For a single-inlet pdu, is always the...

  • Page 341

    Chapter 7: using the command line interface 326 setting the upper critical threshold for an inlet pole this command syntax configures the upper critical threshold of an inlet pole. Config:# sensor inletpole uppercritical variables: is the number of the inlet whose pole sensors you want to configure....

  • Page 342

    Chapter 7: using the command line interface 327 option description a numeric value sets a value for the upper critical threshold of the specified inlet pole sensor and enables this threshold at the same time. Example the following command disables the upper critical threshold for the pole 3 (l3-l1) ...

  • Page 343

    Chapter 7: using the command line interface 328 note: if the requested sensor type is not supported, the message "not available" is displayed. Is one of the options: enable, disable or a numeric value. Option description enable enables the upper warning threshold for the specified inlet pole sensor....

  • Page 344

    Chapter 7: using the command line interface 329 is one of the following sensor types: sensor type description current current sensor voltage voltage sensor activepower active power sensor apparentpower apparent power sensor powerfactor power factor sensor activeenergy active energy sensor unbalanced...

  • Page 345

    Chapter 7: using the command line interface 330 config:# sensor inletpole lowerwarning variables: is the number of the inlet whose pole sensors you want to configure. Is the label of the inlet pole that you want to configure. Pole label current sensor voltage sensor 1 l1 l1 l1 - l2 2 l2 l2 l2 - l3 3...

  • Page 346

    Chapter 7: using the command line interface 331 example the following command sets the lower warning threshold for the pole 3 (l3-l1) voltage of the inlet 1 to 190v. It also enables the lower warning threshold if this threshold has not been enabled yet. Config:# sensor inletpole 1 l3 voltage lowerwa...

  • Page 347

    Chapter 7: using the command line interface 332 is a numeric value that is assigned to the hysteresis for the specified inlet pole sensor. See what is deassertion hysteresis? (on page 153) for the function of the deassertion hysteresis. Example the following command sets the deassertion hysteresis o...

  • Page 348

    Chapter 7: using the command line interface 333 note: if the requested sensor type is not supported, the message "not available" is displayed. Is a number in samples that is assigned to the assertion timeout for the specified inlet pole sensor. See what is assertion timeout? (on page 154). Example t...

  • Page 349

    Chapter 7: using the command line interface 334 option description disable disables the upper critical threshold for the specified circuit breaker sensor. A numeric value sets a value for the upper critical threshold of the specified circuit breaker sensor and enables this threshold at the same time...

  • Page 350

    Chapter 7: using the command line interface 335 example the following command enables the upper warning threshold for the 3rd circuit breaker. Config:# sensor ocp 3 current upperwarning enable setting the lower critical threshold for a circuit breaker this command syntax configures the lower critica...

  • Page 351

    Chapter 7: using the command line interface 336 setting the lower warning threshold for a circuit breaker this command syntax configures the lower warning threshold of a circuit breaker. Config:# sensor ocp lowerwarning variables: is the number of the circuit breaker that you want to configure. Is o...

  • Page 352

    Chapter 7: using the command line interface 337 setting the circuit breaker's deassertion hysteresis this command syntax configures the deassertion hysteresis value of a circuit breaker. Config:# sensor ocp hysteresis variables: is the number of the circuit breaker that you want to configure. Is one...

  • Page 353

    Chapter 7: using the command line interface 338 note: if the requested sensor type is not supported, the message "not available" is displayed. Is a number in samples that is assigned to the assertion timeout of the specified circuit breaker sensor. See what is assertion timeout? (on page 154). Examp...

  • Page 354

    Chapter 7: using the command line interface 339 is one of the options: enable, disable or a numeric value. Option description enable enables the upper critical threshold for the specified environmental sensor. Disable disables the upper critical threshold for the specified environmental sensor. A nu...

  • Page 355

    Chapter 7: using the command line interface 340 option description disable disables the upper warning threshold for the specified environmental sensor. A numeric value sets a value for the upper warning threshold of the specified environmental sensor and enables this threshold at the same time. Exam...

  • Page 356

    Chapter 7: using the command line interface 341 example the following command sets the lower critical threshold of the environmental "humidity" sensor with the id number 1 to 15%. It also enables the lower critical threshold if this threshold has not been enabled yet. Config:# sensor externalsensor ...

  • Page 357

    Chapter 7: using the command line interface 342 example the following command disables the lower warning threshold of the environmental "humidity" sensor with the id number 3. Config:# sensor externalsensor 3 humidity lowerwarning disable setting the sensor's deassertion hysteresis this command synt...

  • Page 358

    Chapter 7: using the command line interface 343 config:# sensor externalsensor assertiontimeout variables: is the id number of the environmental sensor that you want to configure. The id number is assigned and shown in the dominion px web interface. It is an integer between 1 and 16. Is one of these...

  • Page 359

    Chapter 7: using the command line interface 344 variables: is a string comprising up to 32 ascii printable characters. The variable cannot contain spaces. Is one of the options: enable or disable. Option description enable enables the newly-created user profile. Disable disables the newly-created us...

  • Page 360

    Chapter 7: using the command line interface 345 changing a user's password this command syntax allows you to change an existing user's password if you have the administrator privileges. Config:# user modify password after performing the above command, dominion px prompts you to enter a new password....

  • Page 361

    Chapter 7: using the command line interface 346 modifying a user's personal data you can change a user's personal data, including the user's full name, telephone number, and email address. To change a user's full name, use this command syntax: config:# user modify fullname "" to change a user's tele...

  • Page 362

    Chapter 7: using the command line interface 347 config:# user modify may fullname "may turner" telephonenumber 123-4567 results: may's full name is specified as may turner. May's telephone number is set to 123-4567. Enabling or disabling a user profile this command syntax enables or disables a user ...

  • Page 363

    Chapter 7: using the command line interface 348 config:# user modify forcepasswordchangeonnextlogin variables: is the name of the user whose settings you want to change. Is one of the options: true or false. Option description true a password change is forced on the user's next login. False no passw...

  • Page 364

    Chapter 7: using the command line interface 349 to determine the security level: config:# user modify securitylevel variables: is the name of the user whose settings you want to change. Is one of the options: noauthnopriv, authnopriv or authpriv. Option description noauthnopriv no authentication and...

  • Page 365

    Chapter 7: using the command line interface 350 config:# user modify authenticationpassphrase variables: is the name of the user whose settings you want to change. Is a string used as an authentication passphrase, comprising up to 32 ascii printable characters. To determine whether the privacy passp...

  • Page 366

    Chapter 7: using the command line interface 351 config:# user modify privacypassphrase variables: is the name of the user whose settings you want to change. Is a string used as a privacy passphrase, comprising up to 32 ascii printable characters. To determine the authentication protocol: config:# us...

  • Page 367

    Chapter 7: using the command line interface 352 config:# user modify may snmpv3access enable securitylevel authnopriv userpasswordasauthenticationpassphrase true results: the user's snmpv3 access permission is enabled. The snmpv3 security level is authentication only, no privacy. The authentication ...

  • Page 368

    Chapter 7: using the command line interface 353 changing the measurement units you can change the measurement units displayed for temperatures, length, and pressure for a specific user profile. Different measurement unit commands can be combined so that you can set all measurement units at a time. T...

  • Page 369

    Chapter 7: using the command line interface 354 to set the preferred pressure unit: config:# user modify preferredpressureunit variables: is the name of the user whose settings you want to change. Is one of the options: pascal or psi. Option description pascal this option displays the pressure value...

  • Page 370

    Chapter 7: using the command line interface 355 changing your own password every user can change their own password via this command syntax if they have the change own password privilege. Note that this command does not begin with user. Config:# password after performing this command, the dominion p...

  • Page 371

    Chapter 7: using the command line interface 356 config:# role create "" ;;... If a specific privilege contains any arguments, that privilege should be followed by a colon and the argument(s). Config:# role create "" :,...; :,...; :,...; ... Variables: is a string comprising up to 32 ascii printable ...

  • Page 372

    Chapter 7: using the command line interface 357 privilege description changesecuritysettings change security settings changesnmpsettings change snmp settings changeusersettings change local user management changewebcamsettings change webcam configuration clearlog clear local event log firmwareupdate...

  • Page 373

    Chapter 7: using the command line interface 358 example the following command creates a new role and assigns privileges to the role. Config:# role create tester firmwareupdate;vieweventsetup results: a new role "tester" is created. Two privileges are assigned to the role: firmwareupdate (firmware up...

  • Page 374

    Chapter 7: using the command line interface 359 config:# role modify addprivileges :,...; :,...; :,...; ... Variables: is a string comprising up to 32 ascii printable characters. , , and the like are names of the privileges assigned to the role. Separate each privilege with a semi-colon. See all pri...

  • Page 375

    Chapter 7: using the command line interface 360 config:# role modify tester addprivileges changeauthsettings removeprivileges firmwareupgrade results: the "changeauthsettings" (change authentication settings) privilege is added to the role. The "firmwareupgrade" (firmware upgrade) privilege is remov...

  • Page 376

    Chapter 7: using the command line interface 361 example the following command enables the cisco ® energywise feature. Config:# energywise enabled true specifying the energywise domain this command syntax specifies to which cisco ® energywise domain the dominion px device belongs. Config:# energywise...

  • Page 377

    Chapter 7: using the command line interface 362 example the following command specifies "password5233" as the cisco ® energywise domain secret (password). Config:# energywise secret password5233 changing the udp port this command syntax specifies the udp port for communications in the cisco ® energy...

  • Page 378

    Chapter 7: using the command line interface 363 asset management commands you can use the cli commands to change the settings of the connected asset sensor (if any) or the settings of leds on the asset sensor. Asset sensor management an asset sensor management configuration command begins with asset...

  • Page 379

    Chapter 7: using the command line interface 364 specifying the number of rack units this command syntax specifies the total number of rack units on an asset sensor connected to the dominion px device. Config:# assetstrip numberofrackunits note: for the raritan asset sensor, a rack unit refers to a t...

  • Page 380

    Chapter 7: using the command line interface 365 example the following command causes the rack units of the asset sensor #1 to be numbered in an ascending order from the one closest to the asset sensor's rj-45 connector to the farthest one. That is, the rack unit that is most close to the rj-45 conne...

  • Page 381

    Chapter 7: using the command line interface 366 specifying the asset sensor orientation this command syntax specifies the orientation of the asset sensors connected to the dominion px device. Usually you do not need to perform this command unless your asset sensors do not come with the tilt sensor, ...

  • Page 382

    Chapter 7: using the command line interface 367 example the following command sets the led color for all rack units on the asset sensor #1 to red (that is, ff0000) to indicate the presence of a connected asset tag. Config:# assetstrip 1 ledcolorforconnectedtags #ff0000 setting led colors for disconn...

  • Page 383

    Chapter 7: using the command line interface 368 naming a rack unit this command syntax assigns or changes the name of the specified rack unit on the specified asset sensor. Config:# rackunit name "" variables: is the number of the feature port where the selected asset sensor is physically connected....

  • Page 384

    Chapter 7: using the command line interface 369 setting the led operation mode this command syntax determines whether a specific rack unit on the specified asset sensor follows the global led color settings. Config:# rackunit ledoperationmode variables: is the number of the feature port where the se...

  • Page 385

    Chapter 7: using the command line interface 370 setting an led color for a rack unit this command syntax sets the led color for a specific rack unit on the specified asset sensor. You need to set a rack unit's led color only when the led operation mode of this rack unit has been set to "manual." con...

  • Page 386

    Chapter 7: using the command line interface 371 setting an led mode for a rack unit this command syntax sets the led mode for a specific rack unit on the specified asset sensor. You need to set a rack unit's led mode only when the led operation mode of this rack unit has been set to "manual." config...

  • Page 387

    Chapter 7: using the command line interface 372 setting the serial port baud rate this command syntax sets the baud rate (bps) of the serial port labeled console / modem on the dominion px device. Note that you must log out of the cli for this setting to take effect if you change the baud rate via t...

  • Page 388

    Chapter 7: using the command line interface 373 multi-command syntax to shorten the configuration time, you can combine various configuration commands in one command and perform all of them at a time. A multi-command syntax looks like this: ... Example 1 - combination of ip, subnet mask and gateway ...

  • Page 389

    Chapter 7: using the command line interface 374 example 3 - combination of ssid and psk parameters this multi-command syntax configures both of ssid and psk parameters simultaneously for the wireless feature. Config:# network wireless ssid myssid psk encryp_key results: the ssid value is set to myss...

  • Page 390

    Chapter 7: using the command line interface 375 enabling or disabling load shedding this section only applies to outlet-switching capable pdus. This command syntax determines whether the load shedding feature is enabled. # loadshedding after performing the above command, dominion px prompts you to c...

  • Page 391

    Chapter 7: using the command line interface 376 turning on the outlet(s) this section only applies to outlet-switching capable pdus. This command syntax turns on one or multiple outlets. # power outlets on to quicken the operation, you can add the parameter "/y" to the end of the command, which conf...

  • Page 392

    Chapter 7: using the command line interface 377 example the following command turns on all outlets. # power outlets all on turning off the outlet(s) this section only applies to outlet-switching capable pdus. This command syntax turns off one or multiple outlets. # power outlets off to quicken the o...

  • Page 393

    Chapter 7: using the command line interface 378 example the following command turns off the outlet 6. # power outlets 6 off power cycling the outlet(s) this section only applies to outlet-switching capable pdus. This command syntax power cycles one or multiple outlets. # power outlets cycle to quick...

  • Page 394

    Chapter 7: using the command line interface 379 if you entered the command without "/y", a message appears, prompting you to confirm the operation. Then:  type y to confirm the operation, or  type n to abort the operation example the following command power cycles these outlets: 2, 6, 7, 8, 10, 13...

  • Page 395

    Chapter 7: using the command line interface 380 restarting the pdu this command restarts the dominion px device. It is not a factory default reset. To restart the dominion px device: 1. Ensure you have entered the administrator mode and the # prompt is displayed. 2. Type either of the following comm...

  • Page 396

    Chapter 7: using the command line interface 381 entering the diagnostic mode diagnostic commands function in the diagnostic mode only. To enter the diagnostic mode: 1. Ensure you have entered the administrator mode and the # prompt is displayed. 2. Type diag and press enter. The diag> prompt appears...

  • Page 397

    Chapter 7: using the command line interface 382 showing the network connections this command syntax displays network connections and/or status of ports. Diag> netstat variables: is one of the options: ports or connections. Option description ports shows tcp/udp ports. Connections shows network conne...

  • Page 398

    Chapter 7: using the command line interface 383 testing the network connectivity this command syntax sends the icmp echo_request message to a network host for checking its network connectivity. If the output shows the host is responding properly, the network connectivity is good, or the host is shut...

  • Page 399

    Chapter 7: using the command line interface 384 tracing the route this command syntax traces the network route between your dominion px device and a network host. Diag> traceroute variables: is the name or ip address of the host you want to trace. Example the following command displays the existing ...

  • Page 400

    Chapter 7: using the command line interface 385 querying available parameters for a command if you are not sure what commands or parameters are available for a particular type of cli command, you can have the cli show them by adding a space and then a question mark to the end of that command. A list...

  • Page 401

    Chapter 7: using the command line interface 386 logging out of cli after completing your tasks using the cli, always log out of the cli to prevent others from accessing the cli. To log out of the cli: 1. Ensure you have entered the administrator mode and the # prompt is displayed. 2. Type exit and p...

  • Page 402: Appendix A  Specifications

    387 in this chapter power measurement accuracy .............................................................387 maximum ambient operating temperature ..........................................387 serial rs-232 port pinouts....................................................................387 sensor...

  • Page 403

    Appendix a: specifications 388 rs-232 pin/signal definition pin no. Signal direction description 1 dcd input data 2 rxd input receive data (data in) 3 txd output transmit data 4 dtr output data terminal ready 5 gnd ― signal ground 6 dsr input data set ready 7 rts output request to send 8 cts input c...

  • Page 404

    389 dominion px series model ____________ dominion px series serial number ____________ outlet 1 outlet 2 outlet 3 model model model serial number serial number serial number use use use outlet 4 outlet 5 outlet 6 model model model serial number serial number serial number use use use appendix b equ...

  • Page 405

    Appendix b: equipment setup worksheet 390 outlet 7 outlet 8 outlet 9 model model model serial number serial number serial number use use use outlet 10 outlet 11 outlet 12 model model model serial number serial number serial number use use use outlet 13 outlet 14 outlet 15 model model model serial nu...

  • Page 406

    Appendix b: equipment setup worksheet 391 outlet 16 outlet 17 outlet 18 model model model serial number serial number serial number use use use outlet 19 outlet 20 outlet 21 model model model serial number serial number serial number use use use.

  • Page 407

    Appendix b: equipment setup worksheet 392 outlet 22 outlet 23 outlet 24 model model model serial number serial number serial number use use use types of adapters _________________________________________________________ types of cables _________________________________________________________ name o...

  • Page 408

    393 for security reasons, the dominion px device can be reset to factory defaults only at the local console. Important: exercise caution before resetting the dominion px to its factory defaults. This erases existing information and customized settings, such as user profiles, threshold values, and so...

  • Page 409

    Appendix c: resetting to factory defaults 394 this diagram shows the location of the reset button on zero u models. This diagram shows the location of the reset button on 1u models. This diagram shows the location of the reset button on 2u models. Note: hyperterminal is available on windows operatin...

  • Page 410

    Appendix c: resetting to factory defaults 395 3. Log in to the cli by typing the user name "admin" and its password. See step 4 of initial network configuration (on page 23). 4. After the # system prompt appears, type either of the following commands and press enter. # reset factorydefaults -- or --...

  • Page 411

    396 this section provides an ldap example for illustrating the configuration procedure using microsoft active directory ® (ad). To configure ldap authentication, four main steps are required: a. Determine user accounts and groups intended for the dominion px b. Create user groups for the dominion px...

  • Page 412

    Appendix d: ldap configuration illustration 397 step b. Configure user groups on the ad server you must create the groups for the dominion px on the ad server, and then make appropriate users members of these groups. In this illustration, we assume: the groups for the dominion px are named px_admin ...

  • Page 413

    Appendix d: ldap configuration illustration 398 step c. Configure ldap authentication on the dominion px device you must enable and set up ldap authentication properly on the dominion px device to use external authentication. In the illustration, we assume: the dns server settings have been configur...

  • Page 414

    Appendix d: ldap configuration illustration 399  base dn for search - type dc=techadssl,dc=com as the starting point where your search begins on the ad server.  login name attribute - ensure the field is set to samaccountname because the ldap server is microsoft active directory.  user entry obje...

  • Page 415

    Appendix d: ldap configuration illustration 400 note: for more information on ldap configuration, see setting up ldap authentication (on page 128). 5. Click ok to save the changes. The ldap server is saved. 6. Click ok to save the changes. The ldap authentication is activated. Note: if the dominion ...

  • Page 416

    Appendix d: ldap configuration illustration 401 b. Select a permission beginning with the word "view" from the privileges list, such as view event settings. C. Click add. D. Repeat steps a to c to add all permissions beginning with "view." 6. Click ok to save the changes. The px_user role is created...

  • Page 417

    Appendix d: ldap configuration illustration 402 to create the px_admin role with full permissions assigned: 1. Click new. The create new role dialog appears. 2. Type px_admin in the role name field. 3. Type a description for the px_admin role in the description field. In this example, we type "the r...

  • Page 418

    Appendix d: ldap configuration illustration 403 5. Click ok to save the changes. The px_admin role is created. 6. Click close to quit the dialog..

  • Page 419: Appendix E  Integration

    404 the dominion px device can work with certain raritan or non-raritan products to provide diverse power solutions. In this chapter power iq configuration .........................................................................404 dominion kx ii configuration .........................................

  • Page 420

    Appendix e: integration 405 note: if the pdu is not in this type of configuration, leave the proxy index field blank. 4. Enter an asset tag number or other asset management code in the external key field. Optional. 5. Enter data in custom field 1 and custom field 2. Optional. The labels may have bee...

  • Page 421

    Appendix e: integration 406 note: pdu discovery is complete once the pdu model type is determined. Snmp fields such as contact or location values are not determined until this device is polled for the first time. Once added, the pdu appears in the pdu list. Power iq begins polling the pdu for sensor...

  • Page 422

    Appendix e: integration 407 5. Power on the device. Naming the rack pdu in the kx ii or lx (port page for power strips) note: px rack pdus (power strips) can be named in the px as well as in kx ii and lx. Once a raritan remote rack pdu is connected to the kx ii or lx, it will appear on the port conf...

  • Page 423

    Appendix e: integration 408 3. Click ok..

  • Page 424

    Appendix e: integration 409 associating outlets with target servers on kx ii and lx the port page opens when you click on a port on the port configuration page. From this page, you can make power associations, change the port name to something more descriptive, and update target server settings if y...

  • Page 425

    Appendix e: integration 410 2. For that rack pdu, select the appropriate outlet from the outlet name drop-down list. 3. From the outlet name drop-down list, select none. 4. Click ok. That rack pdu/outlet association is removed and a confirmation message is displayed. To remove a rack pdu association...

  • Page 426

    411 in this chapter mac address ........................................................................................411 locking outlets and cords ....................................................................411 altitude correction factors .....................................................

  • Page 427

    Appendix f: additional dominion px information 412 securelock™ outlets and cords securelock ™ is an innovative mechanism designed by raritan, which securely holds c14 or c20 plugs that are plugged into raritan pdus in place. This method requires the following two components: raritan pdu with securel...

  • Page 428

    Appendix f: additional dominion px information 413 to remove a securelock ™ power cord from the pdu: 1. Press and hold down the two latches on the cord's plug as illustrated in the diagram below. 2. Unplug the cord now. Button-type locking outlets a button-type locking outlet has a button on it. Suc...

  • Page 429

    Appendix f: additional dominion px information 414 altitude correction factors if a raritan differential air pressure sensor is attached to your device, the altitude you enter for the device can serve as an altitude correction factor. That is, the reading of the differential air pressure sensor will...

  • Page 430

    Appendix f: additional dominion px information 415 cli command applicability not every cli command applies to all dominion px pdus because features vary from model to model. For example, px-1000 series are not implemented with the outlet switching capability, so outlet-switching commands are not app...

  • Page 431

    Appendix f: additional dominion px information 416 cli commands px-1000 px-2000 show security (details) y y show sensor externalsensor (details) y y show sensor inlet (details) y y show sensor inletpole (details) y y show sensor ocp (details) y y show serial y y show time (details) y y show user (de...

  • Page 432

    Appendix f: additional dominion px information 417 cli commands px-1000 px-2000 all sensor externalsensor commands y y all serial commands y y all time commands y y all user commands y y all role commands y y all energywise commands y y all assetstrip commands y y all loadshedding commands n y histo...

  • Page 433

    Appendix f: additional dominion px information 418 notes: 1. The pdu displayorientation command only applies to zero u models. Other commands this table indicates the applicability of cli commands other than the show and configuration commands. Y: applicable n: not applicable cli commands px-1000 px...

  • Page 434: Index

    419 1 1u products • 4 2 2u products • 4 a a note about enabling thresholds • 229 a note about firmware upgrade time • 220 a note about infinite loop • 178 a note about untriggered rules • 181 about contact closure sensors • 35 about the interface • 230 access security control • 110 accessing the hel...

  • Page 435

    Index 420 changing the user list view • 107 changing the view of a list • 78, 107, 110, 209, 221 changing your own password • 355 changing your password • 67 checking associated circuit breakers • 134 checking server monitoring states • 185 checking the branch circuit rating • 16 circuit breaker con...

  • Page 436

    Index 421 default log messages • 164 deleting a firewall rule • 296 deleting a role • 109, 360 deleting a role-based access control rule • 310 deleting a user profile • 106, 354 deleting an event rule or action • 181 deleting firewall rules • 115 deleting ping monitoring settings • 185 deleting role...

  • Page 437

    Index 422 existing roles • 246 existing user profiles • 245 expanding a blade extension strip • xiv, 199 expanding the tree • 71, 134, 135, 136, 137, 138, 140, 145, 146, 147, 148, 149, 150, 151, 152, 187, 188, 189, 192, 195, 196, 198, 214, 215, 216, 218 f filling out the equipment setup worksheet • ...

  • Page 438

    Index 423 modifying a role • 105, 106, 108, 358 modifying a role-based access control rule • 308 modifying a user profile • 67, 68, 106, 108, 344 modifying a user's personal data • 346 modifying an action • 93, 180 modifying an event rule • 179 modifying the firewall control parameters • 291 modifyi...

  • Page 439

    Index 424 r rack unit configuration • 367 rack unit settings of an asset sensor • 249 rackmount safety guidelines • 5 rack-mounting the pdu • 5 rebooting the dominion px device • 102 reliability data • 250 reliability error log • 251 reset button • 58 resetting the button-type circuit breaker • 59 r...

  • Page 440

    Index 425 setting the ipv4 primary dns server • 273 setting the ipv4 secondary dns server • 274 setting the ipv4 subnet mask • 272 setting the ipv6 address • 276 setting the ipv6 configuration mode • 275 setting the ipv6 gateway • 276 setting the ipv6 primary dns server • 277 setting the ipv6 second...

  • Page 441

    Index 426 specifying the rack unit numbering offset • 365 specifying the secondary ntp server • 289 specifying the sensor type • 316 states of managed sensors • 193 status bar • 73 step a. Determine user accounts and groups • 396 step b. Configure user groups on the ad server • 397 step c. Configure...

  • Page 442

    U.S./canada/latin america monday - friday 8 a.M. - 6 p.M. Et phone: 800-724-8090 or 732-764-8886 for commandcenter noc: press 6, then press 1 for commandcenter secure gateway: press 6, then press 2 fax: 732-764-8887 email for commandcenter noc: tech-ccnoc@raritan.Com email for all other products: te...