. StarTeam Best Practices ........ A guide to StarTeam’s general architecture and how to use StarTeam with your software development processes Table of Contents CONTENTS .................................................................................................................................................................2 INTRODUCTION .......................................................................................................................................................4 STARTEAM OVERVIEW.........................................................................................................................................4 THE STARTEAM MODEL .......................................................................................................................................5 THE STARTEAM REPOSITORY.....................................................................................................................................5 CLIENT SERVER ARCHITECTURE ................................................................................................................................5 PROJECT-ORIENTATION..............................................................................................................................................6 ITEMS .........................................................................................................................................................................7 PROJECTS ...................................................................................................................................................................8 VIEWS ........................................................................................................................................................................8 FOLDERS ....................................................................................................................................................................9 VIEW LABELS...........................................................................................................................................................10 BRANCHING VIEWS ..................................................................................................................................................10 MERGING VIEWS ......................................................................................................................................................12 LINKING ...................................................................................................................................................................12 FILE STATUS.............................................................................................................................................................13 USE CASES ...............................................................................................................................................................14 I. RELEASE DEVELOPMENT AND MAIN DEVELOPMENT............................................................................................14 Sample Scenario 1 ...............................................................................................................................................14 Using a New View to Resolve Scenario 1............................................................................................................14 Using Labels to Resolve Scenario 1 ....................................................................................................................14 Sample Scenario 2 ...............................................................................................................................................17 Using Promotion States to Resolve Scenario 2....................................................................................................17 II. BUG FIXES ...........................................................................................................................................................19 Using a Fix or Maintenance Branch to Resolve Scenario 3................................................................................20 III. INDEPENDENT PRODUCT DEVELOPMENT............................................................................................................20 Sample Scenario 4 ...............................................................................................................................................20 Using a New Branch to Resolve Scenario 4 ........................................................................................................21 IV. COMMON COMPONENT LIBRARY DEVELOPMENT ..............................................................................................21 Setting up the Build Process................................................................................................................................22 Checking Out by Build Label...............................................................................................................................22 Checking Out by Promotion State .......................................................................................................................22 V. CONFIGURATION IDENTIFICATION REPORTS........................................................................................................23 Creating a Filter..................................................................................................................................................23 Displaying Modified Files and Generating the Report........................................................................................26 VI. STAGING ............................................................................................................................................................28 Phase 1: Creating Promotion States for Your Stages..........................................................................................28 Phase 2: Creating a View for the Test Stage ..................................................................................................29 Phase 3: Creating a View for the Production Stage.......................................................................................30 TIPS FOR STARTEAM 4.1 .....................................................................................................................................30 Databases ............................................................................................................................................................31 Project Structure..................................................................................................................................................31 Folders.................................................................................................................................................................31 Backups................................................................................................................................................................31 SECURITY .................................................................................................................................................................32 From StarTeam VirtualTeam Server ...................................................................................................................33 From StarTeam....................................................................................................................................................33 MANIPULATING FOLDERS AND ITEMS IN STARTEAM ...............................................................................................34 2 LABELS ....................................................................................................................................................................35 View Labels .........................................................................................................................................................36 Revision Labels....................................................................................................................................................37 PROMOTION STATES.................................................................................................................................................37 CHANGE REQUESTS..................................................................................................................................................38 TOPICS......................................................................................................................................................................38 TASKS ......................................................................................................................................................................39 GLOSSARY ...............................................................................................................................................................40 3 Introduction StarTeam has revolutionized software configuration management (SCM) applications by saving your company time, money, and code integrity. Since StarTeam’s inception, we have learned from our own experiences and that of our customers about the best ways to install, configure and use StarTeam. We’d like to share this knowledge and information with you. This document includes: ÿ StarTeam Overview A general description