Templates For Software Configuration Management Documents

Templates For

Software Configuration Management

Documents

Deluxe Version 3.0

ISBN Number: 0-9770309-2-x

Produced by: Software Engineering Process Technology (SEPT)

2725 NW Pine Cone Drive Issaquah, WA. 98027 Tel: 425-391-2344

E-mail: Stanmagee@ Web Pages: and

Authors: H. Ronald Berlack and John M. Neorr

?2007 Software Engineering Process Technology (SEPT).

1

Templates For

Software Configuration Management

Documents

Deluxe Version 3.0

ISBN Number: 0-9770309-2-x

Abstract

This document contains a set of templates for software configuration management (CM) documents to aid engineers and managers to implement software configuration management processes per the requirements specified in ISO/IEC standard 12207, Software Life Cycle Processes (1995), including Amendment 1:2002 and Amendment 2:2004; and standard 15288, System Life Cycle Processes (2002) as it pertains to software elements. For software CM processes and related activities and artifacts, these standards-driven templates provide generic descriptions and instructions that, as needed, can be tailored to a specific organization's or project's needs. Thirteen templates are provided. They are:

Template # 1 2 3 4 5 6 7 8 9 10 11A 11B 12

Template Name Software Configuration Management Policy Software Configuration Management Strategy Software Configuration Management Organization Charts Software Configuration Management Plan Software Configuration Management Process Software Configuration Identification Procedure Software Configuration Change Control Procedure Software Configuration Status Accounting Procedure Software Configuration Item Check-in and Check-out Procedure Software Configuration Audits and Reviews Procedure Subcontractor Software Configuration Control Procedure External Interface Configuration Control Procedure Software Product Release and Delivery Procedure

In addition to the templates shown above, this document provides five different aids to help tailor the templates.

?2007 Software Engineering Process Technology (SEPT).

2

What's New in Version 3.0

Version 2.0 of this document, ably written by Ron Berlack, provided a set of software configuration management templates to enable software engineers and managers to implement software configuration management processes per the requirements specified in ISO/IEC standard 12207, Software Life Cycle Processes. In Version 3.0, these templates have been updated to add the software CM requirements of ISO/IEC standard 15288, System Life Cycle Processes. In addition to revising existing templates, we added three new templates and included new diagrams throughout the document. We also expanded and improved the document's text to make the document more readable and usable.

Version 3.0, with its added templates, improved graphics, and expanded text should prove beneficial to you as you begin to implement and execute the very important process of software configuration management. An itemization of Version 3.0 enhancements appears below.

Version 3.0 Enhancement

Description

Document updated to insure templates meet ISO/IEC 15288 standard as it pertains to software configuration management.

Templates can now be used to meet the requirements of both ISO/IEC 12207 and ISO/IEC 15288. Strategy document specifically added as part of this effort.

Added template for software CM strategy.

This template not only helps insure a better CM plan, but also insures compliance with the 15288 standard.

Added template for a check-in/check-out procedure.

This procedure enables version management of configuration items and uses a CM repository to store configuration management data.

Added template for product release and delivery.

This template added to insure compliance with specific requirements in the 12207 standard.

Added an introduction to each template.

Templates are preceded by introductory text to help readers understand the process being supported.

Added standards cross-reference table.

For each 12207 and 15288 CM process clause, this table shows what templates are needed to satisfy that clause.

Added several new diagrams.

10 new diagrams have been included in the document. They explain the topic area to which a template applies. These diagrams can be used for communicating CM concepts to affected organizations and individuals.

?2007 Software Engineering Process Technology (SEPT).

3

Software Configuration Management Templates - Table of Contents

Table of Contents

What's New in Version 3.0 ........................................................................................................... 3

1. Introduction........................................................................................................................... 6

1.1

About Software Configuration Management .................................................................. 6

1.2

How to Use This Document............................................................................................ 7

1.3

The Software Domain ..................................................................................................... 9

1.4

Traceability to 12207 and 15288 .................................................................................... 9

1.5

Product Support ............................................................................................................ 12

1.6

Warranties and Liability ............................................................................................... 12

2. Software Configuration Management Templates............................................................ 13

2.1

Software Configuration Management Policy................................................................ 15

2.2

Software Configuration Management Strategy ............................................................ 20

2.3

Software Configuration Management Organization Charts ......................................... 28

2.4

Software Configuration Management Plan................................................................... 32

2.5

Software Configuration Management Process.............................................................. 43

2.6

Software Configuration Identification Procedure ......................................................... 53

2.7

Software Configuration Change Control Procedure ..................................................... 59

2.8

Software Configuration Status Accounting Procedure ................................................. 65

2.9

Software Configuration Item Check-in and Check-out Procedure ............................... 69

2.10 Software Configuration Audits and Reviews Procedure .............................................. 74

2.11 External Interfaces Procedures ..................................................................................... 78

2.12 Software Product Release and Delivery Procedure ...................................................... 86

3. Software Configuration Management Aids...................................................................... 91

3.1

Aid 1: Acronyms........................................................................................................... 92

3.2

Aid 2: Standards............................................................................................................ 97

3.3

Aid 3: Software Change Request Data Elements ......................................................... 97

3.4

Aid 4: Software Status Accounting Data Elements ...................................................... 98

3.5

Aid 5: Software Documentation Approval Matrix ....................................................... 99

4. About the Authors............................................................................................................. 103

?2007 Software Engineering Process Technology (SEPT).

4

Software Configuration Management Templates ? List of Figures

List of Figures

Figure 1: Software CM templates, and aids, and how they relate. ................................................ 8 Figure 2: CM Policy provides high-level guidance and control.................................................. 15 Figure 3: CM Strategy is guided by policy and focuses plans and procedures. .......................... 20 Figure 4: Software CM organization within a typical large company. ....................................... 29 Figure 5: CM organization within a small company. .................................................................. 30 Figure 6: Organization of a typical software CM group. ............................................................ 30 Figure 7: The configuration management process showing all its inputs and outputs................ 44 Figure 8: Controlled objects and their relationships and attributes. .......................................... 45 Figure 9: Conceptual hierarchy of CM policies, plans, processes, and procedures. .................. 46 Figure 10: Change control process flow...................................................................................... 61 Figure 11: Check-in/Check-out used by CM processes. .............................................................. 69 Figure 12: The check-in/check-out process. ................................................................................ 71 Figure 13: Product release and delivery ? the final step. ............................................................ 86

?2007 Software Engineering Process Technology (SEPT).

5

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download