From 8d638a2bf2afed419767526edac2049f850801f7 Mon Sep 17 00:00:00 2001 From: Martin Kulhavy Date: Fri, 25 Aug 2017 17:19:45 +0300 Subject: 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 --- docs/release/installation/installation_virtual.rst | 36 ++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 docs/release/installation/installation_virtual.rst (limited to 'docs/release/installation/installation_virtual.rst') 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. -- cgit 1.2.3-korg