Chapter 3. Managing the Nuage Networks provider

3.1. Enabling support for the Nuage Networks provider

In the current release of Red Hat CloudForms, the Nuage Networks provider requires extra permissions to be enabled on the Red Hat CloudForms application to be available. The following steps can be followed to enable the Nuage Networks provider.

  1. Open a console on the Red Hat CloudForms Appliance VM or SSH to the Red Hat CloudForms Appliance.
  2. Log in using the root user. The default password is smartvm.
  3. Edit the /var/www/miq/vmdb/config/permissions.yml file, this can be done using vim or nano.
  4. Add the bottom of the file, add a line stating - ems-type:nuage_network.
  5. Save the file.
  6. Run appliance_console.
  7. Press Enter to continue.
  8. Select option 16) Stop EVM Server Processes
  9. Confirm you want to stop the services. Wait for the services to stop. Once they are stopped, press Enter twice to return to the menu.
  10. Select option 17) Start EVM Server Processes
  11. Confirm you want to start the services. Wait for the services to start. Once they are started, press Enter twice to return to the menu.
  12. Select option 21) Quit and log out of the Red Hat CloudForms Appliance.

This will enable the use of the Nuage Networks provider. After starting the service, you might need to wait a few minutes before you can log in to the Red Hat CloudForms application.

3.2. Adding a Nuage Networks provider

You can add a Nuage Networks provider using the following steps.

Note: You must be logged in to Red Hat CloudForms as a user with permission to add providers.

3.2.1. Configuring the basic Nuage Networks provider settings

  1. Navigate to Networks > Providers.
  2. Click Configuration.
  3. Select Add a New Network Provider.
  4. Enter a Name for the Network Provider, for instance "Nuage Networks VSP".
  5. From the Type list, select "Nuage Network Manager".
  6. From the API Version list, select the appropriate version for your Nuage Networks VSP environment.

Note If you want to use the Events feature, you will need to have a Nuage Networks VSP environment of version 5.1.1 or newer.

3.2.2. Configuring endpoints

It is a requirement to configure the Nuage Networks VSD endpoint with which the provider can communicate. This is done through the Endpoints tab in the form when configuring the Nuage Networks provider. The following steps go in more detail.

  1. From the Security Protocol list, select the "SSL without validation" option.
  2. In the Hostname (or IPv4 or IPv6 address) field, enter the IP or hostname of your Standalone Nuage Networks VSD, or the load-balancer IP or hostname that sits in front of the Nuage Networks VSD nodes in a clustered deployment.
  3. In the API Port field, enter the API port to use. The default port on the Nuage Networks VSD for API is 8443.
  4. In the Username field, enter the API username you want to use, this should be a user in the Nuage Networks VSD global environment, not an Enterprise specific user.
  5. In the Password field, enter the API password for the user that you want to use.
  6. Click Validate to validate your input.

A message stating "Credential validation was successful" should appear on the top of the page. If an error is presented, please check the inputs of the different fields and validate again.

3.2.3. Configuring events

By default the Events and Alarms feature is disabled when adding a new Nuage Networks provider. To enable it, follow these steps, using the Events tab in the form when configuring the Nuage Networks provider.

  1. Select AMQP on the Events tab.
  2. From the Security Protocol select Non-SSL.
  3. In the Hostname (or IPv4 or IPv6 address) field, enter the IP or hostname of your Standalone Nuage Networks VSD, or if a Nuage Networks VSD Cluster is deployed, enter the IP or hostname of the first node of the Nuage Networks VSD Cluster.
  4. (Optional) In the Fallback Hostname 1 field, enter the IP or hostname of the second node of the Nuage Networks VSD Cluster.
  5. (Optional) In the Fallback Hostname 2 field, enter the IP or hostname of the third node of the Nuage Networks VSD Cluster.
  6. In the API Port field, enter the port that the AMQP service uses on the Nuage Networks VSD node(s). The default value is 5672.
  7. In the Username field, enter the AMQP username you want to use, this should be a user in the Nuage Networks VSD global environment, not an Enterprise specific user. It is important that the username is in the format of <username>@csp, for example: jmsclient@csp.
  8. In the Password field, enter the AMQP password for the user that you want to use.
  9. Click Validate to validate your input.

A message stating "Credential validation was successful" should appear on the top of the page. If an error is presented, please check the inputs of the different fields and validate again.

3.2.4. Adding the provider

After following the appropriate steps above, you can click the Add button to add the Nuage Networks provider.

3.3. Refreshing a Nuage Networks provider

The Nuage Networks provider supports targeted refresh of the supported entities when the Events and Alarms feature is enabled. This will update the information for Subnets and Security Groups whenever the entity in the Nuage Networks VSD is changed.

Manual refresh is also supported, to achieve this, follow these steps:

  1. Navigate to Networks > Providers.
  2. Select the appropriate Nuage Networks provider.
  3. Click Configuration, then click Refresh Relationships and Power States.
  4. In the popup, click OK.

3.4. Changing a Nuage Networks provider

To change the configuration of a Nuage Networks provider, you can follow these steps.

  1. Navigate to Networks > Providers.
  2. Select the appropriate Nuage Networks provider.
  3. Click Configuration, then click Edit selected Network Provider.
  4. Change the fields according to the required changes.
  5. Click Validate in case of new credentials.
  6. Click Save to save the changes.

3.5. Removing a Nuage Networks provider

If you want to delete the Nuage Networks provider, follow these steps:

  1. Navigate to Networks > Providers.
  2. Select the appropriate Nuage Networks provider.
  3. Click Configuration, then click Remove Network Providers from Inventory.
  4. Confirm that the Nuage Network provider needs to be removed by clicking OK.