Page 2 Using the PRO3X Command Line Interface (CLI) PRO3X User Guide – Command Line Interface (CLI) 2 of 182...
Page 3 Using the PRO3X Command Line Interface (CLI) About Your User Guide This user guide was designed for data center staff and administrators who monitor power, control outlet actions, and direct equipment operations in the data center network using the Command Line Interface (CLI) on the PRO3X product group.
Page 4: Contact Technical Support
Server Technology understands that there are often questions when installing and/or using a new product. Free Technical Support is provided from 8 a.m. to 5 p.m. Pacific Time, Monday through Friday. Server Technology, Inc. (a brand of Legrand) 1040 Sandhill Road...
Page 5: Safety Precautions
Using the PRO3X Command Line Interface (CLI) Safety Precautions This section contains important safety/regulatory information that must be reviewed before installing and using the PRO3X PDU. Only for installation and use in a Destiné à l'installation et l'utilisation dans le Nur für Installation und Gebrauch in Restricted Access Location in cadre de Restricted Access Location selon...
Page 6 Using the PRO3X Command Line Interface (CLI) ATTENTION! Observe precautions for Attention ! Respecter les mesures de sécurité Achtung! Vorsichtshinweise zur Handhabung handling Electrostatic Sensitive Devices. en manipulant des dispositifs sensibles aux elektrostatisch empfindlicher Geräte beachten. décharges électrostatiques. Products rated for 240/415VAC may be Les produits prévus pour 240/415VAC peut Produkte die für 240/415VAC zugelassen sind fitted with a plug that is rated for a higher...
Page 7: Attaching Safety Earth Ground Connection
Using the PRO3X Command Line Interface (CLI) Attaching Safety Earth Ground Connection Server Technology PDUs are supplied with an external safety ground connection to provide an alternate ground path for fault currents, and to maintain the same ground reference between it and the equipment rack. Note: The auxiliary external ground location may vary.
Page 8: Using The Command Line Interface
Using the PRO3X Command Line Interface (CLI) Using the Command Line Interface This user guide explains how to use the command line interface (CLI) to administer the PRO3X. Note that available CLI commands are model dependent. CLI commands are case sensitive. About the Interface The PRO3X provides a command line interface that enables data center administrators to perform some basic management tasks.
Page 9 Using the PRO3X Command Line Interface (CLI) 4. Type a name and press Enter. The name is case sensitive. Then you are prompted to enter a password. 5. Type a password and press Enter. The password is case sensitive. After properly entering the password, the # or > system prompt appears. Tip: The 'Last login' information, including the date and time, is also displayed if the same user account was used to log in to this product's web interface or CLI.
Page 10 Using the PRO3X Command Line Interface (CLI) With an Analog Modem The PRO3X supports remote access to the CLI via a connected analog modem. This feature is especially useful when the LAN access is not available. To connect to the PRO3X via the modem: 1.
Page 11: The ? Command For Showing Available Commands
Using the PRO3X Command Line Interface (CLI) Closing the Local Connection Close the window or terminal emulation program when you finish accessing the PRO3X over the local connection. When accessing or upgrading multiple PRO3X devices, do not transfer the local connection cable from one device to another without closing the local connection window first.
Page 12: Querying Available Parameters For A Command
Using the PRO3X Command Line Interface (CLI) Querying Available Parameters for a Command If you are not sure what commands or parameters are available for a particular type of CLI command or its syntax, you can have the CLI show them by adding a space and the help command (?) or list command (ls) to the end of that command. A list of available parameters and their descriptions will be displayed.
Page 13 Using the PRO3X Command Line Interface (CLI) IP Configuration This command shows the IP settings shared by all network interfaces, such as DNS and routes. Information shown will include both IPv4 and IPv6 configuration. show network ip common To show the IP settings of a specific network interface, use the following command. show network ip interface <ETH>...
Page 14: Ipv4-Only Or Ipv6-Only Configuration
Using the PRO3X Command Line Interface (CLI) IPv4-Only or IPv6-Only Configuration To show IPv4-only or IPv6-only configuration, use any of the following commands. To show IPv4 settings shared by all network interfaces, such as DNS and routes: show network ipv4 common To show IPv6 settings shared by all network interfaces, such as DNS and routes: show network ipv6 common To show the IPv4 configuration of a specific network interface:...
Page 15: Network Interface Settings
Using the PRO3X Command Line Interface (CLI) Interface Description Show the IPv4 or IPv6 configuration of all interfaces. Tip: You can also type the command without adding this option "all" to get the same data. That is, show network ipv4 interface. Network Interface Settings This command shows the specified network interface's information which is NOT related to IP configuration.
Page 16: Network Service Settings
Using the PRO3X Command Line Interface (CLI) Network Service Settings This command shows the network service settings only, including the Telnet setting, TCP ports for HTTP, HTTPS, SSH and Modbus/TCP services, and SNMP settings. show network services <option> Variables: <option> is one of the options: all, http, https, telnet, ssh, snmp, modbus and zeroconfig. Option Description Displays the settings of all network services, including...
Page 17 Using the PRO3X Command Line Interface (CLI) Outlet Information This command syntax shows the outlet information. show outlets <n> To show detailed information, add the parameter "details" to the end of the command. show outlets <n> details Variables: <n> is one of the options: all, or a number. Option Description Displays the information for all outlets.
Page 18: Overcurrent Protector Information
Using the PRO3X Command Line Interface (CLI) Variables: <n> is one of the options: all, or a number. Option Description Displays the information for all inlets. Tip: You can also type the command without adding this option "all" to get the same data. A specific inlet Displays the information for the specified inlet only.
Page 19: Default Measurement Units
Using the PRO3X Command Line Interface (CLI) Displayed information: Without the parameter details only the overcurrent protector status and name are displayed. With the parameter details more overcurrent protector information is displayed in addition to status, such as the rating and RMS current value.
Page 20: Environmental Sensor Information
Using the PRO3X Command Line Interface (CLI) Environmental Sensor Information This command syntax shows the environmental sensor's information. show externalsensors <n> To show detailed information, add the parameter "details" to the end of the command. show externalsensors <n> details Variables: <n>...
Page 21 Using the PRO3X Command Line Interface (CLI) With the parameter details more information is displayed in addition to the ID number and sensor reading, such as the serial number, sensor position, and X, Y, and Z coordinates. Environmental Sensor Package Information Different from the "show externalsensors"...
Page 22: Actuator Information
Using the PRO3X Command Line Interface (CLI) Actuator Information This command syntax shows an actuator's information. show actuators <n> To show detailed information, add the parameter "details" to the end of the command. show actuators <n> details Variables: <n> is one of the options: all, or a number. Option Description Displays the information for all actuators.
Page 23 Using the PRO3X Command Line Interface (CLI) Inlet Sensor Threshold Information This command syntax shows the specified inlet sensor's threshold-related information. show sensor inlet <n> <sensor type> To show detailed information, add the parameter "details" to the end of the command. show sensor inlet <n>...
Page 24 Using the PRO3X Command Line Interface (CLI) Additional sensors supported by specific models: Specific PRO3X models support some or all of the following sensors. 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. Sensor type Description peakCurrent...
Page 25 Using the PRO3X Command Line Interface (CLI) <sensor type> is one of the following sensor types: Sensor type Description current Current sensor voltage Voltage sensor activePower Active power sensor apparentPower Apparent power sensor powerFactor Power factor sensor activeEnergy Active energy sensor Displayed information: Without the parameter details only the reading, state, threshold, de-assertion hysteresis and assertion timeout settings of the specified inlet pole sensor are displayed.
Page 26 Using the PRO3X Command Line Interface (CLI) Overcurrent Protector Sensor Threshold Information This command is only available for models with overcurrent protectors for protecting outlets. This command syntax shows the specified overcurrent protector sensor's threshold-related information. show sensor ocp <n> <sensor type> To show detailed information, add the parameter "details"...
Page 27 Using the PRO3X Command Line Interface (CLI) Environmental Sensor Threshold Information This command syntax shows the specified environmental sensor's threshold-related information. show sensor externalsensor <n> To show detailed information, add the parameter "details" to the end of the command. show sensor externalsensor <n> details Variables: <n>...
Page 28 Using the PRO3X Command Line Interface (CLI) Environmental Sensor Default Thresholds This command syntax shows a certain sensor type's default thresholds, which are the initial thresholds applying to the specified type of sensor. show defaultThresholds <sensor type> To show detailed information, add the parameter "details" to the end of the command. show defaultThresholds <sensor type>...
Page 29 Using the PRO3X Command Line Interface (CLI) Security Settings This command shows the security settings of the PRO3X. show security To show detailed information, add the parameter "details" to the end of the command. show security details Displayed information: Without the parameter details the information including IP access control, role-based access control, password policy, and HTTPS encryption is displayed.
Page 30 Using the PRO3X Command Line Interface (CLI) Authentication Settings General authentication settings: This command displays the authentication settings of the PRO3X, including both LDAP and Radius settings. show authentication One LDAP server's settings: To show the configuration of a specific LDAP server, assign the desired LDAP server with its sequential number in the command.
Page 31: Show Roles
Using the PRO3X Command Line Interface (CLI) Existing User Profiles This command shows the data of one or all existing user profiles. show user <user_name> To show detailed information, add the parameter "details" to the end of the command. show user <user_name> details Variables: <user_name>...
Page 32: Show Serial
Using the PRO3X Command Line Interface (CLI) Variables: <role_name> is the name of the role whose permissions you want to query. The variable can be one of the following options: Option Description This option shows all existing roles. Tip: You can also type the command without adding this option "all"...
Page 33 Using the PRO3X Command Line Interface (CLI) Variables: <n> is one of the options: all, or a number. Option Description Displays all asset strip information. Tip: You can also type the command without adding this option "all" to get the same data. A specific asset Displays the settings of the asset strip connected to the strip number...
Page 34: Show Eventlog
Using the PRO3X Command Line Interface (CLI) Event Log The command used to show the event log begins with show eventlog. You can add either the limit or class parameters or both to show specific events. Show the last 30 entries: show eventlog Show a specific number of last entries in the event log: show eventlog limit <n>...
Page 35: Server Reachability Information
Using the PRO3X Command Line Interface (CLI) Event type Description serverMonitor Server-monitoring records, such as a server being declared reachable or unreachable. assetManagement Asset management events, such as asset tag connections or disconnections. Schroff LHX/SHX heat exchanger events. ® modem Modem-related events.
Page 36: Server Reachability Information For A Specific Server
Using the PRO3X Command Line Interface (CLI) Server Reachability Information for a Specific Server To show the server reachability information for a certain IT device only, use the following command. show serverReachability server <n> To show detailed information, add the parameter "details" to the end of the command. show serverReachability server <n>...
Page 37: Reliability Data
Using the PRO3X Command Line Interface (CLI) Reliability Data This command shows the reliability data. show reliability data Reliability Error Log This command shows the reliability error log. show reliability errorlog <n> Variables: <n> is one of the options: 0 (zero) or any other integer number. Option Description Displays all entries in the reliability error log.
Page 38: Example 1 - Basic Security Information
Using the PRO3X Command Line Interface (CLI) Examples This section provides examples of the show command. Example 1 - Basic Security Information The diagram shows the output of the show security command. PRO3X User Guide – Command Line Interface (CLI) 38 of 182...
Page 39: Example 2 - In-Depth Security Information
Using the PRO3X Command Line Interface (CLI) Example 2 - In-Depth Security Information More information is displayed when typing the show security details command. Example 3 - Basic PDU Information This example shows the output of the show pdu command. PRO3X User Guide –...
Page 40: Example 4 - In-Depth Pdu Information
Using the PRO3X Command Line Interface (CLI) Example 4 - In-Depth PDU Information More information is displayed when typing the show pdu details command. Displayed information varies depending on the model you purchased. Clearing Information You can use the clear commands to remove unnecessary data from the PRO3X. After typing a "clear"...
Page 41 Using the PRO3X Command Line Interface (CLI) Clearing Diagnostic Log for Network Connections This command removes all data from the diagnostic log for both the EAP authentication and WLAN connection. clear networkDiagLog -- OR -- clear networkDiagLog /y If you entered the command without "/y," a message appears, prompting you to confirm the operation. Type y to clear the log or n to abort the operation.
Page 42 Using the PRO3X Command Line Interface (CLI) Quitting Configuration Mode Both of "apply" and "cancel" commands let you quit the configuration mode. The difference is that "apply" saves all changes you made in the configuration mode while "cancel" aborts all changes. To quit the configuration mode, use either command: config:# apply...
Page 43: Specifying The Device Altitude
Using the PRO3X Command Line Interface (CLI) Setting Data Logging Measurements Per Entry This command defines the number of measurements accumulated per log entry. config:# pdu measurementsPerLogEntry <number> Variables: <number> is an integer between 1 and 600. The default is 60 samples per log entry. Specifying the Device Altitude This command specifies the altitude of your PRO3X above sea level (in meters).
Page 44: Enabling Or Disabling Peripheral Device Auto Management
Using the PRO3X Command Line Interface (CLI) Option Description freeForm Any alphanumeric string can be used for specifying the Z coordinate. Enabling or Disabling Peripheral Device Auto Management This command enables or disables the Peripheral Device Auto Management feature. config:# pdu peripheralDeviceAutoManagement <option>...
Page 45: Network Configuration Commands
Using the PRO3X Command Line Interface (CLI) Example 1 - PDU Naming The following command assigns the name "my PRO3X" to the PDU. config:# pdu name "my pro3x" Example 2 - Data Logging Enabled The following command enables the data logging feature. config:# pdu dataRetrieval enable Network Configuration Commands...
Page 46 Using the PRO3X Command Line Interface (CLI) <mode> is one of the modes: dhcp or static. Mode Description dhcp The IPv4 configuration mode is set to DHCP. static The IPv4 configuration mode is set to static IP address. Setting the IPv4 Preferred Host Name After selecting DHCP as the IPv4 configuration mode, you can specify the preferred host name, which is optional.
Page 47 Using the PRO3X Command Line Interface (CLI) Setting the IPv4 Address After selecting the static IP configuration mode, you can use this command to assign a permanent IP address to the PRO3X. config:# network ipv4 interface <ETH> address <ip address> Variables: <ETH>...
Page 48 Using the PRO3X Command Line Interface (CLI) Setting the IPv4 Gateway After selecting the static IP configuration mode, you can use this command to specify the gateway. config:# network ipv4 gateway <ip address> Variables: <ip address> is the IP address of the gateway. The value ranges from 0.0.0.0 to 255.255.255.255. 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 PRO3X and devices in the other subnet.
Page 49 Using the PRO3X Command Line Interface (CLI) Method 1: add a static route when the other network is NOT directly reachable: Method 2: add a static route when the other network is directly reachable: network ipv4 staticRoutes add <dest-1> interface <ETH> Delete an existing static route: network ipv4 staticRoutes delete <route_ID>...
Page 50: Configuring Ipv6 Parameters
Using the PRO3X Command Line Interface (CLI) Configuring IPv6 Parameters An IPv6 configuration command begins with network ipv6. Setting the IPv6 Configuration Mode This command determines the IP configuration mode. config:# network ipv6 interface <ETH> configMethod <mode> Variables: <ETH> is one of the network interfaces: ETH1/ETH2, WIRELESS, or BRIDGE. Note that you must choose/configure the bridge interface if your PRO3X is set to the bridging mode.
Page 51 Using the PRO3X Command Line Interface (CLI) Variables: <ETH> is one of the network interfaces: ETH1/ETH2, WIRELESS, or BRIDGE. Note that you must choose/configure the bridge interface if your PRO3X 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 52 Using the PRO3X Command Line Interface (CLI) Variables: <ETH> is one of the network interfaces: ETH1/ETH2, WIRELESS, or BRIDGE. Note that you must choose/configure the bridge interface if your PRO3X 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 53 Using the PRO3X Command Line Interface (CLI) Setting IPv6 Static Routes If the IPv6 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 PRO3X and devices in the other subnet. These commands are prefixed with network ipv6 staticRoutes.
Page 54 Using the PRO3X Command Line Interface (CLI) Configuring DNS Parameters Use the following commands to configure static DNS-related settings. Specify the primary DNS server: config:# network dns firstServer <ip address> Specify the secondary DNS server: config:# network dns secondServer <ip address> Specify the third DNS server: config:# network dns thirdServer <ip address>...
Page 55: Setting Lan Interface Parameters
Using the PRO3X Command Line Interface (CLI) Setting LAN Interface Parameters A LAN interface configuration command begins with network ethernet. Enabling or Disabling the LAN Interface This command enables or disables the LAN interface. config:# network ethernet <ETH> enabled <option> Variables: <ETH>...
Page 56 Using the PRO3X Command Line Interface (CLI) Changing the LAN Interface Speed This command determines the LAN interface speed. config:# network ethernet <ETH> speed <option> Variables: <ETH> is one of the options -- eth1 or eth2. Option Description eth1 ETH1 port eth2 ETH2 port <option>...
Page 57 Using the PRO3X Command Line Interface (CLI) Changing the LAN Duplex Mode This command determines the LAN interface duplex mode. config:# network ethernet <ETH> duplexMode <mode> Variables: <ETH> is one of the options -- eth1 or eth2. Option Description eth1 ETH1 port eth2 ETH2 port...
Page 58 Using the PRO3X Command Line Interface (CLI) Setting the Ethernet Authentication Method This command sets the authentication method for the selected Ethernet interface to either none or Extensible Authentication Protocol (EAP). config:# network ethernet <ETH> authMethod <method> Variables: <ETH> is one of the options -- eth1 or eth2. Option Description eth1...
Page 59 Using the PRO3X Command Line Interface (CLI) Setting Ethernet EAP Parameters When the selected Ethernet interface's authentication method is set to EAP, you must configure EAP authentication parameters, including outer authentication, inner authentication, EAP identity, client certificate, client private key, password, CA certificate, and RADIUS authentication server.
Page 60 Using the PRO3X Command Line Interface (CLI) Allow network connection with incorrect system time: network ethernet <ETH> allowConnectionWithIncorrectClock <option3> Set the RADIUS authentication server for EAP: config:# network ethernet <ETH> eapAuthServerName <FQDN> Variables: <ETH> is one of the options -- eth1 or eth2. Option Description eth1...
Page 61 Using the PRO3X Command Line Interface (CLI) <option2> is one of the options: true or false. Option Description true Always make the network connection successful even though the TLS certificate chain contains any certificate which is outdated or not valid yet. false The network connection is NOT successfully established when the TLS certificate chain contains any certificate...
Page 62 Using the PRO3X Command Line Interface (CLI) 5. Select and copy the contents as illustrated below, excluding the starting line containing "BEGIN CERTIFICATE" and the ending line containing "END CERTIFICATE." MIICjTCCAfigAwIBAgIEMaYgRzALBgkqhkiG9w0BAQQwRTELMAkGA1UEBhMCVVMxNjA0BgNVBAoTLU5hdG lvbmFsIEFlcm9uYXV0aWNzIGFuZCBTcGFjZSBBZG1pbmlzdHJhdGlvbjAmFxE5NjA1MjgxMzQ5MDUrMDgw MBcROTgwNTI4MTM0OTA1KzA4MDAwZzELMAkGA1UEBhMCVVMxNjA0BgNVBAoTLU5hdGlvbmFsIEFlcm9uYX V0aWNzIGFuZCBTcGFjZSBBZG1pbmlzdHJhdGlvbjEgMAkGA1UEBRMCMTYwEwYDVQQDEwxTdGV2ZSBTY2hv Y2gwWDALBgkqhkiG9w0BAQEDSQAwRgJBALrAwyYdgxmzNP/ts0Uyf6BpmiJYktU/w4NG67ULaN4B5CnEz7 k57s9o3YY3LecETgQ5iQHmkwlYDTL2fTgVfw0CAQOjgaswgagwZAYDVR0ZAQH/BFowWDBWMFQxCzAJBgNV BAYTAlVTMTYwNAYDVQQKEy1OYXRpb25hbCBBZXJvbmF1dGljcyBhbmQgU3BhY2UgQWRtaW5pc3RyYXRpb2 4xDTALBgNVBAMTBENSTDEwFwYDVR0BAQH/BA0wC4AJODMyOTcwODEwMBgGA1UdAgQRMA8ECTgzMjk3MDgy M4ACBSAwDQYDVR0KBAYwBAMCBkAwCwYJKoZIhvcNAQEEA4GBAH2y1VCEw/A4zaXzSYZJTTUi3uawbbFiS2 yxHvgf28+8Js0OHXk1H1w2d6qOHH21X82tZXd/0JtG0g1T9usFFBDvYK8O0ebgz/P5ELJnBL2+atObEuJy 1ZZ0pBDWINR3WkDNLCGiTkCKp0F5EWIrVDwh54NNevkCQRZita+z4IBO 6.
Page 63 Using the PRO3X Command Line Interface (CLI) Removing the Uploaded Certificate or Private Key The procedures of removing an existing client certificate, client private key or CA certificate in CLI are similar. This section illustrates such a procedure for the Ethernet interface "ETH1." To remove a certificate or private key for ETH1: 1.
Page 64: Setting Wireless Parameters
Using the PRO3X Command Line Interface (CLI) Setting Wireless Parameters You must configure wireless parameters, including Service Set Identifier (SSID), authentication method, Pre-Shared Key (PSK), and Basic Service Set Identifier (BSSID) after the wireless networking mode is enabled. A wireless configuration command begins with network wireless. Note: If wireless networking mode is not enabled, the SSID, PSK and BSSID values are not applied until the wireless networking mode is enabled.
Page 65 Using the PRO3X Command Line Interface (CLI) Setting the Wireless Authentication Method This command sets the wireless authentication method to either PSK or Extensible Authentication Protocol (EAP). config:# network wireless authMethod <method> Variables: <method> is one of the authentication methods: PSK or EAP. Method Description The authentication method is set to PSK.
Page 66 Using the PRO3X Command Line Interface (CLI) Setting Wireless EAP Parameters When the wireless authentication method is set to EAP, you must configure EAP authentication parameters, including outer authentication, inner authentication, EAP identity, client certificate, client private key, password, CA certificate, and RADIUS authentication server.
Page 67 Using the PRO3X Command Line Interface (CLI) Allow wireless network connection with incorrect system time: network wireless allowConnectionWithIncorrectClock <option3> Set the RADIUS authentication server for EAP: config:# network wireless eapAuthServerName <FQDN> Variables: <outer_auth> is one of the options: PEAP or TLS. Option Description PEAP...
Page 68 Using the PRO3X Command Line Interface (CLI) Option Description false The network connection is NOT successfully established when the TLS certificate chain contains any certificate which is outdated or not valid yet. <option3> is one of the options: true or false. Option Description true...
Page 69: Configuring The Cascading Mode
Using the PRO3X Command Line Interface (CLI) Configuring the Cascading Mode This command determines the cascading mode. config:# network <mode> enabled <option1> Variables: <mode> is one of the following cascading modes. Mode Description bridge The Bridging mode, where each cascaded device is assigned a unique IP address.
Page 70 Using the PRO3X Command Line Interface (CLI) Variables: <option2> is one of the following cascading roles: Role Description master The device is a master device. link The device is a link device. <option3> is one of the following options: Option Description ETH1/ETH2 ETH1/ETH2 port is the port where the 1st link...
Page 71: Setting Network Service Parameters
Using the PRO3X Command Line Interface (CLI) Setting Network Service Parameters A network service command begins with network services. Setting the HTTP Port The commands used to configure the HTTP port settings begin with network services http. Change the HTTP port: config:# network services http port <n>...
Page 72 Using the PRO3X Command Line Interface (CLI) Setting the HTTPS Port The commands used to configure the HTTPS port settings begin with network services https. Change the HTTPS port: config:# network services https port <n> Enable or disable the HTTPS access: config:# network services https enabled <option>...
Page 73 Using the PRO3X Command Line Interface (CLI) Changing the Telnet Port This command changes the Telnet port. config:# network services telnet port <n> Variables: <n> is a TCP port number between 1 and 65535. The default Telnet port is 23. Changing the SSH Configuration You can enable or disable the SSH service, or change its TCP port using the CLI commands.
Page 74 Using the PRO3X Command Line Interface (CLI) Determining the SSH Authentication Method This command syntax determines the SSH authentication method. config:# network services ssh authentication <auth_method> Variables: <option> is one of the options: passwordOnly, publicKeyOnly or passwordOrPublicKey. Option Description passwordOnly Enables the password-based login only.
Page 75 Using the PRO3X Command Line Interface (CLI) Enabling or Disabling SNMP v3 This command enables or disables the SNMP v3 protocol. config:# network services snmp v3 <option> Variables: <option> is one of the options: enable or disable. Option Description enable The SNMP v3 protocol is enabled.
Page 76 Using the PRO3X Command Line Interface (CLI) 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. Setting the sysLocation Value This command sets the SNMP MIB-II sysLocation value.
Page 77 Using the PRO3X Command Line Interface (CLI) Enabling or Disabling the Read-Only Mode This command enables or disables the read-only mode for the Modbus agent. config:# network services modbus readonly <option> Variables: <option> is one of the options: true or false. Option Description true...
Page 78 Using the PRO3X Command Line Interface (CLI) <option> is one of the options: enable or disable. Option Description enable Service advertisement via the selected method (MDNS or LLMNR) is enabled. disable Service advertisement via the selected method (MDNS or LLMNR) is disabled. Examples This section illustrates several network configuration examples.
Page 79: Determining The Time Setup Method
Using the PRO3X Command Line Interface (CLI) Time Configuration Commands A time configuration command begins with time. Determining the Time Setup Method This command determines the method to configure the system date and time. config:# time method <method> Variables: <method> is one of the time setup options: manual or ntp. Mode Description manual...
Page 80: Setting Ntp Parameters
Using the PRO3X Command Line Interface (CLI) Setting NTP Parameters A time configuration command for NTP-related parameters begins with time ntp. Specify the primary time server: config:# time ntp firstServer <first_server> Specify the secondary time server: config:# time ntp secondServer <second_server> To delete the primary time server: config:# time ntp firstServer ""...
Page 81 Using the PRO3X Command Line Interface (CLI) Customizing the Date and Time To manually configure the date and time, use the following CLI commands to specify them. Note: You shall set the time configuration method to "manual" prior to customizing the date and time. Assign the date: config:# time set date <yyyy-mm-dd>...
Page 82: Setting The Automatic Daylight Savings Time
Using the PRO3X Command Line Interface (CLI) Setting the Automatic Daylight Savings Time This command determines whether the daylight saving time is applied to the time settings. config:# time autoDST <option> Variables: <option> is one of the options: enable or disable. Mode Description enable...
Page 83: Firewall Control
Using the PRO3X Command Line Interface (CLI) Checking the Accessibility of NTP Servers This command verifies the accessibility of NTP servers specified manually on your PRO3X and then shows the result. To perform this command successfully, you must: Own the "Change Date/Time Settings" permission. Customize NTP servers.
Page 84 Using the PRO3X Command Line Interface (CLI) Determine the default IPv4 firewall control policy for outbound traffic: security ipAccessControl ipv4 defaultPolicyOut <policy> IPv6 commands Enable or disable the IPv6 firewall control feature: security ipAccessControl ipv6 enabled <option> Determine the default IPv6 firewall control policy for inbound traffic: security ipAccessControl ipv6 defaultPolicyIn <policy>...
Page 85 Using the PRO3X Command Line Interface (CLI) Managing Firewall Rules You can add, delete or modify firewall rules using the CLI commands. An IPv4 firewall control rule command begins with security ipAccessControl ipv4 rule. An IPv6 firewall control rule command begins with security ipAccessControl ipv6 rule. Adding a Firewall Rule Depending on where you want to add a new firewall rule in the list, the command for adding a rule varies.
Page 86 Using the PRO3X Command Line Interface (CLI) IPv6 commands Add a new rule to the bottom of the IPv6 rules list: security ipAccessControl ipv6 rule add <direction> <ip_mask> <policy> Add a new IPv6 rule by inserting it above or below a specific rule: security ipAccessControl ipv6 rule add <direction>...
Page 87 Using the PRO3X Command Line Interface (CLI) <insert> is one of the options: insertAbove or insertBelow. Option Description insertAbove Inserts the new rule above the specified rule number. Then: new rule's number = the specified rule number Inserts the new rule below the specified rule number. insertBelow Then: new rule's number = the specified rule number + 1...
Page 88 Using the PRO3X Command Line Interface (CLI) IPv6 commands Modify an IPv6 rule's IP address and/or prefix length: security ipAccessControl ipv6 rule modify <direction> <rule_number> ipMask <ip_mask> Modify an IPv6 rule's policy: security ipAccessControl ipv6 rule modify <direction> <rule_number> policy <policy>...
Page 89: Restricted Service Agreement
Using the PRO3X Command Line Interface (CLI) Deleting a Firewall Rule The following commands remove a specific IPv4 or IPv6 rule from the list. IPv4 commands security ipAccessControl ipv4 rule delete <direction> <rule_number> IPv6 commands security ipAccessControl ipv6 rule delete <direction> <rule_number> Variables: <direction>...
Page 90 Using the PRO3X Command Line Interface (CLI) After the Restricted Service Agreement feature is enabled, the agreement's content is displayed on the login screen. Do either of the following, or the login fails: In the web interface, select the checkbox labeled "I understand and accept the restricted service agreement." Tip: To select the agreement checkbox using the keyboard, first press Tab to go to the checkbox and then Enter.
Page 91: Login Limitation
Using the PRO3X Command Line Interface (CLI) Example The following example illustrates how to specify the content of the Restricted Service Agreement. 1. Type the following command and press Enter to start entering the content. config:# security restrictedServiceAgreement bannerContent 2. Type the following content when the CLI prompts you to enter the content. IMPORTANT!! You are accessing the PRO3X.
Page 92 Using the PRO3X Command Line Interface (CLI) Password Aging This command enables or disables the password aging feature, which controls whether the password should be changed at a regular interval: config:# security loginLimits passwordAging <option> Variables: <option> is one of the options: enable or disable. Option Description enable...
Page 93 Using the PRO3X Command Line Interface (CLI) User Blocking There are different commands for changing different user blocking parameters. These commands begin with security userBlocking. You can combine multiple commands to modify the user blocking parameters at a time. Determine the maximum number of failed logins before blocking a user: security userBlocking maximumNumberOfFailedLogins <value1>...
Page 94 Using the PRO3X Command Line Interface (CLI) Minimum Password Length This command determines the minimum length of the password. config:# security strongPasswords minimumLength <value> Variables: <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>...
Page 95 Using the PRO3X Command Line Interface (CLI) Uppercase Character Requirement This command determines whether a strong password includes at least a uppercase character. security strongPasswords enforceAtLeastOneUpperCaseCharacter <option> Variables: <option> is one of the options: enable or disable. Option Description enable At least one uppercase character is required.
Page 96: Role-Based Access Control
Using the PRO3X Command Line Interface (CLI) Variables: <option> is one of the options: enable or disable. Option Description enable At least one special character is required. disable No special character is required. Maximum Password History This command determines the number of previous passwords that CANNOT be repeated when changing the password. config:# security strongPasswords passwordHistoryDepth <value>...
Page 97 Using the PRO3X Command Line Interface (CLI) IPv6 commands Enable or disable the IPv6 role-based access control feature: security roleBasedAccessControl ipv6 enabled <option> Determine the IPv6 role-based access control policy: security roleBasedAccessControl ipv6 defaultPolicy <policy> Variables: <option> is one of the options: true or false. Option Description true...
Page 98 Using the PRO3X Command Line Interface (CLI) Adding a Role-Based Access Control Rule Depending on where you want to add a new rule in the list, the command syntax for adding a rule varies. IPv4 commands Add a new rule to the bottom of the IPv4 rules list: security roleBasedAccessControl ipv4 rule add <start_ip>...
Page 99 Using the PRO3X Command Line Interface (CLI) <insert> is one of the options: insertAbove or insertBelow. Option Description Inserts the new rule above the specified rule number. insertAbove Then: new rule's number = the specified rule number insertBelow Inserts the new rule below the specified rule number. Then: new rule's number = the specified rule number + 1 <rule_number>...
Page 100 Using the PRO3X Command Line Interface (CLI) IPv6 commands Modify a rule's IPv6 address range: security roleBasedAccessControl ipv6 rule modify <rule_number> startIpAddress <start_ip> endIpAddress <end_ip> Modify an IPv6 rule's role: security roleBasedAccessControl ipv6 rule modify <rule_number> role <role> Modify an IPv6 rule's policy: security roleBasedAccessControl ipv6 rule modify <rule_number>...
Page 101 Using the PRO3X Command Line Interface (CLI) Modify all contents of an existing IPv6 rule: security roleBasedAccessControl ipv6 rule modify <rule_number> startIpAddress <start_ip> endIpAddress <end_ip> role <role> policy <policy> Variables: <rule_number> is the number of the existing rule that you want to modify. <start_ip>...
Page 102 Using the PRO3X Command Line Interface (CLI) Enabling or Disabling Front Panel Actuator Control The following CLI commands control whether you can turn on or off connected actuator(s) by operating the front panel LCD display. To enable the front panel actuator control feature: config:# security frontPanelPermissions add switchActuator To disable the front panel actuator control feature:...
Page 103 Using the PRO3X Command Line Interface (CLI) Examples This section illustrates several security configuration examples. Example 1 - IPv4 Firewall Control Configuration The following command sets up two parameters of the IPv4 access control feature. security ipAccessControl ipv4 enabled true defaultPolicyIn accept defaultPolicyOut accept Results: The IPv4 access control feature is enabled.
Page 104: Changing The Outlet Name
Using the PRO3X Command Line Interface (CLI) Example 4 - Adding an IPv4 Role-based Access Control Rule The following command creates a newIPv4 role-based access control rule and specifies its location in the list. security roleBasedAccessControl ipv4 rule add 192.168.78.50 192.168.90.100 admin deny insertAbove 3 Results: A new IPv4 role-based access control rule is added, dropping all packets from any IPv4 address between 192.168.78.50 and...
Page 105: Inlet Configuration Commands
Using the PRO3X Command Line Interface (CLI) Inlet Configuration Commands An inlet configuration command begins with inlet. You can configure an inlet by using the inlet configuration command. Changing the Inlet Name This command syntax names an inlet. config:# inlet <n> name "<name>" Variables: <n>...
Page 106: Example - Inlet Naming
Using the PRO3X Command Line Interface (CLI) Example - Inlet Naming The following command assigns the name "AC source" to the inlet 1. If your PRO3X contains multiple inlets, this command names the 1st inlet. config:# inlet 1 name "AC source" Overcurrent Protector Configuration Commands An overcurrent protector configuration command begins with ocp.
Page 107: Creating A User Profile
Using the PRO3X Command Line Interface (CLI) Creating a User Profile This command creates a new user profile. config:# user create <name> <option> <roles> After performing the user creation command, the PRO3X prompts you to assign a password to the newly-created user. Then: 7.
Page 108 Using the PRO3X Command Line Interface (CLI) Example The following procedure illustrates how to change the password of the user "May." 1. Verify that you have entered the configuration mode. 2. Type the following command to change the password for the user profile "May." config:# user modify May password 3.
Page 109 Using the PRO3X Command Line Interface (CLI) Enabling or Disabling a User Profile This command enables or disables a user profile. A user can log in to the PRO3X only after that user's user profile is enabled. config:# user modify <name> enabled <option> Variables: <name>...
Page 110 Using the PRO3X Command Line Interface (CLI) Modifying SNMPv3 Settings There are different commands to modify the SNMPv3 parameters of a specific user profile. You can combine all of the following commands to modify the SNMPv3 parameters at a time. Enable or disable the SNMP v3 access to PRO3X for the specified user: user modify <name>...
Page 111 Using the PRO3X Command Line Interface (CLI) Determine whether the privacy passphrase is identical to the authentication passphrase: user modify <name> useAuthenticationPassPhraseAsPrivacyPassPhrase <option4> Determine the privacy passphrase: user modify <name> privacyPassPhrase After performing the above command, PRO3X prompts you to enter the privacy passphrase. Determine the authentication protocol: user modify <name>...
Page 112 Using the PRO3X Command Line Interface (CLI) <option3> is one of the options: true or false. Option Description true Authentication passphrase is identical to the password. false Authentication passphrase is different from the password. <option4> is one of the options: true or false. Option Description Privacy passphrase is identical to the authentication...
Page 113 Using the PRO3X Command Line Interface (CLI) Changing the Role(s) This command changes the role(s) of a specific user. config:# user modify <name> roles <roles> Variables: <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. Changing Measurement Units You can change the measurement units displayed for temperatures, length, and pressure for a specific user profile.
Page 114: Deleting A User Profile
Using the PRO3X Command Line Interface (CLI) Option Description feet This option displays the length or height in feet. <option3> is one of the options: pascal or psi. Option Description pascal This option displays the pressure value in Pascals (Pa). This option displays the pressure value in psi.
Page 115 Using the PRO3X Command Line Interface (CLI) Changing Your Own Password Every user can change their own password via this command if they have the Change Own Password privilege. Note that this command does not begin with user. config:# password After performing this command, the PRO3X prompts you to enter both current and new passwords respectively.
Page 116: Setting Default Measurement Units
Using the PRO3X Command Line Interface (CLI) Setting Default Measurement Units Default measurement units, including temperature, length, and pressure units, apply to the PRO3X user interfaces across all users except for those whose preferred measurement units are set differently by themselves or the administrator. Diverse measurement unit commands can be combined so that you can set all default measurement units at a time.
Page 117 Using the PRO3X Command Line Interface (CLI) Examples This section illustrates several user configuration examples. Example 1 - Creating a User Profile The following command creates a new user profile and sets two parameters for the new user. config:# user create Mary enable admin Results: A new user profile "Mary"...
Page 118: Creating A Role
Using the PRO3X Command Line Interface (CLI) Creating a Role This command creates a new role, with a list of semicolon-separated privileges assigned to the role. role create <name> <privilege1>;<privilege2>;<privilege3>... If a specific privilege contains any arguments, that privilege should be followed by a colon and the argument(s). role create <name>...
Page 119 Using the PRO3X Command Line Interface (CLI) Privilege Description changeSecuritySettings Change Security Settings changeSnmpSettings Change SNMP Settings changeUserSettings Change Local User Management changeWebcamSettings Change Webcam Configuration clearLog Clear Local Event Log firmwareUpdate Firmware Update performReset Reset (Warm Start) switchActuator* Switch Actuator viewAuthSettings View Authentication Settings viewEventSetup...
Page 120: Modifying A Role
Using the PRO3X Command Line Interface (CLI) Modifying a Role You can modify diverse parameters of an existing role, including its privileges. Modify a role's description: config:# role modify <name> description "<description>" Add more privileges to a specific role: role modify <name> addPrivileges config:# <privilege1>;<privilege2>;<privilege3>...
Page 121: Determining The Authentication Method
Using the PRO3X Command Line Interface (CLI) Deleting a Role This command deletes an existing role. config:# role delete <name> Example - Creating a Role The following command creates a new role and assigns privileges to the role. config:# role create tester firmwareUpdate;viewEventSetup Results: A new role "tester"...
Page 122: Ldap Settings
Using the PRO3X Command Line Interface (CLI) Variables: <option1> is one of the options: local , ldap or radius. Option Description local Enable Local authentication only. ldap Enable LDAP authentication. radius Enable Radius authentication. <option2> is one of the options: true or false. Option Description true...
Page 123 Using the PRO3X Command Line Interface (CLI) Add a new LDAP server: authentication ldap add <host> <port> <ldap_type> <security> <bind_type> <base_DN> <login_name_att> <user_entry_class> "Optional Parameters" Note: "Optional Parameters" refer to one or multiple parameters listed in the section Optional Parameters (on page 124).
Page 124 Using the PRO3X Command Line Interface (CLI) <base_DN> is the base DN for search. <login_name_att> is the login name attribute. <user_entry_class> is the User Entry Object Class. Optional Parameters You can add one or multiple "optional parameters", such as specifying the Bind DN or certificate upload, to an LDAP-server- adding command as illustrated below.
Page 125 Using the PRO3X Command Line Interface (CLI) Variables: <filter> is the user search subfilter you specify. <bind_DN> is bind DN. <AD_domain> is the Active Directory Domain. <verify_cert> is one of the options: true or false. Option Description true Enable the verification of the LDAP server certificate. false Disable the verification of the LDAP server certificate.
Page 126 Using the PRO3X Command Line Interface (CLI) 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: Enter the CLI command with the "bindDN" parameter and its data added. authentication ldap add op-ldap.raritan.com 389 openldap none authenticatedBind cn=Manager,dc=raritan,dc=com uid inetOrgPerson bindDN user@raritan.com b.
Page 127 Using the PRO3X Command Line Interface (CLI) A list of "parameters": The following table provides a list of LDAP parameters: PRO3X User Guide – Command Line Interface (CLI) 127 of 182...
Page 128 Parameters Description Change the IP address or host name. host <host> ▪ <host> is the new IP address or host name. Using the PRO3X Command Line Interface (CLI) Change the TCP port number. port <port> ▪ <port> is the new TCP port number. Change the server type.
Page 129: Radius Settings
Using the PRO3X Command Line Interface (CLI) Change the bind DN. bindDN <bind_DN> ▪ <bind_DN> is the new bind DN. Change the bind DN password. bindPassword d. First add the "bindPassword" parameter to the command, and press Enter. e. The system prompts you for the input of the password. Type the password and press Enter.
Page 130 Using the PRO3X Command Line Interface (CLI) Adding a Radius Server You can repeat the following commands to add Radius servers one by one. Command syntax: authentication radius add <host> <rds_type> <auth_port> <acct_port> <timeout> <retries> Variables: <host> is the IP address or host name of the Radius server. <rds_type>...
Page 131 Using the PRO3X Command Line Interface (CLI) Modifying an Existing Radius Server You can modify one or multiple parameters of an existing Radius server, or change the priority or sequence of existing servers in the server list. Change the IP address or host name: authentication radius modify <server_num>...
Page 132 Using the PRO3X Command Line Interface (CLI) Change the priority of the specified server: authentication radius modify <server_num> sortPositon <position> Tip: You can add more than one parameters to the command. For example, "authentication radius modify <server_num> host <host> authType <rds_type> authPort <auth_port> accountPort <acct_port> ...". Variables: <server_num>...
Page 133: Changing The Sensor Name
Using the PRO3X Command Line Interface (CLI) Changing the Sensor Name This command names an environmental sensor. config:# externalsensor <n> name "<name>" Variables: <n> is the ID number of the environmental sensor that you want to configure. The ID number is available in the PRO3X web interface or using the command "show externalsensors <n>"...
Page 134: Setting The X Coordinate
Using the PRO3X Command Line Interface (CLI) Setting the X Coordinate This command specifies the X coordinate of an environmental sensor. config:# externalsensor <n> xlabel "<coordinate>" Variables: <n> is the ID number of the environmental sensor that you want to configure. The ID number is available in the PRO3X web interface or using the command "show externalsensors <n>"...
Page 135: Changing The Sensor Description
Using the PRO3X Command Line Interface (CLI) Changing the Sensor Description This command provides a description for a specific environmental sensor. config:# externalsensor <n> description "<description>" Variables: <n> is the ID number of the environmental sensor that you want to configure. The ID number is available in the PRO3X web interface or using the command "show externalsensors <n>"...
Page 136: Setting The Alarmed To Normal Delay For Dx-Pir
Using the PRO3X Command Line Interface (CLI) Setting the Alarmed to Normal Delay for DX-PIR This command determines the value of the Alarmed to Normal Delay setting for a presence detector. config:# externalsensor <n> alarmedToNormalDelay <time> Variables: <n> is the ID number of the environmental sensor that you want to configure. The ID number is available in the PRO3X web interface or using the command "show externalsensors <n>"...
Page 137 Using the PRO3X Command Line Interface (CLI) Set the Default Upper Critical Threshold for a specific sensor type: defaultThresholds <sensor type> upperCritical <value> Set the Default Upper Warning Threshold for a specific sensor type: defaultThresholds <sensor type> upperWarning <value> Set the Default Lower Critical Threshold for a specific sensor type: defaultThresholds <sensor type>...
Page 138 Using the PRO3X Command Line Interface (CLI) <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 relativeHumidity temperature Degrees Celsius ( ) or Fahrenheit ( ), depending...
Page 139 Using the PRO3X Command Line Interface (CLI) Example - Default Upper Thresholds for Temperature It is assumed that your preferred measurement unit for temperature is set to degrees Celsius. Then the following command sets the default Upper Warning threshold to 20 Celsius and Upper Critical threshold to 24 Celsius for all temperature sensors. defaultThresholds temperature upperWarning 20 upperCritical 24 Sensor Threshold Configuration Commands A sensor configuration command begins with sensor.
Page 140 Using the PRO3X Command Line Interface (CLI) Set the Lower Warning threshold for an inlet sensor: sensor inlet <n> <sensor type> lowerWarning <option> Set the deassertion hysteresis for an inlet sensor: sensor inlet <n> <sensor type> hysteresis <hy_value> Set the assertion timeout for an inlet sensor: sensor inlet <n>...
Page 141 Using the PRO3X Command Line Interface (CLI) <option> is one of the options: enable, disable or a numeric value. Option Description enable Enables the specified threshold for a specific inlet sensor. disable Disables the specified threshold for a specific inlet sensor.
Page 142 Using the PRO3X Command Line Interface (CLI) Commands for Inlet Pole Sensors A sensor configuration command for inlet poles begins with sensor inletpole. This type of command is available on a three- phase PDU only. You can configure various inlet pole sensor threshold settings at a time by combining multiple commands. Set the Upper Critical Threshold for an Inlet Pole: sensor inletpole <n>...
Page 143 Using the PRO3X Command Line Interface (CLI) 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. Pole Label Current sensor...
Page 144: Commands For Overcurrent Protector Sensors
Using the PRO3X Command Line Interface (CLI) <hy_value> is a numeric value that is assigned to the hysteresis for the specified inlet pole sensor. <as_value> is a number in samples that is assigned to the assertion timeout for the specified inlet pole sensor. Additional sensors supported by specific models: Specific PRO3X models support some or all of the following sensors.
Page 145 Using the PRO3X Command Line Interface (CLI) Set the Lower Warning threshold for an overcurrent protector: sensor ocp <n> <sensor type> lowerWarning <option> Set the deassertion hysteresis for an overcurrent protector: sensor ocp <n> <sensor type> hysteresis <hy_value> Set the assertion timeout for an overcurrent protector: sensor ocp <n>...
Page 146 Using the PRO3X Command Line Interface (CLI) Commands for Environmental Sensors A sensor threshold configuration command for environmental sensors begins with sensor externalsensor. You can configure various environmental sensor threshold settings at a time by combining multiple commands. Set the Upper Critical threshold for an environmental sensor: sensor externalsensor <n>...
Page 147 Using the PRO3X Command Line Interface (CLI) Set the assertion timeout for an environmental sensor: sensor externalsensor <n> <sensor type> assertionTimeout <as_value> Variables: <n> is the ID number of the environmental sensor that you want to configure. The ID number is available in the PRO3X web interface or using the command "show externalsensors <n>"...
Page 148 Using the PRO3X Command Line Interface (CLI) Examples This section illustrates several environmental sensor threshold configuration examples. Example 1 - Upper Critical Threshold for a Temperature Sensor The following command sets the Upper Critical threshold of the environmental "temperature" sensor with the ID number 2 to 40 degrees Celsius.
Page 149 Using the PRO3X Command Line Interface (CLI) Actuator Configuration Commands An actuator configuration command begins with actuator. You can configure the name and location parameters of an individual actuator. You can configure various parameters for one actuator at a time. Change the name: config:# actuator <n>...
Page 150: Example - Actuator Naming
Using the PRO3X Command Line Interface (CLI) Example - Actuator Naming The following command assigns the name "Door lock of cabinet 3" to the actuator whose ID number is 9. config:# actuator 9 name "Door lock of cabinet 3" Server Reachability Configuration Commands You can use the CLI to add or delete an IT device, such as a server, from the server reachability list, or modify the settings for a monitored IT device.
Page 151 Using the PRO3X Command Line Interface (CLI) Deleting Monitored Devices This command removes a monitored IT device from the server reachability list. config:# serverReachability delete <n> Variables: <n> is a number representing the sequence of the IT device in the monitored server list. You can find each IT device's sequence number using the CLI command of show serverReachability as illustrated below.
Page 152 Using the PRO3X Command Line Interface (CLI) serverReachability modify <n> waitTimeAfterSuccessfulPing <succ_wait> Modify the wait time after a unsuccessful ping: serverReachability modify <n> waitTimeAfterUnsuccessfulPing <fail_wait> Modify the number of consecutive "Unreachable" declarations before disabling the ping monitoring feature: serverReachability modify <n> numberOfFailuresToDisable <disable_count> Variables: <n>...
Page 153 Using the PRO3X Command Line Interface (CLI) Example - Server Settings Changed The following command modifies several ping monitoring settings for the second server in the server reachability list. serverReachability modify 2 numberOfSuccessfulPingsToEnable 10 numberOfUnsuccessfulPingsForFailure 8 waitTimeAfterSuccessfulPing 30 PRO3X User Guide – Command Line Interface (CLI) 153 of 182...
Page 154 Using the PRO3X Command Line Interface (CLI) EnergyWise Configuration Commands An EnergyWise configuration command begins with energywise. Enabling or Disabling EnergyWise This command syntax determines whether the Cisco EnergyWise endpoint implemented on the PRO3X is enabled. ® config:# energywise enabled <option> Variables: <option>...
Page 155: Changing The Udp Port
Using the PRO3X Command Line Interface (CLI) Changing the UDP Port This command syntax specifies the UDP port for communications in the Cisco EnergyWise domain. ® config:# energywise port <port> Variables: <port> is the UDP port number ranging between 1 and 65535. Setting the Polling Interval This command syntax determines the polling interval at which the Cisco EnergyWise domain queries the PRO3X.
Page 156: Asset Strip Management
Using the PRO3X Command Line Interface (CLI) Asset Management Commands You can use the CLI commands to change the settings of the connected asset strip (if any) or the settings of LEDs on the asset strip. Asset Strip Management An asset strip management configuration command begins with assetStrip. Naming an Asset Strip This command syntax names or changes the name of an asset strip connected to the PRO3X device.
Page 157 Using the PRO3X Command Line Interface (CLI) Specifying the Rack Unit Numbering Mode This command syntax specifies the numbering mode of rack units on the asset strips connected to the PRO3X device. The numbering mode changes the rack unit numbers. config:# assetStrip <n>...
Page 158 Using the PRO3X Command Line Interface (CLI) Specifying the Asset Strip Orientation This command syntax specifies the orientation of the asset strips connected to the PRO3X device. Usually you do not need to perform this command unless your asset strips do NOT come with the tilt sensor, causing the PRO3X unable to detect the asset strips' orientation.
Page 159: Rack Unit Configuration
Using the PRO3X Command Line Interface (CLI) Rack Unit Configuration A rack unit refers to a tag port on the asset strips. A rack unit configuration command begins with rackUnit. Naming a Rack Unit This command syntax assigns or changes the name of the specified rack unit on the specified asset strip. config:# rackUnit <n>...
Page 160 Using the PRO3X Command Line Interface (CLI) Mode Description manual This option enables selection of a different LED color and LED mode for the specified rack unit. Setting an LED Color for a Rack Unit This command syntax sets the LED color for a specific rack unit on the specified asset strip. You need to set a rack unit's LED color only when the LED operation mode of this rack unit has been set to "manual."...
Page 161 Using the PRO3X Command Line Interface (CLI) Mode Description This mode has the LED stay off permanently. blinkSlow This mode has the LED blink slowly. blinkFast This mode has the LED blink quickly. Examples This section illustrates several asset management examples. Example 1 - Asset Strip LED Colors for Disconnected Tags This command syntax sets the LED color for all rack units on the asset sensor #1 to BLACK (that is, 000000) to indicate the absence of a connected asset tag.
Page 162 Using the PRO3X Command Line Interface (CLI) Serial Port Configuration Commands A serial port configuration command begins with serial. Setting the Baud Rates The following commands set the baud rate (bps) of the serial port labeled CONSOLE / MODEM on the PRO3X device. Change the baud rate before connecting it to the desired device, such as a computer, a Raritan's P2CIM-SER, or a modem, through the serial port, or there are communications errors.
Page 163 Using the PRO3X Command Line Interface (CLI) Example The following command sets the CONSOLE baud rate of the PRO3X device's serial port to 9600 bps. config:# serial consoleBaudRate 9600 Multi-Command Syntax To shorten the configuration time, you can combine various configuration commands in one command to perform all of them at a time.
Page 164: Example 4 - Combination Of Upper Critical, Upper Warning And Lower Warning Settings
Using the PRO3X Command Line Interface (CLI) Example 3 - Combination of SSID and PSK Parameters This multi-command syntax configures both SSID and PSK parameters simultaneously for the wireless feature. config:# network wireless SSID myssid PSK encryp_key Results: The SSID value is set to myssid. The PSK value is set to encryp_key.
Page 165: Actuator Control Operations
Using the PRO3X Command Line Interface (CLI) Actuator Control Operations An actuator, which is connected to a dry contact signal channel of a sensor package, can control a mechanism or system. You can switch on or off that mechanism or system through the actuator control command in the CLI. Perform these commands in the administrator or user mode.
Page 166: Unblocking A User
Using the PRO3X Command Line Interface (CLI) If you entered the command without "/y", a message appears, prompting you to confirm the operation. Then: ▪ Type y to confirm the operation, OR ▪ Type n to abort the operation Example - Turning on a Specific Actuator The following command turns on the actuator whose ID number is 8.
Page 167: Network Troubleshooting
Using the PRO3X Command Line Interface (CLI) Note: Device reset will cause CLI communications over an "USB" connection to be lost. Therefore, re-connect the USB cable after the reset is complete. Resetting to Factory Defaults The following commands restore all settings of the PRO3X to factory defaults. To reset PRO3X settings after login, use either command: reset factorydefaults -- OR --...
Page 168: Querying Dns Servers
Using the PRO3X Command Line Interface (CLI) Diagnostic Commands The diagnostic command syntax varies from command to command. Querying DNS Servers This command syntax queries Internet domain name server (DNS) information of a network host. diag> nslookup <host> Variables: <host> is the name or IP address of the host whose DNS information you want to query. Showing Network Connections This command syntax displays network connections and/or status of ports.
Page 169: Testing The Network Connectivity
Using the PRO3X Command Line Interface (CLI) Testing the Network Connectivity This ping command sends the ICMP ECHO_REQUEST message to a network host for checking its network connectivity. If the output shows the host is responding properly, the network connectivity is good. If not, either the host is shut down or it is not being properly connected to the network.
Page 170: Tracing The Route
Using the PRO3X Command Line Interface (CLI) Tracing the Route This command syntax traces the network route between your PRO3X and a network host. diag> traceroute <host> <useICMP> Variables: <host> is the name or IP address of the host you want to trace. <useICMP>...
Page 171: Logging Out Of Cli
Using the PRO3X Command Line Interface (CLI) Example 2 (only one possible command): Type the first word and initial letters of the second word of the "security strongPasswords" command -- that is, security str. b. Then press Tab or Ctrl+i to complete the second word. Example 3 (more than one possible commands): Type only the first two words of the "network ipv4 gateway xxx.xxx.xxx.xxx"...
Page 172: Using Scp Commands
Using the PRO3X Command Line Interface (CLI) Using SCP Commands You can perform a Secure Copy (SCP) command to update the PRO3X firmware, do bulk configuration, or backup and restore the configuration. Firmware Update via SCP Same as any PRO3X firmware update, all user management operations are suspended and all login attempts fail during the SCP firmware update.
Page 173 Using the PRO3X Command Line Interface (CLI) ▪ <device ip> is the IP address or hostname of the PRO3X whose configuration you want to save. ▪ <filename> is the custom filename you assign to the "bulk_config.txt" of the source PRO3X. 2.
Page 174: Backup And Restore Via Scp
Using the PRO3X Command Line Interface (CLI) Backup and Restore via SCP To back up ALL settings of a PRO3X, including device-specific settings, you should perform the backup operation instead of the bulk configuration. You can restore all settings to previous ones after a backup file is available. To back up the settings via SCP: 1.
Page 175: Downloading Diagnostic Data Via Scp
Using the PRO3X Command Line Interface (CLI) Downloading Diagnostic Data via SCP You can download the diagnostic data via SCP. To download the diagnostic data via SCP: 1. Type one of the following SCP commands and press Enter. Scenario 1: Use the default SCP port and default filename ▪...
Page 176: Uploading Or Downloading Raw Configuration Data
Using the PRO3X Command Line Interface (CLI) Windows PSCP command: PSCP in Windows works in a similar way to the SCP. ▪ pscp -P <port> <user name>@<device ip>:/diag-data.zip <filename> Uploading or Downloading Raw Configuration Data You can download the raw configuration data of a specific PRO3X for review, backup or modification. After modifying or creating any raw configuration data, you can upload it to a specific PRO3X for changing its configuration.
Page 177 Using the PRO3X Command Line Interface (CLI) ▪ <port> is the current SSH/SCP port number, or the port number of a specific link device in the Port-Forwarding chain. ▪ <filename> is the new filename of the downloaded file. 2. Type the password when prompted. 3.
Page 178 Using the PRO3X Command Line Interface (CLI) ▪ <dev_col> comprises "serial:" or "mac:" and the number of the column where the serial number or MAC address of each PRO3X is in the uploaded CSV file. This is the data based on which each device finds its device-specific settings.
Page 179: Appendix A: Regulatory Compliance
Using the PRO3X Command Line Interface (CLI) Appendix A: Regulatory Compliance Product Safety Units have been safety tested and certified to the following standards: • USA/Canada UL 60950-1:2007 R10.14 and CAN/CSA 22.2 No. 60950-1-07 +A1+A2 • European Union EN 60950-1:2006 + A11 +A1 + A12 + A2 This product is also designed for Norwegian IT power system with phase-to phase voltage 230V.
Page 180: Japanese Notification
Using the PRO3X Command Line Interface (CLI) Japanese Notification この装置は、情報処理装置等電波障害自主規制協議会（ＶＣＣＩ）の基準に基づくクラス A 情報技術装置です。この装置を家庭環境で使用すると電波妨害を引き起こすことがあります。この場合には使用者が適切な対策を講ずるよう要求されることがあります。本製品に同梱または付属しております電源コードは、本製品専用です。本製品以外の製品ならびに他の用途に使用しないで下さい。 Chinese Notification 关于符合中国《电子信息产品污染控制管理办法》的声明产品中有毒有害物质的名称及含量有毒有害物质或元素 (Hazardous Substance) 部件名称铅 (Pb) 汞 (Hg) 镉 (Cd) 六价铬 (Cr (VI)) 多溴联苯 (PBB) 多溴二苯醚 (PBDE) (Parts) 机箱子组件 (Chassis Subassembly) 印刷板组件...
Page 181: Appendix B: Product Support
Server Technology understands that there are often questions when installing and/or using a new product. Free Technical Support is provided from 8 a.m. to 5 p.m. Pacific Time, Monday through Friday. Server Technology, Inc. (a brand of Legrand) 1040 Sandhill Road...
Page 182 About Server Technology ® Server Technology, a brand of Legrand, is leading the engineering and manufacturing of customer-driven, innovative and exceptionally reliable power, access and control solutions for monitoring and managing critical IT assets for continual availability. Server Technology‘s power strategy experts are trusted to provide Rack PDU solutions for data centers worldwide ranging from small technology startups to Fortune 100 powerhouses.

LEGRAND Server Technology PRO3X User Manual

Quick Links

Related Manuals for LEGRAND Server Technology PRO3X

Summary of Contents for LEGRAND Server Technology PRO3X

Table of Contents