Administrator's Guide for Rational ClearCase MultiSite, Release 2002.05.00, All Platforms

Administrator's Guide for Rational ClearCase MultiSite, Release 2002.05.00, All Platforms

1. Introduction to MultiSite 1.1 VOBs and VOB Replicas Replica Names, Replica Objects, and Host Assignments Differences Among Sites Element Ownership and Ownership Preservation Requirements for Ownership-Preserving Replicas Synchronizing Replicas in a VOB Family MultiSite, Time, and Time Zones 1.2 Enabling Independent VOB Development: Mastership Replica Mastership Branch Mastership Creation of the main Branch of an Element Synchronizing Development on Different Branches Default and Explicit Branch Mastership Type Object Mastership Mastership Restrictions 1.3 Supporting Serial Development in Replicas 1.4 Conflict Resolution Resolving Conflicts Among Type Objects 1.5 VOB Objects and Replica Objects 1.6 VOB Operations and the Oplog Tracking Operations for Each Replica Epoch Numbers Optimization and the Epoch Number Matrix Indirect Synchronization
2. Planning a MultiSite Implementation 2.1 MultiSite Installation 2.2 MultiSite Licensing 2.3 ClearCase Use Model Branching and Mastership Use of Metadata Text Mode for Replicas Use of Administrative VOBs or UCM 2.4 MultiSite Use Model Type of Administration Mastership Strategy Replica Permission Strategy Synchronization Method Synchronization Pattern Directions of Exchange One-to-One and Ring Synchronization One-to-Many Synchronization Many-to-Many Synchronization Synchronization Schedule Use of MultiSite for Backups Scrubbing Parameters for VOB Replicas Oplog Scrubbing export_sync Scrubbing 2.5 Responsibilities of MultiSite Administrators
3. MultiSite Command Set 3.1 Location of MultiSite Programs 3.2 multitool Use multitool Subcommands Commands Copied from ClearCase Replica Creation, Synchronization, and Management Object Mastership Failure Recovery 3.3 View Contexts and VOB Mounts 3.4 Specifying VOBs and Replicas in Commands 3.5 Additional MultiSite Commands 3.6 ClearCase Commands Related to MultiSite
4. Creating Replicas 4.1 Overview of Replica Creation 4.2 Timing of Replica Creation 4.3 Notes on Different Transport Methods Store-and-Forward Method Communication Between Replica Hosts Limiting the Size of a Packet Transport Options Notes on Using Tape or a File-Based Transfer Method 4.4 Replica-Creation Scenario Planning the Rules of the Road Prerequisites Export Phase Transport Phase Import Phase 4.5 Replicating a VOB Between UNIX and Windows
5. ClearCase Feature Levels 5.1 Overview of Feature Levels 5.2 Raising the Replica Feature Level 5.3 Raising the VOB Family Feature Level VOB Families with Bidirectional Synchronization VOB Families with Unidirectional Synchronization 5.4 Displaying Feature Levels 5.5 Feature Levels Error Message
6. Synchronizing Replicas 6.1 Synchronization Patterns Designing an Update Strategy 6.2 Assumption of Successful Synchronization 6.3 Transferring Packets with Store-and-Forward Packet Storage During the Export and Import Phases Packet Transport Configuring the Store-and-Forward Facility Submitting Packets to Store-and-Forward Sending Files That Are Not Packets Setting Up an Indirect Shipping Route Retries, Expirations, and Returned Data Error Notification in a Mixed Environment Differentiating Packets with Storage Classes 6.4 Using MultiSite through a Firewall Using Electronic Mail Using FTP Using Custom Software Installing Store-and-Forward on a UNIX Firewall Host Firewall Issues Installing shipping_server on a Firewall Controlling Ports Used by albd_server and shipping_server Guidelines for Setting Port Values Specifying Port Values 6.5 Manual Synchronization Export Phase Transport Phase Import Phase 6.6 Automated Synchronization Using the ClearCase Scheduler Export Phase Transport Phase Import Phase Defining Receipt Handlers Scheduling Import Jobs 6.7 Listing Synchronization History 6.8 Synchronizing More Efficiently Example of Increased Efficiency Example of Decreased Efficiency
7. Managing Replicas 7.1 Displaying Properties of a Replica 7.2 Listing the Synchronization History of a Replica 7.3 Changing the Host Name for a Replica 7.4 Changing Ownership Preservation 7.5 Setting the Connectivity Property 7.6 Renaming a Replica 7.7 Moving a Replica 7.8 Changing Mastership of a Replica 7.9 Deleting a Replica
8. Managing Mastership 8.1 Listing an Object's Master Replica 8.2 Listing Objects Mastered by a Replica 8.3 Listing the History of Mastership Changes for an Object 8.4 Displaying Mastership Request Settings 8.5 Assigning Branch Mastership During Element Creation 8.6 Changing Mastership Transferring Mastership of a Type Object Transferring Mastership of a Replica Object Transferring Mastership of a VOB Transferring Mastership of an Element Transferring Mastership of a Branch Transferring Branch Mastership Removing Explicit Mastership of a Branch Transferring Mastership of a Stream Transferring Mastership of All Objects Mastered by a Replica Fixing an Accidental Mastership Change 8.7 Working with Type Objects Creating a Shared Type Object Listing Whether a Type Object Is Shared or Unshared Converting an Unshared Type Object to a Shared Type Object
9. Implementing Requests for Mastership 9.1 Overview of a Request for Mastership 9.2 Requirements and Recommendations 9.3 Planning Your Implementation To Hide Request for Mastership Features 9.4 Enabling Requests for Mastership Prerequisites Adding Developers to the Access Control List Deny Requests for Specific Objects Enable Requests at the Replica Level 9.5 Customizing Synchronization Updates for Mastership Requests 9.6 Displaying Mastership Request Settings 9.7 Troubleshooting Troubleshooting Commands Status Messages 9.8 Serial Development Scenario Planning the Implementation Setting Up Access Controls Writing Config Specs Boston San Francisco Tokyo Requesting Mastership Serial Development of a File That Cannot Be Merged Serial Development of a File That Can Be Merged
10. Troubleshooting MultiSite Operations 10.1 Troubleshooting Tips 10.2 Replica-Creation Problems Export Phase Import Phase Conflict in VOB Object Registry Conflict in VOB-Tag Registry 10.3 Synchronization Export Problems Cannot Find Oplog Sites Have IP Connection Sites Do Not Have IP Connection Oplog Gap Detected During Creation of Update Packet Export Failure During Version Construction Packets Accumulate in Outgoing Storage Bay Replica Cannot Update Itself 10.4 Transport Problems Error Messages Invalid Destination Delivery Fails Shipping Server Fails to Start or Connection Is Refused Shipping Order Expires 10.5 Synchronization Import Problems Packets Accumulate in Incoming Storage Bay Packet is Not Applicable to Any Local VOB Replicas Read from Input Stream Fails Element Changes During Operation rmreplica Operation Cannot be Imported Replica Incarnation is Old Miscellaneous Problems Recovering from Lost Packets Lost Replica-Creation Packet Lost Update Packet Inconsistent Changes to Replica Ownership Preservation Object Mastership Automatic Renaming of Type Objects and Replica Objects 10.6 Running epoch_watchdog 10.7 Restoring and Replacing Replicas Restoring a Replica from Backup Replacing an Existing Replica Saving Views from the Replaced Replica 10.8 Cleaning Up from Accidental Deletion of a Replica
11. Backing Up VOBs with MultiSite 11.1 Using a Backup Replica Handling Objects That Are Not Replicated Designing Synchronization Strategy 11.2 Using Replicas with Incremental Backup 11.3 Restoring a Replica from Backup
12. Using MultiSite for Interoperability 12.1 Advantages and Disadvantages 12.2 Restrictions on Multiple Replicas in a LAN 12.3 Setting Up Multiple Replicas at One Site
13. MultiSite Reference Pages apropos APPLICABILITY SYNOPSIS DESCRIPTION RESTRICTIONS OPTIONS AND ARGUMENTS EXAMPLES FILES SEE ALSO chepoch APPLICABILITY SYNOPSIS DESCRIPTION RESTRICTIONS OPTIONS AND ARGUMENTS EXAMPLES SEE ALSO chmaster APPLICABILITY SYNOPSIS DESCRIPTION SPECIFYING A VIEW CONTEXT RESTRICTIONS OPTIONS AND ARGUMENTS EXAMPLES SEE ALSO chreplica APPLICABILITY SYNOPSIS DESCRIPTION RESTRICTIONS OPTIONS AND ARGUMENTS EXAMPLES SEE ALSO epoch_watchdog APPLICABILITY SYNOPSIS DESCRIPTION RESTRICTIONS OPTIONS AND ARGUMENTS EXAMPLES FILES SEE ALSO lsepoch APPLICABILITY SYNOPSIS DESCRIPTION RESTRICTIONS OPTIONS AND ARGUMENTS EXAMPLES SEE ALSO lsmaster APPLICABILITY SYNOPSIS DESCRIPTION Object Name Resolution RESTRICTIONS OPTIONS AND ARGUMENTS EXAMPLES SEE ALSO lspacket APPLICABILITY SYNOPSIS DESCRIPTION RESTRICTIONS OPTIONS AND ARGUMENTS EXAMPLES SEE ALSO lsreplica APPLICABILITY SYNOPSIS DESCRIPTION RESTRICTIONS OPTIONS AND ARGUMENTS EXAMPLES SEE ALSO mkorder APPLICABILITY SYNOPSIS DESCRIPTION RESTRICTIONS OPTIONS AND ARGUMENTS EXAMPLES FILES SEE ALSO mkreplica APPLICABILITY SYNOPSIS DESCRIPTION OWNERSHIP PRESERVATION REPLICA-CREATION PACKETS Cleaning Up Used Packets REPLICATION OF VOBS LINKED TO ADMINISTRATIVE VOBS RESTRICTIONS OPTIONS AND ARGUMENTS - EXPORT PHASE OPTIONS AND ARGUMENTS - IMPORT PHASE EXAMPLES Exports Imports SEE ALSO MultiSite Control Panel APPLICABILITY SYNOPSIS DESCRIPTION MAXIMUM PACKET SIZE ADMINISTRATOR E-MAIL STORAGE CLASSES Storage Class Name Packet Expiration Storage Bay Path Return Bay Path Receipt Handler Path ROUTING INFORMATION Next Routing Hop Destination Host Names multitool APPLICABILITY SYNOPSIS DESCRIPTION USING INTERACTIVE MODE AND STATUS MODE SPECIFYING OBJECTS WITH OBJECT SELECTORS Object Names EVENT RECORDS AND COMMENTS Specifying Comments Interactively Customizing Comment Handling recoverpacket APPLICABILITY SYNOPSIS DESCRIPTION Resetting Epoch Numbers Automatically Resetting Epoch Numbers Manually RESTRICTIONS OPTIONS AND ARGUMENTS EXAMPLES SEE ALSO reqmaster APPLICABILITY SYNOPSIS DESCRIPTION SETTING ACCESS CONTROLS REQUESTING MASTERSHIP OF A BRANCH OR BRANCH TYPE TROUBLESHOOTING RESTRICTIONS Setting Access Controls Requesting Mastership of a Branch: Requesting Mastership of a Branch Type: OPTIONS AND ARGUMENTS EXAMPLES SEE ALSO restorereplica APPLICABILITY SYNOPSIS DESCRIPTION LOCKING OF THE REPLICA OPTIMIZING THE RESTORATION PROCESS RESTRICTIONS OPTIONS AND ARGUMENTS EXAMPLES SEE ALSO rmreplica APPLICABILITY SYNOPSIS DESCRIPTION RESTRICTIONS OPTIONS AND ARGUMENTS EXAMPLES SEE ALSO shipping.conf APPLICABILITY SYNOPSIS DESCRIPTION PACKET SIZE NOTIFICATION ADMINISTRATOR ADDRESS STORAGE BAY AND RETURN BAY EXPIRATION PERIOD PACKET ROUTING RECEIPT HANDLER PORT NUMBERS shipping_server APPLICABILITY SYNOPSIS DESCRIPTION TCP/IP Connection Colon Characters in Packet Names Handling of File Name Conflicts Log File RESTRICTIONS OPTIONS AND ARGUMENTS EXAMPLES SEE ALSO sync_export_list APPLICABILITY SYNOPSIS DESCRIPTION RETRYING SYNCHRONIZATION WHEN THE VOB IS LOCKED CONFIGURATION FILE TROUBLESHOOTING RESTRICTIONS OPTIONS AND ARGUMENTS EXAMPLES FILES UNIX Windows SEE ALSO sync_receive APPLICABILITY SYNOPSIS DESCRIPTION RETRYING SYNCHRONIZATION WHEN THE VOB IS LOCKED CONFIGURATION FILE TROUBLESHOOTING RESTRICTIONS OPTIONS AND ARGUMENTS EXAMPLES FILES UNIX Windows SEE ALSO syncreplica APPLICABILITY SYNOPSIS DESCRIPTION NOTES ON THE EXPORT PHASE Specifying a Directory for Temporary Files NOTES ON THE IMPORT PHASE Specifying a Directory for Temporary Files Skipping Packets Update Failures / Replaying Packets Deletion of Update Packets Ownership Preservation Storage Pools Trigger Firing Handling Naming Conflicts Delayed View Updates RETRYING SYNCHRONIZATION WHEN THE VOB IS LOCKED RESTRICTIONS OPTIONS AND ARGUMENTS - EXPORT PHASE OPTIONS AND ARGUMENTS - IMPORT PHASE EXAMPLES Exports Imports SEE ALSO

ClearCase Documentation