Merge "Editorial fixes to requirement document"
[promise.git] / docs / requirements / usecase.rst
1 =======================
2 Use cases and scenarios
3 =======================
4
5 Resource reservation is a basic feature in any virtualization-based network
6 operation. In order to perform such resource reservation from NFVO to VIM, NFVI
7 capacity information is also necessary at the NFVO side. Below, four use cases
8 to show typical requirements and solutions for capacity management and resource
9 reservation is presented. A typical use case as considered for the Brahmaputra
10 release is described in :ref:`uc-brahmaputra`.
11
12 #.  Resource capacity management
13 #.  Resource reservation for immediate use
14 #.  Resource reservation for future use
15 #.  Co-existence of reservations and allocation requests without reservation
16
17 Resource capacity management
18 ============================
19
20 NFVO takes the first decision on in which NFVI it would instantiate a VNF. Along
21 with NFVIs resource attributes (e.g. availability of hardware accelerators,
22 particular CPU architectures etc.), NFVO needs to know available capacity of an
23 NFVI in order to make an informed decision on selecting a particular NFVI. Such
24 capacity information shall be in a coarser granularity than the respective VIM,
25 as VIM maintains capacity information of its NFVI in fine details.  However a
26 very coarse granularity, like simply the number of available virtual CPU cores,
27 may not be sufficient. In order to allow the NFVO to make well founded
28 allocation decisions, an appropriate level to expose the available capacity may
29 be per flavor. Capacity information may be required for the complete NFVI, or
30 per partition or availability zone, or other granularities. Therefore, VIM
31 requires to inform the NFVO about available capacity information regarding its
32 NFVI at a pre-determined abstraction, either by a query-response, or in an
33 event-based, or in a periodical way.
34
35 Resource reservation for immediate use
36 ======================================
37
38 Reservation is inherently for the future. Even if some reserved resources are to
39 be consumed instantly, there is a network latency between the issuance of a
40 resource reservation request from the NFVO, a response from the VIM, and actual
41 allocation of the requested resources to a VNF/VNFM. Within such latency,
42 resource capacity in the NFVI in question could change, e.g., due to failure,
43 allocation to a different request. Therefore, the response from a VIM to the
44 NFVO to a resource reservation request for immediate use should have a validity
45 period which shows until when this VIM can hold the requested resources. During
46 this time, the NFVO should proceed to allocation if it wishes to consume the
47 reserved requested. If allocation is not performed within the validity period,
48 the response from VIM for a particular resource reservation request becomes
49 invalid and VIM is not liable to provide those resources to NFVO/VNFM anymore.
50 Reservations requests for immediate use do not have a start time but may have
51 an end time.
52
53 Resource reservation for future use
54 ===================================
55
56 Network operators may want to reserve extra resources for future use. Such
57 necessity could arise from predicted congestion in telecom nodes e.g. due to
58 local traffic spikes for concerts, natural disasters etc. In such a case, the
59 NFVO, while sending a resource reservation request to the VIM, shall include a
60 start time (and an end time if necessary). The start time indicates at what
61 time the reserved resource shall be available to a designated consumer e.g. a
62 VNF/VNFM. Here, the requirement is that the reserved resources shall be
63 available when the start time arrives. After the start time has arrived, the
64 reserved resources are allocated to the designated consumer(s). An explicit
65 allocation request is needed. How actually these requested resources are held
66 by the VIM for the period in between the arrival of the resource reservation
67 request and the actual allocation is outside the scope of this requirement
68 project.
69
70 Co-existence of reservations and allocation requests without reservation
71 ========================================================================
72
73 In a real environment VIM will have to handle allocation requests without any
74 time reference, i.e. time-unbound, together with time-bound reservations and
75 allocation requests with an explicitly indicated end-time. A granted
76 reservation for the future will effectively reduce the available capacity for
77 any new time-unbound allocation request. The consequence is that reservations,
78 even those far in the future, may result in denial of service for new
79 allocation requests.
80
81 To alleviate this problem several approaches can be taken. They imply an
82 implicit or explicit priority scheme:
83
84 * Allocation requests without reservation and which are time-unbound will be
85   granted resources in a best-effort way: if there is instant capacity, but the
86   resources may be later withdrawn due to the start time of a previously
87   granted reservation
88 * Both allocation requests and reservation requests contain a priority which
89   may be related to SLAs and contractual conditions between the tenant and the
90   NFVI provider. Interactions may look like:
91
92   * A reservation request for future use may cancel another, not yet
93     started, reservation with lower priority
94   * An allocation request without reservations and time-unbound [#unbound]_
95     may be granted resources and prevent a future reservation with lower
96     priority from getting resources at start time
97   * A reservation request may result in terminating resources allocated to a
98     request with no reservation, if the latter has lower priority
99
100 .. [#unbound] In this case, the consumer (VNFM or NFVO) requests to immediately
101               instantiate and assign virtualized resources without having
102               reserved the resources beforehand