system command returns a list of commands to access system related subcategories.
outlets or groups commands only applies to PDUs with outlet current measurement or outlet switching capabilities.
SynLink> system
-----------
System Menu
-----------
Usage: system [command]
Commands:
[s]tatus Print status device, inlet, bank, and outlet status
[d]evice Print PDU Information and Versions
[b]anks Show and Configure Bank (Circuit) info
[i]nlets Show and Configure Inlet info
[o]utlets Show and Configure Outlet Info
[g]roups Show and Configure group related info
sensors Show and Configure sensor related info
system status
system statussystem status command returns all system information related to inlets, circuit, and outlets.
The following example is from a 1U single phase, switched, and outlet monitored PDU
SynLink> system status
------------------
Device Information
------------------
Device Name | SynLink PDU
Model Number | 1001AIE-01
Outlet Switching | Supported
Outlet Pwr Measurements | Supported
Number of Banks | 1
Number of Outlets | 8
Controller Serial # | 1360604425
Enclosure Serial # | 9826498
Inlet Configuration | standard
Mac Address | 3A:D2:21:D3:82:45
Form Factor | 1U
Phase | Single Phase
Device Time | 09/01/2012 - 05:15:24 UTC
Uptime | 678606 seconds
-----------------
Inlet Information
-----------------
Inlet Plug | IEC-320 C20
Inlet Name | IEC-320 C20 Inlet
Inlet Line | L-L/N
Energy Accumulation | 0.00 kWh
Current RMS | 0.01 A
Voltage RMS | 117.80 V
Line Frequency | 60.14 W
Power Factor | 0.37
Active Power | 0.40 W
Apparent Power | 1.07 VA
-----------------
Banks Information
-----------------
Bank 1 Status
-------------------------------------
Bank Name | Bank 1
Lines Used | L-L/N
Energy Accumulation | 0.00 kWh
Current RMS | 0.01 A
Voltage RMS | 117.80 V
Line Frequency | 60.14 W
Power Factor | -0.37
Active Power | 0.40 W
Apparent Power | 1.07 VA
-------------------
Outlets Information
-------------------
--------------------------------------------------------------------
| ID | Name | State | Current | Apparent Power
--------------------------------------------------------------------
1 | 1-16777225 | Outlet 1 | ON | 0.16 A | 18.90 VA
2 | 2-16777225 | Outlet 2 | ON | 0.16 A | 18.93 VA
3 | 3-16777225 | Outlet 3 | ON | 0.16 A | 19.12 VA
4 | 4-16777225 | Outlet 4 | ON | 0.16 A | 18.91 VA
5 | 5-16777225 | Outlet 5 | ON | 0.17 A | 19.63 VA
6 | 6-16777225 | Outlet 6 | ON | 0.16 A | 19.15 VA
7 | 7-16777225 | Outlet 7 | ON | 0.16 A | 18.39 VA
8 | 8-16777225 | Outlet 8 | ON | 0.15 A | 18.02 VA
system device status
system device statussystem device status return device information.
SynLink> system device status
------------------
Device Information
------------------
Device Name | SynLink PDU
Model Number | 1001AIE-01
Outlet Switching | Supported
Outlet Pwr Measurements | Supported
Number of Banks | 1
Number of Outlets | 8
Controller Serial # | 1360604425
Enclosure Serial # | 9826498
Inlet Configuration | standard
Mac Address | 3A:D2:21:D3:82:45
Form Factor | 1U
Phase | Single Phase
Device Time | 09/01/2012 - 05:19:19 UTC
Uptime | 678841 seconds
system device json
system device jsonsystem device json returns device information in json format
SynLink> system device json
{
"numBanks":1,
"numOutlets":4,
"numDryContactRelays":2,
"numInlets":1,
"inletPlug":"IEC-320 C20",
"outletPwrMeasurementsSupported":true,
"outletSwitchingSupported":true,
"enclosureSerialNumber":1000016,
"modelNumber":"5001AIE-0E",
"inletConfig":"standard",
"formFactor":"Compact",
"controllerSerialNumber":1359160329,
"controllerFirmwareVersion":"2.5.4",
"controllerHardwareVersion":"SP000005 1.17.0",
"phase":"Single Phase",
"circuitBreakerProtection":false,
"uptime":14500,
"time":"2021-07-06T15:08Z"
}system device set
system device setsystem device set will return a list of configurations that can be set.
SynLink> system device set
---------------------
Device Configurations
---------------------
Usage: system device set [key] [value]
Key | Values | Desc
-----------------------------------------------------------------
device_name | TEXT | 100 char Limit
global_reboot_time | NUMBER | Min: 1 seconds, Max: 21600 seconds
system inlets status
system inlets statussystem inlets status return inlet information. Optional argument json return the inlet information in a JSON format (system inlets json).
SynLink> system inlets status
-----------------
Inlet Information
-----------------
Inlet Plug | IEC-320 C20
Inlet Name | IEC-320 C20 Inlet
Inlet Line | L-L/N
Energy Accumulation | 0.00 kWh
Current RMS | 0.01 A
Voltage RMS | 118.00 V
Line Frequency | 60.19 W
Power Factor | 0.37
Active Power | 0.40 W
Apparent Power | 1.07 VAsystem inlets set
system inlets setSynLink> system inlets set
---------------------
Inlet Configurations
---------------------
Usage:
system inlets set [key] [inlet_id:optional] [value:optional]
Key | Values | Desc
-----------------------------------------------------------------
inlet_name | TEXT | User defined name for inlet
inlet_energy_accumulation | NONE | No Value necessary.
system banks status
system banks statussystem banks status returns information of circuits/banks on PDU. Optional argument json returns the bank(s) information in a JSON format (system banks json).
SynLink> system banks status
-----------------
Banks Information
-----------------
Bank 1 Status
-------------------------------------
Bank Name | Bank 1
Lines Used | L-L/N
Energy Accumulation | 0.00 kWh
Current RMS | 0.02 A
Voltage RMS | 119.30 V
Line Frequency | 60.19 W
Power Factor | 0.64
Active Power | 1.77 W
Apparent Power | 2.76 VAsystem banks set
system banks setsystem banks set will return a list of configurations that can be set.
SynLink> system banks set
---------------------
Device Configurations
---------------------
Usage: system banks set [key] [bank_id:optional] [value:optional]
Key | Values | Desc
------------------------------------------------------
bank_name | TEXT | Prompts for bank_id and bank_name
system outlets status
system outlets statussystem outlets status returns outlet information. Optional argument json returns outlet information in JSON format (system outlets json)
SynLink> system outlets status
-------------------
Outlets Information
-------------------
----------------------------------------------------------------------
| ID | Name | State | Current | Apparent Power
----------------------------------------------------------------------
1 | 1-16777225 | Outlet 1 | ON | 0.16 A | 19.19 VA
2 | 2-16777225 | Outlet 2 | ON | 0.16 A | 19.04 VA
3 | 3-16777225 | Outlet 3 | ON | 0.16 A | 19.39 VA
4 | 4-16777225 | Outlet 4 | ON | 0.16 A | 19.05 VA
5 | 5-16777225 | Outlet 5 | ON | 0.17 A | 19.90 VA
6 | 6-16777225 | Outlet 6 | ON | 0.16 A | 19.28 VA
7 | 7-16777225 | Outlet 7 | ON | 0.16 A | 19.11 VA
8 | 8-16777225 | Outlet 8 | ON | 0.15 A | 18.15 VA
system outlets set
system outlets setsystem outlets set will return a list of configurations that can be set.
SynLink> system outlets set
---------------------
Outlet Configurations
---------------------
Usage:
system outlets set [Key] [outlet_id:optional] [Value:optional]
Description:
To choose an outlet from a list to turn off/on or power cycle:
system outlet set outlet_state
To change a specific outlet's state:
system outlet set outlet_state 1 off
system outlet set outlet_state 1 reboot
Key | Values | Desc
----------------------------------------------------------------
outlet_name | TEXT | 100 char limit
outlet_state | ON,OFF,RB | RB = reboot outlet/power cycle
custom_reboot_time_enabled | one,off | Custom reboot time for outlet
custom_reboot_time | SECONDS | Reboot time in seconds
power_up_state | ON,OFF,PREV | Outlet state when PDU boots up (cold boot)
system relays status
system relays statussystem relays status will returns relay output information. Optional argument json return relay output information in JSON format (system relays status json)
SynLink> system relays status
-------------------------
Output Relays Information
-------------------------
------------------------------------------
| ID | Name | State
------------------------------------------
1 | R1-1000010 | Relay Output 1 | ON
2 | R2-1000010 | Relay Output 2 | ON
system relays set
system relays setsystem relay set will return a list of configurations that can be set
SynLink> system relays set
---------------------------
Output Relay Configurations
---------------------------
Usage:
system relays set [key] [relay_id:optional] [value:optional]
Description:
Type "system relay status" to see a list of relay ids or
Omit [relay_id] AND [value] to be prompted for relay_ids
Key | Values | Default | Desc
----------------------------------------------------------------------------------
relay_name | TEXT | | 100 char limit
relay_state | ON,OFF,RB | | RB will reboot outlet
custom_reboot_time_enabled | on,off | off | Custom reboot time for relay
custom_reboot_time | SECONDS | 5 | Reboot time in seconds
-->
system groups status
system groups statusShow Outlet group information in human readable format. Print Outlet Group Info in JSON format by appending json argument (system groups json)
SynLink> system groups status
------------------------
Outlet Group Information
------------------------
1. Example Group Name
Total Current RMS: 0.81A (0.16A average for 5 outlets)
# | ID | Name | State | Current | Apparent Power
1 | 1-16777225 | Outlet 1 | ON | 0.16 A | 19.19 VA
2 | 2-16777225 | Outlet 2 | ON | 0.16 A | 19.04 VA
3 | 3-16777225 | Outlet 3 | ON | 0.16 A | 19.39 VA
4 | 4-16777225 | Outlet 4 | ON | 0.16 A | 19.05 VA
5 | 5-16777225 | Outlet 5 | ON | 0.17 A | 19.90 VA
------------------------------------------------------------------
2. Dell Poweredge Servers
# of Group Outlets: 3
Total Current RMS: 0.48A (0.16A average for 3 outlets)
# | ID | Name | State | Current | Apparent Power
2 | 2-16777225 | Outlet 2 | ON | 0.16 A | 19.04 VA
4 | 4-16777225 | Outlet 4 | ON | 0.16 A | 19.05 VA
5 | 5-16777225 | Outlet 5 | ON | 0.17 A | 19.90 VA
------------------------------------------------------------------system groups set
system groups setConfigure an individual outlet group.
SynLink> system groups set
---------------------------
Outlet Group Configurations
---------------------------
Usage:
system groups set [key] [group_id:optional] [value:optional]
Description:
Type "system groups status" to see a list of group ids or
Omit [group_id] AND [value] to be prompted for information.
Key | Values | Desc
------------------------------------------------------------
group_name | TEXT | 100 char limit
reboot_seq_delay | SECONDS | Waterfall timing for group outlet switching
group_state | ON,OFF,RB | Turn all outlets ON, OFF, or Power Cycle/Reboot
add_outlet | OUTLET_ID | Add this single outlet id to the outlet group
remove_outlet | OUTLET_ID | Remove this single outlet from the outlet groupsystem groups add
system groups addCreate a brand new outlet group.
SynLink> system groups add
Usage:
system groups add [group_name:optional]
Description:
If group_name is included and has spaces, uses quotations to wrap the name "example group name". If group_name is not included the group name will be prompted for.
system groups remove
system groups removeRemove a single outlet group.
SynLink> system groups remove
Usage:
system groups remove [group_id:optional]
Description:
If group_id is not included the group id will be prompted for. Find a list of group_ids with command system groups status
system sensors status
system sensors statusPrint sensor information in human readable format. Print sensor information in JSON format by appending json argument (system sensors json).
SynLink> system sensors status
------------------
Sensor Information
------------------
-----------------------------------------
Port A - Temperature & Humidity Sensor
-----------------------------------------
Temperature (C) | 18.86 celsius
Temperature (F) | 66.01 fahrenheit
Humidity (RH) | 39.85 relative humidity
-----------------------------------------
-----------------------------------------
Port B - Disconnected
-----------------------------------------
No Sensor Found
-----------------------------------------