diff options
Diffstat (limited to 'docs/sources')
| -rw-r--r-- | docs/sources/system-requirements.rst | 52 | ||||
| -rw-r--r-- | docs/sources/ux-requirements.rst | 141 |
2 files changed, 92 insertions, 101 deletions
diff --git a/docs/sources/system-requirements.rst b/docs/sources/system-requirements.rst index bbf916a..ca7af03 100644 --- a/docs/sources/system-requirements.rst +++ b/docs/sources/system-requirements.rst @@ -24,59 +24,49 @@ Target system requirements Release: OPNFV Brahmaputra -This document lists requirements for the target system that an installer creates. Different from the requirements document on user-experience, this document focuses on the key hardware and software components the different deployment tools install and/or configure. +This document lists requirements for the target system that +an installer creates. Different from the requirements document +on user-experience, this document focuses on the key hardware +and software components the different deployment tools install +and/or configure. -Hardware components -------------------- -.. Please add the Jira story reference to each requirement. - Note that the below listed "GENESIS-1" Jira story are place holders - and are to be changed for the actual Jira reference. - - -Software components -------------------- -.. Please add the Jira story to each requirement as reference. Minimum base Operating System distribution supported: ===================================================== -`GENESIS-4 <https://jira.opnfv.org/browse/GENESIS-4>`_: Installers support either Centos 7 or -Ubuntu 14.04 as target system base OS + +* `GENESIS-4 <https://jira.opnfv.org/browse/GENESIS-4>`_: + Installers should support either Centos 7 or Ubuntu 14.04 + as target system base OS. Components/features installed for OpenStack: ============================================ -`GENESIS-53 <https://jira.opnfv.org/browse/GENESIS-53>`_: OpenStack Heat should be installed. +* `GENESIS-53 <https://jira.opnfv.org/browse/GENESIS-53>`_: + OpenStack Heat should be installed. Minimum base OpenStack distribution supported: ============================================== -`GENESIS-7 <https://jira.opnfv.org/browse/GENESIS-7>`_: Installers must support OpenStack Liberty -release + +* `GENESIS-7 <https://jira.opnfv.org/browse/GENESIS-7>`_: + Installers should support OpenStack Liberty release. SDN Controller: =============== -`GENESIS-6 <https://jira.opnfv.org/browse/GENESIS-6>`_: Installers support -OpenDaylight Lithium Release - -`GENESIS-49 <https://jira.opnfv.org/browse/GENESIS-49>`_: Installers support for ONOSFW +* `GENESIS-6 <https://jira.opnfv.org/browse/GENESIS-6>`_: + Installers should support OpenDaylight Lithium Release. +* `GENESIS-49 <https://jira.opnfv.org/browse/GENESIS-49>`_: + Installers should support ONOSFW. VM Controller: ============== Hypervisor: =========== -`GENESIS-8 <https://jira.opnfv.org/browse/GENESIS-8>`_: KVM Support + +* `GENESIS-8 <https://jira.opnfv.org/browse/GENESIS-8>`_: + Installers should support KVM hypervisor. Virtual forwarder: ================== - - -Installer Documentation: -======================== - -`GENESIS-34 <https://jira.opnfv.org/browse/GENESIS-34`_: Installers should provide a user guide - -`GENESIS-35 <https://jira.opnfv.org/browse/GENESIS-35`_: Installers should provide release notes for an OPNFV release as part of the documentation provided - - diff --git a/docs/sources/ux-requirements.rst b/docs/sources/ux-requirements.rst index 0076f1f..a41995e 100644 --- a/docs/sources/ux-requirements.rst +++ b/docs/sources/ux-requirements.rst @@ -26,21 +26,17 @@ Release: OPNFV Brahmaputra Requirements for a common user-experience created by the deployment tools. - - High availability requirements ------------------------------ -.. Please add the Jira story reference to each requirement. - Note that the below listed "GENESIS-3" Jira story are place holders - and are to be changed for the actual Jira reference. +.. Please add the story reference to each requirement. -* `Jira GENESIS-3 <https://jira.opnfv.org/browse/GENESIS-3>`_: new requirement... -* `Jira GENESIS-9 <https://jira.opnfv.org/browse/GENESIS-9>`_: The installer shall support the - deployment of OpenStack with High-Availability (for those components that support it in - Liberty) on 3 or more control nodes. Functest tests should be able to verify that the HA is - enabled and functional. +* `GENESIS-9 <https://jira.opnfv.org/browse/GENESIS-9>`_: + Installers shall support the deployment of OpenStack with + High-Availability (for those components that support it in + Liberty) on 3 or more control nodes. Functest tests should + be able to verify that the HA is enabled and functional. -* `Jira GENESIS-71 <https://jira.opnfv.org/browse/GENESIS-71>`_: new requirement +* `GENESIS-71 <https://jira.opnfv.org/browse/GENESIS-71>`_: Hitless hardware upgrade: Increase size of a deployment in terms of compute nodes (add additional compute nodes) without service interruption. This requirement doesn't mandate upgrade/increasing the size of the control @@ -49,65 +45,65 @@ High availability requirements Network setup and configuration related requirements ---------------------------------------------------- -* `Jira GENESIS-20 <https://jira.opnfv.org/browse/GENESIS-20>`_: Automatically populate - discovered servers into install tool (reduce user-intervention to a minimum). +* `GENESIS-20 <https://jira.opnfv.org/browse/GENESIS-20>`_: + Automatically populate discovered servers into install + tool (reduce user-intervention to a minimum). -* `Jira GENESIS-28 <https://jira.opnfv.org/browse/GENESIS-28>`_: Installers should support - a common configuration file (e.g. kickstart file) per platform/role, so that the installed - OS can be customized for hardware and role. +* `GENESIS-28 <https://jira.opnfv.org/browse/GENESIS-28>`_: + Installers should support a common configuration file (e.g. kickstart file) + per platform/role, so that the installed OS can be customized + for hardware and role. -* `Jira GENESIS-43 <https://jira.opnfv.org/browse/GENESIS-43>`_: Neutron DHCP servers should - be configured in HA per tenant +* `GENESIS-43 <https://jira.opnfv.org/browse/GENESIS-43>`_: + Neutron DHCP servers should be configured in HA per tenant. -* `Jira GENESIS-44 <https://jira.opnfv.org/browse/GENESIS-44>`_: SDN Controller Layer 3 forwarding support +* `GENESIS-44 <https://jira.opnfv.org/browse/GENESIS-44>`_: + SDN Controller layer 3 forwarding support. -* `Jira GENESIS-61 <https://jira.opnfv.org/browse/GENESIS-61>`_: Supported Layer 1/2 Networking - Configurations +* `GENESIS-61 <https://jira.opnfv.org/browse/GENESIS-61>`_: + Support layer 1/2 networking configuration. -* `Jira GENESIS-62 <https://jira.opnfv.org/browse/GENESIS-62>`_: Supported Logical Networks for - Target System +* `GENESIS-62 <https://jira.opnfv.org/browse/GENESIS-62>`_: + Support logical networks for target system. -* `Jira GENESIS-72 <https://jira.opnfv.org/browse/GENESIS-72`_: Support L3-neutron agent - as an option for L3 +* `GENESIS-72 <https://jira.opnfv.org/browse/GENESIS-72>`_: + Support L3-neutron agent as an option for L3. -* `Jira GENESIS-69 <https://jira.opnfv.org/browse/GENESIS-69`_: Provide isolated compute node - resources for CEPH OSD +* `GENESIS-69 <https://jira.opnfv.org/browse/GENESIS-69>`_: + Provide isolated compute node resources for CEPH OSD. Versioning requirements ----------------------- -.. Please add the Jira story reference to each requirement. - Note that the below listed "GENESIS-3" Jira stories are place holders - and are to be changed for the actual Jira reference. +.. Please add the story reference to each requirement. -* `Jira GENESIS-3 <https://jira.opnfv.org/browse/GENESIS-3>`_: new requirement... -* `Jira GENESIS-12 <https://jira.opnfv.org/browse/GENESIS-12>`_: Installers should track/control - all versions of all components pulled from external sources (user should be able to identify +* `GENESIS-12 <https://jira.opnfv.org/browse/GENESIS-12>`_: + Installers should track/control all versions of all components pulled + from external sources (user should be able to identify the versions and origins of all software components deployed). System definition and system configuration requirements ------------------------------------------------------- -.. Please add the Jira story reference to each requirement. - Note that the below listed "GENESIS-3" Jira stories are place holders - and are to be changed for the actual Jira reference. - -* `Jira GENESIS-3 <https://jira.opnfv.org/browse/GENESIS-3>`_: new requirement... -* `Jira GENESIS-16 <https://jira.opnfv.org/browse/GENESIS-16>`_: Common ability to input site, - topology, and server information. -* `Jira GENESIS-17 <https://jira.opnfv.org/browse/GENESIS-17>`_: User-configurable parameters - available via config files. -* `Jira GENESIS-18 <https://jira.opnfv.org/browse/GENESIS-18>`_: Allow assignment of different roles - to servers, so that hardware and software can be configured according to the role. -* `Jira GENESIS-19 <https://jira.opnfv.org/browse/GENESIS-19>`_: +.. Please add the story reference to each requirement. + +* `GENESIS-16 <https://jira.opnfv.org/browse/GENESIS-16>`_: + Common ability to input site, topology, and server information. +* `GENESIS-17 <https://jira.opnfv.org/browse/GENESIS-17>`_: + User-configurable parameters available via config files. +* `GENESIS-18 <https://jira.opnfv.org/browse/GENESIS-18>`_: + Allow assignment of different roles to servers, so that hardware and + software can be configured according to the role. +* `GENESIS-19 <https://jira.opnfv.org/browse/GENESIS-19>`_: Deployment tool to provide for automatic device discovery. -* `Jira GENESIS-25 <https://jira.opnfv.org/browse/GENESIS-25`_: +* `GENESIS-25 <https://jira.opnfv.org/browse/GENESIS-25>`_: Installers should configure NTP servers on the servers for clock synchronization. -* `Jira GENESIS-40 <https://jira.opnfv.org/browse/GENESIS-40>`_: Hardware replacement +* `GENESIS-40 <https://jira.opnfv.org/browse/GENESIS-40>`_: + Hardware replacement. Requirements pertaining to the qualities of the deployment process ------------------------------------------------------------------ -* `Jira GENESIS-74 <https://jira.opnfv.org/browse/GENESIS-74>`_: +* `GENESIS-74 <https://jira.opnfv.org/browse/GENESIS-74>`_: Installers which create a build for Brahmaputra, should create the build as an "all-in-one" build. The the build process of the installer creates a single entity (e.g. ISO) - which has @@ -118,43 +114,48 @@ Requirements pertaining to the qualities of the deployment process Note: This requirement only applies to installers which support a "build" phase (i.e. create a bootable image, like an iso-image from the different artifacts required). -* `Jira GENESIS-31 <https://jira.opnfv.org/browse/GENESIS-31>`_: Installers to be agnostic to - type of hard drives used +* `GENESIS-31 <https://jira.opnfv.org/browse/GENESIS-31>`_: + Installers to be agnostic to type of hard drives used. Security related requirements ----------------------------- -.. Please add the Jira story reference to each requirement. - Note that the below listed "GENESIS-3" Jira stories are place holders - and are to be changed for the actual Jira reference. -* `Jira GENESIS-3 <https://jira.opnfv.org/browse/GENESIS-3>`_: new requirement... -* `Jira GENESIS-23 <https://jira.opnfv.org/browse/GENESIS-23>`_: Enable Mandatory Access Control by default. Installer should enable MAC either using SElinux or AppArmour. -* `Jira GENESIS-24 <https://jira.opnfv.org/browse/GENESIS-24>`_: Installers should install ssh keys on servers so that key-based login can be used for administration +* `GENESIS-23 <https://jira.opnfv.org/browse/GENESIS-23>`_: + Installers should enable Mandatory Access Control by default. + Installers should enable MAC either using SElinux or AppArmour. +* `GENESIS-24 <https://jira.opnfv.org/browse/GENESIS-24>`_: + Installers should install ssh keys on servers so that key-based login + can be used for administration. Testing related requirements ---------------------------- -.. Please add the Jira story reference to each requirement. - Note that the below listed "GENESIS-3" Jira stories are place holders - and are to be changed for the actual Jira reference. - -* `Jira GENESIS-3 <https://jira.opnfv.org/browse/GENESIS-3>`_: new requirement... +.. Please add the story reference to each requirement. Installation method related requirements ---------------------------------------- -* `Jira GENESIS-39 <https://jira.opnfv.org/browse/GENESIS-39>`_: Ability to install with upstream - artifacts. +* `GENESIS-39 <https://jira.opnfv.org/browse/GENESIS-39>`_: + Ability to install with upstream artifacts. -* `Jira GENESIS-38 <https://jira.opnfv.org/browse/GENESIS-38>`_: Installers should supply a script or set of scripts ("deploy.sh") to automatically install the jumphost (from there, the entire OPNFV system is automatically installed). - -* `Jira GENESIS-42 <https://jira.opnfv.org/browse/GENESIS-42>`: Requirement: Support deployment offline. Jump host may have Internet access, but the installers should support offline installation on target hosts during the deployment phase. (either manual or automatic) +* `GENESIS-38 <https://jira.opnfv.org/browse/GENESIS-38>`_: + Installers should supply a script or set of scripts ("deploy.sh") to + automatically install the jumphost (from there, the + entire OPNFV system is automatically installed). +* `GENESIS-42 <https://jira.opnfv.org/browse/GENESIS-42>`_: + Installers should support offline deployment. Jump host may have + Internet access, but the installers should support offline + installation on target hosts during the deployment phase (either + manually or automatically). Documentation related requirements ---------------------------------- -.. Please add the Jira story reference to each requirement. - Note that the below listed "GENESIS-3" Jira stories are place holders - and are to be changed for the actual Jira reference. -* `Jira GENESIS-3 <https://jira.opnfv.org/browse/GENESIS-3>`_: new requirement... +* `GENESIS-34 <https://jira.opnfv.org/browse/GENESIS-34>`_: + Installers should provide a user guide. + +* `GENESIS-35 <https://jira.opnfv.org/browse/GENESIS-35>`_: + Installers should provide release notes for an OPNFV release as part of + the documentation provided. + |