##// END OF EJS Templates
docs: updated docs on local archives changes
marcink -
r4295:8e8f835a default
parent child Browse files
Show More
@@ -1,98 +1,109 b''
1 .. _known-issues:
1 .. _known-issues:
2
2
3 Known Issues
3 Known Issues
4 ============
4 ============
5
5
6 Subversion Issues
6 Subversion Issues
7 -----------------
7 -----------------
8
8
9 Limited |svn| support has been achieved for this release,
9 Limited |svn| support has been achieved for this release,
10 |release|. The following known issues are in development for improvement.
10 |release|. The following known issues are in development for improvement.
11
11
12 * |svn| |repo| creation:
12 * |svn| |repo| creation:
13 Terminating the VCS Server during remote importation of |svn| |repos| leaves
13 Terminating the VCS Server during remote importation of |svn| |repos| leaves
14 the the process still running in the background.
14 the the process still running in the background.
15
15
16 * |svn| |repo| checkin/checkout:
16 * |svn| |repo| checkin/checkout:
17 |svn| cloning support is not enabled by default. Please contact support if
17 |svn| cloning support is not enabled by default. Please contact support if
18 you want it enabled.
18 you want it enabled.
19
19
20 Windows Upload
20 Windows Upload
21 --------------
21 --------------
22
22
23 There can be an issue with uploading files from web interface on Windows,
23 There can be an issue with uploading files from web interface on Windows,
24 and afterwards users cannot properly clone or synchronize with the repository.
24 and afterwards users cannot properly clone or synchronize with the repository.
25
25
26 Early testing shows that often uploading files via HTML forms on Windows
26 Early testing shows that often uploading files via HTML forms on Windows
27 includes the full path of the file being uploaded and not the name of the file.
27 includes the full path of the file being uploaded and not the name of the file.
28
28
29 Old Format of Git Repositories
29 Old Format of Git Repositories
30 ------------------------------
30 ------------------------------
31
31
32 There is an issue when trying to import old |git| format |repos| into recent
32 There is an issue when trying to import old |git| format |repos| into recent
33 versions of |RCE|. This issue can occur when importing from external |git|
33 versions of |RCE|. This issue can occur when importing from external |git|
34 repositories or from older versions of |RCE| (<=2.2.7).
34 repositories or from older versions of |RCE| (<=2.2.7).
35
35
36 To convert the old version into a current version, clone the old
36 To convert the old version into a current version, clone the old
37 |repo| into a local machine using a recent |git| client, then push it to a new
37 |repo| into a local machine using a recent |git| client, then push it to a new
38 |repo| inside |RCE|.
38 |repo| inside |RCE|.
39
39
40
40
41 VCS Server Memory Consumption
41 VCS Server Memory Consumption
42 -----------------------------
42 -----------------------------
43
43
44 The VCS Server cache grows without limits if not configured correctly. This
44 The VCS Server cache grows without limits if not configured correctly. This
45 applies to |RCE| versions prior to the 3.3.2 releases, as 3.3.2
45 applies to |RCE| versions prior to the 3.3.2 releases, as 3.3.2
46 shipped with the optimal configuration as default. See the
46 shipped with the optimal configuration as default. See the
47 :ref:`vcs-server-maintain` section for details.
47 :ref:`vcs-server-maintain` section for details.
48
48
49 To fix this issue, upgrade to |RCE| 3.3.2 or greater, and if you discover
49 To fix this issue, upgrade to |RCE| 3.3.2 or greater, and if you discover
50 memory consumption issues check the VCS Server settings.
50 memory consumption issues check the VCS Server settings.
51
51
52 Fedora 23 / Ubuntu 18.04
52 Newer Operating system locales
53 ------------------------
53 ------------------------------
54
54
55 |RCC| has a know problem with locales, due to changes in glibc 2.27+ which affects
55 |RCC| has a know problem with locales, due to changes in glibc 2.27+ which affects
56 the local-archive format, which is now incompatible with our used glibc 2.26.
56 the local-archive format, which is now incompatible with our used glibc 2.26.
57
57
58 Mostly affected are:
59 - Fedora 23+
60 - Ubuntu 18.04
61 - CentOS / RHEL 8
58
62
59 To work around this problem, you need set path to ``$LOCAL_ARCHIVE`` to the
63 To work around this problem, you need set path to ``$LOCAL_ARCHIVE`` to the
60 locale package in older pre glibc 2.27 format, or set `LC_ALL=C` in your enviroment.
64 locale package in older pre glibc 2.27 format, or set `LC_ALL=C` in your enviroment.
61
65
62 To use the pre 2.27 locale-archive fix follow these steps:
66 To use the pre 2.27 locale-archive fix follow these steps:
63
67
64 1. Download the pre 2.27 locale-archive package
68 1. Download the pre 2.27 locale-archive package
65
69
66 .. code-block:: bash
70 .. code-block:: bash
67
71
68 wget https://dls.rhodecode.com/assets/locale-archive
72 wget https://dls.rhodecode.com/assets/locale-archive
69
73
70
74
71 2. Point ``$LOCAL_ARCHIVE`` to the locale package.
75 2. Point ``$LOCAL_ARCHIVE`` to the locale package.
72
76
73 .. code-block:: bash
77 .. code-block:: bash
74
78
75 $ export LOCALE_ARCHIVE=/home/USER/locale-archive # change to your path
79 $ export LOCALE_ARCHIVE=/home/USER/locale-archive # change to your path
76
80
77 This can either added in `~/.rccontrol/supervisor/supervisord.ini`
81 This should be added *both* in `enviroment` variable of `~/.rccontrol/supervisor/supervisord.ini`
78 or in user .bashrc/.zshrc etc, or via a startup script that
82 e.g
83
84 ```
85 [supervisord]
86 environment = HOME=/home/user/rhodecode,LOCALE_ARCHIVE=/YOUR-PATH/locale-archive`
87 ```
88
89 and in user .bashrc/.zshrc etc, or via a startup script that
79 runs `rccontrol self-init`
90 runs `rccontrol self-init`
80
91
81 If you happen to be running |RCC| from systemd, use the following
92 If you happen to be running |RCC| from systemd, use the following
82 example to pass the correct locale information on boot.
93 example to pass the correct locale information on boot.
83
94
84 .. code-block:: ini
95 .. code-block:: ini
85
96
86 [Unit]
97 [Unit]
87 Description=Rhodecode
98 Description=Rhodecode
88 After=network.target
99 After=network.target
89
100
90 [Service]
101 [Service]
91 Type=forking
102 Type=forking
92 User=scm
103 User=scm
93 Environment="LOCALE_ARCHIVE=/YOUR-PATH/locale-archive"
104 Environment="LOCALE_ARCHIVE=/YOUR-PATH/locale-archive"
94 ExecStart=/YOUR-PATH/.rccontrol-profile/bin/rccontrol-self-init
105 ExecStart=/YOUR-PATH/.rccontrol-profile/bin/rccontrol-self-init
95
106
96 [Install]
107 [Install]
97 WantedBy=multi-user.target
108 WantedBy=multi-user.target
98
109
General Comments 0
You need to be logged in to leave comments. Login now