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 <tcn><code>12</code><format>1</format></tcn>
103 <isbn><code>7</code><format>6</format></isbn>
104 <lccn><code>9</code><format>1</format></lccn>
105 <author><code>1003</code><format>6</format></author>
106 <title><code>4</code><format>6</format></title>
107 <issn><code>8</code><format>1</format></issn>
108 <publisher><code>1018</code><format>6</format></publisher>
109 <pubdate><code>31</code><format>1</format></pubdate>
110 <item_type><code>1001</code><format>1</format></item_type>
115 <!-- Z3950 settings for OCLC. Note that OCLC requires username/password -->
116 <host>zcat.oclc.org</host>
118 <db>OLUCWorldCat</db>
121 These are directly from the Bib-1 Attribute Set
122 http://www.loc.gov/z3950/agency/defns/bib1.html
123 <code> is the "use attribute", <format> is the "structure attribute"
124 This just puts some friendly names on the data.
126 <tcn><code>12</code><format>1</format></tcn>
127 <isbn><code>7</code><format>6</format></isbn>
128 <lccn><code>9</code><format>1</format></lccn>
129 <author><code>1003</code><format>6</format></author>
130 <title><code>4</code><format>6</format></title>
131 <issn><code>8</code><format>1</format></issn>
132 <publisher><code>1018</code><format>6</format></publisher>
133 <pubdate><code>31</code><format>1</format></pubdate>
134 <item_type><code>1001</code><format>1</format></item_type>
144 <!-- XXX If you use the Amazon plugin, you must link back to Amazon in the OPAC -->
146 <!-- load the Amazon added content module -->
147 <module>OpenILS::WWW::AddedContent::Amazon</module>
149 Base URL for Amazon added content fetching. This URL may
150 need to be shortened when new (read: non-image) content
151 fetching capabilities are added
153 <base_url>http://images.amazon.com/images/P/</base_url>
156 Max number of seconds to wait for an added content request to
157 return data. Data not returned within the timeout is considered
163 After added content lookups have been disabled due to too many
164 lookup failures, this is the amount of time to wait before
167 <retry_timeout>600</retry_timeout>
170 maximum number of consecutive lookup errors a given process can
171 have before added content lookups are disabled for everyone
173 <max_errors>4</max_errors>
175 <!-- If a userid is required to access the added content.. -->
176 <userid>MY_USER_ID</userid>
179 You can add free-form settings here and they will be accessible
180 within the added content module
187 <!-- no apps are enabled globally by default -->
191 <!-- memcache servers -->
194 <server>localhost:11211</server>
196 <max_cache_time>86400</max_cache_time>
201 <!-- Authentication server -->
204 <!-- how long to wait between stateful requests before the child process re-joins the pool -->
205 <keepalive>5</keepalive>
207 <!-- true if this service support stateless requests -->
208 <stateless>1</stateless>
210 <!-- implementation language -->
211 <language>c</language>
213 <!-- library to plugin -->
214 <implementation>oils_auth.so</implementation>
216 <!-- maximum required opensrf requests within a stateful connection -->
217 <max_requests>93</max_requests>
221 maximum number of top level requests coming to
222 this child before the child is recycled
224 <max_requests>1000</max_requests>
225 <!-- min children to fork -->
226 <min_children>1</min_children>
227 <!-- max possible children to fork -->
228 <max_children>15</max_children>
231 C forking implementation does not support
232 min/max idle children, but may in the future
235 <!-- min idle children -->
236 <min_spare_children>1</min_spare_children>
237 <!-- max idle children -->
238 <max_spare_children>5</max_spare_children>
243 <!-- defined app-specific settings here -->
245 <!-- default login timeouts based on login type -->
254 <!-- Generic search server -->
256 <keepalive>5</keepalive>
257 <stateless>1</stateless>
258 <language>perl</language>
259 <implementation>OpenILS::Application::Search</implementation>
260 <max_requests>93</max_requests>
263 <!-- the following 3 settings are currently used by Perl services only -->
264 <unix_sock>open-ils.search_unix.sock</unix_sock>
265 <unix_pid>open-ils.search_unix.pid</unix_pid>
266 <unix_log>open-ils.search_unix.log</unix_log>
268 <max_requests>1000</max_requests>
269 <min_children>1</min_children>
270 <max_children>15</max_children>
271 <min_spare_children>1</min_spare_children>
272 <max_spare_children>5</max_spare_children>
275 <marc_html_xsl>oilsMARC21slim2HTML.xsl</marc_html_xsl>
276 <!-- Default to using staged search -->
277 <use_staged_search>true</use_staged_search>
278 <superpage_size>1000</superpage_size>
279 <max_superpages>25</max_superpages>
280 <!-- zip code database file -->
281 <!--<zips_file>/openils/var/data/zips.txt</zips_file>-->
285 <!-- server for accessing user info -->
287 <keepalive>5</keepalive>
288 <stateless>1</stateless>
289 <language>perl</language>
290 <implementation>OpenILS::Application::Actor</implementation>
291 <max_requests>93</max_requests>
293 <unix_sock>open-ils.actor_unix.sock</unix_sock>
294 <unix_pid>open-ils.actor_unix.pid</unix_pid>
295 <max_requests>1000</max_requests>
296 <unix_log>open-ils.actor_unix.log</unix_log>
297 <min_children>1</min_children>
298 <max_children>15</max_children>
299 <min_spare_children>1</min_spare_children>
300 <max_spare_children>5</max_spare_children>
306 <keepalive>5</keepalive>
307 <stateless>1</stateless>
308 <language>perl</language>
309 <implementation>OpenILS::Application::Cat</implementation>
310 <max_requests>199</max_requests>
312 <unix_sock>open-ils.cat_unix.sock</unix_sock>
313 <unix_pid>open-ils.cat_unix.pid</unix_pid>
314 <max_requests>1000</max_requests>
315 <unix_log>open-ils.cat_unix.log</unix_log>
316 <min_children>1</min_children>
317 <max_children>15</max_children>
318 <min_spare_children>1</min_spare_children>
319 <max_spare_children>5</max_spare_children>
323 <K_book>/openils/var/templates/marc/k_book.xml</K_book>
329 <keepalive>5</keepalive>
330 <stateless>1</stateless>
331 <language>perl</language>
332 <implementation>OpenILS::Application::SuperCat</implementation>
333 <max_requests>199</max_requests>
335 <unix_sock>open-ils.supercat_unix.sock</unix_sock>
336 <unix_pid>open-ils.supercat_unix.pid</unix_pid>
337 <max_requests>1000</max_requests>
338 <unix_log>open-ils.supercat_unix.log</unix_log>
339 <min_children>1</min_children>
340 <max_children>15</max_children>
341 <min_spare_children>1</min_spare_children>
342 <max_spare_children>5</max_spare_children>
348 <keepalive>3</keepalive>
349 <stateless>1</stateless>
350 <language>c</language>
351 <implementation>osrf_math.so</implementation>
352 <max_requests>97</max_requests>
354 <unix_sock>opensrf.math_unix.sock</unix_sock>
355 <unix_pid>opensrf.math_unix.pid</unix_pid>
356 <max_requests>1000</max_requests>
357 <unix_log>opensrf.math_unix.log</unix_log>
358 <min_children>1</min_children>
359 <max_children>15</max_children>
360 <min_spare_children>1</min_spare_children>
361 <max_spare_children>5</max_spare_children>
366 <keepalive>3</keepalive>
367 <stateless>1</stateless>
368 <language>c</language>
369 <implementation>osrf_dbmath.so</implementation>
370 <max_requests>99</max_requests>
372 <max_requests>1000</max_requests>
373 <unix_log>opensrf.dbmath_unix.log</unix_log>
374 <unix_sock>opensrf.dbmath_unix.sock</unix_sock>
375 <unix_pid>opensrf.dbmath_unix.pid</unix_pid>
376 <min_children>1</min_children>
377 <max_children>15</max_children>
378 <min_spare_children>1</min_spare_children>
379 <max_spare_children>5</max_spare_children>
384 <keepalive>3</keepalive>
385 <stateless>1</stateless>
386 <language>perl</language>
387 <implementation>OpenILS::Application::Penalty</implementation>
388 <max_requests>99</max_requests>
390 <max_requests>1000</max_requests>
391 <unix_log>open-ils.penalty_unix.log</unix_log>
392 <unix_sock>open-ils.penalty_unix.sock</unix_sock>
393 <unix_pid>open-ils.penalty_unix.pid</unix_pid>
394 <min_children>1</min_children>
395 <max_children>15</max_children>
396 <min_spare_children>1</min_spare_children>
397 <max_spare_children>5</max_spare_children>
400 <patron_penalty>penalty/patron_penalty.js</patron_penalty>
401 <script_path>/openils/lib/javascript</script_path>
402 <script_path>/openils/var</script_path>
403 <script_path>/openils/var/catalog</script_path>
408 <keepalive>3</keepalive>
409 <stateless>1</stateless>
410 <language>perl</language>
411 <implementation>OpenILS::Application::Circ</implementation>
412 <max_requests>99</max_requests>
414 <max_requests>1000</max_requests>
415 <unix_log>open-ils.circ_unix.log</unix_log>
416 <unix_sock>open-ils.circ_unix.sock</unix_sock>
417 <unix_pid>open-ils.circ_unix.pid</unix_pid>
418 <min_children>1</min_children>
419 <max_children>15</max_children>
420 <min_spare_children>1</min_spare_children>
421 <max_spare_children>5</max_spare_children>
425 <email>false</email> <!-- set to true for hold notice emails -->
428 <!-- circulation policy scripts -->
429 <script_path>/openils/lib/javascript</script_path>
430 <script_path>/openils/var</script_path>
431 <script_path>/openils/var/catalog</script_path>
433 <circ_permit_patron>circ/circ_permit_patron.js</circ_permit_patron>
434 <circ_permit_copy>circ/circ_permit_copy.js</circ_permit_copy>
435 <circ_duration>circ/circ_duration.js</circ_duration>
436 <circ_recurring_fines>circ/circ_recurring_fines.js</circ_recurring_fines>
437 <circ_max_fines>circ/circ_max_fines.js</circ_max_fines>
438 <circ_permit_renew>circ/circ_permit_renew.js</circ_permit_renew>
439 <circ_permit_hold>circ/circ_permit_hold.js</circ_permit_hold>
448 <mod>bestseller</mod>
449 <mod>bestsellernh</mod>
464 <mod>softwrlong</mod>
465 <mod>equip-long</mod>
466 <mod>talking book</mod>
469 <mod>video-long</mod>
473 <type>Miscellaneous</type>
474 <type>Overdue materials</type>
475 <type>Fee for placing a hold</type>
476 <type>Fee for checking out a book</type>
477 <type>Fee for library card</type>
478 <type>Miscellaneous charges</type>
479 <type>Lost materials</type>
480 <type>Damaged material</type>
481 <type>Overdue Reserves charge</type>
482 <type>Recall overdue</type>
483 <type>Fee for processing lost library materials</type>
484 <type>Fee for sending patron bills to collection agency</type>
485 <type>Fee for interlibrary loan</type>
486 <type>Fee for copies</type>
487 <type>Money advanced to pay for telephone use</type>
488 <type>Deposit fee</type>
489 <type>Fee for disk</type>
490 <type>Fee for faxing</type>
491 <type>Fee for laminating</type>
492 <type>Fee for room cleaning</type>
493 <type>Deposit returned; fee refund</type>
494 <type>Sale items</type>
495 <type>Fee for lost card</type>
496 <type>Long overdue items</type>
497 <type>Lost/Replacement Cassette</type>
498 <type>Returned Check</type>
504 <keepalive>3</keepalive>
505 <stateless>1</stateless>
506 <implementation>OpenILS::Application::Ingest</implementation>
507 <language>perl</language>
508 <max_requests>1000000</max_requests>
510 <max_requests>1000000</max_requests>
511 <unix_log>open-ils.ingest-unix.log</unix_log>
512 <unix_sock>open-ils.ingest-unix.sock</unix_sock>
513 <unix_pid>open-ils.ingest-unix.pid</unix_pid>
514 <min_children>5</min_children>
515 <max_children>20</max_children>
516 <min_spare_children>2</min_spare_children>
517 <max_spare_children>5</max_spare_children>
520 <script_path>/openils/lib/javascript/</script_path>
521 <script_path>/openils/var/catalog/</script_path>
522 <script_path>/openils/var/web/opac/common/js/</script_path>
524 <biblio_fingerprint>biblio_fingerprint.js</biblio_fingerprint>
525 <biblio_descriptor>biblio_descriptor.js</biblio_descriptor>
531 <keepalive>10</keepalive>
532 <stateless>1</stateless>
533 <language>perl</language>
534 <implementation>OpenILS::Application::Storage</implementation>
536 <max_requests>1000</max_requests>
537 <unix_log>openils.storage_unix.log</unix_log>
538 <unix_sock>openils.storage_unix.sock</unix_sock>
539 <unix_pid>openils.storage_unix.pid</unix_pid>
540 <min_children>1</min_children>
541 <max_children>10</max_children>
542 <min_spare_children>1</min_spare_children>
543 <max_spare_children>5</max_spare_children>
546 <script_path>/openils/lib/javascript/</script_path>
547 <script_path>/openils/var/catalog/</script_path>
549 <biblio_fingerprint>biblio_fingerprint.js</biblio_fingerprint>
556 <user>postgres</user>
557 <host>localhost</host>
561 <client_encoding>UTF-8</client_encoding>
569 <keepalive>6</keepalive>
570 <stateless>1</stateless>
571 <language>C</language>
572 <implementation>oils_cstore.so</implementation>
573 <max_requests>95</max_requests>
575 <max_requests>400</max_requests>
576 <min_children>1</min_children>
577 <max_children>15</max_children>
578 <min_spare_children>1</min_spare_children>
579 <max_spare_children>5</max_spare_children>
582 <max_query_recursion>100</max_query_recursion>
583 <driver>pgsql</driver>
587 <user>postgres</user>
588 <host>localhost</host>
592 <client_encoding>UTF-8</client_encoding>
600 <keepalive>1</keepalive>
601 <stateless>1</stateless>
602 <language>perl</language>
603 <implementation>OpenSRF::Application::Settings</implementation>
604 <max_requests>17</max_requests>
606 <unix_sock>opensrf.settings_unix.sock</unix_sock>
607 <unix_pid>opensrf.settings_unix.pid</unix_pid>
608 <max_requests>300</max_requests>
609 <unix_log>opensrf.settings_unix.log</unix_log>
610 <min_children>5</min_children>
611 <max_children>15</max_children>
612 <min_spare_children>3</min_spare_children>
613 <max_spare_children>5</max_spare_children>
617 <open-ils.collections>
618 <keepalive>3</keepalive>
619 <stateless>1</stateless>
620 <language>perl</language>
621 <implementation>OpenILS::Application::Collections</implementation>
622 <max_requests>17</max_requests>
624 <unix_sock>openils.collections_unix.sock</unix_sock>
625 <unix_pid>openils.collections_unix.pid</unix_pid>
626 <max_requests>1000</max_requests>
627 <unix_log>openils.collections_unix.log</unix_log>
628 <min_children>1</min_children>
629 <max_children>10</max_children>
630 <min_spare_children>1</min_spare_children>
631 <max_spare_children>5</max_spare_children>
633 </open-ils.collections>
636 <keepalive>3</keepalive>
637 <stateless>1</stateless>
638 <language>perl</language>
639 <implementation>OpenILS::Application::Reporter</implementation>
640 <max_requests>99</max_requests>
642 <unix_sock>openils.reporter_unix.sock</unix_sock>
643 <unix_pid>openils.reporter_unix.pid</unix_pid>
644 <max_requests>1000</max_requests>
645 <unix_log>openils.reporter_unix.log</unix_log>
646 <min_children>1</min_children>
647 <max_children>10</max_children>
648 <min_spare_children>1</min_spare_children>
649 <max_spare_children>5</max_spare_children>
654 <open-ils.reporter-store>
655 <keepalive>6</keepalive>
656 <stateless>1</stateless>
657 <language>C</language>
658 <implementation>oils_rstore.so</implementation>
659 <max_requests>95</max_requests>
661 <max_requests>400</max_requests>
662 <min_children>1</min_children>
663 <max_children>10</max_children>
664 <min_spare_children>1</min_spare_children>
665 <max_spare_children>5</max_spare_children>
668 <driver>pgsql</driver>
672 <user>postgres</user>
673 <host>localhost</host>
677 <client_encoding>UTF-8</client_encoding>
680 </open-ils.reporter-store>
683 <keepalive>3</keepalive>
684 <stateless>1</stateless>
685 <language>perl</language>
686 <implementation>OpenILS::Application::PermaCrud</implementation>
687 <max_requests>17</max_requests>
689 <unix_sock>open-ils.permacrud_unix.sock</unix_sock>
690 <unix_pid>open-ils.permacrud_unix.pid</unix_pid>
691 <max_requests>1000</max_requests>
692 <unix_log>open-ils.permacrud_unix.log</unix_log>
693 <min_children>5</min_children>
694 <max_children>15</max_children>
695 <min_spare_children>3</min_spare_children>
696 <max_spare_children>5</max_spare_children>
698 </open-ils.permacrud>
701 <keepalive>3</keepalive>
702 <stateless>1</stateless>
703 <language>perl</language>
704 <implementation>OpenILS::Application::Fielder</implementation>
705 <max_requests>17</max_requests>
707 <unix_sock>open-ils.fielder_unix.sock</unix_sock>
708 <unix_pid>open-ils.fielder_unix.pid</unix_pid>
709 <max_requests>1000</max_requests>
710 <unix_log>open-ils.fielder_unix.log</unix_log>
711 <min_children>5</min_children>
712 <max_children>15</max_children>
713 <min_spare_children>3</min_spare_children>
714 <max_spare_children>5</max_spare_children>
725 Should match the fully qualified domain name of the host.
727 On Linux, the output of the following command is authoritative:
728 $ perl -MNet::Domain -e 'print Net::Domain::hostfqdn();'
730 To use 'localhost' instead, run osrf_ctl.sh with the -l flag
734 <!-- services hosted on this machine -->
735 <appname>opensrf.settings</appname>
736 <appname>opensrf.math</appname>
737 <appname>opensrf.dbmath</appname>
738 <appname>open-ils.cat</appname>
739 <appname>open-ils.supercat</appname>
740 <appname>open-ils.search</appname>
741 <appname>open-ils.circ</appname>
742 <appname>open-ils.actor</appname>
743 <appname>open-ils.auth</appname>
744 <appname>open-ils.storage</appname>
745 <appname>open-ils.penalty</appname>
746 <appname>open-ils.cstore</appname>
747 <appname>open-ils.collections</appname>
748 <appname>open-ils.ingest</appname>
749 <appname>open-ils.reporter</appname>
750 <appname>open-ils.reporter-store</appname>
751 <appname>open-ils.permacrud</appname>
752 <appname>open-ils.fielder</appname>