⁠14.3. Adding External Providers

14.3.1. Adding an External Provider
14.3.2. Adding a Foreman Instance for Host Provisioning
14.3.3. Adding an OpenStack Networking (Neutron) Instance for Network Provisioning
14.3.4. Adding an OpenStack Image Service (Glance) Instance for Image Management
14.3.5. Add Provider General Settings Explained
14.3.6. Add Provider Agent Configuration Settings Explained

⁠14.3.1. Adding an External Provider

All external resource providers are added using a single window that adapts to your input. You must add the resource provider before you can use the resources it provides in your Red Hat Enterprise Virtualization environment.

⁠14.3.2. Adding a Foreman Instance for Host Provisioning

Summary
Add a Foreman instance for host provisioning to the Red Hat Enterprise Virtualization Manager.
⁠

Procedure 14.2. Adding a Foreman Instance for Host Provisioning

  1. Select the External Providers entry in the tree pane.
  2. Click the Add button to open the Add Provider window.
    ⁠
    The Add Provider Window

    Figure 14.1. The Add Provider Window

  3. Enter a Name and Description.
  4. From the Type drop-down menu, ensure that Foreman is selected.
  5. Enter the URL or fully qualified domain name of the machine on which the Foreman instance is installed in the Provider URL text field. You do not need to specify a port number.
  6. Enter the Username and Password for the Foreman instance. You must use the same username and password as you would use to log in to the Foreman provisioning portal.
  7. Test the credentials:
    1. Click the Test button to test whether you can authenticate successfully with the Foreman instance using the provided credentials.
    2. If the Foreman instance uses SSL, the Import provider certificates window opens; click OK to import the certificate that the Foreman instance provides.

      Important

      You must import the certificate that the Foreman instance provides to ensure the Manager can communicate with the instance.
  8. Click OK.
Result
You have added the Foreman instance to the Red Hat Enterprise Virtualization Manager, and can work with the hosts it provides.

⁠14.3.3. Adding an OpenStack Networking (Neutron) Instance for Network Provisioning

Summary
Add an OpenStack Networking (Neutron) instance for network provisioning to the Red Hat Enterprise Virtualization Manager.
⁠

Procedure 14.3. Adding an OpenStack Networking (Neutron) Instance for Network Provisioning

  1. Select the External Providers entry in the tree pane.
  2. Click the Add button to open the Add Provider window.
    ⁠
    The Add Provider Window

    Figure 14.2. The Add Provider Window

  3. Enter a Name and Description.
  4. From the Type drop-down menu, select OpenStack Networking.
  5. Click the text field for Networking Plugin and select Open vSwitch.
  6. Enter the URL or fully qualified domain name of the machine on which the OpenStack Networking instance is installed in the Provider URL text field, followed by the port number.
  7. Optionally, select the Requires Authentication check box and enter the Username, Password and Tenant Name for the OpenStack Networking instance. You must use the username and password for the OpenStack Networking user registered in Keystone, and the tenant of which the OpenStack Networking instance is a member.
  8. Test the credentials:
    1. Click the Test button to test whether you can authenticate successfully with the Neutron instance using the provided credentials.
    2. If the Neutron instance uses SSL, the Import provider certificates window opens; click OK to import the certificate that the Neutron instance provides.

      Important

      You must import the certificate that the Neutron instance provides to ensure the Manager can communicate with the instance.
  9. Click the Agent Configuration tab.
    ⁠
    The Agent Configuration Tab

    Figure 14.3. The Agent Configuration Tab

  10. Enter the URL or fully qualified domain name of the host on which the QPID server is hosted in the Host text field.
  11. Enter the port number by which to connect to the QPID instance. This port number will be 5762 by default if QPID is not configured to use SSL, and 5761 if QPID is configured to use SSL.
  12. Enter the Username and Password of the OpenStack Networking user registered in the QPID instance.
  13. Click OK.
Result
You have added the OpenStack Networking instance to the Red Hat Enterprise Virtualization Manager, and can use the networks it provides.

⁠14.3.4. Adding an OpenStack Image Service (Glance) Instance for Image Management

Summary
Add an OpenStack Image Service (Glance) instance for image management to the Red Hat Enterprise Virtualization Manager.
⁠

Procedure 14.4. Adding an OpenStack Image Service (Glance) Instance for Image Management

  1. Select the External Providers entry in the tree pane.
  2. Click the Add button to open the Add Provider window.
    ⁠
    The Add Provider Window

    Figure 14.4. The Add Provider Window

  3. Enter a Name and Description.
  4. From the Type drop-down menu, select OpenStack Image.
  5. Enter the URL or fully qualified domain name of the machine on which the Glance instance is installed in the Provider URL text field.
  6. Optionally, select the Requires Authentication check box and enter the Username, Password and Tenant Name for the Glance instance. You must use the username and password for the Glance user registered in Keystone, and the tenant of which the Glance instance is a member.
  7. Test the credentials:
    1. Click the Test button to test whether you can authenticate successfully with the Glance instance using the provided credentials.
    2. If the Glance instance uses SSL, the Import provider certificates window opens; click OK to import the certificate that the Glance instance provides.

      Important

      You must import the certificate that the Glance instance provides to ensure the Manager can communicate with the instance.
  8. Click OK.
Result
You have added the Glance instance to the Red Hat Enterprise Virtualization Manager, and can work with the images it provides.

⁠14.3.5. Add Provider General Settings Explained

The General tab in the Add Provider window allows you to register the core details regarding the provider.
⁠

Table 14.1. Add Provider: General Settings

Setting
Explanation
Name
A name to represent the provider in the Manager.
Description
A plain text, human-readable description of the provider.
Type
The type of the provider. Changing this setting alters the available fields for configuring the provider.
Foreman
  • Provider URL: The URL or fully qualified domain name of the machine on which the Foreman instance is hosted. You do not need to add the port number to the end of the URL or fully qualified domain name.
  • Requires Authentication: Allows you to specify whether authentication is required for the provider. Authentication is mandatory when Foreman is selected.
  • Username: A username for connecting to the Foreman instance. This username must be the username used to log in to the provisioning portal on the Foreman instance. By default, this username is admin.
  • Password: The password against which the above username is to be authenticated. This password must be the password used to log in to the provisioning portal on the Foreman instance.
OpenStack Image
  • Provider URL: The URL or fully qualified domain name of the machine on which the OpenStack Image Service is hosted. You must add the port number for the OpenStack Image Service to the end of the URL or fully qualified domain name. By default, this port number is 9292.
  • Requires Authentication: Allows you to specify whether authentication is required to access the OpenStack Image Service.
  • Username: A username for connecting to the OpenStack Image Service. This username must be the username for the OpenStack Image Service registered in the Keystone instance of which the OpenStack Image Service is a member. By default, this username is glance.
  • Password: The password against which the above username is to be authenticated. This password must be the password for the OpenStack Image Service registered in the Keystone instance of which the OpenStack Image Service is a member.
  • Tenant Name: The name of the OpenStack tenant of which the OpenStack Image Service is a member. By default, this will be Services.
OpenStack Network
  • Networking Plugin: The networking plugin with which to connect to the OpenStack server. Users can currently select only Open vSwitch.
  • Provider URL: The URL or fully qualified domain name of the machine on which the OpenStack Networking instance is hosted. You must add the port number for the OpenStack Networking instance to the end of the URL or fully qualified domain name. By default, this port number is 9696.
  • Username: A username for connecting to the OpenStack Networking instance. This username must be the username for OpenStack Networking registered in the Keystone instance of which the OpenStack Networking instance is a member. By default, this username is neutron.
  • Password: The password against which the above username is to be authenticated. This password must be the password for OpenStack Networking registered in the Keystone instance of which the OpenStack Networking instance is a member.
  • Tenant Name: The name of the OpenStack tenant of which the OpenStack Networking instance is a member. By default, this will be Services.
Test
Allows users to test the specified credentials. This button is available to all provider types.

⁠14.3.6. Add Provider Agent Configuration Settings Explained

The Agent Configuration tab in the Add Provider window allows users to register details regarding networking plugins. This tab is only available for the OpenStack Network provider type, and only after specifying a plugin via the Networking Plugin setting.
⁠

Table 14.2. Add Provider: General Settings

Setting
Explanation
Interface Mappings
A comma-separated list of mappings in the format of label:interface.
Host
The URL or fully qualified domain name of the machine on which the QPID instance is installed.
Port
The remote port by which a connection with the above host is to be made. By default, this port will be 5762 if SSL is not enabled on the host, and 5761 if SSL is enabled.
Username
A username for authenticating the OpenStack Networking instance with the above QPID instance. By default, this username will be neutron
Password
The password against which the above username is to be authenticated.