Generates and sends update packets
Product | Command type |
---|---|
MultiSite | MultiSite command |
Platform |
---|
UNIX |
Windows |
Generate update packets:
Process shipping orders in the host's storage bays:
Print help on command options:
On UNIX, sync_export_list is located in ccase-home-dir/config/scheduler/tasks. On Windows, sync_export_list is located in ccase-home-dir\config\scheduler\tasks.
sync_export_list generates update packets for one or more VOB replicas. You can specify options for packet generation and transport on the command line, in a script file, or by using a combination of the command line and a script file.
You can run sync_export_list manually, or run it automatically with the schedule command. For more information, see the schedule reference page in the Command Reference.
By default, synchronization exports fail if the VOB is locked. To allow sync_export_list to retry an export when it encounters a lock, use the -lockwait option, which specifies the amount of time (in minutes) for sync_export_list to keep trying to write to the VOB. During that time, sync_export_list retries the write operation every minute. If the time elapses and the VOB is still locked, sync_export_list exits with an error.
The -lockwait option sets the CLEARCASE_VOBLOCKWAIT environment variable in the script's environment. If -lockwait is not used, sync_export_list ignores CLEARCASE_VOBLOCKWAIT if it is set outside the script's environment.
NOTE: sync_export_list waits only if it detects the lock before it starts processing oplogs. If an administrator locks the VOB during oplog processing, sync_export_list exits with an error.
You can modify the behavior of the sync_export_list 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 export setting:
sync_export_list fails if there is another sync_export_list process exporting data from the same replica, unless export locking is disabled (see CONFIGURATION FILE). This failure prevents interference among export processes. To allow an invocation of sync_export_list to retry an export, use the -iterate and -wait options.
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_export_list.
sync_export_list creates a log file during execution. This log file is deleted unless sync_export_list fails or you use -trace or set TRACE_SUBSYS.
By default, the log files are stored in the /var/adm/atria/log/sync_logs directory on UNIX and the ccase-home-dir\var\log directory on Windows. The name of a log file includes the process ID of the sync_export_list command and the time (in UTC format) 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)
With -poll, you must have write and execute permissions on the directory containing the shipping orders, and on UNIX, you must own the shipping order files or be root.
Locks: An error occurs if one or more of these objects are locked: VOB.
Mastership: No mastership restrictions.
0 | (default) Prints errors, warnings, and informational messages |
1 | Prints errors and warnings |
2 | Suppresses all messages |
500k | 500 kilobytes |
20m | 20 megabytes |
1.5g | 1.5 gigabytes |
replica-name@VOB-tag | Generates a packet for a replica |
replica-name@VOB-tag,replica-name,replica-name,... | Generates packets for two or more replicas in a VOB family |
VOB-tag | Generates update packets for all sibling replicas in a VOB family |
compress | Compresses or does not compress packet. |
fship | Ships packets immediately. |
ship | Stores packets in shipping bay. |
maxsize:max-packet-size | Sets maximum packet size. |
sclass:storage-class | Sets a different storage class. To unset the storage class, do not specify a storage-class value. |
update | Controls whether epoch table is updated before export. |
limit:num-packets | Sets maximum number of packets to generate per replica. |
lockwait:minutes | Number of minutes to wait for VOB locks. |
replicas:replica-list | Exports packets from specified replicas. Specify replica-list as described in the -replicas option. |
|
|
|
|
|
Send update packets from all replicas on the host to all their siblings.
/usr/atria/config/scheduler/tasks/sync_export_list -all
SUCCESSFUL COMPLETION: log file removed.
Generate update packets for replicas in the VOB family /vobs/dev. Store the packets in the shipping bay, limit the size of the packets to 500KB, and display messages during processing.
/usr/atria/config/scheduler/tasks/sync_export_list -ship -maxsize 500k -trace \
-replicas /vobs/dev
command options specified or defaulted:
compress: 0
logdir:
storage-class:
workdir:
maxpacket: 500k
limit: 0
all: 0
fship: 0
ship: 1
poll: 0
lockwait: 0 minutes
retries: 1 times, wait 30 seconds
script:
CMD: bin/cleartool lsvob /vobs/dev > /dev/null
vob: /vobs/dev
replicas: bangalore buenosaires
CMD: bin/multitool syncreplica -export -maxsize 500k -ship
replica:bangalore@/vobs/dev >&2
CMD: bin/multitool syncreplica -export -maxsize 500k -ship
replica:buenosaires@/vobs/dev >&2
SUCCESSFUL COMPLETION: see log file at:
"/var/adm/atria/log/sync_logs/send-000815-183301Z-6043_log".
Create a script file for the VOB families \tests and \dev. Create a job that runs sync_export_list every night at 1:00 A.M.
compress
fship
sclass:tests
noupdate
replicas:sanfran_hub@\tests,sydney
sclass:dev
update
replicas:\dev
Job.Begin
Job.Id: 25
Job.Name: "Sync Export tests dev"
Job.Description.Begin:
Every midnight, export update packets to replicas in VOB families \tests
and \dev.
Job.Description.End:
Job.Schedule.Daily.Frequency: 1
Job.Schedule.FirstStartTime: 01:00:00
Job.DeleteWhenCompleted: FALSE
Job.Task: 13
Job.Args: -quiet 1 \\shinjuku\scripts\sync_export_tests_dev
Job.End
/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_receive, syncreplica
Feedback on the documentation in this site? We welcome any comments!
Copyright © 2001 by Rational Software Corporation. All rights reserved. |