Administrator's Guide for Rational ClearCase LT, Release 2002.05.00, All Platforms
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.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.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.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.1 Floating License Architecture
License Priorities
License Expiration
License Report Utility
5.2 Setting Up a License Server
Adding New Licenses to an Existing License Server Host
Setting Up Additional License Server Hosts
5.3 Moving Licenses to Another Host
5.4 Renaming a License Server Host
5.5 License Database Format
License Set Definition Lines
User Priority Lines
Excluded User Lines
Audit-Enable Line
Time-Out Line
6.1 Introduction to VOBs and VOB Administration
Types of VOBs
Access to VOB Data and Metadata
Views
Tags
VOB Server Processes
6.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
6.3 The lost+found Directory
6.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
7.1 VOB Server Configuration Guidelines
VOB Feature Levels
Displaying the Feature Level
Changing the Feature Level
VOB Schema Versions
7.2 Planning for One or More VOBs
Planning for Release VOBs
7.3 Modifying a UNIX VOB Host for ClearCase
UNIX Kernel Resources
Optional Software Packages
7.4 Creating VOB Storage Locations
7.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
7.6 Coordinating the New VOB with Existing VOBs
7.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
7.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
8.1 Overview of Global Types
8.2 Why Use Global Types?
8.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
8.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
9.1 Choosing Backup Tools
UNIX Backup Issues
Windows Backup Issues
9.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
9.3 Backing Up a UNIX VOB with Remote Storage Pools
9.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
9.5 Restoring a VOB from Backup Without vob_restore
9.6 Restoring an Individual Element from Backup
9.7 VOB and View Resynchronization
Resynchronizing Views and VOBs
Reestablishing Consistency of a View's Derived Object State
10.1 VOB Storage Management
Monitoring VOB Storage
Using the Scheduler
10.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
10.3 Removing Unneeded Versions from a VOB
10.4 Creating Additional Storage Pools
Tools for Working with Storage Pools
cleartool Subcommands
10.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
11.1 Important Steps to Take When Moving Any VOB
11.2 Special Considerations for Replicated VOBs
11.3 Moving a VOB on Windows
Moving a VOB Within a Domain
Moving a VOB to a Different Domain
11.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)
11.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
12.1 Locking as an Alternative to VOB Deactivation
12.2 Taking a VOB Out of Service
Restoring the VOB to Service
12.3 Removing a VOB
13.1 When to Use checkvob
13.2 Checking Hyperlinks
13.3 Checking Global Types
Fix Processing
Output Log for Global Type Checking
Example Check or Fix Scenario
13.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
13.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
13.6 Sample checkvob Runs
13.7 Database Newer Than Pools
13.8 Database Older Than Pools
13.9 Unreferenced Containers from Incremental Backup or Restore
13.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
14.1 What Does relocate Do?
14.2 Element Relocation Illustrated
Cataloging in the Source VOB
Cataloging in the Target VOB
Relocating Borderline Elements
14.3 Before Relocating Elements
14.4 Common Errors During a Relocate Operation
Errors Not Related to Source VOB Element Removal
Errors During Source VOB Element Removal
14.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
15.1 ClearCase LT Views
15.2 View Contents
15.3 View Storage Areas
15.4 Backing Up a View
15.5 Restoring a View from Backup
15.6 Configuring Text Modes for Views
Text Modes
Determining a View's Text Mode
Choosing a Text Mode for a View
15.7 File Naming Issues in Mixed Environments
Case-Sensitivity
Character Sets
16.1 Tasks and Jobs
Task and Job Storage
Task and Job Database Initialization
Job Execution Environment
16.2 The Default Schedule
16.3 Managing Tasks
Creating a Task
Editing a Task
Deleting a Task
16.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
16.5 Managing the Scheduler Access Control List
17.1 Configuration Planning
Web Administration Considerations
ClearCase Considerations
Browser Considerations
17.2 Configuring the Web Server
Apache
Microsoft Internet Information Server (IIS)
Configuration Steps for IIS4
Configuration Steps for IIS5
iPlanet Enterprise Server
18.1 Overview of the Integration
Server Setup Overview
Client Setup Overview
18.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
18.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
18.4 Web Folders Support in Office 2000 and Microsoft Internet Explorer 5
18.5 Updating the Shared View on the Web Server
18.6 Considerations for Migrating and Converting Data to the Integration
18.7 Accessing Help Information for the Integration
19.1 Minimize Process Overhead
19.2 Maximize Disk Performance
19.3 Add Memory for Disk Caching on Windows
19.4 Tune Block Buffer Caches on UNIX
Block Buffer Cache Statistics
Flushing the Block Buffer Cache
19.5 Modify Lock Manager Startup Options
Lock Manager Implementations
Lock Manager Startup Options
20.1 ClearCase ACLs
20.2 Causes of Protection Problems
Copying the Storage Directory
Converting the File System from FAT to NTFS
Editing Permissions
20.3 Utilities for Fixing Protection Problems
fix_prot
Options
Examples
lsacl
20.4 Fixing Protection Problems