# HG changeset patch # User Sebastien Jodogne # Date 1604483330 -3600 # Node ID cdfdedcd078b02a732af1756e73852eab63e3e87 # Parent a3f1ddc56b6e80fb62c772aec802271c116aefe2 additional info about debian diff -r a3f1ddc56b6e -r cdfdedcd078b Sphinx/source/users/debian-packages.rst --- 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 -`__ -and `Ubuntu -`__ -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 `__. - -* Use the `LSB binaries `__. - -* Use :ref:`Docker `. - -* :ref:`Compile Orthanc by yourself `. - -* Advanced users: :ref:`replace the binaries from the package by the LSB 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 ` are available in ``/var/log/orthanc/``. - - -Configuration -------------- - -Orthanc reads its :ref:`configuration file -` 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 +`__ +that is continuously updated by the Orthanc core developers. This +implies that Orthanc is also available in the `Debian derivative +distributions +`__, +most notably in `Ubuntu +`__. 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 + `__, or use a Debian-based + distro that derives from unstable (such as Kali Linux). + +* Use the `LSB binaries `__. + +* Use :ref:`Docker `. + +* :ref:`Compile Orthanc by yourself `. + +* Advanced users: :ref:`replace the binaries from the package by the + LSB 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 ` are available in ``/var/log/orthanc/``. + + +Configuration +------------- + +Orthanc reads its :ref:`configuration file +` 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 +