CGET
Section: C3 User Manual (1)
Updated: 4.0
Index
Return to Main Contents
NAME
cget - A utility that retrieves a specified file from each node of a cluster and places it into the specified target directory.
SYNOPSIS
Usage: cget [OPTIONS] [MACHINE DEFINITIONS] source [target]
DESCRIPTION
cget is a utility that retrieves the given file from each node and places them in the the specified directory. Since all files will originally have the same name, an underscore and the cluster name, another underscore, and the node's IP or hostname is appended to each filename. Note that cget ignores subdirectories and links.
OPTIONS
- --help -h
-
:display help message
- --file -f <filename>
-
:alternate cluster configuration file if one is not supplied then /etc/c3.conf will be used
- -i
-
:interactive mode, ask once before executing
- --head
-
:execute command on head node does not execute on compute nodes if specified
- --all
-
:execute command on all nodes in all clusters that are accessible. When specifying --head only the head nodes will participate. This ignores the [MACHINE_DEFINITIONS] section.
GENERAL
There are several ways to call cget:
1. To retrieve a file from the default cluster:
-
cget /tmp/file1
when a target directory is not specified as above then the file is retrieved to the current directory
2. To retrieve a file from a subset of nodes on the default cluster
-
cget :2-6 /tmp/output /home/user1/data/
this retrieves /tmp/output on nodes 2, 3, 4, 5, 6 and places them in /home/user1/data on the local machine
3. To retrieve a file from a list of clusters
-
cget cluster1: cluster2: /tmp/output
this will retrieve the same file from each cluster and store it in the current directory.
SETUP
See the C3 INSTALL file for installation instructions. Also see C3-range for help on node ranges on the command line. If using the scalable setup please see c3-scale
ENVIRONMENT
C3_RSH
-
By default, the C3 tools will use ssh to issue the remote commands. If you would like to have them use rsh instead, you must set the C3_RSH environment variable to rsh.
-
For example, if you are using the bash shell you would do the following:
export C3_RSH=rsh
any program that behaves like rsh or ssh is acceptable
C3_PATH
-
The default install path for C3 is /opt/c3-4. If you install C3 in an alternate location this variable must point to that installation. For remote clusters C3 must be installed in the same directory on each cluster.
-
For example, if you installed C3 in your home directory you might use the following:
export C3_PATH=/home/sgrundy/c3-4
C3_CONF
-
C3's default configuration file is /etc/c3.conf. If you wish an alternate default configuration file set this to point to the file
-
For example, if you keep a special c3.conf file in your home directory you may use:
export C3_CONF=/home/sgrundy/.c3conf
C3_USER
-
By default, the C3 tools will use your local username to access a remote cluster. If you wish to use a different default then set this variable to it
-
For example, this will change the example user from sgrundy to mmanhunter:
export C3_USER=mmanhunter
FILES
/etc/c3.conf
-
This file is the cluster configuration file that contains the names of the nodes to which commands will be sent. The cluster configuration file may also be specified from the command line. The format of both files is identical.
-
see the c3.conf man page for format
SEE ALSO
cexec(1), c3(1), cget(1), ckill(1), cpush(1
), cpushimage(4), crm(1), cshutdown(4), cname(1), cnum(1), clist(1), c3.conf(5), c3-scale(5)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- GENERAL
-
- SETUP
-
- ENVIRONMENT
-
- FILES
-
- SEE ALSO
-
Last Modified: