IIP-Ecosphere Whitepaper IIP-ECOSPHERE PLATFORM HANDBOOK Version 0.20 Holger Eichelberger, Amir Shayan Ahmadian, Andreas Dewes, Marco Ehl, Monika Staciwa, Miguel Gómez Casado White Paper IIP-2021/005 2 IIP-Ecosphere Platform Handbook Disclaimer The contents of this document has been prepared with great carefulness. Although the information has been prepared with the greatest possible care, there is no claim to factual correctness, completeness and/or timeliness of data; in particular, this publication cannot take into account the specific circumstances of individual cases. Any use is therefore the reader's own responsibility. Any liability is excluded. This document contains material that is subject to the copyright of individual or multiple IIP-Ecosphere consortium parties. All rights, including reproduction of parts, are held by the authors. This document reflects only the views of the authors at the time of publication. The Federal Ministry for Economic Affairs and Energy or the responsible project agency are not liable for the use of the information contained herein. Publication: August, 2021 on https://www.iip-ecosphere.eu/ DOI: 10.5281/zenodo.5168946 3 IIP-Ecosphere Platform Handbook Executive Summary The IIP-Ecosphere platform is a central asset developed by the IIP-Ecosphere project. The core aim of the platform is to research and demonstrate novel platform concepts for Industry 4.0, e.g., asset administration shells as interfaces for software components and resources, unified edge deployment, an AI toolkit or seamless configuration of a platform from network settings via services up to applications running on the platform. This platform handbook provides insights into the rationales, ideas and concepts that make up the design and the realization of the IIP-Ecosphere platform, ranging from an overall layered architecture over a detailed discussion of the design and realization state of each layer up to cross-cutting mechanisms such as the configuration model or the related code/artifact generation. This platform handbook addresses the technical side of the platform work in IIP-Ecosphere and builds on the intensive prior work on requirements (usage view and functional/quality requirements of the platform). This handbook shall provide means for deeper technical discussions with partners, stakeholders and interested parties, but also allow for a technical understanding to contribute to the platform, e.g., in terms of protocols, platform connectors, services or demonstration applications. Acknowledgements: We are grateful to Dr. Christian Sauer and Ahmad Alomosh from the Software Systems Engineering Group of the University of Hildesheim for cross-reading this document and providing valuable feedback and ideas for improvement. 4 IIP-Ecosphere Platform Handbook Contents 1 Introduction ................................................................................................................................6 1.1 Motivation and Goals ..........................................................................................................6 1.2 Interaction with other initiatives..........................................................................................7 1.3 Structure of the document ..................................................................................................7 2 Tooling and Basic Technical Decisions .........................................................................................9 3 Architecture .............................................................................................................................. 12 3.1 Overview ........................................................................................................................... 12 3.1.1 Relation to Reference Architectures ........................................................................... 17 3.1.2 Asset Administration Shells ........................................................................................ 18 3.1.3 Virtual Character of the Platform ............................................................................... 19 3.2 Development Streams ....................................................................................................... 19 3.3 Overall Requirements ........................................................................................................ 20 3.4 UML Profiles ...................................................................................................................... 21 3.4.1 IIP-Ecosphere Profile .................................................................................................. 21 3.4.2 UMLSec Profile .......................................................................................................... 27 3.4.3 Security and Privacy Profile ........................................................................................ 28 3.5 Support Layer .................................................................................................................... 32 3.5.1 Asset Administration Shell Abstraction ....................................................................... 32 3.5.2 Network Support ....................................................................................................... 36 3.5.3 Lifecycle Support ....................................................................................................... 36 3.6 Transport and Connection Layer ........................................................................................ 36 3.6.1 Requirements ............................................................................................................ 36 3.6.2 Transport Component ................................................................................................ 38 3.6.3 Connectors Component ............................................................................................. 48 3.6.4 Requirements Discussion ........................................................................................... 56 3.7 Services Layer .................................................................................................................... 58 3.7.1 Terminology and Background ..................................................................................... 58 3.7.2 Requirements ............................................................................................................ 59 3.7.3 Service Environments................................................................................................. 60 3.7.4 Service Control and Management .............................................................................. 65 3.7.5 Requirements Discussion ........................................................................................... 69 3.8 Resources and Monitoring Layer ........................................................................................ 70 3.8.1 ECS runtime ............................................................................................................... 70 3.8.2 Device/Resource Management .................................................................................. 77 3.8.3 Monitoring................................................................................................................. 78 3.9 Security and Data Protection Layer .................................................................................... 79 5 IIP-Ecosphere Platform Handbook 3.10 Reusable Intelligent Services Layer .................................................................................... 79 3.11 Configuration Layer ........................................................................................................... 79 3.12 Application Layer ............................................................................................................... 86 3.13 Platform Server(s).............................................................................................................. 86 4 Architectural Constraints ........................................................................................................... 89 5 Asset Administration Shells ....................................................................................................... 90 6 Platform Configuration Model ................................................................................................... 93 7 Platform Security and Data Protection ...................................................................................... 99 7.1 Internal Security and Security/Privacy Analysis .................................................................. 99 7.2 External Security .............................................................................................................. 101 8 Implementation ...................................................................................................................... 103 8.1 Implementation decisions................................................................................................ 103 8.2 Obtaining the IIP-Ecosphere platform .............................................................................. 104 8.3 Compiling the IIP-Ecosphere platform .............................................................................. 107 8.4 Installing and using the IIP-Ecosphere platform ............................................................... 109 9 How to apply, extend or contribute ........................................................................................