Attempting to power non-rated devices may result in electric shock, fire, personal injury and death. WARNING! Do not use a Legrand product containing outlet relays to power large inductive loads such as motors or compressors. Attempting to power a large inductive load may result in damage to the relay.
Tip 1: The outlet (socket) shall be installed near the equipment and shall be easily accessible. Tip 2: For detailed information on any Legrand PDU's overcurrent protectors' design, refer to that model's PDU Product Selector page product specification on Raritan website's https://www.raritan.com/product-selector.
Initial Installation and Configuration Connecting the PDU to a Power Source................23 Connecting the Legrand PDU to Your Network ..............23 USB Wireless LAN Adapters ......................24 Supported Wireless LAN Configuration ................... 24 ...
Page 7
Bulk Configuration Methods ....................31 Cascading Multiple Legrand PDUs for Sharing Ethernet Connectivity ......... 32 Cascading All Devices via USB ....................... 33 Extended Cascading with Legrand PDUs..................35 Restrictions of Port-Forwarding Connections .................. 37 ...
Page 8
Setting Your Preferred Measurement Units ................... 137 Setting Default Measurement Units ....................137 Device Settings ........................139 Configuring Network Settings ......................140 Configuring Network Services ....................... 158 Configuring Security Settings ......................165 viii Legrand PDU User Guide...
Page 9
Device Information......................... 231 Viewing Connected Users ......................235 Viewing or Clearing the Local Event Log ..................236 Updating the Legrand PDU Firmware.................... 237 Viewing Firmware Update History....................238 Bulk Configuration ......................... 239 Backup and Restore of Device Settings ..................243 ...
Page 10
Command History .......................... 290 Reliability Data..........................290 Reliability Error Log ........................291 Examples ............................291 Clearing Information ......................292 Clearing Event Log ........................292 Clearing WLAN Log ........................293 Legrand PDU User Guide...
Page 12
Configuration Files ......................403 fwupdate.cfg ..........................404 config.txt ............................406 devices.csv ............................ 408 Creating Configuration Files via Mass Deployment Utility ............. 408 Data Encryption in 'config.txt'......................409 xii Legrand PDU User Guide...
Page 13
Step A. Determine User Accounts and Roles ..............431 Step B. Configure User Groups on the AD Server.............. 431 Step C. Configure LDAP Authentication on the Legrand PDU ........... 432 Step D. Configure Roles on the Legrand PDU ..............433 ...
Page 14
AD-Related Configuration ....................466 Additional Legrand PDU Information Reserving IP Addresses in DHCP Servers ................. 470 Reserving IP in Windows....................... 471 Reserving IP in Linux........................472 Sensor Threshold Settings....................473 Thresholds and Sensor States ...................... 473 ...
APIPA and Link-Local Addressing............16 Before You Begin..................16 Available Legrand PDU Models This User Guide mainly introduces two types of Legrand PDU models, both of which are inlet metered PDUs. Legrand PDUs comparison in brief: Inlet power Outlet...
(on page 30). The Legrand PDU previously obtained an IP address from the DHCP server, but the lease of this IP address has expired, and the lease cannot be renewed, or no new IP address is available. Link-local addressing: ...
Technical Support Department for assistance. 4. Verify that all circuit breakers on the Legrand PDU are set to ON. If not, turn them ON. Or make sure that all fuses are inserted and seated properly. If there are any fuse covers, ensure that they are closed.
If a rack is subject to shock in environments such as boats or airplanes, the PDU CANNOT be mounted upside down. If installed upside down, shock stress reduces the trip point by 10%. Note: If normally the line cord is down, upside down means the line cord is up.
Press button into bracket hole and turn with finger. 250-70-0141-00: bracket (2) Mount by positioning the PDU at the rack, then pressing the buttons through the holes in the cabinet and letting the PDU drop down slightly.
Release the buttons when the hooks are in position securely through the bracket. Mount by positioning the PDU at the rack, then tilting the PDU to press the hooks through the holes in the rack. Then set the PDU back to level to engage the hooks.
Parts: of the PDU with 4 screws. Brackets (2) and screws Mount by positioning the PDU at the rack, then attaching the bracket "ears" to the rack with 2 screws in holes provided on each ear. Legrand PDU User Guide...
Locking Outlets Not every Legrand PDU is implemented with locking outlets. Locking outlets, if available, on the Legrand PDU help secure the connection of power cords from your IT equipment to the PDU. A locking outlet has a button on it. Such outlets do not require any special power cords to achieve the locking purpose.
(LAN). Legrand PDU can be connected to a wired or wireless network. Note: If your Legrand PDU will work as a master device in the bridging mode, you must make a wired Cascading Multiple Legrand PDUs for Sharing Ethernet Connectivity connection.
Connect a USB hub to the USB-A port on the Legrand PDU. Then plug the supported USB wireless LAN adapter into the appropriate USB port on the hub. (on page 24) for a list of supported wireless LAN adapters.
1. Connect the Legrand PDU to a computer. See (on page Connecting the Legrand PDU to a Computer 30). 2. Use the connected computer to configure the Legrand PDU via the command line or web interface. Command line interface: See (on page 486).
(on page 31). Connecting a Mobile Device to Legrand PDU Raritan's PDView is a free app that turns your iOS or Android mobile device into a local display for Legrand PDU. PDView is especially helpful when your Legrand PDU is not connected to the network but you need to check the Legrand PDU status, retrieve its information, or change its settings.
Page 27
1. Launch the PDView app from your mobile device. Below illustrate iPad's PDView screens. a. The "Disconnected" message displays first when PDView has not detected the Legrand PDU yet. A diagram in PDView indicates the appropriate USB port your mobile device should connect according to your mobile operating system.
Page 28
To save user credentials in PDView: 1. Make sure your mobile device is NOT connected to the Legrand PDU so that PDView does NOT perform the automatic login feature after it is launched. 2. Launch PDView on your mobile device.
Page 29
3. Tap the top-right icon (iOS) or (Android). 4. The user credentials setup page opens. 5. Type the desired user credentials, and tap Save. Legrand PDU User Guide...
To use the command line interface (CLI) for configuration, establish an RS-232 or USB connection. To use a web browser for configuration, make a network connection to the computer. The Legrand PDU is automatically configured with the following link-local addressing in any network without DHCP available: ...
1 (Not connected) 9 (Not connected) Bulk Configuration Methods If you have to set up multiple Legrand PDUs, you can use one of the following configuration methods to save your time. A bulk configuration file downloaded from Legrand PDU: ...
Cascading Multiple Legrand PDUs for Sharing Ethernet Connectivity You can have multiple Legrand PDUs share one Ethernet connection by cascading them via one of the interfaces below: USB interface Ethernet interface The first one in the cascading chain is the master device and all the other are slave devices. Only the master device is physically connected to the LAN -- wired or wireless.
Slave 2 Slave 3 To cascade Legrand PDUs via USB: 1. Make sure all of Legrand PDUs are running firmware version 3.4.11 or later. 2. Choose the appropriate one as the master device. When the Port Forwarding mode over "wireless LAN" is intended, the master device must be a Raritan product with two USB-A ports, such as PX3, EMX2-888, PX3TS or BCM2.
Page 34
(on page 24). USB Wireless LAN Adapters 5. Connect the USB-A port of the master device to the USB-B port of an additional Legrand PDU via a USB cable. This additional device is Slave 1. 6. Connect Slave 1's USB-A port to the USB-B port of an additional Legrand PDU via another USB cable.
(on page 37). Restrictions of Port-Forwarding Connections You can mix Ethernet and USB cascading in the Legrand PDU chain if preferred. The following diagram illustrates such a chain. The distance between two Ethernet-cascaded devices can be up to 100 meters, while the distance between two USB-cascaded devices supports up to 5 meters only.
Page 36
(on page 24). USB Wireless LAN Adapters 5. Connect the available Ethernet port of the master device to either Ethernet port of another Legrand via a standard network patch cable. This additional Legrand device is Slave 1. 6. Connect Slave 1's available Ethernet port to either Ethernet port of another Legrand via a standard network patch cable.
The following diagrams illustrate cascading connections that are NOT supported. UNSUPPORTED connections: One cascaded device has two upstream devices via Ethernet cables. One cascaded device has two upstream devices via Ethernet and USB cables. Legrand PDU User Guide...
Page 38
One cascaded device has two downstream devices. One device is connected to another device via two cascading cables - USB and Ethernet cables. 38 Legrand PDU User Guide...
Identifying the Sensor Port Warning: If you purchase Raritan's environmental sensor packages, make sure you connect them to the correct port on the Legrand PDU, or damages may be caused to the Legrand PDU and/or connected sensor packages. How to identify the SENSOR port: ...
To directly connect a DPX with a factory-installed sensor cable: An RJ-12 to RJ-45 adapter is required to connect a DPX sensor package to Legrand PDU. a. Connect the adapter's RJ-12 connector to the DPX sensor cable.
Page 41
Using an Optional DPX-ENVHUB4 Sensor Hub Optionally, you can connect a Raritan DPX-ENVHUB4 sensor hub to the Legrand PDU. This allows you to connect up to four DPX sensor packages to the Legrand PDU via the hub. This sensor hub supports DPX sensor packages only. Do NOT connect DPX2, DPX3 or DX sensor packages to it.
Page 42
Connect the adapter's RJ-45 connector to the RJ-45 SENSOR port on the Legrand PDU. 2. The cable has two RJ-12 sensor ports. Connect DPX sensor packages to the cable's sensor ports. 3. Repeat the above steps if there are additional SENSOR ports on your Legrand PDU.
Page 43
The sum of a DPX-T3H1 sensor cable's length is 16' (5 m). The total cabling length between the Legrand PDU and one DPX-T3H1 is 49' (15 m) as illustrated below. Note that the length 16' (5 m) is the length of each DPX-T3H1 sensor cable, which is defined in the above diagram.
NOT work properly. Therefore, always occupy all head connectors prior to the final sensor package with a DPX2 sensor package. To connect DPX2 sensor packages to the Legrand PDU: 1. Connect a DPX2 sensor package to the first head connector of the DPX2 sensor cable.
NO free head connectors prior to the final DPX2 sensor package attached. 3. Use an RJ-12 to RJ-45 adapter to connect the DPX2 sensor package(s) to the Legrand PDU. a. Connect the adapter's RJ-12 connector to the DPX2 sensor cable.
Page 46
Repeat the same steps to cascade more DPX3 sensor packages. 3. Connect the first DPX3 sensor package to the Legrand PDU by plugging its cable's connector into the RJ-45 SENSOR port of the Legrand PDU. Connecting a DPX2 Sensor Package to DPX3 You can connect only one DPX2 sensor package to the "end"...
For example, if you cascade 12 DX packages, and each package contains 3 functions (a function is a sensor or actuator), the Legrand PDU does NOT manage the last 4 functions because the total 36 (12*3=36) exceeds 32 by 4.
Page 48
Exception: You CANNOT cascade DX-PD2C5 sensor packages. A Legrand PDU supports only one DX-PD2C5. 3. Connect the first DX sensor package to the Legrand PDU by plugging its cable's connector into the RJ-45 SENSOR port of the Legrand PDU. 4. If needed, connect a DPX2 sensor package to the end of the DX chain. See Connecting a DPX2 (on page 48).
Using an Optional DPX3-ENVHUB4 Sensor Hub A Raritan DPX3-ENVHUB4 sensor hub is physically and functionally similar to the DPX-ENVHUB4 sensor hub, which increases the number of sensor ports for the Legrand PDU, except for the following differences: All ports on the DPX3-ENVHUB4 sensor hub are RJ-45 instead of RJ-12 as the DPX-ENVHUB4 sensor hub.
Mixing Diverse Sensor Types You can mix DPX, DPX2, DPX3, DX and DX2 sensor packages on one Legrand PDU according to the following sensor combinations. In some scenarios, the DPX3-ENVHUB4 sensor hub is required. The Legrand PDU does NOT support any other sensor-mixing combinations than those described in this section.
Page 51
The sensor package in "blue" can be one DPX2, DPX3 or DX sensor package. This section only illustrations the following three combinations, but actually there are tens of different combinations by using the DPX3-ENVHUB4 sensor hub. Legrand PDU User Guide...
Page 53
You can add a DPX2 sensor package to the end of such a sensor-mixing chain if intended. See Connecting (on page 46) or (on page a DPX2 Sensor Package to DPX3 Connecting a DPX2 Sensor Package to DX 48). Legrand PDU User Guide...
Tip: You can easily find a list of UVC-compliant webcams on the Internet. The Legrand PDU supports up to two webcams. You can use a "powered" USB hub to connect webcams if needed. After connecting a webcam, you can retrieve visual information from anywhere through the Legrand PDU web interface.
Legrand PDU for appropriate input ratings or range of ratings. There is no power switch on the Legrand PDU. To power cycle the PDU, unplug it from the branch circuit, wait 10 seconds and then plug it back in.
USB-B Cascading Legrand PDUs for sharing a network connection. See (on page 33). Cascading All Devices via USB Establishing a USB connection between a computer and the Legrand PDU for: Using the command line interface. Performing the disaster recovery. Contact Legrand Technical Support for instructions.
(on page 35). Extended Cascading with Legrand PDUs Note: Connection to this port is not required if wireless connection is preferred, or if the Legrand PDU is a slave device in the cascading Cascading Multiple Legrand PDUs for Sharing configuration. See Ethernet Connectivity (on page 32).
Page 58
You can use the LCD display to view the Legrand PDU information and even switch an outlet. It consists of: A dot-matrix LCD display Four control buttons Zero U models automatically adjust the orientation of the content shown on the dot-matrix LCD display after detecting the direction in which the PDU is installed.
Page 59
Enter manual mode when you want to operate the dot-matrix LCD display. You can use the dot-matrix LCD display to: Show information of the Legrand PDU, built-in components, or connected peripheral devices Control outlets if your model supports outlet-switching ...
Page 60
Control buttons that can be used and the system time are shown at the bottom of the LCD display. If any alerts exist, the top and bottom bars on the LCD display change the color from black to yellow or red. (on page 59). Operating the Dot-Matrix LCD Display 60 Legrand PDU User Guide...
Page 61
Alerts Alerts Shows the internal beeper's state, and, if it is on, the reason for turning If your Legrand PDU has multiple inlets, this menu item also shows the total active power and total active energy. (on page 62). Shows the inlet I1's information. See (on page 63).
Page 62
3. Press to view additional pages. When there are multiple pages, page numbers appear in the top-right corner of the display. You can configure the following feature with the "PDU" menu command. Energy pulse output settings This feature, once enabled, blinks the energy pulse LED proportional to the energy consumption. For this LED's location, see (on page 76).
Page 63
"Inlet I1" in the Main Menu, and press 2. The first page shows the inlet's active power (W), apparent power (VA), power factor (PF), and active energy (Wh). 3. To go to other page(s), press Legrand PDU User Guide...
Page 64
"OCPs" in the Main Menu, and press 2. The LCD display shows a list of overcurrent protectors similar to the following diagram. Number Description Overcurrent protector names. Associated lines and rated current are displayed below each overcurrent protector's name. 64 Legrand PDU User Guide...
Page 65
Show each outlet's information. Turn on, off or power cycle an individual outlet if your Legrand PDU is outlet-switching capable. To do this, you must first enable the front panel outlet control function. See (on page Front Panel Settings 224).
Page 66
4. The power control page opens. A submenu similar to the following diagram appears. Note: The submenu is not available when the front panel outlet control is disabled. If so, a message "Front-panel outlet control is disabled" is displayed. 66 Legrand PDU User Guide...
Page 67
Main Menu is shown. Peripherals If there are no Raritan environmental sensor packages connected to your Legrand PDU, the LCD display shows the message "No managed devices" for the "Peripherals" menu command. If you have enabled the front panel actuator control function, you can switch on or off a connected actuator using the LCD display.
Page 68
Upper Warning = above upper warning Upper Critical = above upper critical On Off A numeric sensor shows both the reading and state. A state sensor or actuator shows the state only. 68 Legrand PDU User Guide...
Page 69
Port <N>: <N> is the number of the sensor port where this sensor or actuator is connected. This number is always 1 for Legrand PDU. Chain Pos. <n>: <n> is the sensor or actuator's position in a sensor daisy chain.
Page 70
The display shows the device's information, network and IPv4/IPv6 settings through various pages. Page numbers are indicated in the top-right corner of the LCD display. To show the device information: 1. Press to select "Device Info" in the Main Menu, and press 70 Legrand PDU User Guide...
Page 71
2. Device information similar to the following diagram displays. Number Description Device name. Firmware version, model name and serial number. Device ratings, including rated voltage, frequency, current and power. 3. Press to show the Network Common page. Number Description DNS servers. Default gateways. Legrand PDU User Guide...
Page 72
Cascade Position: Indicates the position of a slave device in the Port Forwarding mode. 1 represents Slave 1, 2 represents Slave 2, and so on. A port forwarding slave device will also display the master device's IP address on this page. 72 Legrand PDU User Guide...
Page 73
5. Press to show the Ethernet pages. A Legrand PDU has two Ethernet pages -- ETH1 and ETH2. Number Description Ethernet interface information, including: MAC address. Speed. Full or half duplex. IPv4/IPv6 network information, including: Network configuration: DHCP (or Automatic), or Static. Static represents Static IP.
Page 74
If a supported WLAN adapter is detected and configured properly, wireless network information is shown instead, including: MAC address SSID IPv4/IPv6 network information -- for detailed explanation, refer to number 7. To return to the Main Menu, press 74 Legrand PDU User Guide...
Page 75
The final time that each alerted sensor changed its readings or states. Next steps: To view details of all alerted sensors, press . If the detailed information exceeds one page, press to switch between pages. To return to the Alerts Notice screen, press Legrand PDU User Guide...
The reset button is located inside the small hole near the display panel on the PDU. Pressing this reset button restarts the software of Legrand PDU without any loss of power to outlets. The Legrand PDU can be reset to its factory default values using this button when a serial connection is available. See (on page 429).
1. Locate the breaker whose ON button is up, indicating that the breaker has tripped. 2. Examine your Legrand PDU and the connected equipment to remove or resolve the cause that results in the overload or short circuit. This step is required, or you cannot proceed with the next step.
Page 78
3. Examine your Legrand PDU and the connected equipment to remove or resolve the cause that results in the overload or short circuit. This step is required, or you cannot proceed with the next step. 4. Pull up the operating handle until the colorful rectangle or triangle turns RED.
iOS 7.0 and later Login, Logout and Password Change The first time you log in to the Legrand PDU, use the factory default "admin" user credentials. For details, refer to the Quick Setup Guide accompanying the product. After login, you can create user accounts for other users. See (on page 130).
Page 80
Note: To configure the security agreement, see (on page 181). 4. Click Login or press Enter. The web interface of Legrand PDU opens. Depending on your hardware configuration, your web interface shown onscreen may look slightly different from the image below.
Creating Roles (on page 135). 1. Choose User Management > Change Password. 2. First type the current password, and then the new password twice. Passwords are case sensitive. A password comprises 4 to 64 characters. Legrand PDU User Guide...
Legrand PDU does NOT support other browser password managers. Logout After finishing your tasks, you should log out to prevent others from accessing the Legrand PDU web interface. To log out without closing the web browser: ...
Page 83
- Logout button. From top to bottom -- Your Legrand PDU model. Current firmware version. Online Documentation: link to the online help of Legrand PDU. - See (on page 494). Browsing through the Online Help Legrand PDU User Guide...
Legrand PDU system time, which is converted to the time zone of your computer or mobile device. - Click Device Time to open the Date/Time setup page. Menu Depending on your model and hardware configuration, your Legrand PDU may show all or some menu items shown below. Menu Information shown...
Page 85
SmartLock Either or both menu items appear when you connect the equipment -- and/or -- included in a Raritan's SmartLock kit to Legrand PDU. For details, refer to Card Readers the user documentation accompanying the SmartLock kit or download it from Legrand's (http://www.raritan.com/support/).
Quick Access to a Specific Page If you often visit a specific page in the Legrand PDU web interface, you can note down its URL or bookmark it with your web browser. Next time, you just enter its URL in the address bar of the browser prior to login.
5. The arrow now appears adjacent to the selected column 'Event Class,' indicating the list is sorted in the ascending order based on that column. Dashboard The Dashboard page contains four to five sections, depending on your model. Legrand PDU User Guide...
Page 88
- red: critical (on page 89). Dashboard - Inlet I1 Overcurrent This section is available only when your Legrand PDU contains Protectors overcurrent protectors (OCPs). Overview of each OCP's status A current bar per OCP, which changes colors to indicate the...
Active power (kW or W) Apparent power (kVA or VA) Active energy (kWh or Wh) Power factor Line frequency (Hz) Unbalanced current (%) - model dependent Right side - inlet's current and voltage: Legrand PDU User Guide...
OCP data from top to bottom includes: RMS current (A), and rated current Smaller gray text adjacent to RMS current is each OCP's rated current, such as "16A" shown in the above diagram. 90 Legrand PDU User Guide...
However, it is not meaningful to enable the two thresholds for current levels. Dashboard - Alerted Sensors When any internal sensors or environmental sensor packages connected to the Legrand PDU enter an abnormal state, the Alerted Sensors section in the Dashboard show them for alerting users. This section also lists tripped circuit breakers or blown fuses, if available.
You can have it show the chart of other inlet power data. Simply select a different data type by clicking the selector below the diagram. Available data types include: RMS current RMS voltage Active power Apparent power 92 Legrand PDU User Guide...
Reason column occurred for the first time. Last Appearance Date and time when the event indicated in the Reason column occurred for the last time. Count Number of times the event indicated in the Reason column has occurred. Legrand PDU User Guide...
Tip: The date and time shown on the Legrand PDU web interface are automatically converted to your computer's time zone. To avoid any time confusion, you can apply the same time zone settings as those of Legrand PDU to your computer.
Page 95
Customizes the device name. After removing power from the *Outlet state on Determines the initial power state of PDU, you must wait for a minimum device startup ALL outlets after the Legrand PDU of 10 seconds before powering it powers up.
To reset ALL active energy counters: An active energy reading is a value of total accumulated energy, which is never reset, even if the power fails or the Legrand PDU is rebooted. However, you can manually reset this reading to restart the energy accumulation process.
For example, if the inrush guard delay is set to 100 milliseconds and two or more outlets are turned on at the same time, the PDU will sequentially turn the outlets on with a 100 millisecond delay occurring between each one.
(on page 94). After enabling the automatic management function: When the total number of managed sensors and actuators has not reached the upper limit yet, Legrand PDU automatically brings newly-connected environmental sensors and actuators under management after detecting them.
Page 99
Per default, there are pre-defined RMS voltage and current threshold values in related fields. See Default (on page 479). You can modify them to meet your needs. Voltage and Current Thresholds 1. Click the Thresholds title bar at the bottom of the page to display inlet thresholds. Legrand PDU User Guide...
(on page 84). Menu On this page, you can: View all outlets' status. Each outlet's data is displayed, such as receptacle type and outlet lines. On an outlet-switching capable model, each outlet's power state is also shown. Legrand PDU User Guide...
Page 101
Available Data of the Outlets (on page 103). Overview Page Only Legrand Switched PDUs support all of the following features while Legrand Metered PDUs do NOT support them. To configure global outlet settings or perform the load-shedding command: 1. Click to show a list of commands.
Page 102
(on page 107). 5. When performing any outlet-switching operation, a 'Sequence running' message similar to the following displays before the outlet-switching process finishes. It indicates how many selected outlets are NOT switched on/off or cycled yet. Legrand PDU User Guide...
The outlet is a critical outlet, which will remain unchanged in the load shedding mode. Outlets Note: To set critical and non-critical outlets, go to (on page 100). Receptacle type Lines associated with each outlet Legrand PDU User Guide...
In addition, you can make a delay occur between two outlets that are turned on consecutively. For example, if the power-on sequence is Outlet 1 through Outlet 8, and you want the Legrand PDU to wait for 5 seconds before turning on Outlet 4, after Outlet 3 is turned on, assign a delay of 5 seconds to Outlet 3.
(on page 107). Load Shedding Mode When a UPS supplying power to Legrand PDU switches into battery backup operation, it may be desirable to switch off non-critical outlets to conserve UPS battery life. This feature is known as load shedding.
Page 106
TIP -- automatic load shedding via contact closure sensors: If you have connected a Raritan contact closure sensor to Legrand PDU, you can set up an event rule in a manner that this sensor's status change automatically activates or deactivates the load shedding mode. For an example, see (on page 216).
In addition, you can perform the following operations on this outlet page. Note that only outlet-switching capable models show the power-control buttons, and you must have the Switch Outlet permission to perform outlet-switching operations. Therefore, only Legrand Switched PDUs support the following power-control operation.
Page 108
Type an outlet name up to 64 characters long. *State on device Click this field to select this outlet's initial power startup state after Legrand PDU powers up. Options: on, off, last known and PDU defined. See Options for Outlet State on (on page 96). Startup Note that any option other than "PDU...
Page 109
This outlet's receptacle type Lines Lines associated with this outlet Inlet Inlet associated with this outlet Overcurrent Protector This information is available only when your Legrand PDU has overcurrent protectors. Overcurrent protector associated with this outlet Legrand PDU User Guide...
Time Units OCPs The OCPs page is available only when your Legrand PDU has overcurrent protectors, such as circuit breakers. The OCPs page lists all overcurrent protectors as well as their status. If any OCP trips or its current level enters the alarmed state, it is highlighted in red or yellow.
Page 111
OCP thresholds, when enabled, help you identify the OCP whose RMS current enters the warning or critical level with the yellow or red color. In addition, you can have Legrand PDU automatically generate alert notifications for any warning or critical status. See (on page 184).
Protected Outlets Outlets associated with this OCP. Inlet Inlet associated with this OCP. This information is useful only when your PDU has multiple inlets. RMS current This OCP's current state and readings, including current drawn and current remaining. To customize this OCP's name: 1.
Page 113
Note: The threshold values set for an individual OCP will override the bulk threshold values stored on that OCPs particular OCP. To configure thresholds for multiple OCPs at a time, see (on page 110). 1. Click the Thresholds title bar at the bottom of the page to display the threshold data. Legrand PDU User Guide...
Page 114
To enable any threshold, select the corresponding checkbox. Type a new value in the accompanying text box. For concepts of thresholds, deassertion hysteresis and assertion timeout, see Sensor Threshold (on page 473). Settings 4. Click Save. Legrand PDU User Guide...
Page 115
You can go to another OCP's data/setup page by clicking the OCP selector on the top-left corner. You can go to the associated Inlet's data page by clicking the Inlet link in the Details section. Legrand PDU User Guide...
Peripherals If there are Raritan environmental sensor packages connected to the Legrand PDU, they are listed on the Peripherals page. See (on page 39). Connecting Raritan Environmental Sensor Packages An environmental sensor package comprises one or some of the following sensors/actuators: ...
Page 117
(on page 120). An actuator is never highlighted. Sensors Column Description Name By default the Legrand PDU assigns a name comprising the following two elements to a newly-managed sensor/actuator. Sensor/actuator type, such as "Temperature" or "Dry Contact." Sequential number of the same sensor/actuator type, like 1, 2, 3 and so on.
Page 118
Note that any changes made to default threshold settings not only re-determine the initial threshold values that will apply to newly-added sensors but also the threshold values of the already-managed sensors where default thresholds are being applied. See (on page 125). Individual Sensor/Actuator Pages 1. Click > Default Threshold Setup. Legrand PDU User Guide...
Page 119
1. Select one or multiple actuators which are in the same status - on or off. To select multiple actuators, click to make checkboxes appear and then select desired actuators. 2. Click the desired button. : Turn ON. : Turn OFF. Legrand PDU User Guide...
(on page 224). Yellow- or Red-Highlighted Sensors The Legrand PDU highlights those sensors that enter the abnormal state with a yellow or red color. Note that numeric sensors can change colors only after you have enabled their thresholds. Tip: When an actuator is turned ON, it is also highlighted in red for drawing attention.
"unavailable" for its reading. Unmanaged sensors/actuators: Legrand PDU does NOT communicate with unmanaged sensors/actuators so their data is not retrieved. Unmanaged sensors/actuators are listed only when they are physically connected to Legrand PDU.
Legrand PDU but not managed yet. Note: Unmanaged sensors or actuators will disappear from the web interface after they are no longer Peripherals physically connected to the Legrand PDU. To manage a sensor/actuator, go to (on page 116). Finding the Sensor's Serial Number A DPX environmental sensor package includes a serial number tag on the sensor cable.
A DPX2, DPX3, DX or DX2 sensor package has a serial number tag attached to its rear side. The serial number for each sensor or actuator appears listed in the web interface after each sensor or actuator is detected by the Legrand PDU. Match the serial number from the tag to those listed in the sensor table.
ID number to it by following the procedure below. To release any one, Peripherals (on page 116). To manage only one sensor/actuator: 1. From the list of "unmanaged" sensors/actuators, click the one you want to manage. 2. The "Manage peripheral device" dialog appears. Legrand PDU User Guide...
To let Legrand PDU randomly assign an ID number to it, select "Automatically assign a sensor number." This method does not release any managed sensor or actuator. To assign a desired ID number, select "Manually select a sensor number." Then click to select an ID number.
Page 126
Tip: The date and time shown on the Legrand PDU web interface are automatically converted to your computer's time zone. To avoid any time confusion, you can apply the same time zone settings as those of Legrand PDU to your computer.
Page 127
This field is available for the DX-PIR presence detector only. Normal Delay It determines the wait time before the Legrand PDU announces that the presence detector is back to normal after it already returns to normal. Adjust the value in seconds.
Page 128
To turn on or off an actuator: 1. Click the desired control button. : Turn ON. : Turn OFF. 2. Confirm the operation on the confirmation message. An actuator's state is marked in red when it is turned on. Legrand PDU User Guide...
Z: When the Z coordinate format is set to Rack Units, it can be any number ranging from 0 to 60. When its format is set to Free-Form, it can be any alphanumeric value comprising 0 to 24 characters. See (on page 94). Legrand PDU User Guide...
You cannot delete 'admin' or change its permissions, but you can and should change its password. A "role" determines the tasks/actions a user is permitted to perform on the Legrand PDU so you must assign one or multiple roles to each user.
Page 131
Note that you must enter information in the fields showing the message 'required.' User information: Field/setting Description User Name The name the user enters to log in to the Legrand PDU. 4 to 32 characters Case sensitive ...
Page 132
DES (default) AES-128 Preferences: This section determines the measurement units displayed in the web interface and command line interface for this user. Field Description Temperature Unit Preferred units for temperatures -- (Celsius) (Fahrenheit). Legrand PDU User Guide...
Change Own Password Change Pdu, Inlet, Outlet & Overcurrent Protector Configuration Switch Outlet (if your Legrand PDU is outlet-switching capable) View Event Settings View Local Event Log Note: With multiple roles selected, a user has the union of all roles' permissions.
Page 134
Refer to the above procedure. 2. Select one or multiple users. To select all roles, except for the admin user, select the topmost checkbox in the header row. 3. Click 4. Click Delete on the confirmation message. Legrand PDU User Guide...
View Event Settings View Local Event Log If the two do not satisfy your needs, add new roles. Legrand PDU supports up to 64 roles. To create a role: 1. Choose User Management > Roles > 2. Assign a role name.
1. On the Roles page, click the desired role. The Edit Role page opens. 2. Make changes as needed. The role name cannot be changed. To delete this role, click , and confirm the operation. 3. Click Save. Legrand PDU User Guide...
4. Click Delete on the confirmation message. Setting Your Preferred Measurement Units You can change the measurement units shown in the Legrand PDU user interface according to your own preferences regardless of the permissions you have. Tip: Preferences can also be changed by administrators for specific users on the Edit User page. See Editing or Deleting Users (on page 133).
Page 138
Creating Users Web interface for users who are authenticated via LDAP/Radius servers. The sensor report triggered by the "Send Sensor Report" action. See (on page Send Sensor Report 201). Front panel LCD display. Legrand PDU User Guide...
Changing SSH Settings Telnet (on page 163) Changing Telnet Settings Modbus (on page 163) Changing Modbus Settings Server Advertising (on page 164) Enabling Service Advertising Security IP Access Control (on page 165) Creating IP Access Control Rules Legrand PDU User Guide...
Legrand PDU to your network You can enable both the wired and wireless networking on Legrand PDU so that it has multiple IP addresses -- wired and wireless IP. For example, you can obtain one IPv4 and/or IPv6 address by enabling one Ethernet interface, and obtain one more IPv4 and/or IPv6 address by enabling/configuring the wireless interface.
Page 141
Network Settings You must connect a USB wireless LAN adapter to the Legrand PDU for wireless networking. Note: If the device's cascading mode is set to 'Bridging' or its role is set to 'Slave' in the port forwarding mode, the wireless settings will be disabled.
Page 142
If any static DNS server is specified in these fields, it will override the DHCP-assigned DNS server. If DHCP (or Automatic) is selected for IPv4/IPv6 settings, and there are NO static DNS servers specified, the Legrand PDU will use DHCP-assigned DNS servers. Legrand PDU User Guide...
Page 143
Show the LAN's current status, including the Current State current speed and duplex mode. Note: Auto-negotiation is disabled after setting both the speed and duplex settings of the Legrand PDU to NON-Auto values, which may result in a duplex mismatch. Legrand PDU User Guide...
Page 144
Enable or disable the wireless interface. When disabled, the wireless networking fails. Hardware State Check this field to ensure that the Legrand PDU has detected a wireless USB LAN adapter. If not, verify whether the USB LAN adapter is firmly connected or whether it is supported.
Page 145
TLS certificate verify the validity of the TLS certificate that will be chain installed. For example, the Legrand PDU will check the certificate's validity period against the system time. Click this button to import a certificate file. Then you can: ...
Page 146
Wireless LAN Diagnostic Log Wireless LAN Diagnostic Log The Legrand PDU provides a diagnostic log for inspecting connection errors that occurred over the wireless network interface. The information is useful for technical support. Note that the WLAN Diagnostic Log shows data only after the Network Interface is set to Wireless.
Page 147
4. If wanted, you can resort the list by clicking the desired column header. See (on page 86). Sorting a List To clear the diagnostic log: 1. On the top-right corner of the log, click > 2. Click Clear Log on the confirmation message. Legrand PDU User Guide...
Page 148
(NIC) have been installed in one network server, leading to two available subnets, and IP forwarding has been enabled. All of the NICs and Legrand PDUs in the examples use static IP addresses. Most of local multiple networks are not directly reachable and require the use of a gateway. Therefore, we will select Gateway in the following examples.
Page 149
Prefix length: 64 In this example, NIC-2 (fd07:2fa:6cff:2405::80) is the next hop router for your Legrand PDU to communicate with any device in the other subnet fd07:2fa:6cff:1111::0. In the IPv6 "Static Routes" section, you should enter the data as shown below. Note that the address in the first field must be of the Classless Inter-Domain Routing (CIDR) notation.
Page 150
When another wireless network is connected to WIRELESS your Legrand PDU, select this interface name. Setting the Cascading Mode A maximum of 16 Legrand PDUs can be cascaded to share one Ethernet connection. See Cascading (on page 32). Multiple Legrand PDUs for Sharing Ethernet Connectivity The cascading mode configured on the master device determines the Ethernet sharing method, which is either network bridging or port forwarding.
Page 151
You can "loop" a cascading chain to create network communication redundancy (Bridging mode only), but only when your network supports R/STP protocol. Make sure that your network has R/STP enabled if using a cascade loop (Bridging mode) or else network loops may occur. Legrand PDU User Guide...
Page 152
Online cascading information: For detailed information on the cascading configuration and restrictions, refer to the Cascading Guide, which is available from the Legrand PDU section of Raritan website's Support page (http://www.raritan.com/support/). Overview of the Cascading Modes You must apply a cascading mode to the cascading chain. See...
Page 153
Master device: The port number is either 5NNXX or the standard TCP/UDP port. Slave device: The port number is 5NNXX. 5NNXX port number syntax: NN is a two-digit number representing the network protocol as shown below: Protocols HTTPS HTTP TELNET SNMP MODBUS Legrand PDU User Guide...
Page 154
The master device can be also accessed through standard TCP/UDP ports as listed in the following table. Protocols Port Numbers HTTPS HTTP TELNET SNMP MODBUS In the Port Forwarding mode, the cascaded device does NOT allow you to modify the standard TCP/UDP port configuration, including HTTP, HTTPS, SSH, Telnet and Modbus/TCP. Legrand PDU User Guide...
Page 155
-p 22 192.168.84.77 Slave 1 device: Position code for Slave 1 is '01' so each port number is 5NN01 as shown below. Protocols Port numbers HTTPS 50001 HTTP 50101 50201 TELNET 50301 SNMP 50501 MODBUS 50601 Legrand PDU User Guide...
Page 156
1. Log in to the desired cascaded device, and change its cascading mode to None. Exception: If you are going to connect the removed device to another cascading chain, set its cascading mode to be the same as the mode of another chain. Legrand PDU User Guide...
Page 157
If the new cascading mode is 'Port Forwarding', you must also set its role to 'Master', and correctly select the downstream interface. The following diagram indicates the correct sequence. 'N' is the final one. M = Master device S = Slave device Legrand PDU User Guide...
LDAP and mail services, uses TLS rather than SSL 3.0. Changing HTTP(S) Settings HTTPS uses Transport Layer Security (TLS) technology to encrypt all traffic to and from the Legrand PDU so it is a more secure protocol than HTTP. The Legrand PDU supports TLS 1.0, 1.1 and 1.2.
Page 159
The Legrand PDU device's SSL/TLS-based protocols, including HTTPS, support AES 128- and 256-bit ciphers. The exact cipher to use is negotiated between Legrand PDU and the client (such as a web browser), which is impacted by the cipher priority of Legrand PDU and the client's cipher availability/settings.
Page 160
Configuring SNMP Settings You can enable or disable SNMP communication between an SNMP manager and the Legrand PDU. Enabling SNMP communication allows the manager to retrieve and even control the power status of each outlet. Besides, you may need to configure the SNMP destination(s) if the built-in "System SNMP Notification Rule"...
Page 161
Downloading SNMP MIB 6. Click Save. Configuring SMTP Settings The Legrand PDU can be configured to send alerts or event messages to a specific administrator by email. (on page 184). Event Rules and Actions To send emails, you have to configure the SMTP settings and enter an IP address for your SMTP server and a sender's email address.
Page 162
The Legrand PDU device's SSL/TLS-based protocols, including SMTP over StartTLS, support AES 128- and 256-bit ciphers. The exact cipher to use is negotiated between Legrand PDU and the client (such as a web browser), which is impacted by the cipher priority of Legrand PDU and the client's cipher availability/settings.
Page 163
3. To use a different port, type a new port number. 4. Click Save. Changing Modbus Settings You can enable or disable the Modbus/TCP access to the Legrand PDU, set it to the read-only mode, or change the TCP port. To change the Modbus/TCP settings: 1.
Page 164
.local host name, that is, <preferred_host_name>.local, where <preferred_host_name> is the preferred host name you have specified for Legrand PDU. The IPv4 host name is the first priority. If an IPv4 host name is not available, then use the IPv6 host name.
Creating IP Access Control Rules IP access control rules (firewall rules) determine whether to accept or discard traffic to/from the Legrand PDU, based on the IP address of the host sending or receiving the traffic. When creating rules, keep these principles in mind: ...
Page 166
4. Go to the Inbound Rules section or the Outbound Rules section according to your needs. Inbound rules control the data sent to the Legrand PDU. Outbound rules control the data sent from the Legrand PDU.
Page 167
Ensure the IPv4 or IPv6 checkbox has been selected, or you cannot edit or delete any rule. 4. Perform the desired action. Make changes to the selected rule, and then click Save. For information on each field, see Creating (on page 165). IP Access Control Rules Legrand PDU User Guide...
Page 168
Select a role in the Role field. This rule applies to members of this role only. Select Accept or Deny in the Policy field. Refer to the above table for details. The system automatically numbers the rule. 5. When finished, the rules are listed on this page. Legrand PDU User Guide...
Page 169
IPv4 rules: Make sure you click the Save button in the IPv4 section, or the changes made to IPv4 rules are not saved. IPv6 rules: Make sure you click the Save button in the IPv6 section, or the changes made to IPv6 rules are not saved. Legrand PDU User Guide...
Page 170
Setting Up an SSL/TLS Certificate Important: Legrand uses TLS instead of SSL 3.0 due to published security vulnerabilities in SSL 3.0. Make sure your network infrastructure, such as LDAP and mail services, uses TLS rather than SSL 3.0. Having an X.509 digital certificate ensures that both parties in an SSL/TLS connection are who they say they are.
Page 171
To get a certificate from a certificate authority (CA), first create a CSR and send it to the CA. See Creating a (on page 170). After receiving the CA-signed certificate, install it onto the Legrand PDU. To install the CA-signed certificate: 1. Choose Device Settings > Security > SSL Certificate.
Page 172
Creating a Self-Signed Certificate When appropriate certificate and key files for the Legrand PDU are unavailable, the alternative, other than submitting a CSR to the CA, is to generate a self-signed certificate. Note that you must enter information in the fields showing the message 'required.' ...
Page 173
Installing or Downloading Existing Certificate and Key You can download the already-installed certificate and private key from any Legrand PDU for backup or file transfer. For example, you can install the files onto a replacement Legrand PDU, add the certificate to your browser and so on.
Page 174
The Legrand PDU device's SSL/TLS-based protocols, including LDAPS, support AES 128- and 256-bit ciphers. The exact cipher to use is negotiated between Legrand PDU and the client (such as a web browser), which is impacted by the cipher priority of Legrand PDU and the client's cipher availability/settings.
Page 175
Copy settings from This checkbox appears only when there are existing AA server existing LDAP settings on the Legrand PDU. To duplicate any existing AA server's server settings, refer to the duplicating procedure below. Type of LDAP...
Page 176
The default is 636. Either use the default port or specify another one. Enable verification Select this checkbox if it is required to validate the LDAP server's of LDAP Server certificate by the Legrand PDU prior to the connection. Certificate If the certificate validation fails, the connection is refused. CA Certificate Consult your AA server administrator to get the CA certificate file for the LDAPS server.
Page 177
4. Modify the IP Address/Hostname field. 5. Click Add Server. Note: If the Legrand PDU clock and the LDAP server clock are out of sync, the installed TLS certificates, if any, may be considered expired. To ensure proper synchronization, administrators should configure the Legrand PDU and the LDAP server to use the same NTP server(s).
Page 178
4. To verify if the authentication configuration is set correctly, click Test Connection to check whether the Legrand PDU can connect to the new server successfully. Tip: You can also test the connection on the Authentication page after finishing adding servers. See Managing External Authentication Settings (on page 178).
Page 179
98). 3. In the "Maximum number of failed logins" field, type a number. This is the maximum number of login failure the user is permitted before the user is blocked from accessing the Legrand PDU. 4. Click Save. Tip: If any user blocking event occurs, you can unblock that user manually by using the "unblock" CLI Unblocking a User command over a local connection.
Page 180
Keep the idle timeout to 20 minutes or less if possible. This reduces the number of idle sessions connected, and the number of simultaneous commands sent to the Legrand PDU. 2. Select the "Prevent concurrent login with same username" checkbox if intending to prevent multiple persons from using the same login name simultaneously.
Page 181
Enabling the Restricted Service Agreement The restricted service agreement feature, if enabled, forces users to read a security agreement when they log in to the Legrand PDU. Users must accept the agreement, or they cannot log in. An event notifying you if a user has accepted or declined the agreement can be generated. See...
Set the internal clock on the Legrand PDU manually, or link to a Network Time Protocol (NTP) server. Note: If you are using Sunbird's Power IQ to manage the Legrand PDU, you must configure Power IQ and the Legrand PDU to have the same date/time or NTP settings.
Page 183
Switch between months. dates All dates of the selected month. To select a date, simply (01-31) click it. Today Select today's date. Clear Clear the entry, if any, in the Date field. Close Close the calendar. Legrand PDU User Guide...
If you want the Legrand PDU to perform one action at a regular interval instead of waiting until an event occurs, you can schedule that action. For example, you can make the Legrand PDU email the temperature report every hour.
Page 185
Built-in rules: System Event Log Rule: This causes ANY event occurred to the Legrand PDU to be recorded in the internal log. It is enabled by default. Default Log Messages Note: For the default log messages generated for each event, see (on page 189).
Page 186
Click this field to specify the type of event(s) you want. 5. In this example, Numeric Sensor is selected because we want to select numeric-sensor-related event(s). Then a field for numeric-sensor-related events appears. Click this field to select one of the numeric-sensor-related events from the list. Legrand PDU User Guide...
Page 187
6. In this example, 'Above upper critical threshold' is selected because we want the Legrand PDU to react only when the selected temperature sensor's reading enters the upper critical range. A "Trigger condition" field appears, requiring you to define the "exact" condition related to the "upper critical" event.
Page 188
Both: Legrand PDU takes the action both when the chosen sensor becomes unavailable or available. Link state is up: Legrand PDU takes the Network interface action only when the network link state link state changes from down to up.
Page 189
Default Log Messages These default log messages are recorded internally and emailed to specified recipients when Legrand PDU events occur (are TRUE) or, in some cases, stop or become unavailable (are FALSE). See Send Email page 200) to configure email messages.
Page 190
Device > Sending SNMP inform Sending SNMP inform to manager failed or no response [SNMPMANAGER]:[SNMPMANAGER PORT] failed or no response. [ERRORDESC]. Device > Sending Syslog Sending Syslog message to server message failed [SYSLOGSERVER]:[SYSLOGPORT] ([SYSLOGTRANSPORTPROTO]) failed. [ERRORDESC]. Legrand PDU User Guide...
Page 191
Peripheral Device Slot > * > Peripheral device Peripheral device Numeric Sensor > Below lower '[EXTSENSORNAME]' in slot '[EXTSENSORNAME]' in slot critical threshold [EXTSENSORSLOT] asserted 'below [EXTSENSORSLOT] deasserted lower critical' at [SENSORREADING] 'below lower critical' at [SENSORREADINGUNIT]. [SENSORREADING] [SENSORREADINGUNIT]. Legrand PDU User Guide...
Page 192
Self-Test '[INLET]' started self test. '[INLET]' finished self test. Inlet > Pole > * > Sensor > Sensor '[PDUPOLESENSOR]' on pole Sensor '[PDUPOLESENSOR]' on Unavailable '[INLETPOLE]' of inlet '[INLET]' pole '[INLETPOLE]' of inlet '[INLET]' unavailable. available. Legrand PDU User Guide...
Page 193
Outlet '[OUTLET]' state changed to on. Outlet '[OUTLET]' state changed to State > On/Off off. Overcurrent Protector > * > Sensor '[OCPSENSOR]' on Sensor '[OCPSENSOR]' on Sensor > * > Unavailable overcurrent protector '[OCP]' overcurrent protector '[OCP]' Legrand PDU User Guide...
Page 194
Controller '[CONTROLLER]' with Incompatible ID [BOARDID] is incompatible. board ID [BOARDID] is no longer incompatible. PDU > Controller > * > OK Controller '[CONTROLLER]' with board Controller '[CONTROLLER]' with ID [BOARDID] is OK. board ID [BOARDID] is no longer PDU > Load Shedding >...
Page 195
Webcam Management > Webcam '[WEBCAMNAME]' Webcam attached ('[WEBCAMUVCID]') added to port '[WEBCAMUSBPORT]'. Webcam Management > Webcam '[WEBCAMNAME]' Webcam detached ('[WEBCAMUVCID]') removed from port '[WEBCAMUSBPORT]'. Webcam Management > Webcam '[WEBCAMNAME]' settings Webcam settings changed changed by user '[USERNAME]'. Legrand PDU User Guide...
Page 196
System Tamper Alarm: This action causes the Legrand PDU to show the alarm for the DX tamper sensor, if any, on the Dashboard page until a person acknowledges it. By default, this action has been assigned to the built-in tamper detection event rules.
Page 197
If the Alarm action has been included in a specific event rule and no one acknowledges that alert after it occurs, the Legrand PDU resends or regenerates an alert notification regularly until the alert is acknowledged or the maximum number of alert notifications is sent.
Page 198
Change Load Shedding State The "Change load shedding state" action is available only when your Legrand PDU is able to control outlet power. Use this action to activate or deactivate the load shedding mode for responding to a specific event.
Page 199
The maximum amount of snapshots that can be stored on the Legrand PDU is 10. If you set it for a number greater than 10 and the storage location is on the Legrand PDU, after the 10th snapshot is taken and stored, the oldest snapshots are overwritten.
Page 200
You can configure emails to be sent when an event occurs and can customize the message. Messages consist of a combination of free text and Legrand PDU placeholders. The placeholders represent information which is pulled from the Legrand PDU and inserted into the message.
Page 201
Send Sensor Report You may set the Legrand PDU so that it automatically reports the latest readings or states of one or multiple sensors by sending a message or email or simply recording the report in a log. These sensors can be either internal or environmental sensors listed below.
Page 202
This option sends an SNMP notification to one or multiple SNMP destinations. Operation: 1. Choose Device Settings > Event Rules > 2. Select "Send SNMP notification" from the Action list. 3. Select the type of SNMP notification. See either procedure below according to your selection. Legrand PDU User Guide...
Page 203
5. In the Community fields, enter the SNMP community string to access the device(s). The community is the group representing the Legrand PDU and all SNMP management stations. Tip: An SNMP v2c notification action permits only a maximum of three SNMP destinations. To assign more...
Page 204
Start or Stop a Lua Script If you have created or loaded a Lua script file into the Legrand PDU, you can have that script automatically run or stop in response to a specific event. For instructions on creating or loading a Lua script into this product, see (on page 225).
Page 205
Outlets Switch Peripheral Actuator If you have any actuator connected to the Legrand PDU, you can set up the Legrand PDU so it automatically turns on or off the system controlled by the actuator when a specific event occurs. DX or DX2 Sensor Packages Note: For information on connecting actuators, see (on page 47).
Page 206
An action can be regularly performed at a preset time interval instead of being triggered by a specific event. For example, you can make the Legrand PDU report the reading or state of a specific sensor regularly by scheduling the "Send Sensor Report" action.
Page 207
Time - the value is measured in 12-hour format so you must correctly specify AM or PM by clicking the AM/PM button. An example of the scheduled action is available in the section titled (on page Send Sensor Report Example 208). Legrand PDU User Guide...
Page 208
'Send sensor report' action that includes the 'Email a Sensor Report' action as its destination action. For details, see (on page 201). Send Sensor Report In this example, this action is named Send Temperature Sensor Readings. Legrand PDU User Guide...
Page 209
3. Click to create a timer for performing the 'Send Temperature Sensor Readings' action hourly. For details, see (on page 206). Scheduling an Action In this example, the timer is named Hourly Temperature Sensor Reports. Legrand PDU User Guide...
Page 210
To perform the specified action at 12:30 pm, 01:30 pm, 02:30 pm, and so on, select Hourly, and set the Minute to 30. Then the Legrand PDU will send out an email containing the specified temperature sensor readings hourly every day.
Page 211
The ID of a peripheral device slot [EXTSENSOR] The peripheral device identifier [IFNAME] The human readable name of a network interface [INLETPOLE] The inlet power line identifier [INLETSENSOR] The inlet sensor name [INLET] The power inlet label Legrand PDU User Guide...
Page 212
The outlet sensor name [OUTLET] The outlet label [PDUPOLESENSOR] The sensor name for a certain power line [PDUSENSOR] The PDU sensor name [PERIPHDEVPOSITION] The position of an attached peripheral device [PHONENUMBER] The phone number an SMS was sent to [PORTID]...
Page 213
2. Click the desired one in the list of rules, actions or scheduled actions. Its setup page opens. 3. Perform the desired action. To modify settings, make necessary changes and then click Save. To delete it, click on the top-right corner. Then click Delete on the confirmation message. Legrand PDU User Guide...
Page 214
Sample Event Rules Sample PDU-Level Event Rule In this example, we want the Legrand PDU to record the firmware upgrade failure in the internal log when it happens. The event rule involves: Event: Device > Firmware update failed ...
Page 215
SNMP notifications are sent again. Sample Inlet-Level Event Rule In this example, we want the Legrand PDU to send SNMP notifications to the SNMP manager for any sensor change event of the Inlet I1. The event rule involves: ...
Page 216
This section applies to outlet-switching capable models only. In this example, we want Legrand PDU to activate the load shedding function when a contact closure sensor enters the alarmed state. This event rule requires creating a new action before creating the rule.
Page 217
116). 5. Select "State Sensor/Actuator" because the contact closure sensor is a state sensor. 6. Select "Alarmed" since we want the Legrand PDU to respond when the selected contact closure sensor changes its state related to the "alarmed" state.
Page 218
You should avoid building an infinite loop when creating event rules. The infinite loop refers to a condition where the Legrand PDU keeps busy because the action or one of the actions taken for a certain event triggers an identical or similar event which will result in an action triggering one more event.
In some cases, a measurement exceeds a threshold causing the Legrand PDU to generate an alert. The measurement then returns to a value within the threshold, but the Legrand PDU does not generate an alert message for the Deassertion event. Such scenarios can occur due to the hysteresis tracking the Legrand PDU uses.
Important: Although it is possible to selectively enable/disable logging for individual sensors on the Legrand PDU, it is NOT recommended to do so. Configuring Data Push Settings You can push the sensor log to a remote server for data synchronization. The data will be sent in JSON format using HTTP POST requests.
Monitoring Server Accessibility You can monitor whether specific IT devices are alive by having the Legrand PDU continuously ping them. An IT device's successful response to the ping commands indicates that the IT device is still alive and can be remotely accessed.
Page 222
In this illustration, it is assumed that a significant PDU (IP address: 192.168.84.95) shall be monitored by your Legrand PDU to make sure that PDU is properly operating all the time, and the Legrand PDU must send out SNMP notifications (trap or inform) if that PDU is declared unreachable due to power or network failure.
Page 223
Number of consecutive unsuccessful pings for failure To make the Legrand PDU stop pinging the target PDU for 60 seconds (1 minute) after the PDU inaccessibility is declared, enter the following data. After 60 seconds, the Legrand PDU will re-ping the target PDU,...
Peripherals Configuring the Serial Port You can change the bit rate of the serial port labeled CONSOLE on the Legrand PDU. The default bit rate for console operation is 115200 bps. The Legrand PDU supports using the following devices via the serial interface: ...
(115200 bps). Lua Scripts If you can write or obtain any Lua scripts, you can create or load them into the Legrand PDU to control its behaviors. Legrand also provides some Lua scripts examples, which you can load as needed.
Page 226
6. If you chose to load a script or Legrand's example in the previous step, its codes are then displayed in the Source Code section. Double check the codes. If needed, modify the codes to meet your needs.
Page 227
1. Choose Device Settings > Lua Scripts. 2. Click the desired script whose state is either 'Running' or 'Restarting.' For details, see Checking Lua (on page 228). Scripts States 3. Click on the top-right corner. 4. Click Stop on the confirmation message. Legrand PDU User Guide...
Page 228
Modifying or Deleting a Script You can edit an existing script's codes or even replace it with a new script. Or you can simply remove a unnecessary script from the Legrand PDU. To modify or replace a script: 1. Choose Device Settings > Lua Scripts.
By default, the Schroff LHX/SHX heat exchanger support and Cisco EnergyWise feature implemented on the Legrand PDU are disabled. However, Legrand PDU does NOT support Schroff LHX/SHX so you can ignore the checkbox for this device. If a Cisco EnergyWise energy management architecture is implemented in your place, you can enable the ®...
Viewing Connected Users Event Log (on page 236) Viewing or Clearing the Local Event Log Update Firmware (on page 237) Updating the Legrand PDU Firmware Firmware History (on page 238) Viewing Firmware Update History Bulk Configuration (on page 239) Bulk Configuration...
Network The network information, such as the current networking mode, IPv4 and/or IPv6 addresses and so on. This tab also indicates whether the Legrand PDU is part of a cascading configuration. Identifying Cascaded Devices page 232). Legrand PDU User Guide...
Page 232
This section explains how to identify a cascaded device on the Device Information page. Note: For detailed information on the cascading configuration and restrictions, refer to the Cascading Guide, Support page which is available from the Legrand PDU section of Raritan website's (http://www.raritan.com/support/). To identify the cascading status: 1.
Page 233
Indicates the Port Forwarding is enabled. See (on page 150). Setting the Cascading Mode Cascade Position Indicates the position of the Legrand PDU in the cascading chain. 0 (zero) represents the master device. A non-zero number represents a slave device. 1 is Slave 1, 2 is Slave 2, 3 is Slave 3 and so on.
Page 234
Device Connected field shows no, indicating that it is the final one in the chain. For a list of port numbers required for accessing each cascaded device in the Port Forwarding mode, click the Port Forwarding title bar on the same page. Legrand PDU User Guide...
Viewing Connected Users You can check which users have logged in to the Legrand PDU and their status. If you have administrator privileges, you can terminate any user's connection to the Legrand PDU. To view and manage connected users: 1.
By default, the Legrand PDU captures certain system events and saves them in a local (internal) event log. You can view over 2000 historical events that occurred on the Legrand PDU in the local event log. When the log size exceeds 256KB, each new entry overwrites the oldest one.
ON and outlets that have been powered off remain powered OFF. You must be the administrator or a user with the Firmware Update permission to update the Legrand PDU firmware. Before starting the upgrade, read the release notes downloaded from the Legrand PDU section of Raritan website's (http://www.raritan.com/support/).
For Legrand, disaster recovery can be performed via the USB connection only. If the firmware upgrade fails, causing the Legrand PDU to stop working, you can recover it by using a special utility rather than returning the device to Legrand.
The last configuration-copying record: If you once copied any bulk configuration or device backup file to the Legrand PDU, the last record similar to the following is displayed at the bottom of both the Bulk Configuration and Backup/Restore pages.
Page 240
If the built-in profile does not meet your needs, you can create your own profile(s), and then apply the wanted profile before downloading/saving any settings from the source device. To create new bulk profile(s): 1. Log in to the source Legrand PDU, whose settings you want to download. 2. Choose Maintenance > Bulk Configuration. 3. Click in the Bulk Profiles section.
Page 241
If yes, go to step 2 directly. Step 1: Select the desired bulk configuration profile (optional) 1. Log in to the source Legrand PDU, whose settings you want to copy. 2. Choose Maintenance > Bulk Configuration. 3. Click on the row of the wanted profile to open the Edit Bulk Profile page.
Page 242
Step 3: Perform bulk configuration You must have the Administrator Privileges to upload the configuration. 1. Log in to the target Legrand PDU, which is of the same model and runs the same firmware as the source Legrand PDU.
Backup and Restore of Device Settings Unlike the bulk configuration file, the backup file contains ALL device settings, including device-specific data like device names and all network settings. To back up or restore the settings of Legrand PDU, you should perform the Backup/Restore feature.
The last configuration-copying record: If you once copied any bulk configuration or device backup file to the Legrand PDU, the last record similar to the following is displayed at the bottom of both the Bulk Configuration and Backup/Restore pages.
Important: This function is for use by Legrand Field Engineers or when you are directed by Legrand Technical Support. You can download the diagnostic file from the Legrand PDU to a client machine. The file is compressed into a .tgz file and should be sent to Legrand Technical Support for interpretation.
Resetting All Settings to Factory Defaults You must have the Administrator Privileges to reset all settings of the Legrand PDU to factory defaults. Important: Exercise caution before resetting the Legrand PDU to its factory defaults. This erases existing information and customized settings, such as user profiles, threshold values, and so on. Only active energy data and firmware upgrade history are retained.
Webcam Management The 'Webcams' menu item appears when there is any webcam(s) connected to the Legrand PDU, or when there are snapshots saved onto the Legrand PDU already. See (on page Connecting a Logitech Webcam 54). Legrand PDU User Guide...
With a Logitech webcam connected to the Legrand PDU, you can visually monitor the environment around ® the Legrand PDU via snapshots or videos captured by the webcam. Permissions required: To do... Permission(s) required Either permission below: View snapshots and videos ...
Page 249
Tip: The date and time shown on the Legrand PDU web interface are automatically converted to your computer's time zone. To avoid any time confusion, you can apply the same time zone settings as those of Legrand PDU to your computer.
Page 250
It is suggested to customize a webcam's name "prior to" saving snapshots on the remote server. In case you change the webcam's name after saving any snapshots, Legrand PDU will create a new folder with the new webcam name while keeping the old folder with the old name.
3. Click in the Live Preview section. The live snapshot or video in a standalone window opens. See (on page 248). Configuring Webcams and Viewing Live Images 4. Copy the URL from that live preview window. Legrand PDU User Guide...
Page 252
The Primary Standalone Live Preview window remains open on User A's computer. If so, even though User A logs out of the Legrand PDU or the login session times out, the link remains accessible. User B's Secondary Standalone Live Preview window remains open. If so, even though User A already closes the Primary Standalone Live Preview window, the link remains accessible.
When there are more than one webcam connected, then the oldest snapshot of the webcam "with the most snapshots" is overridden. Tip: To save more than 10 snapshots, you must change the storage location from the Legrand PDU to an Changing Storage Settings FTP or Common Internet File System (CIFS)/Samba server.
FTP client, to access and manage the snapshots stored on remote servers. The default is to store snapshots onto the Legrand PDU device, which has a limitation of 10 snapshots. Note that any operation involving device reboot will remove the snapshots saved on the Legrand PDU, such as firmware upgrade.
Page 255
Legrand PDU web interface. If this issue occurs, first restore the connectivity of the remote server and then change the storage settings of the webcam snapshots.
Page 256
All snapshots are saved as JPEG and named according to the date and time when saving the snapshots. Note that the date and time of the filename are based on the time zone of the Legrand PDU device rather than that of the computer or mobile device you are operating.
Note that "SmartLock" appears only when your door handles are connected via DX2-DH2C2 to Legrand PDU, but "Card Readers" appears as long as the Legrand PDU detects any card reader -- directly connected to Legrand PDU, or indirectly connected via DX2-DH2C2.
To open the SmartLock page, choose SmartLock in the (on page 84). Menu The page lists all DX2-DH2C2 connected to Legrand PDU, including their serial numbers and positions in a sensor chain. You can click the desired DX2-DH2C2 to open its details page, and then do the following.
Page 259
Configure the door handles connected to DX2-DH2C2. You must set this because Legrand PDU cannot detect the types of connected door handles. Control the door handles connected to DX2-DH2C2. To view the status of the door and card reader: There are two door handle sections per DX2-DH2C2 because a DX2-DH2C2 has two door handle ports and two pairs of contact closure sensor terminals.
Page 260
If no door handle is being connected to the door-handle port in question on the DX2-DH2C2, select or leave this field to "None." 3. Click Save. To control the door handles: 1. Make sure you have configured the door handle type properly in the above procedure. Legrand PDU User Guide...
This page lists all card readers connected to Legrand PDU, indirectly or directly. When a user scans his/her smart card with the card reader, Legrand PDU will retrieve the card's type and ID and show them in the corresponding Card Type and Card ID column. If no data is shown in the two columns, it means the scanned card may not be supported by the card reader.
Using SNMP This SNMP section helps you set up the Legrand PDU for use with an SNMP manager. The Legrand PDU can be configured to send traps or informs to an SNMP manager, as well as receive GET and SET commands in order to retrieve status and configure some basic settings.
The port number used to access the device(s). Community The SNMP community string to access the device(s). The community is the group representing the Legrand PDU and all SNMP management stations. 6. Click Save. SNMPv3 Notifications 1. Choose Device Settings > Network Services > SNMP.
Page 264
This is the address to which notifications are sent by the SNMP agent. Port The port number used to access the device(s). User ID User name for accessing the device. Make sure the user has the SNMP v3 access permission. Legrand PDU User Guide...
You must download an appropriate SNMP MIB file for successful SNMP communications. Always use the latest SNMP MIB downloaded from the current firmware of your Legrand PDU. You can download the MIBs from two different pages of the web interface.
Valid objects for these requests are limited to those found in the SNMP MIB-II System Group and the custom Legrand PDU MIB. The Legrand PDU MIB The SNMP MIB file is required for using your Legrand PDU with an SNMP manager. An SNMP MIB file describes the SNMP functions. Legrand PDU User Guide...
Page 267
Layout Opening the MIB reveals the custom objects that describe the Legrand PDU 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. The objects then appear again individually, defined and described in detail.
A Note about Enabling Thresholds When enabling previously-disabled thresholds via SNMP, make sure you set a correct value for all thresholds that are supposed to be enabled prior to actually enabling them. Otherwise, you may get an error message. Legrand PDU User Guide...
Using the Command Line Interface This section explains how to use the command line interface (CLI) to administer the Legrand PDU. CLI commands are case sensitive. In This Chapter About the Interface ................269 Logging in to CLI................... 269 The ? Command for Showing Available Commands......271 Querying Available Parameters for a Command........
Tip: For a USB connection, you can determine the COM port by choosing Control Panel > System > Hardware > Device Manager, and locating the "Dominion PX2 Serial Console" under the Ports group. 3. In the communications program, press Enter to send a carriage return to the Legrand PDU. The Username prompt appears.
Entering Diagnostic Mode Closing a Local Connection Close the window or terminal emulation program when you finish accessing the Legrand PDU over the local connection. When accessing or upgrading multiple Legrand PDUs, do not transfer the local connection cable from one device to another without closing the local connection window first.
Showing Information You can use the show commands to view current settings or the status of the Legrand PDU device or part of it, such as the IP address, networking mode, firmware version, states or readings of internal or external sensors, user profiles, and so on.
<ETH> is one of the network interfaces: ETH1, ETH2, WIRELESS, or BRIDGE. Note that you must choose/configure the bridge interface if your Legrand PDU is set to the bridging mode. Note: In the bridging mode, only the IP parameters of the BRIDGE interface function. The IP parameters of ETH1, ETH2 and WIRELESS interfaces do NOT function.
Page 274
<ETH> is one of the network interfaces: ETH1, ETH2, WIRELESS, or BRIDGE. Note that you must choose/configure the bridge interface if your Legrand PDU is set to the bridging mode. Note: In the bridging mode, only the IP parameters of the BRIDGE interface function. The IP parameters of ETH1, ETH2 and WIRELESS interfaces do NOT function.
Page 275
<ETH> is one of the network interfaces: ETH1, ETH2, WIRELESS, or BRIDGE. Note that you must choose/configure the bridge interface if your Legrand PDU is set to the bridging mode. Note: In the bridging mode, only the IP parameters of the BRIDGE interface function. The IP parameters of ETH1, ETH2 and WIRELESS interfaces do NOT function.
Only displays the settings of the zero configuration advertising. PDU Configuration This command shows the PDU configuration, such as the device name, firmware version and model type. show pdu To show detailed information, add the parameter "details" to the end of the command.
Displays the information for the specified inlet only. number An inlet number needs to be specified only when there are more than 1 inlet on your PDU. Displayed information: Without the parameter "details," only the inlet's name and RMS current are displayed.
To show detailed information, add the parameter "details" to the end of the command. show time details Default Measurement Units This command shows the default measurement units applied to the Legrand PDU web and CLI interfaces across all users, especially those users authenticated through remote authentication servers. show user defaultPreferences...
* The environmental sensor number is the ID number assigned to the sensor, which can be found on the Peripherals page of the Legrand PDU web interface. Displayed information: Without the parameter "details," only the sensor ID, sensor type and reading are displayed.
Description Displays the information for all actuators. Tip: You can also type the command without adding this option "all" to get the same data. A specific Displays the information for the specified actuator actuator only. number* Legrand PDU User Guide...
<n> <sensor type> details Variables: <n> is the number of the inlet whose sensors you want to query. For a single-inlet PDU, <n> is always 1. <sensor type> is one of the following sensor types:...
<n> <p> <sensor type> details Variables: <n> is the number of the inlet whose pole sensors you want to query. For a single-inlet PDU, <n> is always 1. <p> is the label of the inlet pole whose sensors you want to query.
If the requested sensor type is not supported, the "Sensor is not available" message is displayed. Additional sensors supported by Legrand PDUs: The CLI command(s) listed above can be also applied to the following sensors. Note that the measurement unit of current values in CLI is A, not mA.
Variables: <n> is the environmental sensor number. The environmental sensor number is the ID number assigned to the sensor, which can be found on the Peripherals page of the Legrand PDU web interface. Displayed information: Without the parameter "details," only the reading, threshold, deassertion hysteresis and assertion timeout settings of the specified environmental sensor are displayed.
With the parameter "details," the threshold range is displayed in addition to default thresholds settings. Security Settings This command shows the security settings of the Legrand PDU. show security To show detailed information, add the parameter "details" to the end of the command.
Displayed information: Without specifying any server, Legrand PDU shows the authentication type and a list of both LDAP and Radius servers that have been configured. When specifying a server, only that server's basic configuration is displayed, such as IP address and port number.
"all" to get the same data. a specific role's name This option shows the data of the specified role only. Displayed information: Role settings are displayed, including the role description and privileges. Legrand PDU User Guide...
CLI, see (on page 296). Serial Port Settings This command shows the baud rate setting of the serial port labeled CONSOLE on the Legrand PDU. show serial EnergyWise Settings This command shows the Legrand PDU device's current configuration for Cisco EnergyWise.
Cisco EnergyWise-related events, such as enabling the support of the EnergyWise function. Note: Legrand PDU does not support features regarding Schroff LHX, modem, Raritan asset management, and transfer switch so you can ignore these event types in the CLI. Wireless LAN Diagnostic Log This command shows the diagnostic log for the wireless LAN connection.
This command shows the command history for current connection session. show history Displayed information: A list of commands that were previously entered in the current session is displayed. Reliability Data This command shows the reliability data. show reliability data Legrand PDU User Guide...
Displays the specified number of last entries in the integer number reliability error log. Examples This section provides examples of the show command. Example 1 - Basic Security Information The diagram shows the output of the show security command. Legrand PDU User Guide...
Example 2 - In-Depth Security Information More information is displayed when typing the show security details command. Clearing Information You can use the clear commands to remove unnecessary data from the Legrand PDU. After typing a "clear" command, press Enter to execute it. Different CLI Note: Depending on your login name, the # prompt may be replaced by the >...
Configuring the Legrand PDU Device and Network To configure the Legrand PDU device or network settings through the CLI, it is highly recommended to log in as the administrator so that you have full permissions. To configure any settings, enter the configuration mode. Configuration commands are case sensitive so ensure you capitalize them correctly.
PDU Configuration Commands A PDU configuration command begins with pdu. You can use the PDU configuration commands to change the settings that apply to the whole Legrand PDU device. Changing the PDU Name This command changes the device name of Legrand PDU.
Page 295
<delay1>, <delay2>, <delay3> and the like are the delay time in seconds. Setting the PDU-Defined Default Outlet State This section applies to outlet-switching capable models only. This command determines the initial power condition of all outlets after powering up the PDU. config:# pdu outletStateOnDeviceStartup <option>...
Page 296
<outlets2> is one or multiple outlet numbers to be set as NON-critical outlets. Use commas to separate outlet numbers. Use a dash for a range of consecutive outlets. For example, 3-8 represents outlets 3 to 8. Legrand PDU User Guide...
Page 297
Specifying the Device Altitude This command specifies the altitude of your Legrand PDU above sea level (in meters). You must specify the altitude of Legrand PDU above sea level if a Raritan's DPX differential air pressure sensor is attached. This is because the device's altitude is associated with the altitude correction factor.
Page 298
<option> is one of the options: enable or disable. Option Description enable Enables the automatic management feature for environmental sensor packages. disable Disables the automatic management feature for environmental sensor packages. For more information, see (on page 98). How the Automatic Management Function Works Legrand PDU User Guide...
"my px12" Example 2 - Outlet Sequence The following command causes a 10-outlet PDU to first power on the 8th to 6th outlets and then the rest of outlets in the ascending order after the PDU powers up.
Page 300
<ETH> is one of the network interfaces: ETH1, ETH2, WIRELESS, or BRIDGE. Note that you must choose/configure the bridge interface if your Legrand PDU is set to the bridging mode. Note: In the bridging mode, only the IP parameters of the BRIDGE interface function. The IP parameters of ETH1, ETH2 and WIRELESS interfaces do NOT function.
Page 301
Determine the IPv4 address of the BRIDGE interface (that is, the bridging mode). <ip address> is the IP address being assigned to your Legrand PDU. Its format is "IP address/prefix". For example, 192.168.84.99/24. Setting the IPv4 Gateway After selecting the static IP configuration mode, you can use this command to specify the gateway.
Page 302
Setting IPv4 Static Routes If the IPv4 network mode is set to static IP and your local network contains two subnets, you can configure static routes to enable or disable communications between the Legrand PDU and devices in the other subnet.
Page 303
<ETH> is one of the network interfaces: ETH1, ETH2, WIRELESS, or BRIDGE. Note that you must choose/configure the bridge interface if your Legrand PDU is set to the bridging mode. Note: In the bridging mode, only the IP parameters of the BRIDGE interface function. The IP parameters of ETH1, ETH2 and WIRELESS interfaces do NOT function.
Page 304
<ip address> is the IP address being assigned to your Legrand PDU. This value uses the IPv6 address format. Note that you must add /xx, which indicates a prefix length of bits such as /64, to the end of this IPv6 address.
Page 305
<route_ID> <dest-2> interface <ETH> Variables: <dest-1> is the IP address and prefix length of the subnet where the Legrand PDU belongs. The format is IP address/prefix length. <hop> is the IP address of the next hop router.
Page 306
<suffix1>, <suffix2>, and the like are the DNS suffixes that automatically apply when searching for any device via Legrand PDU. For example, <suffix1> can be raritan.com, and <suffix2> can be legrand.com. You can specify up to 6 suffixes by separating them with commas.
Page 307
<option> is one of the options: auto, 10Mbps or 100Mbps. Option Description auto System determines the optimum LAN speed through auto-negotiation. 10Mbps The LAN speed is always 10 Mbps. 100Mbps The LAN speed is always 100 Mbps. Legrand PDU User Guide...
Page 308
<mode> is one of the modes: auto, half or full. Option Description auto The Legrand PDU selects the optimum transmission mode through auto-negotiation. half Half duplex: Data is transmitted in one direction (to or from the Legrand PDU) at a time.
Page 309
If the Pre-Shared Key (PSK) authentication method is selected, you must assign a PSK passphrase by using this command. config:# network wireless PSK <psk> Variables: <psk> is a string or passphrase that consists of: - 8 to 63 characters - No spaces - ASCII codes 0x20 ~ 0x7E Legrand PDU User Guide...
Page 310
<identity> Set the EAP password: config:# network wireless eapPassword After performing the above command, the Legrand PDU prompts you to enter the password. Then type the password and press Enter. Provide a CA TLS certificate: config:# network wireless eapCACertificate After performing the above command, the system prompts you to enter the CA certificate's contents.
Page 311
<option3> is one of the options: true or false. Option Description true Make the wireless network connection successful when the Legrand PDU system time is earlier than the firmware build before synchronizing with the NTP server, causing the TLS certificate to become invalid. false...
Page 312
8. Verify whether the system shows the following command prompt, indicating the provided CA certificate is valid. config:# Setting the BSSID This command specifies the BSSID. config:# network wireless BSSID <bssid> Variables: <bssid> is either the MAC address of the wireless access point or none for automatic selection. Legrand PDU User Guide...
Page 313
<option3> is one of the following options: Option Description ETH1, ETH2 ETH1, ETH2 port is the port where the 1st slave device is connected. USB port is the port where the 1st slave device is connected. Legrand PDU User Guide...
Page 314
<n> is a TCP port number between 1 and 65535. The default HTTPS port is 443. <option> is one of the options: true or false. Option Description true Forces any access to the Legrand PDU via HTTP to be redirected to HTTPS. false No HTTP access is redirected to HTTPS. Legrand PDU User Guide...
Page 315
This command enables or disables the SSH service. config:# network services ssh enabled <option> Variables: <option> is one of the options: true or false. Option Description true The SSH service is enabled. false The SSH service is disabled. Legrand PDU User Guide...
Page 316
This command enables or disables the SNMP v1/v2c protocol. config:# network services snmp v1/v2c <option> Variables: <option> is one of the options: enable or disable. Option Description enable The SNMP v1/v2c protocol is enabled. disable The SNMP v1/v2c protocol is disabled. Legrand PDU User Guide...
Page 317
<value> is a string comprising 0 to 255 alphanumeric characters. Setting the sysName Value This command sets the SNMP MIB-II sysName value. config:# network services snmp sysName <value> Variables: <value> is a string comprising 0 to 255 alphanumeric characters. Legrand PDU User Guide...
Page 318
The read-only mode is disabled. Changing the Modbus Port This command changes the Modbus port. config:# network services modbus port <n> Variables: <n> is a TCP port number between 1 and 65535. The default Modbus port is 502. Legrand PDU User Guide...
The following command sets the wireless authentication method to PSK. config:# network wireless authMethod PSK Example 4 - Static IPv4 Configuration The following command enables the Static IP configuration mode. config:# network ipv4 ipConfigurationMode static Time Configuration Commands A time configuration command begins with time. Legrand PDU User Guide...
Page 320
The <second_server> is the IP address or host name of the secondary NTP server. <option> is one of these options: true or false. Mode Description true Customized NTP server settings override the DHCP-specified NTP servers. false Customized NTP server settings do NOT override the DHCP-specified NTP servers. Legrand PDU User Guide...
Page 321
24-hour format. For example, type 13:50:20 for 1:50:20 pm. Setting the Time Zone The CLI has a list of time zones to configure the date and time for the Legrand PDU. config:# time zone After a list of time zones is displayed, type the index number of the time zone or press Enter to cancel.
192.168.80.66 Checking the Accessibility of NTP Servers This command verifies the accessibility of NTP servers specified manually on your Legrand PDU and then shows the result. For instructions on specifying NTP servers via CLI, see (on page Setting NTP Parameters 320).
Page 323
Firewall Control You can manage firewall control features through the CLI. The firewall control lets you set up rules that permit or disallow access to the Legrand PDU from a specific or a range of IP addresses. An IPv4 firewall configuration command begins with security ipAccessControl ipv4.
Page 324
<direction> <ip_mask> <policy> Add a new IPv6 rule by inserting it above or below a specific rule: config:# security ipAccessControl ipv6 rule add <direction> <ip_mask> <policy> <insert> <rule_number> -- OR -- Legrand PDU User Guide...
Page 325
Depending on what to modify in an existing rule, the command varies. IPv4 commands Modify an IPv4 rule's IP address and/or subnet mask: config:# security ipAccessControl ipv4 rule modify <direction> <rule_number> ipMask <ip_mask> Modify an IPv4 rule's policy: Legrand PDU User Guide...
Page 326
Discards traffic from/to the specified IP address(es), without sending any failure notification to the source or destination host. reject Discards traffic from/to the specified IP address(es), and an ICMP message is sent to the source or destination host for failure notification. Legrand PDU User Guide...
Page 327
This command activates or deactivates the Restricted Service Agreement. config:# security restrictedServiceAgreement enabled <option> Variables: <option> is one of the options: true or false. Option Description true Enables the Restricted Service Agreement feature. false Disables the Restricted Service Agreement feature. Legrand PDU User Guide...
Page 328
1. Type the text comprising up to 10,000 ASCII characters when the CLI prompts you to enter the content. 2. To end the content: a. Press Enter. b. Type --END-- to indicate the end of the content. c. Press Enter again. Legrand PDU User Guide...
Page 329
2. Type the following content when the CLI prompts you to enter the content. IMPORTANT!! You are accessing a PDU. If you are not the system administrator, do NOT power off or power cycle any outlet without the permission of the system administrator.
Page 330
<value> is a numeric value in days set for the password aging interval. The interval ranges from 7 to 365 days. Idle Timeout This command determines how long a user can remain idle before that user is forced to log out of the Legrand PDU web interface or CLI. config:# security loginLimits idleTimeout <value> Variables: ...
Page 331
<value> is an integer between 8 and 32. Maximum Password Length This command determines the maximum length of the password. config:# security strongPasswords maximumLength <value> Variables: <value> is an integer between 16 and 64. Legrand PDU User Guide...
Page 332
<option> is one of the options: enable or disable. Option Description enable At least one numeric character is required. disable No numeric character is required. Special Character Requirement This command determines whether a strong password includes at least a special character. Legrand PDU User Guide...
Page 333
Determine the IPv4 role-based access control policy: config:# security roleBasedAccessControl ipv4 defaultPolicy <policy> IPv6 commands Enable or disable the IPv6 role-based access control feature: config:# security roleBasedAccessControl ipv6 enabled <option> Determine the IPv6 role-based access control policy: Legrand PDU User Guide...
Page 334
Add a new rule to the bottom of the IPv6 rules list: config:# security roleBasedAccessControl ipv6 rule add <start_ip> <end_ip> <role> <policy> Add a new IPv6 rule by inserting it above or below a specific rule: Legrand PDU User Guide...
Page 335
Modify an IPv4 rule's role: config:# security roleBasedAccessControl ipv4 rule modify <rule_number> role <role> Modify an IPv4 rule's policy: config:# security roleBasedAccessControl ipv4 rule modify <rule_number> policy <policy> Modify all contents of an existing IPv4 rule: Legrand PDU User Guide...
Page 336
Deleting a Role-Based Access Control Rule These commands remove a specific rule from the list. IPv4 commands config:# security roleBasedAccessControl ipv4 rule delete <rule_number> IPv6 commands Legrand PDU User Guide...
Page 337
Tip: If your PDU supports multiple front panel permissions, you can combine them into one command by adding a semicolon (;) between different permissions. For example, the following CLI command enables both front panel actuator control and outlet switching functions simultaneously.
Page 338
192.168.78.50 and 192.168.90.100 when the user is a member of the role "admin." The newly-added IPv4 rule is inserted above the 3rd rule. That is, the new rule becomes the 3rd rule, and the original 3rd rule becomes the 4th rule. Legrand PDU User Guide...
Changing an Outlet's Default State This section applies to outlet-switching capable models only. This command determines the initial power condition of an outlet after the Legrand PDU powers up. config:# outlet <n> stateOnDeviceStartup <option>...
<n> name "<name>" Variables: <n> is the number of the inlet that you want to configure. For a single-inlet PDU, <n> is always 1. The value is an integer between 1 and 50. <name> is a string comprising up to 64 ASCII printable characters. The <name> variable must be enclosed in quotes when it contains spaces.
<n> enabled <option> Variables: <n> is the number of the inlet that you want to configure. For a single-inlet PDU, <n> is always 1. The value is an integer between 1 and 50. <option> is one of the options: true or false.
This command creates a new user profile. config:# user create <name> <option> <roles> After performing the user creation command, the Legrand PDU prompts you to assign a password to the newly-created user. Then: 1. Type the password and press Enter.
Page 343
<email_address> is the email address of the specified user. Enabling or Disabling a User Profile This command enables or disables a user profile. A user can log in to the Legrand PDU only after that user's user profile is enabled.
Page 344
SNMPv3 parameters at a time. See Multi-Command Syntax (on page 381). Enable or disable the SNMP v3 access to Legrand PDU for the specified user: config:# user modify <name> snmpV3Access <option1>...
Page 345
<name> is the name of the user whose settings you want to change. <option4> is one of the options: true or false. Option Description true Privacy passphrase is identical to the authentication passphrase. false Privacy passphrase is different from the authentication passphrase. Determine the privacy passphrase: Legrand PDU User Guide...
Page 346
<name> is the name of the user whose settings you want to change. <roles> is a role or a list of comma-separated roles assigned to the specified user profile. See (on page 351). Privileges Legrand PDU User Guide...
Page 347
Multi-Command Syntax Note: The measurement unit change only applies to the web interface and command line interface. Tip: To set the default measurement units applied to the Legrand PDU user interfaces for all users via CLI, Setting Default Measurement Units (on page 349).
Page 348
Note that this command does not begin with user. config:# password After performing this command, the Legrand PDU prompts you to enter both current and new passwords respectively. Important: After the password is changed successfully, the new password is effective immediately no matter you type the command "apply"...
Page 349
381). Note: The measurement unit change only applies to the web interface and command line interface. Tip: To change the preferred measurement units displayed in the Legrand PDU user interfaces for a specific Changing Measurement Units user via CLI, see (on page 347).
Page 350
May roles admin,tester Results: The user May has the union of all privileges of "admin" and "tester." Example 3 - Default Measurement Units The following command sets all default measurement units at a time. Legrand PDU User Guide...
All Privileges This table lists all privileges. Note that available privileges vary according to the model you purchased. For example, a PDU without the outlet switching function does not have the privilege "switchOutlet." Privilege Description acknowledgeAlarms...
Page 353
Note: The ID number of each actuator is shown in the Legrand PDU web interface. It is an integer between 1 and 32. ** The "switchOutlet" privilege requires an argument that is separated with a colon. The argument could be: ...
Page 354
<argument1>, <argument2> and the like are arguments set for a particular privilege. Separate a privilege and its argument(s) with a colon, and separate arguments with a comma if there are more than one argument for a privilege. Deleting a Role This command deletes an existing role. config:# role delete <name> Legrand PDU User Guide...
Option Description true Remote authentication is the first priority. The device will switch to local authentication when the remote authentication is not available. false Always stick to remote authentication regardless of the availability of remote authentication. Legrand PDU User Guide...
Page 356
<ldap_type> is one of the LDAP server types: openldap or activeDirectory. Type Description OpenLDAP server openldap Microsoft Active Directory activeDirectory <security> is one of the security options: none, startTls or tls. Type Description No security none StartTLS startTls Legrand PDU User Guide...
Page 357
After setting to true, the system will prompt you to upload a certificate. For details, see Illustrations of Adding (on page 358). LDAP Servers Whether to accept expired or not valid yet allowExpiredCertificate certificate <allow_exp_cert> Legrand PDU User Guide...
Page 358
Note: The certificate's content is located between the line containing "BEGIN CERTIFICATE" and the line containing "END CERTIFICATE". An LDAP server with the bind DN and bind password configured: a. Enter the CLI command with the "bindDN" parameter and its data added. Legrand PDU User Guide...
Page 359
Variables: <host> is the IP address or host name of the LDAP server. <server_num> is the sequential number of the specified server shown on the server list of the Legrand PDU. See (on page 286). Authentication Settings Modifying an Existing LDAP Server You can modify one or multiple parameters of an existing LDAP server, such as its IP address, TCP port number, Base DN and so on.
Page 360
Enter. Determine whether to accept a certificate which is expired or allowExpiredCertificate not valid yet. <allow_exp_cert> <allow_exp_cert> determines whether to accept an expired or not valid yet certificate <allow_exp_cert> values include: true, and false Legrand PDU User Guide...
Page 361
If you enable Radius authentication, you must add at least one Radius server. Later you can modify or delete any existing Radius server as needed. Adding a Radius Server You can repeat the following commands to add Radius servers one by one. Command syntax: Legrand PDU User Guide...
Page 362
<server_num> authPort <auth_port> Change the accounting port: config:# authentication radius modify <server_num> accountPort <acct_port> Change the timeout value: config:# authentication radius modify <server_num> timeout <timeout> Change the number of retries: Legrand PDU User Guide...
Environmental Sensor Configuration Commands An environmental sensor configuration command begins with externalsensor. You can configure the name and location parameters of an individual environmental sensor. Actuator Configuration Commands Note: To configure an actuator, see (on page 376). Legrand PDU User Guide...
Page 364
<n> is the ID number of the environmental sensor that you want to configure. The ID number is available in the Legrand PDU web interface or using the command "show externalsensors <n>" in the CLI. It is an integer between 1 and 32.
Page 365
<n> is the ID number of the environmental sensor that you want to configure. The ID number is available in the Legrand PDU web interface or using the command "show externalsensors <n>" in the CLI. It is an integer between 1 and 32.
Page 366
<n> is the ID number of the environmental sensor that you want to configure. The ID number is available in the Legrand PDU web interface or using the command "show externalsensors <n>" in the CLI. It is an integer between 1 and 32.
Air flow sensors vibration Vibration sensors <value> is the value for the specified threshold of the specified sensor type. Note that diverse sensor types use different measurement units. Sensor types Measurement units absoluteHumidity g/m^3 (that is, g/m Legrand PDU User Guide...
You can configure various inlet sensor threshold settings at a time by combining multiple commands. See (on page 381). Multi-Command Syntax Set the Upper Critical threshold for an inlet sensor: config:# sensor inlet <n> <sensor type> upperCritical <option> Set the Upper Warning threshold for an inlet sensor: Legrand PDU User Guide...
Page 369
<n> <sensor type> assertionTimeout <as_value> Variables: <n> is the number of the inlet that you want to configure. For a single-inlet PDU, <n> is always 1. <sensor type> is one of the following sensor types: Sensor type...
Page 370
(on page 475). "To Assert" and Assertion Timeout Additional sensors supported by Legrand PDUs: The CLI command(s) listed above can be also applied to the following sensors. Note that the measurement unit of current values in CLI is A, not mA.
Page 371
<n> <p> <sensor type> assertionTimeout <as_value> Variables: <n> is the number of the inlet whose pole sensors you want to configure. For a single-inlet PDU, <n> is always 1. <p> is the label of the inlet pole that you want to configure.
Page 372
(on page 475). "To Assert" and Assertion Timeout Additional sensors supported by Legrand PDUs: The CLI command(s) listed above can be also applied to the following sensors. Note that the measurement unit of current values in CLI is A, not mA.
Page 373
<n> <sensor type> upperWarning <option> Set the Lower Critical threshold for an environmental sensor: config:# sensor externalsensor <n> <sensor type> lowerCritical <option> Set the Lower Warning threshold for an environmental sensor: Legrand PDU User Guide...
Page 374
<n> is the ID number of the environmental sensor that you want to configure. The ID number is available in the Legrand PDU web interface or using the command "show externalsensors <n>" in the CLI. It is an integer between 1 and 32.
Page 375
The Upper Critical threshold for the 2nd overcurrent protector's RMS current is set to 16A. It also enables the upper critical threshold if this threshold has not been enabled yet. The Upper Warning threshold for the 2nd overcurrent protector's RMS current is enabled. Legrand PDU User Guide...
<n> description "<description>" Variables: <n> is the ID number assigned to the actuator. The ID number can be found using the Legrand PDU web interface or CLI. It is an integer starting at 1. <name> is a string comprising up to 64 ASCII printable characters. The <name> variable must be enclosed in quotes when it contains spaces.
<fail_wait> is the wait time to send the next ping after a unsuccessful ping. Valid range is 3 to 600 (seconds). <resume> is the wait time before the Legrand PDU resumes pinging after declaring the monitored device "Unreachable." Valid range is 5 to 120 (seconds). ...
Page 378
<IP_host> is the IP address or host name of the IT device whose settings you want to modify. <option> is one of the options: true or false. Option Description true Enables the ping monitoring feature for the monitored device. false Disables the ping monitoring feature for the monitored device. Legrand PDU User Guide...
<fail_wait> is the wait time to send the next ping after a unsuccessful ping. Valid range is 3 to 600 (seconds). <resume> is the wait time before the Legrand PDU resumes pinging after declaring the monitored device "Unreachable." Valid range is 5 to 120 (seconds). ...
Page 380
The following command sets up two Cisco EnergyWise-related features. ® config:# energywise enabled true port 10288 Results: The EnergyWise feature implemented on the Legrand PDU is enabled. The UDP port is set to 10288. Legrand PDU User Guide...
Setting the Baud Rates The following commands set the baud rate (bps) of the serial port labeled CONSOLE on the Legrand PDU device. Change the baud rate before connecting it to the desired device, such as a computer, a Raritan's P2CIM-SER, through the serial port, or there are communications errors.
A load shedding configuration command begins with loadshedding. Unlike other CLI configuration commands, the load shedding configuration command is performed in the administrator mode rather than the configuration mode. See (on page Different CLI Modes and Prompts 271). Legrand PDU User Guide...
This section applies to outlet-switching capable models only. Outlets on the Legrand PDU can be turned on or off or power cycled through the CLI. Besides, you can cancel the power-on process while the Legrand PDU is powering on ALL outlets.
4, 5, 6, 7, 8, type outlets 3-8. between 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 Legrand PDU User Guide...
4, 5, 6, 7, 8, type outlets 3-8. between 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 Legrand PDU User Guide...
After issuing the command to power on ALL outlets, you can use the following command to stop the power-on process. power cancelSequence To quicken the operation, you can add the parameter "/y" to the end of the command, which confirms the operation. power cancelSequence /y Legrand PDU User Guide...
<n> is an actuator's ID number. The ID number is available in the Legrand PDU web interface or using the show command in the CLI. It is an integer between 1 and 32. If you entered the command without "/y", a message appears, prompting you to confirm the operation. Then: ...
8 on Unblocking a User If any user is blocked from accessing the Legrand PDU, you can unblock them at the local console. To unblock a user: 1. Log in to the CLI interface using any terminal program via a local connection. See With HyperTerminal (on page 270).
<n> is the inlet number. <outlet_n> is an outlet number. Resetting to Factory Defaults The following commands restore all settings of the Legrand PDU to factory defaults. To reset Legrand PDU settings after login, use either command: reset factorydefaults -- OR -- reset factorydefaults /y ...
Showing Network Connections This command syntax displays network connections and/or status of ports. diag> netstat <option> Variables: <option> is one of the options: ports or connections. Option Description ports Shows TCP/UDP ports. connections Shows network connections. Legrand PDU User Guide...
Page 391
The command looks like the following when it includes all options: diag> ping <host> count <number1> size <number2> timeout <number3> Tracing the Route This command syntax traces the network route between your Legrand PDU and a network host. diag> traceroute <host> Variables: ...
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 administrator mode and the # prompt is displayed. 2. Type exit and press Enter. Legrand PDU User Guide...
Page 393
1. Type the following SCP command and press Enter. scp <firmware file> <user name>@<device ip>:/fwupdate <firmware file> is the Legrand PDU firmware's filename. If the firmware file is not in the current directory, you must include the path in the filename. ...
Page 394
<user name>@<device ip>:/backup_settings.txt <user name> is the "admin" or any user profile with the administrator privileges. <device ip> is the IP address of the Legrand PDU whose settings you want to back up. 2. Type the user password when prompted.
Page 395
<user name> is the "admin" or any user profile with the administrator privileges. <device ip> is the IP address of the Legrand PDU whose settings you want to restore. 2. Type the user password when prompted. 3. The system copies the configuration included in the file "backup_settings.txt" to the Legrand PDU, and displays the following message.
Page 396
Privileges" privileges. <device ip> is the IP address of the Legrand PDU whose diagnostic data you want to download. <port> is the current SSH/SCP port number, or the port number of a specific slave device in the Port-Forwarding chain.
Page 397
Sensor RJ-45 Port Pinouts ..............397 Maximum Ambient Operating Temperature Make sure the environment does NOT exceed the maximum ambient operating temperature (TMA) when operating your Legrand PDU. If necessary, contact Legrand Technical Support for this information of your model. Measure...
Page 398
Data Negative of the RS-485 bus ― Signal Ground 1-wire ― 1-wire signal for Raritan environmental sensor packages ― Signal Ground Note: A maximum of 500mA power is permitted for both pin 1 and pin 2 altogether. Legrand PDU User Guide...
Page 399
Equipment Setup Worksheet Legrand PDU Series Model ____________ Legrand PDU Series Serial Number ____________ OUTLET 1 OUTLET 2 OUTLET 3 MODEL MODEL MODEL SERIAL NUMBER SERIAL NUMBER SERIAL NUMBER OUTLET 4 OUTLET 5 OUTLET 6 MODEL MODEL MODEL SERIAL NUMBER...
Page 400
SERIAL NUMBER SERIAL NUMBER SERIAL NUMBER OUTLET 10 OUTLET 11 OUTLET 12 MODEL MODEL MODEL SERIAL NUMBER SERIAL NUMBER SERIAL NUMBER OUTLET 13 OUTLET 14 OUTLET 15 MODEL MODEL MODEL SERIAL NUMBER SERIAL NUMBER SERIAL NUMBER Legrand PDU User Guide...
Page 401
MODEL MODEL SERIAL NUMBER SERIAL NUMBER SERIAL NUMBER OUTLET 22 OUTLET 23 OUTLET 24 MODEL MODEL MODEL SERIAL NUMBER SERIAL NUMBER SERIAL NUMBER Types of adapters _________________________________________________________ Types of cables _________________________________________________________ Name of software program _________________________________________________________ Legrand PDU User Guide...
Page 402
Firmware Upgrade via USB ..............410 Device Configuration/Upgrade Procedure You can use one USB drive to configure or upgrade multiple Legrand PDUs one by one as long it contains valid configuration files. To use a USB drive to configure the Legrand PDU or upgrade firmware: 1.
Page 403
7. Wait for several seconds until the Legrand PDU resumes normal operation, indicated by the normal message of the display. If nothing is shown on the display and no task is performed after plugging the USB drive, check the log file in the USB drive.
Page 404
Each value in the file must be separated by an equal sign (=), without any surrounding spaces. Keys are not case sensitive. Illustration: This section only explains common options in the file. Note: To make sure all of the following options work fine, you must update your Legrand PDU to the latest firmware version. user ...
Page 405
NEW firmware version instead of the current firmware version. collect_diag If this option is set to true, the diagnostic data of the Legrand PDU is transmitted to the USB drive. The filename of the diagnostic data written into the USB drive is: diag_<unit-serial>.zip...
Page 406
Legrand PDU model. You can use Legrand's Mass Deployment Utility to create this file by yourself, or contact Legrand to get a device configuration file specific to your Legrand PDU model and firmware version.
Page 407
"devices.csv" file. The syntax is: ${column}, where "column" is a column number. Examples: net.interfaces[eth0].ipv4.static.addr_cidr.addr=${4} pdu.name=${16} To rename the admin user: You can rename the admin user by adding the following configuration key: users[0].name=new admin name Example: users[0].name=May Legrand PDU User Guide...
Page 408
Referenced in the device_list option of the "fwupdate.cfg" file. See (on page 404). fwupdate.cfg Every Legrand PDU identifies its entry in the "devicelist.csv" file by comparing its serial number or MAC address to one of the columns in the file. Determine the column to identify Legrand PDUs: ...
Page 409
If an appropriate "config.txt" is not created yet, see Creating Configuration Files via Mass (on page 408). Deployment Utility 2. Launch a terminal to log in to the CLI of any Legrand PDU running version 3.4.11 or later. See Logging (on page 269). in to CLI 3.
Page 410
The front panel display shows the firmware upgrade progress. Tip: You can remove the USB drive and plug it into another Legrand PDU for firmware upgrade when the firmware upgrade message displays. 5. It may take one to five minutes to complete the firmware upgrade, depending on your product.
Page 411
Firmware upgrade Downloading diagnostic data This feature is drastically useful if you have hundreds or even thousands of Legrand PDUs to configure or upgrade. Warning: The feature of bulk configuration or firmware upgrade via DHCP/TFTP only works on standalone Legrand PDUs directly connected to the network.
Page 412
Bulk (on page 411). Configuration/Upgrade Procedure If you are going to upload any Legrand PDU diagnostic file or create a log file in the TFTP server, the first of the following requirements is also required. The TFTP server supports the write operation, including file creation and upload.
Page 413
Click Add to add a new vendor class. c. Specify a unique name for this vendor class and type the binary codes of "Raritan PDU 1.0" in the New Class dialog. The vendor class is named "Raritan PDU" in this illustration.
Page 414
Select DHCP Standard Options in the "Option class" field, and Vendor Class Identifier in the "Option name" field. Leave the String field blank. 3. Add three options to the new vendor class "Raritan PDU" in the same dialog. a. Select Raritan PDU in the "Option class" field.
Page 415
Click Add to add the first option. Type "pdu-tftp-server" in the Name field, select IP Address as the data type, and type 1 in the Code field. c. Click Add to add the second option. Type "pdu-update-control-file" in the Name field, select String as the data type, and type 2 in the Code field.
Page 416
The policy is named "PDU" in this illustration. c. Click Add to add a new condition. d. Select the vendor class "Raritan PDU" in the Value field, click Add and then Ok. e. Click Next. Legrand PDU User Guide...
Page 417
Select DHCP Standard Options in the "Vendor class" field, select "060 Vendor Class Identifier" from the Available Options list, and type "Raritan PDU 1.0" in the "String value" field. Legrand PDU User Guide...
Page 418
Select the "Raritan PDU" in the "Vendor class" field, select "001 pdu-tftp-server" from the Available Options list, and type your TFTP server's IPv4 address in the "IP address" field. Legrand PDU User Guide...
Page 419
Select "002 pdu-update-control-file" from the Available Options list, and type the filename "fwupdate.cfg" in the "String value" field. Select "003 pdu-update-magic" from the Available Options list, and type any string in the "String value" field. This third option/code is the magic cookie to prevent the fwupdate.cfg commands from being executed repeatedly.
Page 420
Important: The magic cookie is transmitted to and stored in Legrand PDU at the time of executing the "fwupdate.cfg" commands. The DHCP/TFTP operation is triggered only when there is a mismatch between the magic cookie in DHCP and the one stored in Legrand PDU. Therefore, you must modify the magic cookie's value in DHCP when intending to execute the "fwupdate.cfg"...
Page 421
Specify a unique name for the vendor class, type "13742" in the "Vendor ID (IANA)" field, and type the binary codes of "Raritan PDU 1.0" in the New Class dialog. The vendor class is named "Raritan PDU 1.0" in this illustration.
Page 422
Select Raritan PDU 1.0 in the "Option class" field. c. Click Add to add the first option. Type "pdu-tftp-server" in the Name field, select IP Address as the data type, and type 1 in the Code field. Legrand PDU User Guide...
Page 423
Click Add to add the second option. Type "pdu-update-control-file" in the Name field, select String as the data type, and type 2 in the Code field. e. Click Add to add the third one. Type "pdu-update-magic" in the Name field, select String as the data type, and type 3 in the Code field.
Page 424
Select "Raritan PDU 1.0" in the "Vendor class" field, select "00001 pdu-tftp-server" from the Available Options list, and type your TFTP server's IPv6 address in the "IPv6 address" field. Legrand PDU User Guide...
Page 425
Select "00002 pdu-update-control-file" from the Available Options list, and type the filename "fwupdate.cfg" in the "String value" field. e. Select "00003 pdu-update-magic" from the Available Options list, and type any string in the "String value" field. This third option/code is the magic cookie to prevent the fwupdate.cfg commands from being executed repeatedly.
Page 426
Important: The magic cookie is transmitted to and stored in Legrand PDU at the time of executing the "fwupdate.cfg" commands. The DHCP/TFTP operation is triggered only when there is a mismatch between the magic cookie in DHCP and the one stored in Legrand PDU. Therefore, you must modify the magic cookie's value in DHCP when intending to execute the "fwupdate.cfg"...
Page 427
Important: The magic cookie is transmitted to and stored in Legrand PDU at the time of executing the "fwupdate.cfg" commands. The DHCP/TFTP operation is triggered only when there is a mismatch between the magic cookie in DHCP and the one stored in Legrand PDU. Therefore, you must modify the magic cookie's value in DHCP when intending to execute the "fwupdate.cfg"...
Page 428
Important: The magic cookie is transmitted to and stored in Legrand PDU at the time of executing the "fwupdate.cfg" commands. The DHCP/TFTP operation is triggered only when there is a mismatch between the magic cookie in DHCP and the one stored in Legrand PDU. Therefore, you must modify the magic cookie's value in DHCP when intending to execute the "fwupdate.cfg"...
Page 429
Note: PuTTY is a free program you can download from the Internet. See PuTTY's documentation for details on configuration. 3. Press (and release) the Reset button of the Legrand PDU device while pressing the Esc key of the keyboard several times in rapid succession. A prompt (=>) should appear after about one second.
Page 430
To reset to factory defaults without logging in to the CLI: The Legrand PDU provides an easier way to reset the product to factory defaults in the CLI prior to login. 1. Connect to the Legrand PDU and launch a terminal emulation program as described in the above procedure.
Page 431
The PX_Admin role will have full system and outlet permissions. Step B. Configure User Groups on the AD Server You must create the groups (roles) for the Legrand PDU on the AD server, and then make appropriate users members of these groups.
Page 432
3. Add the pxuser and userb accounts to the PX_Admin group. 4. Verify whether each group comprises correct users. Step C. Configure LDAP Authentication on the Legrand PDU You must enable and set up LDAP authentication properly on the Legrand PDU to use external authentication. In the illustration, we assume: ...
Page 433
6. Click Save. The LDAP authentication is activated. Note: If the Legrand PDU clock and the LDAP server clock are out of sync, the installed TLS certificates, if any, may be considered expired. To ensure proper synchronization, administrators should configure the Legrand PDU and the LDAP server to use the same NTP server(s).
Page 434
Type PX_Admin in the Role Name field. b. Type a description for the PX_Admin role in the Description field. In this example, we type "Includes all PX privileges" to describe the role. Legrand PDU User Guide...
Page 435
In the Privileges list, select Administrator Privileges. The Administrator Privileges allows users to configure or change all Legrand PDU settings. d. Click Save. The PX_Admin role is created. Legrand PDU User Guide...
From LDAP/LDAPS When an LDAP/LDAPS authentication is successful, the Legrand PDU determines the permissions for a given user based on the permissions of the user's role. Your remote LDAP server can provide these user role names by returning an attribute named as follows:...
2. Right-click Attributes in the left pane. 3. Click New and then choose Attribute. When the warning message appears, click Continue and the Create New Attribute dialog appears. 4. Type rciusergroup in the Common Name field. Legrand PDU User Guide...
1. Click Classes in the left pane of the window. 2. Scroll to the user class in the right pane and right-click it. 3. Choose Properties from the menu. The user Properties dialog appears. 4. Click the Attributes tab to open it. 5. Click Add. Legrand PDU User Guide...
Active Directory, allowing you to perform common administrative tasks such as adding, deleting, and moving objects with a directory service. To edit the individual user attributes within the group rciusergroup: 1. From the installation CD, choose Support > Tools. 2. Double-click SUPTOOLS.MSI to install the support tools. Legrand PDU User Guide...
Page 440
4. Open the Domain. 5. In the left pane of the window, select the CN=Users folder. 6. Locate the user name whose properties you want to adjust in the right pane. Right-click the user name and select Properties. Legrand PDU User Guide...
Page 441
7. Click the Attribute Editor tab if it is not already open. Choose rciusergroup from the Attributes list. 8. Click Edit. The String Attribute Editor dialog appears. 9. Type the user role (created in the Legrand PDU) in the Edit Attribute field. Click OK. Legrand PDU User Guide...
Page 442
Adding Radius Servers 2. Configure roles on the Legrand PDU. See (on page 135). Creating Roles 3. Configure Legrand PDU user credentials and roles on your RADIUS server. To configure using standard attributes, see (on page 442). Standard Attributes ...
Page 443
Step A: Add Your Legrand PDU as a RADIUS Client The RADIUS implementation on a Legrand PDU follows the standard RADIUS Internet Engineering Task Force (IETF) specification so you must select "RADIUS Standard" as its vendor name when configuring the NPS server.
Page 444
Verify the authentication and accounting port numbers shown in the properties dialog are the same as those specified on your Legrand PDU. In this example, they are 1812 and 1813. Then close this dialog. 3. Under "RADIUS Clients and Servers," right-click RADIUS Client and select New RADIUS Client. The New RADIUS Client dialog appears.
Page 445
Type the shared secret in the "Shared secret" and "Confirm shared secret" fields. The shared secret must be the same as the one specified on your Legrand PDU. 5. Click OK. Legrand PDU User Guide...
Page 446
Step B: Configure Connection Policies and Standard Attributes You need to configure the following for connection request policies: IP address or host name of the Legrand PDU Connection request forwarding method Authentication method(s) Standard RADIUS attributes ...
Page 447
2. Right-click Connection Request Policies and select New. The New Connection Request Policy dialog appears. 3. Type a descriptive name for identifying this policy in the "Policy name" field. You can leave the "Type of network access server" field to the default -- Unspecified. Legrand PDU User Guide...
Page 448
4. Click Next to show the "Specify Conditions" screen. Click Add. 5. The "Select condition" dialog appears. Click Add. Legrand PDU User Guide...
Page 449
6. The NAS IPv4 Address dialog appears. Type the Legrand PDU IP address -- 192.168.56.29, and click 7. Click Next in the New Connection Request Policy dialog. 8. Select "Authenticate requests on this server" because a local NPS server is used in this example. Then click Next.
Page 450
Note: Connection Request Forwarding options must match your environment. 9. When the system prompts you to select the authentication method, select the following two options: Override network policy authentication settings CHAP -- the Legrand PDU uses "CHAP" in this example Legrand PDU User Guide...
Page 451
Note: If your Legrand PDU uses PAP, then select "PAP." 10. Select Standard to the left of the dialog and then click Add. Legrand PDU User Guide...
Page 452
11. Select Filter-Id from the list of attributes and click Add. 12. In the Attribute Information dialog, click Add. 13. Select String, type Raritan:G{Admin} in the text box, and then click OK. Legrand PDU User Guide...
Page 453
Admin inside the curved brackets {} is the existing role on the Legrand PDU. It is recommended to use the Admin role to test this configuration. The role name is case sensitive. 14. The new attribute is added. Click OK.
Page 454
15. Click Next to continue. 16. A summary showing connection request policy settings is displayed. Click Finish to close the dialog. Legrand PDU User Guide...
Page 455
To configure Windows 2008 NPS with the vendor-specific attribute, you must: a. Add your Legrand PDU to NPS. See (on page Step A: Add Your Legrand PDU as a RADIUS Client 443). b. On the NPS, configure connection request policies and the vendor-specific attribute. See Step B: (on page 459).
Page 456
Step A: Add Your Legrand PDU as a RADIUS Client The RADIUS implementation on a Legrand PDU follows the standard RADIUS Internet Engineering Task Force (IETF) specification so you must select "RADIUS Standard" as its vendor name when configuring the NPS server.
Page 457
Verify the authentication and accounting port numbers shown in the properties dialog are the same as those specified on your Legrand PDU. In this example, they are 1812 and 1813. Then close this dialog. 3. Under "RADIUS Clients and Servers," right-click RADIUS Client and select New RADIUS Client. The New RADIUS Client dialog appears.
Page 458
Type the shared secret in the "Shared secret" and "Confirm shared secret" fields. The shared secret must be the same as the one specified on your Legrand PDU. 5. Click OK. Legrand PDU User Guide...
Page 459
Local NPS server is used RADIUS protocol selected on your Legrand PDU = CHAP Existing roles of your Legrand PDU = Admin, User and SystemTester Illustration: 1. Open the NPS console, and expand the Policies folder. Legrand PDU User Guide...
Page 460
2. Right-click Connection Request Policies and select New. The New Connection Request Policy dialog appears. 3. Type a descriptive name for identifying this policy in the "Policy name" field. You can leave the "Type of network access server" field to the default -- Unspecified. Legrand PDU User Guide...
Page 461
4. Click Next to show the "Specify Conditions" screen. Click Add. 5. The "Select condition" dialog appears. Click Add. Legrand PDU User Guide...
Page 462
6. The NAS IPv4 Address dialog appears. Type the Legrand PDU IP address -- 192.168.56.29, and click 7. Click Next in the New Connection Request Policy dialog. 8. Select "Authenticate requests on this server" because a local NPS server is used in this example. Then click Next.
Page 463
Note: Connection Request Forwarding options must match your environment. 9. When the system prompts you to select the authentication method, select the following two options: Override network policy authentication settings CHAP -- the Legrand PDU uses "CHAP" in this example Legrand PDU User Guide...
Page 464
Note: If your Legrand PDU uses PAP, then select "PAP." 10. Select Vendor Specific to the left of the dialog, and click Add. The Add Vendor Specific Attribute dialog appears. 11. Select Custom in the Vendor field, and click Add. The Attribute Information dialog appears.
Page 465
2. Type the following in the Raritan dictionary file. VENDOR Raritan 13742 BEGIN-VENDOR Raritan ATTRIBUTE Raritan-User-Roles 26 string END-VENDOR Raritan Step B -- create a user profile for "steve" in FreeRADIUS: 1. Go to this location: /etc/raddb/users. Legrand PDU User Guide...
Page 466
2. Add the data of the user "steve" by typing the following. Note that the values after the equal sign (=) must be enclosed in double quotes ("). steve Cleartext-Password := "test123" Raritan-PDU-User-Roles = "Raritan:G{Admin User SystemTester}" AD-Related Configuration When RADIUS authentication is intended, make sure you also configure the following settings related to Microsoft Active Directory (AD): ...
Page 467
3. Click OK, and then OK again. To grant Legrand PDU users remote access permission: 1. Open Active Directory Users and Computers. 2. Open the properties dialog of the user whom you want to grant the access permission. Legrand PDU User Guide...
Page 468
3. Click the Dial-in tab and select the "Allow access" checkbox. To enable reversible encryption for CHAP authentication: 1. Open Active Directory Users and Computers. 2. Open the properties dialog of the user that you want to configure. Legrand PDU User Guide...
Page 469
3. Click the Account tab and select the "Store password using reversible encryption" checkbox. Legrand PDU User Guide...
The Legrand PDU uses its serial number as the client identifier in the DHCP request. Therefore, to successfully reserve an IP address for the Legrand PDU in a DHCP server, use the Legrand PDU device's serial number as the unique ID instead of the MAC address.
Page 471
(on page 470). Reserving IP Addresses in DHCP Servers In the following illustration, it is assumed that the Legrand PDU serial number is PEG1A00003. Windows IP address reservation illustration: 1. Convert the client identifier of the desired network interface into ASCII codes (hexadecimal).
Page 472
(on page 470). Reserving IP Addresses in DHCP Servers In the following illustrations, it is assumed that the Legrand PDU serial number is PEG1A00003, and the IP address you want to reserve is 192.168.20.1. Illustration with ASCII code conversion: 1.
A numeric sensor has four thresholds: Lower Critical, Lower Warning, Upper Warning and Upper Critical. The threshold settings determine how many sensor states are available for a certain sensor and the range of each sensor state. The diagram below shows how each threshold relates to each state. Legrand PDU User Guide...
Page 474
When a sensor has both the Upper Critical and Upper Warning thresholds enabled, it has three sensor states: normal, above upper warning, and above upper critical. States of "above upper warning" and "below lower warning" are warning states to call for your attention. Legrand PDU User Guide...
Page 475
(on page 120). Yellow- or Red-Highlighted Sensors "To Assert" and Assertion Timeout If multiple sensor states are available for a specific sensor, the Legrand PDU asserts a state for it whenever a bad state change occurs. To assert a state: To assert a state is to announce a new, "worse"...
Page 476
In the threshold settings, the Assertion Timeout field postpones the "assertion" action. It determines how long a sensor must remain in the "worse" new state before the Legrand PDU triggers the "assertion" action. If that sensor changes its state again within the specified wait time, the Legrand PDU does NOT assert the worse state.
Page 477
"To De-assert" and Deassertion Hysteresis After the Legrand PDU asserts a worse state for a sensor, it may de-assert that state later on if the readings improve. To de-assert a state: To de-assert a state is to announce the end of the previously-asserted worse state.
Page 478
How "Deassertion Hysteresis" is helpful: If you have created an event rule that instructs the Legrand PDU to send notifications for deassertion events, setting the "Deassertion Hysteresis" is helpful for eliminating a number of notifications that you may receive in case a sensor's readings fluctuate around a certain threshold.
Default Voltage and Current Thresholds The following are factory-default voltage and current thresholds applied to a Legrand power product. There are no default values set for lower current thresholds because lower thresholds are not useful. Availability of diverse thresholds depends on the capability of the model you purchased.
Altitude Correction Factors If a Legrand 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 be multiplied by the correction factor to get a correct reading.
100 * (0.1837) = 18% Ways to Probe Existing User Profiles This section indicates available ways to query existing user accounts on the Legrand PDU. With SNMP v3 activated, you get the "user unknown" error when the user name used to authenticate does not exist.
Possible Root Causes The following lists the network accessibility issues and possible root causes. You can always troubleshoot the software settings by connecting the Legrand PDU to a computer if network access to that Legrand PDU fails. See (on page 30).
Page 483
3.3.10 or later. Tip: To determine which Legrand PDU may be the failure point of network, you may ping each Legrand PDU in the cascading chain, or check the slave-related events in the event log of each Legrand PDU. See...
Page 484
However, in the Port Forwarding mode, whenever the connection or disconnection of a downstream slave device via USB is detected, the Legrand PDU at the USB-A end of the USB cable logs it in the internal log. Note that the Legrand PDU at the USB-B end of the cable does NOT log these events.
The Ping Tool The Legrand PDU provides a ping tool in the web interface and CLI so you can ping any host or Legrand PDU in your data center. Ping via the Web Interface: To log in to the web interface, see (on page 79).
Note: If the Legrand PDU enters the disaster recovery mode when the USB serial driver is not installed yet, it may be shown as a 'GPS camera' in the Device Manager on the computer connected to it. In Linux: No additional drivers are required, but you must provide the name of the tty device, which can be found in the output of the "dmesg"...
Page 487
IPv4 or IPv6 network dns firstServer <ip primary DNS address> server <ip address> = DNS server's IP address IPv4 or IPv6 network dns secondServer <ip secondary address> DNS server <ip address> = DNS server's IP address Legrand PDU User Guide...
Page 488
<inner_auth> <inner_auth> = MSCHAPv2 EAP identity network wireless eapIdentity <identity> <identity> = your user name for EAP authentication EAP password network wireless eapPassword When prompted to enter the password for EAP authentication, type the password. Legrand PDU User Guide...
Page 489
To verify network settings: After exiting the above configuration mode and the # prompt re-appears, type this command to verify all network settings. show network The IP address configured may take seconds to take effect. Legrand PDU User Guide...
A certificate or a chain of certificates is used for trusting a TLS server that you want to connect. The receiver, such as Legrand PDU, can trust a TLS server only after an appropriate certificate (chain) which is "related to" that TLS server's certificate is uploaded to the receiver.
Page 491
PDU, it means you trust each certificate in the chain to certify the authenticity of certificates a server sends to Legrand PDU. Therefore, at least the root certificate must be authentic, issued by a CA you trust, and downloaded from that CA over a secure channel. Never implicitly trust a root certificate that is sent by the server which you want to connect to.
Page 492
For Legrand PDU, if any required certificate is missing, a certificate error message similar to the following is shown on the Legrand PDU web interface. It is NOT recommended to upload the server certificate to the receiver except when it is a self-signed certificate.
Page 493
5. As the server has the server certificate and two intermediate certificates, we conclude that this server sends a partial certificate chain to the receiver. 6. Check whether the issuer "Equifax Secure Certificate Authority" is the root CA. Legrand PDU User Guide...
Step 3 -- Upload the missing certificate(s) to Legrand PDU: 1. Paste the root certificate's content into a plain text file that will be uploaded to Legrand PDU. Content copying must include the lines of "BEGIN CERTIFICATE" and "END CERTIFICATE".
Page 495
9. To email any URL link to the currently selected topic to any person, click the "Email this page" icon in the toolbar. 10. To email your comments or suggestions regarding the online help to Legrand, click the "Send feedback" icon 11.
Page 496
You can access the CLI of the Legrand PDU via SX / SX II. To only access the CLI of the Legrand PDU via SX / SX II, treat the Legrand PDU as a serial device by connecting SX /SX II to the PDU's serial port labeled CONSOLE.
Page 497
The Legrand PDU is categorized ® as a power item in dcTrack. dcTrack offers an import wizard for conveniently adding the Legrand PDU as well as other IT equipment to dcTrack for management.
Page 498
Index Available Data of the Outlets Overview Page 0 • 100, 102, 104, 105 Available Legrand PDU Models • 14 0U Button Mount • 18 B 1 Backup and Restore of Device Settings • 1U Products • 15 228, 237, 241, 403 1U/2U Legrand Clip Mount •...
Page 499
Connecting the Legrand PDU to Your Checking the Accessibility of NTP Servers • Network • 22, 24, 139 Connecting the PDU to a Power Source • 22 Checking the Branch Circuit Rating • 16 Connection Port Functions • 24, 55 Circuit Breaker Orientation Limitation •...
Page 500
Example - Power Cycling Specific Outlets • Control • 335 Enabling or Disabling Front Panel Outlet Example - Server Settings Changed • 377 Switching • 335 Example - Setting Up EnergyWise • 378 Enabling or Disabling Load Shedding • 381 Legrand PDU User Guide...
Page 501
440, 453 Example 1 - Networking Mode • 317 FreeRADIUS VSA Illustration • 453, 463 Example 1 - PDU Naming • 297 From LDAP/LDAPS • 434 Example 1 - Time Setup Method • 320 From Microsoft Active Directory • 434 Example 1 - Upper Critical Threshold for a Front Panel Display •...
Page 502
Interface Names • 147, 149 Rule • 333 Introduction • 14 Modifying a User Profile • 340 Introduction to PDU Components • 54 Modifying a User's Personal Data • 341 IP Configuration • 271, 272 Modifying an Existing LDAP Server • 357 IPv4-Only or IPv6-Only Configuration •...
Page 504
Static Route Examples • 139, 142, 147, 300, Setting the Outlet Power-On Sequence Step A Delay • 292 Add Your Legrand PDU as a RADIUS Setting the PDU-Defined Cycling Power-Off Client • 440, 441, 453, 454 Period • 293, 338 Step A.
Page 505
Unblocking a User • 177, 386 Zero U Products • 14 Unpacking the Product and Components • Updating the LDAP Schema • 434 Updating the Legrand PDU Firmware • 228, 235, 391 Updating the Schema Cache • 437 Uppercase Character Requirement • 330 USB Wireless LAN Adapters •...
Need help?
Do you have a question about the PDU and is the answer not in the manual?
Questions and answers