0
|
1 .. _troubleshooting:
|
|
2
|
|
3 Troubleshooting
|
|
4 ===============
|
|
5
|
16
|
6 As a general rule, when you encounter an issue, always make sure that
|
|
7 you use the `most recent version
|
|
8 <http://www.orthanc-server.com/download.php>`__ of Orthanc.
|
|
9
|
|
10 Also make a search on the `Orthanc Users discussion group
|
|
11 <https://groups.google.com/forum/#!forum/orthanc-users>`__, and make a
|
|
12 search in the present Orthanc Book (there is a search field at the top
|
|
13 of this page). Your issue might indeed have already been discussed in
|
|
14 the past or in the FAQ.
|
|
15
|
|
16
|
|
17 Orthanc Explorer
|
|
18 ----------------
|
|
19
|
0
|
20 * **I cannot login to Orthanc Explorer**: For security reasons, access
|
|
21 to Orthanc from remote hosts is disabled by default. Only the
|
|
22 localhost is allowed to access Orthanc. You have to set the
|
|
23 ``RemoteAccessAllowed`` option in the :ref:`configuration file
|
|
24 <configuration>` to ``true``. It is then strongly advised to set
|
|
25 ``AuthenticationEnabled`` to ``true`` and to add a user to the
|
|
26 ``RegisteredUsers`` option, also in the configuration file.
|
16
|
27
|
|
28
|
|
29 Performance issues
|
|
30 ------------------
|
|
31
|
18
|
32 * **Orthanc Explorer is slow under Windows on the localhost**:
|
|
33
|
|
34 - Favor ``127.0.0.1`` instead of ``localhost`` when specifying the
|
|
35 network address of a server. Users have reported that this minor
|
|
36 change `can massively improve performance
|
|
37 <https://groups.google.com/d/msg/orthanc-users/tTe28zR0nGk/Lvs0STJLAgAJ>`__
|
|
38 on Windows. Starting with Orthanc 1.0.1, the samples from the
|
|
39 source distribution have been adapted in this way.
|
|
40
|
|
41 - As an alternative, you can disable IPv6 support. This is a
|
|
42 Windows-specific problem that is discussed `here
|
|
43 <http://superuser.com/questions/43823/google-chrome-is-slow-to-localhost>`__
|
|
44 and `here
|
|
45 <http://stackoverflow.com/questions/1726585/firefox-and-chrome-slow-on-localhost-known-fix-doesnt-work-on-windows-7>`__.
|
16
|
46
|
|
47 * If you experience **slow DICOM transfers under Linux**, please read
|
|
48 the `following bug report
|
|
49 <https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=785400>`__. This
|
|
50 issue does *not* affect all the versions of Linux. A
|
|
51 patch to this issue is shipped with the Orthanc source code. In
|
|
52 order to take advantage of this patch, you need to statically link
|
|
53 Orthanc against DCMTK by using the ``-DUSE_SYSTEM_DCMTK=OFF`` flag
|
|
54 `when invoking CMake
|
|
55 <https://bitbucket.org/sjodogne/orthanc/src/default/LinuxCompilation.txt>`__.
|
|
56
|
|
57
|
|
58 Windows-specific issues
|
|
59 -----------------------
|
|
60
|
0
|
61 * Under Windows, Orthanc creates the "OrthancStorage" folder, and
|
|
62 crashes with the error "**SQLite: Unable to open the database**":
|
|
63 Your directory name is either too long, or it contains special
|
|
64 characters. Please try and run Orthanc in a folder with a simple
|
|
65 name such as ``C:\Orthanc``.
|