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