crcp [-a] [-t] [-m | -v] source_path target_path
crcp [-s] [-t] [-o] [-i seconds] source_path target_path
Remotely copies files using AIP.
crcp is an AIP-enabled remote copy program that transfers a single file or directory tree between hosts in an AIP cluster. crcp uses CBEXE on an AIP host to transfer files. If AIP is not installed on a host or if CBEXE is not running then crcp uses rcp to copy the file.
To use crcp, you must have read access to the file being copied.
Both the source and target file must be owned by the user who issues the command.
crcp uses rcp to copy a source file to a target file owned by another user. See rcp(1) and LIMITATIONS below for details.
% crcp myfile @hostC:/home/usr/dir1/otherfile
Copies file myfile from the local host to file otherfile on hostC.
% crcp user1@hostA:/home/myfile user1@hostB:otherfile
Copies the file myfile from hostA to file otherfile on hostB.
% crcp -a user1@hostD:/home/myfile /dir1/otherfile
Appends the file myfile on hostD to the file otherfile on the local host.
% crcp /tmp/myfile user1@hostF:~/otherfile
Copies the file myfile from the local host to file otherfile on hostF in user1's home directory.
% crcp -s /tmp/myfile hostB:/home/usr/myfile
Copies the file myfile from the local host to file myfile on hostB in streaming mode. The command does not stop until entering CTRL-C.
% crcp -t /tmp/mydir hostB:/home/usr/mydir
Copies the files and directory tree mydir from the local host to directory mydir on hostB.
% crcp -t -s /tmp/mydir hostB:/home/usr/mydir
Copies the files and directory tree mydir from the local host to directory mydir on hostB in streaming mode. The command does not stop until entering CTRL-C.
crcp attempts to copy source_path to target_path using CBEXE. If CBEXE is down or fails to copy the source_path, crcp will use either rsh when the -a option is specified, or rcp when -a is not specified.
File transfer using lscrp is not supported in the following contexts:
- If AIP account mapping is used; crcp fails when running under a different user account
- On AIP client hosts. AIP client hosts do not run CBEXE, so crcp cannot contact CBEXE on the submission host
- Third party copies. crcp does not support third party copies, when neither source nor target file are on the local host. In such a case rcp or rsh will be used. If the target_path exists, crcp preserves the modes; otherwise, crcp uses the source_path modes modified with the umask (see umask(2)) of the source host.
You can do the following:
If crcp cannot contact CBEXE on the submission host, it attempts to use rcp to copy the file. You must set up the /etc/hosts.equiv or HOME/.rhosts file in order to use rcp. See the rcp(1) and rsh(1) manual pages for more information on using the rcp command.
You can replace crcp with your own file transfer mechanism as long as it supports the same syntax as crcp. This might be done to take advantage of a faster interconnection network, or to overcome limitations with the existing crcp. CBJM looks for the crcp executable in the CB_BINDIR directory as specified in the cb.yaml file.