Mercurial > hg > orthanc-book
comparison Sphinx/source/users/debian-packages.rst @ 535:a3f1ddc56b6e
added debian/ubuntu package doc
author | Alain Mazy <alain@mazy.be> |
---|---|
date | Wed, 04 Nov 2020 09:54:11 +0100 |
parents | |
children | cdfdedcd078b |
comparison
equal
deleted
inserted
replaced
534:8e27dbf6f39e | 535:a3f1ddc56b6e |
---|---|
1 .. _debian-packages: | |
2 .. highlight:: bash | |
3 | |
4 | |
5 Orthanc packages for Debian/Ubuntu | |
6 ================================== | |
7 | |
8 .. toctree:: | |
9 :hidden: | |
10 | |
11 docker-osimis.rst | |
12 | |
13 | |
14 .. contents:: | |
15 :depth: 3 | |
16 | |
17 | |
18 Introduction | |
19 ------------ | |
20 | |
21 Orthanc is available as offical `Debian | |
22 <https://packages.debian.org/search?keywords=orthanc&searchon=names&exact=1&suite=all§ion=all>`__ | |
23 and `Ubuntu | |
24 <https://packages.ubuntu.com/search?keywords=orthanc&searchon=names&suite=all§ion=all>`__ | |
25 packages. Most of the official plugins are also available as separate packages. | |
26 | |
27 Note that the installed versions depend on the OS version. If you absolutely need | |
28 the latest Orthanc version, you should: | |
29 | |
30 * Use the latest `unstable Debian release <https://wiki.debian.org/DebianUnstable>`__. | |
31 | |
32 * Use the `LSB binaries <https://lsb.orthanc-server.com/>`__. | |
33 | |
34 * Use :ref:`Docker <docker>`. | |
35 | |
36 * :ref:`Compile Orthanc by yourself <compiling>`. | |
37 | |
38 * Advanced users: :ref:`replace the binaries from the package by the LSB binaries <replace-binaries>`. | |
39 | |
40 Installation | |
41 ------------ | |
42 | |
43 Prerequisite: make sure to update your package definition before installing:: | |
44 | |
45 $ sudo apt update | |
46 | |
47 To install Orthanc and its plugins:: | |
48 | |
49 $ sudo apt install orthanc | |
50 $ sudo apt install orthanc-dicomweb | |
51 $ sudo apt install orthanc-gdcm | |
52 $ sudo apt install orthanc-imagej | |
53 $ sudo apt install orthanc-mysql | |
54 $ sudo apt install orthanc-postgresql | |
55 $ sudo apt install orthanc-python | |
56 $ sudo apt install orthanc-webviewer | |
57 $ sudo apt install orthanc-wsi | |
58 | |
59 Starting/Stopping the service | |
60 ----------------------------- | |
61 | |
62 Once installed, Orthanc is started as a service. To start/stop/restart, use:: | |
63 | |
64 $ sudo service orthanc start | |
65 $ sudo service orthanc stop | |
66 $ sudo service orthanc restart | |
67 | |
68 | |
69 Accessing the logs | |
70 ------------------ | |
71 | |
72 :ref:`Logs <log>` are available in ``/var/log/orthanc/``. | |
73 | |
74 | |
75 Configuration | |
76 ------------- | |
77 | |
78 Orthanc reads its :ref:`configuration file | |
79 <configuration>` from the ``/etc/orthanc/`` folder. | |
80 | |
81 | |
82 | |
83 Replacing the package from the service by the LSB binaries | |
84 ---------------------------------------------------------- | |
85 | |
86 .. _replace-binaries: | |
87 | |
88 If you're stuck with an old version of Orthanc, you may try to | |
89 replace the binaries by the LSB binaries. Note that there might | |
90 be some inconsistencies between the plugins version and you should | |
91 do that at your own risk. | |
92 | |
93 This can be done with this sequence of commands:: | |
94 | |
95 $ sudo service orthanc stop | |
96 $ sudo wget https://lsb.orthanc-server.com/orthanc/1.8.0/Orthanc --output-document /usr/sbin/Orthanc | |
97 $ sudo rm -f /usr/share/orthanc/plugins/*.so | |
98 $ sudo wget https://lsb.orthanc-server.com/orthanc/1.8.0/libServeFolders.so --output-document /usr/share/orthanc/plugins/libServeFolders.so | |
99 $ sudo wget https://lsb.orthanc-server.com/orthanc/1.8.0/libModalityWorklists.so --output-document /usr/share/orthanc/plugins/libModalityWorklists.so | |
100 $ | |
101 $ sudo wget https://lsb.orthanc-server.com/plugin-dicom-web/1.3/libOrthancDicomWeb.so --output-document /usr/share/orthanc/plugins/libOrthancDicomWeb.so | |
102 $ ... | |
103 $ sudo service orthanc restart | |
104 |