diff --git a/docs/known-issues/known-issues.rst b/docs/known-issues/known-issues.rst --- a/docs/known-issues/known-issues.rst +++ b/docs/known-issues/known-issues.rst @@ -37,6 +37,7 @@ To convert the old version into a curren |repo| into a local machine using a recent |git| client, then push it to a new |repo| inside |RCE|. + VCS Server Memory Consumption ----------------------------- @@ -48,24 +49,34 @@ shipped with the optimal configuration a To fix this issue, upgrade to |RCE| 3.3.2 or greater, and if you discover memory consumption issues check the VCS Server settings. -Fedora 23 ---------- +Fedora 23 / Ubuntu 18.04 +------------------------ + +|RCC| has a know problem with locales, due to changes in glibc 2.27+ which affects +the local-archive format, which is now incompatible with our used glibc 2.26. + -|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 set path to ``$LOCAL_ARCHIVE`` to the +locale package in older pre glibc 2.27 format, or set `LC_ALL=C` in your enviroment. + +To use the pre 2.27 locale-archive fix follow these steps: -To work around this problem, you need to point ``$LOCAL_ARCHIVE`` to the -workaround locale package. +1. Download the pre 2.27 locale-archive package -1. Download this package: - http://lipa.ms.mff.cuni.cz/~cunav5am/nix/locale-archive +.. code-block:: bash + + wget https://dls.rhodecode.com/assets/locale-archive + 2. Point ``$LOCAL_ARCHIVE`` to the locale package. .. code-block:: bash - $ export LOCALE_ARCHIVE=/home/VERSION/locale-archive # change to your path + $ export LOCALE_ARCHIVE=/home/USER/locale-archive # change to your path + +This can either added in `~/.rccontrol/supervisor/supervisord.ini` +or in user .bashrc/.zshrc etc, or via a startup script that +runs `rccontrol self-init` If you happen to be running |RCC| from systemd, use the following example to pass the correct locale information on boot. @@ -85,4 +96,3 @@ example to pass the correct locale infor [Install] WantedBy=multi-user.target -.. _Github issue here: https://github.com/NixOS/nix/issues/599