You can execute MetroAE workflows to perform the following installations:
- Deploy All Components
- Deploy Individual Modules
- Install a Particular Role or Host
- Copy QCOW2 files
- Deploy Standby Cluster
- Setup a Health Monitoring Agent
- Debugging
Before deploying any components, you must have previously set up your Nuage MetroAE environment and customized the environment for your target platform.
Make sure you have unzipped copies of all the Nuage Networks files you are going to need for installation or upgrade. These are generally distributed as *.tar.gz files that are downloaded by you from Nokia OLCS/ALED. There are a few ways you can use to unzip:
- If you are running MetroAE via a clone of the nuage-metroae repo, you can unzip these files by using the nuage-unzip shell script
nuage-unzip.shwhich will place the files in subdirectories under the path specified for thenuage_unzipped_files_dirvariable incommon.yml. - You can also unzip the files manually and copy them to their proper locations by hand. For details of this process, including the subdirectory layout that MetroAE expects, see SETUP.md.
MetroAE can perform a workflow using the command-line tool as follows:
metroae-container <workflow> <component> [deployment] [options]
workflow: Name of the workflow to perform, e.g. 'install' or 'upgrade'. Supported workflows can be listed with --list option.component: Name of the component to apply the workflow to, e.g. 'vsds', 'vscs', 'everything', etc.deployment: Name of the deployment directory containing configuration files. See CUSTOMIZE.mdoptions: Other options for the tool. These can be shown using --help. Also, any options not directed to the metroae-container tool are passed to Ansible.
The following are some examples:
metroae-container install everything
Installs all components described in deployments/default/.
metroae-container destroy vsds east_network
Takes down only the VSD components described by deployments/east_network/vsds.yml. Additional output will be displayed with 3 levels of verbosity.
MetroAE workflows operate on components as you have defined them in your deployment. If you run a workflow for a component not specified, the workflow skips all tasks associated with that component and runs to completion without error. Thus, if you run the install everything workflow when only VRS configuration is present, the workflow deploys VRS successfully while ignoring the tasks for the other components not specified. Deploy all specified components with one command as follows:
metroae-container install everything
Note: metroae-container is a shell script that executes ansible-playbook with the proper includes and command line switches. Use metroae-container (instead of ansible-playbook) when running any of the workflows provided herein.
MetroAE offers modular execution models in case you don't want to deploy all components together. See modules below.
| Module | Command | Description |
|---|---|---|
| VCS | metroae-container install vsds |
Installs VSD components |
| VNS | metroae-container install vscs |
Installs VSC components |
MetroAE has a complete library of workflows, which are directly linked to each individual role. You can limit your deployment to a particular role or component, or you can skip steps you are confident need not be repeated. For example, to deploy only the VSD VM-images and get them ready for VSD software installation, run:
metroae-container install vsds predeploy
To limit your deployment to a particular host, just add --limit parameter:
metroae-container install vsds predeploy --limit "vsd1.example.com"
VSD predeploy can take a long time. If you are vCenter user you may want to monitor progress via the vCenter console.
Note: If you have an issue with a VM and would like to reinstall it, you must destroy it before you replace it. Otherwise, the install will find the first one still running and skip the new install.
When installing or upgrading in a KVM environment, MetroAE copies the QCOW2 image files to the target file server during the predeploy phase. As an option, you can pre-position the qcow2 files for all the components by running copy_qcow2_files. This gives the ability to copy the required images files first and then run install or upgrade later.
When QCOW2 files are pre-positioned, you must add a command-line variable, 'skip_copy_images', to indicate that copying QCOW2 files should be skipped. Otherwise, the QCOW2 files will be copied again. An extra-vars 'skip_copy_images' needs to be passed on the command line during the deployment phase to skip copying of the image files again. For example, to pre-position the QCOW2 images, run:
metroae-container tools copy qcow
Then, to skip the image copy during the install:
metroae-container install everything --extra-vars skip_copy_images=True
MetroAE can be used to bring up the Standby VSD and VSTAT(ES) cluster in situations where the active has already been deployed. This can be done using the following commands. For VSD Standby deploy
metroae-container install vsds standby predeploy
metroae-container install vsds standby deploy
For Standby VSTATs(ES)
metroae-container install vstats standby predeploy
metroae-container install vstats standby deploy
A health monitoring agent can be setup on compatible components during the deploy step. Currently this support includes the Zabbix agent. An optional parameter health_monitoring_agent can be specified on each component in the deployment files to enable setup. During each component deploy step when enabled, the agent will be downloaded, installed and configured to be operational. The agent can be installed separately, outside of the deploy role, using the following command:
metroae-container health monitoring setup
By default, ansible.cfg tells ansible to log to ./ansible.log.
Ansible supports different levels of verbosity, specified with one of the following command line flags: -v -vv -vvv -vvvv
More letters means more verbose, usually for debugging. The highest level, -vvvv, provides SSH connectivity information.
Running individual workflows is also useful for debugging. For example, vsd_predeploy, vsd_deploy, and vsd_postdeploy.
If you would like to remove an entire deployment, or individual components, and start over, see DESTROY.md for details.
After you have successfully deployed Nuage Networks VSP components, you may want to upgrade to a newer version at some point in the future. See UPGRADE_SA.md for standalone deployments and UPGRADE_HA.md for clustered deployments.
Get support via the forums on the MetroAE site.
Ask questions and contact us directly at devops@nuagenetworks.net.
Report bugs you find and suggest new features and enhancements via the GitHub Issues feature.
You may also contribute to MetroAE by submitting your own code to the project.