LP#1786552: optionally restrict auth_proxy login by home OU
[working/Evergreen.git] / Open-ILS / examples / opensrf.xml.example
1 <?xml version='1.0'?>
2
3 <!-- 
4 Example opensrf config file for OpenILS
5 vim:et:ts=4:sw=4:
6 -->
7
8 <opensrf version='0.0.3'>
9
10     <default>
11
12         <!-- unless otherwise overidden, use this locale -->
13         <default_locale>en-US</default_locale>
14
15         <dirs>
16             <log>LOCALSTATEDIR/log</log> <!-- unix::server log files -->
17             <sock>LOCALSTATEDIR/lock</sock> <!-- unix::server sock files -->
18             <pid>LOCALSTATEDIR/run</pid>
19             <xsl>LOCALSTATEDIR/xsl</xsl>
20             <script>LOCALSTATEDIR</script>
21             <script_lib>LOCALSTATEDIR</script_lib>
22             <templates>LOCALSTATEDIR/templates</templates>
23         </dirs>
24
25         <!-- global data visibility settings -->
26         <share>
27             <user>
28                 <!-- Set to "true" to require patron opt-in for foreign (non-home_ou) transactions -->
29                 <opt_in>false</opt_in>
30             </user>
31         </share>
32
33         <IDL>SYSCONFDIR/fm_IDL.xml</IDL> <!-- top level IDL file -->
34         <IDL2js>fm_IDL2js.xsl</IDL2js> <!-- IDL JS XSLT -->
35
36
37         <server_type>prefork</server_type> <!-- net::server type -->
38
39         <ils_events>LOCALSTATEDIR/data/ils_events.xml</ils_events> <!-- ILS events description file -->
40
41         <email_notify> <!-- this will eventually move into the notifications section below... -->
42             <!-- global email notification settings -->
43             <template>LOCALSTATEDIR/data/hold_notification_template.example</template>
44             <smtp_server>localhost</smtp_server>
45
46             <!--
47             in most cases, this is overridden by location 
48             specific config settings.  this is just the default
49             -->
50             <sender_address>evergreen@localhost</sender_address>
51         </email_notify>
52
53
54       <notifications>
55         <!-- global mail server settings -->
56         <smtp_server>localhost</smtp_server>
57         <sender_address>evergreen@localhost</sender_address>
58
59         <!-- global telephony (asterisk) settings -->
60         <telephony>
61             <!-- replace all values below when telephony server is configured -->
62             <enabled>0</enabled>
63             <driver>SIP</driver>    <!-- SIP (default) or multi -->
64             <channels>              <!-- explicit list of channels used if multi -->
65                                     <!-- A channel specifies technology/resource -->
66                 <channel>Zap/1</channel>
67                 <channel>Zap/2</channel>
68                 <channel>IAX/user:secret@widgets.biz</channel>
69             </channels>
70             <host>localhost</host>
71             <port>10080</port>
72             <user>evergreen</user>
73             <pw>evergreen</pw>
74             <!--
75                 The overall composition of callfiles is determined by the
76                 relevant template, but this section can be invoked for callfile
77                 configs common to all outbound calls.
78                 callfile_lines will be inserted into ALL generated callfiles
79                 after the Channel line.  This content mat be overridden
80                 (in whole) by the org unit setting callfile_lines.
81                 Warning: Invalid syntax may break ALL outbound calls.
82             -->
83             <!-- <callfile_lines>
84                 MaxRetries: 3
85                 RetryTime: 60
86                 WaitTime: 30
87                 Archive: 1
88                 Extension: 10
89             </callfile_lines> -->
90         </telephony>
91
92         <!-- Overdue notices: DEPRECATED in 2.0 in favour of Action/Trigger Notifications -->
93         <overdue>
94
95             <!-- optionally, you can define a sender address per notice type -->
96             <sender_address>overdue@localhost</sender_address>
97
98             <!-- The system can generate an XML file of overdue notices.  This is the
99                 directory where they are stored.  Files are named overdue.YYYY-MM-DD.xml -->
100             <notice_dir>LOCALSTATEDIR/data/overdue</notice_dir>
101             <combined_template>LOCALSTATEDIR/data/templates/overdue_combined_xml.example</combined_template>
102
103             <notice>
104                 <!-- Notify at 7 days overdue -->
105                 <notify_interval>7 days</notify_interval>
106                 <!-- Options include always, noemail, and never.  'noemail' means a notice
107                      will be appended to the notice file only if the patron has no valid email address.  -->
108                 <file_append>noemail</file_append>
109                 <!-- do we attempt email notification? -->
110                 <email_notify>false</email_notify>
111                 <!-- notice template file -->
112                 <email_template>LOCALSTATEDIR/data/templates/overdue_7day.example</email_template>
113             </notice>
114         </overdue>
115
116         <!-- Courtesy notices: DEPRECATED in 2.0 in favour of Action/Trigger Notifications -->
117         <predue>
118             <notice>
119                 <!-- All circulations that circulate between 5 and 13 days -->
120                 <circ_duration_range>
121                     <from>5 days</from>
122                     <to>13 days</to>
123                 </circ_duration_range>
124                 <!-- notify at 1 day before the due date -->
125                 <notify_interval>1 day</notify_interval>
126                 <file_append>false</file_append>
127                 <email_notify>false</email_notify>
128                 <email_template>LOCALSTATEDIR/data/templates/predue_1day.example</email_template>
129             </notice>
130         </predue>
131       </notifications>
132
133         <!-- Settings for the hold targeter cron job -->
134         <hold_targeter>
135             <!-- number of parallel processes to use during hold targeting;
136                  increasing can speed up (re)targeting a large number of
137                  hold requests, but with diminishing returns after a point;
138                  if increasing this value, it is recommend to do so slowly
139             -->
140             <parallel>1</parallel>
141         </hold_targeter>
142
143         <!-- Settings for the fine generator cron job -->
144         <fine_generator>
145             <!-- number of parallel processes to use during fine generation -->
146             <parallel>1</parallel>
147         </fine_generator>
148         
149         <reporter>
150             <!--
151             Settings for the reporter daemon process 
152             -->
153             <setup>
154                 <base_uri>https://localhost/reporter/</base_uri>
155                 <database>
156                     <driver>Pg</driver>
157                     <host>localhost</host>
158                     <port>5432</port>
159                     <db>evergreen</db>
160                     <user>postgres</user>
161                     <pw>postgres</pw>
162                     <application_name>Clark Kent (reports)</application_name>
163                 </database>
164                 <state_store>
165                     <driver>Pg</driver>
166                     <host>localhost</host>
167                     <port>5432</port>
168                     <db>evergreen</db>
169                     <user>postgres</user>
170                     <pw>postgres</pw>
171                     <application_name>Clark Kent (state)</application_name>
172                 </state_store>
173                 <files>
174                     <!-- successful report outputs go here -->
175                     <output_base>LOCALSTATEDIR/web/reporter</output_base>
176                     <success_template>LOCALSTATEDIR/data/report-success</success_template>
177                     <fail_template>LOCALSTATEDIR/data/report-fail</fail_template>
178                 </files>
179                 <!-- Number of reports that can be processed simultaneously.  This
180                      value can overriden by the -c/-concurrency command-line switch
181                      of clark-kent.pl.
182                 -->
183                 <parallel>1</parallel>
184                 <!-- Maximum number of rows in the query results allowed before
185                      Clark will refuse to draw a pie, bar, or line chart.  This
186                      value can be overriden by the -max-rows-for-charts command-line
187                      switch of clark-kent.pl.
188                 -->
189                 <max_rows_for_charts>1000</max_rows_for_charts>
190                 <!-- Maximum amount of time (in minutes) that an SQL query initiated
191                      by Clark Kent will be allowed to run before it is terminated.
192                      This value can be overriden by the -statement-timeout
193                      command-line switch of clark-kent.pl.
194                 -->
195                 <statement_timeout>60</statement_timeout>
196                 <!-- Maximum number of results permitted.  If set to a numeric value,
197                      Clark will limit the number of rows returned by report queries
198                      to this value.  Note that it will not be apparent to a user
199                      running a report from the staff interface that their report
200                      has been limited in this fashion.  This setting can be
201                      overriden by the -resultset-limit command-line switch of
202                      clark-kent.pl.
203
204                      A value of 0 means that no limit should be set.
205                 -->
206                 <resultset_limit>1048575</resultset_limit>
207             </setup>
208         </reporter>
209
210
211
212         <xml-rpc>
213             <!-- XML-RPC gateway.  Do NOT publish unprotected services here -->
214             <allowed_services>
215                 <!-- list of published services -->
216                 <service>opensrf.math</service>
217                 <service>opensrf.dbmath</service>
218                 <service>open-ils.cat</service>
219                 <service>open-ils.search</service>
220                 <service>open-ils.circ</service>
221                 <service>open-ils.actor</service>
222                 <service>open-ils.auth</service>
223                 <service>open-ils.auth_proxy</service>
224                 <service>open-ils.collections</service>
225                 <service>open-ils.justintime</service>
226             </allowed_services>
227         </xml-rpc>
228
229         <!--
230         Once upon a time, Z39.50 servers were defined here. As of Evergreen 2.2,
231         they are now defined in the database. See the Release Notes for
232         instructions on mapping the old XML entries to database tables.
233         -->
234
235         <http_client>
236             <!--
237             These settings are used by the OpenILS::Utils::HTTPClient module
238             when communicating with external services (e.g. third-party APIs)
239             over HTTP.  Values are passed along to LWP::UserAgent.
240             -->
241
242             <!-- custom useragent for HTTP requests
243             <useragent>Evergreen</useragent>
244             -->
245
246             <!-- default timeout value (in seconds) -->
247             <default_timeout>60</default_timeout>
248
249             <ssl_opts>
250                 <!--
251                 When using HTTPS, verify that the external server has a valid
252                 SSL certificate matching the expected hostname.  (Set to 0 to
253                 disable verification, 1 to enable it.)
254                 -->
255                 <verify_hostname>1</verify_hostname>
256
257                 <!--
258                 If verify_hostname is enabled, you may need to specify a path
259                 for CA certificates installed on your system.  Use ONE of the
260                 following settings.  See LWP::UserAgent docs for details.
261                 <SSL_ca_path>/etc/ssl/certs</SSL_ca_path>
262                 <SSL_ca_file>/etc/ssl/certs/ca-certificates.crt</SSL_ca_file>
263                 -->
264             </ssl_opts>
265
266         </http_client>
267
268         <added_content>
269             <!-- load the OpenLibrary added content module -->
270             <module>OpenILS::WWW::AddedContent::OpenLibrary</module>
271
272             <!--
273             Max number of seconds to wait for an added content request to 
274             return data.  Data not returned within the timeout is considered
275             a failure.
276
277             Note that the pool of Apache processes used by the AddedContent
278             module is the same pool used by core Evergreen processes such as
279             search, circulation, etc. Therefore, the higher you set this
280             timeout value, the more likely you are to run out of available
281             Apache processes resulting in an accidental (or purposeful) denial
282             of service - particularly if the added content server starts
283             responding abnormally slowly.
284
285             The safest option is to disable the AddedContent module completely,
286             but 3 seconds is a compromise between the threat of a denial of
287             service and the enhanced user experience offered by successful added
288             content requests.
289             -->
290             <timeout>3</timeout>
291
292             <!--
293             After added content lookups have been disabled due to too many
294             lookup failures, this is the amount of time to wait before
295             we try again
296             -->
297             <retry_timeout>600</retry_timeout>
298
299             <!--
300             maximum number of consecutive lookup errors a given process can 
301             have before added content lookups are disabled for everyone
302             -->
303             <max_errors>15</max_errors>
304
305             <!-- If a userid is required to access the added content.. -->
306             <userid>MY_USER_ID</userid>
307
308             <!--
309             Base URL for Amazon added content fetching. Not needed by OpenLibrary
310             <base_url>http://images.amazon.com/images/P/</base_url>
311             -->
312
313             <!--
314             Segregating the details for ContentCafe out for easier use.  At some point, we
315             may want to support multiple services at one time.
316             -->
317             <ContentCafe>
318                 <userid>MY_USER_ID</userid>
319                 <password>MY_PASSWORD</password>
320
321                 <!--
322                 Which order to put identifiers in.
323                 Default is "isbn,upc", ignoring currently unsupported issn.
324                 Should be all lowercase.
325                 Remove an identifier from the list to skip it.
326                 -->
327                 <identifier_order>isbn,upc</identifier_order>
328             </ContentCafe>
329
330             <!--
331             Segregating the details for obalkyknih.cz out for easier use.
332             -->
333             <ObalkyKnih>
334                 <!-- Covers are there always -->
335
336                 <!-- Annotations provided by obalkyknih.cz is mapped to evergreen summary -->
337                 <summary>false</summary>
338                 
339                 <!-- Provider obalkyknih.cz provides TOC as text and as PDF plus thumbnail -->
340                 <tocPdf>true</tocPdf>
341                 <tocText>false</tocText>
342                 
343                 <!-- User reviews from obalkyknih.cz -->
344                 <reviews>true</reviews>
345
346             </ObalkyKnih>
347
348             <!--
349  
350             You can add free-form settings here and they will be accessible
351             within the added content module
352             -->
353
354         </added_content>
355
356         <!-- Config section for acq_order_reader.pl script.
357              It reads MARC order record files from disk (presumably
358              an FTP destination) and pushes the order records into ACQ.
359              THIS IS NOT EDI. -->
360         <acq_order_reader>
361
362             <!-- Root directory for all FTP'd ACQ order record files .
363                  If the script is configured to talk to a remote acq server,
364                  this directory has to be a read/write NFS share.  -->
365             <base_dir>/openils/var/data/acq_orders/</base_dir>
366
367             <!-- any files found in the shared subdir must be inspected
368                  (e.g. file name prefix) to determine the provider. -->
369             <shared_subdir>ALL</shared_subdir><!-- SUPPORT PENDING -->
370
371             <!-- providers that don't provide a mechanism to inspect the file
372                  have to push their files to provider-specific locations -->
373             <provider>
374                 <ordering_agency>BR1</ordering_agency> <!-- who gets/manages the order -->
375                 <provider_code>BAB</provider_code>   
376                 <provider_owner>CONS</provider_owner>  <!-- provider provider_owner; org unit shortname -->
377                 <subdir>CONS-BAB</subdir> <!-- file directory;  full path = base_dir + subdir -->
378                 <activate_po>false</activate_po> <!-- activate PO at upload? -->
379                 <vandelay>
380                     <import_no_match>true</import_no_match>
381                     <!-- Most Vandelay options are supported.  For bools, use true/false.
382                         match_quality_ratio 
383                         match_set 
384                         bib_source 
385                         merge_profile
386                         create_assets
387                         import_no_match 
388                         auto_overlay_exact 
389                         auto_overlay_1match 
390                         auto_overlay_best_match
391                     -->
392                 </vandelay>
393             </provider>
394
395             <!-- Add more as needed...
396             <provider>
397                 ...
398             </provider>
399             -->
400
401         </acq_order_reader>
402
403
404         <!-- no apps are enabled globally by default -->
405         <activeapps/> 
406
407         <cache>
408             <!-- memcache servers -->
409             <global>
410                 <servers>
411                     <server>127.0.0.1:11211</server>
412                 </servers>
413                 <max_cache_time>86400</max_cache_time>
414             </global>
415             <anon>
416                 <!-- anonymous cache.  currently, primarily used for web session caching -->
417                 <servers>
418                     <server>127.0.0.1:11211</server>
419                 </servers>
420                 <max_cache_time>1800</max_cache_time>
421                 <!-- maximum size of a single cache entry / default = 100k-->
422                 <max_cache_size>102400</max_cache_size>
423             </anon>
424         </cache>
425
426         <apps>
427             <!-- Acquisitions server -->
428             <open-ils.acq>
429                 <!-- how long to wait between stateful requests before the child process re-joins the pool -->
430                 <keepalive>5</keepalive>
431                 <!-- true if this service support stateless requests -->
432                 <stateless>1</stateless>
433                 <!-- implementation language -->
434                 <language>perl</language>
435                 <!-- name of the library that implements this application -->
436                 <implementation>OpenILS::Application::Acq</implementation>
437                 <!-- maximum OpenSRF REQUEST within a stateful connection -->
438                 <max_requests>100</max_requests>
439                 <unix_config>
440                     <!--
441                     maximum number of top level requests coming to 
442                     this child before the child is recycled
443                     -->
444                     <max_requests>100</max_requests>
445                     <!-- min children to fork -->
446                     <min_children>1</min_children>
447                     <!-- max possible children to fork -->
448                     <max_children>15</max_children>
449                     <!--
450                     C forking implementation does not support 
451                     min/max idle children, but may in the future
452                     -->
453
454                     <!-- min idle children -->
455                     <min_spare_children>1</min_spare_children>
456                     <!-- max idle children -->
457                     <max_spare_children>5</max_spare_children>
458                     <!-- currently, only Perl uses the following 3 settings -->
459                     <unix_sock>open-ils.acq_unix.sock</unix_sock>
460                     <unix_pid>open-ils.acq_unix.pid</unix_pid>
461                     <unix_log>open-ils.acq_unix.log</unix_log>
462                 </unix_config>
463             </open-ils.acq>
464
465             <!-- Authentication server -->
466             <open-ils.auth>
467                 <keepalive>5</keepalive>
468                 <stateless>1</stateless>
469                 <language>c</language>
470                 <implementation>liboils_auth.so</implementation>
471                 <unix_config>
472                     <max_requests>1000</max_requests>
473                     <min_children>1</min_children>
474                     <max_children>15</max_children>
475                     <min_spare_children>1</min_spare_children>
476                     <max_spare_children>5</max_spare_children>
477                 </unix_config>
478                 <app_settings>
479                     <!-- defined app-specific settings here -->
480                     <auth_limits>
481                         <seed>30</seed> <!-- amount of time a seed request is valid for -->
482                         <block_time>90</block_time> <!-- amount of time since last auth or seed request to save failure counts -->
483                         <block_count>10</block_count> <!-- number of failures before blocking access -->
484                     </auth_limits>
485                 </app_settings>
486             </open-ils.auth>
487
488             <!-- Internal authentication server -->
489             <open-ils.auth_internal>
490                 <keepalive>5</keepalive>
491                 <stateless>1</stateless>
492                 <language>c</language>
493                 <implementation>liboils_auth_internal.so</implementation>
494                 <unix_config>
495                     <max_requests>1000</max_requests>
496                     <min_children>1</min_children>
497                     <max_children>15</max_children>
498                     <min_spare_children>1</min_spare_children>
499                     <max_spare_children>5</max_spare_children>
500                 </unix_config>
501                 <app_settings>
502                     <!-- defined app-specific settings here -->
503                     <default_timeout>
504                         <!-- default login timeouts based on login type -->
505                         <opac>420</opac>
506                         <staff>7200</staff>
507                         <temp>300</temp>
508                         <persist>2 weeks</persist>
509                     </default_timeout>
510                 </app_settings>
511             </open-ils.auth_internal>
512
513
514
515             <!-- Authentication proxy server -->
516             <open-ils.auth_proxy>
517                 <keepalive>5</keepalive>
518                 <stateless>1</stateless>
519                 <language>perl</language>
520                 <implementation>OpenILS::Application::AuthProxy</implementation>
521                 <max_requests>93</max_requests>
522
523                 <unix_config>
524                     <max_requests>1000</max_requests>
525                     <unix_log>open-ils.auth-proxy_unix.log</unix_log>
526                     <unix_sock>open-ils.auth-proxy_unix.sock</unix_sock>
527                     <unix_pid>open-ils.auth-proxy_unix.pid</unix_pid>
528                     <min_children>1</min_children>
529                     <max_children>15</max_children>
530                     <min_spare_children>1</min_spare_children>
531                     <max_spare_children>5</max_spare_children>
532                 </unix_config>
533
534                 <app_settings>
535                     <!-- 'enabled' is the master switch; set to 'true' to enable proxied logins -->
536                     <enabled>false</enabled>
537                     <authenticators>
538                         <!-- the following is a sample configuration for the LDAP_Auth module; please adjust as needed -->
539                         <!--
540                         <authenticator>
541                             <name>ldap</name>
542                             <module>OpenILS::Application::AuthProxy::LDAP_Auth</module>
543                             <hostname>name.domain.com</hostname>
544                             <basedn>ou=people,dc=domain,dc=com</basedn>
545                             <authid>cn=username,ou=specials,dc=domain,dc=com</authid>
546                             <id_attr>uid</id_attr>
547                             <bind_attr>uid</bind_attr>
548                             <password>my_ldap_password_for_authid_user</password>
549                             <login_types>
550                                 <type>staff</type>
551                                 <type>opac</type>
552                                 <type>persist</type>
553                             </login_types>
554                             <org_units>
555                                 <unit>103</unit>
556                                 <unit>104</unit>
557                             </org_units>
558                             <restrict_by_home_ou>false</restrict_by_home_ou>
559                         </authenticator>
560                         -->
561                         <!-- 'native' is a proxied version of Evergreen's standard authentication -->
562                         <authenticator>
563                             <name>native</name>
564                             <!-- you can add 'login_types' and 'org_units' limits to this authenticator as well, if needed -->
565                         </authenticator>
566                     </authenticators>
567                 </app_settings>
568             </open-ils.auth_proxy>
569
570             <!-- Generic search server -->
571             <open-ils.search>
572                 <keepalive>5</keepalive>
573                 <stateless>1</stateless>
574                 <language>perl</language>
575                 <implementation>OpenILS::Application::Search</implementation>
576                 <max_requests>93</max_requests>
577                 <unix_config>
578                     <unix_sock>open-ils.search_unix.sock</unix_sock>
579                     <unix_pid>open-ils.search_unix.pid</unix_pid>
580                     <unix_log>open-ils.search_unix.log</unix_log>
581
582                     <max_requests>1000</max_requests>
583                     <min_children>1</min_children>
584                     <max_children>15</max_children>
585                     <min_spare_children>1</min_spare_children>
586                     <max_spare_children>5</max_spare_children>
587                 </unix_config>
588                 <app_settings>
589                     <marc_html_xsl>oilsMARC21slim2HTML.xsl</marc_html_xsl>
590                     <marc_html_xsl_slim>oilsMARC21slim2HTMLslim.xsl</marc_html_xsl_slim>
591
592                     <spelling_dictionary>
593                         <!-- 
594                             Optionally configure different dictionaries depending on search context.  
595                             If no dictionaries are defined, the default Aspell dictionary is used.
596                         -->
597                         <!--
598                         <default>LOCALSTATEDIR/data/default_dict.txt</default>
599                         <title>LOCALSTATEDIR/data/title_dict.txt</title>
600                         <author>LOCALSTATEDIR/data/author_dict.txt</author>
601                         <subject>LOCALSTATEDIR/data/subject_dict.txt</subject>
602                         <series>LOCALSTATEDIR/data/series_dict.txt</series>
603                         -->
604                     </spelling_dictionary>
605
606                     <!-- Default to using staged search -->
607                     <use_staged_search>true</use_staged_search>
608
609                     <!--
610                         For staged search, we estimate hits based on inclusion or exclusion.
611
612                         Valid settings:
613                             inclusion - visible ratio on superpage
614                             exclusion - excluded ratio on superpage
615                             delete_adjusted_inclusion - included ratio on superpage, ratio adjusted by deleted count
616                             delete_adjusted_exclusion - excluded ratio on superpage, ratio adjusted by deleted count
617
618                         Under normal circumstances, inclusion is the best strategy, and both delete_adjusted variants
619                         will return the same value +/- 1.  The exclusion strategy is the original, and works well
620                         when there are few deleted or excluded records, in other words, when the superpage is not
621                         sparsely populated with visible records.
622                     -->
623                     <estimation_strategy>inclusion</estimation_strategy>
624
625                     <!--
626                         Evergreen uses a cover density algorithm for calculating relative ranking of matches.  There
627                         are several tuning parameters and options available.  By default, no document length normalization
628                         is applied.  From the Postgres documentation on ts_rank_cd() (the function used by Evergreen):
629
630                             Since a longer document has a greater chance of containing a query term it is reasonable 
631                             to take into account document size, e.g., a hundred-word document with five instances of 
632                             a search word is probably more relevant than a thousand-word document with five instances. 
633                             Both ranking functions take an integer normalization option that specifies whether and how 
634                             a document's length should impact its rank. The integer option controls several behaviors, 
635                             so it is a bit mask: you can specify one or more behaviors using | (for example, 2|4).
636
637                                 0 (the default) ignores the document length
638
639                                 1 divides the rank by 1 + the logarithm of the document length
640
641                                 2 divides the rank by the document length
642
643                                 4 divides the rank by the mean harmonic distance between extents (this is implemented only by ts_rank_cd)
644
645                                 8 divides the rank by the number of unique words in document
646
647                                 16 divides the rank by 1 + the logarithm of the number of unique words in document
648
649                                 32 divides the rank by itself + 1
650
651                             If more than one flag bit is specified, the transformations are applied in the order listed.
652
653                             It is important to note that the ranking functions do not use any global information, so it 
654                             is impossible to produce a fair normalization to 1% or 100% as sometimes desired. Normalization 
655                             option 32 (rank/(rank+1)) can be applied to scale all ranks into the range zero to one, but of 
656                             course this is just a cosmetic change; it will not affect the ordering of the search results.
657
658                         In Evergreen, these options are set via search modifiers.  The modifiers are mapped in the
659                         following way:
660
661                             * #CD_logDocumentLength  => 1  :: rank / (1 + LOG(total_word_count))   :: Longer documents slightly less relevant
662                             * #CD_documentLength     => 2  :: rank / total_word_count              :: Longer documents much less relevant
663                             * #CD_meanHarmonic       => 4  :: Word Proximity                       :: Greater matched-word distance is less relevant
664                             * #CD_uniqueWords        => 8  :: rank / unique_word_count             :: Documents with repeated words much less relevant
665                             * #CD_logUniqueWords     => 16 :: rank / (1 + LOG(unique_word_count))  :: Documents with repeated words slightly less relevant
666                             * #CD_selfPlusOne        => 32 :: rank / (1 + rank)                    :: Cosmetic normalization of rank value between 0 and 1
667
668                         Adding one or more of these to the default_CD_modifiers list will cause all searches that use QueryParser to apply them.
669                     -->
670                     <default_CD_modifiers>#CD_documentLength #CD_meanHarmonic #CD_uniqueWords</default_CD_modifiers>
671
672                     <!--
673                         default_preferred_language
674                             Set the global, default preferred languange
675                     -->
676                     <default_preferred_language>eng</default_preferred_language>
677
678                     <!--
679                         default_preferred_language_weight
680                             Set the weight (higher is "better") for the preferred language. Comment out to remove all lanuage weighting by default.
681                     -->
682                     <default_preferred_language_weight>5</default_preferred_language_weight>
683
684                     <!-- Baseline number of records to check for hit estimation. -->
685                     <superpage_size>1000</superpage_size>
686
687                     <!-- How many superpages to consider for searching overall. -->
688                     <max_superpages>100</max_superpages>
689
690                     <!-- zip code database file -->
691                     <!--<zips_file>LOCALSTATEDIR/data/zips.txt</zips_file>-->
692                 </app_settings>
693             </open-ils.search>
694
695             <!-- server for accessing user info -->
696             <open-ils.actor>
697                 <keepalive>5</keepalive>
698                 <stateless>1</stateless>
699                 <language>perl</language>
700                 <implementation>OpenILS::Application::Actor</implementation>
701                 <max_requests>93</max_requests>
702                 <unix_config>
703                     <unix_sock>open-ils.actor_unix.sock</unix_sock>
704                     <unix_pid>open-ils.actor_unix.pid</unix_pid>
705                     <max_requests>1000</max_requests>
706                     <unix_log>open-ils.actor_unix.log</unix_log>
707                     <min_children>1</min_children>
708                     <max_children>15</max_children>
709                     <min_spare_children>1</min_spare_children>
710                     <max_spare_children>5</max_spare_children>
711                 </unix_config>
712                 <!-- set this to 'true' to have barcode search also search patron records by unique ID -->
713                 <app_settings>
714                     <id_as_barcode>false</id_as_barcode>
715                 </app_settings>
716
717             </open-ils.actor>
718
719             <open-ils.booking>
720                 <keepalive>5</keepalive>
721                 <stateless>1</stateless>
722                 <language>perl</language>
723                 <implementation>OpenILS::Application::Booking</implementation>
724                 <max_requests>199</max_requests>
725                 <unix_config>
726                     <unix_sock>open-ils.booking_unix.sock</unix_sock>
727                     <unix_pid>open-ils.booking_unix.pid</unix_pid>
728                     <max_requests>1000</max_requests>
729                     <unix_log>open-ils.booking_unix.log</unix_log>
730                     <min_children>1</min_children>
731                     <max_children>15</max_children>
732                     <min_spare_children>1</min_spare_children>
733                     <max_spare_children>5</max_spare_children>
734                 </unix_config>
735                 <app_settings>
736                 </app_settings>
737             </open-ils.booking>
738
739             <open-ils.cat>
740                 <keepalive>5</keepalive>
741                 <stateless>1</stateless>
742                 <language>perl</language>
743                 <implementation>OpenILS::Application::Cat</implementation>
744                 <max_requests>199</max_requests>
745                 <unix_config>
746                     <unix_sock>open-ils.cat_unix.sock</unix_sock>
747                     <unix_pid>open-ils.cat_unix.pid</unix_pid>
748                     <max_requests>1000</max_requests>
749                     <unix_log>open-ils.cat_unix.log</unix_log>
750                     <min_children>1</min_children>
751                     <max_children>15</max_children>
752                     <min_spare_children>1</min_spare_children>
753                     <max_spare_children>5</max_spare_children>
754                 </unix_config>
755                 <app_settings>
756                     <marctemplates>
757                         <K_book>LOCALSTATEDIR/templates/marc/k_book.xml</K_book>
758                     </marctemplates>
759                 </app_settings>
760             </open-ils.cat>
761
762             <open-ils.supercat>
763                 <keepalive>5</keepalive>
764                 <stateless>1</stateless>
765                 <language>perl</language>
766                 <implementation>OpenILS::Application::SuperCat</implementation>
767                 <max_requests>199</max_requests>
768                 <unix_config>
769                     <unix_sock>open-ils.supercat_unix.sock</unix_sock>
770                     <unix_pid>open-ils.supercat_unix.pid</unix_pid>
771                     <max_requests>1000</max_requests>
772                     <unix_log>open-ils.supercat_unix.log</unix_log>
773                     <min_children>1</min_children>
774                     <max_children>15</max_children>
775                     <min_spare_children>1</min_spare_children>
776                     <max_spare_children>5</max_spare_children>
777                 </unix_config>
778             </open-ils.supercat>
779
780             <!-- server for accessing user info -->
781             <open-ils.trigger>
782                 <keepalive>5</keepalive>
783                 <stateless>1</stateless>
784                 <language>perl</language>
785                 <implementation>OpenILS::Application::Trigger</implementation>
786                 <max_requests>93</max_requests>
787                 <unix_config>
788                     <unix_sock>open-ils.trigger_unix.sock</unix_sock>
789                     <unix_pid>open-ils.trigger_unix.pid</unix_pid>
790                     <max_requests>1000</max_requests>
791                     <unix_log>open-ils.trigger_unix.log</unix_log>
792                     <min_children>1</min_children>
793                     <max_children>15</max_children>
794                     <min_spare_children>1</min_spare_children>
795                     <max_spare_children>5</max_spare_children>
796                 </unix_config>
797                 <app_settings>
798                     <!-- number of parallel open-ils.trigger processes to use for collection and reaction -->
799                     <!--
800                     <parallel>
801                         <collect>3</collect>
802                         <react>3</react>
803                     </parallel>
804                     -->
805                 </app_settings>
806             </open-ils.trigger>
807
808             <open-ils.url_verify>
809                 <keepalive>5</keepalive>
810                 <stateless>1</stateless>
811                 <language>perl</language>
812                 <implementation>OpenILS::Application::URLVerify</implementation>
813                 <max_requests>199</max_requests>
814                 <unix_config>
815                     <unix_sock>open-ils.url_verify_unix.sock</unix_sock>
816                     <unix_pid>open-ils.url_verify_unix.pid</unix_pid>
817                     <max_requests>1000</max_requests>
818                     <unix_log>open-ils.url_verify_unix.log</unix_log>
819                     <min_children>1</min_children>
820                     <max_children>15</max_children>
821                     <min_spare_children>1</min_spare_children>
822                     <max_spare_children>5</max_spare_children>
823                 </unix_config>
824                 <app_settings>
825                     <user_agent>Evergreen %s Link Checker</user_agent>
826                 </app_settings>
827             </open-ils.url_verify>
828
829             <opensrf.math>
830                 <keepalive>3</keepalive>
831                 <stateless>1</stateless>
832                 <language>c</language>
833                 <implementation>libosrf_math.so</implementation>
834                 <unix_config>
835                     <unix_sock>opensrf.math_unix.sock</unix_sock>
836                     <unix_pid>opensrf.math_unix.pid</unix_pid>
837                     <max_requests>1000</max_requests>
838                     <unix_log>opensrf.math_unix.log</unix_log>
839                     <min_children>1</min_children>
840                     <max_children>15</max_children>
841                     <min_spare_children>1</min_spare_children>
842                     <max_spare_children>5</max_spare_children>
843                 </unix_config>
844             </opensrf.math>
845
846             <opensrf.dbmath> 
847                 <keepalive>3</keepalive>
848                 <stateless>1</stateless>
849                 <language>c</language>
850                 <implementation>libosrf_dbmath.so</implementation>
851                 <unix_config>
852                     <max_requests>1000</max_requests>
853                     <unix_log>opensrf.dbmath_unix.log</unix_log>
854                     <unix_sock>opensrf.dbmath_unix.sock</unix_sock>
855                     <unix_pid>opensrf.dbmath_unix.pid</unix_pid>
856                     <min_children>1</min_children>
857                     <max_children>15</max_children>
858                     <min_spare_children>1</min_spare_children> 
859                     <max_spare_children>5</max_spare_children>
860                 </unix_config>
861             </opensrf.dbmath>
862
863             <open-ils.justintime>
864                 <keepalive>5</keepalive>
865                 <stateless>1</stateless>
866                 <language>perl</language>
867                 <implementation>OpenILS::Application::JustInTime</implementation>
868                 <max_requests>199</max_requests>
869                 <unix_config>
870                     <unix_sock>open-ils.justintime_unix.sock</unix_sock>
871                     <unix_pid>open-ils.justintime_unix.pid</unix_pid>
872                     <max_requests>1000</max_requests>
873                     <unix_log>open-ils.justintime_unix.log</unix_log>
874                     <min_children>1</min_children>
875                     <max_children>15</max_children>
876                     <min_spare_children>1</min_spare_children>
877                     <max_spare_children>5</max_spare_children>
878                 </unix_config>
879                 <app_settings>
880                 </app_settings>
881             </open-ils.justintime>
882
883             <open-ils.circ> 
884                 <keepalive>3</keepalive>
885                 <stateless>1</stateless>
886                 <language>perl</language>
887                 <implementation>OpenILS::Application::Circ</implementation>
888                 <max_requests>99</max_requests>
889                 <unix_config>
890                     <max_requests>1000</max_requests>
891                     <unix_log>open-ils.circ_unix.log</unix_log>
892                     <unix_sock>open-ils.circ_unix.sock</unix_sock>
893                     <unix_pid>open-ils.circ_unix.pid</unix_pid>
894                     <min_children>1</min_children>
895                     <max_children>15</max_children>
896                     <min_spare_children>1</min_spare_children> 
897                     <max_spare_children>5</max_spare_children>
898                 </unix_config>
899                 <app_settings>
900                     <notify_hold>
901                         <email>false</email> <!-- set to false to disable hold notice emails -->
902                     </notify_hold>
903                 </app_settings>
904             </open-ils.circ>
905
906             <open-ils.storage>
907                 <keepalive>10</keepalive>
908                 <stateless>1</stateless>
909                 <language>perl</language>
910                 <implementation>OpenILS::Application::Storage</implementation>
911                 <unix_config>
912                     <max_requests>1000</max_requests>
913                     <unix_log>open-ils.storage_unix.log</unix_log>
914                     <unix_sock>open-ils.storage_unix.sock</unix_sock>
915                     <unix_pid>open-ils.storage_unix.pid</unix_pid>
916                     <min_children>1</min_children>
917                     <max_children>10</max_children>
918                     <min_spare_children>1</min_spare_children>
919                     <max_spare_children>5</max_spare_children>
920                 </unix_config>
921                 <app_settings>
922                     <script_path>LIBDIR/javascript/</script_path>
923                     <script_path>LOCALSTATEDIR/catalog/</script_path>
924                     <scripts>
925                         <biblio_fingerprint>biblio_fingerprint.js</biblio_fingerprint>
926                     </scripts>
927                     <databases>
928                         <driver>Pg</driver>
929                         <database>
930                             <type>master</type>
931                             <weight>2</weight>
932                             <user>postgres</user>
933                             <host>localhost</host>
934                             <port>5432</port>
935                             <pw>postgres</pw>
936                             <db>evergreen</db>
937                             <client_encoding>UTF-8</client_encoding>
938                             <application_name>open-ils.storage</application_name>
939                         </database>
940                     </databases>
941                 </app_settings>
942             </open-ils.storage>
943
944             <open-ils.cstore>
945                 <keepalive>6</keepalive>
946                 <stateless>1</stateless>
947                 <language>C</language>
948                 <implementation>liboils_cstore.so</implementation>
949                 <unix_config>
950                     <max_requests>1000</max_requests>
951                     <min_children>1</min_children>
952                     <max_children>15</max_children>
953                     <min_spare_children>1</min_spare_children>
954                     <max_spare_children>5</max_spare_children>
955                 </unix_config>
956                 <app_settings>
957                     <max_query_recursion>100</max_query_recursion>
958                     <driver>pgsql</driver>
959                     <database>
960                         <type>master</type>
961                         <weight>2</weight>
962                         <user>postgres</user>
963                         <host>localhost</host>
964                         <port>5432</port>
965                         <pw>postgres</pw>
966                         <db>evergreen</db>
967                         <client_encoding>UTF-8</client_encoding>
968                         <application_name>open-ils.cstore</application_name>
969                     </database>
970                 </app_settings>
971             </open-ils.cstore>
972
973             <open-ils.pcrud>
974                 <keepalive>6</keepalive>
975                 <migratable>1</migratable>
976                 <stateless>1</stateless>
977                 <language>C</language>
978                 <implementation>liboils_pcrud.so</implementation>
979
980                 <unix_config>
981                     <unix_log>open-ils.pcrud.log</unix_log>
982                     <unix_sock>open-ils.pcrud.sock</unix_sock>
983                     <unix_pid>open-ils.pcrud.pid</unix_pid>
984                     <max_requests>1000</max_requests>
985                     <min_children>1</min_children>
986                     <max_children>15</max_children>
987                     <min_spare_children>1</min_spare_children>
988                     <max_spare_children>5</max_spare_children>
989                 </unix_config>
990
991                 <app_settings>
992                     <IDL>SYSCONFDIR/fm_IDL.xml</IDL>
993                     <driver>pgsql</driver>
994                     <database>
995                         <type>master</type>
996                         <weight>2</weight>
997                         <user>postgres</user>
998                         <host>localhost</host>
999                         <port>5432</port>
1000                         <pw>postgres</pw>
1001                         <db>evergreen</db>
1002                         <client_encoding>UTF-8</client_encoding>
1003                         <application_name>open-ils.pcrud</application_name>
1004                     </database>
1005                 </app_settings>
1006             </open-ils.pcrud>
1007
1008             <open-ils.qstore>
1009                 <keepalive>6</keepalive>
1010                 <stateless>1</stateless>
1011                 <language>C</language>
1012                 <implementation>liboils_qstore.so</implementation>
1013                 <unix_config>
1014                     <max_requests>1000</max_requests>
1015                     <min_children>1</min_children>
1016                     <max_children>15</max_children>
1017                     <min_spare_children>1</min_spare_children>
1018                     <max_spare_children>5</max_spare_children>
1019                 </unix_config>
1020                 <app_settings>
1021                     <driver>pgsql</driver>
1022                     <database>
1023                         <type>master</type>
1024                         <weight>2</weight>
1025                         <user>postgres</user>
1026                         <host>localhost</host>
1027                         <port>5432</port>
1028                         <pw>postgres</pw>
1029                         <db>evergreen</db>
1030                         <client_encoding>UTF-8</client_encoding>
1031                         <application_name>open-ils.qstore</application_name>
1032                     </database>
1033                 </app_settings>
1034             </open-ils.qstore>
1035
1036             <opensrf.settings>
1037                 <keepalive>1</keepalive>
1038                 <stateless>1</stateless>
1039                 <language>perl</language>
1040                 <implementation>OpenSRF::Application::Settings</implementation>
1041                 <max_requests>17</max_requests>
1042                 <unix_config>
1043                     <unix_sock>opensrf.settings_unix.sock</unix_sock>
1044                     <unix_pid>opensrf.settings_unix.pid</unix_pid>
1045                     <max_requests>300</max_requests>
1046                     <unix_log>opensrf.settings_unix.log</unix_log>
1047                     <min_children>5</min_children>
1048                     <max_children>15</max_children>
1049                     <min_spare_children>3</min_spare_children>
1050                     <max_spare_children>5</max_spare_children>
1051                 </unix_config>
1052             </opensrf.settings>
1053
1054             <open-ils.collections>
1055                 <keepalive>3</keepalive>
1056                 <stateless>1</stateless>
1057                 <language>perl</language>
1058                 <implementation>OpenILS::Application::Collections</implementation>
1059                 <max_requests>17</max_requests>
1060                 <unix_config>
1061                     <unix_sock>open-ils.collections_unix.sock</unix_sock>
1062                     <unix_pid>open-ils.collections_unix.pid</unix_pid>
1063                     <max_requests>1000</max_requests>
1064                     <unix_log>open-ils.collections_unix.log</unix_log>
1065                     <min_children>1</min_children>
1066                     <max_children>10</max_children>
1067                     <min_spare_children>1</min_spare_children>
1068                     <max_spare_children>5</max_spare_children>
1069                 </unix_config>
1070                 <app_settings>
1071                     <!-- batch_file_dir must be a protected, web-accessible, shared directory -->
1072                     <batch_file_dir>/openils/var/web/collections</batch_file_dir>
1073                 </app_settings>
1074             </open-ils.collections>
1075
1076             <open-ils.reporter>
1077                 <keepalive>3</keepalive>
1078                 <stateless>1</stateless>
1079                 <language>perl</language>
1080                 <implementation>OpenILS::Application::Reporter</implementation>
1081                 <max_requests>99</max_requests>
1082                 <unix_config>
1083                     <unix_sock>open-ils.reporter_unix.sock</unix_sock>
1084                     <unix_pid>open-ils.reporter_unix.pid</unix_pid>
1085                     <max_requests>1000</max_requests>
1086                     <unix_log>open-ils.reporter_unix.log</unix_log>
1087                     <min_children>1</min_children>
1088                     <max_children>10</max_children>
1089                     <min_spare_children>1</min_spare_children>
1090                     <max_spare_children>5</max_spare_children>
1091                 </unix_config>
1092             </open-ils.reporter>
1093
1094             <open-ils.reporter-store>
1095                 <keepalive>6</keepalive>
1096                 <stateless>1</stateless>
1097                 <language>C</language>
1098                 <implementation>liboils_rstore.so</implementation>
1099                 <unix_config>
1100                     <max_requests>400</max_requests>
1101                     <min_children>1</min_children>
1102                     <max_children>10</max_children>
1103                     <min_spare_children>1</min_spare_children>
1104                     <max_spare_children>5</max_spare_children>
1105                 </unix_config>
1106                 <app_settings>
1107                     <driver>pgsql</driver>
1108                     <database>
1109                         <type>master</type>
1110                         <weight>2</weight>
1111                         <user>postgres</user>
1112                         <host>localhost</host>
1113                         <port>5432</port>
1114                         <pw>postgres</pw>
1115                         <db>evergreen</db>
1116                         <client_encoding>UTF-8</client_encoding>
1117                         <application_name>open-ils.reporter-store</application_name>
1118                     </database>
1119                 </app_settings>
1120             </open-ils.reporter-store>
1121
1122 <!-- resolver_type defaults to sfx but can also be cufts -->
1123 <!--
1124            <open-ils.resolver>
1125                <keepalive>3</keepalive>
1126                <stateless>1</stateless>
1127                <language>perl</language>
1128                <implementation>OpenILS::Application::ResolverResolver</implementation>
1129                <max_requests>93</max_requests>
1130                <unix_config>
1131                   <unix_sock>open-ils.resolver_unix.sock</unix_sock>
1132                   <unix_pid>open-ils.resolver_unix.pid</unix_pid>
1133                   <max_requests>1000</max_requests>
1134                   <unix_log>open-ils.resolver_unix.log</unix_log>
1135                   <min_children>5</min_children>
1136                   <max_children>15</max_children>
1137                   <min_spare_children>3</min_spare_children>
1138                   <max_spare_children>5</max_spare_children>
1139                </unix_config>
1140                <app_settings>
1141                   <cache_timeout>86400</cache_timeout>
1142                   <request_timeout>10</request_timeout>
1143                   <default_url_base>http://path/to/sfx_or_cufts</default_url_base>
1144                   <resolver_type>sfx</resolver_type>
1145                </app_settings>
1146             </open-ils.resolver>
1147 -->
1148
1149             <open-ils.permacrud>
1150                <keepalive>3</keepalive>
1151                <stateless>1</stateless>
1152                <language>perl</language>
1153                <implementation>OpenILS::Application::PermaCrud</implementation>
1154                <max_requests>17</max_requests>
1155                <unix_config>
1156                   <unix_sock>open-ils.permacrud_unix.sock</unix_sock>
1157                   <unix_pid>open-ils.permacrud_unix.pid</unix_pid>
1158                   <max_requests>1000</max_requests>
1159                   <unix_log>open-ils.permacrud_unix.log</unix_log>
1160                   <min_children>5</min_children>
1161                   <max_children>15</max_children>
1162                   <min_spare_children>3</min_spare_children>
1163                   <max_spare_children>5</max_spare_children>
1164                </unix_config>
1165             </open-ils.permacrud>
1166
1167             <open-ils.fielder>
1168                <keepalive>3</keepalive>
1169                <stateless>1</stateless>
1170                <language>perl</language>
1171                <implementation>OpenILS::Application::Fielder</implementation>
1172                <max_requests>17</max_requests>
1173                <unix_config>
1174                   <unix_sock>open-ils.fielder_unix.sock</unix_sock>
1175                   <unix_pid>open-ils.fielder_unix.pid</unix_pid>
1176                   <max_requests>1000</max_requests>
1177                   <unix_log>open-ils.fielder_unix.log</unix_log>
1178                   <min_children>5</min_children>
1179                   <max_children>15</max_children>
1180                   <min_spare_children>3</min_spare_children>
1181                   <max_spare_children>5</max_spare_children>
1182                </unix_config>
1183             </open-ils.fielder>
1184
1185             <open-ils.vandelay>
1186                 <keepalive>5</keepalive>
1187                 <stateless>1</stateless>
1188                 <language>perl</language>
1189                 <implementation>OpenILS::Application::Vandelay</implementation>
1190                 <max_requests>100</max_requests>
1191                 <unix_config>
1192                     <unix_sock>vandelay_unix.sock</unix_sock>
1193                     <unix_pid>vandelay_unix.pid</unix_pid>
1194                     <unix_log>vandelay_unix.log</unix_log>
1195                     <max_requests>100</max_requests>
1196                     <min_children>1</min_children>
1197                     <max_children>15</max_children>
1198                     <min_spare_children>1</min_spare_children>
1199                     <max_spare_children>5</max_spare_children>
1200                 </unix_config>
1201                 <app_settings>
1202                     <databases>
1203                         <!-- temporary location for MARC import files.  
1204                             Files will be deleted after records are spooled.
1205                             *note:  in a multi-brick environment, this will need to
1206                             be on a write-able NFS share.  -->
1207                         <importer>/tmp</importer>
1208                     </databases>
1209                 </app_settings>
1210             </open-ils.vandelay>
1211
1212             <open-ils.serial>
1213                 <keepalive>3</keepalive>
1214                 <stateless>1</stateless>
1215                 <language>perl</language>
1216                 <implementation>OpenILS::Application::Serial</implementation>
1217                 <max_requests>17</max_requests>
1218                 <unix_config>
1219                     <unix_sock>open-ils.serial_unix.sock</unix_sock>
1220                     <unix_pid>open-ils.serial_unix.pid</unix_pid>
1221                     <max_requests>1000</max_requests>
1222                     <unix_log>open-ils.serial_unix.log</unix_log>
1223                     <min_children>5</min_children>
1224                     <max_children>15</max_children>
1225                     <min_spare_children>3</min_spare_children>
1226                     <max_spare_children>5</max_spare_children>
1227                 </unix_config>
1228                 <app_settings>
1229                 </app_settings>
1230             </open-ils.serial>
1231
1232             <open-ils.hold-targeter>
1233                 <keepalive>3</keepalive>
1234                 <stateless>1</stateless>
1235                 <language>perl</language>
1236                 <implementation>OpenILS::Application::HoldTargeter</implementation>
1237                 <max_requests>17</max_requests>
1238                 <unix_config>
1239                     <unix_sock>open-ils.hold-targeter_unix.sock</unix_sock>
1240                     <unix_pid>open-ils.hold-targeter_unix.pid</unix_pid>
1241                     <max_requests>1000</max_requests>
1242                     <unix_log>open-ils.hold-targeter_unix.log</unix_log>
1243                     <min_children>1</min_children>
1244                     <max_children>15</max_children>
1245                     <min_spare_children>1</min_spare_children>
1246                     <max_spare_children>5</max_spare_children>
1247                 </unix_config>
1248                 <app_settings>
1249                 </app_settings>
1250             </open-ils.hold-targeter>
1251
1252             <open-ils.ebook_api>
1253                 <keepalive>5</keepalive>
1254                 <stateless>1</stateless>
1255                 <language>perl</language>
1256                 <implementation>OpenILS::Application::EbookAPI</implementation>
1257                 <max_requests>100</max_requests>
1258                 <unix_config>
1259                     <unix_sock>ebook_api_unix.sock</unix_sock>
1260                     <unix_pid>ebook_api_unix.pid</unix_pid>
1261                     <unix_log>ebook_api_unix.log</unix_log>
1262                     <max_requests>100</max_requests>
1263                     <min_children>1</min_children>
1264                     <max_children>15</max_children>
1265                     <min_spare_children>1</min_spare_children>
1266                     <max_spare_children>5</max_spare_children>
1267                 </unix_config>
1268                 <app_settings>
1269                   <cache_timeout>300</cache_timeout>
1270                   <request_timeout>60</request_timeout>
1271                 </app_settings>
1272             </open-ils.ebook_api>
1273         </apps>
1274     </default>
1275
1276     <hosts>
1277
1278         <localhost> 
1279             <!-- ^-=- 
1280             Should match the fully qualified domain name of the host.
1281
1282             On Linux, the output of the following command is authoritative:
1283             $ perl -MNet::Domain -e 'print Net::Domain::hostfqdn() . "\n";'
1284
1285             To use 'localhost' instead, run osrf_control with the 'localhost' flag
1286             -->
1287
1288             <activeapps>
1289                 <!-- services hosted on this machine -->
1290                 <appname>opensrf.settings</appname> 
1291                 <appname>opensrf.math</appname> 
1292                 <appname>opensrf.dbmath</appname> 
1293                 <appname>open-ils.acq</appname> 
1294                 <appname>open-ils.booking</appname>
1295                 <appname>open-ils.cat</appname> 
1296                 <appname>open-ils.supercat</appname> 
1297                 <appname>open-ils.search</appname> 
1298                 <appname>open-ils.circ</appname> 
1299                 <appname>open-ils.actor</appname> 
1300                 <appname>open-ils.auth</appname> 
1301                 <appname>open-ils.auth_internal</appname>
1302                 <appname>open-ils.auth_proxy</appname> 
1303                 <appname>open-ils.storage</appname>  
1304                 <appname>open-ils.justintime</appname>  
1305                 <appname>open-ils.cstore</appname>  
1306                 <appname>open-ils.collections</appname>  
1307                 <appname>open-ils.qstore</appname>
1308                 <appname>open-ils.reporter</appname>  
1309                 <appname>open-ils.reporter-store</appname>  
1310                 <!-- <appname>open-ils.resolver</appname> -->
1311                 <appname>open-ils.permacrud</appname>  
1312                 <appname>open-ils.pcrud</appname>  
1313                 <appname>open-ils.trigger</appname>  
1314                 <appname>open-ils.url_verify</appname>
1315                 <appname>open-ils.fielder</appname>  
1316                 <appname>open-ils.vandelay</appname>  
1317                 <appname>open-ils.serial</appname>  
1318                 <appname>open-ils.hold-targeter</appname>  
1319                 <appname>open-ils.ebook_api</appname>
1320             </activeapps>
1321         </localhost>
1322     </hosts>
1323
1324 </opensrf>