SOFTWARE CONFIGURATION MANAGEMENT DOCUMENTATION

Transcription

1 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

2 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 : 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 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 Change Request (CR) 53 Change Action Report (CAR) 54 Discrepancy Report (DR) 55

3 '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 Verification Forms...97 Accuracy and Validity Verification Form Data Integrity Verification Form 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).: Configuration Audit Record 107 CHAPTER 5 - TUTORIAL: CONFIGURATION ACCOUNTING DOCUMENTS Introduction 109 Logs Ill Data Base Change Request Log ;. 112 Design Problem Report Log 113 Document Update Transmittal Log 114

4 ix Product Log Routine Log 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 Reports Change Request Status Summary 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 Categories of Baseline Documents! Baseline Correlation of Life-Cycle Stages Hierarchy of an SCI Labeling Scheme SCI Version Identification Project File/Phase End-Document Orientation of Functional Baseline SCIs Functional Baseline Repository Project File/Phase End-Document Orientation of Allocated Baseline SCIs Allocated Baseline Repository Project File/Phase End-Document Orientation of the Design Baseline SCIs Design Baseline Repository Project File/Phase End-Document Orientation of the Product Baseline SCIs Product Baseline Repository Project File/Phase End-Document Orientation of the Operational Baseline SCIs Configuration Control Documents Example of a Change Initiation Policy Statement Example of a Technical Assessment Policy Statement Example of a Business Assessment Policy Statement 45

5 3-5 Example of an Approval Policy Statement Example of a Test Tracking Policy Statement Example of an Installation Tracking Policy Statement Configuration Management Policy Manual Software Change Control Documents Change Request (CR) Form Change Action Report (CAR) Discrepancy Report (DR) Discrepancy Action Report (DAR) Status Report (SR) Revision Control Documents Review and Approval Points Review Copy Status Notation Document Review Control Form Example of Marking Review Copies Formal Baseline Establishment Example of a Document Sign-Off Sheet Document Change Processing Flow Example of Using the Table of Contents as a Change Control Checklist Example of a Revision Control Form Change Control Grid Components of a Configuration Management Standards Manual Example of a Configuration Management Plan Standard Example of a Baseline Management Standard Example of an Interface Control Standard Example of a Configuration Identification Standard Example of a Change Control Standard Example of a Release Requirement Standard Example of a Configuration Audit Standard Example of a Configuration Accounting Standard Configuration Audit Process FCA Checklists Functional Requirements Checklist : Allocated Requirements Checklist Configuration Item Test Checklist Interview Process Auditing Questionnaire Form Interview Worksheet Interview Summary Form Verification Process Accuracy and Validity Verification Form Data Integrity Verification Form Performance Verification Form Design Documentation Checklist Test Documentation Checklist T6 Version Description Documentation Checklist Change Control Documentation Checklist Formal Qualification Review Process Configuration Audit Record CSA System Data Base Change Request Log 112

6 XI 5-3 Design Problem Report Log Document Update Transmittal Log Product Log Routine Log Site Installation Log Software Change Proposal Log Software Modification Report Log Software Problem Report Log Specification Change Notice Log Test Status Log Change Request Status Summary Computer Program Inventory List Computer Program Library Transmittal Summary Software Modification Report Summary Software Problem Report Summary Test Status Summary Report Content Arrangement of a Version Description Document Version Identification Form Version Application Form Differences Between Versions Form Software Capabilities and Limitations Form Adaptation Information Form Installation Instructions Form 136 LIST OF TABLES Table Page 2-1 Functional Baseline SCI Labeling Scheme Allocated Baseline SCI Labeling Scheme Design Baseline SCI Labeling Scheme Product Baseline SCI Labeling Scheme Operational Baseline SCI Labeling Scheme CSA Logs Configuration Accounting Reports 123