Mercurial > kallithea

annotate docs/usage/troubleshooting.rst @ 2601:aa90719e8520 beta

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added troubleshooting section to docs
author Marcin Kuzminski <marcin@python-works.com>
date Sat, 14 Jul 2012 13:03:34 +0200
parents
children 8b8edfc25856 1a498b11f154
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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 ===============
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
5 Troubleshooting
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
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
8 :Q: **Missing static files?**
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
9 :A: Make sure either to set the `static_files = true` in the .ini file or
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
10 double check the root path for your http setup. It should point to
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
11 for example:
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
12 /home/my-virtual-python/lib/python2.6/site-packages/rhodecode/public
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
13
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
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
16 :Q: **Can't install celery/rabbitmq?**
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
17 :A: Don't worry RhodeCode works without them too. No extra setup is required.
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
18 Try out great celery docs for further help.
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
19
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
20 |
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
21
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
22 :Q: **Long lasting push timeouts?**
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
23 :A: Make sure you set a longer timeouts in your proxy/fcgi settings, timeouts
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
24 are caused by https server and not RhodeCode.
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
25
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
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
28 :Q: **Large pushes timeouts?**
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
29 :A: Make sure you set a proper max_body_size for the http server. Very often
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
30 Apache, Nginx or other http servers kill the connection due to to large
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
31 body.
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
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
35 :Q: **Apache doesn't pass basicAuth on pull/push?**
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
36 :A: Make sure you added `WSGIPassAuthorization true`.
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
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
40 :Q: **Git fails on push/pull?**
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
41 :A: Make sure you're using an wsgi http server that can handle chunked encoding
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
42 such as `waitress` or `gunicorn`
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 |
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
45
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
46 :Q: **How i use hooks in RhodeCode?**
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
47 :A: It's easy if they are python hooks just use advanced link in hooks section
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
48 in Admin panel, that works only for Mercurial. If you want to use githooks,
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
49 just install proper one in repository eg. create file in
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
50 `/gitrepo/hooks/pre-receive`. You can also use RhodeCode-extensions to
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
51 connect to callback hooks, for both Git and Mercurial.
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
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
55 :Q: **RhodeCode is slow for me, how can i make it faster?**
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
56 :A: See the :ref:`performance` section
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
57
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
58 For further questions search the `Issues tracker`_, or post a message in the
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
59 `google group rhodecode`_
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
60
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
61 .. _virtualenv: http://pypi.python.org/pypi/virtualenv
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
62 .. _python: http://www.python.org/
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
63 .. _mercurial: http://mercurial.selenic.com/
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
64 .. _celery: http://celeryproject.org/
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
65 .. _rabbitmq: http://www.rabbitmq.com/
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
66 .. _python-ldap: http://www.python-ldap.org/
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
67 .. _mercurial-server: http://www.lshift.net/mercurial-server.html
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
68 .. _PublishingRepositories: http://mercurial.selenic.com/wiki/PublishingRepositories
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
69 .. _Issues tracker: https://bitbucket.org/marcinkuzminski/rhodecode/issues
aa90719e8520 Added troubleshooting section to docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
70 .. _google group rhodecode: http://groups.google.com/group/rhodecode