From daae8eed58c24ce188af481bd8a5028f2db10ecf Mon Sep 17 00:00:00 2001 From: Casandra Qiu Date: Mon, 15 Jan 2018 15:28:57 -0500 Subject: [PATCH 1/3] Add documentation for PDU support. --- docs/source/advanced/pdu/crpdu.rst | 109 ++++++++++++++++++++ docs/source/advanced/pdu/index.rst | 4 +- docs/source/advanced/pdu/irpdu.rst | 151 +++++++++++++++++++++++++++ docs/source/advanced/pdu/pdu.rst | 157 +++++------------------------ 4 files changed, 291 insertions(+), 130 deletions(-) create mode 100644 docs/source/advanced/pdu/crpdu.rst create mode 100644 docs/source/advanced/pdu/irpdu.rst diff --git a/docs/source/advanced/pdu/crpdu.rst b/docs/source/advanced/pdu/crpdu.rst new file mode 100644 index 000000000..eea318d72 --- /dev/null +++ b/docs/source/advanced/pdu/crpdu.rst @@ -0,0 +1,109 @@ +Collaborative PDU +================= + +Collaborative PDU is also refer as Coral PDU, it controls power for compute Rack. + + +Pre-Defined PDU Objects +----------------------- + +User needs to pre-defined PDU node object if want to run pdudiscover command. :: + + mkdef coralpdu groups=pdu mgt=pdu nodetype=pdu (required) + +all other attributes can be set by chdef command or pdudisocover command. :: + + --switch required for pdudiscover command to do mapping + --switchport required for pdudiscover command to do mapping + --ip ip address of the pdu. + --mac can be filled in by pdudiscover command + --pdutype crpdu(for coral pdu) or irpdu(for infrastructure PDUs) + + +If user want to configure snmp other than default value, the following attributes need to be set. :: + + --community community string for coral pdu + --snmpversion snmp version number, required if configure snmpv3 for coral pdu + --snmpuser snmpv3 user name, required if configure snmpv3 for coral pdu + --authkey auth passphrase for snmpv3 configuration + --authtype auth protocol (MD5|SHA) for snmpv3 configuration + --privkey priv passphrase for snmpv3 configuration + --privtype priv protocol (AES|DES) for snmpv3 configuration + --seclevel security level (noAuthNoPriv|authNoPriv|authPriv) for snmpv3 configuration + +Make sure run makehosts after pre-defined PDU. :: + + makehosts coralpdu + + +Configure PDUs +-------------- + +After pre-defined PDUs, user can use **pdudisocver --range ip_range --setup** to configure the PDUs, it covers following commands: + + * To configure passwordless of Coral PDU: :: + + # rspconfig coralpdu sshcfg + + * To change hostname of Coral PDU: :: + + # rspconfig coralpdu hosname=f5pdu3 + + * To change ip address of PDU: :: + + # rsconfig coralpdu ip=x.x.x.x netmaks=255.x.x.x + + * To configure SNMP community string or snmpv3 of PDU (the attribute needs to pre-defined): :: + + # rspconfig coralpdu snmpcfg + + +Remote Power Control of PDU +--------------------------- + +Use the rpower command to remotely power on and off of PDU. + + * To check power stat of PDU: :: + + # rpower coralpdu stat + + * To power off the PDU: :: + + # rpower coralpdu off + + * To power on the PDU: :: + + # rpower coralpdu on + +Coral PDUs have three relays, the following commands are for individual relay support of PDU: + + * To check power stat of relay: :: + + # rpower coralpdu relay=1 stat + + * To power off the relay: :: + + # rpower coralpdu relay=2 off + + * To power on the relay: :: + + # rpower coralpdu relay=3 on + + +Show Monitor Data +----------------- + +Use the rvitals command to show realtime monitor data(inpute voltage, current, power) of PDU. :: + + # rvitals coralpdu + + +Show manufacture information +----------------------------- + +Use the rinv command to show MFR information of PDU :: + + # rinv coralpdu + + + diff --git a/docs/source/advanced/pdu/index.rst b/docs/source/advanced/pdu/index.rst index 5141a09f5..b27f754f2 100644 --- a/docs/source/advanced/pdu/index.rst +++ b/docs/source/advanced/pdu/index.rst @@ -1,10 +1,12 @@ PDUs ==== -Power Distribution Units (PDUs) are devices that distribute power to servers in a frame. Intelligent PDUs have the capability of monitoring the amount of power that is being used by devices plugged into it. +Power Distribution Units (PDUs) are devices that distribute power to servers in a frame. It has the capability of monitoring the amount of power that is being used by devices plugged into it and cycle power to individual receptacles. xCAT can support two kinds of PDUs on the fields, infrastructure PDU (irpdu) and collaborative PDU (crpdu). These two types of PDU have different design and implementation. xCAT has different code path to maintains PDU commands via **pdutype**. .. toctree:: :maxdepth: 2 pdu.rst + irpdu.rst + crpdu.rst diff --git a/docs/source/advanced/pdu/irpdu.rst b/docs/source/advanced/pdu/irpdu.rst new file mode 100644 index 000000000..08c779154 --- /dev/null +++ b/docs/source/advanced/pdu/irpdu.rst @@ -0,0 +1,151 @@ +Infrastructure PDU +================== + + +PDU Commands +------------ + +Administrators will need to know the exact mapping of the outlets to each server in the frame. xCAT cannot validate the physical cable is connected to the correct server. + +Add a ``pdu`` attribute to the compute node definition in the form "PDU_Name:outlet": :: + + # + # Compute server cn01 has two power supplies + # connected to outlet 6 and 7 on pdu=f5pdu3 + # + chdef cn01 pdu=f5pdu3:6,f5pdu3:7 + + +The following commands are supported against a compute node: + + * Check the pdu status for a compute node: :: + + # rpower cn01 pdustat + cn01: f5pdu3 outlet 6 is on + cn01: f5pdu3 outlet 7 is on + + + * Power off the PDU outlets on a compute node: :: + + # rpower cn01 pduoff + cn01: f5pdu3 outlet 6 is off + cn01: f5pdu3 outlet 7 is off + + * Power on the PDU outlets on a compute node: :: + + # rpower cn01 pduon + cn01: f5pdu3 outlet 6 is on + cn01: f5pdu3 outlet 7 is on + + * Power cycling the PDU outlets on a compute node: :: + + # rpower cn01 pdureset + cn01: f5pdu3 outlet 6 is reset + cn01: f5pdu3 outlet 7 is reset + +The following commands are supported against a PDU: + + * Check the status of the full PDU: :: + + # rpower f5pdu3 stat + f5pdu3: outlet 1 is on + f5pdu3: outlet 2 is on + f5pdu3: outlet 3 is on + f5pdu3: outlet 4 is on + f5pdu3: outlet 5 is on + f5pdu3: outlet 6 is off + f5pdu3: outlet 7 is off + f5pdu3: outlet 8 is on + f5pdu3: outlet 9 is on + f5pdu3: outlet 10 is on + f5pdu3: outlet 11 is on + f5pdu3: outlet 12 is on + + * Power off the full PDU: :: + + # rpower f5pdu3 off + f5pdu3: outlet 1 is off + f5pdu3: outlet 2 is off + f5pdu3: outlet 3 is off + f5pdu3: outlet 4 is off + f5pdu3: outlet 5 is off + f5pdu3: outlet 6 is off + f5pdu3: outlet 7 is off + f5pdu3: outlet 8 is off + f5pdu3: outlet 9 is off + f5pdu3: outlet 10 is off + f5pdu3: outlet 11 is off + f5pdu3: outlet 12 is off + + * Power on the full PDU: :: + + # rpower f5pdu3 on + f5pdu3: outlet 1 is on + f5pdu3: outlet 2 is on + f5pdu3: outlet 3 is on + f5pdu3: outlet 4 is on + f5pdu3: outlet 5 is on + f5pdu3: outlet 6 is on + f5pdu3: outlet 7 is on + f5pdu3: outlet 8 is on + f5pdu3: outlet 9 is on + f5pdu3: outlet 10 is on + f5pdu3: outlet 11 is on + f5pdu3: outlet 12 is on + + * Power reset the full PDU: :: + + # rpower f5pdu3 reset + f5pdu3: outlet 1 is reset + f5pdu3: outlet 2 is reset + f5pdu3: outlet 3 is reset + f5pdu3: outlet 4 is reset + f5pdu3: outlet 5 is reset + f5pdu3: outlet 6 is reset + f5pdu3: outlet 7 is reset + f5pdu3: outlet 8 is reset + f5pdu3: outlet 9 is reset + f5pdu3: outlet 10 is reset + f5pdu3: outlet 11 is reset + f5pdu3: outlet 12 is reset + + * PDU inventory information: :: + + # rinv f6pdu16 + f6pdu16: PDU Software Version: "OPDP_sIBM_v01.3_2" + f6pdu16: PDU Machine Type: "1U" + f6pdu16: PDU Model Number: "dPDU4230" + f6pdu16: PDU Part Number: "46W1608" + f6pdu16: PDU Name: "IBM PDU" + f6pdu16: PDU Serial Number: "4571S9" + f6pdu16: PDU Description: "description" + + * PDU and outlet power information: :: + + # rvitals f6pdu15 + f6pdu15: Voltage Warning: 0 + f6pdu15: outlet 1 Current: 0 mA + f6pdu15: outlet 1 Max Capacity of the current: 16000 mA + f6pdu15: outlet 1 Current Threshold Warning: 9600 mA + f6pdu15: outlet 1 Current Threshold Critical: 12800 mA + f6pdu15: outlet 1 Last Power Reading: 0 Watts + f6pdu15: outlet 2 Current: 0 mA + f6pdu15: outlet 2 Max Capacity of the current: 16000 mA + f6pdu15: outlet 2 Current Threshold Warning: 9600 mA + f6pdu15: outlet 2 Current Threshold Critical: 12800 mA + f6pdu15: outlet 2 Last Power Reading: 0 Watts + f6pdu15: outlet 3 Current: 1130 mA + f6pdu15: outlet 3 Max Capacity of the current: 16000 mA + f6pdu15: outlet 3 Current Threshold Warning: 9600 mA + f6pdu15: outlet 3 Current Threshold Critical: 12800 mA + f6pdu15: outlet 3 Last Power Reading: 217 Wattsv + +**Note:** For BMC based compute nodes, turning the PDU outlet power on does not automatically power on the compute side. Users will need to issue ``rpower on`` to power on the compute node after the BMC boots. + + + + + + + + diff --git a/docs/source/advanced/pdu/pdu.rst b/docs/source/advanced/pdu/pdu.rst index a8566b5f8..64de43178 100644 --- a/docs/source/advanced/pdu/pdu.rst +++ b/docs/source/advanced/pdu/pdu.rst @@ -1,17 +1,39 @@ -PDU -=== +Discovering PDUs +================ -xCAT provides basic remote management for each power outlet plugged into the PDUs using SNMP communication. This documentation will focus on configuration of the PDU and Node objects to allow xCAT to control power at the PDU outlet level. +xCAT provides `pdudiscover` command to discover the PDUs that are attached to the neighboring subnets on xCAT management node. :: + + pdudiscover [|--range ipranges] [-r|-x|-z] [-w] [-V|--verbose] [--setup] + +xCAT uses snmp scan method to discover PDU. Make sure net-snmp-utils package is installed on xCAT MN in order to use snmpwalk command. :: + + Options: + --range Specify one or more IP ranges. Each can be an ip address (10.1.2.3) or an ip range + (10.1.2.0/24). If the range is huge, for example, 192.168.1.1/8, the pdu + discover may take a very long time to scan. So the range should be exactly + specified. It accepts multiple formats. For example: + 192.168.1.1/24, 40-41.1-2.3-4.1-100. + + If the range is not specified, the command scans all the subnets that the active + network interfaces (eth0, eth1) are on where this command is issued. + -r Display Raw responses. + -x XML formatted output. + -z Stanza formatted output. + -w Writes output to xCAT database. + --setup Process switch-based pdu discovery and configure the PDUs(it included passwordless , change ip address from dhcp to static and snmp configuration). It required predefined PDU node definition with switch name and switch port attributes for mapping. (Notes: only support for crpdu for now for this options) Define PDU Objects ------------------ - #. Define pdu object :: - mkdef f5pdu3 groups=pdu ip=50.0.0.8 mgt=pdu nodetype=pdu + mkdef f5pdu3 groups=pdu ip=50.0.0.8 mgt=pdu nodetype=pdu pdutype=irpdu + +#. Define switch attribute for pdu object will use for pdudiscover **--setup** options. :: + + chdef f5pdu3 switch=mid08 switchport=3 #. Add hostname to /etc/hosts:: @@ -19,129 +41,6 @@ Define PDU Objects #. Verify the SNMP command responds against the PDU: :: - snmpwalk -v1 -cpublic -mALL f5pdu3 .1.3.6.1.2.1.1 - - -Define PDU Attribute --------------------- - -Administrators will need to know the exact mapping of the outlets to each server in the frame. xCAT cannot validate the physical cable is connected to the correct server. - -Add a ``pdu`` attribute to the compute node definition in the form "PDU_Name:outlet": :: - - # - # Compute server cn01 has two power supplies - # connected to outlet 6 and 7 on pdu=f5pdu3 - # - chdef cn01 pdu=f5pdu3:6,f5pdu3:7 - - -Verify the setting: ``lsdef cn01 -i pdu`` - - -PDU Commands ------------- - -The following commands are supported against a compute node: - - * Check the pdu status for a compute node: :: - - # rpower cn01 pdustat - cn01: f5pdu3 outlet 6 is on - cn01: f5pdu3 outlet 7 is on - - - * Power off the PDU outlets on a compute node: :: - - # rpower cn01 pduoff - cn01: f5pdu3 outlet 6 is off - cn01: f5pdu3 outlet 7 is off - - * Power on the PDU outlets on a compute node: :: - - # rpower cn01 pduon - cn01: f5pdu3 outlet 6 is on - cn01: f5pdu3 outlet 7 is on - - * Power cycling the PDU outlets on a compute node: :: - - # rpower cn01 pdureset - cn01: f5pdu3 outlet 6 is reset - cn01: f5pdu3 outlet 7 is reset - -The following commands are supported against a PDU: - - * Check the status of the full PDU: :: - - # rinv f5pdu3 - f5pdu3: outlet 1 is on - f5pdu3: outlet 2 is on - f5pdu3: outlet 3 is on - f5pdu3: outlet 4 is on - f5pdu3: outlet 5 is on - f5pdu3: outlet 6 is off - f5pdu3: outlet 7 is off - f5pdu3: outlet 8 is on - f5pdu3: outlet 9 is on - f5pdu3: outlet 10 is on - f5pdu3: outlet 11 is on - f5pdu3: outlet 12 is on - - * Power off the full PDU: :: - - # rpower f5pdu3 off - f5pdu3: outlet 1 is off - f5pdu3: outlet 2 is off - f5pdu3: outlet 3 is off - f5pdu3: outlet 4 is off - f5pdu3: outlet 5 is off - f5pdu3: outlet 6 is off - f5pdu3: outlet 7 is off - f5pdu3: outlet 8 is off - f5pdu3: outlet 9 is off - f5pdu3: outlet 10 is off - f5pdu3: outlet 11 is off - f5pdu3: outlet 12 is off - - * Power on the full PDU: :: - - # rpower f5pdu3 on - f5pdu3: outlet 1 is on - f5pdu3: outlet 2 is on - f5pdu3: outlet 3 is on - f5pdu3: outlet 4 is on - f5pdu3: outlet 5 is on - f5pdu3: outlet 6 is on - f5pdu3: outlet 7 is on - f5pdu3: outlet 8 is on - f5pdu3: outlet 9 is on - f5pdu3: outlet 10 is on - f5pdu3: outlet 11 is on - f5pdu3: outlet 12 is on - - * Power reset the full PDU: :: - - # rpower f5pdu3 reset - f5pdu3: outlet 1 is reset - f5pdu3: outlet 2 is reset - f5pdu3: outlet 3 is reset - f5pdu3: outlet 4 is reset - f5pdu3: outlet 5 is reset - f5pdu3: outlet 6 is reset - f5pdu3: outlet 7 is reset - f5pdu3: outlet 8 is reset - f5pdu3: outlet 9 is reset - f5pdu3: outlet 10 is reset - f5pdu3: outlet 11 is reset - f5pdu3: outlet 12 is reset - - -**Note:** For BMC based compute nodes, turning the PDU outlet power on does not automatically power on the compute side. Users will need to issue ``rpower on`` to power on the compute node after the BMC boots. - - - - - - + snmpwalk -v1 -cpublic -mALL f5pdu3 system From ec7a7fc325e80ac9faf73b992c60829011618201 Mon Sep 17 00:00:00 2001 From: Casandra Qiu Date: Tue, 16 Jan 2018 13:46:43 -0500 Subject: [PATCH 2/3] modify changes from Mark's review --- docs/source/advanced/pdu/crpdu.rst | 14 +++---- docs/source/advanced/pdu/index.rst | 2 +- docs/source/advanced/pdu/irpdu.rst | 62 +++++++++++++++--------------- docs/source/advanced/pdu/pdu.rst | 2 +- 4 files changed, 40 insertions(+), 40 deletions(-) diff --git a/docs/source/advanced/pdu/crpdu.rst b/docs/source/advanced/pdu/crpdu.rst index eea318d72..e527c0169 100644 --- a/docs/source/advanced/pdu/crpdu.rst +++ b/docs/source/advanced/pdu/crpdu.rst @@ -1,13 +1,13 @@ Collaborative PDU ================= -Collaborative PDU is also refer as Coral PDU, it controls power for compute Rack. +Collaborative PDU is also referred as Coral PDU, it controls power for compute Rack. Pre-Defined PDU Objects ----------------------- -User needs to pre-defined PDU node object if want to run pdudiscover command. :: +A pre-defined PDU node object is required before running pdudiscover command. :: mkdef coralpdu groups=pdu mgt=pdu nodetype=pdu (required) @@ -20,7 +20,7 @@ all other attributes can be set by chdef command or pdudisocover command. :: --pdutype crpdu(for coral pdu) or irpdu(for infrastructure PDUs) -If user want to configure snmp other than default value, the following attributes need to be set. :: +The following attributes need to be set in order to configure snmp with non-default values. :: --community community string for coral pdu --snmpversion snmp version number, required if configure snmpv3 for coral pdu @@ -31,7 +31,7 @@ If user want to configure snmp other than default value, the following attribute --privtype priv protocol (AES|DES) for snmpv3 configuration --seclevel security level (noAuthNoPriv|authNoPriv|authPriv) for snmpv3 configuration -Make sure run makehosts after pre-defined PDU. :: +Make sure to run makehosts after pre-defined PDU. :: makehosts coralpdu @@ -39,7 +39,7 @@ Make sure run makehosts after pre-defined PDU. :: Configure PDUs -------------- -After pre-defined PDUs, user can use **pdudisocver --range ip_range --setup** to configure the PDUs, it covers following commands: +After pre-defining PDUs, user can use **pdudisocver --range ip_range --setup** to configure the PDUs, or following commands can be used: * To configure passwordless of Coral PDU: :: @@ -61,7 +61,7 @@ After pre-defined PDUs, user can use **pdudisocver --range ip_range --setup** to Remote Power Control of PDU --------------------------- -Use the rpower command to remotely power on and off of PDU. +Use the rpower command to remotely power on and off PDU. * To check power stat of PDU: :: @@ -93,7 +93,7 @@ Coral PDUs have three relays, the following commands are for individual relay su Show Monitor Data ----------------- -Use the rvitals command to show realtime monitor data(inpute voltage, current, power) of PDU. :: +Use the rvitals command to show realtime monitor data(input voltage, current, power) of PDU. :: # rvitals coralpdu diff --git a/docs/source/advanced/pdu/index.rst b/docs/source/advanced/pdu/index.rst index b27f754f2..42b371ae7 100644 --- a/docs/source/advanced/pdu/index.rst +++ b/docs/source/advanced/pdu/index.rst @@ -1,7 +1,7 @@ PDUs ==== -Power Distribution Units (PDUs) are devices that distribute power to servers in a frame. It has the capability of monitoring the amount of power that is being used by devices plugged into it and cycle power to individual receptacles. xCAT can support two kinds of PDUs on the fields, infrastructure PDU (irpdu) and collaborative PDU (crpdu). These two types of PDU have different design and implementation. xCAT has different code path to maintains PDU commands via **pdutype**. +Power Distribution Units (PDUs) are devices that distribute power to servers in a frame. They have the capability of monitoring the amount of power that is being used by devices plugged into it and cycle power to individual receptacles. xCAT can support two kinds of PDUs, infrastructure PDU (irpdu) and collaborative PDU (crpdu). These two types of PDU have different design and implementation. xCAT has different code path to maintains PDU commands via **pdutype**. .. toctree:: diff --git a/docs/source/advanced/pdu/irpdu.rst b/docs/source/advanced/pdu/irpdu.rst index 08c779154..b35193b50 100644 --- a/docs/source/advanced/pdu/irpdu.rst +++ b/docs/source/advanced/pdu/irpdu.rst @@ -25,19 +25,19 @@ The following commands are supported against a compute node: cn01: f5pdu3 outlet 7 is on - * Power off the PDU outlets on a compute node: :: + * Power off the PDU outlets for a compute node: :: # rpower cn01 pduoff cn01: f5pdu3 outlet 6 is off cn01: f5pdu3 outlet 7 is off - * Power on the PDU outlets on a compute node: :: + * Power on the PDU outlets for a compute node: :: # rpower cn01 pduon cn01: f5pdu3 outlet 6 is on cn01: f5pdu3 outlet 7 is on - * Power cycling the PDU outlets on a compute node: :: + * Power cycling the PDU outlets for a compute node: :: # rpower cn01 pdureset cn01: f5pdu3 outlet 6 is reset @@ -109,38 +109,38 @@ The following commands are supported against a PDU: f5pdu3: outlet 11 is reset f5pdu3: outlet 12 is reset - * PDU inventory information: :: + * PDU inventory information: :: - # rinv f6pdu16 - f6pdu16: PDU Software Version: "OPDP_sIBM_v01.3_2" - f6pdu16: PDU Machine Type: "1U" - f6pdu16: PDU Model Number: "dPDU4230" - f6pdu16: PDU Part Number: "46W1608" - f6pdu16: PDU Name: "IBM PDU" - f6pdu16: PDU Serial Number: "4571S9" - f6pdu16: PDU Description: "description" + # rinv f6pdu16 + f6pdu16: PDU Software Version: "OPDP_sIBM_v01.3_2" + f6pdu16: PDU Machine Type: "1U" + f6pdu16: PDU Model Number: "dPDU4230" + f6pdu16: PDU Part Number: "46W1608" + f6pdu16: PDU Name: "IBM PDU" + f6pdu16: PDU Serial Number: "4571S9" + f6pdu16: PDU Description: "description" - * PDU and outlet power information: :: + * PDU and outlet power information: :: - # rvitals f6pdu15 - f6pdu15: Voltage Warning: 0 - f6pdu15: outlet 1 Current: 0 mA - f6pdu15: outlet 1 Max Capacity of the current: 16000 mA - f6pdu15: outlet 1 Current Threshold Warning: 9600 mA - f6pdu15: outlet 1 Current Threshold Critical: 12800 mA - f6pdu15: outlet 1 Last Power Reading: 0 Watts - f6pdu15: outlet 2 Current: 0 mA - f6pdu15: outlet 2 Max Capacity of the current: 16000 mA - f6pdu15: outlet 2 Current Threshold Warning: 9600 mA - f6pdu15: outlet 2 Current Threshold Critical: 12800 mA - f6pdu15: outlet 2 Last Power Reading: 0 Watts - f6pdu15: outlet 3 Current: 1130 mA - f6pdu15: outlet 3 Max Capacity of the current: 16000 mA - f6pdu15: outlet 3 Current Threshold Warning: 9600 mA - f6pdu15: outlet 3 Current Threshold Critical: 12800 mA - f6pdu15: outlet 3 Last Power Reading: 217 Wattsv + # rvitals f6pdu15 + f6pdu15: Voltage Warning: 0 + f6pdu15: outlet 1 Current: 0 mA + f6pdu15: outlet 1 Max Capacity of the current: 16000 mA + f6pdu15: outlet 1 Current Threshold Warning: 9600 mA + f6pdu15: outlet 1 Current Threshold Critical: 12800 mA + f6pdu15: outlet 1 Last Power Reading: 0 Watts + f6pdu15: outlet 2 Current: 0 mA + f6pdu15: outlet 2 Max Capacity of the current: 16000 mA + f6pdu15: outlet 2 Current Threshold Warning: 9600 mA + f6pdu15: outlet 2 Current Threshold Critical: 12800 mA + f6pdu15: outlet 2 Last Power Reading: 0 Watts + f6pdu15: outlet 3 Current: 1130 mA + f6pdu15: outlet 3 Max Capacity of the current: 16000 mA + f6pdu15: outlet 3 Current Threshold Warning: 9600 mA + f6pdu15: outlet 3 Current Threshold Critical: 12800 mA + f6pdu15: outlet 3 Last Power Reading: 217 Wattsv -**Note:** For BMC based compute nodes, turning the PDU outlet power on does not automatically power on the compute side. Users will need to issue ``rpower on`` to power on the compute node after the BMC boots. +**Note:** For BMC based compute nodes, turning the PDU outlet power on does not automatically power on the compute side. Users will need to issue ``rpower on`` to power on the compute side after the BMC boots. diff --git a/docs/source/advanced/pdu/pdu.rst b/docs/source/advanced/pdu/pdu.rst index 64de43178..0157ee8da 100644 --- a/docs/source/advanced/pdu/pdu.rst +++ b/docs/source/advanced/pdu/pdu.rst @@ -31,7 +31,7 @@ Define PDU Objects mkdef f5pdu3 groups=pdu ip=50.0.0.8 mgt=pdu nodetype=pdu pdutype=irpdu -#. Define switch attribute for pdu object will use for pdudiscover **--setup** options. :: +#. Define switch attribute for pdu object which will be used for pdudiscover **--setup** options. :: chdef f5pdu3 switch=mid08 switchport=3 From 1f069848685411be2026f1ddc21c9d9afbd0918b Mon Sep 17 00:00:00 2001 From: Casandra Qiu Date: Wed, 17 Jan 2018 21:06:48 -0500 Subject: [PATCH 3/3] types of PDUs --- docs/source/advanced/pdu/crpdu.rst | 2 +- docs/source/advanced/pdu/index.rst | 4 +++- docs/source/advanced/pdu/irpdu.rst | 2 ++ 3 files changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/source/advanced/pdu/crpdu.rst b/docs/source/advanced/pdu/crpdu.rst index e527c0169..9933a80bc 100644 --- a/docs/source/advanced/pdu/crpdu.rst +++ b/docs/source/advanced/pdu/crpdu.rst @@ -1,7 +1,7 @@ Collaborative PDU ================= -Collaborative PDU is also referred as Coral PDU, it controls power for compute Rack. +Collaborative PDU is also referred as Coral PDU, it controls power for compute Rack. User can access PDU via SSH and can use the **PduManager** command to configure and manage the PDU product. Pre-Defined PDU Objects diff --git a/docs/source/advanced/pdu/index.rst b/docs/source/advanced/pdu/index.rst index 42b371ae7..625bfb269 100644 --- a/docs/source/advanced/pdu/index.rst +++ b/docs/source/advanced/pdu/index.rst @@ -1,7 +1,9 @@ PDUs ==== -Power Distribution Units (PDUs) are devices that distribute power to servers in a frame. They have the capability of monitoring the amount of power that is being used by devices plugged into it and cycle power to individual receptacles. xCAT can support two kinds of PDUs, infrastructure PDU (irpdu) and collaborative PDU (crpdu). These two types of PDU have different design and implementation. xCAT has different code path to maintains PDU commands via **pdutype**. +Power Distribution Units (PDUs) are devices that distribute power to servers in a frame. They have the capability of monitoring the amount of power that is being used by devices plugged into it and cycle power to individual receptacles. xCAT can support two kinds of PDUs, infrastructure PDU (irpdu) and collaborative PDU (crpdu). + +The Infrastructure rack PDUs are switched and monitored 1U PDU products which can connect up to nine C19 devices or up to 12 C13 devices and an additional three C13 peripheral devices to a signle dedicated power source. The Collaborative PDU is on the compute rack and has the 6x IEC 320-C13 receptacles that feed the rack switches. These two types of PDU have different design and implementation. xCAT has different code path to maintains PDU commands via **pdutype**. .. toctree:: diff --git a/docs/source/advanced/pdu/irpdu.rst b/docs/source/advanced/pdu/irpdu.rst index b35193b50..c7a557ed7 100644 --- a/docs/source/advanced/pdu/irpdu.rst +++ b/docs/source/advanced/pdu/irpdu.rst @@ -1,6 +1,8 @@ Infrastructure PDU ================== +Users can access Infrastructure PDU via telnet and use the **IBM PDU Configuration Utility** to set up and configure the PDU. xCAT supports PDU commands for power management and monitoring through SNMP. + PDU Commands ------------