KVM4NFV Installation instruction¶

1. Abstract¶

This document will give the instructions to user on how to deploy available KVM4NFV build scenario verfied for the Euphrates release of the OPNFV platform.

2. KVM4NFV Installation Instruction¶

2.1. Preparing the installation¶

The OPNFV project- KVM4NFV (https://gerrit.opnfv.org/gerrit/kvmfornfv.git) is cloned first, to make the build scripts for Qemu & Kernel, Rpms and Debians available.

2.2. HW requirements¶

These build scripts are triggered on the Jenkins-Slave build server. Currently Intel POD10 is used as test environment for kvm4nfv to execute cyclictest. As part of this test environment Intel pod10-jump is configured as jenkins slave and all the latest build artifacts are downloaded on to it. Intel pod10-node1 is the host on which a guest vm will be launched as a part of running cylictest through yardstick.

2.3. Build instructions¶

Builds are possible for the following packages-

kvmfornfv source code

The ./ci/build.sh is the main script used to trigger the Rpms (on ‘centos’) and Debians (on ‘ubuntu’) builds in this case.

How to build Kernel/Qemu Rpms- To build rpm packages, build.sh script is run with -p and -o option (i.e. if -p package option is passed as “centos” or in default case). Example:

cd kvmfornfv/

For Kernel/Qemu RPMs,
sh ./ci/build.sh -p centos -o build_output

How to build Kernel/Qemu Debians- To build debian packages, build.sh script is run with -p and -o option (i.e. if -p package option is passed as “ubuntu”). Example:

cd kvmfornfv/

For Kernel/Qemu Debians,
sh ./ci/build.sh -p ubuntu -o build_output

How to build all Kernel & Qemu, Rpms & Debians- To build both debian and rpm packages, build.sh script is run with -p and -o option (i.e. if -p package option is passed as “both”). Example:

cd kvmfornfv/

For Kernel/Qemu RPMs and Debians,
sh ./ci/build.sh -p both -o build_output

Note

Kvm4nfv can be installed in two ways

As part of a scenario deployment
As a stand alone component

For installation of kvmfornfv as part of scenario deployment use this `link`_

http://artifacts.opnfv.org/kvmfornfv/docs/index.html#document-scenarios/kvmfornfv.scenarios.description

2.4. Installation instructions¶

Installation can be done in the following ways-

1. From kvmfornfv source code- The build packages that are prepared in the above section, are installed differently depending on the platform.

Please visit the links for each-

2. Using Fuel installer-

Please refer to the document present at /fuel-plugin/README.md

2.5. Post-installation activities¶

After the packages are built, test these packages by executing the scripts present in ci/envs for configuring the host and guest respectively.

3. Release Note for KVM4NFV CICD¶

3.1. Abstract¶

This document contains the release notes for the Euphrates release of OPNFV when using KVM4NFV CICD process.

3.2. Introduction¶

Provide a brief introduction of how this configuration is used in OPNFV release using KVM4VFV CICD as scenario.

Be sure to reference your scenario installation instruction.

3.3. Release Data¶

Project	NFV Hypervisors-KVM
Repo/tag	kvmfornfv
Release designation
Release date	2017-10-06
Purpose of the delivery	Automate the KVM4VFV CICD scenario Executing latency test cases Collection of logs for debugging

3.4. Document version change¶

The following documents are added-

configurationguide
installationprocedure
userguide
overview
glossary
releasenotes

3.5. Reason for new version¶

3.5.1. Feature additions¶

JIRA REFERENCE	SLOGAN
JIRA:	NFV Hypervisors-KVMFORNFV-72
JIRA:	NFV Hypervisors-KVMFORNFV-73
JIRA:	NFV Hypervisors-KVMFORNFV-78
JIRA:	NFV Hypervisors-KVMFORNFV-86
JIRA:	NFV Hypervisors-KVMFORNFV-87
JIRA:	NFV Hypervisors-KVMFORNFV-88
JIRA:	NFV Hypervisors-KVMFORNFV-89
JIRA:	VSPERF-510
JIRA:	YARDSTICK-783
JIRA:	YARDSTICK-815

3.6. Known issues¶

JIRA TICKETS:

JIRA REFERENCE	SLOGAN

3.7. Workarounds¶

See JIRA: https://jira.opnfv.org/projects

For more information on the OPNFV Euphrates release, please visit http://www.opnfv.org/euphrates