2010-06-17 13:58:43 +00:00
|
|
|
=head1 NAME
|
|
|
|
|
|
|
|
|
|
B<chkosimage> - Use this xCAT command to check an xCAT osimage.
|
|
|
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
|
|
|
|
|
B<chkosimage [-h | --help ]>
|
|
|
|
|
|
2010-08-03 17:27:25 +00:00
|
|
|
B<chkosimage [-V] [-c|--clean] osimage_name>
|
2010-06-17 13:58:43 +00:00
|
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
|
2010-08-03 17:27:25 +00:00
|
|
|
This command is currently supported for AIX osimages only.
|
2010-06-17 13:58:43 +00:00
|
|
|
|
2010-08-03 17:27:25 +00:00
|
|
|
Use this command to verify if the NIM lpp_source directories contain the
|
|
|
|
|
correct software. The lpp_source directory must contain all the software
|
|
|
|
|
that is specified in the "installp_bundle" and "otherpkgs"
|
2010-06-17 13:58:43 +00:00
|
|
|
attributes of the osimage definition.
|
|
|
|
|
|
2010-08-03 17:27:25 +00:00
|
|
|
The command gets the name of the lpp_source resource from the xCAT osimage
|
|
|
|
|
definition and the location of the lpp_source directory from the NIM resource
|
|
|
|
|
definition.
|
|
|
|
|
|
|
|
|
|
In addition to checking for missing software the chkosimage command will
|
|
|
|
|
also check to see if there are multiple matches. This could happen
|
|
|
|
|
when you use wildcards in the software file names. For example, if you
|
|
|
|
|
have perl-xCAT* in a bundle file it could match multiple versions of the xCAT
|
|
|
|
|
rpm package saved in your lpp_source directory.
|
|
|
|
|
|
|
|
|
|
If this happens you must remove the unwanted versions of the rpms. If the
|
|
|
|
|
extra rpms are not removed you will get install errors.
|
|
|
|
|
|
|
|
|
|
To help with this process you can use the "-c|--clean" option. This
|
|
|
|
|
option will keep the rpm package with the most recent timestamp and
|
|
|
|
|
remove the others.
|
|
|
|
|
|
|
|
|
|
The chkosimage command should always be used to verify the lpp_source content
|
|
|
|
|
before using the osimage to install any AIX cluster nodes.
|
2010-06-17 13:58:43 +00:00
|
|
|
|
|
|
|
|
=head1 OPTIONS
|
|
|
|
|
|
|
|
|
|
=over 3
|
|
|
|
|
|
2010-08-03 17:27:25 +00:00
|
|
|
=item B<-c |--clean>
|
|
|
|
|
|
|
|
|
|
Remove any older versions of the rpms. Keep the version with the latest
|
|
|
|
|
timestamp.
|
|
|
|
|
|
2010-06-17 13:58:43 +00:00
|
|
|
=item B<-h |--help>
|
|
|
|
|
|
|
|
|
|
Display usage message.
|
|
|
|
|
|
|
|
|
|
=item B<osimage_name>
|
|
|
|
|
|
|
|
|
|
The name of the xCAT for AIX osimage definition.
|
|
|
|
|
|
|
|
|
|
=item B<-V |--verbose>
|
|
|
|
|
|
|
|
|
|
Verbose mode.
|
|
|
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
|
|
=head1 RETURN VALUE
|
|
|
|
|
|
|
|
|
|
=over 3
|
|
|
|
|
|
|
|
|
|
=item 0
|
|
|
|
|
|
|
|
|
|
The command completed successfully.
|
|
|
|
|
|
|
|
|
|
=item 1
|
|
|
|
|
|
|
|
|
|
An error has occurred.
|
|
|
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
|
|
=head1 EXAMPLES
|
|
|
|
|
|
|
|
|
|
=over 3
|
|
|
|
|
|
|
|
|
|
=item 1
|
|
|
|
|
|
2010-08-03 17:27:25 +00:00
|
|
|
Check the XCAT osimage called "61image" to verify that the lpp_source
|
2010-06-17 13:58:43 +00:00
|
|
|
directories contain all the software that is specified in the
|
|
|
|
|
"installp_bundle" and "otherpkgs" attributes.
|
|
|
|
|
|
2010-08-03 17:27:25 +00:00
|
|
|
B<chkosimage -V 61image>
|
|
|
|
|
|
|
|
|
|
=item 2
|
|
|
|
|
|
|
|
|
|
Clean up the lpp_source directory for the osimage named "61img" by removing
|
|
|
|
|
any older rpms with the same names but different versions.
|
|
|
|
|
|
|
|
|
|
B<chkosimage -c 61img>
|
2010-06-17 13:58:43 +00:00
|
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
|
|
=head1 FILES
|
|
|
|
|
|
|
|
|
|
/opt/xcat/bin/chkosimage
|
|
|
|
|
|
|
|
|
|
=head1 NOTES
|
|
|
|
|
|
|
|
|
|
This command is part of the xCAT software product.
|
|
|
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
|
|
|
|
|
L<mknimimage(1)|mknimimage.1>
|
|
|
|
|
|
|
|
|
|
|
