Nuage Rackspace OSA ansible deployment steps - nuagenetworks/nuage-openstack-ansible GitHub Wiki

Steps to run the Nuage OSA ansible scripts:

Prior to OSA deployment using Nuage Neutron Plugin; make sure OSA multi-node environment is set up as per the wiki page:

https://github.com/nuagenetworks/nuage-openstack-ansible/wiki/Configure-OSA-Multi-node-Environment

Also make sure that Nuage VSD/VSC components are functional as a part of OSA multi-node cluster prior to OSA deployment. Refer to the Nuage VSP Install guide for detailed VSD/VSC configuration steps

1) Nuage VRS Ansible Playbooks:

  • These playbooks will be run after the OSA deployment completes

  • Nuage VRS configuration ansible playbooks would be accessible here:

https://github.com/nuagenetworks/nuage-openstack-ansible .

  • To run these playbooks; clone the above repository to the deployment host on the OpenStack multi-node cluster under "/opt/nuage-openstack-ansible"

  • Then copy user variables files under "/etc/user_nuage_vars.yml" and "/etc/user_nuage_neutron.yml" to "/etc/openstack_deploy". Make sure all parameters in the file "/etc/user_nuage_vars.yml" are updated/changed as per your environment.

2) Nuage Neutron Plugin with OSA:

  • Clone the upstream openstack-ansible repository to the deployment host under /opt/openstack-ansible

https://github.com/openstack/openstack-ansible

Now since Nuage Neutron plugin changes have NOT been back-ported to Liberty OSA code; there is a need to manually apply a patch/diff of Nuage Neutron changes before the Nuage Neutron enabled OSA deployment is done. For obtaining this Nuage Neutron plugin patch along with Nuage Networks VSP software packages, user documentation and licenses; please reach out with a query to [email protected] NOTE: This manual patching of Nuage Neutron plugin changes are ONLY required to be done for Liberty OSA Nuage deployments; post Liberty releases Nuage Neutron changes will be a part of upstream OSA

  • Now in /etc/openstack_deploy folder in "/etc/user_variables.yml" file; add the following lines:

pip_links:

These lines make sure that nuage neutron packages which have been hosted at "http://local-web-server-ip-address/links" will be used for nuage neutron packages installation during deployment. This is a requirement because by default for all OpenStack configurations/installations; OSA makes use of "pip" installs which mandates the installation of "whl" packages.

Also the "links" folder seen in the url above is a symlink to the directory hosting Neutron whl packages. To create such a symlink; these are the steps:

-> Create a folder called "links" at the root your web-server; in above case at "http://local-web-server-ip-address"

-> Make sure you have your "whl" packages copied to some location on this web-server; for eg as follows:

-> Now change directory to "links" folder and execute:

find ../packages/neutron -name "*.whl"

-> Now again from "links" folder; execute this:

find ../packages/neutron -name "*.whl" -exec ln -fs {} . ';'

The above step creates a symlink to Neutron whl packages

-> There is a need to setup a local web server because Nuage does not host it's packages on "pypi.org" for OSA access during deployment.

  • Also add the following line to "/etc/openstack_deploy/user_variables.yml" file:

    nova_network_type: "nuage"

  • It is a pre-requisite to generate a CMS-ID and populate this value in "/etc/openstack_deploy/user_nuage_vars.yml" file

  • After all concerned user variable files under "/etc/openstack_deploy" have been updated; run OSA deployment ansible scripts. The detailed steps to run the OSA deployment scripts have been listed in the OSA Install guide

  • After the OSA deployment completes successfully; run Nuage VRS playbooks from "/opt/nuage-openstack-ansible/nuage_playbooks" to setup compute targets with VRS configurations:

    sudo openstack-ansible nuage_all.yml

  • It is also possible to do an end to end OSA deployment followed by Nuage VRS ansible scripts by running a single master ansible playbook. To do this from "/opt/nuage-openstack-ansible/nuage_playbooks" run:

    sudo openstack-ansible master.yml

This master script will set up the entire multi-node OpenStack environment while also configuring compute VRS nodes

Note: For Nuage Networks VSP software packages, user documentation and licenses please reach out with a query to [email protected]