xcat-core

mirror of https://github.com/xcat2/xcat-core.git synced 2024-11-23 18:10:14 +00:00

Table of Contents

Overview
Pre-defined PDU node object
Discovering PDUs
Configure PDUs
Remote power control of PDUs
Show Monitor Data
Show manufacture information

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

News

Apr 22, 2016: xCAT 2.11.1 released.
Mar 11, 2016: xCAT 2.9.3 (AIX only) released.
Dec 11, 2015: xCAT 2.11 released.
Nov 11, 2015: xCAT 2.9.2 (AIX only) released.
Jul 30, 2015: xCAT 2.10 released.
Jul 30, 2015: xCAT migrates from sourceforge to github
Jun 26, 2015: xCAT 2.7.9 released.
Mar 20, 2015: xCAT 2.9.1 released.
Dec 12, 2014: xCAT 2.9 released.
Sep 5, 2014: xCAT 2.8.5 released.
May 23, 2014: xCAT 2.8.4 released.
Jan 24, 2014: xCAT 2.7.8 released.
Nov 15, 2013: xCAT 2.8.3 released.
Jun 26, 2013: xCAT 2.8.2 released.
May 17, 2013: xCAT 2.7.7 released.
May 10, 2013: xCAT 2.8.1 released.
Feb 28, 2013: xCAT 2.8 released.
Nov 30, 2012: xCAT 2.7.6 released.
Oct 29, 2012: xCAT 2.7.5 released.
Aug 27, 2012: xCAT 2.7.4 released.
Jun 22, 2012: xCAT 2.7.3 released.
May 25, 2012: xCAT 2.7.2 released.
Apr 20, 2012: xCAT 2.7.1 released.
Mar 19, 2012: xCAT 2.7 released.
Mar 15, 2012: xCAT 2.6.11 released.
Jan 23, 2012: xCAT 2.6.10 released.
Nov 15, 2011: xCAT 2.6.9 released.
Sep 30, 2011: xCAT 2.6.8 released.
Aug 26, 2011: xCAT 2.6.6 released.
May 20, 2011: xCAT 2.6 released.
Feb 14, 2011: Watson plays on Jeopardy and is managed by xCAT!
xCAT Release Notes Summary
xCAT OS And Hw Support Matrix
xCAT Test Environment Summary

History

Oct 22, 2010: xCAT 2.5 released.
Apr 30, 2010: xCAT 2.4 is released.
Oct 31, 2009: xCAT 2.3 released.
xCAT's 10 year anniversary!
Apr 16, 2009: xCAT 2.2 released.
Oct 31, 2008: xCAT 2.1 released.
Sep 12, 2008: Support for xCAT 2
can now be purchased!
June 9, 2008: xCAT breaths life into
(at the time) the fastest
supercomputer on the planet
May 30, 2008: xCAT 2.0 for Linux
officially released!
Oct 31, 2007: IBM open sources
xCAT 2.0 to allow collaboration
among all of the xCAT users.
Oct 31, 1999: xCAT 1.0 is born!
xCAT started out as a project in
IBM developed by Egan Ford. It
was quickly adopted by customers
and IBM manufacturing sites to
rapidly deploy clusters.