SERENA® PVCS® VERSION MANAGER™ 8.2 Administrator’s Guide Serena Proprietary and Confidential Information Copyright © 1985–2008 Serena Software, Inc. All rights reserved. This document, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. Except as permitted by such license, no part of this publication may be reproduced, photocopied, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Serena. Any reproduction of such software product user documentation, regardless of whether the documentation is reproduced in whole or in part, must be accompanied by this copyright statement in its entirety, without modification. This document contains proprietary and confidential information, and no reproduction or dissemination of any information contained herein is allowed without the express permission of Serena Software. The content of this document is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Serena. Serena assumes no responsibility or liability for any errors or inaccuracies that may appear in this document. Trademarks Serena, TeamTrack, StarTool, PVCS, Collage, Comparex, Dimensions, RTM, Change Governance, and ChangeMan are registered trademarks of Serena Software, Inc. The Serena logo, Professional, Version Manager, Builder, Meritage, Command Center, Composer, Reviewer, Mariner, and Mover are trademarks of Serena Software, Inc. All other products or company names are used for identification purposes only, and may be trademarks of their respective owners. U.S. Government Rights Any Software product acquired by Licensee under this Agreement for or on behalf of the U.S. Government, its agencies and instrumentalities is "commercial software" as defined by the FAR. Use, duplication, and disclosure by the U.S. Government is subject to the restrictions set forth in the license under which the Software was acquired. The manufacturer is Serena Software, Inc., 1900 Seaport Boulevard, 2nd Floor, Redwood City, California 94063-5587. Part number: MA-VMADMIN-008 Publication date: August 2008 Table of Contents Welcome to Version Manager . 11 Typographical Conventions . 11 Using the Manuals . 12 Contacting Technical Support . 13 Chapter 1 Setting Up Version Manager Using the Desktop Client . 15 Introduction . 16 About Version Manager Projects . 16 About Version Manager Project Databases . 17 Planning a Project Database . 19 Workfiles . 19 Archive Locations . 20 Workfile Locations . 20 Shared Archives . 21 Upgrading 5.3/6.0 Projects. 22 Converting SourceSafe Databases . 23 Cross-Platform Environment . 23 Serena Builder . 24 Setting Up a Project Database . 24 Creating a Project Database . 24 Creating a Project . 26 Adding Workfiles . 28 Sharing Archives . 32 Copying 5.3/6.0 Projects into Project Databases . 33 Setting Up Version Manager for Cross-Platform Use . 41 Turning Off Setuid . 43 Editing the nfsmap File . 43 Assigning Privileges . 44 Configuring Version Manager . 45 Making the Case of File and Directory Names Consistent . 51 What's Next . 51 Chapter 2 Configuring Version Manager . 53 Introduction . 54 About Configuration Options . 54 Default Settings in the Desktop Client . 56 Default Settings when No Configuration File Is Used . 58 Understanding Configuration Files in the Desktop Client . 60 Master Configuration File . 60 Guidelines for Setting Configuration Options in the Desktop Client . 61 How Version Manager Reads Configuration Files in the Desktop Client . 62 Administrator's Guide 3 Table of Contents Associating Configuration Files with Project Databases and Projects . 62 Understanding Configuration Files in the Command-Line Interface. 64 Master Configuration File . 64 Guidelines for Setting Configuration Options in the Command-Line Interface . 65 How Version Manager Reads Configuration Files in the Command-Line Interface . 65 How the Command-Line Interface Uses Configuration Files Created in the Desktop Client . 66 Setting Configuration Options . 66 Using the Desktop Client . 66 Using the Command-Line Interface . 68 Archive Creation Options . 69 Branching Options . 71 Locking Options . 71 Promotion Options. 73 Access Control Database Options . 73 Journal File Options . 74 Login Sources . 75 LDAP Configuration Options . 81 Workfile Attributes Options. 85 Keyword Expansion Options . 86 Reference Directory Options . 88 Archive Search Path Options. 90 Command-Line Options . 92 Semaphore Options . 94 Temporary File Options . 97 Options Set on a File Type Basis . 98 Event Triggers . 103 Allowing and Disallowing Options . 103 Embedding a Master Configuration File into Version Manager . 105 Using the Desktop Client . 105 Using the Command-Line Interface . 106 Setting Up TrackerLink and SourceBridge . 107 Setting SourceBridge User Options . 108 Working with Both TeamTrack and TrackerLink . 110 Setting Up Serena Mover . 112 Configuring a Connection to a Mover Server . 112 Using Version Manager with Mover . 113 Troubleshooting. 114 Configuration File Locked by Another User . 114 Chapter 3 Setting Up Version Manager Using the Command-Line Interface . 115 Introduction . 116 About the Version Manager Command-Line Interface . 116 Default Archive Suffix Template . 116 Guidelines for Use . 117 4 Serena® PVCS® Version Manager™ 8.2 Table of Contents Restrictions . 117 Project Organization Scenarios . 117 Small Single-Person Projects . 117 Larger Single-Person Projects . 118 Multiple-Person, Network-Based Projects . 118 Planning a Version Manager Setup . 118 Workfiles . 118 Archive Locations . 119 Workfile Locations . 119 Cross-Platform Environment . 119 Setting Up a Multiple-Person, Network-Based Project . 119 Creating Archive Directories . 120 Creating Workfile Directories on Local Workstations . 120 Creating Local Configuration Files . ..