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 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.

cfm2xcat(1)

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

chdef(1)

Change xCAT data object definitions.

chkosimage(1)

Use this xCAT command to check an xCAT osimage.

chvm(1)

Changes HMC- and IVM-managed partition profiles. 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.

clonevm(1)

Create masters from virtual machines and virtual machines from masters.

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)

Regenerates the initrd for a stateless image to be used for a diskless install.

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 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.

lslite(1)

Display a summary of the statelite information.

lsslp(1)

Discovers selected networked services information within the same subnet.

lsvm(1)

Lists partition profile information for HMC- and IVM-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- and IVM-managed partitions or other virtual machines.

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 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.

nodech(1)

Changes nodes' attributes in the xCAT cluster database.

nodegrpch(1)

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

nodels(1)

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

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.

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) on AIX.

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.

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.

rmigrate(1)

Execute migration of a guest VM between hosts/hypervisors

rmimage(1)

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

rmnimimage(1)

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

rmvm(1)

Removes HMC- and IVM-managed partitions.

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)

Change xCAT compute nodes to use 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

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 commands on multiple 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 CDs/DVDs to 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

mkrrbc(8)

Adds or deletes BladeCenter management module and switch node definitions in the xCAT cluster database.

mkrrnodes(8)

Adds or deletes nodes in the xCAT cluster database.

nodeadd(8)

Adds nodes to the xCAT cluster database.

nodeset(8)

set the boot state for a noderange

rinstall(8)

Begin installation on a noderange

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 the contents of an xCAT database table with the contents in a csv file.

winstall(8)

Begin installation on a noderange and display in wcons

xcatconfig(8)

Sets up the Management Node during the xCAT install.

xcatd(8)

The xCAT daemon

xcatdebug(8)

Starts the xCAT daemon (xcatd) in trace mode.

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.