Mercurial > kallithea
annotate docs/usage/troubleshooting.rst @ 5999:58809814b51d
hooks: set Windows stderr output mode to binary
This prevents Python (or the Windows console) from replacing \n with \r\n. The
extra \r made exception output show up with empty lines.
Assuming we only get text and never binary data on stderr, an alternative
solution could be to strip trailing whitespace ...
author | domruf <dominikruf@gmail.com> |
---|---|
date | Tue, 14 Jun 2016 21:23:51 +0200 |
parents | 84d2a9aaa1a4 |
children | 9c6f717823e1 |
rev | line source |
---|---|
2601
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
1 .. _troubleshooting: |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
2 |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
3 =============== |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
4 Troubleshooting |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
5 =============== |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
6 |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
7 :Q: **Missing static files?** |
4955
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
8 :A: Make sure either to set the ``static_files = true`` in the .ini file or |
3224
8b8edfc25856
whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents:
2601
diff
changeset
|
9 double check the root path for your http setup. It should point to |
2601
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
10 for example: |
4955
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
11 ``/home/my-virtual-python/lib/python2.7/site-packages/kallithea/public`` |
3224
8b8edfc25856
whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents:
2601
diff
changeset
|
12 |
8b8edfc25856
whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents:
2601
diff
changeset
|
13 | |
2601
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
14 |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
15 :Q: **Can't install celery/rabbitmq?** |
4955
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
16 :A: Don't worry. Kallithea works without them, too. No extra setup is required. |
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
17 Try out the great Celery docs for further help. |
2601
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
18 |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
19 | |
3224
8b8edfc25856
whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents:
2601
diff
changeset
|
20 |
2601
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
21 :Q: **Long lasting push timeouts?** |
4955
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
22 :A: Make sure you set a longer timeout in your proxy/fcgi settings. Timeouts |
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
23 are caused by the http server and not Kallithea. |
3224
8b8edfc25856
whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents:
2601
diff
changeset
|
24 |
8b8edfc25856
whitespace cleanup
Marcin Kuzminski <marcin@python-works.com>
parents:
2601
diff
changeset
|
25 | |
2601
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
26 |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
27 :Q: **Large pushes timeouts?** |
4955
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
28 :A: Make sure you set a proper ``max_body_size`` for the http server. Very often |
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
29 Apache, Nginx, or other http servers kill the connection due to to large |
2601
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
30 body. |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
31 |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
32 | |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
33 |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
34 :Q: **Apache doesn't pass basicAuth on pull/push?** |
4955
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
35 :A: Make sure you added ``WSGIPassAuthorization true``. |
2601
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
36 |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
37 | |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
38 |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
39 :Q: **Git fails on push/pull?** |
4955
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
40 :A: Make sure you're using a WSGI http server that can handle chunked encoding |
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
41 such as ``waitress`` or ``gunicorn``. |
2601
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
42 |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
43 | |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
44 |
4902 | 45 :Q: **How can I use hooks in Kallithea?** |
4955
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
46 :A: It's easy if they are Python hooks: just use advanced link in |
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
47 hooks section in Admin panel, that works only for Mercurial. If |
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
48 you want to use Git hooks, just install th proper one in the repository, |
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
49 e.g., create a file `/gitrepo/hooks/pre-receive`. You can also use |
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
50 Kallithea-extensions to connect to callback hooks, for both Git |
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
51 and Mercurial. |
2601
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
52 |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
53 | |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
54 |
4902 | 55 :Q: **Kallithea is slow for me, how can I make it faster?** |
56 :A: See the :ref:`performance` section. | |
2601
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
57 |
3240
af2059eead28
troubleshooting docs, added modwsgi unicode problems link from django
Marcin Kuzminski <marcin@python-works.com>
parents:
3224
diff
changeset
|
58 | |
af2059eead28
troubleshooting docs, added modwsgi unicode problems link from django
Marcin Kuzminski <marcin@python-works.com>
parents:
3224
diff
changeset
|
59 |
af2059eead28
troubleshooting docs, added modwsgi unicode problems link from django
Marcin Kuzminski <marcin@python-works.com>
parents:
3224
diff
changeset
|
60 :Q: **UnicodeDecodeError on Apache mod_wsgi** |
4902 | 61 :A: Please read: https://docs.djangoproject.com/en/dev/howto/deployment/wsgi/modwsgi/#if-you-get-a-unicodeencodeerror. |
3337
4a99684543f7
fixes #753 inform about some problems with antivirus software in RhodeCode
Marcin Kuzminski <marcin@python-works.com>
parents:
3240
diff
changeset
|
62 |
4a99684543f7
fixes #753 inform about some problems with antivirus software in RhodeCode
Marcin Kuzminski <marcin@python-works.com>
parents:
3240
diff
changeset
|
63 | |
4a99684543f7
fixes #753 inform about some problems with antivirus software in RhodeCode
Marcin Kuzminski <marcin@python-works.com>
parents:
3240
diff
changeset
|
64 |
4a99684543f7
fixes #753 inform about some problems with antivirus software in RhodeCode
Marcin Kuzminski <marcin@python-works.com>
parents:
3240
diff
changeset
|
65 :Q: **Requests hanging on Windows** |
5822 | 66 :A: Please try out with disabled Antivirus software, there are some known problems with Eset Antivirus. Make sure |
4955
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
67 you have installed the latest Windows patches (especially KB2789397). |
3337
4a99684543f7
fixes #753 inform about some problems with antivirus software in RhodeCode
Marcin Kuzminski <marcin@python-works.com>
parents:
3240
diff
changeset
|
68 |
3240
af2059eead28
troubleshooting docs, added modwsgi unicode problems link from django
Marcin Kuzminski <marcin@python-works.com>
parents:
3224
diff
changeset
|
69 |
2601
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
70 .. _virtualenv: http://pypi.python.org/pypi/virtualenv |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
71 .. _python: http://www.python.org/ |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
72 .. _mercurial: http://mercurial.selenic.com/ |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
73 .. _celery: http://celeryproject.org/ |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
74 .. _rabbitmq: http://www.rabbitmq.com/ |
aa90719e8520
Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
75 .. _python-ldap: http://www.python-ldap.org/ |