Mercurial > kallithea
annotate docs/upgrade.rst @ 2074:6c6718c06ea2
merge beta into stable
author | Marcin Kuzminski <marcin@python-works.com> |
---|---|
date | Wed, 29 Feb 2012 23:11:13 +0200 |
parents | bf263968da47 8330d5778ba3 |
children | 934906f028b5 |
rev | line source |
---|---|
640 | 1 .. _upgrade: |
2 | |
3 Upgrade | |
4 ======= | |
5 | |
1092
8af52e1224ff
merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents:
1062
diff
changeset
|
6 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
|
7 -------------------------- |
640 | 8 |
1092
8af52e1224ff
merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents:
1062
diff
changeset
|
9 .. note:: |
1123 | 10 Firstly, it is recommended that you **always** perform a database backup |
11 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
|
12 |
8af52e1224ff
merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents:
1062
diff
changeset
|
13 The easiest way to upgrade ``rhodecode`` is to run:: |
640 | 14 |
15 easy_install -U rhodecode | |
16 | |
17 Or:: | |
18 | |
19 pip install --upgrade rhodecode | |
20 | |
21 | |
1092
8af52e1224ff
merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents:
1062
diff
changeset
|
22 Then make sure you run the following command from the installation directory:: |
640 | 23 |
24 paster make-config RhodeCode production.ini | |
25 | |
1092
8af52e1224ff
merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents:
1062
diff
changeset
|
26 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
|
27 current configuration. It will try to perform an automerge. It's always better |
1123 | 28 to make a backup of your configuration file before hand and recheck the |
29 content after the automerge. | |
640 | 30 |
1062
053983a464e4
docs and readme update
Marcin Kuzminski <marcin@python-works.com>
parents:
845
diff
changeset
|
31 .. note:: |
2071
8330d5778ba3
upgrade docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
1123
diff
changeset
|
32 Please always make sure your .ini files are upto date. Often errors are |
8330d5778ba3
upgrade docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
1123
diff
changeset
|
33 caused by missing params added in new versions. |
8330d5778ba3
upgrade docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
1123
diff
changeset
|
34 |
1062
053983a464e4
docs and readme update
Marcin Kuzminski <marcin@python-works.com>
parents:
845
diff
changeset
|
35 |
1123 | 36 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
|
37 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
|
38 Read the changelog to see if there were any changes to whoosh. |
845 | 39 |
40 | |
1092
8af52e1224ff
merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents:
1062
diff
changeset
|
41 The final step is to upgrade the database. To do this simply run:: |
845 | 42 |
1062
053983a464e4
docs and readme update
Marcin Kuzminski <marcin@python-works.com>
parents:
845
diff
changeset
|
43 paster upgrade-db production.ini |
845 | 44 |
1092
8af52e1224ff
merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents:
1062
diff
changeset
|
45 This will upgrade the schema and update some of the defaults in the database, |
1123 | 46 and will always recheck the settings of the application, if there are no new |
47 options that need to be set. | |
845 | 48 |
640 | 49 |
50 .. _virtualenv: http://pypi.python.org/pypi/virtualenv | |
51 .. _python: http://www.python.org/ | |
52 .. _mercurial: http://mercurial.selenic.com/ | |
53 .. _celery: http://celeryproject.org/ | |
54 .. _rabbitmq: http://www.rabbitmq.com/ |