Coral PDU supports - xcat2/xcat-core GitHub Wiki

Overview

Coral PDU is a collaborative PDU used for IBM HPC project and is intended to supply AC mains power to a rack of machines. xCAT provide few commands to support Coral PDU.

Pre-defined PDU node object

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    cpdu(for coral pdu) or ipdu(for intelligent), can be filled in by pdudiscover command

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

Discovering PDUs

Use pdudiscover command to discover the PDUs that are attached to the neghboring subnets on xCAT management node.

        pdudiscover --range ip_ranges [-r][-x][-z][-w][--setup]

xCAT use snmp scan method to discover PDU, make sure net-snmp-utils package is installed on xCAT MN.

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.

Configure PDUs

The rspconfig command can be used to configure the PDUs.

To configure passwordless of Coral PDU:

        rspconfig coralpdu sshcfg

To change hostname of Coral PDU:

        rspconfig coralpdu hostname=coralpdu

To change ip address of PDU:

        rspconfig coralpdu ip=x.x.x.x netmask=255.x.x.x

To configure SNMP of PDU (the attribute needs to pre-defined):

        rspconfig coralpdu snmpcfg

Remote power control of PDUs

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

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