1. Samy Chemli – 2014-06-11

2. Configuration Management - S. Chemli EN-MEF – 2014-06-11 2 Contents Configuration Management Hardware Baseline Change Management of the baseline Naming Layout Database Change Management of the layout database Summary

3. Configuration Management - S. Chemli EN-MEF – 2014-06-11 3 Configuration Management Provides a clear and coherent picture of the status of a project or machine at a given point in time. In order to achieve this, we use three important tools making up the framework Changes to the machines and transfer lines are documented, circulated and approved in the Hardware Baseline (also known as a Product Breakdown Structure) using EDMS We register the layouts of the accelerators and all changes to them within the Layout Database that has to remain up-to-date. Sequence of functional positions = space management Integration and Installation Drawings match the recorded layout to ensure that envelopes of reserved space still match the physical equipment dimensions Naming is critical throughout the lifecycle of the machines/projects. To store and manage naming, we use the Naming Portal

4. Configuration Management - S. Chemli EN-MEF – 2014-06-11 4 Hardware Baseline… …is an EDMS (Engineering Document Management System) based tool. It contains all the information needed to (re-)build the machine, including: Eng. Specifications, Conceptual Specifications, Functional Specifications, Engineering/Technical Notes, Manufacturing Procedures, Test Procedures, Hardware Commissioning Procedures, Market Survey, Invitation to Tender, Engineering Change Requests… Logical structure of nodes, based on hardware types and functions Determine an associated name for each node (equipment, function, layout, service…) Centrally managed by the configuration management write access is restricted read access is granted to project members Question: how to handle a project baseline within a hardware baseline

5. Configuration Management - S. Chemli EN-MEF – 2014-06-11 5 Integrated Baseline In order to answer this question, each node of the baseline tree impacted by the upgrade has been divided into  A node containing the current machine data simply prefixed with ‘Current Machine’ tag  A new node to handle the upgrade documentation and that has been prefixed with a ‘HL’ tag  NB: When possible, this splitting has been done at the lowest possible level  ‘Inner Triplet Assemblies’ and ‘Inner Triplet Quadrupole Assemblies’ remained untouched.

6. Configuration Management - S. Chemli EN-MEF – 2014-06-11 6 Dedicated View Point Nodes of the LHC Baseline dedicated to HL have been grouped into a dedicated tree structure The structure is linked into the main project structure Tree nodes are the one of the hardware baseline… …then document are the ones of the baseline

7. Configuration Management - S. Chemli EN-MEF – 2014-06-11 7 Merging with the operated machine At installation time, the idea is to gather the split nodes and documents back into a single point. Few variants: When the ‘current’ node is no longer needed (e.g. Warm D1 Magnets documentation). The node will be prefixed with ‘former’ and the documents will simply be turned obsolete. When the ‘current’ node is still needed (e.g. current triplet still in use for IR2 and IR8). The description will be modified to get a better match…

8. Configuration Management - S. Chemli EN-MEF – 2014-06-11 8 Change Management of the baseline Now that a baseline has been established, handling changes is done through 2 processes Using Space Reservation Documents – mainly when an Eng. Specification has not been written yet Using Engineering Change Requests (ECRs) in all other cases What for: Inform other stakeholders and get their approval/refusal/comments Impact analysis and space analysis Allow all persons concerned the opportunity to comment about the impact of changes on surrounding equipment or general planning.

9. Configuration Management - S. Chemli EN-MEF – 2014-06-11 9 Where: in the HW baseline for long-term traceability Identify the adequate node in the structure All changes concerning given equipment recorded in the same place in the HW Baseline When: prior to the change taking place Resulting actions: update the HW Baseline (Engineering Specifications, Drawings…) and the Layout Database. Machine/Project Equipment code/category Document type. For example: ES = Engineering Specification, EC = Engineering Change request, TP = Test Procedure etc. Change Management of the baseline

10. Configuration Management - S. Chemli EN-MEF – 2014-06-11 10 Naming Baseline nodes and their related documents are associated with names Names are defined according to Naming Conventions The Quality Assurance Committee – mandated by the Accelerator and Technology Sector – has an action in 2014 to provide an update plan for the general naming conventions, including LHC and HL-LHC For LHC, the LHC-QAP (Plan) is still in use, with caution

11. Configuration Management - S. Chemli EN-MEF – 2014-06-11 11 Naming Baseline nodes and their related documents are associated with names On a practical base, we use the naming portal for accelerators entities and signals For the configuration management, this is the source for all codes in EDMS, CDD, InforEAM/MTF and Layout

12. Configuration Management - S. Chemli EN-MEF – 2014-06-11 12 Naming Accelerator / Project Code Will remain LHC Only equipment code (excludes the variant) 12 char Engineering Drawing Number Baseline nodes and their related documents are associated with names On a practical base, we use the naming portal for accelerators entities and signals For the configuration management, this is the source for all codes in EDMS, CDD, InforEAM/MTF and Layout

13. Configuration Management - S. Chemli EN-MEF – 2014-06-11 13 Naming Accelerator / Project Code Will remain LHC Only equipment code (excludes the variant) 12 char Engineering Drawing Number Additional Title block for external drawings Baseline nodes and their related documents are associated with names On a practical base, we use the naming portal for accelerators entities and signals For the configuration management, this is the source for all codes in EDMS, CDD, InforEAM/MTF and Layout

14. Configuration Management - S. Chemli EN-MEF – 2014-06-11 14 Naming 19 char Physical Equipment – Asset - Number Variants handling Machine Code Will remain HC Baseline nodes and their related documents are associated with names On a practical base, we use the naming portal for accelerators entities and signals For the configuration management, this is the source for all codes in EDMS, CDD, InforEAM/MTF and Layout

15. Configuration Management - S. Chemli EN-MEF – 2014-06-11 15 The Naming Portal The Naming Portal handles the names for the CERN accelerators Service is ensured by BE-CO and EN-MEF URL - https://cern.ch/service-acc-naminghttps://cern.ch/service-acc-naming CERN-Intranet restricted – Please use Remote Desktop to access Mail : Accelerators-Naming.Service@cern.ch

16. Configuration Management - S. Chemli EN-MEF – 2014-06-11 16 The Naming Portal

17. Configuration Management - S. Chemli EN-MEF – 2014-06-11 17 The Naming Portal

18. Configuration Management - S. Chemli EN-MEF – 2014-06-11 18 Layout Database Stores the sequence (layout) of accelerator and transfer line components. Equipment types and details Functional positions for mechanical and electrical layouts Asset names – functional position is exported to MTF database and associated to an asset. Layout just shows the result. Expert name – optional, alternative functional name Updated as a result of ECRs - all past layout information is kept for traceability purposes (database is versioned – see next slides) Functional positions become ‘expired’, not deleted Accessible to all CERN users (CERN IP address) Access: cern.ch/layout or https://layout.web.cern.ch/layout/ Single sign on under discussion/implementation From outside, Remote Desktop mandatory for the moment https://layout.web.cern.ch/layout/

19. Configuration Management - S. Chemli EN-MEF – 2014-06-11 19 Layout Database Navigator with regions and functional position names – distance ordered Pictures from the tunnel Installation Drawing Link

20. Configuration Management - S. Chemli EN-MEF – 2014-06-11 20 Layout Database Latest but not released installation drawing Integration of 360 pictures (on-going)

21. Configuration Management - S. Chemli EN-MEF – 2014-06-11 21 In order to allow parallel evolution of the HL project and the operated machine, the two layouts will be recorded in separate machine representations within the layout database. Modifications to the layout of the machines (using Space Reservations and ECRs) are buffered and grouped into dated versions in the Layout Database. Release notes summarise the modifications between dated versions done to the layout/optics inside the database (see example next slides for the operated machine) This includes mechanical and conceptual layout drawings LHCLSX, LHCLSXG, LHCLSA, LHCLSS for the operated machine LHCLSXH and LHCLSGH for the HL-LHC project And the electrical circuits definition drawings LHCLSD drawing (possibly LHCLSDH) These dated versions are triggered by: Technical Stops (few days), Extended/Winter Technical Stops (2-3 months), Long Shutdowns (e.g. LS1) for the operated machine Technical Coordination and/or Parameters and Layout Committee for the HL project Change Management of the layout

22. Configuration Management - S. Chemli EN-MEF – 2014-06-11 22 Change Management of the layout

23. Configuration Management - S. Chemli EN-MEF – 2014-06-11 23 Change Management of the layout

24. Configuration Management - S. Chemli EN-MEF – 2014-06-11 24 Change Management of the layout

25. Configuration Management - S. Chemli EN-MEF – 2014-06-11 25 Summary The purpose of the Configuration Management is to provide a clear picture of the HL-LHC project and the operated machine at a given point in time. It is achieved through : The usage of a single Hardware Baseline: Centrally managed by the configuration management Separated at the lowest possible level To be reconciled at the end of the project Change Management of the baseline: Engineering Change Requests and Space Reservation Stored in Hardware Baseline not in individual EDMS structures Naming: Important at all stages of the project/machine lifecycle Available on the Naming portal Includes drawing and equipment/assets naming Layout Database: Stores the sequence (layout) of components, including electrical components and circuits. Separate HL and Operated machines Change Management of the layout database: Versioning of the machine and project versions and Release Notes issuing

26. Configuration Management - S. Chemli EN-MEF – 2014-06-11 26 Summary Further information: Naming Service: accelerators-naming.service@cern.chaccelerators-naming.service@cern.ch Naming Portal: https://cern.ch/service-acc-naminghttps://cern.ch/service-acc-naming Layout Service: layout-service@cern.chlayout-service@cern.ch Layout Web Interface: https://layout.web.cern.ch/layout/https://layout.web.cern.ch/layout/ EDMS: https://edms.cern.chhttps://edms.cern.ch Configuration and Change Management of the Accelerators Baselines: ecr- configuration@cern.checr- configuration@cern.ch