Mercurial > kallithea

annotate docs/upgrade.rst @ 2181:e1c1ebbe7346 beta

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
#419 don't strip passwords for login forms, make rhodecode more compatible with LDAP servers
author Marcin Kuzminski <marcin@python-works.com>
date Tue, 03 Apr 2012 00:02:25 +0200
parents 8dfb265fc954
children dc2584ba5fbc 008d9c6f7c92
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
642
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
1 .. _upgrade:
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
2
2095
Marcin Kuzminski <marcin@python-works.com>
parents: 2094
diff changeset
3 =======
642
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
4 Upgrade
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
5 =======
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
6
1092
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
7 Upgrading from Cheese Shop
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
8 --------------------------
642
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
9
1092
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
10 .. note::
1123
9472a0150bf0 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1092
diff changeset
11 Firstly, it is recommended that you **always** perform a database backup
9472a0150bf0 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1092
diff changeset
12 before doing an upgrade.
1092
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
13
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
14 The easiest way to upgrade ``rhodecode`` is to run::
642
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
15
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
16 easy_install -U rhodecode
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
17
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
18 Or::
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
19
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
20 pip install --upgrade rhodecode
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
21
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
22
1092
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
23 Then make sure you run the following command from the installation directory::
642
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
24
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
25 paster make-config RhodeCode production.ini
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
26
1092
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
27 This will display any changes made by the new version of RhodeCode to your
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
28 current configuration. It will try to perform an automerge. It's always better
2094
Marcin Kuzminski <marcin@python-works.com>
parents: 2071
diff changeset
29 to make a backup of your configuration file before hand and re check the
1123
9472a0150bf0 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1092
diff changeset
30 content after the automerge.
642
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
31
1062
053983a464e4 docs and readme update
Marcin Kuzminski <marcin@python-works.com>
parents: 845
diff changeset
32 .. note::
2094
Marcin Kuzminski <marcin@python-works.com>
parents: 2071
diff changeset
33 Please always make sure your .ini files are up to date. Often errors are
2071
8330d5778ba3 upgrade docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1123
diff changeset
34 caused by missing params added in new versions.
8330d5778ba3 upgrade docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1123
diff changeset
35
1062
053983a464e4 docs and readme update
Marcin Kuzminski <marcin@python-works.com>
parents: 845
diff changeset
36
1123
9472a0150bf0 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1092
diff changeset
37 It is also recommended that you rebuild the whoosh index after upgrading since
2071
8330d5778ba3 upgrade docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1123
diff changeset
38 the new whoosh version could introduce some incompatible index changes. Please
8330d5778ba3 upgrade docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1123
diff changeset
39 Read the changelog to see if there were any changes to whoosh.
845
a040597b070b docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 661
diff changeset
40
a040597b070b docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 661
diff changeset
41
1092
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
42 The final step is to upgrade the database. To do this simply run::
845
a040597b070b docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 661
diff changeset
43
1062
053983a464e4 docs and readme update
Marcin Kuzminski <marcin@python-works.com>
parents: 845
diff changeset
44 paster upgrade-db production.ini
845
a040597b070b docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 661
diff changeset
45
1092
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
46 This will upgrade the schema and update some of the defaults in the database,
1123
9472a0150bf0 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1092
diff changeset
47 and will always recheck the settings of the application, if there are no new
9472a0150bf0 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1092
diff changeset
48 options that need to be set.
845
a040597b070b docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 661
diff changeset
49
2115
8dfb265fc954 added info to ugprade docs to restart celery
Marcin Kuzminski <marcin@python-works.com>
parents: 2095
diff changeset
50 .. note::
8dfb265fc954 added info to ugprade docs to restart celery
Marcin Kuzminski <marcin@python-works.com>
parents: 2095
diff changeset
51 If you're using Celery, make sure you restart all instances of it after
8dfb265fc954 added info to ugprade docs to restart celery
Marcin Kuzminski <marcin@python-works.com>
parents: 2095
diff changeset
52 upgrade.
642
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
53
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
54 .. _virtualenv: http://pypi.python.org/pypi/virtualenv
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
55 .. _python: http://www.python.org/
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
56 .. _mercurial: http://mercurial.selenic.com/
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
57 .. _celery: http://celeryproject.org/
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
58 .. _rabbitmq: http://www.rabbitmq.com/