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>
9 This document compiles the release notes for the Fraser release of
10 OPNFV when using JOID as a deployment tool with LXD container hypervisor.
15 These notes provides release information for the use of joid as deployment
16 tool for the Fraser release of OPNFV with LXD hypervisor for containers
19 The goal of the Fraser release and this JOID based deployment process is
20 to establish a lab ready platform accelerating further development
21 of the OPNFV infrastructure.
23 Carefully follow the installation-instructions which guides a user to deploy
24 OPNFV using JOID which is based on MAAS and Juju.
29 LXD is a lightweight container hypervisor for full system containers,
30 unlike Docker and Rocket which is for application containers. This means that
31 the container will look and feel like a regular VM – but will act like a
32 container. LXD uses the same container technology found in the Linux kernel
33 (cgroups, namespaces, LSM, etc).
35 Fraser release with the JOID deployment with LXD hypervisor will establish an
36 OPNFV target system on a Pharos compliant lab infrastructure.
37 The current definition of an OPNFV target system is and OpenStack Pike combined
40 The system is deployed with OpenStack High Availability (HA) for most OpenStack services.
42 User has following choices to make to do the deployment.
45 - Type -- HA, nonHA, tip (stable git branch of respective openstack)
46 - Feature -- LXD (container hypervisor)
48 NOTE: Detailed information on how to install in your lab can be find in installation guide
49 command to deploy lxd feature is:
51 #LXD deployment with HA Openstack
52 ./deploy.sh -o pike -f lxd -t ha -l custom -s nosdn
54 #LXD deployment with no HA Openstack
55 ./deploy.sh -o pike -f lxd -t noha -l custom -s nosdn
57 Using LXD with Openstack
58 ========================
60 Once you have finished installinf the JOID with LXD container hypervisor you can use the
61 following to uplod your lxd image to the glance server that LXD can use.
62 In order to do that you simply have to do the following:
64 wget -O xenial-server-cloudimg-amd64-root.tar.gz \
65 https://cloud-images.ubuntu.com/xenial/current/xenial-server-cloudimg-amd64-root.tar.gz
67 glance image-create --name="Xenial LXC x86_64" --visibility=public --container-format=bare \
68 --disk-format=root-tar --property architecture="x86_64" xenial-server-cloudimg-amd64-root.tar.gz
70 After you upload the image to glance then you will be ready to go. If you have any questions
71 please don’t hesitate to ask on the LXC mailing, #lxcontainers IRC channel on freenode
77 +--------------------------------------+--------------------------------------+
78 | **Project** | JOID |
80 +--------------------------------------+--------------------------------------+
81 | **Repo/tag** | gerrit.opnfv.org/gerrit/joid.git |
83 +--------------------------------------+--------------------------------------+
84 | **Release designation** | Fraser release |
86 +--------------------------------------+--------------------------------------+
87 | **Release date** | April 27 2018 |
89 +--------------------------------------+--------------------------------------+
90 | **Purpose of the delivery** | Fraser release |
92 +--------------------------------------+--------------------------------------+
99 `JOID based installer script files <https://gerrit.opnfv.org/gerrit/gitweb?p=joid.git;a=summary>`_
101 Known Limitations, Issues and Workarounds
102 =========================================
109 +--------------------------------------+--------------------------------------+
110 | **JIRA REFERENCE** | **SLOGAN** |
112 +--------------------------------------+--------------------------------------+
113 | JIRA: YARDSTICK-325 | Provide raw format yardstick vm image|
114 | | for nova-lxd scenario(OPNFV) |
115 +--------------------------------------+--------------------------------------+
117 +--------------------------------------+--------------------------------------+
122 Name: joid-os-nosdn-lxd-ha
123 Test Link: https://build.opnfv.org/ci/view/joid/job/joid-os-nosdn-lxd-ha-baremetal-daily-fraser/
126 Name: joid-os-nosdn-lxd-noha
127 Test Link: https://build.opnfv.org/ci/view/joid/job/joid-os-nosdn-lxd-noha-baremetal-daily-fraser/
134 - `JUJU LXD charm <https://jujucharms.com/lxd/xenial/2>`_
135 - `LXD hypervisor <https://help.ubuntu.com/lts/serverguide/lxd.html>`_
136 - `LXD Story <http://insights.ubuntu.com/2016/03/14/the-lxd-2-0-story-prologue/>`_
140 - `Juju Charm store <https://jujucharms.com/>`_
141 - `Juju documents <https://jujucharms.com/docs/stable/getting-started>`_
145 - `Bare metal management (Metal-As-A-Service) <http://maas.io/get-started>`_
146 - `MAAS API documents <http://maas.ubuntu.com/docs/>`_
150 - `OPNFV JOID wiki <https://wiki.opnfv.org/joid>`_
151 - `OPNFV JOID Get Started <https://wiki.opnfv.org/display/joid/JOID+Get+Started>`_
155 - `OpenStack Pike Release artifacts <http://www.openstack.org/software/pike>`_
156 - `OpenStack documentation <http://docs.openstack.org>`_