StarTeam 17.0 Server Administration Help Micro Focus The Lawn 22-30 Old Bath Road Newbury, Berkshire RG14 1QN UK http://www.microfocus.com © Copyright 2019 Micro Focus or one of its affiliates. MICRO FOCUS, the Micro Focus logo and StarTeam are trademarks or registered trademarks of Micro Focus or one of its affiliates. All other marks are the property of their respective owners. 2019-02-03 ii Contents StarTeam Server Administration .......................................................................5 Welcome to StarTeam .........................................................................................................5 Introduction ......................................................................................................................... 5 Installation and Licensing for StarTeam ....................................................................5 Products Included with StarTeam Enterprise Licenses ............................................ 6 Products Included with StarTeam Enterprise Advantage Licenses .......................... 8 Contacting Support .................................................................................................. 9 Standard StarTeam Architecture Overview .............................................................. 9 MPX Components .................................................................................................. 11 About Source Control ............................................................................................. 13 Atomic Check-ins ................................................................................................... 13 Deployment Guidelines ..................................................................................................... 14 Performance and Scalability Factors ...................................................................... 14 Configuration Size .................................................................................................. 14 Multiple Configurations on the Same Server ..........................................................15 Medium Configurations .......................................................................................... 17 Large Configurations .............................................................................................. 18 Active/Passive Clustering ....................................................................................... 19 Server Administration ........................................................................................................20 StarTeam Server Administration Overview .............................................................21 Server Administrator Assumptions ......................................................................... 21 StarTeam Server Configuration Sample Data ........................................................ 22 Licensing the Server ......................................................................................................... 22 Setting Up License Servers ....................................................................................22 Using Evaluation Licenses ..................................................................................... 24 Using Native Licenses ............................................................................................24 Saving License (.slip) Files .....................................................................................25 Assigning Licenses to Users .................................................................................. 25 Managing Named User Licenses ........................................................................... 27 Working with Server Configurations ..................................................................................27 About Server Configurations .................................................................................. 27 Creating, Running, and Managing Server Configurations ......................................36 Managing Users and Groups ................................................................................. 42 Configuring the Server ........................................................................................... 61 Upgrade Distribution through StarFlow ............................................................................. 89 Auto Client Update ................................................................................................. 90 Search ...............................................................................................................................90 Search Index Configuration ....................................................................................90 Customization .........................................................................................................91 Troubleshooting ...................................................................................................... 93 Custom Components ........................................................................................................ 93 Custom Component Builder ................................................................................... 93 Manually Creating Custom Components ................................................................96 Import/Export Manager ..................................................................................................... 98 Import/Export Manager Business Rules .................................................................98 Best Practices ...................................................................................................... 100 Exporting .............................................................................................................. 101 Importing .............................................................................................................. 101 Maintenance Task Scheduler .......................................................................................... 103 Assigning a Schedule to a Script ..........................................................................104 Scripts .................................................................................................................. 104 Contents | 3 Maintenance Task Scheduler Dialog Box .............................................................105 Managing Log and Initialization Files .............................................................................. 105 Initialization Files .................................................................................................. 105 StarTeam.Log ....................................................................................................... 113 Audit Logs ............................................................................................................ 114 Security Logs ........................................................................................................115 Working with the Server Log ................................................................................ 118 DbConvert.<local>.log ..........................................................................................119 Analyze Server Log and Analyze Archived Server Logs .................................................122 Configuring Datamart ......................................................................................................123 Working with Pulse ..........................................................................................................123 Tracing Data from Check-out Operations ........................................................................ 124 Tracing Data from Check-out Operations with the Check-out Trace Utility ...........124 Enabling Tracing for Server Configurations Manually ...........................................125 Generating .CSV Files About Check-out Operations ........................................... 125 Data Storage Options ......................................................................................................126 Data Storage Overview ........................................................................................ 126 Native-II Vaults ..................................................................................................... 127 Hives .................................................................................................................... 129 Creating New Hives ..............................................................................................130 Customizing the Archives Path .............................................................................131 Viewing and Customizing Hive Properties ........................................................... 132 Migrating Servers ............................................................................................................ 133 Moving Server Configurations Overview .............................................................. 133 Migrating Server Configurations ...........................................................................133 Moving Server Configurations to a New Server ................................................... 135 Guidelines for Data Files and Translation Logs ...............................................................136 Guidelines for Microsoft SQL Server/Microsoft SQL Server Express Data Files and Transaction Logs ............................................................................................................................