Professional Documents
Culture Documents
CM Process Description
CM Process Description
CM Process Description
Procedure
Date: 10.01.2006
Procedure Configuration Management Process Description
Issued by the
Siemens AG Com Mobile Networks
St. Martin-Strasse 76
D-81541 Munich
Responsible for updating: (Tiziana Vimercati, Umberto Pesce, Milan, Tel. 0224377211)
The file name of this document is: "CM Process Description v2 060110.doc".
It is based on the "Standard WORD Template for PEPP Working Level Process Documents.
Contents
0 Preamble ...................................................................................................4
0.1 Scope ............................................................................................................. 4
0.2 Applicability................................................................................................... 4
0.3 Document management ............................................................................... 4
0.4 History ........................................................................................................... 4
0.5 Responsibility ............................................................................................... 4
1 Position within PLP Process Structure ..................................................5
2 Process Overview ....................................................................................7
3 Process Sections Description.................................................................9
3.1 Configuration Management Strategy........................................................... 9
3.1.1 First Issue of the CM Plan (B130) ...........................................................................9
3.1.2 Final Issue of the CM Plan (B200).........................................................................10
3.1.3 Planning CM activities ...........................................................................................10
3.2 Configuration Management Control .......................................................... 11
3.2.1 Establish Baselines................................................................................................12
3.2.2 Establish Integrity...................................................................................................17
3.2.3 Track and Control Changes...................................................................................19
4 References ..............................................................................................26
ANNEXES.........................................................................................................27
A Abbreviations..........................................................................................27
0 Preamble
0.1 Scope
The aim of this document is to provide a detailed process description for configuration manage-
ment activities according to PPP: D Process for Radio Access Networks [1] in conformance with
CMMI requirements.
0.2 Applicability
The directions provided in this document apply to Com MN PG R, Com CRD RA and any other
organization involved in product development on behalf of Com MN PG R.
The document is applicable to external projects (i.e. projects delivered to customers). It can be
applied to internal projects as well, specifying in the relevant project Configuration Management
Plan how it is applied.
0.4 History
DS 01, 10.11.2005 AFI Version, first issue
DS 02, 10.01.2006 IUS Version, after review
0.5 Responsibility
This document is under responsibility of Siemens Com CRD DT.
ANALYSIS
HARDWARE
DEVELOPMENT
P
r SOFTWARE
o DEVELOPMENT
Cc
oe SYSTEM
r s INTEGRATION
es SYSTEM
e TEST
s
CUSTOMER
ACCEPTANCE
PRODUCT QUALIFICATION
PROJECT MANAGEMENT
P
Sr QUALITY MANAGEMENT
uo
CONFIGURATION MANAGEMENT
pc
pe CHANGE MANAGEMENT
os FAULT MANAGEMENT
r s
t e TECHNOLOGY MANAGEMENT
s
CONTINUOUS PROCESS IMPROVEMENT
2 Process Overview
Configuration Management is the PLP PPP:D support process of identifying the components
that comprise system configurations, controlling those components and changes to them
throughout the system lifecycle, recording configuration status and history information, and pro-
viding configuration auditing
The purpose of the Configuration Management Process is to guarantee a homogenous and
methodical style of work within the project for all items under Configuration Control. It defines the
application of administrative and technical procedures throughout the product life cycle.
The Configuration Management Process takes into account the fact that configuration item types
are heterogeneous and require different configuration management activities. All configuration
items are identified by a unique code, author, date of issue, version etc. in order to allow any
time traceability, validation and retrieval.
Examples of configuration items are:
Documents (e.g. Feature Sheets, Functional Specifications, Interface Specifications, Design
Specifications, Test Specifications, O&M Documents).
SW-items (e.g. source code modules, libraries, tools, scripts, rules, executables).
HW-items (e.g. boards, racks)
In particular HW Configuration Management monitors the HW life cycle based on a HW
Status definition, identifying different main consolidation levels of the HW which extend be-
yond the PPP:D.
The main activities belonging to CM process are:
Define, identify and manage configuration items
Control, record and report status/version of configuration items
Ensure the formal completeness, consistency and correctness of the configuration items
Archive, store, provide and distribute configuration items
Obtain derived items through the definition and application of production rules (e.g. executa-
bles)
Ensure the re-producibility of all derived items for a time period fixed according to internal
and/or external requirements
Configuration
Management
Strategy
Configuration Management Strategy: it is the sub-process during which all the Con-
figuration Management activities are established and planned. The output of the
planning activity is the CM plan which is ready as a first issue at B130 and updated at
B200.
Configuration Management Control: it is the sub-process during which the CM system is
defined and all the Configuration Management activities are performed.
The purpose of the Configuration Management Strategy is to identify the activities required for
the Configuration Management for a specific project, to identify and establish the tools to ac-
complish Configuration Management activities, to define a scheme for identification, versioning
and control of all Configuration Items within the project and to plan necessary resources.
The CM Strategy process consists in three main sections:
Issue a first version of the Configuration Management Plan at B130.
Issue the final version of the Configuration Management Plan at B200
Plan the Configuration Management activities.
The standard template for Configuration Management Plan documents is reported in [3], where
the typical table of contents is provided, including the description of each chapter and paragraph.
The CM Plan document is prepared and released in a first issue at B130. The contents of the
document is based on CM company policies and on information contained in the project docu-
mentation before B130 milestone.
In particular the first issue of the CM Plan covers the following topics:
Roles definition and assignment for documentation lifecycle management
Elements under Configuration control
First skeleton of HW/SW/Documentation structure
Naming conventions
Lifecycles for Configuration items/components/units
Change control rules
Status accounting and configuration auditing activities
The final issue of the CM Plan is ready at B200. Later only corrective updates can be applied.
In the final issue, besides the topics already covered at B130, the
HW/SW/Documentation/Product structure description is completed.
The purpose of the Configuration Management Control process is to control formally the con-
figuration item modifications, applying mechanisms for tracing them (history of changes), to
make available reports on status and history of configuration items and to audit their congruence
and completeness.
Establish Base-
Identify Configuration
Establish CM sys-
Create/Release Base-
Establish Integ-
Establish CM Rec-
Perform Configuration
Control Configuration
As shown in Fig. 5, the Configuration Management sub-process is split in the following sections:
Establish Baselines: set of practices and activities devoted to identify configuration
items, define and establish the Configuration Management System and create, release
and maintain the baselines.
Establish Integrity: this section covers the activities to ensure the integrity of data
stored into the CM system and into the released baselines. In particular accounting and
auditing are typical activities performed in this section.
Track and Control Changes: set of specific practices devoted to control and track
changes to the work products under configuration management across the entire lifecy-
cle.
The Establish Baselines sub-process is performed by means of a set of specific practices de-
voted to identify configuration items, define and establish the Configuration Management System
and create, release and maintain the baselines.
o Related documentation
o Product Documentation
An unique unambiguous identifier has to be assigned to each configuration item and to each
configuration component/unit. A version index is also assigned to identify all the changes applied
to each component through the lifecycle.
Each time a component is modified the version index is updated, so that the revision number
serves to unambiguously define the contents of the component.
The naming conventions adopted both for identification and versioning, established during the
CM Strategy phase, are managed and controlled using appropriate tools and procedures.
In addition to the unambiguous identifier and version other information are stored and managed
for each configuration item/component/unit:
Author/Owner/Responsible
Type
Description
Information relating component evolution (i.e. creation date, update date, status, update
author)
The naming convention definition process is strictly related to the project and can follow different
criteria depending on the types of the item managed under configuration control. It is also related
to adopted company standards.
Specific topics relating configuration item identification for documentation, HW and SW items
are reported below.
Documentation Item naming convention
The definition of the naming convention is driven by the following criteria:
Keeping alignment with the system architecture
Organization of documentation items in a structure related to the foreseen item types,
considering the following categories
o Functional specifications
o Design specifications
o Planning documentation
o Testing documentation
o Feature description documentation
o Working documentation
o Review reporting documentation.
Documentation items naming convention is described into the CM Plan associated to the project
and it depends on the characteristics of the project and of the CM tool used to define and im-
plement the documentation configuration management environment.
This practice consists in establishing and maintaining a configuration management system for
controlling configuration items.
The configuration management system includes the storage media where project libraries and
CM database are archived and the procedures and the tools used for accessing the configura-
tion system.
The following requirements have to be satisfied and the following features ensured:
The CM system must be capable to store and manage all the configuration items and
tools
There must be versioning mechanisms in order to identify changes to all the configura-
tion units and to trace the status of each component version
The adopted CM tools must support and maintain CM libraries and databases
Features for the definition, creation and release of CM baselines must be available
Builds procedures must be designed and managed in order to ensure CM baselines re-
producibility
Page 14 of 27 10.11.2005 A1R19361 DS:01 SC:435
For internal use only Copyright Siemens AG
Procedure Configuration Management Process Description
The access to the CM system must be authenticated and users operations shall be gov-
erned on the basis of assigned roles
Features supporting change documentation, status accounting and reporting and con-
figuration auditing activities must be available.
The adopted CM systems must be able to contain and manage under version control compo-
nents currently being created or revised, to contain current CM baselines and changes to them
and to archive CM baselines already released.
It must be always possible to retrieve any archived version of configuration items/components
and to generate and manage reports about their history.
Specific procedures must be set up in order to preserve the CM system and to ensure backups
and restore of configuration management data. These procedures are performed by an external
organization.
The CM System can be different depending on the project and is technically described in details
in the related CM plan.
The process for setting up a CM system is performed each time a new project and/or a new project re-
lease have to be developed. The input for the process is the project starting (at B100) and the
requirements for the CM system are establish and analyzed during the CM strategy process, when the
first issue of the CM plan is produced. The CM system set up activities are planned considering the proj-
ect master plan and are performed in order that the CM system must be ready to host foreseen
documentation, hardware and software items. In particular the CM system must be ready before B130
milestone for documentation items, before B200 milestone for HW and and before D300 for SW items.
In order to allow for a later re-creation of a CM baseline, any support tool used to create a re-
lease is frozen as well as the configuration components.
CM procedures are defined and implemented to ensure that the CM baseline is generated con-
sidering only configuration components stored into the configuration management systems.
Utilities are available to audit the correctness, completeness and consistency of the frozen sys-
tem configuration.
A CM baseline can be delivered for internal use (i.e. for testing activities) or to the customer. The
delivery process is performed and traced using appropriate tools and is performed after a formal
approval.
Planned loads are SW loads generated by SW CM for incorporation of new items revi-
sions created for new features and/or change requests development and for
incorporation of bug fixes (failures raised during Network Entity Integration and System
Integration Test activities). These loads are planned during the SW implementation
phase and testing phases (from D300 to B500). In order to track the various loads and
their content a Load Plan is defined, maintained and communicated to all relevant
stakeholders, in accordance with the rules and procedures defined in the Project Man-
agement Guideline [15]. In the load plan are specified, for each load, the features and
change requests to be incorporated and the fixed bugs.
Corrective loads
Corrective loads are SW loads generated by CM exclusively to introduce corrections to
a SW load previously generated. Corrective loads can be also generated after B500
milestone. In this case the code freeze baseline is generated considering the frozen
configuration associated to the SW load to be corrected and introducing the updated
items revisions containing the corrections produced by designers.
A proper naming convention is defined in order to distinguish planned loads and corrective
loads.
Details about the load generation procedure are described in specific working level docu-
ments. [9] [10]
The delivery process is executed by SW Configuration Management in order to make avail-
able a SW load for testing purposes or for the installation in the field.
The following table summarizes the CM baselines foreseen for each milestone and their con-
tents.
The integrity of the baselines, established by the Establish Baseline sub-process and main-
tained by the Track and Control Changes sub-processes, is performed by a process whose
activities are described in the following paragraphs.
Configuration auditing is the process of verifying the completeness and correctness of all com-
ponents in a configuration. Completeness involves checking that all required components in a
configuration are produced; correctness involves verifying that the components agree with
specified requirements. Configuration Auditing is intended to increase the visibility of the current
status of the project, and to provide traceability between a product and its requirements through-
out the lifecycle. CM Audit activities and processes are performed to confirm that the resulting
CM baselines and documentation are accurate. Audit results are recorded as appropriate.
Three types of Configuration Audits are foreseen:
Functional Configuration Audits
The purpose is to verify that the development of a Configuration Item has been com-
pleted satisfactorily and that the Configuration Item has achieved the performance and
functional characteristics specified in the functional and allocated configuration baseline.
Functional configuration audits are held at the end of a development cycle, following the
completion of all the testing activities on the items that have been developed.
Examples of foreseen audits are:
Documentation CM baseline verification at ach milestone completion
SW load verification.
The Track and Control Changes sub-process is performed with a set of specific practices de-
voted to control and track changes to the work products under configuration management.
In any case changes are analyzed to determine the impacts that the change will have on the
work products, related work products, schedule and costs.
In the PPP:D/PLP process structure two specific support processes: Change Management and
Fault Management, are devoted to cover these topics. Specific procedures describe the project
change requests management process and the fault handling process. These procedures also
describe the organization of the change requests and faults/defects databases.
For more details the reader is referred to [4], [5] and [6].
At the end of the Change Management/Fault Management process the approved updates are
planned to be incorporated into a planned/corrective load. The updates are applied to the con-
figuration items into the CM system and are controlled by CM procedures described below.
The generic lifecycle for configuration items of class documentation is characterised by the fol-
lowing logical states:
UNDER WORK: it is the state associated by the item when it is created by the author(s);
in this state the item can be modified as many times as needed;
UNDER REVIEW: this state corresponds to the completion of the item contents and the
execution of formal verification on it; an item in the UNDER REVIEW state cannot be
modified; if formal verifications are successfully passed, the item is moved to the
APPROVED state by the approver(s), otherwise the item is moved to the
SUPERSEDED state by the approver(s) and a new version of the item is created in the
UNDER WORK state in order to be modified by the author(s) to insert the necessary
modifications;
APPROVED: this state corresponds to a successful verification of the item that is
therefore fully valid and applicable in the relevant context; to insert modifications into an
APPROVED item it is necessary to create a new version of it; when an APPROVED
item is included in a official release to the customer, it is moved to the RELEASED state
by the Configuration Management Responsible;
RELEASED: this state corresponds to a official release of the item to the customer; it is
a final state in the lifecycle;
SUPERSEDED: this state corresponds to a unsuccessful verification of the item; it is a
final state in the lifecycle.
The figure below depicts states, transitions and involved roles.
Under
Work
Author
Under
Review Approver
Approver
Approved CM Technician
Superseeded
Released
The logical states presented can have different names depending on the CM system adopted
and specific project rules. The specific life cycle shall be described in the relevant Quality Plans
and/or CM Plans of the specific development projects/releases.
The review process is tracked by CM and the review reports are stored and managed into the
CM system.
HW Configuration items have a life cycle based on HW Status definition, identifying different
consolidation levels of the HW.
The meaning of HW status and roles responsible for transitions are reported in the following ta-
ble.
10 -
Sample
Orders
12 -
Sample
Production
19 - Ready
For Develop.
Software Configuration Item Change Control
Release
A1R19361 DS:01 SC:435 10.11.2005 Page 23 of 27
Copyright Siemens AG For21 -
internal use only
Development
40-
Release
Cancelled
Procedure Configuration Management Process Description
Code
Produced SW Designer
CM
Production
4 References
[1] IMS: PPP:D for Radio Access Networks Process Handbook, A1R12011
[2] IMS: Regulation of PEPP Process Documents, A1R11401
[3] IMS: Guideline for Configuration Management Plan document, A1R16981
[4] IMS: Electronic Change Request Procedure for SBS, A1R17041
[5] IMS: Error Handling for SBS, A1R17061
[6] A7060-D72-A211-*-35 Gestione Modifiche/Varianti and elementi HW
[7] IMS: Measurement and Analysis Process Description - A1R18911
[8] IMS: Description of CM and SW Support Quality Metrics A1R19371
[9] IMS: Load Generation Process for BSC, TRAU, LMT and OTS A7060-D73-A235-*-7635
[10] IMS: Load Generation Process for BSC, TRAU, LMT using ClearCase A1R19431
[11] IMS: SW Delivery Manual A7060-D73-A236-*-7635
[12] IMS: Object Patch Management W_SBSCM_OBJPATCHMNGT
[13] IMS: Object Patch and Load Delivery Management for SBS Project A7060-D73-A213-*-
7635
[14] IMS: Patch Information Automation A1R16781
[15] IMS: Project Management Guideline A1R17141
ANNEXES
A Abbreviations
CM Configuration Management
CMMI Capability Maturity Model Integration
HW Hardware
IUS Inspected, Updated and Stored
PLP Product Lifecycle Process
PPP:D Product Realization: Development
SW Software
TPL Technical Project Leader