Mercurial > hg > orthanc-book

annotate Sphinx/source/users/debian-packages.rst @ 536:cdfdedcd078b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
additional info about debian
author Sebastien Jodogne <s.jodogne@gmail.com>
date Wed, 04 Nov 2020 10:48:50 +0100
parents a3f1ddc56b6e
children 2c8f4eca3cd2
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
536
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
1 .. _debian-packages:
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
2 .. highlight:: bash
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
3
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
4
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
5 Orthanc packages for Debian/Ubuntu
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
6 ==================================
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
7
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
8 .. toctree::
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
9 :hidden:
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
10
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
11 docker-osimis.rst
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
12
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
13
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
14 .. contents::
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
15 :depth: 3
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
16
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
17
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
18 Introduction
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
19 ------------
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
20
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
21 Orthanc is available as an offical `Debian package
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
22 <https://packages.debian.org/search?keywords=orthanc&searchon=names&exact=1&suite=all&section=all>`__
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
23 that is continuously updated by the Orthanc core developers. This
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
24 implies that Orthanc is also available in the `Debian derivative
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
25 distributions
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
26 <https://en.wikipedia.org/wiki/List_of_Linux_distributions#Debian-based>`__,
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
27 most notably in `Ubuntu
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
28 <https://packages.ubuntu.com/search?keywords=orthanc&searchon=names&suite=all&section=all>`__. Most
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
29 of the official plugins are also available as separate packages.
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
30
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
31 Note that the installed versions depend on the version of the Debian
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
32 distribution. If you absolutely need the latest Orthanc version, you
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
33 should:
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
34
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
35 * Use the bleeding-edge `Debian unstable
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
36 <https://wiki.debian.org/DebianUnstable>`__, or use a Debian-based
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
37 distro that derives from unstable (such as Kali Linux).
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
38
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
39 * Use the `LSB binaries <https://lsb.orthanc-server.com/>`__.
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
40
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
41 * Use :ref:`Docker <docker>`.
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
42
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
43 * :ref:`Compile Orthanc by yourself <compiling>`.
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
44
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
45 * Advanced users: :ref:`replace the binaries from the package by the
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
46 LSB binaries <lsb-replace-debian-binaries>`.
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
47
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
48
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
49 Installation
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
50 ------------
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
51
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
52 Prerequisite: make sure to update your package definition before installing::
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
53
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
54 $ sudo apt update
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
55
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
56 To install Orthanc and its plugins::
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
57
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
58 $ sudo apt install orthanc
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
59 $ sudo apt install orthanc-dicomweb
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
60 $ sudo apt install orthanc-gdcm
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
61 $ sudo apt install orthanc-imagej
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
62 $ sudo apt install orthanc-mysql
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
63 $ sudo apt install orthanc-postgresql
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
64 $ sudo apt install orthanc-python
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
65 $ sudo apt install orthanc-webviewer
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
66 $ sudo apt install orthanc-wsi
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
67
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
68 Starting/Stopping the service
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
69 -----------------------------
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
70
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
71 Once installed, Orthanc is started as a service. To start/stop/restart, use::
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
72
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
73 $ sudo service orthanc start
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
74 $ sudo service orthanc stop
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
75 $ sudo service orthanc restart
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
76
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
77
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
78 Accessing the logs
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
79 ------------------
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
80
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
81 :ref:`Logs <log>` are available in ``/var/log/orthanc/``.
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
82
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
83
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
84 Configuration
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
85 -------------
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
86
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
87 Orthanc reads its :ref:`configuration file
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
88 <configuration>` from the ``/etc/orthanc/`` folder.
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
89
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
90
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
91
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
92 Replacing the package from the service by the LSB binaries
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
93 ----------------------------------------------------------
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
94
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
95 .. _lsb-replace-debian-binaries:
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
96
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
97 If you're stuck with an old version of Orthanc, you may try to
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
98 replace the binaries by the LSB binaries. Note that there might
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
99 be some inconsistencies between the plugins version and you should
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
100 do that at your own risk.
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
101
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
102 This can be done with this sequence of commands::
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
103
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
104 $ sudo service orthanc stop
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
105 $ sudo wget https://lsb.orthanc-server.com/orthanc/1.8.0/Orthanc --output-document /usr/sbin/Orthanc
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
106 $ sudo rm -f /usr/share/orthanc/plugins/*.so
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
107 $ sudo wget https://lsb.orthanc-server.com/orthanc/1.8.0/libServeFolders.so --output-document /usr/share/orthanc/plugins/libServeFolders.so
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
108 $ sudo wget https://lsb.orthanc-server.com/orthanc/1.8.0/libModalityWorklists.so --output-document /usr/share/orthanc/plugins/libModalityWorklists.so
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
109 $
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
110 $ sudo wget https://lsb.orthanc-server.com/plugin-dicom-web/1.3/libOrthancDicomWeb.so --output-document /usr/share/orthanc/plugins/libOrthancDicomWeb.so
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
111 $ ...
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
112 $ sudo service orthanc restart
cdfdedcd078b additional info about debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 535
diff changeset
113