From 4fbd57151a67c0d99082f884523953b3e6bdd39e Mon Sep 17 00:00:00 2001 From: Luc Provoost Date: Mon, 30 Nov 2020 15:36:18 +0100 Subject: SampleVNF Jerma documentation update Some more documentation updates for the Jerma release. Change-Id: I0626ae2ac18dd858f6d1e5fa341371aca6ec639d Signed-off-by: Luc Provoost --- docs/testing/user/userguide/03-installation.rst | 48 +++++++++++++++++++++++++ 1 file changed, 48 insertions(+) (limited to 'docs/testing/user/userguide/03-installation.rst') diff --git a/docs/testing/user/userguide/03-installation.rst b/docs/testing/user/userguide/03-installation.rst index dc40e8e0..2ce4ceda 100644 --- a/docs/testing/user/userguide/03-installation.rst +++ b/docs/testing/user/userguide/03-installation.rst @@ -83,8 +83,15 @@ this will involve some manual file copying. Step 2: Clone the samplevnf project on that machine ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +<<<<<<< HEAD :: git clone https://git.opnfv.org/samplevnf +======= +.. code-block:: console + + git clone https://git.opnfv.org/samplevnf + +>>>>>>> Jerma documentation rewrite Go to the relevant directory in this repository: samplevnf/VNFs/DPPD-PROX/helper-scripts/rapid/ Step 3: Deploy the testing VMs @@ -95,6 +102,7 @@ will have all information needed to run the actual test. You can do this step ma platforms (OpenStack, VMWare, K8s, bare metal, ...), but the automation tools described in the rest of this paragraph will using OpenStack Heat yaml files. First, a PROX qcow2 image needs to be downloaded. +<<<<<<< HEAD :: wget http://artifacts.opnfv.org/samplevnf/jerma/prox_jerma.qcow2 This image can also be created mannualy by following instructions in https://wiki.opnfv.org/display/SAM/Rapid+scripting, @@ -106,6 +114,25 @@ Now run createrapid.sh to create the stack. This process takes the config_file a https://wiki.opnfv.org/display/SAM/Rapid+scripting, in the section "Deploying the VMs" :: ./createrapid.sh +======= +.. code-block:: console + + wget http://artifacts.opnfv.org/samplevnf/jerma/prox_jerma.qcow2 + +This image can also be created mannualy by following instructions in https://wiki.opnfv.org/display/SAM/Rapid+scripting, +in the section "Creating an image" +Now upload this image to Openstack: +.. code-block:: console + + openstack image` create --disk-format qcow2 --container-format bare --file prox_jerma.qcow2 rapidVM + +Now run createrapid.sh to create the stack. This process takes the config_file as input. Details can be found in +https://wiki.opnfv.org/display/SAM/Rapid+scripting, in the section "Deploying the VMs" +.. code-block:: console + + ./createrapid.sh + +>>>>>>> Jerma documentation rewrite At the end of this step, VMs should be running and the rapid.env and rapid_key.pem files should be available. Step 4: Deploy your own Xtesting toolchain @@ -113,7 +140,12 @@ Step 4: Deploy your own Xtesting toolchain Install Xtesting as described in https://xtesting.readthedocs.io/en/latest/ First goto the xtesting directory in samplevnf/VNFs/DPPD-PROX/helper-scripts/rapid/xtesting (this was cloned in step 2) +<<<<<<< HEAD :: +======= +.. code-block:: console + +>>>>>>> Jerma documentation rewrite virtualenv xtesting . xtesting/bin/activate pip install ansible @@ -124,12 +156,28 @@ in step 2) Step 5: Build the test container that will drive the TST009 testing ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +<<<<<<< HEAD :: +======= +Go to the directory samplevnf/VNFs/DPPD-PROX/helper-scripts/rapid/xtesting +While building this container, some files will be copied into the container image. Two of these files +are generated by Step 3: rapid.env and rapid_key.pem and reside in the samplevnf/VNFs/DPPD-PROX/helper-scripts/rapid/. +PLease copy them into the xtesting directory. +The 3rd file that will be copied is testcases.yaml. You might want to modify this file according to the testing you would +like to execute. +.. code-block:: console + +>>>>>>> Jerma documentation rewrite docker build -t 127.0.0.1:5000/rapidxt . Step 6: Publish your container on your local repository ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +<<<<<<< HEAD :: +======= +.. code-block:: console + +>>>>>>> Jerma documentation rewrite docker push 127.0.0.1:5000/rapidxt You are now ready to execute the testing -- cgit 1.2.3-korg