4 Example opensrf config file for OpenILS
8 <opensrf version='0.0.3'>
13 <log>/openils/var/log</log> <!-- unix::server log files -->
14 <sock>/openils/var/sock</sock> <!-- unix::server sock files -->
15 <pid>/openils/var/pid</pid>
16 <xsl>/openils/var/xsl</xsl>
17 <script>/openils/var</script>
18 <script_lib>/openils/var</script_lib>
21 <!-- global data visibility settings -->
24 <!-- Set to "true" to require patron opt-in for foreign (non-home_ou) transactions -->
25 <opt_in>false</opt_in>
29 <IDL>/openils/conf/fm_IDL.xml</IDL> <!-- top level IDL file -->
31 <server_type>prefork</server_type> <!-- net::server type -->
33 <ils_events>/openils/var/data/ils_events.xml</ils_events> <!-- ILS events description file -->
35 <email_notify> <!-- this will eventually move into the notifications section below... -->
36 <!-- global email notification settings -->
37 <template>/openils/var/data/hold_notification_template.example</template>
38 <smtp_server>localhost</smtp_server>
41 in most cases, this is overridden by location
42 specific config settings. this is just the default
44 <sender_address>evergreen@localhost</sender_address>
49 <!-- global mail server settings -->
50 <smtp_server>localhost</smtp_server>
51 <sender_address>evergreen@localhost</sender_address>
53 <!-- Overdue notices -->
56 <!-- optionally, you can define a sender address per notice type -->
57 <sender_address>overdue@localhost</sender_address>
59 <!-- The system can generate an XML file of overdue notices. This is the
60 directory where they are stored. Files are named overdue.YYYY-MM-DD.xml -->
61 <notice_dir>/openils/var/data/overdue</notice_dir>
64 <!-- Notify at 7 days overdue -->
65 <notify_interval>7 days</notify_interval>
66 <!-- Options include always, noemail, and never. 'noemail' means a notice
67 will be appended to the notice file only if the patron has no valid email address. -->
68 <file_append>noemail</file_append>
69 <!-- do we attempt email notification? -->
70 <email_notify>true</email_notify>
71 <!-- notice template file -->
72 <template>/openils/var/data/templates/overdue_7day.example</template>
76 <!-- Courtesy notices -->
79 <!-- All circulations that circulate between 5 and 13 days -->
83 </circ_duration_range>
84 <!-- notify at 1 day before the due date -->
85 <notify_interval>1 day</notify_interval>
86 <file_append>false</file_append>
87 <email_notify>true</email_notify>
88 <template>/openils/var/data/templates/predue_1day.example</template>
95 Settings for the reporter daemon process
98 <base_uri>https://localhost/reporter/</base_uri>
101 <host>localhost</host>
104 <user>postgres</user>
108 <!-- successful report outputs go here -->
109 <output_base>/openils/var/web/reporter</output_base>
110 <success_template>/openils/var/data/report-success</success_template>
111 <fail_template>/openils/var/data/report-fail</fail_template>
119 <!-- XML-RPC gateway. Do NOT publish unprotected services here -->
121 <!-- list of published services -->
122 <service>opensrf.math</service>
123 <service>opensrf.dbmath</service>
124 <service>open-ils.cat</service>
125 <service>open-ils.search</service>
126 <service>open-ils.circ</service>
127 <service>open-ils.actor</service>
128 <service>open-ils.auth</service>
129 <service>open-ils.collections</service>
135 <default>oclc</default>
139 <!-- LoC does not require username/password -->
141 <host>z3950.loc.gov</host>
144 <!-- fetch the full record with no holdings. FI is the default -->
145 <record_format>FI</record_format>
147 <!-- Record transmission format from the server. Supported -->
148 <!-- formats include usmarc and xml (for marcxml). -->
149 <transmission_format>usmarc</transmission_format>
152 <tcn><code>12</code><format>1</format></tcn>
153 <isbn><code>7</code><format>6</format></isbn>
154 <lccn><code>9</code><format>1</format></lccn>
155 <author><code>1003</code><format>6</format></author>
156 <title><code>4</code><format>6</format></title>
157 <issn><code>8</code><format>1</format></issn>
158 <publisher><code>1018</code><format>6</format></publisher>
159 <pubdate><code>31</code><format>1</format></pubdate>
160 <item_type><code>1001</code><format>1</format></item_type>
165 <!-- Z3950 settings for OCLC. Note that OCLC requires username/password -->
166 <host>zcat.oclc.org</host>
168 <db>OLUCWorldCat</db>
171 These are directly from the Bib-1 Attribute Set
172 http://www.loc.gov/z3950/agency/defns/bib1.html
173 <code> is the "use attribute", <format> is the "structure attribute"
174 This just puts some friendly names on the data.
176 <tcn><code>12</code><format>1</format></tcn>
177 <isbn><code>7</code><format>6</format></isbn>
178 <lccn><code>9</code><format>1</format></lccn>
179 <author><code>1003</code><format>6</format></author>
180 <title><code>4</code><format>6</format></title>
181 <issn><code>8</code><format>1</format></issn>
182 <publisher><code>1018</code><format>6</format></publisher>
183 <pubdate><code>31</code><format>1</format></pubdate>
184 <item_type><code>1001</code><format>1</format></item_type>
194 <!-- XXX If you use the Amazon plugin, you must link back to Amazon in the OPAC -->
196 <!-- load the Amazon added content module -->
197 <module>OpenILS::WWW::AddedContent::Amazon</module>
199 Base URL for Amazon added content fetching. This URL may
200 need to be shortened when new (read: non-image) content
201 fetching capabilities are added
203 <base_url>http://images.amazon.com/images/P/</base_url>
206 Max number of seconds to wait for an added content request to
207 return data. Data not returned within the timeout is considered
213 After added content lookups have been disabled due to too many
214 lookup failures, this is the amount of time to wait before
217 <retry_timeout>600</retry_timeout>
220 maximum number of consecutive lookup errors a given process can
221 have before added content lookups are disabled for everyone
223 <max_errors>4</max_errors>
225 <!-- If a userid is required to access the added content.. -->
226 <userid>MY_USER_ID</userid>
229 You can add free-form settings here and they will be accessible
230 within the added content module
237 <!-- no apps are enabled globally by default -->
241 <!-- memcache servers -->
244 <server>localhost:11211</server>
246 <max_cache_time>86400</max_cache_time>
251 <!-- Authentication server -->
254 <!-- how long to wait between stateful requests before the child process re-joins the pool -->
255 <keepalive>5</keepalive>
257 <!-- true if this service support stateless requests -->
258 <stateless>1</stateless>
260 <!-- implementation language -->
261 <language>c</language>
263 <!-- library to plugin -->
264 <implementation>oils_auth.so</implementation>
266 <!-- maximum required opensrf requests within a stateful connection -->
267 <max_requests>93</max_requests>
271 maximum number of top level requests coming to
272 this child before the child is recycled
274 <max_requests>1000</max_requests>
275 <!-- min children to fork -->
276 <min_children>1</min_children>
277 <!-- max possible children to fork -->
278 <max_children>15</max_children>
281 C forking implementation does not support
282 min/max idle children, but may in the future
285 <!-- min idle children -->
286 <min_spare_children>1</min_spare_children>
287 <!-- max idle children -->
288 <max_spare_children>5</max_spare_children>
293 <!-- defined app-specific settings here -->
295 <!-- default login timeouts based on login type -->
304 <!-- Generic search server -->
306 <keepalive>5</keepalive>
307 <stateless>1</stateless>
308 <language>perl</language>
309 <implementation>OpenILS::Application::Search</implementation>
310 <max_requests>93</max_requests>
313 <!-- the following 3 settings are currently used by Perl services only -->
314 <unix_sock>open-ils.search_unix.sock</unix_sock>
315 <unix_pid>open-ils.search_unix.pid</unix_pid>
316 <unix_log>open-ils.search_unix.log</unix_log>
318 <max_requests>1000</max_requests>
319 <min_children>1</min_children>
320 <max_children>15</max_children>
321 <min_spare_children>1</min_spare_children>
322 <max_spare_children>5</max_spare_children>
325 <marc_html_xsl>oilsMARC21slim2HTML.xsl</marc_html_xsl>
326 <!-- Default to using staged search -->
327 <use_staged_search>true</use_staged_search>
328 <superpage_size>500</superpage_size>
329 <max_superpages>20</max_superpages>
330 <!-- zip code database file -->
331 <!--<zips_file>/openils/var/data/zips.txt</zips_file>-->
335 <!-- server for accessing user info -->
337 <keepalive>5</keepalive>
338 <stateless>1</stateless>
339 <language>perl</language>
340 <implementation>OpenILS::Application::Actor</implementation>
341 <max_requests>93</max_requests>
343 <unix_sock>open-ils.actor_unix.sock</unix_sock>
344 <unix_pid>open-ils.actor_unix.pid</unix_pid>
345 <max_requests>1000</max_requests>
346 <unix_log>open-ils.actor_unix.log</unix_log>
347 <min_children>1</min_children>
348 <max_children>15</max_children>
349 <min_spare_children>1</min_spare_children>
350 <max_spare_children>5</max_spare_children>
356 <keepalive>5</keepalive>
357 <stateless>1</stateless>
358 <language>perl</language>
359 <implementation>OpenILS::Application::Cat</implementation>
360 <max_requests>199</max_requests>
362 <unix_sock>open-ils.cat_unix.sock</unix_sock>
363 <unix_pid>open-ils.cat_unix.pid</unix_pid>
364 <max_requests>1000</max_requests>
365 <unix_log>open-ils.cat_unix.log</unix_log>
366 <min_children>1</min_children>
367 <max_children>15</max_children>
368 <min_spare_children>1</min_spare_children>
369 <max_spare_children>5</max_spare_children>
373 <K_book>/openils/var/templates/marc/k_book.xml</K_book>
379 <keepalive>5</keepalive>
380 <stateless>1</stateless>
381 <language>perl</language>
382 <implementation>OpenILS::Application::SuperCat</implementation>
383 <max_requests>199</max_requests>
385 <unix_sock>open-ils.supercat_unix.sock</unix_sock>
386 <unix_pid>open-ils.supercat_unix.pid</unix_pid>
387 <max_requests>1000</max_requests>
388 <unix_log>open-ils.supercat_unix.log</unix_log>
389 <min_children>1</min_children>
390 <max_children>15</max_children>
391 <min_spare_children>1</min_spare_children>
392 <max_spare_children>5</max_spare_children>
398 <keepalive>3</keepalive>
399 <stateless>1</stateless>
400 <language>c</language>
401 <implementation>osrf_math.so</implementation>
402 <max_requests>97</max_requests>
404 <unix_sock>opensrf.math_unix.sock</unix_sock>
405 <unix_pid>opensrf.math_unix.pid</unix_pid>
406 <max_requests>1000</max_requests>
407 <unix_log>opensrf.math_unix.log</unix_log>
408 <min_children>1</min_children>
409 <max_children>15</max_children>
410 <min_spare_children>1</min_spare_children>
411 <max_spare_children>5</max_spare_children>
416 <keepalive>3</keepalive>
417 <stateless>1</stateless>
418 <language>c</language>
419 <implementation>osrf_dbmath.so</implementation>
420 <max_requests>99</max_requests>
422 <max_requests>1000</max_requests>
423 <unix_log>opensrf.dbmath_unix.log</unix_log>
424 <unix_sock>opensrf.dbmath_unix.sock</unix_sock>
425 <unix_pid>opensrf.dbmath_unix.pid</unix_pid>
426 <min_children>1</min_children>
427 <max_children>15</max_children>
428 <min_spare_children>1</min_spare_children>
429 <max_spare_children>5</max_spare_children>
434 <keepalive>3</keepalive>
435 <stateless>1</stateless>
436 <language>perl</language>
437 <implementation>OpenILS::Application::Penalty</implementation>
438 <max_requests>99</max_requests>
440 <max_requests>1000</max_requests>
441 <unix_log>open-ils.penalty_unix.log</unix_log>
442 <unix_sock>open-ils.penalty_unix.sock</unix_sock>
443 <unix_pid>open-ils.penalty_unix.pid</unix_pid>
444 <min_children>1</min_children>
445 <max_children>15</max_children>
446 <min_spare_children>1</min_spare_children>
447 <max_spare_children>5</max_spare_children>
450 <patron_penalty>penalty/patron_penalty.js</patron_penalty>
451 <script_path>/openils/lib/javascript</script_path>
452 <script_path>/openils/var</script_path>
453 <script_path>/openils/var/catalog</script_path>
458 <keepalive>3</keepalive>
459 <stateless>1</stateless>
460 <language>perl</language>
461 <implementation>OpenILS::Application::Circ</implementation>
462 <max_requests>99</max_requests>
464 <max_requests>1000</max_requests>
465 <unix_log>open-ils.circ_unix.log</unix_log>
466 <unix_sock>open-ils.circ_unix.sock</unix_sock>
467 <unix_pid>open-ils.circ_unix.pid</unix_pid>
468 <min_children>1</min_children>
469 <max_children>15</max_children>
470 <min_spare_children>1</min_spare_children>
471 <max_spare_children>5</max_spare_children>
475 <email>false</email> <!-- set to true for hold notice emails -->
478 <!-- circulation policy scripts -->
479 <script_path>/openils/lib/javascript</script_path>
480 <script_path>/openils/var</script_path>
481 <script_path>/openils/var/catalog</script_path>
482 <legacy_script_support>false</legacy_script_support>
484 <circ_permit_patron>circ/circ_permit_patron.js</circ_permit_patron>
485 <circ_permit_copy>circ/circ_permit_copy.js</circ_permit_copy>
486 <circ_duration>circ/circ_duration.js</circ_duration>
487 <circ_recurring_fines>circ/circ_recurring_fines.js</circ_recurring_fines>
488 <circ_max_fines>circ/circ_max_fines.js</circ_max_fines>
489 <circ_permit_renew>circ/circ_permit_renew.js</circ_permit_renew>
490 <circ_permit_hold>circ/circ_permit_hold.js</circ_permit_hold>
499 <mod>bestseller</mod>
500 <mod>bestsellernh</mod>
515 <mod>softwrlong</mod>
516 <mod>equip-long</mod>
517 <mod>talking book</mod>
520 <mod>video-long</mod>
524 <type>Miscellaneous</type>
525 <type>Overdue materials</type>
526 <type>Fee for placing a hold</type>
527 <type>Fee for checking out a book</type>
528 <type>Fee for library card</type>
529 <type>Miscellaneous charges</type>
530 <type>Lost materials</type>
531 <type>Damaged material</type>
532 <type>Overdue Reserves charge</type>
533 <type>Recall overdue</type>
534 <type>Fee for processing lost library materials</type>
535 <type>Fee for sending patron bills to collection agency</type>
536 <type>Fee for interlibrary loan</type>
537 <type>Fee for copies</type>
538 <type>Money advanced to pay for telephone use</type>
539 <type>Deposit fee</type>
540 <type>Fee for disk</type>
541 <type>Fee for faxing</type>
542 <type>Fee for laminating</type>
543 <type>Fee for room cleaning</type>
544 <type>Deposit returned; fee refund</type>
545 <type>Sale items</type>
546 <type>Fee for lost card</type>
547 <type>Long overdue items</type>
548 <type>Lost/Replacement Cassette</type>
549 <type>Returned Check</type>
555 <keepalive>3</keepalive>
556 <stateless>1</stateless>
557 <implementation>OpenILS::Application::Ingest</implementation>
558 <language>perl</language>
559 <max_requests>1000000</max_requests>
561 <max_requests>1000000</max_requests>
562 <unix_log>open-ils.ingest-unix.log</unix_log>
563 <unix_sock>open-ils.ingest-unix.sock</unix_sock>
564 <unix_pid>open-ils.ingest-unix.pid</unix_pid>
565 <min_children>5</min_children>
566 <max_children>20</max_children>
567 <min_spare_children>2</min_spare_children>
568 <max_spare_children>5</max_spare_children>
571 <script_path>/openils/lib/javascript/</script_path>
572 <script_path>/openils/var/catalog/</script_path>
573 <script_path>/openils/var/web/opac/common/js/</script_path>
575 <biblio_fingerprint>biblio_fingerprint.js</biblio_fingerprint>
576 <biblio_descriptor>biblio_descriptor.js</biblio_descriptor>
582 <keepalive>10</keepalive>
583 <stateless>1</stateless>
584 <language>perl</language>
585 <implementation>OpenILS::Application::Storage</implementation>
587 <max_requests>1000</max_requests>
588 <unix_log>openils.storage_unix.log</unix_log>
589 <unix_sock>openils.storage_unix.sock</unix_sock>
590 <unix_pid>openils.storage_unix.pid</unix_pid>
591 <min_children>1</min_children>
592 <max_children>10</max_children>
593 <min_spare_children>1</min_spare_children>
594 <max_spare_children>5</max_spare_children>
597 <script_path>/openils/lib/javascript/</script_path>
598 <script_path>/openils/var/catalog/</script_path>
600 <biblio_fingerprint>biblio_fingerprint.js</biblio_fingerprint>
607 <user>postgres</user>
608 <host>localhost</host>
612 <client_encoding>UTF-8</client_encoding>
620 <keepalive>6</keepalive>
621 <stateless>1</stateless>
622 <language>C</language>
623 <implementation>oils_cstore.so</implementation>
624 <max_requests>95</max_requests>
626 <max_requests>400</max_requests>
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>
633 <max_query_recursion>100</max_query_recursion>
634 <driver>pgsql</driver>
638 <user>postgres</user>
639 <host>localhost</host>
643 <client_encoding>UTF-8</client_encoding>
651 <keepalive>1</keepalive>
652 <stateless>1</stateless>
653 <language>perl</language>
654 <implementation>OpenSRF::Application::Settings</implementation>
655 <max_requests>17</max_requests>
657 <unix_sock>opensrf.settings_unix.sock</unix_sock>
658 <unix_pid>opensrf.settings_unix.pid</unix_pid>
659 <max_requests>300</max_requests>
660 <unix_log>opensrf.settings_unix.log</unix_log>
661 <min_children>5</min_children>
662 <max_children>15</max_children>
663 <min_spare_children>3</min_spare_children>
664 <max_spare_children>5</max_spare_children>
668 <open-ils.collections>
669 <keepalive>3</keepalive>
670 <stateless>1</stateless>
671 <language>perl</language>
672 <implementation>OpenILS::Application::Collections</implementation>
673 <max_requests>17</max_requests>
675 <unix_sock>openils.collections_unix.sock</unix_sock>
676 <unix_pid>openils.collections_unix.pid</unix_pid>
677 <max_requests>1000</max_requests>
678 <unix_log>openils.collections_unix.log</unix_log>
679 <min_children>1</min_children>
680 <max_children>10</max_children>
681 <min_spare_children>1</min_spare_children>
682 <max_spare_children>5</max_spare_children>
684 </open-ils.collections>
687 <keepalive>3</keepalive>
688 <stateless>1</stateless>
689 <language>perl</language>
690 <implementation>OpenILS::Application::Reporter</implementation>
691 <max_requests>99</max_requests>
693 <unix_sock>openils.reporter_unix.sock</unix_sock>
694 <unix_pid>openils.reporter_unix.pid</unix_pid>
695 <max_requests>1000</max_requests>
696 <unix_log>openils.reporter_unix.log</unix_log>
697 <min_children>1</min_children>
698 <max_children>10</max_children>
699 <min_spare_children>1</min_spare_children>
700 <max_spare_children>5</max_spare_children>
705 <open-ils.reporter-store>
706 <keepalive>6</keepalive>
707 <stateless>1</stateless>
708 <language>C</language>
709 <implementation>oils_rstore.so</implementation>
710 <max_requests>95</max_requests>
712 <max_requests>400</max_requests>
713 <min_children>1</min_children>
714 <max_children>10</max_children>
715 <min_spare_children>1</min_spare_children>
716 <max_spare_children>5</max_spare_children>
719 <driver>pgsql</driver>
723 <user>postgres</user>
724 <host>localhost</host>
728 <client_encoding>UTF-8</client_encoding>
731 </open-ils.reporter-store>
734 <keepalive>3</keepalive>
735 <stateless>1</stateless>
736 <language>perl</language>
737 <implementation>OpenILS::Application::PermaCrud</implementation>
738 <max_requests>17</max_requests>
740 <unix_sock>open-ils.permacrud_unix.sock</unix_sock>
741 <unix_pid>open-ils.permacrud_unix.pid</unix_pid>
742 <max_requests>1000</max_requests>
743 <unix_log>open-ils.permacrud_unix.log</unix_log>
744 <min_children>5</min_children>
745 <max_children>15</max_children>
746 <min_spare_children>3</min_spare_children>
747 <max_spare_children>5</max_spare_children>
749 </open-ils.permacrud>
752 <keepalive>3</keepalive>
753 <stateless>1</stateless>
754 <language>perl</language>
755 <implementation>OpenILS::Application::Fielder</implementation>
756 <max_requests>17</max_requests>
758 <unix_sock>open-ils.fielder_unix.sock</unix_sock>
759 <unix_pid>open-ils.fielder_unix.pid</unix_pid>
760 <max_requests>1000</max_requests>
761 <unix_log>open-ils.fielder_unix.log</unix_log>
762 <min_children>5</min_children>
763 <max_children>15</max_children>
764 <min_spare_children>3</min_spare_children>
765 <max_spare_children>5</max_spare_children>
776 Should match the fully qualified domain name of the host.
778 On Linux, the output of the following command is authoritative:
779 $ perl -MNet::Domain -e 'print Net::Domain::hostfqdn();'
781 To use 'localhost' instead, run osrf_ctl.sh with the -l flag
785 <!-- services hosted on this machine -->
786 <appname>opensrf.settings</appname>
787 <appname>opensrf.math</appname>
788 <appname>opensrf.dbmath</appname>
789 <appname>open-ils.cat</appname>
790 <appname>open-ils.supercat</appname>
791 <appname>open-ils.search</appname>
792 <appname>open-ils.circ</appname>
793 <appname>open-ils.actor</appname>
794 <appname>open-ils.auth</appname>
795 <appname>open-ils.storage</appname>
796 <appname>open-ils.penalty</appname>
797 <appname>open-ils.cstore</appname>
798 <appname>open-ils.collections</appname>
799 <appname>open-ils.ingest</appname>
800 <appname>open-ils.reporter</appname>
801 <appname>open-ils.reporter-store</appname>
802 <appname>open-ils.permacrud</appname>
803 <appname>open-ils.fielder</appname>