changeset 108:e3be44c1d041

added startup troubleshooting
author amazy
date Thu, 20 Jul 2017 07:34:37 +0200
parents 7063afe5748c
children b14e88dc1a9c
files Sphinx/source/faq/troubleshooting.rst
diffstat 1 files changed, 19 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/Sphinx/source/faq/troubleshooting.rst	Wed Jul 19 12:49:56 2017 +0200
+++ b/Sphinx/source/faq/troubleshooting.rst	Thu Jul 20 07:34:37 2017 +0200
@@ -13,6 +13,24 @@
 of this page). Your issue might indeed have already been discussed in
 the past or in the FAQ.
 
+Startup
+-------
+* If **Orthanc fails to start** with the error "**The TCP port of the DICOM 
+  server is privileged or already in use**", this means another software is
+  already using the port Orthanc is trying to use.  Usually, this means
+  that an other instance of Orthanc is running.  However, note that, by default, 
+  Orthanc uses port 4242 which might also be used by other software like
+  a `Juniper VPN client <https://www.file.net/process/dsncservice.exe.html>`__.
+  To determine which other process is using the port: 
+
+  On Windows, you may use the `Resource Monitor <https://en.wikipedia.org/wiki/Resource_Monitor>`__.
+  In the `Network` tab, check the `Listening Ports`.  
+
+  On Linux, you may use this command line: ``sudo ss --tcp --listen --numeric --processes``.
+
+  Starting with version 1.3.0, the check at Orthanc startup is more robust
+  (it also checks for UDP socket using the same port) and Orthanc 1.3.0 might 
+  display error messages that where not displayed by previous versions.
 
 Orthanc Explorer
 ----------------
@@ -103,4 +121,4 @@
   less than 4GB of RAM. If this is an important limitation for you,
   precompiled command-line versions of Orthanc for Windows 64bit are
   available courtesy of `Osimis
-  <http://www.osimis.io/en/download.html>`__.
+  <http://www.osimis.io/en/download.html>`__.
\ No newline at end of file