Contents

1   Introduction

This User Guide (UG) describes the different Fuel plugins available for the Cloud Execution Environment (CEE), and the mandatory Fuel plugins for a supported CEE configuration.

1.1   Target Group

Support organization personnel with a solid knowledge of Linux CLI, OpenStack, and CEE.

1.2   Prerequisites

This section states the prerequisites that have to be fulfilled.

1.2.1   Conditions

Ensure that the following condition is met:

• Access to the Fuel VM on the kickstart server

1.2.2   Documents

No document is needed as a prerequisite when using this UG.

2   Fuel Plugin Handling in CEE

This section describes the handling of Fuel plugins in a CEE region.

CEE software releases contain the officially supported Fuel plugins. To enable the officially supported plugins, see Section 2.2.

Note:  

Additional software packages are required for Fuel plugins that are not part of the CEE software release bundle. For more information and installation instructions, refer to Preparation of Kickstart Server.

To customize CEE with user specified Fuel plugins, see Section 2.1.

2.1   Adding Fuel Plugins to CEE Region

The officially supported plugin packages are available in Fuel at the following location:

/var/www/nailgun/ericsson/fuel-plugins

CEE installation scripts will install and enable the plugins, listed in Section 2.2, from this location. Customized Fuel plugins have to be added to this directory before starting the CEE installation in the CEE installation flow.

Note:  

Adding customized Fuel plugins to a CEE installation deviates from an officially supported CEE configuration. Support for lifecycle management functions, such as updates, are not guaranteed.

2.2   Enabling Fuel Plugins for CEE Region

Refer to section Fuel Plugins in the Configuration File Guide to enable a Fuel plugin in a CEE region.

To find the possible configuration attributes and their allowed values for the officially supported Fuel plugins in CEE, see the following sections:

• For the mandatory Fuel plugins, see Section 3
• For the optional Fuel plugins, see Section 4

The default values for the Fuel plugins are automatically set when no config_attributes are specified in the config.yaml file. Setting a user specified configuration value requires adding only the relevant line to the config_attributes section, and any additional non-specified attributes are automatically set to their default values.

3   Mandatory Fuel Plugins for CEE

This section describes the mandatory Fuel plugins for a supported CEE configuration.

3.1   Networking

3.1.1   Ericsson CSS

This plugin enables the integration of Ericsson Cloud SDN Switch (CSS) with CEE.

Plugin name: ericsson_css

Depends on: None

Conflicts with: None

CEE Release Compatibility: 6.4 and later

Configuration Attributes:

3.2   High Availability

3.2.1   Ericsson CM-HA

This plugin enables the integration of Continuous Monitoring High Availability (CM-HA) with CEE.

Plugin name: ericsson_cmha

Depends on: ericsson_watchmen, ericsson_ldap, ericsson_idam

Conflicts with: None

CEE Release Compatibility: 6.4 and later

3.3   Security

3.3.1   Ericsson TLS

This plugin enables the integration of Ericsson TLS feature with CEE.

Plugin name: ericsson_tls

Depends on: None

Conflicts with: TLS feature provided by Mirantis OpenStack

CEE Release Compatibility: 6.4 and later

3.3.2   Ericsson LDAP

This plugin enables the integration of Ericsson LDAP setup with CEE.

Plugin name: ericsson_ldap

Depends on: None

Conflicts with: None

CEE Release Compatibility: 6.4 and later

3.3.3   Ericsson IdAM

This plugin enables the integration of Ericsson IdAM configuration with CEE.

Plugin name: ericsson_idam

Depends on: ericsson_ldap

Conflicts with: None

CEE Release Compatibility: 6.4 and later

3.4   Fault Management

3.4.1   Ericsson Watchmen

This plugin enables the integration of Ericsson Watchmen component with CEE.

Plugin name: ericsson_watchmen

Depends on: ericsson_ldap, ericsson_idam, ericsson_hcframework

Conflicts with: None

CEE Release Compatibility: 6.4 and later

Configuration Attributes:

3.4.2   Ericsson HCFramework

This plugin enables the integration of Ericsson HCFramework component with CEE.

Plugin name: ericsson_hcframework

Depends on: ericsson_ldap, ericsson_idam

Conflicts with: None

CEE Release Compatibility: 6.4 and later

3.4.3   Ericsson NdevAlarm

This plugin enables the integration of Ericsson NdevAlarm component with CEE.

Plugin name: ericsson_ndevalarm

Depends on: ericsson_infra_setup

Conflicts with: None

CEE Release Compatibility: 6.4 and later

3.4.4   Ericsson Service Supervision

This plugin enables the integration of Ericsson service supervision with CEE.

Plugin name: ericsson_service_supervision

Depends on: None

Conflicts with: None

CEE Release Compatibility: 6.4 and later

3.5   Performance Management

3.5.1   Zabbix Monitoring

This plugin enables the integration of Zabbix component with CEE.

Plugin name: zabbix_monitoring

Depends on: None

Conflicts with: None

CEE Release Compatibility: 6.0 and later

3.5.2   Ericsson Zabbix Configuration

This plugin enables the configuration of the Zabbix component as per CEE recommendations.

Only the alarm templates are enabled in Zabbix monitoring by default, which contain the Zabbix measurements that drive Watchmen alarms. The additional measurement or monitoring options are independent, and can be enabled or disabled in any combination through the configuration attributes.

Note:  

For using all PM file reporting functions, pmreports and isplogs must be true. For using all Zabbix PM functions, pmreports, isplogs, characteristics and rest must be true.

Plugin name: ericsson_zabbix

Depends on: zabbix_monitoring, ericsson_hcframework, ericsson_hardening, ericsson_service_supervision, ericsson_watchmen, ericsson_tls

Conflicts with: None

CEE Release Compatibility: 6.4 and later

Configuration Attributes:

3.5.3   Ericsson PM

This plugin enables the integration of PMAPI, PMReporter, ISPlogger and confhandler components with CEE.

Plugin name: ericsson_pm

Depends on: None

Conflicts with: None

CEE Release Compatibility: 6.4 and later

3.6   Infrastructure Management

3.6.1   Ericsson NTP

This plugin enables the integration of NTP service with CEE.

Plugin name: ericsson_ntp

Depends on: None

Conflicts with: None

CEE Release Compatibility: 6.4 and later

3.6.2   Ericsson Logging

This plugin enables the configuration of logging in CEE as per Ericsson recommendation.

Plugin name: ericsson_logging

Depends on: None

Conflicts with: None

CEE Release Compatibility: 6.4 and later

3.6.3   Ericsson Infrastructure Setup

This plugin enables the configuration of the infrastructure of a CEE region as per Ericsson recommendation.

Plugin name: ericsson_infra_setup

Depends on: None

Conflicts with: None

CEE Release Compatibility: 6.4 and later

3.6.4   Ericsson Hardening

This plugin enables the security hardening of infrastructure as per CEE recommendation.

Plugin name: ericsson_hardening

Depends on: None

Conflicts with: None

CEE Release Compatibility: 6.4 and later

3.7   OpenStack Configuration

3.7.1   Ericsson OpenStack Configuration

This plugin enables the integration of Nova, Neutron, Cinder and Ceilometer services with CEE.

Plugin name: ericsson_openstack_config

Depends on: None

Conflicts with: None

CEE Release Compatibility: 6.4 and later

Configuration Attributes:

3.8   Backup

3.8.1   Ericsson CEE Backup

This plugin enables the integration of Ericsson Backup with CEE.

Plugin name: ericsson_cee_backup

Depends on: None

Conflicts with: None

CEE Release Compatibility: 6.4 and later

3.9   License Management

3.9.1   Ericsson NeLS for CEE

This plugin enables the integration of the license management feature in CEE.

Plugin name: ericsson_sheriff

Depends on: None

Conflicts with: None

CEE Release Compatibility: 6.6 and later

4   Optional Fuel Plugins for CEE

This section describes the list of Fuel plugins which are optional for a CEE configuration.

Note:  

The plugins listed in this section are mandatory depending on hardware setup and configuration

4.1   Networking

4.1.1   Ericsson SR-IOV

This plugin enables the integration of SR-IOV feature with CEE.

Note:  

This plugin is mandatory if SR-IOV is enabled for the node in config.yaml.

Plugin name: ericsson_sriov

Depends on: None

Conflicts with: None

CEE Release Compatibility: 6.4 and later

4.1.2   Ericsson PCI Passthrough and SR-IOV Physical Function Passthrough

This plugin enables the PCI passthrough or the SR-IOV Physical Function passthrough feature with CEE.

Note:  

This plugin is mandatory if PCI passthrough or SR-IOV Physical Function passthrough is enabled for at least one node in confg.yaml.

Plugin name: ericsson_pci_passthrough

Depends on: None

Conflicts with: None

CEE Release Compatibility: R7A and later

4.1.3   Ericsson SDN Controller

This plugin enables the integration of Ericsson Cloud Software Defined Networking (SDN) controller with CEE.

Plugin name: ericsson_sdnc

Depends on: ericsson_watchmen, ericsson_css

Conflicts with: None

CEE Release Compatibility: R6B and later

Configuration Attributes:

4.1.4   Ericsson BGP VPN

This plugin enables the integration of BGP VPN functionality in Ericsson SDN controller with CEE.

Plugin name: bgvpn

Depends on: ericsson_sdnc, ericsson_css

Conflicts with: None

CEE Release Compatibility: R6B and later

4.1.5   Ericsson L2GW

This plugin enables the integration of L2GW functionality in Ericsson SDN controller with CEE.

Plugin name: l2gw

Depends on: ericsson_sdnc, ericsson_css

Conflicts with: None

CEE Release Compatibility: R6B and later

Configuration Attributes:

dcgw_vlan_physnet:
- "DCGW_NET1"
- "DCGW_NET2"

dcgw_vlan_physnet:
- "DCGW_NET1"
- "DCGW_NET2"

4.1.6   Extreme

This plugin enables the integration of Extreme switches with CEE.

Note:  

This plugin is mandatory when in config.yaml file the parameter neutron_config_yaml_file is set to neutron_ericsson_extreme.yaml and initial_setup in hw_switches is set to extreme.

Plugin name: ericsson_extreme

Depends on: None

Conflicts with: None

CEE Release Compatibility: 6.4 and later

4.1.7   Ericsson BSP CMX

This plugin includes the OpenStack Neutron ML2 plugin for the CMX switches in order to manage them dynamically.

Note:  

This Plugin is mandatory if CEE is installed on BSP hardware.

Plugin name: ericsson_bsp_cmx

Depends on: ericsson_openstack_config

Conflicts with: None

CEE Release Compatibility: 6.4 and later

4.2   Storage

4.2.1   EMC ScaleIO

This plugin enables the integration of EMC ScaleIO with CEE.

Note:  

This plugin is mandatory if CEE-managed ScaleIO is configured in config.yaml.

Plugin name: scaleio

Depends on: ericsson_ldap, ericsson_idam

Conflicts with: None

CEE Release Compatibility: R6B and later

4.3   Infrastructure Management

4.3.1   Ericsson Performance Enhancements

This plugin enables the integration of Ericsson performance enhancement components with CEE.

The ericsson_performance plugin enables the update of the QEMU package that increases the virtio_queue_size parameter to 1024 from the default 256. Installation of the updated QEMU package has to be specified per blade in a CEE region through the config.yaml file. See the Configuration File Guide for more information.

Plugin name: ericsson_performance

Depends on: None

Conflicts with: None

CEE Release Compatibility: 6.4 and later

4.3.2   Ericsson HDS Agent

This plugin enables the integration of HDS Agent with CEE.

Plugin name: ericsson_hds_agent

Depends on: None

Conflicts with: None

CEE Release Compatibility: 6.4 and later

Configuration Attributes:

5   Appendix

This section contains example Fuel plugin configurations for the different CEE deployments.

Note:  

The configurations listed in this section are provided as a reference, and do not illustrate supported features for the specific CEE deployments.

5.1   Single Server Fuel Plugin Configuration

This section contains the Fuel plugin configuration for CEE deployments on Single Server platforms.

ericsson:
  ...   
  fuel-plugins:
    -
       name: zabbix_monitoring
       config_attributes:
         password: CEEZ@bbIxUs3R#
         db_password: CEEZ@bbIxDbpwd#
    -
       name: ericsson_css
       config_attributes:
         redundant_traffic_interface: false
    -
       name: ericsson_hcframework
    -
       name: ericsson_idam
    -
       name: ericsson_ldap
    -
       name: ericsson_ndevalarm
    -
       name: ericsson_openstack_config
    -
       name: ericsson_pm
    -
       name: ericsson_service_supervision
    -
       name: ericsson_watchmen
    -
       name: ericsson_logging
    -
       name: ericsson_tls
    -
       name: ericsson_infra_setup
    -
       name: ericsson_sheriff
    
       name: ericsson_ntp
    -
       name: ericsson_hardening
    -
       name: ericsson_zabbix
    

# Depending on the configuration, the following plugins are optional

    -
       name: ericsson_performance
  ...  

5.2   Dell Fuel Plugin Configuration

This section contains the Fuel plugin configuration for CEE deployments on Dell Multi-Server platforms.

ericsson:
  ...   
  fuel-plugins:
    -
       name: zabbix_monitoring
       config_attributes:
         password: CEEZ@bbIxUs3R#
         db_password: CEEZ@bbIxDbpwd#
    -
       name: ericsson_css
    -
       name: ericsson_hcframework
    -
       name: ericsson_idam
    -
       name: ericsson_ldap
    -
       name: ericsson_ndevalarm
    -
       name: ericsson_openstack_config
    -
       name: ericsson_pm
    -
       name: ericsson_service_supervision
    -
       name: ericsson_watchmen
    -
       name: ericsson_logging
    -
       name: ericsson_cmha
    -
       name: ericsson_tls
    -
       name: ericsson_infra_setup
    -
       name: ericsson_sheriff
    
       name: ericsson_cee_backup
    -
       name: ericsson_ntp
    -
       name: ericsson_hardening
    -
       name: ericsson_zabbix
    

# Depending on the configuration, the following plugins are optional

    -
       name: ericsson_extreme
    -
       name: ericsson_sriov
    -
       name: ericsson_performance
    -
       name: scaleio
    
  ...  

5.3   BSP Fuel Plugin Configuration

This section contains the Fuel plugin configuration for CEE deployments on BSP platforms.

ericsson:
  ...   
  fuel-plugins:
    -
       name: zabbix_monitoring
       config_attributes:
         password: CEEZ@bbIxUs3R#
         db_password: CEEZ@bbIxDbpwd#
    -
       name: ericsson_css
       config_attributes:
         dpdk_bond_mode: active-backup
    -
       name: ericsson_hcframework
    -
       name: ericsson_idam
    -
       name: ericsson_ldap
    -
       name: ericsson_ndevalarm
    -
       name: ericsson_openstack_config
    -
       name: ericsson_pm
    -
       name: ericsson_service_supervision
    -
       name: ericsson_watchmen
    -
       name: ericsson_logging
    -
       name: ericsson_cmha
    -
       name: ericsson_tls
    -
       name: ericsson_infra_setup
    -
       name: ericsson_sheriff
    
       name: ericsson_bsp_cmx
    -
       name: ericsson_cee_backup
    -
       name: ericsson_ntp
    -
       name: ericsson_hardening
    -
       name: ericsson_zabbix
    

# Depending on the configuration, the following plugins are optional

    -
       name: ericsson_performance
    -
       name: scaleio
    
  ...  

5.4   HDS Fuel Plugin Configuration

This section contains the Fuel plugin configuration for CEE deployments on HDS platforms.

ericsson:
  ...   
  fuel-plugins:
    -
       name: zabbix_monitoring
       config_attributes:
         password: CEEZ@bbIxUs3R#
         db_password: CEEZ@bbIxDbpwd#
    -
       name: ericsson_css
    -
       name: ericsson_hcframework
    -
       name: ericsson_idam
    -
       name: ericsson_ldap
    -
       name: ericsson_ndevalarm
    -
       name: ericsson_openstack_config
    -
       name: ericsson_pm
    -
       name: ericsson_service_supervision
    -
       name: ericsson_watchmen
    -
       name: ericsson_logging
    -
       name: ericsson_cmha
    -
       name: ericsson_tls
    -
       name: ericsson_infra_setup
    -
       name: ericsson_sheriff
    
       name: ericsson_hds_agent
       config_attributes:
         server: 192.168.33.4
         interface: br-hds-agent
    -
       name: ericsson_cee_backup
    -
       name: ericsson_ntp
    -
       name: ericsson_hardening
    -
       name: ericsson_zabbix
    

# Depending on the configuration, the following plugins are optional

    -
       name: l2gw
    -
       name: ericsson_sdnc
    -
       name: bgvpn
    -
       name: ericsson_performance
    -
       name: scaleio
    
  ...