20 xcatprobe_framework

Weihua Hu edited this page 2016-06-21 16:16:36 +08:00

Table of Contents

• xCAT Probe Framework
• The Directory Structure of xCAT Probe
• How to Maintain xCAT probe in github
• The Main Script (xcatporbe)
• Responsibility
• Usage
• The Rules Checking Tools Need to Follow

xCAT Probe Framework

The Directory Structure of xCAT Probe

After installation, xCAT probe is going to work like below:

/opt/xcat/bin/xcatprobe
         |
         /probe/subcmds/xcatmn
               |      |/discover
               |      |/.....
               |
               /lib/perl/xx.pm
                   |   |/xx.pm
                   |   |/.....
                   |/c/xx.c
                   | |/xx.c
                   | |...
                   |/shell/xx.sh
                   |     |/xx.sh
                   |     |/....
                   |/....

How to Maintain xCAT probe in github

In github, All code of xCAT probe are going to maintain like below:

<xCAT_home>/xCAT-probe/xcatprobe
                     |/subcmds/xcatmn
                     |       |/discover
                     |       |/.....
                     |lib/perl/xx.pm
                        |    |/xx.pm
                        |    |/....
                        |/c/xx.c
                        | |/xx.c
                        | |...
                        |/shell/xx.sh
                        |     |/xx.sh
                        |     |/....
                        |/....

The Main Script (xcatporbe)

Responsibility

• xcatprobe will manage all checking tools uniformly, Loads and triggers checking tools by one way

• xcatprobe will reformat the output of checking tool to uniform style

• xcatprobe will connect some solution database, offers solution for failed checking point (a future feature)

Usage

The usage of xcatprobe like below:

Usage:
    xcatprobe -h
    xcatprobe -l
    xcatprobe [-V] <subcommand>  <attrbute_to_subcommand>

Options:
    -h : get usage information of xcatprobe
    -l : list all valid sub commands
    -V : print verbose information of xcatprobe itself

• The first argument without starting by - in command line will be treated as checking tool name
• The arguments between xcatprobe and checking tool are treated as arguments of xcatprobe itself
• The arguments behind checking tool are treated as arguments of checking tool

The Rules Checking Tools Need to Follow

Checking tools can be developed by any language and any contributor. As long as these checking tools follow below rules, they can be loaded and triggered by xcatprobe.

• The output of checking tool must follow below format:

  [flag] : one line message

  • The valid flag are ok, warning, failed, info and debug.

• Checking tool must reserve and support one option (-T) for working with xcatprobe.

  • -T: xcatprobe will call checktool -T then it tries to load this checking tool, the output of checktool -T will result in whether xcatprobe loads it or not. The output must follow [flag]:one line message format. The flag is ok. The message will describe what the checking tool is used for, limitation and prerequisite and so on. These message will be display when xcatporbe -l run.

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.