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