Mercurial > hg > orthanc-book
annotate Sphinx/source/users/debian-packages.rst @ 536:cdfdedcd078b
additional info about debian
author | Sebastien Jodogne <s.jodogne@gmail.com> |
---|---|
date | Wed, 04 Nov 2020 10:48:50 +0100 |
parents | a3f1ddc56b6e |
children | 2c8f4eca3cd2 |
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§ion=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§ion=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 |