130b86f0e0
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@4304 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
65 lines
1.4 KiB
Plaintext
65 lines
1.4 KiB
Plaintext
=head1 NAME
|
|
|
|
B<groupfiles4dsh> - Builds a directory of files for each defined nodegroup in xCAT.
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
B<groupfiles4dsh> [{B<-p>|B<--path>} I<path>]
|
|
|
|
B<groupfiles4dsh> [B<-h>|B<--help>] [B<-v>|B<--version>]
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
This tool will build a directory of files, one for each defined
|
|
nodegroup in xCAT. The file will be named the nodegroup name and
|
|
contain a list of nodes that belong to the nodegroup.
|
|
The file can be used as input to the AIX dsh command.
|
|
The purpose of this tool is to allow backward compatiblity with scripts
|
|
that were created using the AIX or CSM dsh command
|
|
|
|
Reference: man dsh.
|
|
|
|
=head1 OPTIONS
|
|
|
|
|
|
B<-h> Display usage message.
|
|
|
|
B<-v> Command Version.
|
|
|
|
B<-p> Path to the directory to create the nodegroup files (must exist).
|
|
|
|
|
|
=head1 RETURN VALUE
|
|
|
|
0 The command completed successfully.
|
|
|
|
1 An error has occurred.
|
|
|
|
=head1 EXAMPLES
|
|
|
|
1. To create the nodegroup files in directory /tmp/nodegroupfiles, enter:
|
|
|
|
B<groupfiles4dsh -p /tmp/nodegroupfiles>
|
|
|
|
To use with dsh:
|
|
|
|
export DSH_CONTEXT=DSH ( default unless CSM is installed)
|
|
export DSH_NODE_RSH=/bin/ssh (default is rsh)
|
|
export DSH_NODEGROUP_PATH= /tmp/nodegroupfiles
|
|
|
|
dsh -N all date (where all is a group defined in xCAT)
|
|
dsh -a date (will look in all nodegroupfiles and build a list of all nodes)
|
|
|
|
=head1 FILES
|
|
|
|
/opt/xcat/share/xcat/tools/groupfiles4dsh
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<xdsh(1)|xdsh.1>
|
|
|
|
|
|
|
|
|