Viewtier Parabuild 4.2 Administrator's Manual Viewtier Parabuild 4.2: Administrator's Manual Copyright © 2004-2012 Viewtier Systems Table of Contents Preface ................................................................................................................... xiii About This Manual ........................................................................................... xiii Audience ........................................................................................................ xiii Technical Support ............................................................................................ xiii 1. Load Balancing and Failover ...................................................................................... 1 Automatic Load Balancing .................................................................................... 1 Transparent Failover ............................................................................................ 1 2. Monitoring Build Statuses ......................................................................................... 2 List View Mode ..................................................................................................2 Detailed View Mode ............................................................................................ 2 Monitoring Other Build Statuses While in the Detailed View Mode .............................. 2 Recent Builds Mode ............................................................................................ 2 Build Control Commands ..................................................................................... 2 Controlling Build Execution Using Change Messages ................................................ 3 3. Monitoring Agent Statuses ........................................................................................ 4 Monitoring Agent Load ........................................................................................ 4 Agent List View .................................................................................................4 Monitoring Builds on Single Agent ........................................................................ 4 Build Control Commands ..................................................................................... 4 4. System Administration ............................................................................................. 5 Parabuild will display a list of configuration options on the right size of the screen .......... 5 E-Mail Settings ........................................................................................... 5 Instant Messaging Settings ............................................................................ 7 Global Version Control User to E-mail Map ..................................................... 8 General System Settings ....................................................................................... 9 Appearance Settings .................................................................................... 9 Stability Settings ....................................................................................... 13 Display Groups ......................................................................................... 15 Projects ................................................................................................... 16 Global Variables ....................................................................................... 17 Managing Build Infrastructure ............................................................................. 18 Managing Build Agents .............................................................................. 18 Managing Build Farms ............................................................................... 19 Entering Parabuild License ................................................................................. 20 Configuring LDAP Authentication ....................................................................... 20 Connection URL ....................................................................................... 21 Connection Principal And Connection Credentials ........................................... 21 Connection Security Level .......................................................................... 21 Processing Referrals .................................................................................. 21 User Distinguished Name Template .............................................................. 21 User Search Template ................................................................................ 22 Base Element for User Searches ................................................................... 22 Search Entire Subtree ................................................................................. 22 User Password Attribute Name .................................................................... 22 Credentials Digest Algorithm ...................................................................... 23 User E-Mail Attribute Name ....................................................................... 23 Add First-Time Users To Group ................................................................... 23 Using LDAP to Map Names of Version Control Users to E-mails ....................... 23 Testing LDAP Configuration ....................................................................... 23 Integrating With Active Directory ................................................................ 23 5. Configuring a Build ............................................................................................... 24 Overview ......................................................................................................... 24 General Settings Form ....................................................................................... 24 iv Viewtier Parabuild 4.2 Naming a Build ................................................................................................ 24 Selecting Build Type ......................................................................................... 25 Automatic Builds ...................................................................................... 25 Scheduled Builds ...................................................................................... 25 Manual Builds .......................................................................................... 26 Parallel Builds .......................................................................................... 26 Selecting Build Results Access ............................................................................ 26 Detailed Build Configuration ............................................................................... 27 Adding Build Steps ................................................................................... 27 Common Version Control Settings ............................................................... 29 Configuring Accurev Access ....................................................................... 29 Configuring Bazaar Access ......................................................................... 31 Configuring ClearCase Access ..................................................................... 32 Configuring CVS Access ............................................................................ 35 Configuring Watching for File System Changes .............................................. 40 Configuring Generic Version Control System Access ....................................... 42 Configuring Git Access .............................................................................. 44 Configuring Mercurial Access ..................................................................... 46 Configuring MKS Access ........................................................................... 46 Configuring Perforce Access ....................................................................... 48 Configuring Serena Version Manager (PVCS) Access ...................................... 53 Configuring StarTeam Access ..................................................................... 55 Configuring Subversion Access ................................................................... 56 Configuring Surround Access ...................................................................... 59 Configuring Vault Access ........................................................................... 61 Configuring Visual SourceSafe Access .......................................................... 63 Configuring Build Schedule ........................................................................ 65 Configuring Build Labeling ........................................................................ 68 Configuring Dependent Build ...................................................................... 68 Notification Settings Tab .................................................................................... 68 Setting Notification Policy .......................................................................... 69 Mapping Names of Users of a Version Control System to E-mail ....................... 69 Using E-mails Provided by Version Control System ........................................ 69 Setting Default E-mail Domain .................................................................... 69 Notifying Other Users ................................................................................ 70 Understanding Relative Paths .............................................................................