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

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

1. Understanding the ClearCase Network 1.1 Network Overview 1.2 ClearCase Hosts 1.3 ClearCase Data Storage Versioned Object Bases (VOBs) Views 1.4 ClearCase Users 1.5 The ClearCase Registry Objects and Tags Registry Regions Server Storage Locations 1.6 ClearCase Server Processes albd_server Port Assignment admin_server view_server vob_server db_server vobrpc_server lockmgr Server Error Logs Error Logging on UNIX Error Logging on Windows 1.7 ClearCase Client/Server Processing 1.8 ClearCase Startup and Shutdown On UNIX On Windows
2. Administering ClearCase Hosts 2.1 ClearCase Administration Console Controlling Remote Administration 2.2 Using DHCP with ClearCase 2.3 ClearCase Data and Non-ClearCase Hosts 2.4 Using Non-ClearCase Access on UNIX Hosts Restrictions on Use Using automount with Non-ClearCase Access Problems with Non-ClearCase Access: NFS Client Caching Problems with Non-ClearCase Access: NFS Locking 2.5 Support for Multiple Network Interfaces on UNIX Hosts 2.6 Using automount with ClearCase on UNIX Automounter Maps Using the -hosts Map Not Using the -hosts Map Specifying a Nonstandard Mount Directory 2.7 Administering Networkwide Release Areas Changing the Location of the Release Area Renaming a Release Area Host
3. Understanding ClearCase Access Controls 3.1 Fundamentals of ClearCase Access Control Users and Groups Privileged Users and Groups Restricted Privileges for Remote root User Processes ClearCase Objects Access to ClearCase Data 3.2 Access Control for VOBs and VOB Objects Access Control for VOBs Permission to Create VOBs Permission to Delete VOBs Permission to Read VOBs Permission to Write VOBs Permission to Execute VOBs Access Control for Elements Permission to Create Elements Permission to Delete Elements Permission to Read Elements Permission to Write Elements Permission to Execute Elements Access Control for Other VOB Objects Permission to Create Other VOB Objects Permission to Delete Other VOB Objects Permission to Read Other VOB Objects Permission to Write Other VOB Objects Locks on VOB Objects Locking Type Objects 3.3 Access Control for Views and View Objects Access Control for Dynamic Views Permission to Create Views Permission to Delete Views Permission to Read Views Permission to Write Views Permission to Execute Views Access Control for View-Private Files Initial Owner, Group, and Protection Mode on UNIX Initial Owner, Group, and Protection Mode on Windows Permission to Create View-Private Files Permission to Delete View-Private Files Permission to Read View-Private Files Permission to Write View-Private Files Permission to Execute View-Private Files Access Control for Derived Objects 3.4 ClearCase and Native File-System Permissions
4. ClearCase and Windows Domains 4.1 Domain Configurations Compatible with ClearCase What ClearCase Requires from Any Domain ClearCase on Nondomain Hosts 4.2 Domain User and Group Accounts Setting the ClearCase Primary Group Defining the Accounts Manually 4.3 Multiple User Account Domain Support Using Active Directory Universal Groups Using Proxy Groups and Domain Mapping in Windows NT Domains Setting VOB Element Permissions Setting VOB Storage ACLs 4.4 Conversion to Active Directory Understanding Active Directory How Active Directory Affects ClearCase Planning Your Active Directory Upgrade or Migration Strategy Preparing ClearCase Hosts 4.5 Domain Upgrade Scenarios Upgrading a Single Domain Upgrading a Master Domain and Its Resource Domains Upgrading Multiple Master and Resource Domains Converting Proxy Groups 4.6 Domain Migration Scenarios Migrating Multiple Domains Migrating Users and Groups If You Must Add a New User While Migration Is In Progress Migrating Individual ClearCase Hosts If VOB Servers Cannot Migrate When Clients Do 4.7 Using vob_sidwalk to Change or Update VOB Users and Groups Remapping Historical SIDs After Domain Migration Remapping Current SIDs When Moving a VOB to a New Domain Reassigning Ownership to the VOB Owner Resetting VOB Storage Directory Protections Using -delete_groups With Ownership-Preserving Replicas
5. Configuring ClearCase in a Mixed Network 5.1 When to Use ClearCase in a Mixed Network Environment When Not to Use a Mixed Environment 5.2 ClearCase Capabilities in a Mixed Environment Windows UNIX Constraints in a Mixed Environment 5.3 Managing User Accounts Creating a ClearCase Server Process User Account on UNIX Credentials Mapping and the Credentials Server Checking User and Group Assignments UNIX VOB Group Lists and Registered User Groups 5.4 ClearCase Access Control on UNIX and Windows 5.5 Case-Sensitivity General Recommendations Case Considerations on UNIX Case Considerations on Windows When to Use Case-Sensitive Mode NFS Client Products and Case-Sensitivity
6. Cross-Platform File Access 6.1 ClearCase File Service Enabling CCFS on Windows 6.2 NFS Client Products Disabling Automatic Case Conversion Microsoft SFU and Intergraph DiskAccess Hummingbird NFS Maestro Setting an NFS Client's Default Protection Microsoft SFU or Intergraph DiskAccess Hummingbird NFS Maestro Setting the Correct Logon Name Microsoft SFU or Intergraph DiskAccess Hummingbird NFS Maestro Hummingbird NFS Maestro: Disabling DOS Sharing Automounting and NFS Client Software Microsoft SFU 1.0 or Intergraph DiskAccess: Configuring Authentication for the ClearCase Server Process User 6.3 SMB Server Products Installing and Configuring Samba Creating a Samba Username Map for clearcase_albd Using the Samba Web Administration Tool (SWAT) Configuring Samba Globals for ClearCase Creating Shares for VOB and View Storage Starting Samba Services Configuring ClearCase to Support Samba Testing the Samba Configuration on Non-ClearCase Files Testing the Samba Configuration with ClearCase TotalNET Advanced Server Installing TAS Enabling the Multiuser Kernel Driver on AIX Accessing the Syntax Administration Framework Performing Initial Setup of TAS General TAS Settings Enabling and Configuring the CIFS Realm Configuring TAS to Support ClearCase Creating a TAS Username Map for clearcase_albd Creating a Volume Configuring the File Service Start Services and Accept Service Connections Configuring ClearCase to Support TAS Testing the TAS Configuration on Ordinary Files Testing the TAS Configuration with ClearCase
7. Configuring VOB and View Access in Mixed Environments 7.1 Preparing the UNIX VOB or View Host 7.2 Creating a New Network Region Assigning Computers to the New Network Region 7.3 Creating VOB-Tags and View-Tags in the New Region Using the Region Synchronizer 7.4 Re-Creating an Incorrect VOB-Tag or View-Tag 7.5 Windows Tags for UNIX VOBs with Symbolically Linked Storage Mapping Storage Pools for an Existing VOB-Tag 7.6 Configuring Text Modes for Views Text Modes Determining a View's Text Mode Choosing a Text Mode for a View Enabling Interop Text Mode Support in VOBs Determining Whether a VOB Supports Interop Text Modes Special Procedure for MultiSite Users
8. Understanding VOBs and VOB Storage 8.1 Introduction to VOBs and VOB Administration Types of VOBs Access to VOB Data and Metadata Views Tags VOB Server Processes 8.2 The VOB Storage Directory VOB Storage Pools Source Storage Pools Cleartext Storage Pools Derived Object Storage Pools VOB Database Preserved Database Subdirectories The .identity Directory 8.3 The lost+found Directory 8.4 VOB Datatypes The VOB Object and Replica Objects File System Objects Link Counts for UNIX File System Objects Type Objects Instances of Type Objects Predefined and User-Defined Type Objects Scope of Type Objects Changing an Element's Type Shareable Derived Objects Configuration Records Event Records
9. Setting Up VOBs 9.1 VOB Server Configuration Guidelines VOB Feature Levels Displaying the Feature Level Changing the Feature Level VOB Schema Versions 9.2 Planning for One or More VOBs Planning for Release VOBs 9.3 Modifying a UNIX VOB Host for ClearCase UNIX Kernel Resources Optional Software Packages 9.4 Creating VOB Storage Locations 9.5 Creating a VOB Linking a VOB to an Administrative VOB Creating a VOB on a Remote Host Adjusting the VOB's Ownership Information Case 1: One Group for All VOBs, Views, and Users Case 2: Accommodating Multiple User Groups Ensuring Global Access to the VOB-Special Cases for UNIX Guess Was Wrong, But Global Pathname Does Exist Network Requires Multiple Global Pathnames Enabling Setuid and Setgid Mounting of the Viewroot and VOB File Systems on UNIX Hosts Creating Remote Storage Pools on UNIX Hosts 9.6 Coordinating the New VOB with Existing VOBs 9.7 Populating a VOB with Data Importing Data into a UCM Project Example: Importing RCS Data Creating the Data File Running clearimport Example: Importing PVCS Data Creating the Data File Running the Conversion Scripts 9.8 Converting a SourceSafe Configuration Overview of Payroll Configuration Shares Branches Labels Pins Setting Your Environment Setting Environment Variables Setting Your SourceSafe Current Project Running clearexport_ssafe Using the Recursive Option Example Running clearimport Examining the Results Version Numbers Labels Branches Pins Shares
10. Backing Up and Restoring VOBs 10.1 Choosing Backup Tools UNIX Backup Issues Windows Backup Issues 10.2 Backing Up a VOB Backing Up a VOB on UNIX Backing Up a VOB on Windows Choosing Between Standard and Semi-Live Backup Benefits of Semi-Live Backup Costs of Semi-Live Backup Enabling Semi-Live Backup Deferred Source Container Deletion Determining a VOB's Location Ensuring a Consistent Backup Locking and Unlocking a VOB Partial Backups DO Pool Backup Cleartext Pool Backup Administrative Directory Backup Incremental Backups of a VOB Storage Directory 10.3 Backing Up a UNIX VOB with Remote Storage Pools 10.4 Restoring a VOB from Backup with vob_restore vob_restore: Sample Session Target Prompt Storage Directory Prompt Snapshot Prompt Backup-Loaded Prompt Sample VOB Restoration Scenario vob_restore: Restoration Scenarios How vob_restore Determines the Scenario Restoration Rules and Guidelines vob_restore: In Place vob_restore: VOB Is Active vob_restore: Move VOB on Same Host vob_restore: Move VOB to New Host vob_restore: Unregistered vob_restore: Restoring with a Database Snapshot 10.5 Restoring a VOB from Backup Without vob_restore 10.6 Restoring an Individual Element from Backup 10.7 VOB and View Resynchronization Resynchronizing Views and VOBs Reestablishing Consistency of a View's Derived Object State
11. Administering VOB Storage 11.1 VOB Storage Management Monitoring VOB Storage Using the Scheduler 11.2 Scrubbing to Control VOB Storage Growth Scrubbing VOB Storage Pools Scrubbing VOB Databases Adjusting Default Scrubbing Parameters Scrubbing Derived Objects More Often Fine-Tuning Derived Object Scrubbing Scrubbing Less Aggressively 11.3 Removing Unneeded Versions from a VOB 11.4 Creating Additional Storage Pools Tools for Working with Storage Pools cleartool Subcommands 11.5 Creating Remote Storage Pools on UNIX Hosts Example: Assigning All Files in a Directory to a New Pool Example: Moving an Existing Storage Pool to Another Disk
12. Moving VOBs 12.1 Important Steps to Take When Moving Any VOB 12.2 Special Considerations for Replicated VOBs 12.3 Moving a VOB on Windows Moving a VOB Within a Domain Moving a VOB to a Different Domain 12.4 Moving a VOB on UNIX If the VOB Has Remote Pools Consolidating Remote Pools If the VOB Is Exported for Non-ClearCase Access Moving a VOB Between UNIX Hosts (Same Architecture) Moving a VOB Between UNIX Hosts (Different Architectures) 12.5 Moving a VOB Between Windows and UNIX Schema Version Compatibility Moving a VOB from Windows to UNIX Moving a VOB from UNIX to Windows
13. Removing VOBs 13.1 Locking as an Alternative to VOB Deactivation 13.2 Taking a VOB Out of Service Restoring the VOB to Service 13.3 Removing a VOB
14. Using checkvob 14.1 When to Use checkvob 14.2 Checking Hyperlinks 14.3 Checking Global Types Fix Processing Output Log for Global Type Checking Example Check or Fix Scenario 14.4 Database or Storage Pool Inconsistencies Updating the VOB Database Requirements for Using checkvob Replicated VOB Considerations Running checkvob Output Log for Pool Checking Overview of checkvob Processing Individual File Element or DO Processing Pool Mode (-pool Option) Processing: Overview Force-Fix Mode Pool Setup Mode Descriptions of Storage Pool Problems Source, DO, or Cleartext Pool: Bad Pool Roots Description Cause Fix Processing Source or DO Pool: Misprotected Container on Windows Description Cause Fix Processing Missing and Unreferenced Data Containers Source Pool: Missing Container Source Pool: Unreferenced Container (Debris) Source Pool: Corrupted Container Description Cause Fix Processing DO Pool: Missing Container Description Causes Fix Processing DO Pool: Unreferenced Container (Debris) Description Causes Fix Processing DO Pool: Corrupted Container Description Causes Fix Processing 14.5 Sample Check and Fix Scenarios Scenario 1: VOB Database Newer Than Storage Pools Running checkvob Scenario 2: Storage Pools Newer Than VOB Database Running checkvob 14.6 Sample checkvob Runs 14.7 Database Newer Than Pools 14.8 Database Older Than Pools 14.9 Unreferenced Containers from Incremental Backup or Restore 14.10 Pool Root Check Failure Fixing Pool Roots: Getting Started Fixing Pool Roots: The Most Common Problems Pool Skew Caused by Addition of New Pool Pool Skew Caused by Pool Deletion Pool Skew Caused by Renamed Pool A More Complex Pool Skew Scenario How to Re-Create a Pool's pool_id
15. Splitting VOBs with relocate 15.1 What Does relocate Do? 15.2 Element Relocation Illustrated Cataloging in the Source VOB Cataloging in the Target VOB Relocating Borderline Elements 15.3 Before Relocating Elements 15.4 Common Errors During a Relocate Operation Errors Not Related to Source VOB Element Removal Errors During Source VOB Element Removal 15.5 After Relocating Elements Symbolic Links Upgrading Views That Rely on Symbolic Links Cleanup Guidelines Updating Directory Versions Manually Fixing Symbolic Links Created by relocate Modifying Old Target Directory Versions to See Relocated Elements Modifying Newest Version of Source Directory to See Relocated Elements
16. Using Administrative VOBs and Global Types 16.1 Overview of Global Types 16.2 Why Use Global Types? 16.3 Working with Administrative VOBs Creating an Administrative VOB Linking a Client VOB to an Administrative VOB Administrative VOB Hierarchies Listing an AdminVOB Hyperlink Restrictions on Administrative and Client VOBs If an Administrative VOB Becomes Unavailable Using Administrative VOBs with MultiSite Breaking a Link Between a Client VOB and an Administrative VOB Removing the AdminVOB Hyperlink Removing All GlobalDefinition Hyperlinks Removing an Administrative VOB Fixing Global Type Problems After Restoring a VOB from Backup 16.4 Working with Global Types Creating a Global Type Auto-Make-Type Operations Auto-Make-Type of Shared Global Types Describing Global Types Listing Global Types Listing History of a Global Type Changing Protection of a Global Type Locking or Unlocking a Global Type Changing Mastership of a Global Type Changing the Type of an Element or Branch Copying a Global Type Renaming a Global Type Changing the Scope of a Type Removing a Global Type Cleaning Up Global Types
17. Understanding Views and View Storage 17.1 Introduction to Views and View Administration 17.2 Dynamic Views View Root View Storage Directory View-Private Storage View Database How a Dynamic View Selects Versions How a Dynamic View Manages Derived Objects 17.3 The Multiversion File System (MVFS) Supported File Types The MVFS and Audited Builds Known Limitations of the MVFS on Windows The MVFS and Case-Sensitivity Running Executables in the MVFS MVFS Performance 17.4 Snapshot Views Snapshot View Directory Tree View Storage Directory View Database How a Snapshot View Selects Versions 17.5 Remote View Storage
18. Setting Up Views 18.1 Setting Up an Individual User's View View Storage Requirements View Database View's Private Storage Area 18.2 Setting Up a Shared View 18.3 Setting Up an Export View for Non-ClearCase Access Exporting Multiple VOBs Multihop Export Configurations Restricting Exports to Particular Hosts
19. Backing Up and Restoring Views 19.1 Backing Up a View 19.2 Restoring a View from Backup
20. Administering View Storage 20.1 View Storage Maintenance Getting Information on View Contents Scrubbing View-Private Storage 20.2 Cleaning Up a View Manually
21. Moving Views 21.1 Moving a View Moving a View on UNIX Moving a View on Windows 21.2 Moving a View to a UNIX Host with a Different Architecture 21.3 Moving a Dynamic View's Private Storage Area on UNIX
22. Removing Views 22.1 Taking a View Out of Service Restoring the View to Service 22.2 Permanent Removal of a View
23. Using Network Attached Storage with VOB Server and View Server Hosts 23.1 NAS and ClearCase Configuring Network Access to the NAS Device Changes Are Required in Some Procedures 23.2 Creating a Storage Location on NAS 23.3 Creating a VOB on NAS 23.4 Moving a VOB to NAS Moving a VOB That Has No Remote Pools Consolidating Remote Pools 23.5 Backing Up a VOB on NAS Restoring a VOB from Backup 23.6 Creating a View on NAS 23.7 Moving a View to NAS Moving a Dynamic View Moving a Snapshot View 23.8 Backing Up a View on NAS 23.9 Replacing a VOB or View Server Host Replacing a VOB Server Host Replacing a View Server Host 23.10 Reformatting a VOB or View
24. Administering Licenses 24.1 Floating License Architecture License Priorities License Expiration License Report Utility 24.2 Setting Up a License Server Adding New Licenses to an Existing License Server Host Setting Up Additional License Server Hosts 24.3 Moving Licenses to Another Host 24.4 Renaming a License Server Host 24.5 License Database Format License Set Definition Lines User Priority Lines Excluded User Lines Audit-Enable Line Time-Out Line
25. Understanding the ClearCase Registry 25.1 Registry Hosts, Backup Registry Hosts, and Registry Regions 25.2 Registry Administration Tools 25.3 Storage Directories and Access Paths Distributed VOBs and Views on UNIX 25.4 Storage Registries 25.5 Object Registries 25.6 Tag Registries Tag Registries on UNIX Tag Registries on Windows 25.7 Networkwide Accessibility of VOBs and Views Public and Private VOBs 25.8 Managing VOB and View Registry Entries Viewing VOB and View Registry Entries Creating VOB and View Registry Entries Creating VOB-Tags and View-Tags 25.9 Creating Server Storage Locations 25.10 Registering Site-Wide Properties 25.11 Registry Guidelines Multiple Registries
26. Administering Regions 26.1 Network Regions Registries in a Multiple-Region Network Tag Registry Implementation Establishing Network Regions 26.2 Adding a Network Region When to Create Additional Regions Multiple Regions vs. Multiple Registries A Example Using Network Regions Procedure for Adding a Network Region To Create a New Region To Move a Host into a New Registry Region To Change a Host's Registry Server To Create VOB-tags and View-tags in a New Network Region Using mktag If the New Region Is Served by a Different Registry Host Guidelines for Multiple Network Regions 26.3 Removing a Network Region
27. Moving, Renaming, and Backing Up the ClearCase Registry 27.1 Backing Up Registry Data 27.2 Setting Up a Backup Registry Host Moving the Registry to an Active Backup Registry Host Switching to a Backup Registry Server Switching Back to the Primary Registry Server Moving the Registry to a Host Not Configured for Registry Snapshots No Backup Host: Primary Registry Host Is Available No Backup Host: Primary Registry Host Is Down 27.3 Renaming the Registry Server Host 27.4 Changing the Backup Registry Host Changing Backup Registry Host Using rgy_switchover Changing Backup Registry Host Without rgy_switchover 27.5 Renaming a VOB or View Host
28. Managing Scheduled Jobs 28.1 Tasks and Jobs Task and Job Storage Task and Job Database Initialization Job Execution Environment 28.2 The Default Schedule 28.3 Managing Tasks Creating a Task Editing a Task Deleting a Task 28.4 Managing Jobs Creating a Job Specifying a Job's Schedule Specifying Job Notifications Viewing Job Properties Editing Job Properties Running a Job Immediately Deleting a Job 28.5 Managing the Scheduler Access Control List
29. Configuring a Web Server for the ClearCase Web Interface 29.1 Configuration Planning Web Administration Considerations ClearCase Considerations Browser Considerations 29.2 Configuring the Web Server Apache Microsoft Internet Information Server (IIS) Configuration Steps for IIS4 Configuration Steps for IIS5 iPlanet Enterprise Server
30. Configuring Integrations with Microsoft Web Authoring Tools 30.1 Overview of the Integration Server Setup Overview Client Setup Overview 30.2 Server Setup Procedure Step 1: Install IIS Step 2: Install FPSE or OSE Step 3: Install ClearCase Step 4: Run the Web Authoring Integration Configuration Wizard 30.3 Client Setup Procedure Step 1: Install the Client Application Step 2: Add Web to Source Control From FrontPage 98 From FrontPage 2000 From Visual InterDev 6.0 Step 3: Verify That New Web Content Is Added to Source Control Step 4: Setting User Permissions FrontPage 98 FrontPage 2000 Visual InterDev 6.0 Step 5: Local Mode Client Setup for FrontPage 2000 30.4 Web Folders Support in Office 2000 and Microsoft Internet Explorer 5 30.5 Updating the Shared View on the Web Server 30.6 Considerations for Migrating and Converting Data to the Integration 30.7 Accessing Help Information for the Integration
31. Using Dynamic Views to Develop and Deliver Web Content 31.1 Overview of Using Dynamic Views on a Web Server 31.2 Example Scenario VOB and Branch Configuration View Configuration for Tasks Developing New Content Merging and Testing Approved Changes Viewing and Testing Content Accessing Content from a Web Browser Implementing Policies Testing Source Files Before Checkin Restricting the Users Who Can Approve Changes Labeling Approved Sources Synchronizing the Massachusetts and California VOB Replicas Copying Files to the Web Server Rolling Back to Previously Published Versions 31.3 Configuring the Web Server Configuring the Apache Web Server To Configure an Apache Web Server on Windows To Configure an Apache Web Server on UNIX Configuring the Netscape Enterprise Web Server
32. Improving VOB Host Performance 32.1 Minimize Process Overhead 32.2 Maximize Disk Performance 32.3 Add Memory for Disk Caching on Windows 32.4 Tune Block Buffer Caches on UNIX Block Buffer Cache Statistics Flushing the Block Buffer Cache 32.5 Modify Lock Manager Startup Options Lock Manager Implementations Lock Manager Startup Options
33. Improving Client Host Performance 33.1 Client Host Configuration Guidelines 33.2 Examining and Adjusting MVFS Cache Size Real-Time Updating of MVFS Cache Sizes Adjusting the MVFS Memory Initialization Factor Setting Individual Caching Parameters on UNIX Setting Individual Cache Sizes on Windows Minimizing Attribute Cache Misses Attribute Cache Total Misses Close-to-Open Misses Generation Misses Cache Timeout Misses Cache Fill Misses Event Time Misses 33.3 View Caches 33.4 Obtaining View Cache Information Analyzing the Output 33.5 Reconfiguring a View
34. Determining a Data Container's Location 34.1 Scenario 34.2 Determining the ClearCase Status of Files 34.3 Determining the Full UNIX Pathnames of Files 34.4 Where Is the VOB? 34.5 Where Is the View? 34.6 Where Are the Individual Files? Locating a Checked-Out Version Locating a Checked-In Version's Cleartext Container Locating a Checked-In Version's Source Container Locating a View-Private File Issues with Nonlocal UNIX Storage Links and Directories on UNIX
35. Repairing VOB and View Storage Directory ACLs on Windows 35.1 ClearCase ACLs 35.2 Causes of Protection Problems Copying the Storage Directory Converting the File System from FAT to NTFS Editing Permissions 35.3 Utilities for Fixing Protection Problems fix_prot Options Examples lsacl 35.4 Fixing Protection Problems
36. Preventing Accidental Deletion of Data by crontab Entries 36.1 Preventing Recursive Traversal of the Root Directory crontab Modification During ClearCase Installation Modifying a crontab Entry

ClearCase Documentation