Mercurial > kallithea

annotate docs/upgrade.rst @ 1237:f7bb54f8c20f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
fixed archive names, added setup command to contributing docs.
author Marcin Kuzminski <marcin@python-works.com>
date Sat, 09 Apr 2011 20:15:18 +0200
parents 93b980ebee55
children bf263968da47
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
1091
e67786cb2afa - Further corrections.
jfh <jason@jasonfharris.com>
parents: 1071
diff changeset
6 Upgrading from Cheese Shop
1095
3cdacd152b24 fixed sphinx build errors
Marcin Kuzminski <marcin@python-works.com>
parents: 1091
diff changeset
7 --------------------------
640
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
8
1091
e67786cb2afa - Further corrections.
jfh <jason@jasonfharris.com>
parents: 1071
diff changeset
9 .. note::
1136
93b980ebee55 changes for release 1.1.5
Marcin Kuzminski <marcin@python-works.com>
parents: 1095
diff changeset
10 Firstly, it is recommended that you **always** perform a database backup
93b980ebee55 changes for release 1.1.5
Marcin Kuzminski <marcin@python-works.com>
parents: 1095
diff changeset
11 before doing an upgrade.
1091
e67786cb2afa - Further corrections.
jfh <jason@jasonfharris.com>
parents: 1071
diff changeset
12
e67786cb2afa - Further corrections.
jfh <jason@jasonfharris.com>
parents: 1071
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
1091
e67786cb2afa - Further corrections.
jfh <jason@jasonfharris.com>
parents: 1071
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
1091
e67786cb2afa - Further corrections.
jfh <jason@jasonfharris.com>
parents: 1071
diff changeset
26 This will display any changes made by the new version of RhodeCode to your
e67786cb2afa - Further corrections.
jfh <jason@jasonfharris.com>
parents: 1071
diff changeset
27 current configuration. It will try to perform an automerge. It's always better
1136
93b980ebee55 changes for release 1.1.5
Marcin Kuzminski <marcin@python-works.com>
parents: 1095
diff changeset
28 to make a backup of your configuration file before hand and recheck the
93b980ebee55 changes for release 1.1.5
Marcin Kuzminski <marcin@python-works.com>
parents: 1095
diff changeset
29 content after the automerge.
640
afd98d1f817e docs update
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
30
1071
bdc438fb4fe4 Fixes for release 1.1.4
Marcin Kuzminski <marcin@python-works.com>
parents: 845
diff changeset
31 .. note::
bdc438fb4fe4 Fixes for release 1.1.4
Marcin Kuzminski <marcin@python-works.com>
parents: 845
diff changeset
32 The next steps only apply to upgrading from non bugfix releases eg. from
bdc438fb4fe4 Fixes for release 1.1.4
Marcin Kuzminski <marcin@python-works.com>
parents: 845
diff changeset
33 any minor or major releases. Bugfix releases (eg. 1.1.2->1.1.3) will
1091
e67786cb2afa - Further corrections.
jfh <jason@jasonfharris.com>
parents: 1071
diff changeset
34 not have any database schema changes or whoosh library updates.
1071
bdc438fb4fe4 Fixes for release 1.1.4
Marcin Kuzminski <marcin@python-works.com>
parents: 845
diff changeset
35
1136
93b980ebee55 changes for release 1.1.5
Marcin Kuzminski <marcin@python-works.com>
parents: 1095
diff changeset
36 It is also recommended that you rebuild the whoosh index after upgrading since
93b980ebee55 changes for release 1.1.5
Marcin Kuzminski <marcin@python-works.com>
parents: 1095
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
1091
e67786cb2afa - Further corrections.
jfh <jason@jasonfharris.com>
parents: 1071
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
1071
bdc438fb4fe4 Fixes for release 1.1.4
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
1091
e67786cb2afa - Further corrections.
jfh <jason@jasonfharris.com>
parents: 1071
diff changeset
44 This will upgrade the schema and update some of the defaults in the database,
1136
93b980ebee55 changes for release 1.1.5
Marcin Kuzminski <marcin@python-works.com>
parents: 1095
diff changeset
45 and will always recheck the settings of the application, if there are no new
93b980ebee55 changes for release 1.1.5
Marcin Kuzminski <marcin@python-works.com>
parents: 1095
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/