.. _control-known-issues:

Known Issues
============

MySQL Upgrade Issue
-------------------

Upgrading a |RCEE| version that runs with MySQL currently requires some
reconfiguring of your :file:`production.ini` file so that an ``IP Address`` is
set and not ``localhost``.

Fedora 23
---------

|RCC| does not run perfectly on Fedora 23 due to a locale issue. This is a
known issue under investigation due to the Nix packaging of the product, see the
`Github issue here`_. |RCC| runs fine on Fedora 21.

To work around this problem, you need to point ``$LOCAL_ARCHIVE`` to the
workaround locale package.

1. Download this package:
   http://lipa.ms.mff.cuni.cz/~cunav5am/nix/locale-archive

2. Point ``$LOCAL_ARCHIVE`` to the locale package.

.. code-block:: bash

    $ export LOCALE_ARCHIVE=/home/VERSION/locale-archive # change to your path

.. _Github issue here: https://github.com/NixOS/nix/issues/599

If you happen to be running |RCC| from systemd, use the following
example to pass the correct locale information on boot.

.. code-block:: ini

    [Unit]
    Description=Rhodecode
    After=network.target

    [Service]
    Type=forking
    User=scm
    Environment="LOCALE_ARCHIVE=/YOUR-PATH/locale-archive"
    ExecStart=/YOUR-PATH/.rccontrol-profile/bin/rccontrol-self-init

    [Install]
    WantedBy=multi-user.target