engineering/unrhodecode
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: updated section about locale-archive problems

Browse source
This commit is contained in:
Marcin Kuzminski 2018-08-11 14:19:07 +02:00
parent bf88165cf3
commit 9e8409f5d1
1 changed files with 21 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

32
docs/known-issues/known-issues.rst
View file

@ -37,6 +37,7 @@ To convert the old version into a current version, clone the old
|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 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
---------
Fedora 23 / Ubuntu 18.04
------------------------
|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.
|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.
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
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:
1. Download the pre 2.27 locale-archive package
.. 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 information on boot.
[Install]
WantedBy=multi-user.target
.. _Github issue here: https://github.com/NixOS/nix/issues/599