lskitcomp.1

NAME

lskitcomp - Used to list information for one or more kit components.

SYNOPSIS

lskitcomp [-? | -h | --help | -v | --version]

DESCRIPTION

The lskitcomp command is used to list information for one or more kit components. A kit is made up of one or more kit components. Each kit component is a meta package used to install a software product component on one or more nodes in an xCAT cluster.

The lskitcomp command outputs the kit component info in two formats: human-readable format (default), and XML format. Use the -x option to view the info in XML format.

Input to the command can specify any number or combination of the input options.

Note: The xCAT support for Kits is only available for Linux operating systems.

OPTIONS

-C|--compattr compattr_names

where compattr_names is a comma-delimited list of kit component attribute names. The names correspond to attribute names in the kitcomponent table. The lskitcomp command will only display the specified kit component attributes.

-O|--osdistro os_distro

where os_distro is the name of an osdistro in osdistro table. The lskitcomp command will only display the kit components matching the specified osdistro.

-S|--serverrole server_role

where server_role is the name of a server role. The typical server roles are: mgtnode, servicenode, computenode, loginnode, storagennode. The lskitcomp command will only display the kit components matching the specified server role.

kitcomp_names

is a comma-delimited list of kit component names. The lskitcomp command will only display the kit components matching the specified names.

-x|--xml|--XML

Need XCATXMLTRACE=1 env when using -x|–xml|–XML. Return the output with XML tags. The data is returned as:
<data>
  <kitinfo>
     ...
  </kitinfo>
</data>
...
<data>
  <kitinfo>
     ...
  </kitinfo>
</data>
Each <kitinfo> tag contains info for a group of kit components belonging to the same kit. The info inside <kitinfo> is structured as follows:
The <kit> sub-tag contains the kit's name.
The <kitcomponent> sub-tags store info about the kit's components.
The data inside <kitinfo> is returned as:
<kitinfo>
   <kit>
     ...
   </kit>

   <kitcomponent>
     ...
   </kitcomponent>
   ...
</kitinfo>

-V|--verbose

Display additional progress and error messages.

-v|--version

Command Version.

-?|-h|--help

Display usage message.

RETURN VALUE

0 The command completed successfully.

1 An error has occurred.

EXAMPLES

To list all kit components, enter:
```
lskitcomp
```
To list the kit component “comp-server-1.0-1-rhels-6-x86_64”, enter:
```
lskitcomp comp-server-1.0-1-rhels-6-x86_64
```
To list the kit component “comp-server-1.0-1-rhels-6-x86_64” for selected kit component attributes, enter:
```
lskitcomp -C kitcompname,desc comp-server-1.0-1-rhels-6-x86_64
```
To list kit components compatible with “rhels-6.2-x86_64” osdistro, enter:
```
lskitcomp -O rhels-6.2-x86_64
```
To list kit components compatible with “rhels-6.2-x86_64” osdistro and “computenode” server role, enter:
```
lskitcomp -O rhels-6.2-x86_64 -S computenode
```
To list the kit component “testkit-compute-1.0-1-ubuntu-14.04-ppc64el” with XML tags, enter:
```
XCATXMLTRACE=1 lskitcomp -x testkit-compute-1.0-1-ubuntu-14.04-ppc64el
```

FILES

/opt/xcat/bin/lskitcomp