Mercurial > hg > orthanc-book
annotate Sphinx/source/faq/debian-daemon.rst @ 1034:bbcec5f44c34
PG 6.0
author | Alain Mazy <am@osimis.io> |
---|---|
date | Thu, 08 Feb 2024 16:46:35 +0100 |
parents | ac493614ba2e |
children |
rev | line source |
---|---|
284 | 1 Starting Orthanc as a GNU/Linux daemon |
2 ====================================== | |
3 | |
4 .. contents:: | |
5 | |
0 | 6 .. highlight:: bash |
7 | |
284 | 8 "init" flavor |
9 ------------- | |
0 | 10 |
284 | 11 To install Orthanc as a GNU/Linux `init daemon |
12 <https://en.wikipedia.org/wiki/Init>`__ on a Debian/Ubuntu system, you | |
13 can: | |
0 | 14 |
15 1. Download this `service script | |
262 | 16 <https://salsa.debian.org/med-team/orthanc/raw/master/debian/orthanc.init>`_ |
0 | 17 (this file is part of the `official Debian package |
18 <https://tracker.debian.org/pkg/orthanc>`_ of Orthanc), | |
19 2. Adapt some of its variables to reflect the configuration of your | |
20 system, | |
21 3. Copy it in ``/etc/init.d`` as root (the filename cannot contain | |
22 dot, otherwise it is not executed), make it belong to root, and tag | |
23 it as executable:: | |
24 | |
25 $ sudo mv orthanc.init /etc/init.d/orthanc | |
26 $ sudo chown root:root /etc/init.d/orthanc | |
27 $ sudo chmod 755 /etc/init.d/orthanc | |
28 | |
29 4. If you wish the daemon to be automatically launched at boot time and stopped at shutdown:: | |
30 | |
31 $ sudo update-rc.d orthanc defaults | |
32 | |
33 5. If you wish to remove the automatic launching at boot time later on:: | |
34 | |
35 $ sudo update-rc.d -f orthanc remove | |
36 | |
37 *Note*: You can use ``rcconf`` to easily monitor the services that are | |
38 run at startup:: | |
39 | |
40 $ sudo apt-get install rcconf | |
284 | 41 |
42 | |
43 "systemd" flavor | |
44 ---------------- | |
45 | |
46 A sample `systemd daemon <https://en.wikipedia.org/wiki/Systemd>`__ | |
733
ac493614ba2e
systemd from debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
482
diff
changeset
|
47 for Orthanc can be found in the official `Debian package |
ac493614ba2e
systemd from debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
482
diff
changeset
|
48 <https://tracker.debian.org/pkg/orthanc>`_ and in the official `Fedora |
ac493614ba2e
systemd from debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
482
diff
changeset
|
49 package <https://src.fedoraproject.org/rpms/orthanc/tree/f32>`__ (now |
ac493614ba2e
systemd from debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
482
diff
changeset
|
50 orphaned - please consider :ref:`contributing by adopting this package |
ac493614ba2e
systemd from debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
482
diff
changeset
|
51 <contributing>`): |
284 | 52 |
53 1. Download the `systemd script | |
733
ac493614ba2e
systemd from debian
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
482
diff
changeset
|
54 <https://salsa.debian.org/med-team/orthanc/raw/master/debian/orthanc.service>`__, |
284 | 55 2. Adapt some of its variables to reflect the configuration of your |
56 system, | |
57 3. Copy it as ``/etc/systemd/system/orthanc.service``, | |
58 4. Start the daemon as follows:: | |
59 | |
60 $ sudo systemctl daemon-reload | |
61 $ sudo systemctl start orthanc.service | |
62 | |
63 5. To make this change permanent after a reboot, you can create a | |
64 symbolic link as follows:: | |
65 | |
66 $ sudo ln -s /etc/systemd/system/orthanc.service /etc/systemd/system/default.target.wants/ | |
67 | |
68 | |
69 Other GNU/Linux distributions | |
70 ----------------------------- | |
71 | |
72 The instructions above have been tested on Debian/Ubuntu/Fedora | |
73 systems, but should work similarly on other GNU/Linux distributions. |