Software Configuration Management with Elego ComPact Version 1.2

ComPact Development Team

This manual, as well as the software decribed in it, is furnished under license and may only be used or copied in accordance with the terms of such license. Basically, ComPact consists of some programs and manuals that are free for private and non-commercial use, and some that need to be purchased. The general license documents can be found in English and German at the end of this book.

For more information regarding the details of that license, ComPact itself, and other Elego products and services, contact us at:

      elego Software Solutions GmbH
       --- Elego ComPact Information 
      email: info@elego.de
      www: http://www.elego.de
      or: http://www.elego-software-solutions.com
      Cranachstraße 7
      D-12157
      Berlin
      Germany
      phone: +49.30.85 58 01 81
      fax:   +49.30.85 58 01 88
    



Direct Links: email: info@elego.de www: http://www.elego.de or: http://www.elego-software-solutions.com

This product includes software developed by John D. Polstra.

This product includes software developed by the University of California, Berkeley and its contributors.

This product includes software developed by the System Research Center of Digital Equipment Corporation, now owned by Compaq.

Note: This manual is still work in progress. It is considered to be fairly complete and correct, yet as with all continually developing software products, documentation efforts usually cannot keep pace with the current implementation. Therefore some features of the software that are described in the manual may have changed or become obsolete, while others that are more recent may not be described at all. We do our best to keep the manuals up-to-date, but we are sure that we do not succeed all the time. Thus said, error reports and corrections are of course greatly appreciated.


Table of Contents
I. Introduction
1. About ComPact Release 1.2
2. About Configuration Management
3. Working with Elego ComPact
3.1. Work from the Point of View of a Single Developer
3.2. Coordinating Version Control between Multiple Developers
3.3. Coordinating Software Builds between Multiple Developers
4. Elego ComPact Concepts
4.1. Divide and conquer
4.2. Concentrate your efforts, localize your work
4.3. Keep an eye on history
4.4. Have a plan and stick to it
4.5. Don't trust revolutions
4.6. Automate tedious tasks
4.7. Keep everything simple
5. The Concept of Software Packages
5.1. Use of software packages for build management
5.2. Use of software packages for version management
5.3. Use of software packages for process management
6. Elego ComPact Tools
6.1. The ComPact Version Manager Pkgvm
6.2. The ComPact Package Manager Pkgm
6.3. The ComPact Instance Generator Instgen
6.4. The ComPact Project Manager Prjm
6.5. The ComPact Pool Manager Poolm
6.6. The ComPact Graphical User Interface Compact-Httpd
6.7. The ComPact Resource Service Compactrsrcd
II. Installation
7. Requirements
7.1. Hardware and Operating Systems
7.2. Required Third Party Software
8. Overview of the Elego ComPact Installation
8.1. CM and ComPact Installation Basics
9. Use of the Graphical Installer
10. Manual Installation
10.1. D-I-Y Installation for the Impatient
10.2. D-I-Y Installation of the Executable Programs
10.3. Installation and Configuration of the Source Code Repository
10.3.1. Configuring CVS for use with the Remote Shell Protocol
10.3.2. Configuring CVS for use with the Pserver Protocol
10.3.3. Configuring CVS for use with other Accees Methods
10.3.4. Configuring the ComPact Client Programs
10.4. Installation of the Package Pools
10.5. Setup of a global configuration file
10.6. Other Configuration Files: PkgBase.DefaultData and pkgconf.cbcl
10.6.1. PkgBase.DefaultData
10.6.2. pkgconf.cbcl
10.7. Setup of the ComPact Resource Service
List of Figures
3-1. Working with Elego ComPact
3-2. Elego ComPact Version Management
3-3. Elego ComPact Build Management
5-1. Sample Package Structure
5-2. Sample Package Version Tree