Mercurial > kallithea

comparison docs/usage/troubleshooting.rst @ 4955:4e6dfdb3fa01

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
docs: English and consistency corrections
author Michael V. DePalatis <mike@depalatis.net>
date Tue, 31 Mar 2015 22:15:38 +0200
parents 03bbd33bc084
children 22a3fa3c4254
comparison
equal deleted inserted replaced
4954:14f063657078 4955:4e6dfdb3fa01
4 =============== 4 ===============
5 Troubleshooting 5 Troubleshooting
6 =============== 6 ===============
7 7
8 :Q: **Missing static files?** 8 :Q: **Missing static files?**
9 :A: Make sure either to set the `static_files = true` in the .ini file or 9 :A: Make sure either to set the ``static_files = true`` in the .ini file or
10 double check the root path for your http setup. It should point to 10 double check the root path for your http setup. It should point to
11 for example: 11 for example:
12 /home/my-virtual-python/lib/python2.7/site-packages/kallithea/public 12 ``/home/my-virtual-python/lib/python2.7/site-packages/kallithea/public``
13 13
14 | 14 |
15 15
16 :Q: **Can't install celery/rabbitmq?** 16 :Q: **Can't install celery/rabbitmq?**
17 :A: Don't worry Kallithea works without them too. No extra setup is required. 17 :A: Don't worry. Kallithea works without them, too. No extra setup is required.
18 Try out great celery docs for further help. 18 Try out the great Celery docs for further help.
19 19
20 | 20 |
21 21
22 :Q: **Long lasting push timeouts?** 22 :Q: **Long lasting push timeouts?**
23 :A: Make sure you set a longer timeouts in your proxy/fcgi settings, timeouts 23 :A: Make sure you set a longer timeout in your proxy/fcgi settings. Timeouts
24 are caused by https server and not Kallithea. 24 are caused by the http server and not Kallithea.
25 25
26 | 26 |
27 27
28 :Q: **Large pushes timeouts?** 28 :Q: **Large pushes timeouts?**
29 :A: Make sure you set a proper max_body_size for the http server. Very often 29 :A: Make sure you set a proper ``max_body_size`` for the http server. Very often
30 Apache, Nginx or other http servers kill the connection due to to large 30 Apache, Nginx, or other http servers kill the connection due to to large
31 body. 31 body.
32 32
33 | 33 |
34 34
35 :Q: **Apache doesn't pass basicAuth on pull/push?** 35 :Q: **Apache doesn't pass basicAuth on pull/push?**
36 :A: Make sure you added `WSGIPassAuthorization true`. 36 :A: Make sure you added ``WSGIPassAuthorization true``.
37 37
38 | 38 |
39 39
40 :Q: **Git fails on push/pull?** 40 :Q: **Git fails on push/pull?**
41 :A: Make sure you're using an wsgi http server that can handle chunked encoding 41 :A: Make sure you're using a WSGI http server that can handle chunked encoding
42 such as `waitress` or `gunicorn`. 42 such as ``waitress`` or ``gunicorn``.
43 43
44 | 44 |
45 45
46 :Q: **How can I use hooks in Kallithea?** 46 :Q: **How can I use hooks in Kallithea?**
47 :A: It's easy if they are python hooks just use advanced link in hooks section 47 :A: It's easy if they are Python hooks: just use advanced link in
48 in Admin panel, that works only for Mercurial. If you want to use githooks, 48 hooks section in Admin panel, that works only for Mercurial. If
49 just install proper one in repository eg. create file in 49 you want to use Git hooks, just install th proper one in the repository,
50 `/gitrepo/hooks/pre-receive`. You can also use Kallithea-extensions to 50 e.g., create a file `/gitrepo/hooks/pre-receive`. You can also use
51 connect to callback hooks, for both Git and Mercurial. 51 Kallithea-extensions to connect to callback hooks, for both Git
52 and Mercurial.
52 53
53 | 54 |
54 55
55 :Q: **Kallithea is slow for me, how can I make it faster?** 56 :Q: **Kallithea is slow for me, how can I make it faster?**
56 :A: See the :ref:`performance` section. 57 :A: See the :ref:`performance` section.
62 63
63 | 64 |
64 65
65 :Q: **Requests hanging on Windows** 66 :Q: **Requests hanging on Windows**
66 :A: Please try out with disabled Antivirus software, there are some known problems with Eset Anitivirus. Make sure 67 :A: Please try out with disabled Antivirus software, there are some known problems with Eset Anitivirus. Make sure
67 you have installed latest windows patches (especially KB2789397). 68 you have installed the latest Windows patches (especially KB2789397).
68 69
69 70
70 .. _virtualenv: http://pypi.python.org/pypi/virtualenv 71 .. _virtualenv: http://pypi.python.org/pypi/virtualenv
71 .. _python: http://www.python.org/ 72 .. _python: http://www.python.org/
72 .. _mercurial: http://mercurial.selenic.com/ 73 .. _mercurial: http://mercurial.selenic.com/