From fc3228bd6c2163081143e2231e0574faa9bcaad1 Mon Sep 17 00:00:00 2001 From: Guo Ruijing Date: Tue, 3 May 2016 09:22:42 +0800 Subject: Create fuel kvm plugin Upstream status: NA In Brahmaputra release, KVM plugin functionality was bundled inside the fuel-plugin-qemu. In order for easy maintenance, the KVM plugin functionality would be separated from fuel-plugin-qemu and moved into an independent fuel-plugin-kvm and keep the source code here starting from Colorado release. Change-Id: Id89069234a4529cca40f1887e2d947378f928dd2 Signed-off-by: davidjchou Signed-off-by: Guo Ruijing --- fuel-plugin/README.md | 135 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 135 insertions(+) create mode 100644 fuel-plugin/README.md (limited to 'fuel-plugin/README.md') diff --git a/fuel-plugin/README.md b/fuel-plugin/README.md new file mode 100644 index 000000000..810d8a021 --- /dev/null +++ b/fuel-plugin/README.md @@ -0,0 +1,135 @@ +KVM Plugin for Fuel +================================ + +KVM plugin +----------------------- + +Overview +-------- + +New fuel plugin fuel-plugin-kvm is to deploy KVM enhancements for NFV + +Requirements +------------ + +| Requirement | Version/Comment | +|----------------------------------|-----------------| +| Mirantis OpenStack compatibility | 8.0 | + +Recommendations +--------------- + +None. + +Limitations +----------- + +None. + +Installation Guide +================== + +KVM plugin installation +---------------------------------------- + +1. Clone the fuel-plugin repo from https://gerrit.opnfv.org/gerrit/kvmfornfv/fuel-plugin: + + git clone https://gerrit.opnfv.org/gerrit/kvmfornfv/fuel-plugin + +2. Install the Fuel Plugin Builder: + + pip install fuel-plugin-builder + +3. Build KVM Fuel plugin: + + fpb --build fuel-plugin-kvm/ + +4. The *fuel-plugin-kvm-[x.x.x].rpm* plugin package will be created in the plugin folder. + +5. Move this file to the Fuel Master node with secure copy (scp): + + scp fuel-plugin-kvm-[x.x.x].rpm root@:/tmp + +6. While logged in Fuel Master install the KVM plugin: + + fuel plugins --install fuel-plugin-kvm-[x.x.x].rpm + +7. Check if the plugin was installed successfully: + + fuel plugins + + id | name | version | package_version + ---|------------------|---------|---------------- + 1 | fuel-plugin-kvm | 0.5.2 | 3.0.0 + +8. Plugin is ready to use and can be enabled on the Settings tab of the Fuel web UI. + + +User Guide +========== + +KVM plugin configuration +--------------------------------------------- + +1. Create a new environment with the Fuel UI wizard. +2. Click on the Settings tab of the Fuel web UI. +3. Scroll down the page, select the plugin checkbox. + + +Build options +------------- + +It is possible to modify process of building plugin by setting environment variables. Look into [pre_build_hook file](pre_build_hook) for more details. + +Dependencies +------------ + +If you plan to use plugin in environment without internet access or/and CentOS environment modify build command: + + INCLUDE_DEPENDENCIES=true fpb --build fuel-plugin-kvm/ + +Pre build script will try download required dependencies so it become part of the compiled plugin. + +Note: List of packages for [ubuntu](kvm_package/ubuntu/dependencies.txt) and [centos](kvm_package/centos/dependencies.txt) may need to be modified if packages in centos or ubuntu repositories will change. + +Testing +------- + +None. + +Known issues +------------ + +None. + + + +Development +=========== + +The *OpenStack Development Mailing List* is the preferred way to communicate, +emails should be sent to `openstack-dev@lists.openstack.org` with the subject +prefixed by `[fuel][plugins][kvm]`. + +Reporting Bugs +-------------- + +Bugs should be filled on the [Launchpad fuel-plugins project]( +https://bugs.launchpad.net/fuel-plugins) (not GitHub) with the tag `kvm`. + + +Contributing +------------ + +If you would like to contribute to the development of this Fuel plugin you must +follow the [OpenStack development workflow]( +http://docs.openstack.org/infra/manual/developers.html#development-workflow). + +Patch reviews take place on the [OpenStack gerrit]( +https://review.openstack.org/#/q/status:open+project:stackforge/fuel-plugin-kvm,n,z) +system. + +Contributors +------------ + +* ling.y.yu@intel.com,ruijing.guo@intel.com -- cgit 1.2.3-korg