diff options
| author |   Martin Kulhavy <martin.kulhavy@nokia.com> | 2017-08-25 17:19:45 +0300 |
|---|---|---|
| committer | Martin Kulhavy <martin.kulhavy@nokia.com> | 2017-08-25 17:19:45 +0300 |
| commit | 8d638a2bf2afed419767526edac2049f850801f7 (patch) | |
| tree | 773b6a5e1c31b8973d586c9b1ac76dc6cf35b729 /docs/release/installation/installation_virtual.rst | |
| parent | 4b7bbc9613bf8cab6b918b5f97b1712d7a5226bf (diff) | |
Create new consolidated documentation for JOID
The current documentation contains many different versions, which
overlap and partly contradict each other. This makes it very hard for
people with no experience with JOID to deploy it for the first time.
This commit tries to create a new docs structure, merging information
currently spread across different files, while at the same time updating
the information and adding new hints based on the experience deploying
JOID in our lab.
The new docs structure is inspired by and tries to follow the docs
structure used for the APEX installer.
As a next step after finalizing this transformation, the other
overlapping docs directories shall be removed
Change-Id: I7075ea48565a7bd509321a532f1173cffd24cdbc
Signed-off-by: Martin Kulhavy <martin.kulhavy@nokia.com>
Diffstat (limited to 'docs/release/installation/installation_virtual.rst')
| -rw-r--r-- | docs/release/installation/installation_virtual.rst | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/docs/release/installation/installation_virtual.rst b/docs/release/installation/installation_virtual.rst new file mode 100644 index 00000000..58340809 --- /dev/null +++ b/docs/release/installation/installation_virtual.rst @@ -0,0 +1,36 @@ +.. highlight:: bash + + +Virtual Installation +======================= + +The virtual deployment of JOID is very simple and does not require any special +configuration. To deploy a virtual JOID environment follow these few simple +steps: + +1. Install a clean Ubuntu 16.04 (Xenial) server on the machine. You can use + the tips noted in the first step of the :ref:`jumphost-install-os` for + bare metal deployment. However, no specialized configuration is needed, + just make sure you have Internet connectivity. + +2. Run the MAAS deployment for virtual deployment without customized labconfig + file: + + :: + + # in joid/ci directory + ./03-maasdeploy.sh + +3. Run the Juju/OPNFV deployment with your desired configuration parameters, + but with ``-l default -i 1`` for virtual deployment. For example to deploy + the Kubernetes model: + + :: + + # in joid/ci directory + ./deploy.sh -d xenial -s nosdn -t noha -f none -m kubernetes -l default -i 1 + + .. + +Now you should have a working JOID deployment with three virtual nodes. In case +of any issues, refer to the :ref:`troubleshooting` section. |