xcat - extreme Cluster Administration Tool.
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.
All of the cluster configuration information is in the xCAT database. See xcatdb(5) for descriptions of every table in the database.
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.
Migrates the CFM setup in CSM to the xdcp rsync setup in xCAT.
Change xCAT data object definitions.
Use this xCAT command to check an xCAT osimage.
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.
Create masters from virtual machines and virtual machines from masters.
Allows the migration of a CSM database to an xCAT database.
Sets up the IBM DB2 for xCAT to use.
dumps the xCAT db tables .
Generates a stateless image to be used for a diskless install.
Regenerates the initrd for a stateless image to be used for a diskless install.
Collects node MAC address.
select table rows, based on attribute criteria, and display specific attributes.
downloads the xCAT documentation and converts to HTML and PDF
Builds a directory of files for each defined nodegroup in xCAT.
Captures an image from a Linux diskful node and create a diskless image on the management node.
Exports an xCAT image.
Imports an xCAT image or configuration file into the xCAT tables so that you can immediately begin deploying with it.
Modify statelite image by creating a series of links.
Use this command to list xCAT data object definitions.
Display the information of flexible node
Use this command to display the connection status for CEC and Frame nodes.
Display a summary of the statelite information.
Discovers selected networked services information within the same subnet.
Lists partition profile information for HMC- and IVM-managed nodes. For Power 775, it lists the LPARs' I/O slots information and CEC configuration.
lists xCAT daemon information.
Use this command to create xCAT data object definitions.
Use this xCAT command to define and initialize AIX/NIM diskless machines.
Create a flexible node.
Sets up connections for CEC and Frame nodes to HMC nodes or hardware server.
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).
Creates HMC- and IVM-managed partitions or other virtual machines.
Registers a monitoring plug-in to the xCAT cluster.
Configures a 3rd party monitoring software to monitor the xCAT cluster.
Deconfigures a 3rd party monitoring software from monitoring the xCAT cluster.
Lists monitoring plug-in modules that can be used to monitor the xCAT cluster.
Unregisters a monitoring plug-in module from the xCAT cluster.
Shows event data for monitoring.
Starts a plug-in module to monitor the xCAT cluster.
Stops a monitoring plug-in module to monitor the xCAT cluster.
Sets up the MySQL database for xCAT to use.
Use this xCAT command to customize AIX/NIM standalone machines.
Use this xCAT command to initialize AIX/NIM standalone machines.
Changes nodes' attributes in the xCAT cluster database.
Changes attributes at the group level in the xCAT cluster database.
lists the nodes, and their attributes, from the xCAT database.
Removes the nodes in the noderange from all database table.
display the running status of each node in a noderange
Packs the stateless image from the chroot file system.
Runs a command on the noderange using the out-of-band console.
Sets up the PostgreSQL database for xCAT to use.
parallel ping the nodes.
parallel ping from nodes to other nodes in the cluster.
parallel rsync
parallel remote copy
parallel remote shell
Turns beacon on/off/blink or gives status of a node or noderange.
Persistently sets the order of boot devices for BladeCenter blades or PPC LPARs using Direct FSP Management (DFM).
remotely accesses the serial console of a node
Registers a Perl module or a command that will get called when changes occur in the desired xCAT database tables.
remote energy management tool
replay the console output for a node
Restart the xCAT daemon (xcatd) on AIX.
restores the xCAT db tables .
retrieve or clear remote hardware event logs
Performs Licensed Internal Code (LIC) update support for HMC-attached POWER5 and POWER6 Systems, and POWER7 systems using Direct FSP management.
remote hardware inventory
Use this command to remove xCAT data object definitions.
Use this xCAT command to remove AIX/NIM diskless machine definitions.
Delete a flexible node.
Use this command to remove connections from CEC and Frame nodes to HMC nodes.
Execute migration of a guest VM between hosts/hypervisors
Removes the Linux stateless or statelite image from the file system.
Use this xCAT command to remove NIM resources specified in an xCAT osimage definition.
Removes HMC- and IVM-managed partitions.
Cause the range of nodes to boot to network.
performs cluster rolling update
remote power control of nodes
Collects node information from one or more hardware control points.
Sets the boot device to be used for BMC-based servers for the next boot only.
Configures nodes' service processors
resets the service processors associated with the specified nodes
remote hardware vitals
Checks the software configuration of the nodes in the cluster.
Change xCAT compute nodes to use a different xCAT service node.
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.
reassign the BladeCenter media tray and/or KVM to the specified blade
list table names in which an entry for the given node appears.
unregister a Perl module or a command that was watching for the changes of the desired xCAT database tables.
Adds the needed Service Node configuration files to the install image.
Update nodes in an xCAT cluster environment.
windowed remote console
kill windowed remote consoles
Sample client program for xCAT.
Use this command to create and manage AIX NIM definitions based on xCAT node, group and network object definitions.
Use this xCAT command to modify an xCAT AIX diskless operating system image.
Formats and consolidates the output of the psh, rinv commands.
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.
Concurrently runs commands on multiple nodes, or an install image.
Formats the output of the xdsh command.
Formats and consolidates the output of the xdsh,sinv commands.
PBS pbsnodes front-end for a noderange.
syntax for compactly expressing a list of node names
Format of a stanza file that can be used with xCAT data object definition commands.
Add, delete or update rows in the database tables.
Client side wrapper for copycds supporting physical drives.
Copies Linux distributions and service levels from CDs/DVDs to install directory.
creates the conserver configuration file from info in the xCAT database
Creates and updates DHCP configuration files.
sets up domain name services (DNS).
sets up /etc/hosts from the xCAT hosts table.
Make a known_hosts file under $ROOTHOME/.ssh for input noderange.
Gather cluster network information and add it to the xCAT database.
add or delete routes to/from the os route table on nodes.
creates a network boot root image for node discovery and flashing
Adds or deletes BladeCenter management module and switch node definitions in the xCAT cluster database.
Adds or deletes nodes in the xCAT cluster database.
Adds nodes to the xCAT cluster database.
set the boot state for a noderange
Begin installation on a noderange
Runs sql command files against the current xCAT database.
creates a LUN for a node to boot up with, using iSCSI
Add, delete or update rows in the database tables.
display an xCAT database table in CSV format.
view an xCAT database table in an editor and make changes.
Deletes records from the eventlog,auditlog,isnm_perf,isnm_perf_sum tables.
replaces the contents of an xCAT database table with the contents in a csv file.
Begin installation on a noderange and display in wcons
Sets up the Management Node during the xCAT install.
The xCAT daemon
Starts the xCAT daemon (xcatd) in trace mode.
Prime the xCAT database using naming conventions specified in a config file.
Gathers information for service about the current running xCAT environment.
Run automated xCAT test cases.