=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<--noscripts>] 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.

B<Note:> xCAT Kit support 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>

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

2. Kit components added by addkitcomp -n will be installed separately behind all other ones which have been added.

=item B<--noscripts>

Do not add kitcomponent's postbootscripts to osimage

=item I<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 add a single kit component to osimage "rhels6.2-ppc64-netboot-compute":

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

2. To add a kit component to osimage with dependencies, use the -a (addeps) option:

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

3. To add a kit component to osimage with incompatable osarch, osversion or ostype, use the -f (force) option: 

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

4. To add a new version of kit component to osimage without upgrade, use the -n (noupgrade) option:

 addkitcomp -n -i rhels6.2-ppc64-netboot-compute 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>


