NAME

xcat - extreme Cluster Administration Tool.


DESCRIPTION

Extreme Cluster Administration Toolkit (xCAT). xCAT is a scalable distributed computing management and provisioning tool that provides a unified interface for hardware control, discovery, and OS diskful/diskfree deployment.


XCAT DATABASE

All of the cluster configuration information is in the xCAT database. See xcatdb(5) for descriptions of every table in the database.


XCAT ADDITIONAL TOOLS

Some additional tools have been contributed to xCAT. You can read about them at http://xcat.sourceforge.net/tools/README.html or in /opt/xcat/share/xcat/tools/README.txt on your xCAT management node.


XCAT COMMANDS

What follows is a short description of each xCAT command. To get more information about a particular command, see its man page. Note that the commands are listed in alphabetical order within each section, i.e. all the commands in section 1, then the commands in section 3, etc.

addkit(1)

Install a kit on the xCAT management node

addkitcomp(1)

Assign Kit components to an xCAT osimage.

cfgve(1)

Configure the elements for a virtual environment.

cfm2xcat(1)

Migrates the CFM setup in CSM to the xdcp rsync setup in xCAT.

chdef(1)

Change xCAT data object definitions.

chhypervisor(1)

Configure the virtualization hosts.

chkkitcomp(1)

Check if Kit components are compatible with an xCAT osimage.

chkosimage(1)

Use this xCAT command to check an xCAT osimage.

chvm(1)

Changes HMC-, DFM-, IVM-, and zVM-managed partition profiles or virtual machines. For Power 775, chvm could be used to change the octant configuration values for generating LPARs; change the I/O slots assignment to LPARs within the same CEC.

chzone(1)

Changes a zone defined in the cluster.

clonevm(1)

Create masters from virtual machines and virtual machines from masters.

configfpc(1)

discover the Fan Power Controllers (FPCs) and configure the FPC interface

csm2xcat(1)

Allows the migration of a CSM database to an xCAT database.

db2sqlsetup(1)

Sets up the IBM DB2 for xCAT to use.

dumpxCATdb(1)

dumps the xCAT db tables .

genimage(1)

Generates a stateless image to be used for a diskless install.

geninitrd(1)

Generate an initrd (initial ramfs) which to be used for statefull install or stateless netboot.

getmacs(1)

Collects node MAC address.

gettab(1)

select table rows, based on attribute criteria, and display specific attributes.

getxcatdocs(1)

downloads the xCAT documentation and converts to HTML and PDF

groupfiles4dsh(1)

Builds a directory of files for each defined nodegroup in xCAT.

imgcapture(1)

Captures an image from a Linux diskful node and create a diskless or diskful image on the management node.

imgexport(1)

Exports an xCAT image.

imgimport(1)

Imports an xCAT image or configuration file into the xCAT tables so that you can immediately begin deploying with it.

liteimg(1)

Modify statelite image by creating a series of links.

lsdef(1)

Use this command to list xCAT data object definitions.

lsflexnode(1)

Display the information of flexible node

lshwconn(1)

Use this command to display the connection status for CEC and Frame nodes.

lskit(1)

Lists information for one or more Kits.

lskitcomp(1)

Used to list information for one or more kit components.

lskitdeployparam(1)

Lists the deployment parameters for one or more Kits or Kit components

lskmodules(1)

list kernel driver modules in rpms or driver disk image files

lslite(1)

Display a summary of the statelite information.

lsslp(1)

Discovers selected networked services information within the same subnet.

lstree(1)

Display the tree of service node hierarchy, hardware hierarchy, or VM hierarchy.

lsve(1)

Lists detail attributes for a virtual environment.

lsvm(1)

Lists partition profile information for HMC-, DFM-, IVM-, KVM-, Vmware- and zVM-managed nodes. For Power 775, it lists the LPARs' I/O slots information and CEC configuration.

lsxcatd(1)

lists xCAT daemon information.

mkdef(1)

Use this command to create xCAT data object definitions.

mkdsklsnode(1)

Use this xCAT command to define and initialize AIX/NIM diskless machines.

mkflexnode(1)

Create a flexible node.

mkhwconn(1)

Sets up connections for CEC and Frame nodes to HMC nodes or hardware server.

mknimimage(1)

Use this xCAT command to create xCAT osimage definitions and related AIX/NIM resources. The command can also be used to update an existing AIX diskless image(SPOT).

mkvm(1)

Creates HMC-, DFM-, IVM-, and zVM-managed partitions or other virtual machines.

mkzone(1)

Defines a new zone in the cluster.

monadd(1)

Registers a monitoring plug-in to the xCAT cluster.

moncfg(1)

Configures a 3rd party monitoring software to monitor the xCAT cluster.

mondecfg(1)

Deconfigures a 3rd party monitoring software from monitoring the xCAT cluster.

monls(1)

Lists monitoring plug-in modules that can be used to monitor the xCAT cluster.

monrm(1)

Unregisters a monitoring plug-in module from the xCAT cluster.

monshow(1)

Shows event data for monitoring.

monstart(1)

Starts a plug-in module to monitor the xCAT cluster.

monstop(1)

Stops a monitoring plug-in module to monitor the xCAT cluster.

mysqlsetup(1)

Sets up the MySQL or MariaDB database for xCAT to use.

nimnodecust(1)

Use this xCAT command to customize AIX/NIM standalone machines.

nimnodeset(1)

Use this xCAT command to initialize AIX/NIM standalone machines.

nodeaddunmged(1)

Create a unmanaged node.

nodech(1)

Changes nodes' attributes in the xCAT cluster database.

nodechmac(1)

Updates the MAC address for a node.

nodechprofile(1)

updates a profile used by a node

nodediscoverdef(1)

Define the undefined discovery request to a predefined xCAT node,

nodediscoverls(1)

List the discovered nodes

nodediscoverstart(1)

starts the node discovery process

nodediscoverstatus(1)

gets the node discovery process status

nodediscoverstop(1)

stops the node discovery process.

nodegrpch(1)

Changes attributes at the group level in the xCAT cluster database.

nodeimport(1)

Create profiled nodes by importing hostinfo file.

nodels(1)

lists the nodes, and their attributes, from the xCAT database.

nodepurge(1)

Removes nodes.

noderefresh(1)

Update nodes configurations by running associated kit plugins.

noderm(1)

Removes the nodes in the noderange from all database table.

nodestat(1)

display the running status of each node in a noderange

packimage(1)

Packs the stateless image from the chroot file system.

pasu(1)

run the ASU to many nodes in parallel

pcons(1)

Runs a command on the noderange using the out-of-band console.

pgsqlsetup(1)

Sets up the PostgreSQL database for xCAT to use.

pping(1)

parallel ping the nodes.

ppping(1)

parallel ping from nodes to other nodes in the cluster.

prsync(1)

parallel rsync

pscp(1)

parallel remote copy

psh(1)

parallel remote shell

rbeacon(1)

Turns beacon on/off/blink or gives status of a node or noderange.

rbootseq(1)

Persistently sets the order of boot devices for BladeCenter blades or PPC LPARs using Direct FSP Management (DFM).

rcons(1)

remotely accesses the serial console of a node

regnotif(1)

Registers a Perl module or a command that will get called when changes occur in the desired xCAT database tables.

renergy(1)

remote energy management tool

replaycons(1)

replay the console output for a node

restartxcatd(1)

Restart the xCAT daemon (xcatd).

restorexCATdb(1)

restores the xCAT db tables .

reventlog(1)

retrieve or clear remote hardware event logs

rflash(1)

Performs Licensed Internal Code (LIC) update support for HMC-attached POWER5 and POWER6 Systems, and POWER7 systems using Direct FSP management. rflash is also able to update firmware for NextScale Fan Power Controllers (FPC).

rinv(1)

Remote hardware inventory

rmdef(1)

Use this command to remove xCAT data object definitions.

rmdsklsnode(1)

Use this xCAT command to remove AIX/NIM diskless machine definitions.

rmflexnode(1)

Delete a flexible node.

rmhwconn(1)

Use this command to remove connections from CEC and Frame nodes to HMC nodes.

rmhypervisor(1)

Remove the virtualization hosts.

rmigrate(1)

Execute migration of a guest VM between hosts/hypervisors

rmimage(1)

Removes the Linux stateless or statelite image from the file system.

rmkit(1)

Remove Kits from xCAT

rmkitcomp(1)

Remove Kit components from an xCAT osimage.

rmnimimage(1)

Use this xCAT command to remove NIM resources specified in an xCAT osimage definition.

rmvm(1)

Removes HMC-, DFM-, IVM-, KVM-, Vmware- and zVM-managed partitions or virtual machines.

rmzone(1)

Removes a zone from the cluster.

rnetboot(1)

Cause the range of nodes to boot to network.

rollupdate(1)

performs cluster rolling update

rpower(1)

remote power control of nodes

rscan(1)

Collects node information from one or more hardware control points.

rsetboot(1)

Sets the boot device to be used for BMC-based servers for the next boot only.

rspconfig(1)

Configures nodes' service processors

rspreset(1)

resets the service processors associated with the specified nodes

rvitals(1)

remote hardware vitals

sinv(1)

Checks the software configuration of the nodes in the cluster.

snmove(1)

Move xCAT compute nodes to a different xCAT service node.

swapnodes(1)

swap the location info in the db (all the attributes in the ppc table and the nodepos table) between 2 nodes. If swapping within a cec, it will assign the IO adapters that were assigned to the defective node to the available node.

switchblade(1)

reassign the BladeCenter media tray and/or KVM to the specified blade

tabgrep(1)

list table names in which an entry for the given node appears.

unregnotif(1)

unregister a Perl module or a command that was watching for the changes of the desired xCAT database tables.

updateSNimage(1)

Adds the needed Service Node configuration files to the install image.

updatenode(1)

Update nodes in an xCAT cluster environment.

wcons(1)

windowed remote console

wkill(1)

kill windowed remote consoles

wvid(1)

windowed remote video console for nodes

xCATWorld(1)

Sample client program for xCAT.

xcat2nim(1)

Use this command to create and manage AIX NIM definitions based on xCAT node, group and network object definitions.

xcatchroot(1)

Use this xCAT command to modify an xCAT AIX diskless operating system image.

xcoll(1)

Formats and consolidates the output of the psh, rinv commands.

xdcp(1)

Concurrently copies files to or from multiple nodes. In addition, provides an option to use rsync to update the files on the nodes, or to an installation image on the local node.

xdsh(1)

Concurrently runs remote commands on multiple nodes (Management Node, Service Nodes, compute nodes), or an install image.

xdshbak(1)

Formats the output of the xdsh command.

xdshcoll(1)

Formats and consolidates the output of the xdsh,sinv commands.

xpbsnodes(1)

PBS pbsnodes front-end for a noderange.

noderange(3)

syntax for compactly expressing a list of node names

xcatstanzafile(5)

Format of a stanza file that can be used with xCAT data object definition commands.

chtab(8)

Add, delete or update rows in the database tables.

copycds-cdrom(8)

Client side wrapper for copycds supporting physical drives.

copycds(8)

Copies Linux distributions and service levels from DVDs/ISOs to the xCAT /install directory.

makeconservercf(8)

creates the conserver configuration file from info in the xCAT database

makedhcp(8)

Creates and updates DHCP configuration files.

makedns(8)

sets up domain name services (DNS).

makehosts(8)

sets up /etc/hosts from the xCAT hosts table.

makeknownhosts(8)

Make a known_hosts file under $ROOTHOME/.ssh for input noderange.

makenetworks(8)

Gather cluster network information and add it to the xCAT database.

makeroutes(8)

add or delete routes to/from the os route table on nodes.

mknb(8)

creates a network boot root image for node discovery and flashing

nodeadd(8)

Adds nodes to the xCAT cluster database.

nodeset(8)

set the boot state for a noderange

rescanplugins(8)

Notifies xcatd to rescan the plugin directory

rinstall(8)

Begin OS provision on a noderange

rmosdistro(8)

remove OS Distro

runsqlcmd(8)

Runs sql command files against the current xCAT database.

setupiscsidev(8)

creates a LUN for a node to boot up with, using iSCSI

tabch(8)

Add, delete or update rows in the database tables.

tabdump(8)

display an xCAT database table in CSV format.

tabedit(8)

view an xCAT database table in an editor and make changes.

tabprune(8)

Deletes records from the eventlog,auditlog,isnm_perf,isnm_perf_sum tables.

tabrestore(8)

replaces with or adds to a xCAT database table the contents in a csv file.

winstall(8)

Begin OS provision on a noderange

xcatconfig(8)

Sets up the Management Node during the xCAT install.

xcatd(8)

The xCAT daemon

xcatdebug(8)

Enable or disable the trace facilities for xCAT. (Only supports Linux Operating System)

xcatsetup(8)

Prime the xCAT database using naming conventions specified in a config file.

xcatsnap(8)

Gathers information for service about the current running xCAT environment.

xcattest(1)

Run automated xCAT test cases.

buildkit(1)

Build product software kits to be installed in an xCAT cluster.