summaryrefslogtreecommitdiffstats
path: root/docs/requirements/userexperience.rst
blob: ff2323779e9f6614cf35f1c1649e2bdaaccd0eea (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
.. Copyright 2015 Open Platform for NFV Project, Inc. and its contributors

.. This work is licensed under the
.. Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0


UX requirements
===============

Releases: OPNFV Brahmaputra and Colorado

Requirements for a common user-experience created by the deployment tools.

High availability requirements
------------------------------
.. Please add the story reference to each requirement.

* `GENESIS-9 <https://jira.opnfv.org/browse/GENESIS-9>`_:
  Brahmaputra and later:
  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.
* `GENESIS-71 <https://jira.opnfv.org/browse/GENESIS-71>`_:
  Brahmaputra and later:
  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
  node cluster.


Network setup and configuration related requirements
----------------------------------------------------
* `GENESIS-20 <https://jira.opnfv.org/browse/GENESIS-20>`_:
  Brahmaputra and later:
  Automatically populate discovered servers into install
  tool (reduce user-intervention to a minimum).
* `GENESIS-28 <https://jira.opnfv.org/browse/GENESIS-28>`_:
  Brahmaputra and later:
  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-43 <https://jira.opnfv.org/browse/GENESIS-43>`_:
  Brahmaputra and later:
  Neutron DHCP servers should be configured in HA per tenant.
* `GENESIS-44 <https://jira.opnfv.org/browse/GENESIS-44>`_:
  Brahmaputra and later:
  SDN Controller layer 3 forwarding support.
* `GENESIS-61 <https://jira.opnfv.org/browse/GENESIS-61>`_:
  Brahmaputra and later:
  Support layer 1/2 networking configuration.
* `GENESIS-62 <https://jira.opnfv.org/browse/GENESIS-62>`_:
  Brahmaputra and later:
  Support logical networks for target system.
* `GENESIS-72 <https://jira.opnfv.org/browse/GENESIS-72>`_:
  Brahmaputra and later:
  Support L3-neutron agent as an option for L3.
* `GENESIS-69 <https://jira.opnfv.org/browse/GENESIS-69>`_:
  Brahmaputra and later:
  Provide isolated compute node resources for CEPH OSD.

Versioning requirements
-----------------------
.. Please add the story reference to each requirement.

* `GENESIS-12 <https://jira.opnfv.org/browse/GENESIS-12>`_:
  Brahmaputra and later:
  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 story reference to each requirement.

* `GENESIS-16 <https://jira.opnfv.org/browse/GENESIS-16>`_:
  Brahmaputra and later:
  Common ability to input site, topology, and server information.
* `GENESIS-17 <https://jira.opnfv.org/browse/GENESIS-17>`_:
  Brahmaputra and later:
  User-configurable parameters available via config files.
* `GENESIS-18 <https://jira.opnfv.org/browse/GENESIS-18>`_:
  Brahmaputra and later:
  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>`_:
  Brahmaputra and later:
  Deployment tool to provide for automatic device discovery.
* `GENESIS-25 <https://jira.opnfv.org/browse/GENESIS-25>`_:
  Brahmaputra and later:
  Installers should configure NTP servers on the servers for clock
  synchronization.
* `GENESIS-40 <https://jira.opnfv.org/browse/GENESIS-40>`_:
  Brahmaputra and later:
  Hardware replacement.

Requirements pertaining to the qualities of the deployment process
------------------------------------------------------------------

* `GENESIS-74 <https://jira.opnfv.org/browse/GENESIS-74>`_:
  Brahmaputra and later:
  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
  all the artifacts considered and required by all the projects
  for Brahmaputra packaged in. Or in other terms and as an example:
  If there are 4 different versions of OVS - all these 4 versions
  would be contained in the "all in one build".
  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).
* `GENESIS-31 <https://jira.opnfv.org/browse/GENESIS-31>`_:
  Brahmaputra and later:
  Installers to be agnostic to type of hard drives used.

Security related requirements
-----------------------------

* `GENESIS-23 <https://jira.opnfv.org/browse/GENESIS-23>`_:
  Brahmaputra and later:
  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>`_:
  Brahmaputra and later:
  Installers should install ssh keys on servers so that key-based login
  can be used for administration.

Testing related requirements
----------------------------
.. Please add the story reference to each requirement.

Installation method related requirements
----------------------------------------

* `GENESIS-39 <https://jira.opnfv.org/browse/GENESIS-39>`_:
  Brahmaputra and later:
  Ability to install with upstream artifacts.
* `GENESIS-38 <https://jira.opnfv.org/browse/GENESIS-38>`_:
  Brahmaputra and later:
  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>`_:
  Brahmaputra and later:
  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
----------------------------------

* `GENESIS-34 <https://jira.opnfv.org/browse/GENESIS-34>`_:
  Brahmaputra and later:
  Installers should provide a user guide.
* `GENESIS-35 <https://jira.opnfv.org/browse/GENESIS-35>`_:
  Brahmaputra and later:
  Installers should provide release notes for an OPNFV release as part of
  the documentation provided.