1b520ff91d151f688de0d72ddc700562a589c99f
[joid.git] / docs / release / scenarios / os-nosdn-nofeature-noha / release-notes.rst
1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
2 .. http://creativecommons.org/licenses/by/4.0
3 .. (c) <optionally add copywriters name>
4
5
6 Abstract
7 ========
8
9 This document compiles the release notes for the Danube release of
10 OPNFV when using JOID as a deployment tool with KVM hypervisor.
11
12 Introduction
13 ============
14
15 These notes provides release information for the use of joid as deployment
16 tool for the Danube release of OPNFV with KVM hypervisor for containers
17 scenario.
18
19 The goal of the Danube release and this JOID based deployment process is
20 to establish a lab ready platform accelerating further development
21 of the OPNFV infrastructure.
22
23 Carefully follow the installation-instructions which guides a user to deploy
24 OPNFV using JOID which is based on MAAS and Juju.
25
26 Summary
27 =======
28
29     KVM (for Kernel-based Virtual Machine) is a full virtualization solution
30 for Linux on x86 hardware containing virtualization extensions (Intel VT or AMD-V).
31 It consists of a loadable kernel module, kvm.ko, that provides the core
32 virtualization infrastructure and a processor specific module, kvm-intel.ko or kvm-amd.ko.
33
34 Danube release with the JOID deployment with KVM hypervisor will establish an
35 OPNFV target system on a Pharos compliant lab infrastructure.
36
37 The current definition of an OPNFV target system is and OpenStack Newton.
38
39     The system is deployed with OpenStack High Availability (HA) for most OpenStack services.
40
41     User has following choices to make to do the deployment.
42
43     - Openstack      -- Newton
44     - Type           -- HA, nonHA, tip (stable git branch of respective openstack)
45     - Feature        -- KVM (hypervisor)
46
47 NOTE: Detailed information on how to install in your lab can be find in installation guide
48 command to deploy lxd feature is:
49
50 #KVM deployment with HA Openstack
51 ./deploy.sh -o newton -f none -t ha -l custom -s nosdn
52
53 #LXD deployment with no HA Openstack
54 ./deploy.sh -o newton -f none -t nonha -l custom -s nosdn
55
56 Using Openstack
57 ===============
58
59 admin-openrc file have been placed under ~/joid_config/
60 Please source the same and use OpenStack API to do rest of the configuration.
61
62
63 Release Data
64 ============
65
66 +--------------------------------------+--------------------------------------+
67 | **Project**                          | JOID                                 |
68 |                                      |                                      |
69 +--------------------------------------+--------------------------------------+
70 | **Repo/tag**                         | gerrit.opnfv.org/gerrit/joid.git     |
71 |                                      | stable/danube                        |
72 +--------------------------------------+--------------------------------------+
73 | **Release designation**              | Danube release                       |
74 |                                      |                                      |
75 +--------------------------------------+--------------------------------------+
76 | **Release date**                     | April 01 2017                        |
77 |                                      |                                      |
78 +--------------------------------------+--------------------------------------+
79 | **Purpose of the delivery**          | Danube release                       |
80 |                                      |                                      |
81 +--------------------------------------+--------------------------------------+
82
83 Deliverables
84 ------------
85
86 Software deliverables
87 ~~~~~~~~~~~~~~~~~~~~~
88 `JOID based installer script files <https://gerrit.opnfv.org/gerrit/gitweb?p=joid.git;a=summary>`_
89
90 Known Limitations, Issues and Workarounds
91 =========================================
92
93 Known issues
94 ------------
95
96 **JIRA TICKETS:**
97
98 +--------------------------------------+--------------------------------------+
99 | **JIRA REFERENCE**                   | **SLOGAN**                           |
100 |                                      |                                      |
101 +--------------------------------------+--------------------------------------+
102 | JIRA:                                |                                      |
103 +--------------------------------------+--------------------------------------+
104
105
106 Scenario Releases
107 =================
108 Name:      joid-os-nosdn-lxd-ha
109 Test Link: https://build.opnfv.org/ci/view/joid/job/joid-os-nosdn-lxd-ha-baremetal-daily-danube/
110 Notes:
111
112 Name:      joid-os-nosdn-lxd-noha
113 Test Link: https://build.opnfv.org/ci/view/joid/job/joid-os-nosdn-lxd-noha-baremetal-daily-danube/
114 Notes:
115
116 References
117 ==========
118 KVM
119 ---
120 - `JUJU Openstack charm <https://jujucharms.com/openstack-telemetry/>`_
121 - `KVM hypervisor <https://help.ubuntu.com/community/KVM/Installation>`_
122
123 Juju
124 ----
125 - `Juju Charm store <https://jujucharms.com/>`_
126 - `Juju documents <https://jujucharms.com/docs/stable/getting-started>`_
127
128 MAAS
129 ----
130 - `Bare metal management (Metal-As-A-Service) <http://maas.io/get-started>`_
131 - `MAAS API documents <http://maas.ubuntu.com/docs/>`_
132
133 JOID
134 ----
135 - `OPNFV JOID wiki <https://wiki.opnfv.org/joid>`_
136 - `OPNFV JOID Get Started <https://wiki.opnfv.org/display/joid/JOID+Get+Started>`_
137
138 OpenStack
139 ---------
140 - `OpenStack Newton Release artifacts <http://www.openstack.org/software/newton>`_
141 - `OpenStack documentation <http://docs.openstack.org>`_
142