SOFTWARE CONFIGURATION MANAGEMENT DOCUMENTATION STEVE J. AYER FRANK S. PATRINOSTRO Edited by JACK A. NELSON Technische Hochschule Darmstadt FACH8EREICH INFORMATIK BIBLIOTHEK Inventar-Nr.:, SachgetH9te: Standort: SOFTWARE DEVELOPMENT DOCUMENTATION SERIES VOLUME 6
CHAPTER 1 - INTRODUCTION 1 Configuration Identification Documents Functional Baselines 2 4 Allocated Baselines Design Baseline 5 5 Product Baseline Operational Baseline...: 6 7 Configuration Control Documents 8 Change Control Documents 8 Policies Operating Procedures 9 9 Document Control Forms, ; 10 Standards and Guidelines 10 Configuration Accounting Documents 12 Configuration Audit Documents Configuration Management Plan : 14 15 CHAPTER 2-TUTORIAL: CONFIGURATION IDENTIFICATION DOCUMENTS17 Introduction : 17 Identifying Functional Baseline SCIs 22 Identifying Allocated Baseline SCIs 26 Identifying Design Baseline SCIs 29 Identifying Product Baseline SCIs 32 Identifying Operational Baseline SCIs 37 CHAPTER 3 - TUTORIAL: CONFIGURATION CONTROL DOCUMENTS 41 Introduction 41 Policies Change Initiation Policy 42 43 Technical Assessment Policy 44 Business Assessment Policy 45 Approval Policy 46 Test Tracking Policy 47 Installation Tracking Policy 48 Software Change Control Documents Change Classification 50 52 Change Request (CR) 53 Change Action Report (CAR) 54 Discrepancy Report (DR) 55
'viil Contents Discrepancy Action Report (DAR) 56 Status Report (SR) 57 Baseline Document Revision Control 58 Manuscript Review 59 Document Status Notations 60 Document Review Control Form 61 Marking Review Copies 62 Conducting the Meeting 63 Concurrence and Sign-Off.. 64 Change Control 65 Using the Table of Contents as a Checklist 66 Revision Control Form 67 Change Control Grid 68 Configuration Management Standards.,..., 69 Configuration Management Plan Standards 71 Baseline Management Standards 73 Interface Control Standards 75 Configuration Identification Standards 77 Change Control Standards 79 Release Requirement Standards 81 Configuration Audit Standards 83 Configuration Accounting Standards 85 CHAPTER 4 - TUTORIAL CONFIGURATION AUDITING DOCUMENTS 87 Introduction 87 Functional Configuration Audit (FCA) 88 Checklists 89 Functional Requirements Checklist...; 90 Allocated Requirements Checklist,.91 Configuration Item Test Checklist...92 Questionnaires 93 Interview Questionnaires 94 Interview Worksheet Interview Summary 95 96 Verification Forms...97 Accuracy and Validity Verification Form Data Integrity Verification Form 98 99 Performance Verification Form 100 Physical Configuration Audit (PCA) 101 Design Documentation Checklist 102 Test Documentation Checklist 103 Version Description Documentation Checklist 104 Change Control Documentation Checklist Formal Qualification Review (FQR).: 105 106 Configuration Audit Record 107 CHAPTER 5 - TUTORIAL: CONFIGURATION ACCOUNTING DOCUMENTS.. 109 Introduction 109 Logs Ill Data Base Change Request Log ;. 112 Design Problem Report Log 113 Document Update Transmittal Log 114
ix Product Log Routine Log 115 116 Site Installation Log 117 Software Change Proposal Log 118 Software Modification Report Log 119 Software Problem Report Log 120 Specification Change Notice Log Test Status Log 121 122 Reports Change Request Status Summary 123 124 Computer Program Inventory Report 125 Computer Program Library Transmittal Summary 126 Software Modification Report Summary 127 Software Problem Report Summary 128 Test Status Summary Report 129 Version Description Document 130 Version Identification Form 131 Version Application Form 132 Differences. Between Versions Form 133 Software Capabilities and Limitations Form 134 Adaptation Information Form 135 Installation Instructions Form 136 LIST OF FIGURES Figure Page 1-1 Baseline Documents of the Software Development Life-Cycle 2 1-2 Categories of Baseline Documents! 3 2-1 Baseline Correlation of Life-Cycle Stages 18 2-2 Hierarchy of an SCI Labeling Scheme 20 2-3 SCI Version Identification 21 2-4 Project File/Phase End-Document Orientation of Functional Baseline SCIs 24 2-5 Functional Baseline Repository 25 2-6 Project File/Phase End-Document Orientation of Allocated Baseline SCIs 27 2-7 Allocated Baseline Repository 28 2-8 Project File/Phase End-Document Orientation of the Design Baseline SCIs 30 2-9 Design Baseline Repository 31 2-10 Project File/Phase End-Document Orientation of the Product Baseline SCIs 36 2-11 Product Baseline Repository 36 2-12 Project File/Phase End-Document Orientation of the Operational Baseline SCIs 39 3-1 Configuration Control Documents 41 3-2 3-3 Example of a Change Initiation Policy Statement Example of a Technical Assessment Policy Statement 43 44 3-4 Example of a Business Assessment Policy Statement 45
3-5 Example of an Approval Policy Statement 46 3-6 Example of a Test Tracking Policy Statement 47 3-7 Example of an Installation Tracking Policy Statement 48 3-8 Configuration Management Policy Manual 49 3-9 Software Change Control Documents 51 3-10 Change Request (CR) Form 53 3-11 Change Action Report (CAR) 54 3-12 Discrepancy Report (DR) 55 3-13 Discrepancy Action Report (DAR) 56 3-14 Status Report (SR) 57 3-15 Revision Control Documents 58 3-16 Review and Approval Points 59 3-17 Review Copy Status Notation 60 3-18 Document Review Control Form 61 3-19 Example of Marking Review Copies 62 3-20 Formal Baseline Establishment 63 3-21 Example of a Document Sign-Off Sheet 64 3-22 Document Change Processing Flow 65 3-23 Example of Using the Table of Contents as a Change Control Checklist 66 3-24 Example of a Revision Control Form 67 3-25 Change Control Grid 68 3-26 Components of a Configuration Management Standards Manual 70 3-27 Example of a Configuration Management Plan Standard 71 3-28 Example of a Baseline Management Standard 73 3-29 Example of an Interface Control Standard 75 3-30 Example of a Configuration Identification Standard 77 3-31 Example of a Change Control Standard 79 3-32 Example of a Release Requirement Standard 81 3-33 Example of a Configuration Audit Standard 83 3-34 Example of a Configuration Accounting Standard 85 4-1 Configuration Audit Process 87 4-2 FCA Checklists 89 4-3 Functional Requirements Checklist : 90 4-4 Allocated Requirements Checklist 91 4-5 Configuration Item Test Checklist 92 4-6 Interview Process 93 4-7 Auditing Questionnaire Form 94 4-8 Interview Worksheet 95 4-9 Interview Summary Form 96 4-10 Verification Process 97 4-11 Accuracy and Validity Verification Form.. 98 4-12 Data Integrity Verification Form 99 4-13 Performance Verification Form 100 4-14 Design Documentation Checklist 102 4-15 Test Documentation Checklist 103 4-T6 Version Description Documentation Checklist 104 4-17 Change Control Documentation Checklist 105 4-18 Formal Qualification Review Process 106 4-19 Configuration Audit Record 107 5-1 CSA System 109 5-2 Data Base Change Request Log 112
XI 5-3 Design Problem Report Log 113 5-4 Document Update Transmittal Log 114 5-5 Product Log 115 5-6 Routine Log 116 5-7 Site Installation Log 117 5-8 Software Change Proposal Log 118 5-9 Software Modification Report Log 119 5-10 Software Problem Report Log 120 5-11 Specification Change Notice Log 121 5-12 Test Status Log 122 5-13 Change Request Status Summary 124 5-14 Computer Program Inventory List 125 5-15 Computer Program Library Transmittal Summary 126 5-16 Software Modification Report Summary 127 5-17 Software Problem Report Summary 128 5-18 Test Status Summary Report 129 5-19 Content Arrangement of a Version Description Document 130 5-20 Version Identification Form 131 5-21 Version Application Form 132 5-22 Differences Between Versions Form 133 5-23 Software Capabilities and Limitations Form... 134 5-24 Adaptation Information Form 135 5-25 Installation Instructions Form 136 LIST OF TABLES Table Page 2-1 Functional Baseline SCI Labeling Scheme 22 2-2 Allocated Baseline SCI Labeling Scheme 26 2-3 Design Baseline SCI Labeling Scheme 29 2-4 Product Baseline SCI Labeling Scheme 32 2-5 Operational Baseline SCI Labeling Scheme 37 5-1 CSA Logs 111 5-2 Configuration Accounting Reports 123