diff --git a/docs/turnkey-solution/hardware-landscape.md b/docs/turnkey-solution/hardware-landscape.md new file mode 100644 index 0000000000..286100e51d --- /dev/null +++ b/docs/turnkey-solution/hardware-landscape.md @@ -0,0 +1,62 @@ +--- +sidebar_label: Hardware-Landscape +sidebar_position: 99 +--- + +# The SCS Hardware-Landscape + +## General information + +![An image of the SCS hardware landscape rack](images/combined_rack_visual.jpg "The SCS hardware landscape rack") + +The general aim of this environment is to install and operate the SCS reference implementation on hardware. +In addition to the classic tasks in the area of quality assurance, the environment is also used to evaluate +new concepts in the underlay(overlay network area, as a test environment for hardware-related developments, +as a demonstration environment for interested parties and as a publicly accessible blueprint for users. +The environment is designed for long-term use which a varying circle of users. + +The environment consists of 21 server and 12 switch components. The selection of hardware and the +functions and properties used was designed so that the focus is on generally available or characteristic +functions and dependency on manufacturer-specific functions is avoided. Instead of the x86 servers or SONiC +switches used here, the realised environment could also be realised with hardware from other manufacturers. + +From 1 January 2025, the environment will be operated by [forum SCS-Standards](https://scs.community/2024/10/23/osba-forum-scs-standards/) +and the participating companies. + +## Tasks and Objectives + +The tasks and objectives of the environments can be summarised as follows: + +* The division into several environments makes it possible to run a lab as well as to map a productive environment (near-live operation). +* Operation of the compliance monitor (automated test for conformity with the SCS standards) +* Implementation and validation of the developed standards in a reference environment +* Analysis of problems in the interaction with the standards +* Provision of proof-of-concept installations for interested parties who want to use, promote or further develop the project +* The environment can be used by members of the SCS Standards forum and by contributors to the SCS community + as a development and test environment for open-source development in connection with the further development + of the SCS standards, SCS reference implementation and other relevant software components ('open-lab'/'near-live laboratory'). +* Continuous Integration Environment ('Zuul as a Service') - Operation of non-critical zuul worker instances + +## Installation details + +The available hardware was divided into two distinct application areas: + +* The **lab environment** consists exclusively of switch hardware used to evaluate, test and develop + concepts in the area of 'Software Defined Networking'. This means that various switch models can be + used to test and implement development tasks in the area of the open [SONiC](https://sonicfoundation.dev/) NOS + (a network operating system based on Debian Linux) or provisioning automation tasks in the SONiC environment with the + open-source system Netbox, a solution that is used primarily for IPAM and DCIM (IP Address Management, Data Center Infrastructure Management). +* The **production environment** is an exemplary installation of the relevant or most reference implementations with regard to an + SCS system. It follows a configuration or approach that is based on the needs and circumstances of a real and much larger environment. + To this end, characteristic infrastructure components were automatically installed on the manager nodes used for the installation. + +The setup of the entire environment is designed in such a way that it can be reproducibly restored or reset. +Therefore, the Ansible automation available via OSISM was used in many areas. +Areas that could not be usefully automated using Ansible were implemented using a Python command-line tooling stored in the GIT repository. + +## Available documentation + +The primary point of information and orientation is the [*readme file*](https://github.com/SovereignCloudStack/hardware-landscape?tab=readme-ov-file#references) +which is stored at the top level of the [configuration repository](https://github.com/SovereignCloudStack/hardware-landscape). + +The relevant **References** section refers here to the individual documentation areas. diff --git a/docs/turnkey-solution/images/combined_rack_visual.jpg b/docs/turnkey-solution/images/combined_rack_visual.jpg new file mode 100644 index 0000000000..f3671f035d Binary files /dev/null and b/docs/turnkey-solution/images/combined_rack_visual.jpg differ diff --git a/sidebarsDocs.js b/sidebarsDocs.js index 766062f989..375c30e04e 100644 --- a/sidebarsDocs.js +++ b/sidebarsDocs.js @@ -458,7 +458,10 @@ const sidebarsDocs = { link: { type: 'generated-index' }, - items: ['turnkey-solution/overview'] + items: [ + 'turnkey-solution/overview', + 'turnkey-solution/hardware-landscape' + ] }, { type: 'category',