background image

 

 

 

Using the PRO3X Command Line Interface (CLI) 

 

PRO3X User Guide 

 Command Line Interface (CLI) 

 

108 of 182 

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.

 

Type a new password when prompted, and press Enter. 

4.

 

Type the same new password and press Enter. If the password change is completed successfully, the config:# prompt 
appears. 

 

Modifying a User's Personal Data 

You can change a user's personal data, including the user's full name, telephone number, and email address. 

Various commands can be combined to modify the parameters of a specific user profile at a time.  

 

Change a user's full name: 

config:#

 

user modify <name> fullName "<full_name>"

 

 

Change a user's telephone number: 

config:#

 

user modify <name> telephoneNumber "<phone_number>"

 

 

Change a user's email address: 

config:#

 

user modify <name> eMailAddress <email_address>

 

Variables: 

 

<name> is the name of the user whose settings you want to change. 
<full_name> is a string comprising up to 64 ASCII printable characters. The <full_name> variable must be enclosed in quotes 
when it contains spaces. 
<phone_number> is the phone number that can reach the specified user. The <phone_number> variable must be enclosed in 
quotes when it contains spaces. 
<email_address> is the email address of the specified user. 

 

Summary of Contents for Server Technology PRO3X

Page 1: ......

Page 2: ...Using the PRO3X Command Line Interface CLI PRO3X User Guide Command Line Interface CLI 2 of 182 ...

Page 3: ...trators 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 This guide is a detailed resource for the PRO3X CLI commands description syntax usage parameters variables as well as providing command examples and results to assist you with using the firmware s interface 2 2 ...

Page 4: ...upport 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 Tel 1 800 835 1515 Web www servertech com Reno Nevada 89521 USA Fax 775 284 2065 Email support servertech com ...

Page 5: ...fusibles destinés à l installation en Amérique du Nord doivent avoir une capacité d interruption de 10 000 A Der feste Stromkreis muss mit einem Schutzschalter oder einem Sicherungsschutz versehen sein PDUs verfügt über keinen Hauptschutzschalter bzw über keine Sicherung damit kein einzelner Fehlerpunkt entstehen kann Der Kunde ist dafür verantwortlich den Stromkreis sachgemäß zu schützen Der Kapa...

Page 6: ... fitted with a plug that is rated for a higher voltage Caution must be taken to assure that the rating of the unit and the supply voltage match Les produits prévus pour 240 415VAC peut être équipé d un bouchon qui est conçu pour une tension plus élevée Des précautions doivent être prises pour assurer que la cote de l unité et la tension d alimentation correspond Produkte die für 240 415VAC zugelas...

Page 7: ...round location may vary Most PDUs will have it located near the power cord entry located near the symbol User Supplied Materials One 5 mm internal or external tooth star washer One 4 0 mm2 10 AWG wire with 5 mm ring terminal One metric M5 x 6 mm coarse pitch screw Instructions 1 Connect one end of the ground wire to the equipment cabinet or local ground 2 Locate the PDU external ground near the sy...

Page 8: ...isabled by default because it communicates openly and is thus insecure Logging in to CLI Logging in via HyperTerminal over a local connection is a little different than logging in using SSH or Telnet If a security login agreement has been enabled you must accept the agreement in order to complete the login Users are authenticated first and the security banner is checked afterwards With HyperTermin...

Page 9: ...et client such as PuTTY Note PuTTY is a free program you can download from the Internet Refer to PuTTY s documentation for details on configuration To log in using SSH or Telnet 1 Ensure SSH or Telnet has been enabled 2 Launch an SSH or Telnet client and open a console window A login prompt appears 3 Type a name and press Enter The name is case sensitive Note If using the SSH client the name must ...

Page 10: ...o log in to the CLI To disconnect from the PRO3X 6 Return to the modem s command mode using the escape code 7 After the OK prompt appears type the following AT command to disconnect from the PRO3X ATH Different CLI Modes and Prompts Depending on the login name you use and the mode you enter the system prompt in the CLI varies User Mode When you log in as a normal user who may not have full permiss...

Page 11: ...ice to another without closing the local connection window first The Command for Showing Available Commands When you are not familiar with CLI commands you can press the key at any time for one of the following purposes Show a list of main CLI commands available in the current mode Show a list of available commands or parameters for the command you type In the administrator mode In the configurati...

Page 12: ...he role create command config role create Showing Information You can use the show commands to view current settings or the status of the PRO3X 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 Some show commands have two formats one with the parameter details and the other without The difference ...

Page 13: ...u 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 Interface Description eth1 Show the IP related configuration of the ETH1 interface eth2 Show the IP related configuration of the ETH2 interface wireless Show th...

Page 14: ...ETH To show the IPv6 configuration of a specific network interface show network ipv6 interface ETH 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 ...

Page 15: ...cation protocol show network interface ETH 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 Interface Description eth1 Sh...

Page 16: ...pe the command without adding this option all to get the same data http Only displays the TCP port for the HTTP service https Only displays the TCP port for the HTTPS service telnet Only displays the settings of the Telnet service ssh Only displays the settings of the SSH service snmp Only displays the SNMP settings modbus Only displays the settings of the Modbus TCP service zeroconfig Only displa...

Page 17: ...ation for all outlets Tip You can also type the command without adding this option all to get the same data A specific outlet number Displays the information for the specified outlet only Displayed information Without the parameter details only the outlet name is displayed With the parameter details more outlet information is displayed in addition to the outlet name such as the outlet rating Inlet...

Page 18: ...nlet information is displayed in addition to the inlet name and RMS current such as the inlet s RMS voltage active power and active energy Overcurrent Protector Information This command is only available for models with overcurrent protectors for protecting outlets This command syntax shows the overcurrent protector information such as a circuit breaker or a fuse show ocp n To show detailed inform...

Page 19: ...te and time settings on the PRO3X show time 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 PRO3X web and CLI interfaces across all users especially those users authenticated through remote authentication servers show user defaultPreferences Note If a user ha...

Page 20: ...on Description all Displays the information of all environmental sensors Tip You can also type the command without adding this option all to get the same data A specific environmental sensor number Displays the information for the specified environmental sensor only The environmental sensor number is the ID number assigned to the sensor which can be found on the Peripherals page of the PRO3X web i...

Page 21: ...vironmental sensor the following command shows the information of all connected environmental sensor packages each of which may contain more than one sensor or actuator show peripheralDevicePackages Information similar to the following is displayed Peripheral Device Package refers to an environmental sensor package Peripheral Device Package 1 Serial Number 1GE7A00022 Package Type DX2 T1H1 Position...

Page 22: ...ll actuators Tip You can also type the command without adding this option all to get the same data A specific actuator number Displays the information for the specified actuator only The actuator number is the ID number assigned to the actuator The ID number can be found using the PRO3X web interface or CLI It is an integer starting at 1 Displayed information Without the parameter details only the...

Page 23: ...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 unbalancedCurrent Unbalanced load sensor lineFrequency Line frequency sensor Displayed information Without the parameter details only the reading state thresho...

Page 24: ...t detects residual AC current For Type B it is the sensor that detects both residual AC and DC current residualDCCurrent RCM DC current sensor detects residual DC current only Available only on PDUs with RCM Type B Inlet Pole Sensor Threshold Information This command syntax shows the specified inlet pole sensor s threshold related information show sensor inletpole n p sensor type To show detailed ...

Page 25: ...ding resolution and range If the requested sensor type is not supported the Sensor is not available message is displayed 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 Descript...

Page 26: ...ailed information add the parameter details to the end of the command show sensor ocp n sensor type details Variables n is the number of the overcurrent protector whose sensors you want to query sensor type is one of the following sensor types Sensor type Description current Current sensor Displayed information Without the parameter details only the reading state threshold de assertion hysteresis ...

Page 27: ...r n details 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 PRO3X web interface Displayed information Without the parameter details only the reading threshold de assertion hysteresis and assertion timeout settings of the specified environmental sensor are displayed With the para...

Page 28: ...ollowing numeric sensor types Sensor types Description absoluteHumidity Absolute humidity sensors relativeHumidity Relative humidity sensors temperature Temperature sensors airPressure Air pressure sensors airFlow Air flow sensors vibration Vibration sensors all All of the above numeric sensors Tip You can also type the command without adding this option all to get the same data Displayed informat...

Page 29: ... 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 With the parameter details more security information is displayed such as user blocking time user idle timeout and front panel permissions if supported b...

Page 30: ...ific Radius server assign the desired Radius server with its sequential number in the command To get detailed information add details to the end of the command show authentication radiusServer server_num OR show authentication radiusServer server_num details Variables server_num is the sequential number of the specified authentication server on the LDAP or Radius server list Displayed information ...

Page 31: ... name Option Description all This option shows all existing user profiles Tip You can also type the command without adding this option all to get the same data a specific user s name This option shows the profile of the specified user only Displayed information Without the parameter details only four pieces of user information are displayed user name user Enabled status SNMP v3 access privilege an...

Page 32: ...ption shows the data of the specified role only Displayed information Role settings are displayed including the role description and privileges Serial Port Settings This command shows the baud rate setting of the serial port labeled CONSOLE MODEM on the PRO3X show serial EnergyWise Settings This command shows the PRO3X device s current configuration for Cisco EnergyWise show energywise Asset Strip...

Page 33: ... settings of a specific rack unit or all rack units on an asset strip such as a rack unit s LED color and LED mode show rackUnit n rack_unit Variables n is the number of the FEATURE port where the selected asset strip is physically connected For the PRO3X device with only one FEATURE port the number is always 1 rack_unit is one of the options all or a specific rack unit s index number Option Descr...

Page 34: ...ic type of events only show eventlog limit n class event_type Variables n is one of the options all or a number Option Description all Displays all entries in the event log An integer number Displays the specified number of last entries in the event log The number ranges between 1 to 10 000 event_type is one of the following event types Event type Description all All events device Device related e...

Page 35: ...lated events timerEvent Scheduled action events webcam Events for webcam management if available cardReader Events for card reader management if available energywise Cisco EnergyWise related events such as enabling the support of the EnergyWise function Network Connections Diagnostic Log This command shows the diagnostic log for both the EAP authentication and wireless LAN connection show network ...

Page 36: ...he 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 Displayed information Without the parameter details only the specified device s IP address monitoring enabled disabled state and current status are displayed With the parameter details more settings for the specified device are displayed such...

Page 37: ...iability errorlog n Variables n is one of the options 0 zero or any other integer number Option Description 0 Displays all entries in the reliability error log Tip You can also type the command without adding this option 0 to get all data A specific integer number Displays the specified number of last entries in the reliability error log Reliability Hardware Failures This command shows a list of d...

Page 38: ...ine Interface CLI PRO3X User Guide Command Line Interface CLI 38 of 182 Examples This section provides examples of the show command Example 1 Basic Security Information The diagram shows the output of the show security command ...

Page 39: ... User Guide Command Line Interface CLI 39 of 182 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 ...

Page 40: ... unnecessary data from the PRO3X After typing a clear command press Enter to execute it Note Depending on your login name the prompt may be replaced by the prompt Clearing Event Log This command removes all data from the event log clear eventlog OR clear eventlog y If you entered the command without y a message appears prompting you to confirm the operation Type y to clear the event log or n to ab...

Page 41: ...permissions To configure any settings enter the configuration mode Configuration commands are case sensitive so ensure you capitalize them correctly Entering Configuration Mode Configuration commands function in configuration mode only To enter configuration mode 1 Ensure you have entered administrator mode and the prompt is displayed Note If you enter configuration mode from user mode you may hav...

Page 42: ...nfiguration command begins with pdu You can use the PDU configuration commands to change the settings that apply to the whole PRO3X device Configuration commands are case sensitive so ensure you capitalize them correctly Changing the PDU Name This command changes the device name of PRO3X config pdu name name Variables name is a string comprising up to 64 ASCII printable characters The name variabl...

Page 43: ...vice s altitude is associated with the altitude correction factor config pdu deviceAltitude altitude Variables altitude is an integer between 425 and 3000 meters Note that the lower limit 425 is a negative value because some locations are below the seal level Setting the Z Coordinate Format for Environmental Sensors This command enables or disables the use of rack units for specifying the height Z...

Page 44: ...packages disable Disables the automatic management feature for environmental sensor packages Setting the Maximum Number of Active Powered Dry Contact Actuators This command determines the upper limit of active powered dry contact actuators on one PRO3X device You need either Change Peripheral Device Configuration privilege or Administrator Privileges to change its upper limit config pdu activePowe...

Page 45: ... Configuration Mode This command determines the IP configuration mode config network ipv4 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 Note In the bridging mode only the IP parameters of the BRIDGE interface function The IP parameters of ...

Page 46: ...ridge 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 Interface Description eth1 Determine the IPv4 preferred host name of the ETH1 interface that is wired networking eth2 Determine the IPv4 preferred host name of the ETH2 interface that is wi...

Page 47: ...t 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 Interface Description eth1 Determine the IPv4 address of the ETH1 interface that is wired networking eth2 Determine the IPv4 address of the ETH2 interface that is wired networking wireless Determine the IPv4 address of the W...

Page 48: ...e 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 These commands are prefixed with network ipv4 staticRoutes Depending on whether the other...

Page 49: ...y an existing static route OR Variables dest 1 is a combination of the IP address and subnet mask of the other subnet The format is IP address subnet mask hop is the IP address of the next hop router ETH is one of the interfaces ETH1 ETH2 WIRELESS and BRIDGE Type bridge only when your PRO3X is in the bridging mode route_ID is the ID number of the route setting which you want to delete or modify de...

Page 50: ...interfaces do NOT function Interface Description eth1 Determine the IPv6 configuration mode of the ETH1 interface wired networking eth2 Determine the IPv6 configuration mode of the ETH2 interface wired networking wireless Determine the IPv6 configuration mode of the WIRELESS interface that is wireless networking bridge Determine the IPv6 configuration mode of the BRIDGE interface that is bridging ...

Page 51: ...terface wired networking eth2 Determine the IPv6 preferred host name of the ETH2 interface wired networking wireless Determine the IPv6 preferred host name of the WIRELESS interface that is wireless networking bridge Determine the IPv6 preferred host name of the BRIDGE interface that is bridging mode name is a host name which Consists of alphanumeric characters and or hyphens Cannot begin or end w...

Page 52: ...orking eth2 Determine the IPv6 address of the ETH2 interface wired networking wireless Determine the IPv6 address of the WIRELESS interface that is wireless networking bridge Determine the IPv6 address of the BRIDGE interface that is the bridging mode ip address is the IP address being assigned to your PRO3X This value uses the IPv6 address format Note that you must add xx which indicates a prefix...

Page 53: ...twork is directly reachable network ipv6 staticRoutes add dest 1 interface ETH Delete an existing static route network ipv6 staticRoutes delete route_ID Modify an existing static route network ipv6 staticRoutes modify route_ID dest dest 2 nextHop hop OR network ipv6 staticRoutes modify route_ID dest dest 2 interface ETH Variables dest 1 is the IP address and prefix length of the subnet where the P...

Page 54: ...config network dns searchSuffixes suffix1 OR network dns searchSuffixes suffix1 suffix2 suffix3 suffix6 Determine which IP address is used when the DNS server returns both IPv4 and IPv6 addresses config network dns resolverPreference resolver Variables ip address is the IP address of the DNS server suffix1 suffix2 and the like are the DNS suffixes that automatically apply when searching for any de...

Page 55: ...net Enabling or Disabling the LAN Interface This command enables or disables the LAN interface config network ethernet ETH enabled option Variables ETH is one of the options eth1 or eth2 Option Description eth1 ETH1 port eth2 ETH2 port option is one of the options true or false Option Description true The specified network interface is enabled false The specified network interface is disabled ...

Page 56: ...thernet ETH speed option Variables ETH is one of the options eth1 or eth2 Option Description eth1 ETH1 port eth2 ETH2 port option is one of the options auto 10Mbps 100Mbps or 1000Mbps 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 1000Mbps The LAN speed is always 1000 Mbps ...

Page 57: ...duplexMode mode Variables ETH is one of the options eth1 or eth2 Option Description eth1 ETH1 port eth2 ETH2 port mode is one of the modes auto half or full Option Description auto The PRO3X selects the optimum transmission mode through auto negotiation half Half duplex Data is transmitted in one direction to or from the PRO3X at a time full Full duplex Data is transmitted in both directions simul...

Page 58: ...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 ETH1 port eth2 ETH2 port method is one of the authentication methods NONE or EAP Method Description NONE The authentication method is set to NONE EAP The authentication method is set to EAP ...

Page 59: ...net ETH eapPassword After performing the above command the PRO3X prompts you to enter the password Then type the password and press Enter Provide a client certificate for authentication set to EAP TLS or EAP PEAP TLS config network ethernet ETH eapClientCertificate After performing any certificate or private key commands including commands for the client certificate client private key and CA certi...

Page 60: ...e of the options PEAP or TLS Option Description PEAP Outer authentication is set to Protected Extensible Authentication Protocol PEAP TLS Outer authentication is set to TLS inner_auth is one of the options MS CHAPv2 or TLS Option Description MSCHAPv2 Inner authentication is set to Microsoft s Challenge Authentication Protocol Version 2 MS CHAPv2 TLS Inner authentication is set to TLS identity is y...

Page 61: ...ished when the PRO3X finds that the TLS certificate is not valid due to incorrect system time FQDN is the name of the RADIUS server if it is present in the TLS certificate The name must match the fully qualified domain name FQDN of the host shown in the certificate EAP CA Certificate Example This section provides a CA certificate example for the Ethernet interface ETH1 Your CA certificate contents...

Page 62: ...RMCMTYwEwYDVQQDEwxTdGV2ZSBTY2hv Y2gwWDALBgkqhkiG9w0BAQEDSQAwRgJBALrAwyYdgxmzNP ts0Uyf6BpmiJYktU w4NG67ULaN4B5CnEz7 k57s9o3YY3LecETgQ5iQHmkwlYDTL2fTgVfw0CAQOjgaswgagwZAYDVR0ZAQH BFowWDBWMFQxCzAJBgNV BAYTAlVTMTYwNAYDVQQKEy1OYXRpb25hbCBBZXJvbmF1dGljcyBhbmQgU3BhY2UgQWRtaW5pc3RyYXRpb2 4xDTALBgNVBAMTBENSTDEwFwYDVR0BAQH BA0wC4AJODMyOTcwODEwMBgGA1UdAgQRMA8ECTgzMjk3MDgy M4ACBSAwDQYDVR0KBAYwBAMCBkAwCwYJKoZI...

Page 63: ...e you have entered the configuration mode 2 Type the appropriate command depending on which file you want to remove and press Enter Client certificate config network ethernet eth1 eapClientCertificate Client private key config network ethernet eth1 eapClientPrivateKey CA certificate config network ethernet eth1 eapCACertificate 3 The system prompts you to enter the contents of the chosen certifica...

Page 64: ...D values are not applied until the wireless networking mode is enabled In addition a message appears indicating that the active network interface is not wireless Setting the SSID This command specifies the SSID string config network wireless SSID ssid Variables ssid is the name of the wireless access point which consists of Up to 32 ASCII characters No spaces ASCII codes 0x20 0x7E Enabling or Disa...

Page 65: ...reless authMethod method Variables method is one of the authentication methods PSK or EAP Method Description PSK The authentication method is set to PSK EAP The authentication method is set to EAP Setting the PSK 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 ...

Page 66: ...d config network wireless eapPassword After performing the above command the PRO3X prompts you to enter the password Then type the password and press Enter Provide a Client Certificate for authentication set to EAP TLS or EAP PEAP TLS config network wireless eapClientCertificate After performing any certificate or private key commands including commands for the client certificate client private ke...

Page 67: ...ntication is set to TLS inner_auth is one of the options MS CHAPv2 or TLS Option Description MSCHAPv2 Inner authentication is set to Microsoft s Challenge Authentication Protocol Version 2 MS CHAPv2 TLS Inner authentication is set to TLS identity is your user name for the EAP authentication option1 is one of the options true or false Option Description true Enables the verification of the TLS cert...

Page 68: ...n the firmware build before synchronizing with the NTP server causing the TLS certificate to become invalid false The network connection is NOT successfully established when the PRO3X finds that the TLS certificate is not valid due to incorrect system time FQDN is the name of the RADIUS server if it is present in the TLS certificate The name must match the fully qualified domain name FQDN of the h...

Page 69: ...ort numbers assigned Important When enabling either cascading mode you must make sure the other cascading mode is disabled or the preferred cascading mode may not be enabled successfully option1 is one of the following options Option Description true The selected cascading mode is enabled false The selected cascading mode is disabled If Port Forwarding mode is enabled you must configure two more s...

Page 70: ...ne 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 device is connected Usb USB port is the port where the 1st link device is connected ...

Page 71: ...ge the HTTP port config network services http port n Enable or disable the HTTP port config network services http enabled option Enforce redirection from HTTP to HTTPS config network services http enforceHttps option Variables n is a TCP port number between 1 and 65535 The default HTTP port is 80 option is one of the options true or false Option Description true The HTTP port is enabled OR HTTP re...

Page 72: ...443 option is one of the options true or false Option Description true Forces any access to the PRO3X via HTTP to be redirected to HTTPS false No HTTP access is redirected to HTTPS Changing the Telnet Configuration You can enable or disable the Telnet service or change its TCP port using the CLI commands A Telnet command begins with network services telnet Enabling or Disabling Telnet This command...

Page 73: ... the SSH service or change its TCP port using the CLI commands An SSH command begins with network services ssh Enabling or Disabling SSH 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 Changing the SSH Port This comman...

Page 74: ...key based login This is the default If the public key authentication is selected you must enter a valid SSH public key for each user profile to log in over the SSH connection Setting the SNMP Configuration You can enable or disable the SNMP v1 v2c or v3 agent configure the read and write community strings or set the MIB II parameters such as sysContact using the CLI commands An SNMP command begins...

Page 75: ...NMP read only community string config network services snmp readCommunity string Variables string is a string comprising 4 to 64 ASCII printable characters The string CANNOT include spaces Setting the SNMP Write Community This command sets the SNMP read write community string config network services snmp writeCommunity string Variables string is a string comprising 4 to 64 ASCII printable characte...

Page 76: ...nfig network services snmp sysLocation value Variables value is a string comprising 0 to 255 alphanumeric characters Changing the Modbus Configuration You can enable or disable the Modbus agent configure its read only capability or change its TCP port A Modbus command begins with network services modbus Enabling or Disabling Modbus This command enables or disables the Modbus protocol config networ...

Page 77: ...led 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 Enabling or Disabling Service Advertising This command enables or disables the zero configuration protocol which enables advertising or auto discovery of network services config network services zeroconfig method...

Page 78: ...ss Networking Mode The following command enables the wireless networking mode config network wireless enabled true Example 2 Enabling IPv6 Protocol on the Ethernet Interface The following command enables the IPv6 protocol on the ETH1 interface config network ipv6 interface eth1 enabled true Example 3 Wireless Authentication Method The following command sets the wireless authentication method to PS...

Page 79: ...nd 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 The date and time settings are customized ntp The date and time settings synchronize with a specified NTP server ...

Page 80: ... 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 To delete the secondary time server config time ntp secondServer Variables The first_server is the IP address or host name of the primary NTP server The second_server is the IP address or host name of the se...

Page 81: ...the format of yyyy mm dd For example type 2015 11 30 for November 30 2015 hh mm ss Type the time in the format of hh mm ss in the 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 PRO3X config time zone After a list of time zones is displayed type the index number of the time zone or press Enter to canc...

Page 82: ...s one of the options enable or disable Mode Description enable Daylight savings time is enabled disable Daylight savings time is disabled Examples This section illustrates several time configuration examples Example 1 Time Setup Method The following command sets the date and time settings by using the NTP servers config time method ntp Example 2 Primary NTP Server The following command sets the pr...

Page 83: ...mmands A security configuration command begins with security 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 PRO3X from a specific or a range of IP addresses An IPv4 firewall configuration command begins with security ipAccessControl ipv4 An IPv6 firewall configuration command begins with sec...

Page 84: ...v6 firewall control policy for outbound traffic security ipAccessControl ipv6 defaultPolicyOut policy Variables option is one of the options true or false Option Description true Enables the IP access control feature false Disables the IP access control feature policy is one of the options accept drop or reject Option Description accept Accepts traffic from all IP addresses drop Discards traffic f...

Page 85: ...ecurity 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 IPv4 commands Add a new rule to the bottom of the IPv4 rules list security ipAccessControl ipv4 rule add direction ip_mask policy Add a new IPv4 rule by inserting it above or below a specific rule security ipAccessControl ipv4 rule add dir...

Page 86: ...s one of the options in or out Direction Description in Inbound traffic out Outbound traffic ip_mask is the combination of the IP address and subnet mask values or prefix length which are separated with a slash For example an IPv4 combination looks like this 192 168 94 222 24 policy is one of the options accept drop or reject Policy Description accept Accepts traffic from to the specified IP addre...

Page 87: ...e number 1 rule_number is the number of the existing rule which you want to insert the new rule above or below Modifying a Firewall Rule 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 security ipAccessControl ipv4 rule modify direction rule_number ipMask ip_mask Modify an IPv4 rule s policy security ipAccessContr...

Page 88: ...n or out Direction Description in Inbound traffic out Outbound traffic rule_number is the number of the existing rule that you want to modify ip_mask is the combination of the IP address and subnet mask values or prefix length which are separated with a slash For example an IPv4 combination looks like this 192 168 94 222 24 policy is one of the options accept drop or reject Option Description acce...

Page 89: ...n in Inbound traffic out Outbound traffic rule_number is the number of the existing rule that you want to remove Restricted Service Agreement The CLI command used to set the Restricted Service Agreement feature begins with security restrictedServiceAgreement Enabling or Disabling the Restricted Service Agreement This command activates or deactivates the Restricted Service Agreement config security...

Page 90: ...icted service agreement is displayed Specifying the Agreement Contents This command allows you to create or modify contents of the Restricted Service Agreement config security restrictedServiceAgreement bannerContent After performing the above command do the following 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...

Page 91: ...message Successfully entered Restricted Service Agreement is displayed indicating that the content input is successful Login Limitation The login limitation feature controls login related limitations such as password aging simultaneous logins using the same user name and the idle time permitted before forcing a user to log out A login limitation command begins with security loginLimits You can com...

Page 92: ... disable Disables the password aging feature Password Aging Interval This command determines how often the password should be changed config security loginLimits passwordAgingInterval value Variables 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 for...

Page 93: ...mber of failed logins and thus disables the user blocking function value2 is a numeric value ranging from 1 to 1440 minutes one day or infinite which blocks the user all the time until the user is unblocked manually Strong Passwords The strong password commands determine whether a strong password is required for login and what a strong password should contain at least A strong password command beg...

Page 94: ...mmand determines the maximum length of the password config security strongPasswords maximumLength value Variables value is an integer between 16 and 64 Lowercase Character Requirement This command determines whether a strong password includes at least a lowercase character security strongPasswords enforceAtLeastOneLowerCaseCharacter option Variables option is one of the options enable or disable O...

Page 95: ...aracter is required disable No uppercase character is required Numeric Character Requirement This command determines whether a strong password includes at least a numeric character security strongPasswords enforceAtLeastOneNumericCharacter option Variables option is one of the options enable or disable Option Description enable At least one numeric character is required disable No numeric characte...

Page 96: ...ccess Control In addition to firewall access control based on IP addresses you can configure other access control rules that are based on both IP addresses and users roles An IPv4 role based access control command begins with security roleBasedAccessControl ipv4 An IPv6 role based access control command begins with security roleBasedAccessControl ipv6 Modifying Role Based Access Control Parameters...

Page 97: ... the role based access control feature policy is one of the options allow or deny Policy Description allow Accepts traffic from all IP addresses regardless of the user s role deny Drops traffic from all IP addresses regardless of the user s role Tip You can combine both commands to modify all role based access control parameters at a time Managing Role Based Access Control Rules You can add delete...

Page 98: ...rule_number IPv6 commands Add a new rule to the bottom of the IPv6 rules list 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 security roleBasedAccessControl ipv6 rule add start_ip end_ip role policy insert rule_number Variables start_ip is the starting IP address end_ip is the ending IP address role is th...

Page 99: ... the new rule above or below Modifying a Role Based Access Control Rule Depending on what to modify in an existing rule the command syntax varies IPv4 commands Modify a rule s IPv4 address range security roleBasedAccessControl ipv4 rule modify rule_number startIpAddress start_ip endIpAddress end_ip Modify an IPv4 rule s role security roleBasedAccessControl ipv4 rule modify rule_number role role Mo...

Page 100: ...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 policy policy ...

Page 101: ...e is one of the existing roles policy is one of the options allow or deny Policy Description allow Accepts traffic from the specified IP address range when the user is a member of the specified role deny Drops traffic from the specified IP address range when the user is a member of the specified role Deleting a Role Based Access Control Rule These commands remove a specific rule from the list IPv4...

Page 102: ...t panel actuator control and the internal beeper muting functions simultaneously security frontPanelPermissions add switchActuator muteBeeper Enabling or Disabling Front Panel Beeper Sound Control The following CLI commands control whether you can mute the internal beeper by operating the front panel LCD display when the beeper sounds To enable the front panel beeper sound control feature config s...

Page 103: ...is set to accept Example 2 Adding an IPv4 Firewall Rule The following command adds a new IPv4 access control rule and specifies its location in the list security ipAccessControl ipv4 rule add in 192 168 84 123 24 accept insertAbove 5 Results A new IPv4 firewall control rule is added to accept all packets sent from the IPv4 address 192 168 84 123 The newly added rule is inserted above the 5th rule ...

Page 104: ...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 Outlet Configuration Commands An outlet configuration command begins with outlet Such a command allows you to configure an individual outlet Changing the Outlet Name This command names an outlet config outlet n name...

Page 105: ...acters The name variable must be enclosed in quotes when it contains spaces Enabling or Disabling an Inlet for Multi Inlet PDUs Enabling or disabling an inlet takes effect on a multi inlet PDU only This command enables or disables an inlet config inlet 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 bet...

Page 106: ...ts outlets Changing the Overcurrent Protector Name This command names a circuit breaker or a fuse which protects outlets on your PRO3X config ocp n name name Variables n is the number of the overcurrent protector that you want to configure 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 co...

Page 107: ...ption enable Enables the newly created user profile disable Disables the newly created user profile roles is a role or a list of comma separated roles assigned to the specified user profile Modifying a User Profile A user profile contains various parameters that you can modify Tip You can combine all commands to modify the parameters of a specific user profile at a time Changing a User s Password ...

Page 108: ...the user s full name telephone number and email address Various commands can be combined to modify the parameters of a specific user profile at a time Change a user s full name config user modify name fullName full_name Change a user s telephone number config user modify name telephoneNumber phone_number Change a user s email address config user modify name eMailAddress email_address Variables nam...

Page 109: ...e of the options true or false Option Description true Enables the specified user profile false Disables the specified user profile Forcing a Password Change This command determines whether the password change is forced when a user logs in to the specified user profile next time user modify name forcePasswordChangeOnNextLogin option Variables name is the name of the user whose settings you want to...

Page 110: ... time Enable or disable the SNMP v3 access to PRO3X for the specified user user modify name snmpV3Access option1 Determine the security level user modify name securityLevel option2 Determine whether the authentication passphrase is identical to the password user modify name userPasswordAsAuthenticationPassphrase option3 Determine the authentication passphrase user modify name authenticationPassPhr...

Page 111: ...thentication protocol user modify name authenticationProtocol option5 Determine the privacy protocol user modify name privacyProtocol option6 Variables name is the name of the user whose settings you want to change option1 is one of the options enable or disable Option Description enable Enables the SNMP v3 access permission for the specified user disable Disables the SNMP v3 access permission for...

Page 112: ...ption true Privacy passphrase is identical to the authentication passphrase false Privacy passphrase is different from the authentication passphrase option5 is one of the options MD5 or SHA 1 Option Description MD5 MD5 authentication protocol is applied SHA 1 SHA 1 authentication protocol is applied option6 is one of the options DES or AES 128 Option Description DES DES privacy protocol is applied...

Page 113: ... so that you can set all measurement units at a time Note The measurement unit change only applies to the web interface and command line interface Set the preferred temperature unit config user modify name preferredTemperatureUnit option1 Set the preferred length unit config user modify name preferredLengthUnit option2 Set the preferred pressure unit config user modify name preferredPressureUnit o...

Page 114: ... sshPublicKey 2 The system prompts you to enter the contents of the SSH public key Do the following to input the contents a Open your SSH public key with a text editor b Copy all contents in the text editor c Paste the contents into the terminal d Press Enter To remove an existing SSH public key 1 Type the same command as shown above 2 When the system prompts you to input the contents press Enter ...

Page 115: ...er the password is changed successfully the new password is effective immediately no matter you type the command apply or not to save the changes Example This procedure changes your own password 1 Verify that you have entered the configuration mode 2 Type the following command and press Enter config password 3 Type the existing password and press Enter when the following prompt appears Current pas...

Page 116: ...t the default temperature unit user defaultpreferences preferredTemperatureUnit option1 Set the default length unit user defaultpreferences preferredLengthUnit option2 Set the default pressure unit user defaultpreferences preferredPressureUnit option3 Variables option1 is one of the options C or F Option Description C This option displays the temperature in Celsius F This option displays the tempe...

Page 117: ...new user profile Example 2 Modifying a User s Roles The following command assigns two roles to the user May config user modify Mary roles admin tester Results The user Mary 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 user defaultpreferences preferredTemperatureUnit F preferredLengthUnit f...

Page 118: ...d 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 All Privileges This table lists all privileges Note that available privileges vary according to the model you purchased Privilege Description acknowledgeAlarms Acknowledge Alarms adminPrivilege Administr...

Page 119: ... View Event Settings viewEverything Unrestricted View Privileges viewLog View Local Event Log viewSecuritySettings View Security Settings viewSnmpSettings View SNMP Settings viewUserSettings View Local User Management viewWebcamSettings View Webcam Snapshots and Configuration The switchActuator privilege requires an argument that is separated with a colon The argument could be All actuators that i...

Page 120: ...d a colon and the argument s after that privilege config role modify name removePrivileges privilege1 argument1 argument2 privilege2 argument1 argument2 privilege3 argument1 argument2 Note When removing privileges from a role make sure the specified privileges and arguments if any exactly match those assigned to the role Otherwise the command fails to remove specified privileges that are not avail...

Page 121: ...command begins with authentication Determining the Authentication Method You can choose to set the authentication type only or both set the authentication type and determine whether to switch to local authentication in case the remote authentication is not available Determine the authentication type only config authentication type option1 Determine the authentication type and enable disable the op...

Page 122: ... Always stick to remote authentication regardless of the availability of remote authentication LDAP Settings All LDAP related commands begin with authentication ldap If you enable LDAP authentication you must add at least one LDAP server Later you can modify or delete any existing LDAP server as needed Adding an LDAP Server Adding an LDAP server requires the entry of quite a lot of parameters such...

Page 123: ...erformed a list of all LDAP servers including the newly added one will be displayed which is similar to the following diagram Variables host is the IP address or host name of the LDAP server port is the port number assigned for communication with the LDAP server ldap_type is one of the LDAP server types openldap or activeDirectory Type Description openldap OpenLDAP server activeDirectory Microsoft...

Page 124: ...tion ldap add host port ldap_type security bind_type base_DN login_name_att user_entry_class adDomain AD_domain Example 2 Set up the bind DN authentication ldap add host port ldap_type security bind_type base_DN login_name_att user_entry_class bindDN bind_DN Optional Parameters table Parameters To configure userSearchSubfilter filter User search subfilter bindDN bind_DN bind DN The system will pro...

Page 125: ...xamples Those words highlighted in bold are required for their respective examples An OpenLDAP server authentication ldap add op ldap raritan com 389 openldap none anonymousBind dc raritan dc com uid inetOrgPerson A Microsoft Active Directory server authentication ldap add ac ldap raritan com 389 activeDirectory none anonymousBind dc raritan dc com sAMAccountName user adDomain raritan com An LDAP ...

Page 126: ...rver that has been configured use the following command Add an LDAP server by copying an existing server s settings config authentication ldap addClone server_num host 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 PRO3X Modifying an Existing LDAP Server You can modify one or multiple para...

Page 127: ...Using the PRO3X Command Line Interface CLI PRO3X User Guide Command Line Interface CLI 127 of 182 A list of parameters The following table provides a list of LDAP parameters ...

Page 128: ...w login name attribute userEntryObjectClass user_entry_class Change the user entry object class user_entry_class is the new user entry class userSearchSubfilter user_search_filter Change the user search subfilter user_search_filter is the new user search subfilter adDomain AD_domain Change the Active Directory Domain name AD_domain is the new domain name of the Active Directory verifyServerCertifi...

Page 129: ...fig authentication ldap delete server_num Variables server_num is the sequential number of the specified server in the LDAP server list Radius Settings All Radius related commands begin with authentication radius 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 bindDN bind_DN Change the bind DN bind_DN i...

Page 130: ...thentication types pap chap msChapV2 Type Description chap CHAP pap PAP msChapV2 MSCHAP v2 auth_port is the authentication port number acct_port is the accounting port number timeout is the timeout value in seconds It ranges between 1 to 10 seconds retries is the number of retries It ranges between 0 to 5 To enter the shared secret 6 After executing the above Radius command the system automaticall...

Page 131: ...odify server_num host host Change the Radius authentication type authentication radius modify server_num authType rds_type Change the authentication port authentication radius modify server_num authPort auth_port Change the accounting port authentication radius modify server_num accountPort acct_port Change the timeout value authentication radius modify server_num timeout timeout Change the number...

Page 132: ...ng port number timeout is the new timeout value in seconds It ranges between 1 to 10 seconds retries is the new number of retries It ranges between 0 to 5 To enter the shared secret 9 After executing the above Radius command the system automatically prompts you to enter the shared secret 10 Type the secret and press Enter 11 Re type the same secret and press Enter Example authentication radius add...

Page 133: ...party You must specify the type of connected detector switch for proper operation Use this command when you need to specify the sensor type config externalsensor n sensorSubType sensor_type 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 in the CLI It is an integer ...

Page 134: ...ronmental sensor that you want to configure The ID number is available in the PRO3X web interface or using the command show externalsensors n in the CLI It is an integer starting at 1 coordinate is a string comprising up to 24 ASCII printable characters and it must be enclosed in quotes Setting the Z Coordinate This command specifies the Z coordinate of an environmental sensor config externalsenso...

Page 135: ... must be enclosed in quotes when it contains spaces Using Default Thresholds This command determines whether default thresholds including the deassertion hysteresis and assertion timeout are applied to a specific environmental sensor config externalsensor n useDefaultThresholds option Variables n is the ID number of the environmental sensor that you want to configure The ID number is available in ...

Page 136: ...assigns the name Cabinet humidity to the environmental sensor with the ID number 4 config externalsensor 4 name Cabinet humidity Example 2 Sensor Threshold Selection The following command sets the environmental sensor 1 to use the default thresholds including the deassertion hysteresis and assertion timeout as its threshold settings config externalsensor 1 useDefaultThresholds true Configuring Env...

Page 137: ...lue Set the Default Lower Warning Threshold for a specific sensor type defaultThresholds sensor type lowerWarning value Set the Default Deassertion Hysteresis for a specific sensor type defaultThresholds sensor type hysteresis hy_value Set the Default Assertion Timeout for a specific sensor type defaultThresholds sensor type assertionTimeout as_value Variables sensor type is one of the following n...

Page 138: ...pes Measurement units absoluteHumidity g m 3 that is g m3 relativeHumidity temperature Degrees Celsius or Fahrenheit depending on your measurement unit settings airPressure Pascal Pa or psi depending on your measurement unit settings airFlow m s vibration g hy_value is the deassertion hysteresis value applied to the specified sensor type as_value is the assertion timeout value applied to the speci...

Page 139: ...ld hysteresis and assertion timeout values for any sensor associated with the following items Inlets Inlet poles for three phase PDUs only Overcurrent protectors Environmental sensors It is permitted to assign a new value to the threshold at any time regardless of whether the threshold has been enabled Commands for Inlet Sensors A sensor configuration command for inlets begins with sensor inlet Yo...

Page 140: ...eout 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 Description current Current sensor voltage Voltage sensor activePower Active power sensor apparentPower Apparent power sensor powerFactor Power factor sensor activeEnergy Active energy sensor unbalancedCurrent Unbalanced l...

Page 141: ...ue that is assigned to the assertion timeout for the specified inlet sensor 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 Peak current sensor reactiveP...

Page 142: ...al Threshold for an Inlet Pole sensor inletpole n p sensor type upperCritical option Set the Upper Warning Threshold for an Inlet Pole sensor inletpole n p sensor type upperWarning option Set the Lower Critical Threshold for an Inlet Pole sensor inletpole n p sensor type lowerCritical option Set the Lower Warning Threshold for an Inlet Pole sensor inletpole n p sensor type lowerWarning option Set ...

Page 143: ...ge Voltage sensor activePower Active power sensor apparentPower Apparent power sensor powerFactor Power factor sensor activeEnergy Active energy sensor unbalancedCurrent Unbalanced load sensor Note If the requested sensor type is not supported the Sensor is not available message is displayed option is one of the options enable disable or a numeric value Option Description enable Enables the specif...

Page 144: ...rFact or Displacement power factor sensor residualCurrent RCM current sensor For Type A it is the sensor that detects residual AC current For Type B it is the sensor that detects both residual AC and DC current residualDCCurrent RCM DC current sensor detects residual DC current only Available only on PDUs with RCM Type B Commands for Overcurrent Protector Sensors A sensor configuration command for...

Page 145: ...ensor type Description current Current sensor Note If the requested sensor type is not supported the Sensor is not available message is displayed option is one of the options enable disable or a numeric value Option Description enable Enables the specified threshold for the overcurrent protector sensor disable Disables the specified threshold for the overcurrent protector sensor A numeric value Se...

Page 146: ...al threshold for an environmental sensor sensor externalsensor n sensor type upperCritical option Set the Upper Warning threshold for an environmental sensor sensor externalsensor n sensor type upperWarning option Set the Lower Critical threshold for an environmental sensor sensor externalsensor n sensor type lowerCritical option Set the Lower Warning threshold for an environmental sensor sensor e...

Page 147: ...n Vibration sensors Note If the specified sensor type does not match the type of the specified environmental sensor this error message appears Specified sensor type XXX does not match the sensor s type sensortype where XXX is the specified sensor type and sensortype is the correct sensor type option is one of the options enable disable or a numeric value Option Description enable Enables the speci...

Page 148: ...urrent sensor inlet 1 current upperWarning 20 lowerWarning 12 Results The Upper Warning threshold for the inlet 1 RMS current is set to 20A It also enables the upper warning threshold if this threshold has not been enabled yet The Lower Warning threshold for the inlet 1 RMS current is set to 12A It also enables the lower warning threshold if this threshold has not been enabled yet Example 3 Upper ...

Page 149: ...iption Variables n is the ID number assigned to the actuator The ID number can be found using the PRO3X 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 coordinate is a string comprising up to 24 ASCII printable characters and it must be enclosed in quotes There a...

Page 150: ... one of the options true or false Option Description true Enables the ping monitoring feature for the newly added device false Disables the ping monitoring feature for the newly added device succ_ping is the number of successful pings for declaring the monitored device Reachable Valid range is 0 to 200 fail_ping is the number of consecutive unsuccessful pings for declaring the monitored device Unr...

Page 151: ...ngs The command to modify a monitored IT device s settings begins with serverReachability modify You can modify various settings for a monitored device at a time Modify a device s IP address or host name serverReachability modify n ipAddress IP_host Enable or disable the ping monitoring feature for the device serverReachability modify n pingMonitoringEnabled option Modify the number of successful ...

Page 152: ...ature for the monitored device false Disables the ping monitoring feature for the monitored device succ_number is the number of successful pings for declaring the monitored device Reachable Valid range is 0 to 200 fail_number is the number of consecutive unsuccessful pings for declaring the monitored device Unreachable Valid range is 1 to 100 succ_wait is the wait time to send the next ping after ...

Page 153: ...3 of 182 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 ...

Page 154: ...ption true The Cisco EnergyWise feature is enabled false The Cisco EnergyWise feature is disabled Specifying the EnergyWise Domain This command syntax specifies to which Cisco EnergyWise domain the PRO3X belongs config energywise domain name Variables name is a string comprising up to 127 ASCII printable characters Spaces and asterisks are NOT acceptable Specifying the EnergyWise Secret This comma...

Page 155: ...nd 65535 Setting the Polling Interval This command syntax determines the polling interval at which the Cisco EnergyWise domain queries the PRO3X config energywise polling timing Variables timing is an integer number in seconds It ranges between 30 and 600 seconds Example Setting Up EnergyWise The following command sets up two Cisco EnergyWise related features config energywise enabled true port 10...

Page 156: ...t strip is physically connected For the PRO3X device with only one FEATURE port the number is always 1 name is a string comprising up to 64 ASCII printable characters The name variable must be enclosed in quotes when it contains spaces Specifying the Number of Rack Units This command syntax specifies the total number of rack units on an asset strip connected to the PRO3X device config assetStrip n...

Page 157: ...ering modes topDown or bottomUp Mode Description topDown The rack units are numbered in the ascending order from the highest to the lowest rack unit bottomUp The rack units are numbered in the descending order from the highest to the lowest rack unit Specifying the Rack Unit Numbering Offset This command syntax specifies the starting number of rack units on the asset strips connected to the PRO3X ...

Page 158: ...n topConnector This option indicates that the asset strip is mounted with the RJ 45 connector located on the top bottomConnector This option indicates that the asset strip is mounted with the RJ 45 connector located at the bottom Setting LED Colors for Connected Tags This command syntax sets the LED color for all rack units on the asset strip 1 to indicate the presence of a connected asset tag con...

Page 159: ... Strip page of the web interface name is a string comprising up to 64 ASCII printable characters The name variable must be enclosed in quotes when it contains spaces Setting the LED Operation Mode This command syntax determines whether a specific rack unit on the specified asset strip follows the global LED color settings config rackUnit n rack_unit LEDOperationMode mode Variables n is the number ...

Page 160: ...sset strip or the Asset Strip page of the web interface color is the hexadecimal RGB value of a color in HTML format The color variable ranges from 000000 to FFFFFF Note A rack unit s LED color setting overrides the global LED color setting on it Setting an LED Mode for a Rack Unit This command syntax sets the LED mode for a specific rack unit on the specified asset strip You need to set a rack un...

Page 161: ...agement 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 config assetStrip 1 LEDColorForDisconnectedTags 000000 Note Black color causes the LEDs to stay off Example 2 Rack Unit Naming The following command assigns the name Linux ser...

Page 162: ...te baud_rate Determine the MODEM baud rate config serial modemBaudRate baud_rate Variables baud_rate is one of the baud rate options 1200 2400 4800 9600 19200 38400 57600 115200 Forcing the Device Detection Mode This command forces the serial port on the PRO3X to enter a specific device detection mode config serial deviceDetectionType mode Variables mode is one of the detection modes automatic for...

Page 163: ...uration Method and IP The following multi command syntax configures IPv4 address configuration method and activation status for ETH1 s network connectivity simultaneously network ipv4 interface eth1 enabled true configMethod static address 192 168 84 225 24 Results The ETH1 interface is enabled ETH1 s configuration method is set to static IP address ETH1 s IPv4 address is set to 192 168 84 225 24 ...

Page 164: ... set to encryp_key Example 4 Combination of Upper Critical Upper Warning and Lower Warning Settings The following multi command syntax configures Upper Critical Upper Warning and Lower Warning thresholds for the outlet 5 RMS current simultaneously sensor outlet 5 current upperCritical disable upperWarning enable lowerWarning 1 0 Results The Upper Critical threshold of outlet 5 RMS current is disab...

Page 165: ...d which confirms the operation control actuator n on y Variables n is an actuator s ID number The ID number is available in the PRO3X web interface or using the show command in the CLI It is an integer starting at 1 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 Switching Off an Act...

Page 166: ...ion 2 When the Username prompt appears type unblock and press Enter 3 When the Username to unblock prompt appears type the name of the blocked user and press Enter 4 A message appears indicating that the specified user was unblocked successfully Resetting the PRO3X You can reset the PRO3X to factory defaults or simply restart it using the CLI commands Restarting the PDU This command restarts the P...

Page 167: ...et is complete Network Troubleshooting The PRO3X provides 4 diagnostic commands for troubleshooting network problems nslookup netstat ping and traceroute The diagnostic commands function as corresponding Linux commands and can get corresponding Linux outputs Entering Diagnostic Mode Diagnostic commands function in the diagnostic mode only To enter the diagnostic mode 1 Enter either of the followin...

Page 168: ...ernet 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 diag netstat option Variables option is one of the options ports or connections Option Description ports Shows TCP UDP ports conn...

Page 169: ... host is the host name or IP address whose networking connectivity you want to check Options You can include any or all of additional options listed below in the ping command Options Description count number1 Determines the number of messages to be sent number1 is an integer number between 1 and 100 size number2 Determines the packet size number2 is an integer number in bytes between 1 and 65468 t...

Page 170: ...sly typed in the same connection session press the Up arrow on the keyboard several times until the desired command is displayed Automatically Completing a Command A CLI command always consists of several words You can easily enter a command by typing first word s or letter s and then pressing Tab or Ctrl i instead of typing the whole command word by word To have a command completed automatically ...

Page 171: ...e first two words of the network ipv4 gateway xxx xxx xxx xxx command that is network ipv4 b Then press Tab or Ctrl i one or two times a list of possible commands displays as shown below gateway interface staticRoutes c Type the full command network ipv4 gateway xxx xxx xxx xxx according to the onscreen command list Logging out of CLI After completing your tasks using the CLI always log out of the...

Page 172: ...RO3X where you want to upload the specified file 2 Type the password when prompted and press Enter 3 The system transmits the specified firmware file to the PRO3X and shows the transmission speed and percentage 4 When the transmission is complete it shows the following message indicating that the PRO3X starts to update its firmware now Wait until the upgrade completes Starting firmware update The ...

Page 173: ...r password when prompted 6 The system copies the configuration included in the file bulk_config txt to another PRO3X and displays the following message Starting restore operation The connection will be closed now SCP examples Save operation scp admin 192 168 87 50 bulk_config txt today_config txt Copy operation scp today_config txt admin 192 168 87 47 bulk_restore Windows PSCP commands PSCP in Win...

Page 174: ... named backup_settings txt To restore the settings via SCP 1 Type the following SCP command and press Enter scp backup_settings txt user name device ip settings_restore user name is the admin or any user profile with Administrator Privileges device ip is the IP address or hostname of the PRO3X whose settings you want to restore 2 Type the user password when prompted 3 The system copies the configu...

Page 175: ...CP port is the default 22 and the accessed PRO3X is a standalone device Renaming the diagnostic file is wanted scp user name device ip diag data zip filename Scenario 4 Specify a different SCP port and a new filename SSH SCP port is NOT the default 22 or the accessed PRO3X is a Port Forwarding link device Renaming the diagnostic file is wanted scp P port user name device ip diag data zip filename ...

Page 176: ...fault SCP port and default filename SSH SCP port is the default 22 and the accessed PRO3X is a standalone device The raw configuration file s default filename raw_config txt is wanted Then add a dot in the end of the SCP command as shown below scp user name device ip raw_config txt Scenario 2 Specify a different SCP port but use the default filename SSH SCP port is NOT the default 22 or the access...

Page 177: ... file for device specific settings is NOT needed scp P port config file user name device ip raw_config_update Scenario 3 Multiple PRO3X to configure with the default SCP port SSH SCP port is the default 22 and the accessed PRO3X is a standalone device There are multiple devices to configure so a CSV file for device specific settings is needed during the upload scp dev_list file config file user na...

Page 178: ...CP commands PSCP in Windows works in a similar way to the SCP pscp P port user name device ip raw_config txt filename pscp P port CSV file config file user name device ip raw_config_update match col Alternative of bulk configuration via SCP Both methods of uploading bulk configuration file or raw configuration file via SCP can serve the purpose of bulk configuration The only difference is that you...

Page 179: ... interference to radio communications Operation of this equipment in a residential area is likely to cause harmful interference in which case the user will be required to correct the interference at the user s own expense Modifications not expressly approved by the manufacturer could void the user s authority to operate the equipment under FCC rules Canadian Notification This Class A digital appar...

Page 180: ...below the limit requirement in SJ T 11363 2006 X 表示该有毒有害物质至少在该部件的某一均质材料中的含量超出 SJ T 11363 2006 标准 规定的限量要求 Indicates that this hazardous substance contained in at least one of the homogeneous materials of this part is above the limit requirement in SJ T 11363 2006 Product Recycling Recycling Server Technology Inc encourages the recycling of its products Disposal facilities environmental conditions a...

Page 181: ...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 Tel 1 800 835 1515 Web www servertech com Reno Nevada 89521 USA Fax 775 284 2065 Email support servertech com Return Merchandise Authorization RMA If you have a product that is not functionin...

Page 182: ...y startups to Fortune 100 powerhouses Because power is all we do Server Technology can be found in the best cloud and colocation providers forward thinking labs and telecommunications operations Server Technology customers consistently rank us as providing the highest quality PDUs the best customer support and most valuable innovation We have over 12 000 PDU configurations to fit every data center...

Reviews: