Mercurial > hg > orthanc-book
annotate Sphinx/source/users/support.rst @ 276:3977ccfc318e
read log before asking support
| author | Sebastien Jodogne <s.jodogne@gmail.com> |
|---|---|
| date | Tue, 03 Sep 2019 17:05:13 +0200 |
| parents | 1173e40cbf35 |
| children | 3d718457cfb6 |
| rev | line source |
|---|---|
| 271 | 1 .. _support: |
| 2 | |
| 3 Asking for support | |
| 4 ================== | |
| 5 | |
| 6 .. _support-resources: | |
| 7 | |
| 8 Analyzing your problem | |
| 9 ---------------------- | |
| 10 | |
| 11 When you face a problem, you should first check out the following | |
| 12 resources: | |
| 13 | |
| 14 1. Make sure to :ref:`understand the basics of DICOM <dicom-guide>`. | |
|
276
3977ccfc318e
read log before asking support
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
271
diff
changeset
|
15 2. Carefully read your :ref:`log files in verbose mode <log>`. |
|
3977ccfc318e
read log before asking support
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
271
diff
changeset
|
16 3. Follow the :ref:`general troubleshooting guide <troubleshooting>`. |
|
3977ccfc318e
read log before asking support
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
271
diff
changeset
|
17 4. If the problem is related to the DICOM network protocol, follow |
| 271 | 18 the :ref:`DICOM troubleshooting guide <dicom>`. |
|
276
3977ccfc318e
read log before asking support
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
271
diff
changeset
|
19 5. Have a look at **all** the :ref:`frequently asked questions (FAQs) |
| 271 | 20 <faq>` that are already available in the Orthanc Book. |
|
276
3977ccfc318e
read log before asking support
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
271
diff
changeset
|
21 6. Make a search for similar problem previously discussed in the |
| 271 | 22 `Orthanc Users discussion forum |
| 23 <https://groups.google.com/forum/#!forum/orthanc-users>`__. | |
|
276
3977ccfc318e
read log before asking support
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
271
diff
changeset
|
24 7. Check out the ``Pending changes in the mainline`` section of the |
| 271 | 25 `NEWS file |
| 26 <https://bitbucket.org/sjodogne/orthanc/src/default/NEWS>`__, as | |
| 27 your issue might already be solved in the mainline of Orthanc (i.e. | |
| 28 in the cutting-edge version of Orthanc since the last stable | |
| 29 official release). | |
|
276
3977ccfc318e
read log before asking support
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
271
diff
changeset
|
30 8. Carefully read the `TODO file |
| 271 | 31 <https://bitbucket.org/sjodogne/orthanc/src/default/TODO>`__ that |
| 32 contains our roadmap, as you might be requesting a feature that is | |
| 33 currently pending in our backlog (i.e. not implemented yet). | |
|
276
3977ccfc318e
read log before asking support
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
271
diff
changeset
|
34 9. Have a look for the issue in the `official bug tracker |
| 271 | 35 <https://bitbucket.org/sjodogne/orthanc/issues?status=new&status=open>`__ |
| 36 (click on the ``All`` button, as your issue might already been solved). | |
| 37 | |
| 38 | |
| 39 Importantly, for all the features that are pending in the ``TODO`` | |
| 40 file, if you are a company, please consider `buying professional | |
| 41 services <https://www.orthanc-server.com/orthanc-pro.php>`__ in order | |
| 42 to get the feature implemented faster. | |
| 43 | |
| 44 | |
| 45 .. _support-mwe: | |
| 46 | |
| 47 Discussing a minimal working example | |
| 48 ------------------------------------ | |
| 49 | |
| 50 If none of these resources help, you can consider sending a message to | |
| 51 the `Orthanc Users discussion forum | |
| 52 <https://groups.google.com/forum/#!forum/orthanc-users>`__. In such a | |
| 53 situation, you **must** provide a `minimal working example | |
| 54 <https://en.wikipedia.org/wiki/Minimal_working_example>`__, which means that | |
| 55 you must provide all the following information: | |
| 56 | |
| 57 * Context and full textual description of your issue. When talking | |
| 58 about DICOM networking issues, carefully describe the imaging | |
| 59 modalities into play (including their manufacturers) and your | |
| 60 network topology. | |
| 61 * Full :ref:`configuration files <configuration>`. | |
| 62 * Full logs as produced by Orthanc in :ref:`verbose mode <log>`. | |
| 63 * Sample DICOM files. | |
| 64 * A sequence of command lines that lead to your problem. These command | |
| 65 lines must only call commands that are available as free and | |
| 66 open-source software and that are cross-platform (:ref:`proprietary | |
| 67 software does not help <proprietary>`). The most useful commands are | |
| 68 `cURL <https://en.wikipedia.org/wiki/CURL>`__, `DCMTK | |
| 69 <https://dicom.offis.de/dcmtk.php.en>`__, `dicom3tools | |
| 70 <https://www.dclunie.com/dicom3tools.html>`__, `dcm4che command-line | |
| 71 tools <https://www.dcm4che.org/>`__, or Python scripts. | |
| 72 * If applicable, a screenshot is worth a thousands word. | |
| 73 * If you report a crash, if applicable, a :ref:`core file <crash>`. | |
| 74 | |
| 75 All this information is mandatory, as it allows other members of the | |
| 76 Orthanc community to **reproduce your problem independently of your | |
| 77 setup**. If we can't reproduce your issue, we can't provide any | |
| 78 support! | |
| 79 | |
| 80 | |
| 81 .. _support-tracker: | |
| 82 | |
| 83 Using the bug tracker | |
| 84 --------------------- | |
| 85 | |
| 86 If you are **sure** that you are reporting a yet unknown bug, you can | |
| 87 consider directly introducing a `bug report on our issue tracker | |
| 88 <https://bitbucket.org/sjodogne/orthanc/issues/new>`__. Beware however | |
| 89 that your issue might be closed if too vague or if not reproducible. | |
| 90 As a consequence, it is advised to first use the discussion forum. |