updates to use new doc toolchain
[escalator.git] / docs / design / 202-Information_Flows.rst
1 =================
2 Information Flows
3 =================
4
5 This section describes the information flows among the function
6 entities when Escalator is in actions.
7
8 1. Upgrade process of Compute nodes
9
10 1.1 consider VIM as a whole
11
12 .. figure:: images/figure4.png
13    :name: figure4
14    :width: 100%
15
16 process is:
17 1. Operators add new version files on the VIM,initiate the upgrade.
18 2. VIM chooses some compute nodes as the upgrade target nodes, and set them
19 into maintenance mode. VIM queries the list of running VMs on target nodes.
20 3. VIM notice VNFM corresponding to  the virtual machine, to migrate the
21 business.
22 4. VNFM migrates the business. If the business is in active of active-standby
23 mode, it will initiate switch-over. If the business is in loading balance mode,
24 it will move the business to other node.
25 5. After VNFM moves business, it notifies the VIM.
26 6. VIM judges whether the business on the target VM has all been moved. If
27 not, VIM migrates the VM with business loaded to other free nodes. Then VIM
28 upgrades the target computer nodes. After upgrade, VIM set the target compute
29 nodes into normal nodes.
30 7. If there are computer nodes remained to be upgraded, goto step 2.
31
32 4.2 from inside VIM
33
34 .. figure:: images/figure5.png
35    :name: figure5
36    :width: 100%
37
38 .. figure:: images/figure6.png
39    :name: figure6
40    :width: 100%
41
42 process is:
43 1. Upgrade manager receives user operation commands. Add new version files.
44 Upgrade is began.
45 2. Upgrade Manager selects compute node A to Upgrade. Query list of the VMs
46 running the compute nodes A to the Cloud Manager, and set the node to
47 maintenance mode, that is to say creation or migration of new VM on this node
48 is impossible anymore.
49 3. Upgrade Manager notifies VNFM compute node A  into maintenance mode by VIM
50 interface, temporarily disabling the inserting of business, and business on
51 compute node A need move to the other available compute nodes.
52 4. When receives the VNFM reply, or waited for a timeout, Upgrade Manager
53 notifies the system support on compute node A to do software upgrade.
54 5. After upgraded, Upgrade Manager removes maintenance mode for the compute
55 node A.
56 6. Upgrade Manager claims VNFM computing nodes A available.
57 7. Select computer node B to upgrade