Mercurial > hg > orthanc-book
changeset 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 |
| files | Sphinx/source/users/debian-packages.rst |
| diffstat | 1 files changed, 113 insertions(+), 104 deletions(-) [+] |
line wrap: on
line diff
--- a/Sphinx/source/users/debian-packages.rst Wed Nov 04 09:54:11 2020 +0100 +++ b/Sphinx/source/users/debian-packages.rst Wed Nov 04 10:48:50 2020 +0100 @@ -1,104 +1,113 @@ -.. _debian-packages: -.. highlight:: bash - - -Orthanc packages for Debian/Ubuntu -================================== - -.. toctree:: - :hidden: - - docker-osimis.rst - - -.. contents:: - :depth: 3 - - -Introduction ------------- - -Orthanc is available as offical `Debian -<https://packages.debian.org/search?keywords=orthanc&searchon=names&exact=1&suite=all§ion=all>`__ -and `Ubuntu -<https://packages.ubuntu.com/search?keywords=orthanc&searchon=names&suite=all§ion=all>`__ -packages. Most of the official plugins are also available as separate packages. - -Note that the installed versions depend on the OS version. If you absolutely need -the latest Orthanc version, you should: - -* Use the latest `unstable Debian release <https://wiki.debian.org/DebianUnstable>`__. - -* Use the `LSB binaries <https://lsb.orthanc-server.com/>`__. - -* Use :ref:`Docker <docker>`. - -* :ref:`Compile Orthanc by yourself <compiling>`. - -* Advanced users: :ref:`replace the binaries from the package by the LSB binaries <replace-binaries>`. - -Installation ------------- - -Prerequisite: make sure to update your package definition before installing:: - - $ sudo apt update - -To install Orthanc and its plugins:: - - $ sudo apt install orthanc - $ sudo apt install orthanc-dicomweb - $ sudo apt install orthanc-gdcm - $ sudo apt install orthanc-imagej - $ sudo apt install orthanc-mysql - $ sudo apt install orthanc-postgresql - $ sudo apt install orthanc-python - $ sudo apt install orthanc-webviewer - $ sudo apt install orthanc-wsi - -Starting/Stopping the service ------------------------------ - -Once installed, Orthanc is started as a service. To start/stop/restart, use:: - - $ sudo service orthanc start - $ sudo service orthanc stop - $ sudo service orthanc restart - - -Accessing the logs ------------------- - -:ref:`Logs <log>` are available in ``/var/log/orthanc/``. - - -Configuration -------------- - -Orthanc reads its :ref:`configuration file -<configuration>` from the ``/etc/orthanc/`` folder. - - - -Replacing the package from the service by the LSB binaries ----------------------------------------------------------- - -.. _replace-binaries: - -If you're stuck with an old version of Orthanc, you may try to -replace the binaries by the LSB binaries. Note that there might -be some inconsistencies between the plugins version and you should -do that at your own risk. - -This can be done with this sequence of commands:: - - $ sudo service orthanc stop - $ sudo wget https://lsb.orthanc-server.com/orthanc/1.8.0/Orthanc --output-document /usr/sbin/Orthanc - $ sudo rm -f /usr/share/orthanc/plugins/*.so - $ sudo wget https://lsb.orthanc-server.com/orthanc/1.8.0/libServeFolders.so --output-document /usr/share/orthanc/plugins/libServeFolders.so - $ sudo wget https://lsb.orthanc-server.com/orthanc/1.8.0/libModalityWorklists.so --output-document /usr/share/orthanc/plugins/libModalityWorklists.so - $ - $ sudo wget https://lsb.orthanc-server.com/plugin-dicom-web/1.3/libOrthancDicomWeb.so --output-document /usr/share/orthanc/plugins/libOrthancDicomWeb.so - $ ... - $ sudo service orthanc restart - +.. _debian-packages: +.. highlight:: bash + + +Orthanc packages for Debian/Ubuntu +================================== + +.. toctree:: + :hidden: + + docker-osimis.rst + + +.. contents:: + :depth: 3 + + +Introduction +------------ + +Orthanc is available as an offical `Debian package +<https://packages.debian.org/search?keywords=orthanc&searchon=names&exact=1&suite=all§ion=all>`__ +that is continuously updated by the Orthanc core developers. This +implies that Orthanc is also available in the `Debian derivative +distributions +<https://en.wikipedia.org/wiki/List_of_Linux_distributions#Debian-based>`__, +most notably in `Ubuntu +<https://packages.ubuntu.com/search?keywords=orthanc&searchon=names&suite=all§ion=all>`__. Most +of the official plugins are also available as separate packages. + +Note that the installed versions depend on the version of the Debian +distribution. If you absolutely need the latest Orthanc version, you +should: + +* Use the bleeding-edge `Debian unstable + <https://wiki.debian.org/DebianUnstable>`__, or use a Debian-based + distro that derives from unstable (such as Kali Linux). + +* Use the `LSB binaries <https://lsb.orthanc-server.com/>`__. + +* Use :ref:`Docker <docker>`. + +* :ref:`Compile Orthanc by yourself <compiling>`. + +* Advanced users: :ref:`replace the binaries from the package by the + LSB binaries <lsb-replace-debian-binaries>`. + + +Installation +------------ + +Prerequisite: make sure to update your package definition before installing:: + + $ sudo apt update + +To install Orthanc and its plugins:: + + $ sudo apt install orthanc + $ sudo apt install orthanc-dicomweb + $ sudo apt install orthanc-gdcm + $ sudo apt install orthanc-imagej + $ sudo apt install orthanc-mysql + $ sudo apt install orthanc-postgresql + $ sudo apt install orthanc-python + $ sudo apt install orthanc-webviewer + $ sudo apt install orthanc-wsi + +Starting/Stopping the service +----------------------------- + +Once installed, Orthanc is started as a service. To start/stop/restart, use:: + + $ sudo service orthanc start + $ sudo service orthanc stop + $ sudo service orthanc restart + + +Accessing the logs +------------------ + +:ref:`Logs <log>` are available in ``/var/log/orthanc/``. + + +Configuration +------------- + +Orthanc reads its :ref:`configuration file +<configuration>` from the ``/etc/orthanc/`` folder. + + + +Replacing the package from the service by the LSB binaries +---------------------------------------------------------- + +.. _lsb-replace-debian-binaries: + +If you're stuck with an old version of Orthanc, you may try to +replace the binaries by the LSB binaries. Note that there might +be some inconsistencies between the plugins version and you should +do that at your own risk. + +This can be done with this sequence of commands:: + + $ sudo service orthanc stop + $ sudo wget https://lsb.orthanc-server.com/orthanc/1.8.0/Orthanc --output-document /usr/sbin/Orthanc + $ sudo rm -f /usr/share/orthanc/plugins/*.so + $ sudo wget https://lsb.orthanc-server.com/orthanc/1.8.0/libServeFolders.so --output-document /usr/share/orthanc/plugins/libServeFolders.so + $ sudo wget https://lsb.orthanc-server.com/orthanc/1.8.0/libModalityWorklists.so --output-document /usr/share/orthanc/plugins/libModalityWorklists.so + $ + $ sudo wget https://lsb.orthanc-server.com/plugin-dicom-web/1.3/libOrthancDicomWeb.so --output-document /usr/share/orthanc/plugins/libOrthancDicomWeb.so + $ ... + $ sudo service orthanc restart +