]> git.evergreen-ils.org Git - working/Evergreen.git/blob - Open-ILS/examples/opensrf.xml.example
LP#1413624: update doc to reflect that spaces can also delimit option lists
[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                 </database>
163                 <state_store>
164                     <driver>Pg</driver>
165                     <host>localhost</host>
166                     <port>5432</port>
167                     <db>evergreen</db>
168                     <user>postgres</user>
169                     <pw>postgres</pw>
170                 </state_store>
171                 <files>
172                     <!-- successful report outputs go here -->
173                     <output_base>LOCALSTATEDIR/web/reporter</output_base>
174                     <success_template>LOCALSTATEDIR/data/report-success</success_template>
175                     <fail_template>LOCALSTATEDIR/data/report-fail</fail_template>
176                 </files>
177             </setup>
178         </reporter>
179
180
181
182         <xml-rpc>
183             <!-- XML-RPC gateway.  Do NOT publish unprotected services here -->
184             <allowed_services>
185                 <!-- list of published services -->
186                 <service>opensrf.math</service>
187                 <service>opensrf.dbmath</service>
188                 <service>open-ils.cat</service>
189                 <service>open-ils.search</service>
190                 <service>open-ils.circ</service>
191                 <service>open-ils.actor</service>
192                 <service>open-ils.auth</service>
193                 <service>open-ils.auth_proxy</service>
194                 <service>open-ils.collections</service>
195                 <service>open-ils.justintime</service>
196             </allowed_services>
197         </xml-rpc>
198
199         <!--
200         Once upon a time, Z39.50 servers were defined here. As of Evergreen 2.2,
201         they are now defined in the database. See the Release Notes for
202         instructions on mapping the old XML entries to database tables.
203         -->
204
205         <added_content>
206             <!-- load the OpenLibrary added content module -->
207             <module>OpenILS::WWW::AddedContent::OpenLibrary</module>
208
209             <!--
210             Max number of seconds to wait for an added content request to 
211             return data.  Data not returned within the timeout is considered
212             a failure.
213
214             Note that the pool of Apache processes used by the AddedContent
215             module is the same pool used by core Evergreen processes such as
216             search, circulation, etc. Therefore, the higher you set this
217             timeout value, the more likely you are to run out of available
218             Apache processes resulting in an accidental (or purposeful) denial
219             of service - particularly if the added content server starts
220             responding abnormally slowly.
221
222             The safest option is to disable the AddedContent module completely,
223             but 3 seconds is a compromise between the threat of a denial of
224             service and the enhanced user experience offered by successful added
225             content requests.
226             -->
227             <timeout>3</timeout>
228
229             <!--
230             After added content lookups have been disabled due to too many
231             lookup failures, this is the amount of time to wait before
232             we try again
233             -->
234             <retry_timeout>600</retry_timeout>
235
236             <!--
237             maximum number of consecutive lookup errors a given process can 
238             have before added content lookups are disabled for everyone
239             -->
240             <max_errors>15</max_errors>
241
242             <!-- If a userid is required to access the added content.. -->
243             <userid>MY_USER_ID</userid>
244
245             <!--
246             Base URL for Amazon added content fetching. Not needed by OpenLibrary
247             <base_url>http://images.amazon.com/images/P/</base_url>
248             -->
249
250             <!--
251             Segregating the details for ContentCafe out for easier use.  At some point, we
252             may want to support multiple services at one time.
253             -->
254             <ContentCafe>
255                 <userid>MY_USER_ID</userid>
256                 <password>MY_PASSWORD</password>
257
258                 <!--
259                 Which order to put identifiers in.
260                 Default is "isbn,upc", ignoring currently unsupported issn.
261                 Should be all lowercase.
262                 Remove an identifier from the list to skip it.
263                 -->
264                 <identifier_order>isbn,upc</identifier_order>
265             </ContentCafe>
266
267             <!--
268  
269             You can add free-form settings here and they will be accessible
270             within the added content module
271             -->
272
273         </added_content>
274
275         <!-- Config section for acq_order_reader.pl script.
276              It reads MARC order record files from disk (presumably
277              an FTP destination) and pushes the order records into ACQ.
278              THIS IS NOT EDI. -->
279         <acq_order_reader>
280
281             <!-- Root directory for all FTP'd ACQ order record files .
282                  If the script is configured to talk to a remote acq server,
283                  this directory has to be a read/write NFS share.  -->
284             <base_dir>/openils/var/data/acq_orders/</base_dir>
285
286             <!-- any files found in the shared subdir must be inspected
287                  (e.g. file name prefix) to determine the provider. -->
288             <shared_subdir>ALL</shared_subdir><!-- SUPPORT PENDING -->
289
290             <!-- providers that don't provide a mechanism to inspect the file
291                  have to push their files to provider-specific locations -->
292             <provider>
293                 <ordering_agency>BR1</ordering_agency> <!-- who gets/manages the order -->
294                 <provider_code>BAB</provider_code>   
295                 <provider_owner>CONS</provider_owner>  <!-- provider provider_owner; org unit shortname -->
296                 <subdir>CONS-BAB</subdir> <!-- file directory;  full path = base_dir + subdir -->
297                 <activate_po>false</activate_po> <!-- activate PO at upload? -->
298                 <vandelay>
299                     <import_no_match>true</import_no_match>
300                     <!-- Most Vandelay options are supported.  For bools, use true/false.
301                         match_quality_ratio 
302                         match_set 
303                         bib_source 
304                         merge_profile
305                         create_assets
306                         import_no_match 
307                         auto_overlay_exact 
308                         auto_overlay_1match 
309                         auto_overlay_best_match
310                     -->
311                 </vandelay>
312             </provider>
313
314             <!-- Add more as needed...
315             <provider>
316                 ...
317             </provider>
318             -->
319
320         </acq_order_reader>
321
322
323         <!-- no apps are enabled globally by default -->
324         <activeapps/> 
325
326         <cache>
327             <!-- memcache servers -->
328             <global>
329                 <servers>
330                     <server>127.0.0.1:11211</server>
331                 </servers>
332                 <max_cache_time>86400</max_cache_time>
333             </global>
334             <anon>
335                 <!-- anonymous cache.  currently, primarily used for web session caching -->
336                 <servers>
337                     <server>127.0.0.1:11211</server>
338                 </servers>
339                 <max_cache_time>1800</max_cache_time>
340                 <!-- maximum size of a single cache entry / default = 100k-->
341                 <max_cache_size>102400</max_cache_size>
342             </anon>
343         </cache>
344
345         <apps>
346             <!-- Acquisitions server -->
347             <open-ils.acq>
348                 <!-- how long to wait between stateful requests before the child process re-joins the pool -->
349                 <keepalive>5</keepalive>
350                 <!-- true if this service support stateless requests -->
351                 <stateless>1</stateless>
352                 <!-- implementation language -->
353                 <language>perl</language>
354                 <!-- name of the library that implements this application -->
355                 <implementation>OpenILS::Application::Acq</implementation>
356                 <!-- maximum OpenSRF REQUEST within a stateful connection -->
357                 <max_requests>100</max_requests>
358                 <unix_config>
359                     <!--
360                     maximum number of top level requests coming to 
361                     this child before the child is recycled
362                     -->
363                     <max_requests>100</max_requests>
364                     <!-- min children to fork -->
365                     <min_children>1</min_children>
366                     <!-- max possible children to fork -->
367                     <max_children>15</max_children>
368                     <!--
369                     C forking implementation does not support 
370                     min/max idle children, but may in the future
371                     -->
372
373                     <!-- min idle children -->
374                     <min_spare_children>1</min_spare_children>
375                     <!-- max idle children -->
376                     <max_spare_children>5</max_spare_children>
377                     <!-- currently, only Perl uses the following 3 settings -->
378                     <unix_sock>open-ils.acq_unix.sock</unix_sock>
379                     <unix_pid>open-ils.acq_unix.pid</unix_pid>
380                     <unix_log>open-ils.acq_unix.log</unix_log>
381                 </unix_config>
382             </open-ils.acq>
383
384             <!-- Authentication server -->
385             <open-ils.auth>
386                 <keepalive>5</keepalive>
387                 <stateless>1</stateless>
388                 <language>c</language>
389                 <implementation>oils_auth.so</implementation>
390                 <unix_config>
391                     <max_requests>1000</max_requests>
392                     <min_children>1</min_children>
393                     <max_children>15</max_children>
394                     <min_spare_children>1</min_spare_children>
395                     <max_spare_children>5</max_spare_children>
396                 </unix_config>
397                 <app_settings>
398                     <!-- defined app-specific settings here -->
399                     <default_timeout>
400                         <!-- default login timeouts based on login type -->
401                         <opac>420</opac>
402                         <staff>7200</staff>
403                         <temp>300</temp>
404                         <persist>2 weeks</persist>
405                     </default_timeout>
406                     <auth_limits>
407                         <seed>30</seed> <!-- amount of time a seed request is valid for -->
408                         <block_time>90</block_time> <!-- amount of time since last auth or seed request to save failure counts -->
409                         <block_count>10</block_count> <!-- number of failures before blocking access -->
410                     </auth_limits>
411                 </app_settings>
412             </open-ils.auth>
413
414             <!-- Authentication proxy server -->
415             <open-ils.auth_proxy>
416                 <keepalive>5</keepalive>
417                 <stateless>1</stateless>
418                 <language>perl</language>
419                 <implementation>OpenILS::Application::AuthProxy</implementation>
420                 <max_requests>93</max_requests>
421
422                 <unix_config>
423                     <max_requests>1000</max_requests>
424                     <unix_log>open-ils.auth-proxy_unix.log</unix_log>
425                     <unix_sock>open-ils.auth-proxy_unix.sock</unix_sock>
426                     <unix_pid>open-ils.auth-proxy_unix.pid</unix_pid>
427                     <min_children>1</min_children>
428                     <max_children>15</max_children>
429                     <min_spare_children>1</min_spare_children>
430                     <max_spare_children>5</max_spare_children>
431                 </unix_config>
432
433                 <app_settings>
434                     <!-- 'enabled' is the master switch; set to 'true' to enable proxied logins -->
435                     <enabled>false</enabled>
436                     <authenticators>
437                         <!-- the following is a sample configuration for the LDAP_Auth module; please adjust as needed -->
438                         <!--
439                         <authenticator>
440                             <name>ldap</name>
441                             <module>OpenILS::Application::AuthProxy::LDAP_Auth</module>
442                             <hostname>name.domain.com</hostname>
443                             <basedn>ou=people,dc=domain,dc=com</basedn>
444                             <authid>cn=username,ou=specials,dc=domain,dc=com</authid>
445                             <id_attr>uid</id_attr>
446                             <password>my_ldap_password_for_authid_user</password>
447                             <login_types>
448                                 <type>staff</type>
449                                 <type>opac</type>
450                                 <type>persist</type>
451                             </login_types>
452                             <org_units>
453                                 <unit>103</unit>
454                                 <unit>104</unit>
455                             </org_units>
456                         </authenticator>
457                         -->
458                         <!-- 'native' is a proxied version of Evergreen's standard authentication -->
459                         <authenticator>
460                             <name>native</name>
461                             <!-- you can add 'login_types' and 'org_units' limits to this authenticator as well, if needed -->
462                         </authenticator>
463                     </authenticators>
464                 </app_settings>
465             </open-ils.auth_proxy>
466
467             <!-- Generic search server -->
468             <open-ils.search>
469                 <keepalive>5</keepalive>
470                 <stateless>1</stateless>
471                 <language>perl</language>
472                 <implementation>OpenILS::Application::Search</implementation>
473                 <max_requests>93</max_requests>
474                 <unix_config>
475                     <unix_sock>open-ils.search_unix.sock</unix_sock>
476                     <unix_pid>open-ils.search_unix.pid</unix_pid>
477                     <unix_log>open-ils.search_unix.log</unix_log>
478
479                     <max_requests>1000</max_requests>
480                     <min_children>1</min_children>
481                     <max_children>15</max_children>
482                     <min_spare_children>1</min_spare_children>
483                     <max_spare_children>5</max_spare_children>
484                 </unix_config>
485                 <app_settings>
486                     <marc_html_xsl>oilsMARC21slim2HTML.xsl</marc_html_xsl>
487                     <marc_html_xsl_slim>oilsMARC21slim2HTMLslim.xsl</marc_html_xsl_slim>
488
489                     <spelling_dictionary>
490                         <!-- 
491                             Optionally configure different dictionaries depending on search context.  
492                             If no dictionaries are defined, the default Aspell dictionary is used.
493                         -->
494                         <!--
495                         <default>LOCALSTATEDIR/data/default_dict.txt</default>
496                         <title>LOCALSTATEDIR/data/title_dict.txt</title>
497                         <author>LOCALSTATEDIR/data/author_dict.txt</author>
498                         <subject>LOCALSTATEDIR/data/subject_dict.txt</subject>
499                         <series>LOCALSTATEDIR/data/series_dict.txt</series>
500                         -->
501                     </spelling_dictionary>
502
503                     <!-- Default to using staged search -->
504                     <use_staged_search>true</use_staged_search>
505
506                     <!--
507                         For staged search, we estimate hits based on inclusion or exclusion.
508
509                         Valid settings:
510                             inclusion - visible ratio on superpage
511                             exclusion - excluded ratio on superpage
512                             delete_adjusted_inclusion - included ratio on superpage, ratio adjusted by deleted count
513                             delete_adjusted_exclusion - excluded ratio on superpage, ratio adjusted by deleted count
514
515                         Under normal circumstances, inclusion is the best strategy, and both delete_adjusted variants
516                         will return the same value +/- 1.  The exclusion strategy is the original, and works well
517                         when there are few deleted or excluded records, in other words, when the superpage is not
518                         sparsely populated with visible records.
519                     -->
520                     <estimation_strategy>inclusion</estimation_strategy>
521
522                     <!--
523                         Evergreen uses a cover density algorithm for calculating relative ranking of matches.  There
524                         are several tuning parameters and options available.  By default, no document length normalization
525                         is applied.  From the Postgres documentation on ts_rank_cd() (the function used by Evergreen):
526
527                             Since a longer document has a greater chance of containing a query term it is reasonable 
528                             to take into account document size, e.g., a hundred-word document with five instances of 
529                             a search word is probably more relevant than a thousand-word document with five instances. 
530                             Both ranking functions take an integer normalization option that specifies whether and how 
531                             a document's length should impact its rank. The integer option controls several behaviors, 
532                             so it is a bit mask: you can specify one or more behaviors using | (for example, 2|4).
533
534                                 0 (the default) ignores the document length
535
536                                 1 divides the rank by 1 + the logarithm of the document length
537
538                                 2 divides the rank by the document length
539
540                                 4 divides the rank by the mean harmonic distance between extents (this is implemented only by ts_rank_cd)
541
542                                 8 divides the rank by the number of unique words in document
543
544                                 16 divides the rank by 1 + the logarithm of the number of unique words in document
545
546                                 32 divides the rank by itself + 1
547
548                             If more than one flag bit is specified, the transformations are applied in the order listed.
549
550                             It is important to note that the ranking functions do not use any global information, so it 
551                             is impossible to produce a fair normalization to 1% or 100% as sometimes desired. Normalization 
552                             option 32 (rank/(rank+1)) can be applied to scale all ranks into the range zero to one, but of 
553                             course this is just a cosmetic change; it will not affect the ordering of the search results.
554
555                         In Evergreen, these options are set via search modifiers.  The modifiers are mapped in the
556                         following way:
557
558                             * #CD_logDocumentLength  => 1  :: rank / (1 + LOG(total_word_count))   :: Longer documents slightly less relevant
559                             * #CD_documentLength     => 2  :: rank / total_word_count              :: Longer documents much less relevant
560                             * #CD_meanHarmonic       => 4  :: Word Proximity                       :: Greater matched-word distance is less relevant
561                             * #CD_uniqueWords        => 8  :: rank / unique_word_count             :: Documents with repeated words much less relevant
562                             * #CD_logUniqueWords     => 16 :: rank / (1 + LOG(unique_word_count))  :: Documents with repeated words slightly less relevant
563                             * #CD_selfPlusOne        => 32 :: rank / (1 + rank)                    :: Cosmetic normalization of rank value between 0 and 1
564
565                         Adding one or more of these to the default_CD_modifiers list will cause all searches that use QueryParser to apply them.
566                     -->
567                     <default_CD_modifiers>#CD_documentLength #CD_meanHarmonic #CD_uniqueWords</default_CD_modifiers>
568
569                     <!--
570                         default_preferred_language
571                             Set the global, default preferred languange
572                     -->
573                     <default_preferred_language>eng</default_preferred_language>
574
575                     <!--
576                         default_preferred_language_weight
577                             Set the weight (higher is "better") for the preferred language. Comment out to remove all lanuage weighting by default.
578                     -->
579                     <default_preferred_language_weight>5</default_preferred_language_weight>
580
581                     <!-- Baseline number of records to check for hit estimation. -->
582                     <superpage_size>1000</superpage_size>
583
584                     <!-- How many superpages to consider for searching overall. -->
585                     <max_superpages>10</max_superpages>
586
587                     <!-- zip code database file -->
588                     <!--<zips_file>LOCALSTATEDIR/data/zips.txt</zips_file>-->
589                 </app_settings>
590             </open-ils.search>
591
592             <!-- server for accessing user info -->
593             <open-ils.actor>
594                 <keepalive>5</keepalive>
595                 <stateless>1</stateless>
596                 <language>perl</language>
597                 <implementation>OpenILS::Application::Actor</implementation>
598                 <max_requests>93</max_requests>
599                 <unix_config>
600                     <unix_sock>open-ils.actor_unix.sock</unix_sock>
601                     <unix_pid>open-ils.actor_unix.pid</unix_pid>
602                     <max_requests>1000</max_requests>
603                     <unix_log>open-ils.actor_unix.log</unix_log>
604                     <min_children>1</min_children>
605                     <max_children>15</max_children>
606                     <min_spare_children>1</min_spare_children>
607                     <max_spare_children>5</max_spare_children>
608                 </unix_config>
609                 <!-- set this to 'true' to have barcode search also search patron records by unique ID -->
610                 <app_settings>
611                     <id_as_barcode>false</id_as_barcode>
612                 </app_settings>
613
614             </open-ils.actor>
615
616             <open-ils.booking>
617                 <keepalive>5</keepalive>
618                 <stateless>1</stateless>
619                 <language>perl</language>
620                 <implementation>OpenILS::Application::Booking</implementation>
621                 <max_requests>199</max_requests>
622                 <unix_config>
623                     <unix_sock>open-ils.booking_unix.sock</unix_sock>
624                     <unix_pid>open-ils.booking_unix.pid</unix_pid>
625                     <max_requests>1000</max_requests>
626                     <unix_log>open-ils.booking_unix.log</unix_log>
627                     <min_children>1</min_children>
628                     <max_children>15</max_children>
629                     <min_spare_children>1</min_spare_children>
630                     <max_spare_children>5</max_spare_children>
631                 </unix_config>
632                 <app_settings>
633                 </app_settings>
634             </open-ils.booking>
635
636             <open-ils.cat>
637                 <keepalive>5</keepalive>
638                 <stateless>1</stateless>
639                 <language>perl</language>
640                 <implementation>OpenILS::Application::Cat</implementation>
641                 <max_requests>199</max_requests>
642                 <unix_config>
643                     <unix_sock>open-ils.cat_unix.sock</unix_sock>
644                     <unix_pid>open-ils.cat_unix.pid</unix_pid>
645                     <max_requests>1000</max_requests>
646                     <unix_log>open-ils.cat_unix.log</unix_log>
647                     <min_children>1</min_children>
648                     <max_children>15</max_children>
649                     <min_spare_children>1</min_spare_children>
650                     <max_spare_children>5</max_spare_children>
651                 </unix_config>
652                 <app_settings>
653                     <marctemplates>
654                         <K_book>LOCALSTATEDIR/templates/marc/k_book.xml</K_book>
655                     </marctemplates>
656                 </app_settings>
657             </open-ils.cat>
658
659             <open-ils.supercat>
660                 <keepalive>5</keepalive>
661                 <stateless>1</stateless>
662                 <language>perl</language>
663                 <implementation>OpenILS::Application::SuperCat</implementation>
664                 <max_requests>199</max_requests>
665                 <unix_config>
666                     <unix_sock>open-ils.supercat_unix.sock</unix_sock>
667                     <unix_pid>open-ils.supercat_unix.pid</unix_pid>
668                     <max_requests>1000</max_requests>
669                     <unix_log>open-ils.supercat_unix.log</unix_log>
670                     <min_children>1</min_children>
671                     <max_children>15</max_children>
672                     <min_spare_children>1</min_spare_children>
673                     <max_spare_children>5</max_spare_children>
674                 </unix_config>
675             </open-ils.supercat>
676
677             <!-- server for accessing user info -->
678             <open-ils.trigger>
679                 <keepalive>5</keepalive>
680                 <stateless>1</stateless>
681                 <language>perl</language>
682                 <implementation>OpenILS::Application::Trigger</implementation>
683                 <max_requests>93</max_requests>
684                 <unix_config>
685                     <unix_sock>open-ils.trigger_unix.sock</unix_sock>
686                     <unix_pid>open-ils.trigger_unix.pid</unix_pid>
687                     <max_requests>1000</max_requests>
688                     <unix_log>open-ils.trigger_unix.log</unix_log>
689                     <min_children>1</min_children>
690                     <max_children>15</max_children>
691                     <min_spare_children>1</min_spare_children>
692                     <max_spare_children>5</max_spare_children>
693                 </unix_config>
694                 <app_settings>
695                     <!-- number of parallel open-ils.trigger processes to use for collection and reaction -->
696                     <!--
697                     <parallel>
698                         <collect>3</collect>
699                         <react>3</react>
700                     </parallel>
701                     -->
702                 </app_settings>
703             </open-ils.trigger>
704
705             <open-ils.url_verify>
706                 <keepalive>5</keepalive>
707                 <stateless>1</stateless>
708                 <language>perl</language>
709                 <implementation>OpenILS::Application::URLVerify</implementation>
710                 <max_requests>199</max_requests>
711                 <unix_config>
712                     <unix_sock>open-ils.url_verify_unix.sock</unix_sock>
713                     <unix_pid>open-ils.url_verify_unix.pid</unix_pid>
714                     <max_requests>1000</max_requests>
715                     <unix_log>open-ils.url_verify_unix.log</unix_log>
716                     <min_children>1</min_children>
717                     <max_children>15</max_children>
718                     <min_spare_children>1</min_spare_children>
719                     <max_spare_children>5</max_spare_children>
720                 </unix_config>
721                 <app_settings>
722                     <user_agent>Evergreen %s Link Checker</user_agent>
723                 </app_settings>
724             </open-ils.url_verify>
725
726             <opensrf.math>
727                 <keepalive>3</keepalive>
728                 <stateless>1</stateless>
729                 <language>c</language>
730                 <implementation>osrf_math.so</implementation>
731                 <unix_config>
732                     <unix_sock>opensrf.math_unix.sock</unix_sock>
733                     <unix_pid>opensrf.math_unix.pid</unix_pid>
734                     <max_requests>1000</max_requests>
735                     <unix_log>opensrf.math_unix.log</unix_log>
736                     <min_children>1</min_children>
737                     <max_children>15</max_children>
738                     <min_spare_children>1</min_spare_children>
739                     <max_spare_children>5</max_spare_children>
740                 </unix_config>
741             </opensrf.math>
742
743             <opensrf.dbmath> 
744                 <keepalive>3</keepalive>
745                 <stateless>1</stateless>
746                 <language>c</language>
747                 <implementation>osrf_dbmath.so</implementation>
748                 <unix_config>
749                     <max_requests>1000</max_requests>
750                     <unix_log>opensrf.dbmath_unix.log</unix_log>
751                     <unix_sock>opensrf.dbmath_unix.sock</unix_sock>
752                     <unix_pid>opensrf.dbmath_unix.pid</unix_pid>
753                     <min_children>1</min_children>
754                     <max_children>15</max_children>
755                     <min_spare_children>1</min_spare_children> 
756                     <max_spare_children>5</max_spare_children>
757                 </unix_config>
758             </opensrf.dbmath>
759
760             <open-ils.penalty>
761                 <keepalive>3</keepalive>
762                 <stateless>1</stateless>
763                 <language>perl</language>
764                 <implementation>OpenILS::Application::Penalty</implementation>
765                 <max_requests>99</max_requests>
766                 <unix_config>
767                     <max_requests>1000</max_requests>
768                     <unix_log>open-ils.penalty_unix.log</unix_log>
769                     <unix_sock>open-ils.penalty_unix.sock</unix_sock>
770                     <unix_pid>open-ils.penalty_unix.pid</unix_pid>
771                     <min_children>1</min_children>
772                     <max_children>15</max_children>
773                     <min_spare_children>1</min_spare_children>
774                     <max_spare_children>5</max_spare_children>
775                 </unix_config>
776                 <app_settings>
777                     <patron_penalty>penalty/patron_penalty.js</patron_penalty>
778                     <script_path>LIBDIR/javascript</script_path>
779                     <script_path>LOCALSTATEDIR</script_path>
780                     <script_path>LOCALSTATEDIR/catalog</script_path>
781                 </app_settings>
782             </open-ils.penalty>
783
784             <open-ils.justintime>
785                 <keepalive>5</keepalive>
786                 <stateless>1</stateless>
787                 <language>perl</language>
788                 <implementation>OpenILS::Application::JustInTime</implementation>
789                 <max_requests>199</max_requests>
790                 <unix_config>
791                     <unix_sock>open-ils.justintime_unix.sock</unix_sock>
792                     <unix_pid>open-ils.justintime_unix.pid</unix_pid>
793                     <max_requests>1000</max_requests>
794                     <unix_log>open-ils.justintime_unix.log</unix_log>
795                     <min_children>1</min_children>
796                     <max_children>15</max_children>
797                     <min_spare_children>1</min_spare_children>
798                     <max_spare_children>5</max_spare_children>
799                 </unix_config>
800                 <app_settings>
801                 </app_settings>
802             </open-ils.justintime>
803
804             <open-ils.circ> 
805                 <keepalive>3</keepalive>
806                 <stateless>1</stateless>
807                 <language>perl</language>
808                 <implementation>OpenILS::Application::Circ</implementation>
809                 <max_requests>99</max_requests>
810                 <unix_config>
811                     <max_requests>1000</max_requests>
812                     <unix_log>open-ils.circ_unix.log</unix_log>
813                     <unix_sock>open-ils.circ_unix.sock</unix_sock>
814                     <unix_pid>open-ils.circ_unix.pid</unix_pid>
815                     <min_children>1</min_children>
816                     <max_children>15</max_children>
817                     <min_spare_children>1</min_spare_children> 
818                     <max_spare_children>5</max_spare_children>
819                 </unix_config>
820                 <app_settings>
821                     <notify_hold>
822                         <email>false</email> <!-- set to false to disable hold notice emails -->
823                     </notify_hold>
824
825                     <!-- circulation policy scripts -->
826                     <script_path>LIBDIR/javascript</script_path>
827                     <script_path>LOCALSTATEDIR</script_path>
828                     <script_path>LOCALSTATEDIR/catalog</script_path>
829                     <legacy_script_support>false</legacy_script_support>
830                     <scripts> 
831                         <circ_permit_patron>circ/circ_permit_patron.js</circ_permit_patron>
832                         <circ_permit_copy>circ/circ_permit_copy.js</circ_permit_copy>
833                         <circ_duration>circ/circ_duration.js</circ_duration>
834                         <circ_recurring_fines>circ/circ_recurring_fines.js</circ_recurring_fines>
835                         <circ_max_fines>circ/circ_max_fines.js</circ_max_fines>
836                         <circ_permit_renew>circ/circ_permit_renew.js</circ_permit_renew>
837                         <circ_permit_hold>circ/circ_permit_hold.js</circ_permit_hold>
838                     </scripts>               
839
840                 </app_settings>
841             </open-ils.circ>
842
843             <open-ils.storage>
844                 <keepalive>10</keepalive>
845                 <stateless>1</stateless>
846                 <language>perl</language>
847                 <implementation>OpenILS::Application::Storage</implementation>
848                 <unix_config>
849                     <max_requests>1000</max_requests>
850                     <unix_log>open-ils.storage_unix.log</unix_log>
851                     <unix_sock>open-ils.storage_unix.sock</unix_sock>
852                     <unix_pid>open-ils.storage_unix.pid</unix_pid>
853                     <min_children>1</min_children>
854                     <max_children>10</max_children>
855                     <min_spare_children>1</min_spare_children>
856                     <max_spare_children>5</max_spare_children>
857                 </unix_config>
858                 <app_settings>
859                     <script_path>LIBDIR/javascript/</script_path>
860                     <script_path>LOCALSTATEDIR/catalog/</script_path>
861                     <scripts>
862                         <biblio_fingerprint>biblio_fingerprint.js</biblio_fingerprint>
863                     </scripts>
864                     <databases>
865                         <driver>Pg</driver>
866                         <database>
867                             <type>master</type>
868                             <weight>2</weight>
869                             <user>postgres</user>
870                             <host>localhost</host>
871                             <port>5432</port>
872                             <pw>postgres</pw>
873                             <db>evergreen</db>
874                             <client_encoding>UTF-8</client_encoding>
875                         </database>
876                     </databases>
877                 </app_settings>
878             </open-ils.storage>
879
880             <open-ils.cstore>
881                 <keepalive>6</keepalive>
882                 <stateless>1</stateless>
883                 <language>C</language>
884                 <implementation>oils_cstore.so</implementation>
885                 <unix_config>
886                     <max_requests>1000</max_requests>
887                     <min_children>1</min_children>
888                     <max_children>15</max_children>
889                     <min_spare_children>1</min_spare_children>
890                     <max_spare_children>5</max_spare_children>
891                 </unix_config>
892                 <app_settings>
893                     <max_query_recursion>100</max_query_recursion>
894                     <driver>pgsql</driver>
895                     <database>
896                         <type>master</type>
897                         <weight>2</weight>
898                         <user>postgres</user>
899                         <host>localhost</host>
900                         <port>5432</port>
901                         <pw>postgres</pw>
902                         <db>evergreen</db>
903                         <client_encoding>UTF-8</client_encoding>
904                     </database>
905                 </app_settings>
906             </open-ils.cstore>
907
908             <open-ils.pcrud>
909                 <keepalive>6</keepalive>
910                 <migratable>1</migratable>
911                 <stateless>1</stateless>
912                 <language>C</language>
913                 <implementation>oils_pcrud.so</implementation>
914
915                 <unix_config>
916                     <unix_log>open-ils.pcrud.log</unix_log>
917                     <unix_sock>open-ils.pcrud.sock</unix_sock>
918                     <unix_pid>open-ils.pcrud.pid</unix_pid>
919                     <max_requests>1000</max_requests>
920                     <min_children>1</min_children>
921                     <max_children>15</max_children>
922                     <min_spare_children>1</min_spare_children>
923                     <max_spare_children>5</max_spare_children>
924                 </unix_config>
925
926                 <app_settings>
927                     <IDL>SYSCONFDIR/fm_IDL.xml</IDL>
928                     <driver>pgsql</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                     </database>
939                 </app_settings>
940             </open-ils.pcrud>
941
942             <open-ils.qstore>
943                 <keepalive>6</keepalive>
944                 <stateless>1</stateless>
945                 <language>C</language>
946                 <implementation>oils_qstore.so</implementation>
947                 <unix_config>
948                     <max_requests>1000</max_requests>
949                     <min_children>1</min_children>
950                     <max_children>15</max_children>
951                     <min_spare_children>1</min_spare_children>
952                     <max_spare_children>5</max_spare_children>
953                 </unix_config>
954                 <app_settings>
955                     <driver>pgsql</driver>
956                     <database>
957                         <type>master</type>
958                         <weight>2</weight>
959                         <user>postgres</user>
960                         <host>localhost</host>
961                         <port>5432</port>
962                         <pw>postgres</pw>
963                         <db>evergreen</db>
964                         <client_encoding>UTF-8</client_encoding>
965                     </database>
966                 </app_settings>
967             </open-ils.qstore>
968
969             <opensrf.settings>
970                 <keepalive>1</keepalive>
971                 <stateless>1</stateless>
972                 <language>perl</language>
973                 <implementation>OpenSRF::Application::Settings</implementation>
974                 <max_requests>17</max_requests>
975                 <unix_config>
976                     <unix_sock>opensrf.settings_unix.sock</unix_sock>
977                     <unix_pid>opensrf.settings_unix.pid</unix_pid>
978                     <max_requests>300</max_requests>
979                     <unix_log>opensrf.settings_unix.log</unix_log>
980                     <min_children>5</min_children>
981                     <max_children>15</max_children>
982                     <min_spare_children>3</min_spare_children>
983                     <max_spare_children>5</max_spare_children>
984                 </unix_config>
985             </opensrf.settings>
986
987             <open-ils.collections>
988                 <keepalive>3</keepalive>
989                 <stateless>1</stateless>
990                 <language>perl</language>
991                 <implementation>OpenILS::Application::Collections</implementation>
992                 <max_requests>17</max_requests>
993                 <unix_config>
994                     <unix_sock>open-ils.collections_unix.sock</unix_sock>
995                     <unix_pid>open-ils.collections_unix.pid</unix_pid>
996                     <max_requests>1000</max_requests>
997                     <unix_log>open-ils.collections_unix.log</unix_log>
998                     <min_children>1</min_children>
999                     <max_children>10</max_children>
1000                     <min_spare_children>1</min_spare_children>
1001                     <max_spare_children>5</max_spare_children>
1002                 </unix_config>
1003                 <app_settings>
1004                     <!-- batch_file_dir must be a protected, web-accessible, shared directory -->
1005                     <batch_file_dir>/openils/var/web/collections</batch_file_dir>
1006                 </app_settings>
1007             </open-ils.collections>
1008
1009             <open-ils.reporter>
1010                 <keepalive>3</keepalive>
1011                 <stateless>1</stateless>
1012                 <language>perl</language>
1013                 <implementation>OpenILS::Application::Reporter</implementation>
1014                 <max_requests>99</max_requests>
1015                 <unix_config>
1016                     <unix_sock>open-ils.reporter_unix.sock</unix_sock>
1017                     <unix_pid>open-ils.reporter_unix.pid</unix_pid>
1018                     <max_requests>1000</max_requests>
1019                     <unix_log>open-ils.reporter_unix.log</unix_log>
1020                     <min_children>1</min_children>
1021                     <max_children>10</max_children>
1022                     <min_spare_children>1</min_spare_children>
1023                     <max_spare_children>5</max_spare_children>
1024                 </unix_config>
1025             </open-ils.reporter>
1026
1027             <open-ils.reporter-store>
1028                 <keepalive>6</keepalive>
1029                 <stateless>1</stateless>
1030                 <language>C</language>
1031                 <implementation>oils_rstore.so</implementation>
1032                 <unix_config>
1033                     <max_requests>400</max_requests>
1034                     <min_children>1</min_children>
1035                     <max_children>10</max_children>
1036                     <min_spare_children>1</min_spare_children>
1037                     <max_spare_children>5</max_spare_children>
1038                 </unix_config>
1039                 <app_settings>
1040                     <driver>pgsql</driver>
1041                     <database>
1042                         <type>master</type>
1043                         <weight>2</weight>
1044                         <user>postgres</user>
1045                         <host>localhost</host>
1046                         <port>5432</port>
1047                         <pw>postgres</pw>
1048                         <db>evergreen</db>
1049                         <client_encoding>UTF-8</client_encoding>
1050                     </database>
1051                 </app_settings>
1052             </open-ils.reporter-store>
1053
1054 <!-- resolver_type defaults to sfx but can also be cufts -->
1055 <!--
1056            <open-ils.resolver>
1057                <keepalive>3</keepalive>
1058                <stateless>1</stateless>
1059                <language>perl</language>
1060                <implementation>OpenILS::Application::ResolverResolver</implementation>
1061                <max_requests>93</max_requests>
1062                <unix_config>
1063                   <unix_sock>open-ils.resolver_unix.sock</unix_sock>
1064                   <unix_pid>open-ils.resolver_unix.pid</unix_pid>
1065                   <max_requests>1000</max_requests>
1066                   <unix_log>open-ils.resolver_unix.log</unix_log>
1067                   <min_children>5</min_children>
1068                   <max_children>15</max_children>
1069                   <min_spare_children>3</min_spare_children>
1070                   <max_spare_children>5</max_spare_children>
1071                </unix_config>
1072                <app_settings>
1073                   <cache_timeout>86400</cache_timeout>
1074                   <request_timeout>10</request_timeout>
1075                   <default_url_base>http://path/to/sfx_or_cufts</default_url_base>
1076                   <resolver_type>sfx</resolver_type>
1077                </app_settings>
1078             </open-ils.resolver>
1079 -->
1080
1081             <open-ils.permacrud>
1082                <keepalive>3</keepalive>
1083                <stateless>1</stateless>
1084                <language>perl</language>
1085                <implementation>OpenILS::Application::PermaCrud</implementation>
1086                <max_requests>17</max_requests>
1087                <unix_config>
1088                   <unix_sock>open-ils.permacrud_unix.sock</unix_sock>
1089                   <unix_pid>open-ils.permacrud_unix.pid</unix_pid>
1090                   <max_requests>1000</max_requests>
1091                   <unix_log>open-ils.permacrud_unix.log</unix_log>
1092                   <min_children>5</min_children>
1093                   <max_children>15</max_children>
1094                   <min_spare_children>3</min_spare_children>
1095                   <max_spare_children>5</max_spare_children>
1096                </unix_config>
1097             </open-ils.permacrud>
1098
1099             <open-ils.fielder>
1100                <keepalive>3</keepalive>
1101                <stateless>1</stateless>
1102                <language>perl</language>
1103                <implementation>OpenILS::Application::Fielder</implementation>
1104                <max_requests>17</max_requests>
1105                <unix_config>
1106                   <unix_sock>open-ils.fielder_unix.sock</unix_sock>
1107                   <unix_pid>open-ils.fielder_unix.pid</unix_pid>
1108                   <max_requests>1000</max_requests>
1109                   <unix_log>open-ils.fielder_unix.log</unix_log>
1110                   <min_children>5</min_children>
1111                   <max_children>15</max_children>
1112                   <min_spare_children>3</min_spare_children>
1113                   <max_spare_children>5</max_spare_children>
1114                </unix_config>
1115             </open-ils.fielder>
1116
1117             <open-ils.vandelay>
1118                 <keepalive>5</keepalive>
1119                 <stateless>1</stateless>
1120                 <language>perl</language>
1121                 <implementation>OpenILS::Application::Vandelay</implementation>
1122                 <max_requests>100</max_requests>
1123                 <unix_config>
1124                     <unix_sock>vandelay_unix.sock</unix_sock>
1125                     <unix_pid>vandelay_unix.pid</unix_pid>
1126                     <unix_log>vandelay_unix.log</unix_log>
1127                     <max_requests>100</max_requests>
1128                     <min_children>1</min_children>
1129                     <max_children>15</max_children>
1130                     <min_spare_children>1</min_spare_children>
1131                     <max_spare_children>5</max_spare_children>
1132                 </unix_config>
1133                 <app_settings>
1134                     <databases>
1135                         <!-- temporary location for MARC import files.  
1136                             Files will be deleted after records are spooled.
1137                             *note:  in a multi-brick environment, this will need to
1138                             be on a write-able NFS share.  -->
1139                         <importer>/tmp</importer>
1140                     </databases>
1141                 </app_settings>
1142             </open-ils.vandelay>
1143
1144             <open-ils.serial>
1145                 <keepalive>3</keepalive>
1146                 <stateless>1</stateless>
1147                 <language>perl</language>
1148                 <implementation>OpenILS::Application::Serial</implementation>
1149                 <max_requests>17</max_requests>
1150                 <unix_config>
1151                     <unix_sock>open-ils.serial_unix.sock</unix_sock>
1152                     <unix_pid>open-ils.serial_unix.pid</unix_pid>
1153                     <max_requests>1000</max_requests>
1154                     <unix_log>open-ils.serial_unix.log</unix_log>
1155                     <min_children>5</min_children>
1156                     <max_children>15</max_children>
1157                     <min_spare_children>3</min_spare_children>
1158                     <max_spare_children>5</max_spare_children>
1159                 </unix_config>
1160                 <app_settings>
1161                 </app_settings>
1162             </open-ils.serial>
1163
1164         </apps>
1165     </default>
1166
1167     <hosts>
1168
1169         <localhost> 
1170             <!-- ^-=- 
1171             Should match the fully qualified domain name of the host.
1172
1173             On Linux, the output of the following command is authoritative:
1174             $ perl -MNet::Domain -e 'print Net::Domain::hostfqdn() . "\n";'
1175
1176             To use 'localhost' instead, run osrf_control with the 'localhost' flag
1177             -->
1178
1179             <activeapps>
1180                 <!-- services hosted on this machine -->
1181                 <appname>opensrf.settings</appname> 
1182                 <appname>opensrf.math</appname> 
1183                 <appname>opensrf.dbmath</appname> 
1184                 <appname>open-ils.acq</appname> 
1185                 <appname>open-ils.booking</appname>
1186                 <appname>open-ils.cat</appname> 
1187                 <appname>open-ils.supercat</appname> 
1188                 <appname>open-ils.search</appname> 
1189                 <appname>open-ils.circ</appname> 
1190                 <appname>open-ils.actor</appname> 
1191                 <appname>open-ils.auth</appname> 
1192                 <appname>open-ils.auth_proxy</appname> 
1193                 <appname>open-ils.storage</appname>  
1194                 <appname>open-ils.penalty</appname>  
1195                 <appname>open-ils.justintime</appname>  
1196                 <appname>open-ils.cstore</appname>  
1197                 <appname>open-ils.collections</appname>  
1198                 <appname>open-ils.reporter</appname>  
1199                 <appname>open-ils.reporter-store</appname>  
1200                 <!-- <appname>open-ils.resolver</appname> -->
1201                 <appname>open-ils.permacrud</appname>  
1202                 <appname>open-ils.pcrud</appname>  
1203                 <appname>open-ils.trigger</appname>  
1204                 <appname>open-ils.url_verify</appname>
1205                 <appname>open-ils.fielder</appname>  
1206                 <appname>open-ils.vandelay</appname>  
1207                 <appname>open-ils.serial</appname>  
1208             </activeapps>
1209         </localhost>
1210     </hosts>
1211
1212 </opensrf>