Product | Command type |
---|---|
MultiSite | MultiSite command |
Platform |
---|
UNIX |
Windows |
Import update packets:
Print help on command options:
On UNIX, sync_receive is located in ccase-home-dir/config/scheduler/tasks. On Windows, sync_receive is located in ccase-home-dir\config\scheduler\tasks.
sync_receive imports update packets in the local host's incoming storage bays. You can run sync_receive from the command line, or run it with the schedule command (see the schedule reference page in the Command Reference). For information about using sync_receive as a receipt handler, see the shipping.conf and MultiSite Control Panel reference pages.
If files in the incoming shipping bays have names ending with .gz
, sync_receive uncompresses the files, determines whether they are packets, and then imports the packets.
By default, synchronization imports fail if the VOB is locked. To allow sync_receive to retry an import when it encounters a lock, use the -lockwait option, which specifies the amount of time (in minutes) for sync_receive to keep trying to write to the VOB. During that time, sync_receive retries the write operation every minute. If the time elapses and the VOB is still locked, sync_receive exits with an error.
The -lockwait option sets the CLEARCASE_VOBLOCKWAIT environment variable in the script's environment. If -lockwait is not used, sync_receive ignores CLEARCASE_VOBLOCKWAIT if it is set outside the script's environment.
NOTE: sync_receive waits only if it detects the lock before it starts processing oplogs. If an administrator locks the VOB during oplog processing, sync_receive exits with an error.
You can modify the behavior of the sync_receive script by creating a file named MSimport_export.conf and setting values in it. On UNIX, create the file in the directory /var/adm/atria/config. On Windows, create the file in the directory ccase-home-dir\var\config.
The file can include the following import settings:
0
(default) enables use of the lockfile.To display informational messages, specify the -trace option on the command line.
To display all debugging print statements, set the TRACE_SUBSYS environment variable to the value sync_receive.
sync_receive creates a log file during execution. This log file is deleted unless sync_receive fails or you use -trace or TRACE_SUBSYS.
By default, the log files are stored in the /var/adm/atria/log/sync_logs directory (UNIX) or the ccase-home-dir\var\log directory (Windows). The name of a log file is based on the process ID of the sync_export_list command and the time at which you ran the command.
On UNIX, the Weekly Log Scrubbing job installed with ClearCase deletes send* and recv* log files in /var/adm/atria/log/sync_logs that are more than 14 days old.
Identities: You must have one of the following identities:
VOB owner
root (UNIX)
Member of the ClearCase administrators group (Windows)
Locks: An error occurs if one or more of these objects are locked: VOB.
Mastership: No mastership restrictions.
-vob /vobs/dev |
(apply packets to /vobs/dev and any VOB whose tag contains `/vobs/dev') |
-vob dev |
(apply packets to any VOB whose tag contains the string `dev') |
0 | (default when sync_receive is used on the command line) Prints errors, warnings, and informational messages |
1 | (default when sync_receive is used as a receipt handler) Prints errors and warnings |
2 | Suppresses all messages |
When sync_receive is invoked as a receipt handler, the following parameters are passed in automatically. You can use -sclass, -data, and -actual from the command line.
Import packets in the incoming storage bays for the daily storage class.
/usr/atria/config/scheduler/tasks/sync_receive -sclass daily
Import a specific packet and apply it to all VOBs whose tags include the pattern lib. The lines are broken for readability. You must enter the command on a single physical line.
"c:\Program Files\Rational\ClearCase\config\scheduler\tasks\sync_receive.bat" -vob lib -d
"c:\Program Files\Rational\ClearCase\var\shipping\daily\incoming\sync_orig_09-Dec-98.18.17.54_6587_1"
On UNIX, specify sync_receive as the receipt handler for the daily storage class.
cp /usr/atria/config/scheduler/tasks/sync_receive* /var/adm/atria/scheduler/tasks
Edit the shipping.conf file and add a receipt handler entry:
RECEIPT-HANDLER daily /var/adm/atria/scheduler/tasks/sync_receive
On Windows, specify sync_receive as the receipt handler for the daily storage class.
Copy the script into a directory outside the ClearCase installation area. For example:
copy "c:\Program Files\Rational\ClearCase\config\scheduler\tasks\sync_receive.bat" c:\scripts
Edit the script as appropriate.
In the MultiSite Control Panel, select the daily class in the Storage Class list.
Click Modify Class.
In the Receipt Handler Path box, enter the path to the script. For example:
c:\scripts\sync_receive.bat
Click OK.
/var/adm/atria/log/sync_logs
/var/adm/atria/config/shipping.conf
ccase-home-dir/config/scheduler/multisite.schedule
mkorder, MultiSite Control Panel, shipping.conf, shipping_server, sync_export_list, syncreplica
Feedback on the documentation in this site? We welcome any comments!
Copyright © 2001 by Rational Software Corporation. All rights reserved. |