xcat-core/xCAT-client/pods/man1/swapnodes.1.pod
2011-03-28 07:07:03 +00:00

72 lines
1.8 KiB
Plaintext

=head1 NAME
B<swapnodes> - swap the location info in the db between 2 nodes. If swapping within a cec, it will assign the IO adapters that were assigned to the defective node to the available node.
=head1 SYNOPSIS
B<swapnodes> [B<-h>| B<--help>]
B<swapnodes> B<-c> current_node B<-f> fip_node [-o]
=head1 DESCRIPTION
This command is only for P7 IH using Direct FSP Management. Without -o option, it's used to swap the location info in the db between 2 nodes. With -o option, it's used to move the current_node definition to fip_node (the 2nd octant), not move the fip_node definition to the 1st octant. If the two nodes are in a cec, it will assign the IO adapters that were assigned to the defective node to the available node. Originally, the current_node is a defective non-compute node, and fip_node is a avaible compute node. After the swapping, the current_node will be a available node.
=head1 OPTIONS
=over 5
=item B<-h|--help>
Display usage message.
=item B<-c>
current_node -- the defective non-compute node.
=item B<-f>
fip_node -- a compute node which will be swapped as the non-compute node.
=item B<-o>
one way. Move the current_node definition to fip_node (the 2nd octant), and not move the fip_node definition to the 1st octant.
=back
=head1 RETURN VALUE
0 The command completed successfully.
1 An error has occurred.
=head1 EXAMPLES
=over 3
=item 1.
To swap the service node attributes and IO assignments between sn1 and compute2 which are in the same cec:
swapnodes -c sn1 -f compute2
=back
=head1 FILES
$XCATROOT/bin/swapnodes
(The XCATROOT environment variable is set when xCAT is installed. The
default value is "/opt/xcat".)
=head1 NOTES
This command is part of the xCAT software product.
=head1 SEE ALSO
L<lsvm(1)|lsvm.1>, L<mkvm(1)|mkvm.1>, L<chvm(1)|chvm.1>