~narindergupta/opnfv/stable-R2

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
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0
.. (c) <optionally add copywriters name>


Abstract
========

This document compiles the release notes for the Colorado release of
OPNFV when using JOID as a deployment tool with LXD container hypervisor.

Introduction
============

These notes provides release information for the use of joid as deployment
tool for the Colorado release of OPNFV with LXD hypervisor for containers
scenario.

The goal of the Colorado release and this JOID based deployment process is
to establish a lab ready platform accelerating further development
of the OPNFV infrastructure.

Carefully follow the installation-instructions which guides a user to deploy
OPNFV using JOID which is based on MAAS and Juju.

Summary
=======

    LXD is a lightweight container hypervisor for full system containers,
unlike Docker and Rocket which is for application containers. This means that
the container will look and feel like a regular VM – but will act like a
container. LXD uses the same container technology found in the Linux kernel
(cgroups, namespaces, LSM, etc).

Colorado release with the JOID deployment with LXD hypervisor will establish an
OPNFV target system on a Pharos compliant lab infrastructure.
The current definition of an OPNFV target system is and OpenStack Mitaka combined
with LXD Hypervisor.

    The system is deployed with OpenStack High Availability (HA) for most OpenStack services.

    User has following choices to make to do the deployment.

    - Openstack      -- Mitaka
    - Type           -- HA, nonHA, tip (stable git branch of respective openstack)
    - Feature        -- LXD (container hypervisor)

NOTE: Detailed information on how to install in your lab can be find in installation guide
command to deploy lxd feature is:

#LXD deployment with HA Openstack
./deploy.sh -o mitaka -f lxd -t ha -l custom -s nosdn

#LXD deployment with no HA Openstack
./deploy.sh -o mitaka -f lxd -t nonha -l custom -s nosdn

Using LXD with Openstack
========================

Once you have finished installinf the JOID with LXD container hypervisor you can use the
following to uplod your lxd image to the glance server that LXD can use.
In order to do that you simply have to do the following:

wget -O xenial-server-cloudimg-amd64-root.tar.gz \
https://cloud-images.ubuntu.com/xenial/current/xenial-server-cloudimg-amd64-root.tar.gz

glance image-create --name="Xenial LXC x86_64" --visibility=public --container-format=bare \
--disk-format=root-tar --property architecture="x86_64" xenial-server-cloudimg-amd64-root.tar.gz

After you upload the image to glance then you will be ready to go. If you have any questions
please don’t hesitate to ask on the LXC mailing, #lxcontainers IRC channel on freenode


Release Data
============

+--------------------------------------+--------------------------------------+
| **Project**                          | JOID                                 |
|                                      |                                      |
+--------------------------------------+--------------------------------------+
| **Repo/tag**                         | gerrit.opnfv.org/gerrit/joid.git     |
|                                      | stable/colorado                      |
+--------------------------------------+--------------------------------------+
| **Release designation**              | Colorado release                     |
|                                      |                                      |
+--------------------------------------+--------------------------------------+
| **Release date**                     | September 22 2016                    |
|                                      |                                      |
+--------------------------------------+--------------------------------------+
| **Purpose of the delivery**          | Colorado release                     |
|                                      |                                      |
+--------------------------------------+--------------------------------------+

Deliverables
------------

Software deliverables
~~~~~~~~~~~~~~~~~~~~~
`JOID based installer script files <https://gerrit.opnfv.org/gerrit/gitweb?p=joid.git;a=summary>`_

Known Limitations, Issues and Workarounds
=========================================

Known issues
------------

**JIRA TICKETS:**

+--------------------------------------+--------------------------------------+
| **JIRA REFERENCE**                   | **SLOGAN**                           |
|                                      |                                      |
+--------------------------------------+--------------------------------------+
| JIRA: YARDSTICK-325                  | Provide raw format yardstick vm image|
|                                      | for nova-lxd scenario(OPNFV)         |
+--------------------------------------+--------------------------------------+
| JIRA:                                |                                      |
+--------------------------------------+--------------------------------------+


Scenario Releases
=================
Name:      joid-os-nosdn-lxd-ha
Test Link: https://build.opnfv.org/ci/view/joid/job/joid-os-nosdn-lxd-ha-baremetal-daily-colorado/
Notes:

Name:      joid-os-nosdn-lxd-noha
Test Link: https://build.opnfv.org/ci/user/narindergupta/my-views/view/joid/job/joid-os-nosdn-lxd-noha-baremetal-daily-colorado/
Notes:

References
==========
LXD
---
- `JUJU LXD charm <https://jujucharms.com/lxd/xenial/2>`_
- `LXD hypervisor <https://help.ubuntu.com/lts/serverguide/lxd.html>`_
- `LXD Story <http://insights.ubuntu.com/2016/03/14/the-lxd-2-0-story-prologue/>`_

Juju
----
- `Juju Charm store <https://jujucharms.com/>`_
- `Juju documents <https://jujucharms.com/docs/stable/getting-started>`_

MAAS
----
- `Bare metal management (Metal-As-A-Service) <http://maas.io/get-started>`_
- `MAAS API documents <http://maas.ubuntu.com/docs/>`_

JOID
----
- `OPNFV JOID wiki <https://wiki.opnfv.org/joid>`_
- `OPNFV JOID User Guide <https://wiki.opnfv.org/joid/b_userguide>`_
- `OPNFV Release Notes <https://wiki.opnfv.org/display/joid/Colorado+Release+Notes>`_
- `OPNFV JOID Install Guide <https://wiki.opnfv.org/display/joid/Colorado+installation+Guide>`_

OpenStack
---------
- `OpenStack Mitaka Release artifacts <http://www.openstack.org/software/mitaka>`_
- `OpenStack documentation <http://docs.openstack.org>`_