Clean up master. use 2.0 files for now.
[working/Evergreen.git] / reports / report-startingreporter.xml
1 <?xml version="1.0" encoding="utf-8"?>\r
2 <chapter xml:id="report_starting_reporter_service" xmlns="" version="5.0" xml:lang="EN"\r
3     xmlns:xi="" xmlns:xlink="">\r
4         <info>\r
5                 <title>Starting and Stopping the Reporter Daemon</title>\r
6         </info>\r
7         <para>Before you can view reports, the Evergreen administrator must start the reporter daemon from the command line of the Evergreen server.</para>\r
8         <para>The reporter daemon periodically checks for requests for new reports or scheduled reports and gets them running.</para>\r
9         \r
10         <simplesect xml:id="startingreporter">\r
11                 <title>Starting the Reporter Daemon</title>\r
12                 <para>To start the reporter daemon, run the following command as the opensrf user:</para>\r
13                 <screen> --daemon</screen>\r
14                 <para>You can also specify other options:</para>\r
15                 <itemizedlist>\r
16                         <listitem>sleep=interval : number of seconds to sleep between checks for new reports to run; defaults to 10</listitem>\r
17                         <listitem>lockfile=filename : where to place the lockfile for the process; defaults to /tmp/reporter-LOCK</listitem>\r
18                         <listitem>concurrency=integer : number of reporter daemon processes to run; defaults to 1</listitem>    \r
19                         <listitem>boostrap=filename : OpenSRF bootstrap configuration file; defaults to /openils/conf/opensrf_core.xml</listitem>       \r
20                 </itemizedlist>\r
21                 <note>\r
22                         <para>The open-ils.reporter process must be running and enabled on the gateway before the reporter daemon can be started.</para>\r
23                         <para>Remember that if the server is restarted, the reporter daemon will need to be restarted before you can view reports unless you have configured your server to start the daemon \r
24                         automatically at start up time.</para></note>\r
25         </simplesect>\r
26         <simplesect xml:id="stoppingreporter">\r
27                 <title>Stopping the Reporter Daemon</title>\r
28                 <para>To stop the reporter daemon, you have to kill the process and remove the lockfile. Assuming you're running just a single process and that the lockfile is \r
29                 in the default location, perform the following commands as the opensrf user:</para>\r
30                 <screen>kill `ps wax | grep "Clark Kent" | grep -v grep | cut -b1-6`</screen>\r
31                 <screen>rm /tmp/reporter-LOCK</screen>\r
32         </simplesect>\r
33 </chapter>\r
34 \r
35 \r
36 \r
37 \r
38 \r
39 \r
40 \r
41 \r
42 \r