Mercurial > hg > orthanc-book

comparison Sphinx/source/users/debian-packages.rst @ 535:a3f1ddc56b6e

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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&section=all>`__
23 and `Ubuntu
24 <https://packages.ubuntu.com/search?keywords=orthanc&searchon=names&suite=all&section=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