xcat-core/xCAT-client/pods/man1/addkitcomp.1.pod

=head1 NAME

B<addkitcomp> - Assign Kit components to an xCAT osimage.

=head1 SYNOPSIS

B<addkitcomp> [B<-?>|B<-h>|B<--help>] [B<-v>|B<--version>]

B<addkitcomp> [B<-V>|B<--verbose>] [B<-a>|B<--adddeps>] [B<-f>|B<--force>] [B<-n>|B<--noupgrade>] B<-i> I<osimage>  I<kitcompname_list>

=head1 DESCRIPTION

The B<addkitcomp> command will assign kit components to an xCAT osimage. The kit component meta rpm, package rpm and deploy parameters will be added to osimage's otherpkg.pkglist and postbootscripts will be added to osimages's postbootscripts attribute.

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

=head1 OPTIONS

=over 10
 
=item B<-a|--adddeps>

Assign kitcomponent dependencies to the osimage.

=item B<-h|--help>

Display usage message.

=item B<-V|--verbose>

Verbose mode.

=item B<-v|--version>

Command version.

=item B<-f|--force>

Add kit component to osimage even if there is a mismatch in OS, version, arch, serverrole, or kitcompdeps

=item B<-i> I<osimage>

The osimage name that the kit component is assigning to.

=item B<-n|--noupgrade>

Allow multiple versions of kitcomponent to be installed into the osimage, instead of kitcomponent upgrade

=item B<kitcompname_list>

A comma-delimited list of valid full kit component names or kit component basenames that are to be added to the osimage.

=back

=head1 RETURN VALUE

0  The command completed successfully.

1  An error has occurred.

=head1 EXAMPLES

1. To assign a kit component to osimage

addkitcomp -i rhels6.2-ppc64-netboot-compute comp-test1-1.0-1-rhels-6.2-ppc64

Output is similar to:

Assigning kit component comp-test1-1.0-1-rhels-6.2-ppc64 to osimage rhels6.2-ppc64-netboot-compute
Kit components comp-test1-1.0-1-rhels-6.2-ppc64 were added to osimage rhels6.2-ppc64-netboot-compute successfully

2. To assign a kit component to osimage with its dependency.

addkitcomp -a -i rhels6.2-ppc64-netboot-compute comp-test2-1.0-1-rhels-6.2-ppc64

Output is similar to:

Assigning kit component comp-test1-1.0-1-rhels-6.0-ppc64 to osimage rhels6.2-ppc64-netboot-compute
Assigning kit component comp-test2-1.0-1-rhels-6.2-ppc64 to osimage rhels6.2-ppc64-netboot-compute
Kit components comp-test1-1.0-1-rhels-6.0-ppc64,comp-test2-1.0-1-rhels-6.2-ppc64 were added to osimage rhels6.2-ppc64-netboot-compute successfully

3. To assign a kit component to osimage with incompatable osarch, osversion or ostype.

addkitcomp -f -i rhels6.2-ppc64-netboot-compute comp-test1-1.0-1-rhels-6.2-ppc64

Output is similar to:

Assigning kit component comp-test1-1.0-1-rhels-6.2-ppc64 to osimage rhels6.2-ppc64-netboot-compute
Kit components comp-test1-1.0-1-rhels-6.2-ppc64 were added to osimage rhels6.2-ppc64-netboot-compute successfully

4. To assign a new version of kit component to osimage without upgrade.

addkitcomp -n -i rhels6.2-ppc64-netboot-compute comp-test2-1.0-1-rhels-6.2-ppc64

Output is similar to:

Assigning kit component comp-test1-1.0-1-rhels-6.0-ppc64 to osimage rhels6.2-ppc64-netboot-compute
Assigning kit component comp-test2-1.0-1-rhels-6.2-ppc64 to osimage rhels6.2-ppc64-netboot-compute
Kit components comp-test2-1.0-1-rhels-6.2-ppc64 were added to osimage rhels6.2-ppc64-netboot-compute successfully

The result will be:
lsdef -t osimage rhels6.2-ppc64-netboot-compute -i kitcomponents
Object name: rhels6.2-ppc64-netboot-compute
kitcomponents=comp-test2-1.0-0-rhels-6.2-ppc64,comp-test2-1.0-1-rhels-6.2-ppc64


=head1 SEE ALSO

L<lskit(1)|lskit.1>, L<addkit(1)|addkit.1>, L<rmkit(1)|rmkit.1>, L<rmkitcomp(1)|rmkitcomp.1>, L<chkkitcomp(1)|chkkitcomp.1>