Mercurial > hg > orthanc-book

comparison Sphinx/source/users/replication.rst @ 75:16d516fdc642

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
note
author Sebastien Jodogne <s.jodogne@gmail.com>
date Wed, 14 Dec 2016 10:09:44 +0100
parents 12b204ee328d
children c2f2202f54f2
comparison
equal deleted inserted replaced
74:a976607e46f7 75:16d516fdc642
7 This page explains how to replicate the content of one instance of 7 This page explains how to replicate the content of one instance of
8 Orthanc to another instance of Orthanc. This is useful to **upgrade** 8 Orthanc to another instance of Orthanc. This is useful to **upgrade**
9 between :ref:`versions of the database schema <db-versioning>`, or to 9 between :ref:`versions of the database schema <db-versioning>`, or to
10 create **mirrored DICOM servers**. 10 create **mirrored DICOM servers**.
11 11
12 Note that if you only want to automatically upgrade the database for 12
13 successive versions of Orthanc, you most probably only have to add the 13 Upgrade the database schema
14 ``--upgrade`` command-line option while starting Orthanc. 14 ---------------------------
15
16 As explained :ref:`elsewhere in the Orthanc Book <db-versioning>`,
17 successive versions of Orthanc might use a different version of the
18 database schema. If this happens, Orthanc will refuse to start (with
19 an explicit message in its :ref:`logs <log>`), to let the user decides
20 whether she actually wants to upgrade the database. At this point, the
21 user might indeed decide to modify its :ref:`configuration file
22 <configuration>` to create a new database elsewhere on the filesystem.
23
24 If you decide to upgrade the database schema, you have to apply the
25 following 3 steps:
26
27 1. If not done yet, stop the running Orthanc service:
28
29 * Under Microsoft Windows, use the `services control panel
30 <https://en.wikipedia.org/wiki/Windows_service>`__.
31 * Under Debian, use ``sudo /etc/init.d/orthanc stop``.
32
33 2. Manually call Orthanc with the ``--upgrade`` command-line option,
34 and point to your default configuration file:
35
36 * Under Microsoft Windows, ``Orthanc.exe c:/Orthanc/``.
37 * Under Debian, use ``sudo /usr/sbin/Orthanc /etc/orthanc/ --upgrade``.
38
39 3. Start the Orthanc service again:
40
41 * Under Microsoft Windows, use the `services control panel
42 <https://en.wikipedia.org/wiki/Windows_service>`__.
43 * Under Debian, use ``sudo /etc/init.d/orthanc stop``.
44
45 Note that, depending on the size of the Orthanc database, upgrading
46 the database schema might take time.
15 47
16 48
17 Direct access to the filesystem 49 Direct access to the filesystem
18 ------------------------------- 50 -------------------------------
19 51