From 14ac9e9a0f731c9a2490ab546db15983b6399bb7 Mon Sep 17 00:00:00 2001 From: Marcin Kuzminski Date: Mon, 6 Apr 2020 13:03:35 +0200 Subject: [PATCH] docs: updated docs on local archives changes --- docs/known-issues/known-issues.rst | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-) diff --git a/docs/known-issues/known-issues.rst b/docs/known-issues/known-issues.rst index d840b834..07e8d688 100644 --- a/docs/known-issues/known-issues.rst +++ b/docs/known-issues/known-issues.rst @@ -49,12 +49,16 @@ shipped with the optimal configuration as default. See the 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 / Ubuntu 18.04 ------------------------- +Newer Operating system locales +------------------------------ |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. +Mostly affected are: +- Fedora 23+ +- Ubuntu 18.04 +- CentOS / RHEL 8 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. @@ -74,8 +78,15 @@ To use the pre 2.27 locale-archive fix follow these steps: $ 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 +This should be added *both* in `enviroment` variable of `~/.rccontrol/supervisor/supervisord.ini` +e.g + +``` +[supervisord] +environment = HOME=/home/user/rhodecode,LOCALE_ARCHIVE=/YOUR-PATH/locale-archive` +``` + +and 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