fuel-plugin-plumgrid/doc/plugin_guide/source/install_guide.rst

Installation Guide

Prerequisites

This document assumes that you have installed Fuel and setup the target hosts with appropriate networking for the pxe, management, public and plumgrid-fabric networks. The nodes must be discovered and functional prior to doing the following steps.

Obtain a PLUMgrid ONS license and access to packages or LCM image by emailing Support at info@plumgrid.com.

Installing Fuel PLUMgrid Plugin

1. Download the PLUMgrid plugin from the Fuel Plugins Catalog.

2. Copy this file to the Fuel Master node with secure copy (scp): :

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

3. On the Fuel Master node, Install the PLUMgrid plugin with: :

   cd /tmp
   fuel plugins --install plumgrid-<x.x.x>.rpm

   You should get the following output: :

   Plugin <plugin-name-version>.rpm was successfully installed

4. Check that the correct version of the PLUMgrid plugin is installed in Fuel with: :

   fuel plugins --list

5. The plugin is now ready for use and can be enabled on the Settings tab, PLUMgrid Plugin section of the Fuel web UI, as explained next.

Configuring a New Environment

1. In Fuel UI create environment.

   

2. Select the appropiate KVM or QEMU hypervisor type for your environment.

   

3. Select Neutron with VLAN segmentation as Networking Setup.

   

Configuring PLUMgrid Plugin

1. After creating the enviroment, navigate to Settings → Fuel PLUMgrid plugin. Check the Fuel PLUMgrid Pluginbox and fill in the appropiate values for the enviroment.

   

• Enter the username for PLUMgrid: default is plumgrid
• Enter the password for PLUMgrid: default is plumgrid
• PLUMgrid VIP on the management network to access the PLUMgrid console:  The IP address for PLUMgrid console, make sure to select an unassigned IP on the management network.
• Enter the PLUMgrid Fabric Network: Enter the network that will be used by PLUMgrid Fabric.
• Repository for PLUMgrid packages: Enter IP address of a repo hosting PLUMgrid packages such as LCM.
• Enter the zone name for PLUMgrid LCM: If using an LCM enter the zone name specified during its configuration.
• Enter the license for PLUMgrid: Enter the PLUMgrid license string provided by PLUMgrid support.
• Enter the interface(s) to be used by GW: Enter the interfaces that will be used for external connectivity by the PLUMgrid Gateway, comma separated for more than one.

Deployment Settings

1. Navigate to Repositories tab and click Add Extra Repo and provide the following PLUMgrid repositories: :

   plumgrid           deb http://<LCM-IP>:81/plumgrid plumgrid <component>         1200
   plumgrid-images    deb http://<LCM-IP>:81/plumgrid-images plumgrid <component>  1250

   

2. Navigate to the Nodes tab and click on Add nodes:

   

   Assign the unallocated nodes their respective roles. Select the role i.e. Controller/Compute/PLUMgrid-Gateway and select the node which will assume that role. This process must be repeated for every node individually:

   

3. As described in the Requirements section, configure interfaces on nodes as shown in figure below:

   

4. Navigate to Networks tab and set the appropiate Network Settings for the Public, Storage and Management Networks. Click Verify Networks to verify correct configuration.

   

5. Press Deploy changes to deploy the environment.

6. After a succesful deployment. The PLUMgrid UI will be accessible on the VIP entered in the PLUMgrid Settings. :: https://<PG-VIP>

   

7. As PLUMgrid provides the network backend; all standard neutron operations (create/delete networks, routers etc) can be performed to check the status of the plugin. SSH into any Controller node and run the following: :

   source /root/openrc
   neutron net-create net1
   neutron router-create router1

   The newly created network and router should be visible in Horizon and the PLUMgrid UI

8. For further details on usability & features, and to obtain official documentation, contact PLUMgrid at info@plumgrid.com.