Mercurial > hg > orthanc-book
diff 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 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Sphinx/source/faq/log.rst Thu Jul 14 09:47:19 2016 +0200 @@ -0,0 +1,63 @@ +.. _log: + +Generating an Exploitable Log +----------------------------- + +For your log to be exploitable by the Orthanc community, you must +generate them with the ``--verbose`` or ``--trace``. If you are using +Orthanc at the command-line, simply add these flags and redirect the +standard outputs to some log file. + +However, if you use packaged versions of Orthanc that runs the server +in background, you will have to manually start Orthanc. The sections +below explain how to achieve this goal with the officially supported +packages. + + +Under Windows +^^^^^^^^^^^^^ + +Under Windows, if you used the official installer: + +1. Download the `precompiled command-line version + <http://www.orthanc-server.com/download-windows.php>`__ of Orthanc. + +2. Stop the Orthanc service. The actual process depends on your + version of Windows. + +3. Copy the just-downloaded ``Orthanc-1.1.0-Release.exe`` together + with your configuration file (that is by default located in + ``C:\Orthanc\Configuration.json``) into the same folder + (e.g. ``C:\Temp``). + +4. Type in a command-line shell, to generate the ``Orthanc.log`` file:: + + $ cd C:\Temp + $ Orthanc-1.1.0-Release.exe --verbose Configuration.json > Orthanc.log 2<&1 + +5. Restart the Orthanc service. + + +Under Debian GNU/Linux +^^^^^^^^^^^^^^^^^^^^^^ + +1. Stop the Orthanc service:: + + $ sudo /etc/init.d/orthanc stop + +2. Manually start Orthanc (using the same configuration as the + service) and generate the log:: + + $ sudo -u orthanc /usr/sbin/Orthanc --verbose /etc/orthanc/ > Orthanc.log 2>&1 + +3. Restart the Orthanc service:: + + $ sudo /etc/init.d/orthanc start + + +Under Docker +^^^^^^^^^^^^ + +The command-line to be used is:: + + $ sudo docker run -a stderr -p 4242:4242 -p 8042:8042 --rm jodogne/orthanc --verbose /etc/orthanc > Orthanc.log 2>&1