SERENA® PVCS® VERSION MANAGER™ 8.1.4 IDE Client Implementation Guide Serena Proprietary and Confidential Information Copyright © 2000–2007 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., 2755 Campus Drive, San Mateo, CA 94403. Part number: MA-VMIDE-006 Publication date: March 2007 Table of Contents Welcome to Version Manager . 15 Typographical Conventions . 15 Using the Manuals . 16 Contacting Technical Support . 17 Part 1 The Version Manager IDE Client . 19 Introduction . 20 Chapter 1 Overview of Version Manager Source Control. 21 Introduction . 22 Source Control Concepts. 22 Project Databases . 22 Projects and Subprojects . 22 Archives. 22 Revisions . 23 Workfiles . 23 Locks . 23 Version Labels . 23 Promotion . 23 Branches . 24 Sharing . 24 Workspaces . 24 Available Source Control Information . 24 Viewing Properties of Files Under Source Control. 24 Monitoring Source Control Activity. 24 Viewing Historical Archive or Revision Activity. 24 Comparing Files or Revisions . 25 Working with Version Manager 5.3/6.0 Projects. 25 How Version Manager Integrates with IDEs. 25 Chapter 2 Setting Up Source Control with SCC IDEs . 27 Introduction . 28 Recommended Workflow . 28 Administrators . 28 All Users . 28 About Selecting a Source Control Provider . 29 Selecting an SCC Provider . 29 Testing an SCC Provider. 30 Stopping the PVCSCLIServ Service . 31 Creating and Configuring Project Databases . 31 About Version Manager Workspaces . 31 IDE Client Implementation Guide 3 Table of Contents Launching the Version Manager Desktop Client . 32 About Setting Defaults for Version Manager Options . 32 Setting Defaults . 33 About Creating Source Control Projects . 35 About Adding Files to Source Control . 35 Returning Files to Source Control . 35 Advanced Add Options . 36 About Sharing Files Across Projects . 37 Sharing Files. 37 About Removing Files from Source Control . 38 Chapter 3 Setting Up Source Control with COM IDEs . 39 Introduction . 40 About Web Projects . 40 Recommended Workflow . 40 Supported Web Server Configurations . 41 Configuring Web Server Security . 41 Windows Security . 41 FrontPage User Permissions . 42 Configuring Source Control Defaults. 42 Editing Default Project Settings. 43 Enabling External Source Control . 45 Adding Web Projects to Source Control. 46 Nested Project Structure . 46 Removing Web Projects from Source Control. 46 Restoring Web Files to Source Control . 47 Checking Out a Previous Revision . 47 Chapter 4 Using Source Control . 51 Introduction . 52 Logging In to Version Manager Projects . 52 About Getting Files. 52 Advanced Get Options . 53 Getting IDE Projects from Source Control. 54 About Checking Out Files . 54 Advanced Checkout Options . 55 About Undoing Checkout. 56 Advanced Undo Checkout Options . 57 About Checking In Files . 57 Advanced Check-In Options . 58 About Version Labels . 60 Assigning Version Labels . 60 Renaming Version Labels . 62 Deleting Version Labels . 64 4 Serena® PVCS® Version Manager™ 8.1.4 Table of Contents About Promotion Groups. 65 Checking Out Revisions Assigned to a Promotion Group . 66 Assigning a Promotion Group to Revisions . 66 Promoting Revisions to the Next Promotion Group. 68 Changing a Promotion Group . 70 Removing a Promotion Group . 72 Chapter 5 Accessing Source Control Information . 75 Introduction . 76 About Properties . 76 Reviewing Properties . 76 Monitoring Source Control Activity with Pulse . 77 Configuring Pulse . 77 About Starting Pulse . ..