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 -->
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>
50 Settings for the reporter daemon process
53 <base_uri>https://localhost/reporter/</base_uri>
56 <host>localhost</host>
63 <!-- successful report outputs go here -->
64 <output_base>/openils/var/web/reporter</output_base>
65 <success_template>/openils/var/data/report-success</success_template>
66 <fail_template>/openils/var/data/report-fail</fail_template>
74 <!-- XML-RPC gateway. Do NOT publish unprotected services here -->
76 <!-- list of published services -->
77 <service>opensrf.math</service>
78 <service>opensrf.dbmath</service>
79 <service>open-ils.cat</service>
80 <service>open-ils.search</service>
81 <service>open-ils.circ</service>
82 <service>open-ils.actor</service>
83 <service>open-ils.auth</service>
84 <service>open-ils.collections</service>
90 <default>oclc</default>
94 <!-- LoC does not require username/password -->
96 <host>z3950.loc.gov</host>
99 <!-- fetch the full record with no holdings. FI is the default -->
100 <record_format>FI</record_format>
102 <!-- Record transmission format from the server. Supported -->
103 <!-- formats include usmarc and xml (for marcxml). -->
104 <transmission_format>usmarc</transmission_format>
107 <tcn><code>12</code><format>1</format></tcn>
108 <isbn><code>7</code><format>6</format></isbn>
109 <lccn><code>9</code><format>1</format></lccn>
110 <author><code>1003</code><format>6</format></author>
111 <title><code>4</code><format>6</format></title>
112 <issn><code>8</code><format>1</format></issn>
113 <publisher><code>1018</code><format>6</format></publisher>
114 <pubdate><code>31</code><format>1</format></pubdate>
115 <item_type><code>1001</code><format>1</format></item_type>
120 <!-- Z3950 settings for OCLC. Note that OCLC requires username/password -->
121 <host>zcat.oclc.org</host>
123 <db>OLUCWorldCat</db>
126 These are directly from the Bib-1 Attribute Set
127 http://www.loc.gov/z3950/agency/defns/bib1.html
128 <code> is the "use attribute", <format> is the "structure attribute"
129 This just puts some friendly names on the data.
131 <tcn><code>12</code><format>1</format></tcn>
132 <isbn><code>7</code><format>6</format></isbn>
133 <lccn><code>9</code><format>1</format></lccn>
134 <author><code>1003</code><format>6</format></author>
135 <title><code>4</code><format>6</format></title>
136 <issn><code>8</code><format>1</format></issn>
137 <publisher><code>1018</code><format>6</format></publisher>
138 <pubdate><code>31</code><format>1</format></pubdate>
139 <item_type><code>1001</code><format>1</format></item_type>
149 <!-- XXX If you use the Amazon plugin, you must link back to Amazon in the OPAC -->
151 <!-- load the Amazon added content module -->
152 <module>OpenILS::WWW::AddedContent::Amazon</module>
154 Base URL for Amazon added content fetching. This URL may
155 need to be shortened when new (read: non-image) content
156 fetching capabilities are added
158 <base_url>http://images.amazon.com/images/P/</base_url>
161 Max number of seconds to wait for an added content request to
162 return data. Data not returned within the timeout is considered
168 After added content lookups have been disabled due to too many
169 lookup failures, this is the amount of time to wait before
172 <retry_timeout>600</retry_timeout>
175 maximum number of consecutive lookup errors a given process can
176 have before added content lookups are disabled for everyone
178 <max_errors>4</max_errors>
180 <!-- If a userid is required to access the added content.. -->
181 <userid>MY_USER_ID</userid>
184 You can add free-form settings here and they will be accessible
185 within the added content module
192 <!-- no apps are enabled globally by default -->
196 <!-- memcache servers -->
199 <server>localhost:11211</server>
201 <max_cache_time>86400</max_cache_time>
206 <!-- Authentication server -->
209 <!-- how long to wait between stateful requests before the child process re-joins the pool -->
210 <keepalive>5</keepalive>
212 <!-- true if this service support stateless requests -->
213 <stateless>1</stateless>
215 <!-- implementation language -->
216 <language>c</language>
218 <!-- library to plugin -->
219 <implementation>oils_auth.so</implementation>
221 <!-- maximum required opensrf requests within a stateful connection -->
222 <max_requests>93</max_requests>
226 maximum number of top level requests coming to
227 this child before the child is recycled
229 <max_requests>1000</max_requests>
230 <!-- min children to fork -->
231 <min_children>1</min_children>
232 <!-- max possible children to fork -->
233 <max_children>15</max_children>
236 C forking implementation does not support
237 min/max idle children, but may in the future
240 <!-- min idle children -->
241 <min_spare_children>1</min_spare_children>
242 <!-- max idle children -->
243 <max_spare_children>5</max_spare_children>
248 <!-- defined app-specific settings here -->
250 <!-- default login timeouts based on login type -->
259 <!-- Generic search server -->
261 <keepalive>5</keepalive>
262 <stateless>1</stateless>
263 <language>perl</language>
264 <implementation>OpenILS::Application::Search</implementation>
265 <max_requests>93</max_requests>
268 <!-- the following 3 settings are currently used by Perl services only -->
269 <unix_sock>open-ils.search_unix.sock</unix_sock>
270 <unix_pid>open-ils.search_unix.pid</unix_pid>
271 <unix_log>open-ils.search_unix.log</unix_log>
273 <max_requests>1000</max_requests>
274 <min_children>1</min_children>
275 <max_children>15</max_children>
276 <min_spare_children>1</min_spare_children>
277 <max_spare_children>5</max_spare_children>
280 <marc_html_xsl>oilsMARC21slim2HTML.xsl</marc_html_xsl>
281 <!-- Default to using staged search -->
282 <use_staged_search>true</use_staged_search>
283 <superpage_size>500</superpage_size>
284 <max_superpages>20</max_superpages>
285 <!-- zip code database file -->
286 <!--<zips_file>/openils/var/data/zips.txt</zips_file>-->
290 <!-- server for accessing user info -->
292 <keepalive>5</keepalive>
293 <stateless>1</stateless>
294 <language>perl</language>
295 <implementation>OpenILS::Application::Actor</implementation>
296 <max_requests>93</max_requests>
298 <unix_sock>open-ils.actor_unix.sock</unix_sock>
299 <unix_pid>open-ils.actor_unix.pid</unix_pid>
300 <max_requests>1000</max_requests>
301 <unix_log>open-ils.actor_unix.log</unix_log>
302 <min_children>1</min_children>
303 <max_children>15</max_children>
304 <min_spare_children>1</min_spare_children>
305 <max_spare_children>5</max_spare_children>
311 <keepalive>5</keepalive>
312 <stateless>1</stateless>
313 <language>perl</language>
314 <implementation>OpenILS::Application::Cat</implementation>
315 <max_requests>199</max_requests>
317 <unix_sock>open-ils.cat_unix.sock</unix_sock>
318 <unix_pid>open-ils.cat_unix.pid</unix_pid>
319 <max_requests>1000</max_requests>
320 <unix_log>open-ils.cat_unix.log</unix_log>
321 <min_children>1</min_children>
322 <max_children>15</max_children>
323 <min_spare_children>1</min_spare_children>
324 <max_spare_children>5</max_spare_children>
328 <K_book>/openils/var/templates/marc/k_book.xml</K_book>
334 <keepalive>5</keepalive>
335 <stateless>1</stateless>
336 <language>perl</language>
337 <implementation>OpenILS::Application::SuperCat</implementation>
338 <max_requests>199</max_requests>
340 <unix_sock>open-ils.supercat_unix.sock</unix_sock>
341 <unix_pid>open-ils.supercat_unix.pid</unix_pid>
342 <max_requests>1000</max_requests>
343 <unix_log>open-ils.supercat_unix.log</unix_log>
344 <min_children>1</min_children>
345 <max_children>15</max_children>
346 <min_spare_children>1</min_spare_children>
347 <max_spare_children>5</max_spare_children>
353 <keepalive>3</keepalive>
354 <stateless>1</stateless>
355 <language>c</language>
356 <implementation>osrf_math.so</implementation>
357 <max_requests>97</max_requests>
359 <unix_sock>opensrf.math_unix.sock</unix_sock>
360 <unix_pid>opensrf.math_unix.pid</unix_pid>
361 <max_requests>1000</max_requests>
362 <unix_log>opensrf.math_unix.log</unix_log>
363 <min_children>1</min_children>
364 <max_children>15</max_children>
365 <min_spare_children>1</min_spare_children>
366 <max_spare_children>5</max_spare_children>
371 <keepalive>3</keepalive>
372 <stateless>1</stateless>
373 <language>c</language>
374 <implementation>osrf_dbmath.so</implementation>
375 <max_requests>99</max_requests>
377 <max_requests>1000</max_requests>
378 <unix_log>opensrf.dbmath_unix.log</unix_log>
379 <unix_sock>opensrf.dbmath_unix.sock</unix_sock>
380 <unix_pid>opensrf.dbmath_unix.pid</unix_pid>
381 <min_children>1</min_children>
382 <max_children>15</max_children>
383 <min_spare_children>1</min_spare_children>
384 <max_spare_children>5</max_spare_children>
389 <keepalive>3</keepalive>
390 <stateless>1</stateless>
391 <language>perl</language>
392 <implementation>OpenILS::Application::Penalty</implementation>
393 <max_requests>99</max_requests>
395 <max_requests>1000</max_requests>
396 <unix_log>open-ils.penalty_unix.log</unix_log>
397 <unix_sock>open-ils.penalty_unix.sock</unix_sock>
398 <unix_pid>open-ils.penalty_unix.pid</unix_pid>
399 <min_children>1</min_children>
400 <max_children>15</max_children>
401 <min_spare_children>1</min_spare_children>
402 <max_spare_children>5</max_spare_children>
405 <patron_penalty>penalty/patron_penalty.js</patron_penalty>
406 <script_path>/openils/lib/javascript</script_path>
407 <script_path>/openils/var</script_path>
408 <script_path>/openils/var/catalog</script_path>
413 <keepalive>3</keepalive>
414 <stateless>1</stateless>
415 <language>perl</language>
416 <implementation>OpenILS::Application::Circ</implementation>
417 <max_requests>99</max_requests>
419 <max_requests>1000</max_requests>
420 <unix_log>open-ils.circ_unix.log</unix_log>
421 <unix_sock>open-ils.circ_unix.sock</unix_sock>
422 <unix_pid>open-ils.circ_unix.pid</unix_pid>
423 <min_children>1</min_children>
424 <max_children>15</max_children>
425 <min_spare_children>1</min_spare_children>
426 <max_spare_children>5</max_spare_children>
430 <email>false</email> <!-- set to true for hold notice emails -->
433 <!-- circulation policy scripts -->
434 <script_path>/openils/lib/javascript</script_path>
435 <script_path>/openils/var</script_path>
436 <script_path>/openils/var/catalog</script_path>
437 <legacy_script_support>false</legacy_script_support>
439 <circ_permit_patron>circ/circ_permit_patron.js</circ_permit_patron>
440 <circ_permit_copy>circ/circ_permit_copy.js</circ_permit_copy>
441 <circ_duration>circ/circ_duration.js</circ_duration>
442 <circ_recurring_fines>circ/circ_recurring_fines.js</circ_recurring_fines>
443 <circ_max_fines>circ/circ_max_fines.js</circ_max_fines>
444 <circ_permit_renew>circ/circ_permit_renew.js</circ_permit_renew>
445 <circ_permit_hold>circ/circ_permit_hold.js</circ_permit_hold>
454 <mod>bestseller</mod>
455 <mod>bestsellernh</mod>
470 <mod>softwrlong</mod>
471 <mod>equip-long</mod>
472 <mod>talking book</mod>
475 <mod>video-long</mod>
479 <type>Miscellaneous</type>
480 <type>Overdue materials</type>
481 <type>Fee for placing a hold</type>
482 <type>Fee for checking out a book</type>
483 <type>Fee for library card</type>
484 <type>Miscellaneous charges</type>
485 <type>Lost materials</type>
486 <type>Damaged material</type>
487 <type>Overdue Reserves charge</type>
488 <type>Recall overdue</type>
489 <type>Fee for processing lost library materials</type>
490 <type>Fee for sending patron bills to collection agency</type>
491 <type>Fee for interlibrary loan</type>
492 <type>Fee for copies</type>
493 <type>Money advanced to pay for telephone use</type>
494 <type>Deposit fee</type>
495 <type>Fee for disk</type>
496 <type>Fee for faxing</type>
497 <type>Fee for laminating</type>
498 <type>Fee for room cleaning</type>
499 <type>Deposit returned; fee refund</type>
500 <type>Sale items</type>
501 <type>Fee for lost card</type>
502 <type>Long overdue items</type>
503 <type>Lost/Replacement Cassette</type>
504 <type>Returned Check</type>
510 <keepalive>3</keepalive>
511 <stateless>1</stateless>
512 <implementation>OpenILS::Application::Ingest</implementation>
513 <language>perl</language>
514 <max_requests>1000000</max_requests>
516 <max_requests>1000000</max_requests>
517 <unix_log>open-ils.ingest-unix.log</unix_log>
518 <unix_sock>open-ils.ingest-unix.sock</unix_sock>
519 <unix_pid>open-ils.ingest-unix.pid</unix_pid>
520 <min_children>5</min_children>
521 <max_children>20</max_children>
522 <min_spare_children>2</min_spare_children>
523 <max_spare_children>5</max_spare_children>
526 <script_path>/openils/lib/javascript/</script_path>
527 <script_path>/openils/var/catalog/</script_path>
528 <script_path>/openils/var/web/opac/common/js/</script_path>
530 <biblio_fingerprint>biblio_fingerprint.js</biblio_fingerprint>
531 <biblio_descriptor>biblio_descriptor.js</biblio_descriptor>
537 <keepalive>10</keepalive>
538 <stateless>1</stateless>
539 <language>perl</language>
540 <implementation>OpenILS::Application::Storage</implementation>
542 <max_requests>1000</max_requests>
543 <unix_log>openils.storage_unix.log</unix_log>
544 <unix_sock>openils.storage_unix.sock</unix_sock>
545 <unix_pid>openils.storage_unix.pid</unix_pid>
546 <min_children>1</min_children>
547 <max_children>10</max_children>
548 <min_spare_children>1</min_spare_children>
549 <max_spare_children>5</max_spare_children>
552 <script_path>/openils/lib/javascript/</script_path>
553 <script_path>/openils/var/catalog/</script_path>
555 <biblio_fingerprint>biblio_fingerprint.js</biblio_fingerprint>
562 <user>postgres</user>
563 <host>localhost</host>
567 <client_encoding>UTF-8</client_encoding>
575 <keepalive>6</keepalive>
576 <stateless>1</stateless>
577 <language>C</language>
578 <implementation>oils_cstore.so</implementation>
579 <max_requests>95</max_requests>
581 <max_requests>400</max_requests>
582 <min_children>1</min_children>
583 <max_children>15</max_children>
584 <min_spare_children>1</min_spare_children>
585 <max_spare_children>5</max_spare_children>
588 <max_query_recursion>100</max_query_recursion>
589 <driver>pgsql</driver>
593 <user>postgres</user>
594 <host>localhost</host>
598 <client_encoding>UTF-8</client_encoding>
606 <keepalive>1</keepalive>
607 <stateless>1</stateless>
608 <language>perl</language>
609 <implementation>OpenSRF::Application::Settings</implementation>
610 <max_requests>17</max_requests>
612 <unix_sock>opensrf.settings_unix.sock</unix_sock>
613 <unix_pid>opensrf.settings_unix.pid</unix_pid>
614 <max_requests>300</max_requests>
615 <unix_log>opensrf.settings_unix.log</unix_log>
616 <min_children>5</min_children>
617 <max_children>15</max_children>
618 <min_spare_children>3</min_spare_children>
619 <max_spare_children>5</max_spare_children>
623 <open-ils.collections>
624 <keepalive>3</keepalive>
625 <stateless>1</stateless>
626 <language>perl</language>
627 <implementation>OpenILS::Application::Collections</implementation>
628 <max_requests>17</max_requests>
630 <unix_sock>openils.collections_unix.sock</unix_sock>
631 <unix_pid>openils.collections_unix.pid</unix_pid>
632 <max_requests>1000</max_requests>
633 <unix_log>openils.collections_unix.log</unix_log>
634 <min_children>1</min_children>
635 <max_children>10</max_children>
636 <min_spare_children>1</min_spare_children>
637 <max_spare_children>5</max_spare_children>
639 </open-ils.collections>
642 <keepalive>3</keepalive>
643 <stateless>1</stateless>
644 <language>perl</language>
645 <implementation>OpenILS::Application::Reporter</implementation>
646 <max_requests>99</max_requests>
648 <unix_sock>openils.reporter_unix.sock</unix_sock>
649 <unix_pid>openils.reporter_unix.pid</unix_pid>
650 <max_requests>1000</max_requests>
651 <unix_log>openils.reporter_unix.log</unix_log>
652 <min_children>1</min_children>
653 <max_children>10</max_children>
654 <min_spare_children>1</min_spare_children>
655 <max_spare_children>5</max_spare_children>
660 <open-ils.reporter-store>
661 <keepalive>6</keepalive>
662 <stateless>1</stateless>
663 <language>C</language>
664 <implementation>oils_rstore.so</implementation>
665 <max_requests>95</max_requests>
667 <max_requests>400</max_requests>
668 <min_children>1</min_children>
669 <max_children>10</max_children>
670 <min_spare_children>1</min_spare_children>
671 <max_spare_children>5</max_spare_children>
674 <driver>pgsql</driver>
678 <user>postgres</user>
679 <host>localhost</host>
683 <client_encoding>UTF-8</client_encoding>
686 </open-ils.reporter-store>
689 <keepalive>3</keepalive>
690 <stateless>1</stateless>
691 <language>perl</language>
692 <implementation>OpenILS::Application::PermaCrud</implementation>
693 <max_requests>17</max_requests>
695 <unix_sock>open-ils.permacrud_unix.sock</unix_sock>
696 <unix_pid>open-ils.permacrud_unix.pid</unix_pid>
697 <max_requests>1000</max_requests>
698 <unix_log>open-ils.permacrud_unix.log</unix_log>
699 <min_children>5</min_children>
700 <max_children>15</max_children>
701 <min_spare_children>3</min_spare_children>
702 <max_spare_children>5</max_spare_children>
704 </open-ils.permacrud>
707 <keepalive>3</keepalive>
708 <stateless>1</stateless>
709 <language>perl</language>
710 <implementation>OpenILS::Application::Fielder</implementation>
711 <max_requests>17</max_requests>
713 <unix_sock>open-ils.fielder_unix.sock</unix_sock>
714 <unix_pid>open-ils.fielder_unix.pid</unix_pid>
715 <max_requests>1000</max_requests>
716 <unix_log>open-ils.fielder_unix.log</unix_log>
717 <min_children>5</min_children>
718 <max_children>15</max_children>
719 <min_spare_children>3</min_spare_children>
720 <max_spare_children>5</max_spare_children>
731 Should match the fully qualified domain name of the host.
733 On Linux, the output of the following command is authoritative:
734 $ perl -MNet::Domain -e 'print Net::Domain::hostfqdn();'
736 To use 'localhost' instead, run osrf_ctl.sh with the -l flag
740 <!-- services hosted on this machine -->
741 <appname>opensrf.settings</appname>
742 <appname>opensrf.math</appname>
743 <appname>opensrf.dbmath</appname>
744 <appname>open-ils.cat</appname>
745 <appname>open-ils.supercat</appname>
746 <appname>open-ils.search</appname>
747 <appname>open-ils.circ</appname>
748 <appname>open-ils.actor</appname>
749 <appname>open-ils.auth</appname>
750 <appname>open-ils.storage</appname>
751 <appname>open-ils.penalty</appname>
752 <appname>open-ils.cstore</appname>
753 <appname>open-ils.collections</appname>
754 <appname>open-ils.ingest</appname>
755 <appname>open-ils.reporter</appname>
756 <appname>open-ils.reporter-store</appname>
757 <appname>open-ils.permacrud</appname>
758 <appname>open-ils.fielder</appname>