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

95 lines
2.9 KiB
Plaintext
Raw Normal View History

=head1 NAME
B<rollupdate> - performs cluster rolling update
=head1 SYNOPSIS
B<cat> I<stanza-file> B<|> B<rollupdate> [B<-V> | B<--verbose>] [B<-t>| B<--test>]
B<rollupdate> [B<-?> | B<-h> | B<--help> | B<-v> | B<--version>]
=head1 DESCRIPTION
The B<rollupdate> command creates and submits scheduler reservation jobs that will notify xCAT to shutdown a group of nodes, run optional out-of-band commands from the xCAT management node, and reboot the nodes. Currently, only LoadLeveler is supported as a job scheduler with B<rollupdate>.
Input to the B<rollupdate> command is passed in as stanza data through STDIN. Information such as the sets of nodes that will be updated, the name of the job scheduler, a template for generating job command files, and other control data are required. See
/opt/xcat/share/xcat/rollupdate/rollupdate.input.sample
and
/opt/xcat/share/xcat/rollupdate/rollupdate_all.input.sample
for stanza keywords, usage, and examples.
The B<rollupdate> command will use the input data to determine each set of nodes that will be managed together as an update group. For each update group, a job scheduler command file is created and a reservation request is submitted. When the group of nodes becomes available and the scheduler activates the reservation, the xcatd daemon on the management node will be notified to begin the update process for all the nodes in the update group. If specified, prescripts will be run, an operating system shutdown command will be sent to each node, out-of-band operations can be run on the management node, and the nodes are powered back on.
The B<rollupdate> command assumes that, if the update is to include rebooting stateless or statelite nodes to a new operating system image, the image has been created and tested, and that all relevant xCAT commands have been run for the nodes such that the new image will be loaded when xCAT reboots the nodes.
=head1 OPTIONS
=over 10
=item B<-v|--version>
Command Version.
=item B<-V|--verbose>
Display additional progress and error messages. Output is also logged in /var/log/xcat/rollupdate.log.
=item B<-t|--test>
Run the rollupdate command in test mode only to verify the output files that are created. No scheduler reservation requests will be submitted.
=item B<-?|-h|--help>
Display usage message.
=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.
To run a cluster rolling update based on the information provided in the file
/u/admin/rolling_updates/update_all.stanza
enter:
cat /admin/rolling_updates/update_all.stanza | rollupdate
=back
=head1 FILES
/opt/xcat/bin/rollupdate
/opt/xcat/share/xcat/rollupdate/rollupdate.input.sample
/opt/xcat/share/xcat/rollupdate/ll.tmpl
/opt/xcat/share/xcat/rollupdate/rollupdate_all.input.sample
/opt/xcat/share/xcat/rollupdate/llall.tmpl
/var/log/xcat/rollupdate.log
=head1 SEE ALSO