Dominion® PX User Guide Release 1.1.0 Copyright © 2008 Raritan, Inc.
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 2008 Raritan, Inc., CommandCenter®, Dominion®, Paragon® and the Raritan company logo are trademarks or registered trademarks of Raritan, Inc. All rights reserved. Java® is a registered trademark of Sun Microsystems, Inc.
Safety Guidelines To avoid potentially fatal shock hazard and possible damage to Raritan equipment: SYSTEMS SHOULD ONLY BE CONFIGURED BY A COMPETENT PERSON. IT IS ESSENTIAL THAT THIS EQUIPMENT IS CONNECTED TO AN ELECTRICAL SUPPLY THAT HAS A PROTECTIVE GROUND CONDUCTOR WARNING: TO ISOLATE THIS EQUIPMENT DISCONNECT POWER SUPPLY PLUG. ATTENTION: AFIN DʹISOLER TOTALEMENT CET APPAREIL DEBRANCHER FICHE DʹALIMENTATION. CAUTION: USE ONLY IN DRY LOCATIONS. ATTENTION: UTILISER UNIQUEMENT DANS DES EMPLACEMENTS SECS.
Product Models Provide an earthing connection before the mains plug is connected to the mains. And, when disconnecting the earthing connection, be sure to disconnect after pulling out the mains plug from the mains.
Contents Safety Guidelines Chapter 1 Introduction iii 1 Product Models.......................................................................................................................................... 1 Product Photos........................................................................................................................................... 1 Zero U Size ...................................................................................................................................
Contents Back Panel................................................................................................................................................. 20 Power Cord ................................................................................................................................... 20 Outlets............................................................................................................................................ 21 LED Display...................................
Contents Setting Up External User Authentication............................................................................................. 62 Settings Up LDAP Authentication............................................................................................. 63 Setting Up Outlets and Power Thresholds........................................................................................... 65 Setting the Default Outlet State........................................................................
Contents Deleting Outlet Group Devices ................................................................................................ 106 Chapter 6 Integration 107 Dominion KX ......................................................................................................................................... 108 KX Manager Application (Dominion KX‐I only)................................................................... 108 Associate Outlets with a Target .........................................
Contents Querying an Outlet Sensor................................................................................................................... 130 Appendix D Using SNMP 131 Enabling SNMP ..................................................................................................................................... 132 Configuring Users for Encrypted SNMP v3........................................................................... 134 Configuring SNMP Traps...................................
Contents Get Power Cycle Delay Command .......................................................................................... 152 IPMI Privilege Levels............................................................................................................................
Chapter 1 Introduction The Dominion PX unit is an intelligent power distribution unit that allows you to reboot remote servers and other network devices, and monitor power in the data center, through Raritanʹs KVM switches and Secure Console Servers. From the office or from anywhere, the Dominion PX unit will power on, power off, or reboot remote equipment, as well as monitor current, voltage, power, and temperature.
Product Photos Zero U Size 1U Size 2
Chapter 1: Introduction 2U Size Product Features All models and sizes of the Dominion PX provide the following features: • The ability to control outlets collectively and individually • The ability to power on, power off and reboot the devices connected to each outlet • The ability to group outlets from multiple Dominion PX as virtual outlets accessible from a single session • The ability to monitor the following at the outlet level: RMS Current Power Factor Maximum RMS Current RMS Voltage Active P
Package Contents • The ability to monitor the internal, CPU temperature of the Dominion PX • The ability to monitor environmental factors such as external temperature and humidity • An audible alarm (beeper) and a visual alarm (blinking LED) to indicate current overload • Configurable alarm thresholds • Support for SNMP v1, v2 and V3. • The ability to send traps using SNMP protocol. • The ability to retrieve outlet specific data using SNMP, including outlet state, current, voltage and power.
Chapter 1: Introduction 2U Products • Dominion PX unit including power cord 1.
Chapter 2 Rack-Mounting the Dominion PX In This Chapter Rack Mount Safety Guidelines.........................................................................6 Tool‐less Mounting Instructions......................................................................8 Rack Mount Safety Guidelines In Raritan products which require Rack Mounting, please follow these precautions: Operation temperature in a closed rack environment may be greater than room temperature.
Chapter 2: Rack-Mounting the Dominion PX Side Fixing End Fixing Blind Fixing 7
Tool-less Mounting Instructions Tool-less Mounting Instructions The Zero U units also ship with a tool‐less mounting kit consisting of a claw feet with a silver button on one side. These work by attaching to the back side of a Zero U Dominion PX (the side opposite of the outlets) and fitting the button into the mounting holes of the cabinet. Note that not all racks may allow the option of securing the Dominion PX in this way.
Chapter 2: Rack-Mounting the Dominion PX To Mount: • Snap fit the claw feet mounts onto the back of the Dominion PX unit. Leave at least 24 inches between the buttons for stability. Once the claw feet are mounted on the Dominion PX rail, they will not readily move‐a flat‐head screwdriver can be used to remove the feet if they need to be repositioned. • Align the silver buttons with the mounting holes in the cabinet, and ensure that both buttons can engage their mounting holes simultaneously.
Installation and Configuration Chapter 3 This chapter explains how to install a Dominion PX unit and configure it for network connectivity. In This Chapter Before You Begin..............................................................................................10 Connect the Dominion PX to a Computer....................................................11 Connect the Dominion PX to Your Network ...............................................12 Configure the Dominion PX for Network Connectivity .......
Chapter 3: Installation and Configuration Fill Out the Equipment Setup Worksheet An Equipment Setup Worksheet is provided in Appendix B (see ʺEquipment Setup Worksheetʺ on page 121). Use this worksheet to record the model, serial number, and use of each device connected to the Dominion PX. As you add and remove devices, keep the worksheet up to date. Connect the Dominion PX to a Computer You must connect the Dominion PX to a computer to configure it.
Connect the Dominion PX to Your Network 2. Plug the other end of the null‐modem cable (containing the DB9 connector) into the serial port (COM) of the computer. Connect the Dominion PX to Your Network To use the Web interface to administer the Dominion PX, you must connect the Dominion PX to your local area network (LAN). 1. Take a standard Category 5e UTP cable and connect one end to the LAN port on the front of the Dominion PX.
Chapter 3: Installation and Configuration Bits per second = 9600 Data bits = 8 Stop bits = 1 Parity = None Flow control = None Note: The “Flow control” parameter must be set to “None” for the communications program to work correctly with the Dominion PX. 2. Point the communications program at the serial port connecting the Dominion PX and open a terminal window. 3. Press Enter to display the opening configuration prompt. 4.
Configure the Dominion PX for Network Connectivity Note: The Dominion PXʹs IP address is automatically displayed in the system prompt. The default IP address is 192.168.0.192. The default IP configuration method is DHCP, and the default IP address will be replaced by the address assigned by DHCP or BOOTP, or the static IP address you entered, as soon as the configuration process is complete.
Chapter 3: Installation and Configuration 8. By default, the LAN interface speed is set to Auto, which allows the system to select the optimum speed. To keep the default, press Enter. To set the speed to 10 or 100 Mbps, type the speed you want and press Enter. You are prompted to select the duplex mode for the LAN interface. 9. By default, the LAN interface duplex mode is set to Auto, which allows the system to pick the optimum mode.
Resetting to Factory Defaults If you want to terminate the configuration process, type c and press Enter. The configuration is cancelled and you are returned to the opening prompt as shown in the screenshot of Step 3. 11. If you entered y to confirm the configuration, a message is displayed telling you when the configuration is complete. You are then returned to the opening prompt as shown in the screenshot of Step 3. You are now ready to begin using your Dominion PX.
Chapter 3: Installation and Configuration • Baud rate (bits per second) = 9600 • Data bits = 8 • Stop bits = 1 • Parity = None • Flow control = None 1. Press (and release) the Reset button of DPX while pressing the Esc key several times in rapid succession. A prompt (=>) should appear after about one second. 2. Execute the defaults command to reset the DPX to its factory defaults.
Resetting to Factory Defaults Note: Enter ʺhelpʺ to show a list of available command and a short description of each one. HyperTerminal is available on many Windows OS. But HyperTerminal is not available on Windows Vista. PuTTY is a free program you can download from the internet. Please refer to PuTTYʹs documentation for details on configuration. The picture below shows the location of the reset hole.
Chapter 4 Using the Dominion PX This chapter explains how to use the Dominion PX unit. It describes the LEDs and ports on the front and back panels of the Dominion PX, and explains how to use the display panel. It also explains how the circuit breaker works and when the beeper goes off. In This Chapter Front Panel........................................................................................................19 Back Panel..............................................................................
Back Panel LAN Connecting the Dominion PX to your companyʹs network Connect a standard Category 5e UTP cable to this port and connect the other end to your network. This connection is necessary to administer the Dominion PX remotely using the Web interface. There are two small LEDs under the LAN port. Green indicates a physical link and activity, and yellow indicates communication at 10/100 BaseT speeds. Note: Connecting any power CIM except the for the D2CIM‐PWR (e.g.
Chapter 4: Using the Dominion PX Outlets The number of outlets on the back panel depends upon the Dominion PX model. To the upper left of each outlet is a small LED. The units are shipped from the factory with all outlets powered ON. The table below explains how to interpret the different LED states. LED State Outlet Status What it Means Not lit (Light grey) Unit OFF The outlet is not connected to power or the control circuitryʹs power supply is broken.
Back Panel LED Display The LED display is located adjacent to the outlets on the Zero U model, and on the back right of the 1U and 2U models. The following picture shows the LED display.
Chapter 4: Using the Dominion PX The LED display consists of these components: • A lower row displaying two digits • An upper row displaying three digits • Up and Down buttons Note: The small hole between the lower row and the Down button is the reset hole. The Dominion PX unit can be reset to its factory default values through this hole when connected to the serial port. Refer to Resetting to Factory Defaults (on page 16) section for additional details.
Circuit Breaker Tip: A quick way to distinguish between voltage, current, and power is the placement of the decimal point in the display. Voltage has no decimal point, current has a decimal point between the first and second digits, and power has a decimal point between the second and third digits. You can view the current and voltage for the entire Dominion PX unit by using the Up and Down buttons to select the outlet number 00. The LEDs do not show the active power for the unit and display ‐‐‐ instead.
Chapter 4: Using the Dominion PX Beeper The Dominion PX includes a beeper. It will ring if any of the circuit breakers is tripped or if the control board temperature sensor exceeds 80 degrees Celsius (or 176 degrees Fahrenheit). The beeper will cease ringing when the broken circuit breaker conditions disappear or the control board temperature sensor drops below 70 degrees Celsius (or 158 degrees Fahrenheit). The temperature thresholds are factory defaults, and can be user‐ configurable.
Using the Web Interface Chapter 5 This chapter explains how to use the Web interface to administer a Dominion PX. In This Chapter Logging into the Web Interface .....................................................................26 Using the Web Interface..................................................................................30 Using the Home Window...............................................................................36 Setting Up User Profiles.........................................
Chapter 5: Using the Web Interface where is the IP address of the Dominion PX. A Login dialog appears. 2. Type your user name and password in the Username and Password fields. Both the user name and password are case sensitive, so make sure you capitalize the letters correctly.
Logging into the Web Interface 3. 28 Click Login. The Home window appears.
Chapter 5: Using the Web Interface Note: The Home window shown above shows 8 outlets. If your Dominion PX has 20 outlets, the Home window will show all 20. Java script must be enabled in the web browser for proper operation. If Java Script is not enabled, features such as the Status Panel on the left side of the interface will not display correctly.
Using the Web Interface Changing Your Password To change your password: 1. Choose User Management ‐‐> Change Password. The Change Password window appears. 2. Type your existing password in the Old Password field. 3. Type your new password in the New Password and Confirm New Password fields. Passwords are case sensitive, so be sure to capitalize the same letters each time. 4. Click Apply. Your password is changed.
Chapter 5: Using the Web Interface Menus There are several menus in the Web interface: • Power Outlets • Alerts • User Management • Device Settings • Maintenance • Outlet Groups Options The following figure shows a complete list of the options available from each menu.
Using the Web Interface How to Select an Option There are two ways to select an option from a menu: • Click the menu name to display a window listing each option, and then click the option you want to select it. • Position the cursor on the menu name. A list of options drops down from the menu. Slide the cursor to the option you want and click it to select it.
Chapter 5: Using the Web Interface • Information about the Dominion PX, including: Model name and number IP address Firmware version • Information about all the users currently connected, including user name, IP address, and current state. Your current session is included in this list. • A link to the User Guide on the Raritan Website. The State field in the user information section considers a user to be ʺidleʺ 30 seconds after the last keyboard or mouse action.
Using the Web Interface Status Messages When you perform an operation from the Web interface, such as creating a user profile or changing a network setting, a message appears at the top of the window that indicates whether or not the operation was successful. Be sure to check this message to confirm that an operation was successful.
Chapter 5: Using the Web Interface Unavailable Options At times, certain actions will be unavailable. When this occurs, the appropriate buttons will be non‐functional, though different browsers may display this differently. For example: if you select the Admin User Group in Internet Explorer, the buttons for Copy, Modify and Delete will be grayed‐out since you cannot Copy, Modify or Delete the Admin user group. In Firefox, however, these buttons will appear normal and simply be unclickable.
Using the Home Window Using the Home Window The Home window is the first window to appear after a successful login. It consists of a Global Status, an Outlets list, and an All Outlets Control panel. The home window also contains an environmental sensors panel, and a time stamp in the top right corner, noting when the data on the screen was last refreshed.
Chapter 5: Using the Web Interface Outlets List The Outlets List displays each outlet on the Dominion PX as a table row with a view of the power status, the RMS current and the RMS Power through the individual outlet. Turn an Outlet On, Off, or Cycle the Power To turn an outlet ON, OFF or cycle the power to it, click the On, Off, or Cycle in the outlet row. You will be asked to confirm your action, click OK and the outlet will then switch ON, OFF or will cycle its power.
Using the Home Window Display Additional Details To display additional details about an outlet, click the outlet name. This displays the Outlet Details window (refer to Figure 49 for a picture of the window). This window gives the name and status of the outlet, as well as: • RMS Current • Power Factor • Maximum RMS Current • RMS Voltage • Active Power • Apparent Power Note: RMS refers to Root Mean Square, a statistical method for measuring certain types of variables.
Chapter 5: Using the Web Interface Setting Up User Profiles The Dominion PX is shipped with one user profile built in. This is the Admin profile, which was used for the original login. This profile has full system and outlet permissions, and should be reserved for the system administrator. This profile cannot be modified or deleted. All users must have a user profile. The profile specifies a login name and password, and contains additional (optional) information about the user.
Setting Up User Profiles Note: Before entering any information in the user profile, please make sure the User Group is created and available for selection. 2. In the User Management panel, type the following information about the user in the corresponding fields: Field Type this... New user name The name the user will enter to log into the Web interface Full Name The userʹs first and last names Password The password the user will enter to log in.
Chapter 5: Using the Web Interface Note: New user name, Password, and Confirm Password are the only required fields. 3. Select a User Group from the drop‐down list in the User Group field. The User Group determines the system functions and outlets this user can access. 4. If you select None, the user is not assigned to a User Group. This means you have to set the userʹs permissions individually. Until you do this, the user is effectively blocked from accessing any system functions and outlets.
Setting Up User Profiles Modifying a User Profile Every user with user management permissions can modify a user profile. (Refer to “Setting the System Permissions (on page 44)” section for information about setting user permissions.) To modify a user profile: 1. Choose User Management ‐‐> Users & Groups. The User/Group Management window appears. 2. Select the user profile you want to modify from the drop‐down list in the Existing Users field.
Chapter 5: Using the Web Interface 2. Select the user from the drop‐down list in the User (not in group) field. The drop‐down list shows all user profiles that have NOT been assigned to a User Group. 3. Set the permissions as necessary. Click this icon choose either Yes or No. 4. When you are finished, click Apply. The permissions are applied to the user. in a field and Outlet Permissions To set the outlet permissions: 1. Choose User Management ‐‐> User/Group Outlet Permissions.
Setting Up User Groups Creating a User Group To create a User Group: 1. Choose User Management ‐‐> Users & Groups. The User/Group Management window appears. This window is divided into a User Management panel and a Group Management panel. 2. In the Group Management panel, type the name of the group in the New Group Name field. 3. Click Create. The User Group is created. Setting the System Permissions System permissions include all the major functional areas of the Web interface.
Chapter 5: Using the Web Interface 2. Select the User Group from the drop‐down list in the Group field. The permissions that apply to this group are displayed. If this is the first time you are setting the permissions for this group, all permissions are set to No. 3. Set the permissions as necessary. Click this icon select either Yes or No.
Setting Up User Groups 4. When you are finished, click Apply. The permissions are applied to the User Group. Note: The User (not in group) field on this window is used to set individual user permissions. If you are setting group permissions, you may ignore this field.
Chapter 5: Using the Web Interface Setting the Outlet Permissions Setting outlet permissions allows you to specify which outlets members of a User Group are permitted to access. When you first create a User Group, all outlet permissions are set to NO. To set the outlet permissions for a User Group: 1. Choose User Management ‐‐> Users/Group Outlet Permissions. The User/Group Outlet Permissions window appears. 2. Select the User Group from the drop‐down list in the Group field.
Setting Up User Groups 3. Set the permissions as necessary. Click this icon select either Yes or No. in a field and 4. When you are finished, click Apply. The permissions are applied to the User Group. Note: The User field on this window is used to set individual user permissions. If you are setting group permissions, you may ignore this field. Copying a User Group You can create a new User Group with the exact same permissions as an existing User Group by using the copy function.
Chapter 5: Using the Web Interface Note: To modify a User Groupʹs system or outlet permissions, repeat the procedure for setting the system or outlet permissions described above and make any necessary changes. Deleting a User Group To delete a User Group: 1. Choose User Management ‐‐> Users & Groups. The User/Group Management window appears. 2. Select the User Group you want to delete from the drop‐down list in the Existing groups field. 3. Click Delete. The User Group is deleted.
Setting Up Access Controls Configuring the Firewall The Dominion PX has a firewall that can be configured to prevent specific IP addresses and ranges of IP addresses from accessing the Dominion PX. When the Dominion PX was initially configured, you were prompted to enable or disable IP access control. If you selected Disable (the default), the Dominion PX firewall was not enabled.
Chapter 5: Using the Web Interface Change the Default Policy Once enabled, the firewall has a default policy built in that accepts traffic from all IP addresses. This means any IP addresses not dropped by a specific rule will be permitted to access the Dominion PX. You can change the default policy to DROP, in which case traffic from all IP addresses will be dropped except traffic allowed by a specific ACCEPT rule. To change the default policy: 1. Choose Device Settings ‐‐> Security.
Setting Up Access Controls 2. Make sure the checkbox labeled Enable IP Access Control is checked. Create specific rules. The following explains how: Action Do this... Add a rule to the end of the rules list • Type an IP address and subnet mask in the IP/Mask field. • Select ACCEPT or DROP in the Policy field. • Click Append. Do NOT enter a rule number. The system automatically numbers the rule.
Chapter 5: Using the Web Interface 2. Click Apply. The rules are applied. Delete Firewall Rules To delete a firewall rule: 1. Choose Device Settings ‐‐> Security. The Security Settings window appears. 2. Make sure the checkbox labeled Enable IP Access Control is checked. 3. Type the number of the rule to be deleted in the Rule # field. 4. Click Delete. The rule is removed from the IP Access Control panel. 5. Click Apply. The rule is deleted.
Setting Up Access Controls 2. Click the checkbox labeled Enable Group based System Access Control. This enables the feature. 3. Click Apply. Group based access control rules are enabled. Change the Default Action The default action is shown in the Group based System Access Control panel on the Security Settings window. To change the default action: 1. Choose Device Settings ‐‐> Security. The Security Settings window appears. The panel labeled Group based System Access Control controls this feature.
Chapter 5: Using the Web Interface Action Do this... Add a rule to the end of the rules list • Type a starting IP address in the Starting IP field. • Type an ending IP address in the Ending IP field. • Select a User Group from the drop‐down list in the Group field. This rule applies to members of this group only. • Select ACCEPT or DROP from the drop‐down list in the Policy field. • Click Append. Do NOT enter a rule number. This system automatically numbers the rule.
Setting Up Access Controls 2. Make sure the checkbox labeled Enable Group based System Access Control is checked. 3. Type the number of the rule to be deleted in the Rule # field. 4. Click Delete. The rule is removed from the Group based System Access Control panel. 5. Click Apply. The rule is deleted. 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.
Chapter 5: Using the Web Interface Enable Login Limitations Login limitations allow you to determine whether more than one person can use the same login at the same time, and whether or not users will be required to change passwords at regularly scheduled intervals. To enable login limitations: 1. Choose Device Settings ‐‐> Security. The Security Settings window appears. The Login Limitations panel controls this feature. 2.
Setting Up Access Controls Enable Strong Passwords Forcing users to create strong passwords makes it more difficult for intruders to crack user passwords and access the Dominion PX unit. Strong passwords should be at least eight characters long and should contain upper and lowercase letters, numbers, and special characters (such as @ or &). To force users to create strong passwords: 58 1. Choose Device Settings ‐‐> Security. The Security Settings window appears.
Chapter 5: Using the Web Interface 3. Make any necessary changes to the default settings. 4. When you are finished, click Apply. The changes are applied. Setting Up a Digital Certificate The purpose of an X.509 digital certificate is to ensure that both parties in an SSL connection are who they say they are. To obtain a certificate for the Dominion PX, you must create a Certificate Signing Request (CSR) and submit it to a certificate authority (CA).
Setting Up a Digital Certificate Creating a Certificate Signing Request To create a CSR: 1. Choose Device Setting ‐‐> Certificate. The first page of the SSL Server Certificate Management window appears. 2. Provide the information requested. Type the following in the appropriate fields: Field Type this...
Chapter 5: Using the Web Interface State/Province The state or province where your company is located Country (ISO code) The country where your company is located. Use the standard ISO code. For a list of ISO codes, go to this Web site: http://www.iso.org/iso/en/prods‐services/iso3166ma/ 02iso‐3166‐code‐lists/list‐en1.ht Email An email address where you or another administrative user can be reached Challenge Password The password that will be required to access the Dominion PX.
Setting Up External User Authentication 2. Type the path and name of the certificate file in the SSL Certificate File field, or click Browse and select the file. 3. Click Upload. The certificate is installed on the Dominion PX. Setting Up External User Authentication For security purposes, users attempting to log into the Dominion PX must be authenticated.
Chapter 5: Using the Web Interface Settings Up LDAP Authentication To set up LDAP authentication: 1. Choose Device Settings ‐‐> Authentication. The Authentication Settings window appears. The LDAP parameters appear on the left side of the window. 2. Click the radio button labeled LDAP. 3. Type the IP address of the LDAP server in the User LDAP Server field. 4. To encrypt traffic to and from the LDAP server, click the checkbox labeled SSL Enabled. 5.
Setting Up External User Authentication 6. Type the base DN in the Base DN of user LDAP server field. The base distinguished name (DN) is the top level of the LDAP directory tree. It indicates where in the LDAP directory you want to begin searching for user credentials. 7. Select the type of LDAP server from the drop‐down list in the Type of external LDAP server field. Your choices are: 8. 9.
Chapter 5: Using the Web Interface 5. By default, the Dominion PX uses the standard RADIUS port 1812 (authentication) and 1813 (accounting). If you prefer to use non‐ standard ports, change the ports. 6. Type the timeout period in seconds in the Timeout field. This sets the maximum amount of time to establish contact with the RADIUS server before timing out. Default is 1 second. 7. Type the number of retries permitted in the Retries field. Default is 3. 8.
Setting Up Outlets and Power Thresholds Setting the Default Outlet State Sets a global default for the power state of the outlets when the Dominion PX unit is powered on. Setting an individual outletʹs startup state to something other than Device Default (refer to Naming the Outlets) will override this default state for that outlet. To set this default: 1. Select Device Settings, and then select Unit Setup. The Unit Setup window appears. 2.
Chapter 5: Using the Web Interface Note: The number you enter here applies to all outlets on the Dominion PX. However, you can override this number for specific outlets, if you wish. refer to “Setting the Outlet Thresholds (on page 70)” section for more information. You can power cycle an outlet from the Outlet Details window. Refer to “Power Cycling an Outlet (on page 72)” section for instructions. 2. Type a number of seconds in the field labeled Sequence Delay in ms. The default is 200 milliseconds. 3.
Setting Up Outlets and Power Thresholds • First moves the outlet to the top of the list and makes it the first outlet to receive power. • Up moves the outlet up one position in the list. • Down moves the outlet down one position in the list. • Last moves the outlet to the bottom of the list and makes it the last outlet to receive power. 1. Click Apply. The new sequence is saved.
Chapter 5: Using the Web Interface Naming the Outlets You can give each outlet a name to help you identify the device connected to it. To do this: 1. Choose Power Outlets ‐‐> Outlet Setup. The Outlet Setup window appears. 2. Select the outlet from the drop‐down list in the Show setup of outlet field. 3. Type a name for the outlet in the Outlet Name field. It is a good idea to give the outlet an easily recognizable name that helps you identify the device connected to it.
Setting Up Outlets and Power Thresholds 5. Click Apply. The new name is applied. Setting the Outlet Thresholds To set the current thresholds of an outlet: 1. Choose Power Outlets ‐‐> Outlet Setup. The Outlet Setup window appears. 2. Select an outlet from the drop‐down list in the Show setup of outlet field. 3. Type a number in the field labeled Power off period during outlet power cycling. When an outlet is power cycled, it is turned off and then back on.
Chapter 5: Using the Web Interface Viewing Outlet Details To display details about a particular outlet: 1. Choose Power Outlets ‐‐> Outlet Details. The Outlet Details window appears. 2. Select an outlet from the drop‐down list in the Show details of outlet field.
Environmental Sensors Note: To display the Outlet Setup window, click the [Setup] link. Refer to Naming the Outlets (on page 69) section for a picture of the Outlet Setup Window. Power Cycling an Outlet To turn an outlet off and on: 1. Choose Power Outlets ‐‐> Outlet Details. The Outlet Details window appears. 2. Select an outlet from the drop‐down list in the Show details of outlet field. The outlet must be ON. 3. Click Cycle. The outlet turns OFF and then back ON.
Chapter 5: Using the Web Interface Mapping the Environmental Sensors Once the sensors have been physically connected to the Dominion PX, they must be mapped to the unitʹs logical sensors before Dominion PX will recognize (and display) the readings from them. To do this:s 1. Select Device Settings, and then select Environmental Sensors. The Environmental Sensors window appears. The page will list the logical Temperature and Humidity sensors first. 2.
Environmental Sensors 4. To unmap a logical sensor from any physical sensor, clilck clear at the bottom of the column. That logical sensor will no longer be associated with any of the physical sensors. Note: It is possible (but not advisable) to map more than one logical sensor to a single physical sensor. You cannot map multiple physical sensors to a single logical one.
Chapter 5: Using the Web Interface When the configuration changes have been applied, the sensor readings will be displayed on the Home Page next to the outlets list and the sensor names will be updated. This updated name will also display in the physical sensors table at the bottom of the Environmental Sensors page. This can be useful for ensuring that the physical and logical sensors are correctly mapped together.
Setting Up Alerts Setting Up Alerts The Dominion PX can be configured to issue an alert whenever a threshold is crossed, either for the Dominion PX unit as a whole or for a specific outlet. The alert can be programmed to send an administrator an email message, or it can be programmed to send a Simple Network Management Protocol (SNMP) trap to a specific IP address. Note: Refer to “Setting Up Outlets and Power Thresholds (on page 65)” section for instructions on setting power thresholds.
Chapter 5: Using the Web Interface 3. Select the threshold from the second drop‐down list in the Event field as shown below. The list of thresholds will vary depending on what was selected in the first drop‐down list. 4. Select an Event Direction from the third drop‐down list. • If set to Assert, this alert will only trigger when a measured value moves past a critical threshold (either above an upper critical threshold, or below a lower critical one).
Setting Up Alerts Creating Alert Policies Alert policies allow you to associate events with destinations. Policies determine whether specific events trigger an entry in the event log, an email message to an administrator, an SNMP trap, a selected outlet to be switched on/off/cycled, or any combination of the four. About Policies The diagram below illustrates the way policies associate events with destinations. In this example, five events and two policies are defined.
Chapter 5: Using the Web Interface 2. You can modify or delete a policy by clicking the corresponding button next to the policy. You can add a new policy and configure alerts and destinations by clicking the appropriate link. Create a Policy To create a policy: 1. Choose Alerts ‐‐> Alert Policy Editor. The Alert Policy Editor appears. 2. Type a name for the policy in the New policy Name field.
Setting Up Alerts 3. Select the destinations associated with the policy in the Destinations panel. Your choices are System (event log), Switch Outlet, eMail, and SNMP. 4. Click Create. The policy is created. Modify a Policy To modify a policy: 1. Choose Alerts ‐‐> Alert Policy Editor. The Alert Policy Editor appears. 2. Select the policy to be modified from the drop‐down list in the Existing Policies field. 3. Make any necessary changes to the policyʹs name or destinations. 4. Click Modify.
Chapter 5: Using the Web Interface Specifying the Alert Destination The alert destination can be an email address or an SNMP trap. To specify the destination: 1. Choose Alerts ‐‐> Alert Destinations. The Alert Destinations window appears. Note: If you have not configured the Dominion PXʹs SMTP, a note will appear on this page prompting you to do so now. You cannot enter an email address until you have configured the SMTP server.
Setting Up Event Logging 4. Email SNMP If you selected SNMP, enter the IP address of the trap and the community string. If you selected email, type the receiverʹs email address. Click Add. The destination is added. Note: To delete an alert destination, click the appropriate Delete button. Note: The Dominion PX is capable of sending out two types of SNMP traps, including: (1) PX‐specific traps, which are sent if configured in Event Log setting, while the PDU‐MIBs should be self‐ explanatory.
Chapter 5: Using the Web Interface Configuring the Local Event Log To configure the local event log: 1. Choose Device Settings ‐‐> Event Log. The Event Log Settings window appears. The Local Logging panel appears first. This panel controls the local event log. 2. The local event log is enabled by default. To turn it off, uncheck the checkbox labeled Local Logging Enabled. 3. By default, 20 log entries appear on each page of the local event log when it is displayed on your screen.
Setting Up Event Logging 5. By default, when the local event log is enabled, seven event types appear in the Event Log Assignments panel to the right. All are enabled by default. To disable any of these event types, clear the appropriate check boxes. Note: Refer to the Event Types appendix for a more detailed explanation of these event types. 6. 84 When you are finished, click Apply. Local logging is configured.
Chapter 5: Using the Web Interface Viewing the Internal Event Log To display the internal event log, select Maintenance and then select View Event Log. Entries For each entry, the event log shows: • The date and time of the event • The type of event (board message, security, host control, or authentication) • A brief description of the event. For example, for an authentication event, the entry in the log shows the userʹs login name and the IP address of the userʹs computer.
Setting Up Event Logging Configuring NFS Logging To configure Network File System (NFS) logging: 86 1. Choose Device Settings ‐‐> Event Log. The Event Log Settings window appears. The NFS Logging panel controls NFS logging. 2. Click the checkbox labeled NFS Logging Enabled. 3. Type the IP address of the NFS server in the NFS Server field. 4. Type the name of the shared NFS directory in the NFS Share field. 5. Type the name of the NFS log file in the NFS Log File field. Default is evtlog. 6.
Chapter 5: Using the Web Interface Configuring SMTP Logging To configure Simple Mail Transfer Protocol (SMTP) logging: 1. Choose Device Settings ‐‐> Event Log. The Event Log Settings window appears. The SMTP Logging panel controls SMTP logging. 2. Click the checkbox labeled SMTP Logging Enabled. 3. Type the receiverʹs email address in the Receiver Email Address field. 4. By default, when SMTP logging is enabled, seven event types appear in the Event Log Assignments panel to the right.
Setting Up Event Logging Configuring SNMP Logging Event logging can be performed by sending SNMP traps to a third‐party SNMP manager. Refer to the Using SNMP appendix for instructions on enabling SNMP Event Logging on Dominion PX. Configuring Syslog Forwarding To configure Syslog Forwarding: 88 1. Choose Device Settings ‐‐> Event Log. The Event Log Settings window appears. The Syslog Forwarding panel controls forwarding of system logs. 2. Click the checkbox labeled Enable Syslog Forwarding. 3.
Chapter 5: Using the Web Interface Managing the Dominion PX You can display basic device information about the Dominion PX, give the Dominion PX a new device name, and modify any of the network settings that were entered during the initial configuration process. You can also set the unitʹs date and time and configure its SMTP settings so it can send email messages when alerts are issued. Displaying Basic Device Information 1.
Managing the Dominion PX 90 2. This Device Information panel displays the product name, serial number, and IP and MAC addresses of the Dominion PX, as well as detailed information about the firmware running in the unit. 3. To open or save an XML file providing details for Raritan Technical Support, click the link entitled View the datafile for support.
Chapter 5: Using the Web Interface Displaying Model Configuration Information To display information about the specific model of the Dominion PX that you are using, choose Maintenance ‐‐> Device Information. The Device Information window appears. Information about your model is shown in the Model Configuration Panel below the Device Information panel. See Figure 64 for details.
Managing the Dominion PX Naming the Dominion PX By default, the Dominion PX has a device name of pdu. You may want to give the Dominion PX a more easily recognizable name to help identify it. To do this: 92 1. Choose Device Settings ‐‐> Network. The Network Settings window appears. The left side of the window consists of the Basic Network Settings panel, which contains the device name. 2. Type a new name in the Device Name field. 3.
Chapter 5: Using the Web Interface Modifying the Network Settings The Dominion PX was configured for network connectivity during the installation and configuration process (refer to Installation and Configuration (on page 10) chapter for details). If necessary, you can modify any of these settings. To do this: 1. Choose Device Settings ‐‐> Network. The Network Settings window appears. The left side of the window consists of the Basic Network Settings panel, which shows the current network settings.
Managing the Dominion PX Modifying the Communications, Port and Bandwidth Settings You can use Telnet or SSH to log into the Dominion PXʹs CLP interface. However, by default SSH is enabled and Telnet is not (because it communicates in the clear and is therefore not secure). You can change this and enable or disable either application. You can also set a bandwidth limit, and change any of the default port settings. Finally, you can enable or disable the Raritan Setup Protocol. To do all this: 94 1.
Chapter 5: Using the Web Interface Note: No programs are currently available to use the Setup Protocol with Dominion PX. It is safe to leave this disabled. 6. When you are finished, click Apply. The settings are modified. Modifying the LAN Interface Settings The LAN interface speed and duplex mode were set during the installation and configuration process (refer to for details). To modify either setting: 1. Choose Device Settings ‐‐> Network. The Network Settings window appears.
Managing the Dominion PX Setting the Date and Time You can set the internal clock on the Dominion PX manually, or you can link to a Network Time Protocol (NTP) server and let it set the date and time. 96 1. Choose Device Settings ‐‐> Date/Time. The Date/Time Settings window appears. 2. Enter a time zone by selecting the appropriate Coordinated Universal Time (UTC) offset from the drop‐down list in the UTC Offset field (e.g. US Eastern Standard Time = UTC‐5). 3.
Chapter 5: Using the Web Interface Configuring the SMTP Settings The Dominion PX allows you to configure alerts to send an email message to a specific administrator. To do this, you have to configure the Dominion PXʹs SMTP settings and enter an IP address for your SMTP server and a senderʹs email address. Note: Refer to “Setting Up Alerts (on page 76)” section for instructions on configuring alerts to send emails. 1. Choose Device Settings ‐‐> SMTP Settings. The SMTP Settings window appears. 2.
Managing the Dominion PX Configuring the SNMP Settings The SNMP Settings window allows you to enable and disable SNMP communication between an SNMP manager and the PX unit. Enabling SNMP communication will allow the PX to send SNMP trap events to the manager, as well as allow the manager to retrieve and control the power status of each outlet. To configure SNMP communication (necessary for passing SNMP traps as well as individual outlet control): 98 1.
Chapter 5: Using the Web Interface 4. Check Enable SNMP v3 Protocol to enable communication with an SNMP manager using SNMP v3 protocol. 5. Type the System Location in the System Location field. 6. Type the System Contact in the System Contact field. 7. Click on the link at the bottom of the window to download an SNMP MIB for your Dominion PX to use with your SNMP manager. 8. Click Apply. The SNMP configuration is set.
Managing the Dominion PX 4. When the reset is complete, the Dominion PX unit restarts and the Login window is displayed. Then, you can log back into the Dominion PX. Updating the Firmware Raritan will notify customers when new firmware is available to update the Dominion PX. Customers will be given instructions where to go to download the new firmware. Once the firmware is downloaded onto a PC, you can install it on the Dominion PX from the Web interface. To perform a firmware update: 100 1.
Chapter 5: Using the Web Interface 4. Click Upload. The Firmware Update window appears. It shows the current firmware version and the new firmware version, and gives you a last chance to terminate the update. 5. To proceed with the update, click Update. To terminate the update, click Discard. The update may take several minutes. The Status panel on the left tracks the progress of the upgrade. Note: Do NOT power the Dominion PX off during the update.
Outlet Grouping Outlet Grouping Using the Outlet Grouping feature, users can combine outlets from separate Dominion PX Units into a single, logical group, allowing control from a single Dominion PX. Outlets that are grouped together power on (and power off) together in unison, making outlet grouping ideal for servers with power supplies plugged into multiple Dominion PX units.
Chapter 5: Using the Web Interface 5. Click Add/Modify. The new Dominion PX is now available for outlet grouping. To modify the name, or the Username and Password used to access a participating Dominion PX, simply retype the information for the same Dominion PX unit and click Add/Modify again. Note: You can re‐add the Dominion PX unit you are accessing (if you deleted it from the list) or modify its details by using the IP address 127.0.0.1.
Outlet Grouping 2. Type a name for the outlet group in the Name field. It is a good idea to give the outlet group a recognizable name that helps identify the device(s) connected to it. 3. Type a comment for the outlet group in the Comment field. This can be used to further identify device(s) powered by the group. 4. Under the Capabilities field, check the boxes of the Power Control abilities you want available for this outlet. 5.
Chapter 5: Using the Web Interface Controlling Outlet Groups Any outlet groups created from this Dominion PX will appear in the Outlet Groups List. From this list, you can power ON, Power OFF or cycle power to the outlet group (if the capability is available). To control the power to an outlet group: 1. Select Outlet Groups, then Outlet Group Details. The Outlet Groups List appears. Note: Only outlet groups created through this specific Dominion PX will appear in this Outlet Groups list.
Outlet Grouping Note: The page must finish loading or refreshing before selecting an action. If you select an action before the page has finished updating the status of all outlet groups, the command will be ignored. If you want to view or edit the composition of an outlet group, clicking on the name of the outlet group in the list will take you to the Outlet Group Editor for the selected outlet group. Editing or Deleting Outlet Groups 1. Select Outlet Groups, and then select Outlet Group Editor.
Integration Chapter 6 Product Direct Access Interfaces Access thru CC Interfaces Association Control Association Dominion SX >= 3.1 SX GUI Control Max # of PX Connectivity units supported RSC into PX CC GUI serial port CC GUI CSCSPCS‐1 or Max = number CSCSPCS‐10 of serial ports RRC/MPC CC GUI JAC for KX‐ II Only CC GUI P2CIM‐PWR 4 D2CIM‐PWR (Increased to 8 in KX1.3) <3.
Dominion KX NOTE: Connecting any power CIM except the for the D2CIM‐PWR (e.g. P2CIM‐PWR) to the serial port of the Dominion PX will switch all the outlets to the ON state, even if they were previously OFF. In This Chapter Dominion KX..................................................................................................108 Paragon II........................................................................................................111 Dominion SX .............................................
Chapter 6: Integration 2. Select up to eight Dominion PX units from drop‐down list. 3. Select up to a total of four outlets from the PX units.
Dominion KX 4. Notice the target icon change to indicate power. 5. Notice the outlet icon change to indicate association. 6. Notice the outlet name automatically changes to the targetʹs name. Control a Target's Power 1. 110 Select target associated with outlets.
Chapter 6: Integration 2. Select from Power On, Power Off, or Cycle Power options. Dominion KX-II To use the Dominion KX II power control feature: 1. Connect the Dominion PX to your target server. 2. Name the Dominion PX unit. 3. Associate outlet(s) in the Dominion PX to the target server. 4. Utilize remote power management of the target server from the Port Access Page. Refer to Dominion KX‐II user guide for more details. Paragon II Paragon II use requires P2CIM‐PWR and straight CAT5 cable.
Paragon II Paragon Manager Application Use Raritanʹs Paragon Manager application to configure associations: 1. In Paragon Manager, select the target. 2. Click the target icon and drag‐and‐drop it on the desired outlets. 3. The outlets will be renamed to the associated targetʹs name automatically. 4. To turn on, turn off, or recycle power to the target, click on the target and press the F3 key; select On, Off, or Recycle power from the drop‐ down menu.
Chapter 6: Integration Associate Outlets with a Target On the OSD screen, press F5 to enter the Channel Configuration page and select the channel. Press G to enter the special second‐tier screen (Outlet Configuration page). Control a Target's Power To control a targetʹs power: 1. From either “Channel Selection by Name” OR “Channel Selection” menus, press F3 to control power. The message, “X‐Power Off; O‐ Power On; R‐Recycle Power” appears on the scrolling help line. 2.
Dominion SX Control an Outlet's Power When in “Channel Selection” Menus (NOT in “Channel Selection by Name”), users can navigate to individual Dominion PX ports and control power. User Selects Outlet and Presses X, O, or R: • If no permission to the outlet, “Permission denied.” displayed • If O, executes on command If X or R, “Are you sure (yes/no)?” displayed. User must type “yes” (case insensitive) in order for command to execute. Typing “Y” or “y” or “ye”, etc. is not acceptable.
Chapter 6: Integration 3. Type a name and description in the Name and Description fields. 4. Select the number of outlets from the drop‐down menu in the Number of Outlets field. 5. Type the port number in the Port field. 6. Click OK. Power Control 1. Choose Power Control ‐‐> Power Strip Power Control. 2. The Outlet Control screen appears. 3. Check the box of outlet number you wish to control, and click On/Off buttons to power on/off the selected outlet(s).
Dominion KSX 4. A confirmation message will appear to indicate the successful operation. Figure 1: Outlet Confirmation Screen Check Power Strip Status 1. Choose Power Control ‐‐> Power Strip Status. 2. A status box appears to display details of the controlled Dominion PX, including power state of each outlet on the unit. Dominion KSX Support of KSX G1 for Dominion PX is currently not available at this stage.
Chapter 6: Integration CommandCenter You can manage a Dominion PX from a CommandCenter if it is connected through any of the following Raritan products: • Dominion SX • Dominion KX • Paragon II • Refer to CC‐SG user guide for more details. NOTE: If you have to reboot or power OFF the Dominion PX while it is integrated with a Raritan product under CC‐SG management you should PAUSE MANAGEMENT of the integrated product until the Dominion PX fully powers ON again.
Appendix A Dominion PX Models Outlet Type # of Outlet s Plug Type # of Circui t # of Circuit Breaker Model Rack V Curren t DPCR8‐15 1U 120 15 Nema 5‐15R 8 Nema 5‐15P 1 None DPCR8A‐16 1U 230 16 IEC320 C13 8 IEC60309 16A 1 None DPCR8A‐20L6 1U 208 20 IEC320 C13 8 Nema L6‐20P 1 None DPCS12‐20 0U 120 20 Nema 5‐15R 12 Nema 5‐20P 1 None DPCS12A‐16 0U 230 16 IEC320 C13 12 IEC60309 16A 1 None DPCS20‐20 0U 120 20 Nema 5‐15R 20 Nema 5‐20P 1 None DPCS20‐20
Appendix A: Dominion PX Models Note: Per NEC rules, North American units should be de‐rated by 20%. For example, a Dominion PX rated at 30A can provide 24A of current in North America. Regardless of Dominion PX model, the maximum current load is 10A per outlet. In This Chapter Hardware Specification.................................................................................119 Environmental Specifications.......................................................................
Environmental Specifications Environmental Specifications Environmental Factor Threshold Max Ambient Temperature 40 degrees Celsius 120
Appendix B Equipment Setup Worksheet Dominion PX Series Unit Model ____________ Dominion PX Series Unit Serial Number ____________ 121
Environmental Specifications OUTLET 1 OUTLET 2 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 OUTLET 7 OUTLET 8 OUTLET 9 MODEL MODEL MODEL SERIAL NUMBER SERIAL NUMBER SERIAL NUMBER USE USE USE OUTLET 10 OUTLET 11 OUTLET 12 122 OUTLET3 MODEL
Appendix B: Equipment Setup Worksheet MODEL MODEL MODEL SERIAL NUMBER SERIAL NUMBER SERIAL NUMBER USE USE USE OUTLET 13 OUTLET 14 OUTLET 15 MODEL MODEL MODEL SERIAL NUMBER SERIAL NUMBER SERIAL NUMBER USE USE USE OUTLET 16 OUTLET 17 OUTLET 18 MODEL MODEL MODEL SERIAL NUMBER SERIAL NUMBER SERIAL NUMBER USE USE USE OUTLET 19 OUTLET 20 MODEL MODEL 123
Environmental Specifications SERIAL NUMBER SERIAL NUMBER USE USE Types of adapters _____________________________________________________________ Types of cables ________________________________________________________________ Name of software program ______________________________________________________ 124
Appendix C Using the CLP Interface This section explains how to use the Command Line Protocol (CLP) interface to administer a Dominion PX. In This Chapter About the CLP Interface ...............................................................................125 Logging into the CLP interface ....................................................................126 Showing Outlet Information ........................................................................127 Turning an Outlet On or Off ...............
Logging into the CLP interface Logging into the CLP interface Logging in via HyperTerminal and a serial connection is a little different than logging in using SSH or Telnet. Using HyperTerminal To log in using HyperTerminal: 126 1. Connect your PC to the Dominion PX serial port via a serial cable, launch HyperTerminal and open a console window. When the window first appears, it is blank. 2. Press Enter to display a Command prompt. 3. At the Command prompt, type clp and press Enter.
Appendix C: Using the CLP Interface 6. You are now logged into the CLP interface and can begin using the interface to administer the Dominion PX. Using SSH or Telnet To log in using SSH or Telnet: 1. Launch an SSH or Telnet client such as PuTTY and open a console window. A Login prompt appears. 2. Type a login name and press Enter. You are prompted to enter a password. 3. Type a password and press Enter. The password is case‐sensitive, so make sure you capitalize the correct letters.
Showing Outlet Information Syntax The following is the syntax for the show command: clp:/-> show /system1/outlet where is the number of the outlet. To display information for all outlets, type the wildcard asterisk (*) instead of a number. Attributes You can use the name and powerState attributes to filter the output of the show command. The name attribute displays only the name of the outlet, and the powerState attribute displays only the power state (on or off).
Appendix C: Using the CLP Interface Examples The following are examples of the show command. Example 1 -- No Attributes The following shows the output of the show command with no attributes entered. Example 2 -- Name Attribute The following shows the output of the show command with the name attribute. Example 3 -- powerState Attribute The following shows the output of the show command with the powerState attribute.
Turning an Outlet On or Off Turning an Outlet On or Off The set command turns an outlet on or off. Syntax The following is the syntax for the set command: clp:/-> set /system1/ powerState=on|off where the keyword on turns the outlet on and the keyword off turns the outlet off.
Appendix D Using SNMP This Appendix will help you set up 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..............................................................................................132 Configuring SNMP Traps.............................................................................
Enabling SNMP Enabling SNMP To communicate with an SNMP manager, you must first enable the SNMP agent on Dominion PX. This can be done from the SNMP Settings window: 132 1. Select Device Settings, and then select SNMP Settings. The SNMP Settings window appears. 2. Check the box for Enable SNMP Agent to enable the Dominion PX to communicate with external SNMP managers. A number of options will then become available. 3.
Appendix D: Using SNMP • Additionally, check Force Encryption to force using encrypted SNMP communication. 1. Type the SNMP MIBII sysLocation value in the System Location field. 2. Type the SNMP MIBII sysContact value in the System Contact field. 3. Click on the link at the bottom of the window to download an SNMP MIB for your Dominion PX to use with your SNMP manager. 4. Click Apply. The SNMP configuration is set.
Enabling SNMP Configuring Users for Encrypted SNMP v3 The SNMP v3 protocol allows for encrypted communication. To take advantage of this, users will need to have a Encryption Phrase,which acts as a shared secret between them and the Dominion PX. This encryption phrase can be set in the User Management page. 134 1. Choose User Management, then Users & Groups. The User/Group Management window appears. 2. Select the user profile you want to modify from the drop‐down list in the Existing Users field. 3.
Appendix D: Using SNMP 4. If you want to specify a different encryption phrase, uncheck this box, type the new phrase in the SNMP v3 Encryption Phrase field, then type it again in the Confirm SNMP v3 Encryption Phrase field. 5. Click Modify. The user is now setup for encrypted SNMP v3 communication. Configuring SNMP Traps Dominion PX automatically keeps an internal log of events that occur (refer to Setting Up Event Logging under the Using the Web interface chapter).
SNMP Gets and Sets 6. When SNMP logging is enabled, seven event types appear in the Event Log Assignments panel to the right. All are disabled by default. To enable any of these event types, check the appropriate checkboxes. 7. Click Apply. SNMP logging is configured. Note: You should re‐download the Dominion PX MIB after updating the unitʹs firmware. This will ensure your SNMP manager has the correct MIB for the release you are using.
Appendix D: Using SNMP The Dominion PX MIB This MIB is available from the SNMP Settings page, the Event Logging page, or by pointing your browser to http:///MIB.txt, where is the IP address of your Dominion PX. Layout Opening the MIB will reveal the custom objects that describe the Dominion PX system at the unit‐level as well as at the individual‐outlet‐ level. As standard, these objects are first presented at the beginning of the file, listed under their parent group.
SNMP Gets and Sets For example, the unitSensorsGroup group contains objects for sensor readings of the Dominion PX as a whole. One object listed under this group, unitCurrent, is described later in the MIB as ʺThe value for the unitʹs current sensor in millampsʺ‐‐the measure of the current drawn by Dominion PX. outletCurrent, part of the outletsGroup group describes the current passing through a specific outlet. NOTE: When performing an SNMP get, all current values are measured in milliamps (ma).
Appendix E Using the IPMI Tool Set The IPMI tool set is command‐line that allows users to display channel information, print sensor data, and set LAN configuration parameters. The following explains the available IPMI commands. Note: The open source IPMI tool can be downloaded from sourceforge, and compiled on Linux system .Then users can interact with Dominion PX via IPMI protocol through this tool. An example at the Linux command shell is given as: $ ipmitool ‐I lan ‐H 192.168.51.
Channel Commands Example $ ipmitool -I lan -H 192.168.51.58 -U admin -a channel authcap 14 5 Refer to the IPMI Privileges Levels section for additional information about IPMI privileges. info [channel number] Displays information about the selected channel. If no channel is given it will display information about the currently used channel: Example $ ipmitool -I lan -H 192.168.51.
Appendix E: Using the IPMI Tool Set getciphers [channel] Displays the list of cipher suites supported for the given application (ipmi or sol) on the given channel. Example $ ipmitool -I lan -H allen-dpxpcr20-20 -U admin -P raritan1 channel getciphers ipmi 14 Event Commands The Event commands allow you to send pre‐defined events to a Management Controller. Sends a pre‐defined event to the System Event Log.
LAN Commands file Event log records specified in filename will be added to the System Event Log. The format of each line in the file is as follows: <{EvM Revision} {Sensor Type} {Sensor Num} {Event Dir/Type} {Event Data 0} {Event Data 1} {Event Data 2}>[# COMMENT] Note: The Event Dir/Type field is encoded with the event direction as the high bit (bit 7) and the event type as the low 7 bits.
Appendix E: Using the IPMI Tool Set set Sets the given parameter on the given channel. Valid parameters are: • ipaddr Sets the IP address for this channel. • netmask Sets the netmask for this channel. • macaddr Sets the MAC address for this channel. • defgw ipaddr Sets the default gateway IP address. • defgw macaddr Sets the default gateway MAC address. • bakgw ipaddr
Sensor Commands The format of privlist is as follows. Each character represents a privilege level and the character position identifies the cipher suite number. For example, the first character represents cipher suite 1 (cipher suite 0 is reserved), the second represents cipher suite 2, and so on. privlist must be 15 characters in length.
Appendix E: Using the IPMI Tool Set thresh This allows you to set a particular sensor threshold value. The sensor is specified by name. Valid thresholds are: • unr Upper Non‐Recoverable • ucr Upper Critical • unc Upper Non‐Critical • lnc Lower Non‐Critical • lcr Lower Critical • lnr Lower Non‐Recoverable Example $ ipmitool -I lan -H allen-dpxpcr20-20 -U admin -P raritan1 sensor thresh "R.14 Current" unr 10.
OEM Commands Command Name Id Set Receptacle ACL 0x19 Get Receptacle ACL 0x1A Set Sensor Calibration 0x1B Test Actors 0x1C Test Sensors 0x1D Set Power Cycle Delay Command 0x1E Get Power Cycle Delay Command 0x1F Set Power Set Delay Command The global power on delay defines how much time has to pass between two power on actions. Request Data 1 delay in 1/10 seconds the delay is the minimum time after which a receptacle will be switched on after a previous receptacle has been switched on.
Appendix E: Using the IPMI Tool Set Request Data 1 # of receptacle [7 ‐ 5] reserved [4 ‐ 0] # of receptacle, 0 based, highest valid # depends on device model 2 new state [7 ‐ 1] reserved [0] 1b = power on, 0b = power off Response Data 1 Completion Code Get Receptacle State Command Request Data 1 # of receptacle [7 ‐ 5] reserved [4 ‐ 0] # of receptacle, 0 based, highest valid # depends on device model Response Data 1 Completion Code 2 current receptacle state and visual state [7] reserved [6]
OEM Commands Request Data 1 # of group [7 ‐ 5] reserved [4 ‐ 0] group #, valid numbers: 0 ‐ 23 2 new state [7 ‐ 1] reserved [0] 1b = power on, 0b = power off Response Data 1 Completion Code Set Group Membership Command Request Data 1 # of group [7 ‐ 5] reserved [4 ‐ 0] group #, valid numbers: 0 ‐ 23 2 [7 ‐ 1] reserved [0] 1b = enable group, 0b = disable group 3 [7] 1b = receptacle 7 belongs to group ... [0] 1b = receptacle 0 belongs to group 4 [7] 1b = receptacle 15 belongs to group ...
Appendix E: Using the IPMI Tool Set Request Data 1 # of group [7 ‐ 5] reserved [4 ‐ 0] group #, valid numbers: 0 ‐ 23 2 [7 ‐ 1] reserved [0] 1b = group is enabled, 0b = group is disabled 3 [7] 1b = receptacle 7 belongs to group ... [0] 1b = receptacle 0 belongs to group 4 [7] 1b = receptacle 15 belongs to group ... [0] 1b = receptacle 8 belongs to group 5 [7] 1b = receptacle 23 belongs to group ...
OEM Commands Request Data 1 # of group [7 ‐ 5] reserved [4 ‐ 0] group #, valid numbers: 0 ‐ 23 Response Data 1 Completion Code 2 delay in 1/10 seconds Set Receptacle ACL ACLs define who is authorized to change the state of a receptacle. ACLs will be stored for each individual outlet. A single ACL entry defines whether a certain user id or privilege level is allowed or denied to issue control commands for the outlet. ACL will be evaluated top to bottom, hence order of ACL entries is important.
Appendix E: Using the IPMI Tool Set Set Sensor Calibration Sensor calibration is only allowed for threshold based sensors that return a sensor reading byte with the Get Sensor Reading Command. Also not all threshold based sensors have capability to be calibrated. Request Data 1 Sensor number (ffh = reserved) 2 Actual sensor reading value Assumes, that at the time this command is executed a calibrated measurement is applied to this sensor.
IPMI Privilege Levels Request Data Response Data 1 # of receptacle (0xFF for global unit delay) 2 Delay (seconds), 1‐255 for unit and receptacle, 0 fallback to unit delay (receptacle only) 1 Completion Code Get Power Cycle Delay Command Request Data 1 # of receptacle (0xFF for global unit delay) Response Data 1 Completion Code 2 Delay (seconds), 1‐255, 0 if not set (receptacle only) Note: Values greater than 255 cannot be sent to the Dominion PX via IPMI.
Appendix F Event Types Event Type Examples Outlet Control Outlet(#) switched on by user Outlet(#) switched off by user Outlet(#) cycled by user Outlet/Unit/Environmental Sensors Assertion: Environmental Temperature (#) above upper non‐ critical threshold Deassertion: Environmental Temperature (#) above upper critical threshold User/Group Administration User added successfully User successfully changed User successfully deleted User password successfully changed Group added successfully Group success
IPMI Privilege Levels 154
Appendix G Specifications This appendix contains information describing: • DPX Serial RJ‐45 pinouts RJ-45 Pin/signal definition Pin No. Signal Direction Description 1 DTR Output Reserved 2 GND ― Signal Ground 3 +5V ― Power for CIM (200mA, fuse protected) • 4 TxD Output Transmit Data (Data out) 5 RxD Input Receive Data (Data in) 6 N/C N/C No Connection 7 GND ― Signal Ground 8 DCD Input Reserved DPX Feature RJ‐11 pinouts RJ-11 Pin/signal definition Pin No.
Index < • 141 1 1U Products • 4 1U Size • 2 2 2U Products • 5 2U Size • 3 A About the CLP Interface • 125 Add a Dominion PX Unit in Paragon II • 112 All Outlets Control • 38 Associate Outlets with a Target • 108, 113 Attributes • 128 authcap • 139 B Back Panel • 20 Beeper • 25 Before Beginning: • 8 Before You Begin • 10 Blue LED • 20 C Changing Your Password • 30 Channel Commands • 139 Check Power Strip Status • 116 Circuit Breaker • 24 CommandCente
Index Enabling SNMP • 132 Environmental Sensors • 72 Environmental Specifications • 120 Equipment Setup Worksheet • 11, 121 Event Commands • 141 Event Types • 153 Examples • 129 F file • 142 Fill Out the Equipment Setup Worksheet • 11 Forcing HTTPS Encryption • 49, 59 Front Panel • 19 G get ...
Index Q Querying an Outlet Sensor • 130 R Rack Mount Safety Guidelines • 6 Rack‐Mounting the Dominion PX • 6 Refresh • 35 Reset to Defaults • 35 Resetting the Dominion PX • 99 Resetting to Factory Defaults • 16, 23 S Safety Guidelines • iii Sensor Commands • 144 set • 143 Set Group Membership Command • 148 Set Group Power On Delay Command • 149 Set Group State Command • 147 Set Power Cycle Delay Command • 151 Set Power Set Delay Command • 146 Set Receptacle ACL • 150 Set Receptacle
¾ U.S./Canada/Latin America Monday ‐ Friday 8 a.m. ‐ 8 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: tech@raritan.com ¾ China Beijing Monday ‐ Friday 9 a.m. ‐ 6 p.m. local time Phone: +86‐10‐88091890 Shanghai Monday ‐ Friday 9 a.m. ‐ 6 p.m.