Fuel Plugin Configuration Guide
Cloud Execution Environment

Contents

1Introduction
1.1Target Group
1.2Prerequisites
1.2.1Conditions
1.2.2Documents

2
Fuel Plugin Handling in CEE
2.1Adding Fuel Plugins to a CEE Region
2.2Enabling Fuel Plugins for a CEE Region

3
Mandatory Fuel Plugins for CEE
3.1Networking
3.1.1CSS
3.2High Availability
3.2.1CM-HA
3.3Security
3.3.1Ericsson TLS
3.3.2LDAP
3.3.3IdAM
3.4Fault Management
3.4.1Watchmen
3.4.2HCFramework
3.5Performance Management
3.5.1Zabbix
3.5.2PMAPI and PMReporter
3.6Infrastructure Management
3.6.1NTP

4
Optional Fuel Plugins for CEE
4.1Networking
4.1.1SR-IOV
4.1.2Ericsson CSC
4.1.3Extreme
4.2Storage
4.2.1EMC VNX
4.2.2EMC ScaleIO
4.3Infrastructure Management
4.3.1HDS Agent

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:

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.

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

2.1   Adding Fuel Plugins to a 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, for example, updates, are not guaranteed.

2.2   Enabling Fuel Plugins for a CEE Region

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

The configuration attributes can be user specified to override the default values, as detailed in the Configuration File Guide. To find the possible configuration attributes and their allowed values for the officially supported Fuel plugins in CEE, see the following sections:

3   Mandatory Fuel Plugins for CEE

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

3.1   Networking

3.1.1   CSS

Note:  
This plugin will be available in a future release of CEE R6.

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: R6.4

Configuration Attributes:

Option = default value

(Type) Help string

install_css_dpdk = true

(BoolOpt) Install CSS with DPDK. Always expected to be default value.


Possible values:


  • true

  • false


Related options:


  • dpdk_bond_mode

redundant_traffic_interface = true

(BoolOpt) Redundancy for traffic interfaces. For multi-server deployments the default value, true, is expected. For single server deployments, since only one traffic interface is present, the expected value is false.


Possible values:


  • true

  • false


Related options:


  • dpdk_bond_mode

dpdk_bond_mode(1) = balance-slb

(StrOpt) Describes the mode of DPDK traffic bond configured by the CSS plugin. This value is suggested to be set as active-backup for BSP and vCEE based deployments.


Possible values:


  • active-backup

  • balance-slb


Related options:


  • install_css_dpdk

  • redundant_traffic_interface

(1)  This parameter is not available when install_css_dpdk or redundant_traffic_interface is set to False.


Table 0    CSS Configuration Attributes

Option = default value

(Type) Help string

install_css_dpdk = true

(BoolOpt) Install CSS with DPDK. Always expected to be the default value.


Possible values:


  • true

  • false


Related options:


  • dpdk_bond_mode

redundant_traffic_interface = true

(BoolOpt) Redundancy for traffic interfaces. For multi-server deployments the default value, true, is expected. For single server deployments, since only one traffic interface is present, the expected value is false.


Possible values:


  • true

  • false


Related options:


  • dpdk_bond_mode

dpdk_bond_mode(1) = balance-slb

(StrOpt) Describes the mode of DPDK traffic bond configured by the CSS plugin. This value is suggested to be set as active-backup for BSP and vCEE based deployments.


Possible values:


  • active-backup

  • balance-slb


Related options:


  • install_css_dpdk

  • redundant_traffic_interface

(1)  This parameter is not available when install_css_dpdk or redundant_traffic_interface is set to False.


3.2   High Availability

3.2.1   CM-HA

Note:  
This plugin will be available in a future release of CEE R6.

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

Plugin name: cm_ha

Depends on: Watchmen

Conflicts with: None

CEE Release Compatibility: R6.4

3.3   Security

3.3.1   Ericsson TLS

Note:  
This plugin will be available in a future release of CEE R6.

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: R6.4

Configuration Attributes:

Option = default value

(Type) Help string

openssl_ciphersuites = ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES128-SHA

(StrOpt) Cipher suites to be used for OpenSSL.


Possible values:


  • Valid cipher suites

openssl_protocols = TLSv1.2

(StrOpt) Specifies the OpenSSL protocol used for TLS.


Possible values:


  • TLSv1.1

  • TLSv1.2

gnutls_priority = NONE:+SUITEB128:+SUITEB192:+VERS-TLS-1.2

(StrOpt) GnuTLS priority used within the Ericsson TLS.


Possible values:


  • NONE:+SUITEB128:+SUITEB192:+VERS-TLS-1.2

Table 0    Ericsson TLS Configuration Attributes

Option = default value

(Type) Help string

openssl_ciphersuites = ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES128-SHA

(StrOpt) Cipher suites to be used for OpenSSL.


Possible values:


  • Valid cipher suites

openssl_protocols = TLSv1.2

(StrOpt) Specifies the OpenSSL protocol used for TLS.


Possible values:


  • TLSv1.1

  • TLSv1.2

gnutls_priority = NONE:+SUITEB128:+SUITEB192:+VERS-TLS-1.2

(StrOpt) GnuTLS priority used within the Ericsson TLS.


Possible values:


  • NONE:+SUITEB128:+SUITEB192:+VERS-TLS-1.2

3.3.2   LDAP

Note:  
This plugin will be available in a future release of CEE R6.

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

Plugin name: ericsson_ldap

Depends on: None

Conflicts with: None

CEE Release Compatibility: R6.4

3.3.3   IdAM

Note:  
This plugin will be available in a future release of CEE R6.

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

Plugin name: ericsson_idam

Depends on: LDAP

Conflicts with: None

CEE Release Compatibility: R6.4

3.4   Fault Management

3.4.1   Watchmen

Note:  
This plugin will be available in a future release of CEE R6.

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

Plugin name: ericsson_watchmen

Depends on: HCFramework, LDAP, IdAM

Conflicts with: None

CEE Release Compatibility: R6.4

Configuration Attributes:

Option = default value

(Type) Help string

galera_password

(StrOpt) Watchmen plugin requires galera database password.

Table 0    Watchmen Configuration Attributes

Option = default value

(Type) Help string

galera_password

(StrOpt) Watchmen plugin requires galera database password.

3.4.2   HCFramework

Note:  
This plugin will be available in a future release of CEE R6.

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

Plugin name: ericsson_hcframework

Depends on: LDAP, IdAM

Conflicts with: None

CEE Release Compatibility: R6.4

3.5   Performance Management

3.5.1   Zabbix

This plugin enables the integration of Zabbix component with CEE.

Plugin name: zabbix_monitoring

Depends on: None

Conflicts with: None

CEE Release Compatibility: R6.3

Configuration Attributes:

Option = default value

(Type) Help string

username = admin

(StrOpt) Username for Zabbix Administrator. The default value is admin.


Possible values:


  • A valid text as user name

password = Zabbix

(StrOpt) Password for Zabbix Administrator. If no value is specified, the default password will be used. It is recommended to specify a strong password.(1)


Possible values:


  • A valid password

db_password = fae2oom_aeR6

(StrOpt) Password for Zabbix Database. If no value is specified, the default password will be used. It is recommended to specify a strong password. (1)


Possible values:


  • A valid password

monitoring_password = Og1aaQivaiv1

(StrOpt) Password for monitoring user of Zabbix. If no value is specified, the default password will be used. It is recommended to specify a strong password. (1)


Possible values:


  • A valid password

(1)  Refer to the Security User Guide for the recommended password policies.


Table 0    Zabbix Configuration Attributes

Option = default value

(Type) Help string

username = admin

(StrOpt) Username for Zabbix Administrator. The default value is admin.


Possible values:


  • A valid text as user name

password = Zabbix

(StrOpt) Password for Zabbix Administrator. If no value is specified, the default password will be used. It is recommended to specify a strong password.(1)


Possible values:


  • A valid password

db_password = fae2oom_aeR6

(StrOpt) Password for Zabbix Database. If no value is specified, the default password will be used. It is recommended to specify a strong password. (1).


Possible values:


  • A valid password

monitoring_password = Og1aaQivaiv1

(StrOpt) Password for monitoring user of Zabbix. If no value is specified, the default password will be used. It is recommended to specify a strong password. (1)


Possible values:


  • A valid password

(1)  Refer to the Security User Guide for the recommended password policies.


3.5.2   PMAPI and PMReporter

This plugin enables the integration of PMAPI and PMReporter component with CEE.

Plugin name: ericsson_pmapi

Depends on: None

Conflicts with: None

CEE Release Compatibility: R6.4

Configuration Attributes:

Option = default value

(Type) Help string

Ceilometer_user_password

(StrOpt) Password used by PMReporter.

Table 0    PMAPI and PMReporter Configuration Attributes

Option = default value

(Type) Help string

Ceilometer_user_password

(StrOpt) Password used by PMReporter.

3.6   Infrastructure Management

3.6.1   NTP

Note:  
This plugin will be available in a future release of CEE R6.

This plugin enables the integration of NTP service with CEE.

Plugin name: ericsson-ntp

Depends on: None

Conflicts with: None

CEE Release Compatibility: R6.4

Configuration Attributes:

Option = default value

(Type) Help string

eri_ntp_check_connection = true

(BoolOpt)


Possible values:


  • true

  • false

eri_ntp_config = ntp-mirantis

(StrOpt) NTP configuration type


Possible values:


  • ntp-mirantis

  • ntp-cic

  • ntp-vcic


Related options:


  • eri_ntp_orphan

eri_ntp_orphan = false

(BoolOpt)


Possible values:


  • true

  • false

eri_ntp_orphan_stratum

(StrOpt) Orphan stratum level


Possible values:


  • 2 – 4


Related options:


  • eri_ntp_orphan

eri_ntp_authentication = None

(StrOpt) Authentication and encryption method


Possible values:


  • None (No authentication)

  • md5 (Authentication with md5 encryption)


Related options:


  • eri_ntp_auth_upstream_key

  • eri_ntp_auth_upstream_password

  • eri_ntp_auth_own_key

  • eri_ntp_auth_own_password

eri_ntp_auth_upstream_key

(StrOpt) Upstream key to use


Possible values:


  • 1 – 65535

eri_ntp_auth_upstream_password

(StrOpt) Upstream password

eri_ntp_auth_own_key

(StrOpt) Key used by upstream


Possible values:


  • 1 – 65535

eri_ntp_auth_own_password

(StrOpt) Password used by upstream

Table 0    NTP Configuration Attributes

Option = default value

(Type) Help string

eri_ntp_check_connection = true

(BoolOpt)


Possible values:


  • true

  • false

eri_ntp_config = ntp-mirantis

(StrOpt) NTP configuration type


Possible values:


  • ntp-mirantis

  • ntp-cic

  • ntp-vcic


Related options:


  • eri_ntp_orphan

eri_ntp_orphan = false

(BoolOpt)


Possible values:


  • true

  • false

eri_ntp_orphan_stratum

(StrOpt) Orphan stratum level


Possible values:


  • 2 – 4


Related options:


  • eri_ntp_orphan

eri_ntp_authentication = None

(StrOpt) Authentication and encryption method


Possible values:


  • None (No authentication)

  • md5(Authentication with md5 encryption)


Related options:


  • eri_ntp_auth_upstream_key

  • eri_ntp_auth_upstream_password

  • eri_ntp_auth_own_key

  • eri_ntp_auth_own_password

eri_ntp_auth_upstream_key

(StrOpt) Upstream key to use


Possible values:


  • 1 – 65535

eri_ntp_auth_upstream_password

(StrOpt) Upstream password

eri_ntp_auth_own_key

(StrOpt) Key used by upstream


Possible values:


  • 1 – 65535

eri_ntp_auth_own_password

(StrOpt) Password used by upstream

4   Optional Fuel Plugins for CEE

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

The optional plugins can be enabled or disabled depending on the configuration and the hardware setup.

4.1   Networking

4.1.1   SR-IOV

Note:  
This plugin will be available in a future release of CEE R6.

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

Plugin name: ericsson_sriov

Depends on: None

Conflicts with: None

CEE Release Compatibility: R6.4

4.1.2   Ericsson CSC

Note:  
This plugin will be available in a future release of CEE R6.

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

Plugin name: ericsson_csc

Depends on: None

Conflicts with: None

CEE Release Compatibility: R6.4

4.1.3   Extreme

Note:  
This plugin will be available in a future release of CEE R6.

This plugin enables the integration of Extreme switches with CEE.

Plugin name: extreme_plugin

Depends on: None

Conflicts with: None

CEE Release Compatibility: R6.4

Configuration Attributes:

Option = default value

(Type) Help string

install_extreme_plugin = true

(BoolOpt)


Possible values:


  • true

  • false

Table 0    Extreme Configuration Attributes

Option = default value

(Type) Help string

install_extreme_plugin = true

(BoolOpt)


Possible values:


  • true

  • false

4.2   Storage

4.2.1   EMC VNX

Note:  
This plugin will be available in a future release of CEE R6.

This plugin enables the integration of EMC VNX with CEE.

Plugin name: emc_vnx

Depends on: LDAP, IdAM

Conflicts with: None

CEE Release Compatibility: R6.4

Configuration Attributes:

Option = default value

(Type) Help string

cee_managed = true

(BoolOpt)


Possible values:


  • true

  • false

emc_username = admin

(StrOpt) EMC VNX username.

emc_password = ericsson

(StrOpt) EMC VNX password

emc_sp_a_ip = 192.168.2.12

(StrOpt) EMC VNX SP A IP

emc_sp_b_ip = 192.168.2.13

(StrOpt) EMC VNX SP B IP

emc_pool_name = cinderpool

(StrOpt) EMC VNX pool name

hw_type = VNX5400

(StrOpt) EMC VNX hardware type


Possible values:


  • VNX5400

  • VNX5500

Table 0    EMC VNX Configuration Attributes

Option = default value

(Type) Help string

cee_managed = true

(BoolOpt)


Possible values:


  • true

  • false

emc_username = admin

(StrOpt) EMC VNX username.

emc_password = ericsson

(StrOpt) EMC VNX password

emc_sp_a_ip = 192.168.2.12

(StrOpt) EMC VNX SP A IP

emc_sp_b_ip = 192.168.2.13

(StrOpt) EMC VNX SP B IP

emc_pool_name = cinderpool

(StrOpt) EMC VNX pool name

hw_type = VNX5400

(StrOpt) EMC VNX hardware type


Possible values:


  • VNX5400

  • VNX5500

4.2.2   EMC ScaleIO

Note:  
This plugin will be available in a future release of CEE R6.

This plugin enables the integration of EMC ScaleIO with CEE.

Plugin name: eri_scaleio_plugin

Depends on: LDAP, IdAM

Conflicts with: None

CEE Release Compatibility: R6.4

4.3   Infrastructure Management

4.3.1   HDS Agent

Note:  
This plugin will be available in a future release of CEE R6.

This plugin enables the integration of HDS Agent with CEE.

Plugin name: hds_agent

Depends on: None

Conflicts with: None

CEE Release Compatibility: R6.4



Copyright

© Ericsson AB 2016. All rights reserved. No part of this document may be reproduced in any form without the written permission of the copyright owner.

Disclaimer

The contents of this document are subject to revision without notice due to continued progress in methodology, design and manufacturing. Ericsson shall have no liability for any error or damage of any kind resulting from the use of this document.

Trademark List
All trademarks mentioned herein are the property of their respective owners. These are shown in the document Trademark Information.

    Fuel Plugin Configuration Guide         Cloud Execution Environment