Manual Synchronization


This section describes how to synchronize replicas by entering explicit syncreplica commands.

Export Phase

  1. Create an update packet at the sending host. Use the syncreplica –export command with the appropriate transport option.
  2. If your sites are connected electronically, you can use store-and-forward to send the packet (–fship) or place it in a storage bay (–ship).

    The following example uses the –fship option to send the packet immediately:

    multitool syncreplica –export –maxsize 1m –fship boston_hub@\dev 
    Generating synchronization packet C:\Program 
    Files\Rational\ClearCase\var
    \shipping\ms_ship\outgoing\sync_bangalore_30-Oct-02.14.35.49_2468_1
     - shipping order file is C:\Program 
    Files\Rational\ClearCase\var\shipping
    \ms_ship\outgoing\sh_o_sync_bangalore_30-Oct-02.14.35.49_2468_1
    Attempting to forward/deliver generated packets...
     -- Forwarded/delivered packet C:\Program 
    Files\Rational\ClearCase\var
    \shipping\ms_ship\outgoing\sync_bangalore_30-Oct-02.14.35.49_2468_1

    The following example uses the –out option to save the packet as an output file and includes the –maxsize option to divide the logical packet into appropriately sized physical packets. The packet files can then be sent by electronic mail or copied onto diskettes, CDs, or tape.

    multitool syncreplica –export –maxsize 1m –out c:\packets\update1 
    boston_hub@\dev 
    Generating synchronization packet c:\packets\update1 

Transport Phase

If you did not use the –fship option, send the packets:

Import Phase

  1. (If you used diskettes, CDs, tape, or electronic mail) Copy the packet files into a directory on the receiving replica’s host.
  2. Use the lspacket command to verify that the packet has arrived.
  3. multitool lspacket 
    Packet is: 
    /opt/rational/clearcase/shipping/ms_ship/incoming/sync_bangalore_30
    -Oct-02.14.35.49_2468_1
    Packet type: Update
    VOB family identifier is: 12a3456b.78c901d2.e3ab.45:67:89:c0:1d:e2
    Comment supplied at packet creation is: 
    Packet intended for the following targets:
    boston_hub 
    The packet sequence number is 1
  4. Apply the packet at the receiving replica. Use the syncreplica –import command to apply the changes in the packet to the replica.
  5. This example specifies the –receive option; syncreplica imports any packets it finds in the incoming shipping directories.

    multitool syncreplica –import –receive 
    Applied sync. packet 
    /opt/rational/clearcase/shipping/ms_ship/incoming/sync_bangalore_30
    -Oct-02.14.35.49_2468_1 to VOB /net/minuteman/vobstg/dev.vbs

    This example specifies a directory pathname as an argument. syncreplica –import looks in this directory for update packets and applies them to the replica on the host.

    multitool syncreplica –import c:\msite\packets 
    Applied sync. packet c:\msite\packets\update1 to VOB 
    \\servo\vobs\dev.vbs