Mercurial > kallithea

annotate docs/upgrade.rst @ 1103:918c0b600a06 beta

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
changelog update, bumped mako version in setup
author Marcin Kuzminski <marcin@python-works.com>
date Sun, 27 Feb 2011 03:31:01 +0100
parents 8af52e1224ff
children 9472a0150bf0
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
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
3 Upgrade
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
4 =======
674ecf21de85 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 --------------------------
642
674ecf21de85 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::
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
10 Firstly, it is recommended that you **always** perform a database backup before doing an upgrade.
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
11
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
12 The easiest way to upgrade ``rhodecode`` is to run::
642
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
13
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
14 easy_install -U rhodecode
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 Or::
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 pip install --upgrade rhodecode
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
1092
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
21 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
22
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
23 paster make-config RhodeCode production.ini
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
24
1092
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
25 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
26 current configuration. It will try to perform an automerge. It's always better
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
27 to make a backup of your configuration file before hand and recheck the content after the automerge.
642
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
28
1062
053983a464e4 docs and readme update
Marcin Kuzminski <marcin@python-works.com>
parents: 845
diff changeset
29 .. note::
053983a464e4 docs and readme update
Marcin Kuzminski <marcin@python-works.com>
parents: 845
diff changeset
30 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
31 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
32 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
33
1092
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
34 It is also recommended that you rebuild the whoosh index after upgrading since the new whoosh
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
35 version could introduce some incompatible index changes.
845
a040597b070b docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 661
diff changeset
36
a040597b070b docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 661
diff changeset
37
1092
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
38 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
39
1062
053983a464e4 docs and readme update
Marcin Kuzminski <marcin@python-works.com>
parents: 845
diff changeset
40 paster upgrade-db production.ini
845
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 This will upgrade the schema and update some of the defaults in the database,
8af52e1224ff merge docs in beta with those corrected by Jason Harris
Marcin Kuzminski <marcin@python-works.com>
parents: 1062
diff changeset
43 and will always recheck the settings of the application, if there are no new options
845
a040597b070b docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 661
diff changeset
44 that need to be set.
a040597b070b docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 661
diff changeset
45
642
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
46
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
47 .. _virtualenv: http://pypi.python.org/pypi/virtualenv
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
48 .. _python: http://www.python.org/
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
49 .. _mercurial: http://mercurial.selenic.com/
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
50 .. _celery: http://celeryproject.org/
674ecf21de85 docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
51 .. _rabbitmq: http://www.rabbitmq.com/