<commit_before>Known Issues in Mirantis OpenStack 4.1
======================================

Hardcoded "admin" tenant breaks Neutron default networks
--------------------------------------------------------

Neutron default networks (net04 and net04-ext) are now properly created
if a user changes the name of the default tenant.
See `LP12267431 <https://bugs.launchpad.net/fuel/+bug/1267431>`_.

Murano OSTF test for Linux Apache Service fails
-----------------------------------------------

The Murano OSTF test for the Linux Apache service fails with an AssertionError.
See `LP1271089 <https://bugs.launchpad.net/fuel/+bug/1271089>`_.

CentOS issues using Neutron-enabled installations with VLANS
------------------------------------------------------------

Deployments using CentOS may run into problems
using Neutron VLANs or GRE (with VLAN tags on the management, storage or public networks).
The problems include poor performance, intermittent connectivity problems,
one VLAN but not others working, or total failure to pass traffic.
This is because the CentOS kernel is based on a pre-3.3 kernel
and so has poor support for VLAN tagged packets moving through OpenVSwitch (OVS) Bridges.
Ubuntu is not affected by this issue.

A workaround is to enable VLAN Splinters in OVS.
For CentOS, The Fuel UI Settings page can now deploy
with a VLAN splinters workaround enabled in two separate modes -- soft trunks and hard trunks:

*  The **soft trunks mode** configures OVS to enable splinters
   and attempts to automatically detect in-use VLANs.
   This provides the least amount of performance overhead
   but the traffic may not be passed onto the OVS bridge in some edge cases.

*  The **hard trunks mode** also configureS OVS to enable splinters
   but useS an explicitly defined list of all VLANs across all interfaces.
   This should prevent the occasional failures associated with the soft mode
   but requires that corresponding tags be created on all of the interfaces.
   This introduces additional performance overhead.
   In the hard trunks mode,  you should use fewer than 50 VLANs in the Neutron VLAN mode.

See `Advanced Network Configuration using Open VSwitch <http://docs.mirantis.com/fuel/fuel-4.1/reference-architecture.html?highlight=vlan%20splinters#advanced-network-configuration-using-open-vswitch>`_
for more information about using Open VSwitch..

GRE-enabled Neutron installation runs inter VM traffic through management network
---------------------------------------------------------------------------------

In all Neutron GRE installations,
a physical interface is used for both OpenStack management traffic and VM-to-VM communications.
This limitation is restricted to the UI only.
It is possible to use other physical interfaces when configured via the Fuel CLI.
See `LP 1285059 <https://bugs.launchpad.net/fuel/+bug/1285059>`_.

File injection into VMs fails on CentOS
---------------------------------------

VM creation may fail, issuing the following error:

::

  ERROR: Error injecting data into image 5e9f173d-aa6f-4153-a41a-8f59c651651e
  (Error mounting /var/lib/nova/instances/c0733320-0c11-48f9-863e-b7d54e8d0812/disk with libguestfs
  (command failed: LC_ALL=C '/usr/libexec/qemu-kvm' -nographic -help
  errno: No such file or directory

In this situation, the Nova service fails to inject files into VM instances.
This is due to a Nova/QEMU bug that may be related to an incorrect path,
but the details of the failure have not yet been determined.

Ceph RadosGW might not start on all controllers
-----------------------------------------------

In HA mode, RadosGW services may fail on some controller nodes during deployment
This can be fixed by manually starting the rados-gw service.
See `LP1261955 <https://bugs.launchpad.net/fuel/+bug/1261966>`_.

Health Check tests may fail in slow environments
------------------------------------------------

If multiple environments are deployed or if the environments are slow,
some tests may fail due to timeouts.
Reducing the load on the environment allows the tests to run successfully.

The ability to deploy Red Hat Enterprise Linux OpenStack Platform has been temporarily disabled
-----------------------------------------------------------------------------------------------

Previous versions of Mirantis OpenStack had an option to deploy<commit_msg>Add note about placing Ceph OSD on controllers<commit_after>Known Issues in Mirantis OpenStack 4.1
======================================

Hardcoded "admin" tenant breaks Neutron default networks
--------------------------------------------------------

Neutron default networks (net04 and net04-ext) are now properly created
if a user changes the name of the default tenant.
See `LP12267431 <https://bugs.launchpad.net/fuel/+bug/1267431>`_.

Murano OSTF test for Linux Apache Service fails
-----------------------------------------------

The Murano OSTF test for the Linux Apache service fails with an AssertionError.
See `LP1271089 <https://bugs.launchpad.net/fuel/+bug/1271089>`_.

CentOS issues using Neutron-enabled installations with VLANS
------------------------------------------------------------

Deployments using CentOS may run into problems
using Neutron VLANs or GRE (with VLAN tags on the management, storage or public networks).
The problems include poor performance, intermittent connectivity problems,
one VLAN but not others working, or total failure to pass traffic.
This is because the CentOS kernel is based on a pre-3.3 kernel
and so has poor support for VLAN tagged packets moving through OpenVSwitch (OVS) Bridges.
Ubuntu is not affected by this issue.

A workaround is to enable VLAN Splinters in OVS.
For CentOS, The Fuel UI Settings page can now deploy
with a VLAN splinters workaround enabled in two separate modes -- soft trunks and hard trunks:

*  The **soft trunks mode** configures OVS to enable splinters
   and attempts to automatically detect in-use VLANs.
   This provides the least amount of performance overhead
   but the traffic may not be passed onto the OVS bridge in some edge cases.

*  The **hard trunks mode** also configureS OVS to enable splinters
   but useS an explicitly defined list of all VLANs across all interfaces.
   This should prevent the occasional failures associated with the soft mode
   but requires that corresponding tags be created on all of the interfaces.
   This introduces additional performance overhead.
   In the hard trunks mode,  you should use fewer than 50 VLANs in the Neutron VLAN mode.

See `Advanced Network Configuration using Open VSwitch <http://docs.mirantis.com/fuel/fuel-4.1/reference-architecture.html?highlight=vlan%20splinters#advanced-network-configuration-using-open-vswitch>`_
for more information about using Open VSwitch..

GRE-enabled Neutron installation runs inter VM traffic through management network
---------------------------------------------------------------------------------

In all Neutron GRE installations,
a physical interface is used for both OpenStack management traffic and VM-to-VM communications.
This limitation is restricted to the UI only.
It is possible to use other physical interfaces when configured via the Fuel CLI.
See `LP 1285059 <https://bugs.launchpad.net/fuel/+bug/1285059>`_.

File injection into VMs fails on CentOS
---------------------------------------

VM creation may fail, issuing the following error:

::

  ERROR: Error injecting data into image 5e9f173d-aa6f-4153-a41a-8f59c651651e
  (Error mounting /var/lib/nova/instances/c0733320-0c11-48f9-863e-b7d54e8d0812/disk with libguestfs
  (command failed: LC_ALL=C '/usr/libexec/qemu-kvm' -nographic -help
  errno: No such file or directory

In this situation, the Nova service fails to inject files into VM instances.
This is due to a Nova/QEMU bug that may be related to an incorrect path,
but the details of the failure have not yet been determined.

Ceph RadosGW might not start on all controllers
-----------------------------------------------

In HA mode, RadosGW services may fail on some controller nodes during deployment
This can be fixed by manually starting the rados-gw service.
See `LP1261955 <https://bugs.launchpad.net/fuel/+bug/1261966>`_.

Health Check tests may fail in slow environments
------------------------------------------------

If multiple environments are deployed or if the environments are slow,
some tests may fail due to timeouts.
Reducing the load on the environment allows the tests to run successfully.

Placing Ceph OSD on Controller nodes is not recommended
-------------------------------------------------------

Placing Ceph OSD on Controllers is highly unadvisable because it can severely
degrade controller's performance. It's better to use separate storage nodes
if you have enough hardware.

The ability to deploy Red Hat Enterprise Linux OpenStack Platform has been temporarily disabled
-----------------------------------------------------------------------------------------------

Previous versions of Mirantis OpenStack had an option to deploy
{'fraction_non_alphanumeric': 0.15977443609022557, 'fraction_numerical': 0.02565236620964175, 'mean_word_length': 2.6948529411764706, 'pattern_counts': {'":': 0, '<': 13, '<?xml version=': 0, '>': 13, 'https://': 8, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '7311529', 'n_tokens_mistral': 2388, 'n_tokens_neox': 2103, 'n_words': 1092}