x
/
fuel-plugin-nova-nfs
Code Issues Proposed changes
RETIRED, Fuel plugin for nfs as storage backend for ephemeral volumes (nova)
11 Commits 4 Branches 1 Tag 140 KiB
Go to file
Jenkins 767a222422 Merge "Add validation for plugin settings" 2016-05-02 13:15:19 +00:00
deployment_scripts/puppet Initial implementation of Nova NFS plugin for Fuel 2015-04-28 09:44:02 +02:00
figures Initial implementation of Nova NFS plugin for Fuel 2015-04-28 09:44:02 +02:00
repositories Initial implementation of Nova NFS plugin for Fuel 2015-04-28 09:44:02 +02:00
.gitreview Update .gitreview for new namespace 2015-10-17 22:25:17 +00:00
LICENSE Initial implementation of Nova NFS plugin for Fuel 2015-04-28 09:44:02 +02:00
README.md Inject deployment task into graph for compute role 2016-05-02 07:21:57 +00:00
deployment_tasks.yaml Inject deployment task into graph for compute role 2016-05-02 07:21:57 +00:00
environment_config.yaml Add validation for plugin settings 2016-05-02 09:06:04 +00:00
metadata.yaml Inject deployment task into graph for compute role 2016-05-02 07:21:57 +00:00
pre_build_hook Initial implementation of Nova NFS plugin for Fuel 2015-04-28 09:44:02 +02:00

README.md

Fuel Nova-nfs plugin for Fuel

Nova-nfs plugin

Overview

nova-nfs uses nfs backend to store ephemeral volumes (intances.) This plugin allow to mount a nfs volume and use it as storage backend for Nova. It introduce deployment task which will be rinning on compute role

This repo contains all necessary files to build nova-nfs Fuel plugin.

Requirements

Requirement Version/Comment
Mirantis Openstack compatibility 7.0, 8.0
---------------------------------- ---------------------------------------------------------
NFS Server an NFS server with volume accessible from compute nodes

Recommendations

None.

Limitations

Only one nfs volume can be defined. So in HA deployment compute node will share the same storage backend for instances.

Installation Guide

Nova-nfs plugin installation

  1. Clone the fuel-plugin repo from: https://github.com/stackforge/fuel-plugin-nova-nfs.git

    git clone

  2. Install the Fuel Plugin Builder:

    pip install fuel-plugin-builder

  3. Build nova-nfs Fuel plugin:

    fpb --build fuel-plugin-nova-nfs/

  4. The nova_nfs-<x.x.x>.rpm file will be created in the plugin folder (fuel-plugin-nova-nfs)

  5. Move this file to the Fuel Master node with secure copy (scp):

    scp nova_nfs-<x.x.x>.rpm root@:<the_Fuel_Master_node_IP address>:/tmp cd /tmp

  6. Install the nova-nfs plugin:

    fuel plugins --install nova_nfs-<x.x.x>.rpm

  7. Verify that the plugin is installed correctly: fuel plugins --list

  8. Plugin is ready to use and can be enabled on the Settings tab of the Fuel web UI.

User Guide

Nova-nfs plugin configuration

  1. Create a new environment with the Fuel UI wizard

  2. Add a node with the "Compute" role.

  3. Click on the settings tab of the Fuel web UI

  4. Scroll down the page, select the "Nova-nfs plugin" checkbox and fill-in the requiered fields

    • the nfs volume to store instances
    • the mount point for the nfs volume

Here is a screenshot of the fields

nova-nfs fields

Deployment details

Create mountpoint directory Edit /etc/fstab to add auto mount of NFS volume on the mountpoint Configure Nova to use it as backend for instances Restart nova services

Known issues

The deployment failed if the NFS volume is not available during the deployment

Release Notes

1.0.0

  • Initial release of the plugin

2.0.0

  • Update plugin to Fuel 6.1 release

3.0.0

  • Update plugin to Fuel 7.0 release

3.2.0

  • Update plugin to inject task into deployment graph instead of being run as post-deployment task