Mercurial > hg > orthanc-book
comparison Sphinx/source/faq/log.rst @ 23:f99aa6a6f0c9
Generating an Exploitable Log
| author | Sebastien Jodogne <s.jodogne@gmail.com> |
|---|---|
| date | Thu, 14 Jul 2016 09:47:19 +0200 |
| parents | |
| children | 87803e4e9c91 |
comparison
equal
deleted
inserted
replaced
| 22:6d02b30fd8a9 | 23:f99aa6a6f0c9 |
|---|---|
| 1 .. _log: | |
| 2 | |
| 3 Generating an Exploitable Log | |
| 4 ----------------------------- | |
| 5 | |
| 6 For your log to be exploitable by the Orthanc community, you must | |
| 7 generate them with the ``--verbose`` or ``--trace``. If you are using | |
| 8 Orthanc at the command-line, simply add these flags and redirect the | |
| 9 standard outputs to some log file. | |
| 10 | |
| 11 However, if you use packaged versions of Orthanc that runs the server | |
| 12 in background, you will have to manually start Orthanc. The sections | |
| 13 below explain how to achieve this goal with the officially supported | |
| 14 packages. | |
| 15 | |
| 16 | |
| 17 Under Windows | |
| 18 ^^^^^^^^^^^^^ | |
| 19 | |
| 20 Under Windows, if you used the official installer: | |
| 21 | |
| 22 1. Download the `precompiled command-line version | |
| 23 <http://www.orthanc-server.com/download-windows.php>`__ of Orthanc. | |
| 24 | |
| 25 2. Stop the Orthanc service. The actual process depends on your | |
| 26 version of Windows. | |
| 27 | |
| 28 3. Copy the just-downloaded ``Orthanc-1.1.0-Release.exe`` together | |
| 29 with your configuration file (that is by default located in | |
| 30 ``C:\Orthanc\Configuration.json``) into the same folder | |
| 31 (e.g. ``C:\Temp``). | |
| 32 | |
| 33 4. Type in a command-line shell, to generate the ``Orthanc.log`` file:: | |
| 34 | |
| 35 $ cd C:\Temp | |
| 36 $ Orthanc-1.1.0-Release.exe --verbose Configuration.json > Orthanc.log 2<&1 | |
| 37 | |
| 38 5. Restart the Orthanc service. | |
| 39 | |
| 40 | |
| 41 Under Debian GNU/Linux | |
| 42 ^^^^^^^^^^^^^^^^^^^^^^ | |
| 43 | |
| 44 1. Stop the Orthanc service:: | |
| 45 | |
| 46 $ sudo /etc/init.d/orthanc stop | |
| 47 | |
| 48 2. Manually start Orthanc (using the same configuration as the | |
| 49 service) and generate the log:: | |
| 50 | |
| 51 $ sudo -u orthanc /usr/sbin/Orthanc --verbose /etc/orthanc/ > Orthanc.log 2>&1 | |
| 52 | |
| 53 3. Restart the Orthanc service:: | |
| 54 | |
| 55 $ sudo /etc/init.d/orthanc start | |
| 56 | |
| 57 | |
| 58 Under Docker | |
| 59 ^^^^^^^^^^^^ | |
| 60 | |
| 61 The command-line to be used is:: | |
| 62 | |
| 63 $ sudo docker run -a stderr -p 4242:4242 -p 8042:8042 --rm jodogne/orthanc --verbose /etc/orthanc > Orthanc.log 2>&1 |