Plug-in configurations¶

Configure Big Switch (Floodlight REST Proxy) plug-in¶

1. Edit the /etc/neutron/neutron.conf file and add this line:

   core_plugin = bigswitch
   

2. In the /etc/neutron/neutron.conf file, set the service_plugins option:

   service_plugins = neutron.plugins.bigswitch.l3_router_plugin.L3RestProxy
   

3. Edit the /etc/neutron/plugins/bigswitch/restproxy.ini file for the plug-in and specify a comma-separated list of controller_ip:port pairs:

   server = CONTROLLER_IP:PORT
   

   For database configuration, see Install Networking Services in the Installation Guide in the OpenStack Documentation index. (The link defaults to the Ubuntu version.)

4. Restart neutron-server to apply the settings:

   # service neutron-server restart
   

Configure Brocade plug-in¶

1. Install the Brocade-modified Python netconf client (ncclient) library, which is available at https://github.com/brocade/ncclient:

   $ git clone https://github.com/brocade/ncclient
   

2. As root, run this command:

   # cd ncclient;python setup.py install
   

3. Edit the /etc/neutron/neutron.conf file and set the following option:

   core_plugin = brocade
   

4. Edit the /etc/neutron/plugins/brocade/brocade.ini file for the Brocade plug-in and specify the admin user name, password, and IP address of the Brocade switch:

   [SWITCH]
   username = ADMIN
   password = PASSWORD
   address  = SWITCH_MGMT_IP_ADDRESS
   ostype   = NOS
   

   For database configuration, see Install Networking Services in any of the Installation Guides in the OpenStack Documentation index. (The link defaults to the Ubuntu version.)

5. Restart the neutron-server service to apply the settings:

   # service neutron-server restart
   

Configure NSX-mh plug-in¶

The instructions in this section refer to the VMware NSX-mh platform, formerly known as Nicira NVP.

1. Install the NSX plug-in:

   # apt-get install neutron-plugin-vmware
   

2. Edit the /etc/neutron/neutron.conf file and set this line:

   core_plugin = vmware
   

   Example neutron.conf: file for NSX-mh integration:

   core_plugin = vmware
   rabbit_host = 192.168.203.10
   allow_overlapping_ips = True
   

3. To configure the NSX-mh controller cluster for OpenStack Networking, locate the [default] section in the /etc/neutron/plugins/vmware/nsx.ini file and add the following entries:

   • To establish and configure the connection with the controller cluster you must set some parameters, including NSX-mh API endpoints, access credentials, and optionally specify settings for HTTP timeouts, redirects and retries in case of connection failures:

     nsx_user = ADMIN_USER_NAME
     nsx_password = NSX_USER_PASSWORD
     http_timeout = HTTP_REQUEST_TIMEOUT # (seconds) default 75 seconds
     retries = HTTP_REQUEST_RETRIES # default 2
     redirects = HTTP_REQUEST_MAX_REDIRECTS # default 2
     nsx_controllers = API_ENDPOINT_LIST # comma-separated list
     

     To ensure correct operations, the nsx_user user must have administrator credentials on the NSX-mh platform.

     A controller API endpoint consists of the IP address and port for the controller; if you omit the port, port 443 is used. If multiple API endpoints are specified, it is up to the user to ensure that all these endpoints belong to the same controller cluster. The OpenStack Networking VMware NSX-mh plug-in does not perform this check, and results might be unpredictable.

     When you specify multiple API endpoints, the plug-in takes care of load balancing requests on the various API endpoints.

   • The UUID of the NSX-mh transport zone that should be used by default when a tenant creates a network. You can get this value from the Transport Zones page for the NSX-mh manager:

     Alternatively the transport zone identifier can be retrieved by query the NSX-mh API: /ws.v1/transport-zone

     default_tz_uuid = TRANSPORT_ZONE_UUID
     

   • default_l3_gw_service_uuid = GATEWAY_SERVICE_UUID
     

     Warning

     Ubuntu packaging currently does not update the neutron init script to point to the NSX-mh configuration file. Instead, you must manually update /etc/default/neutron-server to add this line:

     NEUTRON_PLUGIN_CONFIG = /etc/neutron/plugins/vmware/nsx.ini
     

     For database configuration, see Install Networking Services in the Installation Guide.

4. Restart neutron-server to apply settings:

   # service neutron-server restart
   

   Warning

   The neutron NSX-mh plug-in does not implement initial re-synchronization of Neutron resources. Therefore resources that might already exist in the database when Neutron is switched to the NSX-mh plug-in will not be created on the NSX-mh backend upon restart.

Example nsx.ini file:

   [DEFAULT]
   default_tz_uuid = d3afb164-b263-4aaa-a3e4-48e0e09bb33c
   default_l3_gw_service_uuid=5c8622cc-240a-40a1-9693-e6a5fca4e3cf
   nsx_user=admin
   nsx_password=changeme
   nsx_controllers=10.127.0.100,10.127.0.200:8888

.. Note::

  To debug :file:`nsx.ini` configuration issues, run this command from the
  host that runs neutron-server:

..code:: console

     # neutron-check-nsx-config PATH_TO_NSX.INI

This command tests whether neutron-server can log into all of the
NSX-mh controllers and the SQL server, and whether all UUID values
are correct.

Configure PLUMgrid plug-in¶

1. Edit the /etc/neutron/neutron.conf file and set this line:

   core_plugin = plumgrid
   

2. Edit the [PLUMgridDirector] section in the /etc/neutron/plugins/plumgrid/plumgrid.ini file and specify the IP address, port, admin user name, and password of the PLUMgrid Director:

   [PLUMgridDirector]
   director_server = "PLUMgrid-director-ip-address"
   director_server_port = "PLUMgrid-director-port"
   username = "PLUMgrid-director-admin-username"
   password = "PLUMgrid-director-admin-password"
   

   For database configuration, see Install Networking Services in the Installation Guide.

3. Restart the neutron-server service to apply the settings:

   # service neutron-server restart