Mercurial > kallithea

annotate docs/upgrade.rst @ 1936:ba445351cf5e

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
backported #341
author Marcin Kuzminski <marcin@python-works.com>
date Sat, 21 Jan 2012 07:08:43 +0200
parents bf263968da47
children 6c6718c06ea2
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
640
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
1 .. _upgrade:
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
2
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
3 Upgrade
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
4 =======
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
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
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
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
9472a0150bf0 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1092
diff changeset
10 Firstly, it is recommended that you **always** perform a database backup
9472a0150bf0 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1092
diff changeset
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
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
14
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
15 easy_install -U rhodecode
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
16
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
17 Or::
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
18
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
19 pip install --upgrade rhodecode
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
20
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
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
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
23
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
24 paster make-config RhodeCode production.ini
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
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
9472a0150bf0 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1092
diff changeset
28 to make a backup of your configuration file before hand and recheck the
9472a0150bf0 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1092
diff changeset
29 content after the automerge.
640
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
30
1062
053983a464e4 docs and readme update
Marcin Kuzminski <marcin@python-works.com>
parents: 845
diff changeset
31 .. note::
053983a464e4 docs and readme update
Marcin Kuzminski <marcin@python-works.com>
parents: 845
diff changeset
32 The next steps only apply to upgrading from non bugfix releases eg. from
1092
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
33 any minor or major releases. Bugfix releases (eg. 1.1.2->1.1.3) will
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
34 not have any database schema changes or whoosh library updates.
1062
053983a464e4 docs and readme update
Marcin Kuzminski <marcin@python-works.com>
parents: 845
diff changeset
35
1123
9472a0150bf0 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1092
diff changeset
36 It is also recommended that you rebuild the whoosh index after upgrading since
9472a0150bf0 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1092
diff changeset
37 the new whoosh version could introduce some incompatible index changes.
845
a040597b070b docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 661
diff changeset
38
a040597b070b docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 661
diff changeset
39
1092
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
40 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
41
1062
053983a464e4 docs and readme update
Marcin Kuzminski <marcin@python-works.com>
parents: 845
diff changeset
42 paster upgrade-db production.ini
845
a040597b070b docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 661
diff changeset
43
1092
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
44 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
45 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
46 options that need to be set.
845
a040597b070b docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 661
diff changeset
47
640
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
48
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
49 .. _virtualenv: http://pypi.python.org/pypi/virtualenv
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
50 .. _python: http://www.python.org/
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
51 .. _mercurial: http://mercurial.selenic.com/
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
52 .. _celery: http://celeryproject.org/
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
53 .. _rabbitmq: http://www.rabbitmq.com/