document update for Fraser release.
[joid.git] / docs / release / installation / introduction.rst
1 Introduction
2 ============
3
4 JOID in brief
5 -------------
6 JOID as *Juju OPNFV Infrastructure Deployer* allows you to deploy different
7 combinations of OpenStack release and SDN solution in HA or non-HA mode. For
8 OpenStack, JOID currently supports Ocata and Pike. For SDN, it supports
9 Openvswitch, OpenContrail, OpenDayLight, and ONOS. In addition to HA or non-HA
10 mode, it also supports deploying from the latest development tree.
11
12 JOID heavily utilizes the technology developed in Juju and MAAS.
13
14 Juju_ is a state-of-the-art, open source modelling tool for operating software
15 in the cloud. Juju allows you to deploy, configure, manage, maintain, and scale
16 cloud applications quickly and efficiently on public clouds, as well as on
17 physical servers, OpenStack, and containers. You can use Juju from the command
18 line or through its beautiful `GUI <JUJU GUI_>`_.
19 (source: `Juju Docs <https://jujucharms.com/docs/2.2/about-juju>`_)
20
21 MAAS_ is *Metal As A Service*. It lets you treat physical servers like virtual
22 machines (instances) in the cloud. Rather than having to manage each server
23 individually, MAAS turns your bare metal into an elastic cloud-like resource.
24 Machines can be quickly provisioned and then destroyed again as easily as you
25 can with instances in a public cloud. ... In particular, it is designed to work
26 especially well with Juju, the service and model management service. It's a
27 perfect arrangement: MAAS manages the machines and Juju manages the services
28 running on those machines.
29 (source: `MAAS Docs <https://docs.ubuntu.com/maas/2.1/en/index>`_)
30
31 Typical JOID Architecture
32 -------------------------
33 The MAAS server is installed and configured on Jumphost with Ubuntu 16.04 LTS
34 server with access to the Internet. Another VM is created to be managed by
35 MAAS as a bootstrap node for Juju. The rest of the resources, bare metal or
36 virtual, will be registered and provisioned in MAAS. And finally the MAAS
37 environment details are passed to Juju for use.
38
39 .. TODO: setup diagram
40
41
42 .. Links:
43 .. _Juju: https://jujucharms.com/
44 .. _`JUJU GUI`: https://jujucharms.com/docs/stable/controllers-gui
45 .. _MAAS: https://maas.io/