xcat-core/xCAT-client/pods/man8/makeroutes.8.pod
linggao 01eb73616d minor fix for makeroutes
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@9269 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
2011-04-11 13:44:01 +00:00

91 lines
2.4 KiB
Plaintext

=head1 NAME
B<makeroutes> - add or delete routes to/from the os route table on nodes.
=head1 SYNOPSIS
B<makeroutes> [B<-r>|B<--routename> I<r1>[I<,r2...>]]
B<makeroutes> B<-d>|B<--delete> [B<-r>|B<--routenames> I<r1>[I<,r2...>]]
B<makeroutes> I<noderange> [B<-r>|B<--routename> I<r1>[I<,r2...>]]
B<makeroutes> I<noderange> B<-d>|B<--delete> [B<-r>|B<--routenames> I<r1>[I<,r2...>]]
B<makeroutes> [B<-h> B<--help>|B<-v>|B<--version>]
=head1 DESCRIPTION
The B<makeroutes> command adds or deletes routes on the management node or any given nodes. The B<noderange> specifies the nodes where the routes are to be added or removed. When the I<noderange> is omitted, the action will be done on the management node. The B<-r> option specifies the name of routes. The details of the routes are defined in the B<routes> table which contians the route name, subnet, net mask and gateway. If -r option is omitted, the names of the routes found on B<noderes.routenames> for the nodes or on B<site.mnroutenames> for the management node will be used.
If you want the routes be automatically setup during node deployment, first put a list of route names to B<noderes.routenames> and then add I<setroute> script name to the B<postscripts.postbootscripts> for the nodes.
=head1 Parameters
I<noderange> specifies the nodes where the routes are to be added or removed. If omitted, the operation will be done on the management node.
=head1 OPTIONS
=over 10
=item B<-d|--delete>
Specifies to delete the given routes. If not specified, the action is to add routes.
=item B<-r|--routename>
Specifies a list of comma separated route names defined in the B<routes> table. If omitted, all routes defined in B<noderes.routenames> for nodes or B<site.mnroutenames> for the management node will be used.
=item B<-h|--help>
Display usage message.
=item B<-v|--version>
Command Version.
=back
=head1 EXAMPLES
=over 3
=item 1.
To add all routes from the B<site.mnroutenames> to the os route table for the management node.
makeroutes
=item 2.
To add all the routes from B<noderes.routenames> to the os route table for node1.
makeroutes node1
=item 3.
To add route rr1 and rr2 to the os route table for the management node.
makeroutes -r rr1,rr2
=item 4.
To delete route rr1 and rr2 from the os route table on node1 and node1.
makeroutes node1,node2 -d -r rr1,rr2
=back
=head1 FILES
/opt/xcat/sbin/makeroutes
=head1 SEE ALSO