[OPEN-ILS-DEV] SIP server documentation available in AsciiDoc on Git collab branch

[Ben Shum]

I'm on board with Galen's suggestion about making the
min_spare_servers='1', but I would also add that my recent testing of this
option indicated a need to also define the max_spare_servers value when
setting min_spare_servers to anything other than 0.

And then, it follows that you need max_servers > min_servers >
max_spare_servers > min_spare_servers

So an example config entry might look like:

        <server-params
           min_spare_servers='1'
           max_spare_servers='2'
           min_servers='3'
           max_servers='25' />

If not set appropriately, I found that SIPServer failed to start correctly
and silently crashed without too much explanation outside of higher logging
levels.

-- Ben


On Wed, Jul 9, 2014 at 12:50 PM, Galen Charlton <gmc at esilibrary.com> wrote:

> Hi,
>
> > I don't use SIp server so I need others to look it over. So feel free to
> > make additions, and/or to ask for help with AsciiDoc. Just let me know
> when
> > I should push it to master for inclusion in the official docs.
>
> Thanks for working on this.  I have a few comments:
>
> [1] I recommend min_spare_servers='1' rather than zero, as otherwise
> even small sites that have more than one SIP client in play have been
> observed to experience issues with clients complaining that it takes
> too long to establish a connection.
>
> [2] The instruction to "cp oils_sip.xml.example oils_sip.xml" appears
> twice in the document.  I think it should appear only once, to avoid
> somebody following the instructions too literally.
>
> [3] A permission should be added to the list for the SIP user profile:
> 'CREATE_PAYMENT'.
>
> [4] It's not necessary to explicitly supply the -d and -s options to
> oils_ctl.sh (assuming, of course, that the user is going with the
> stock name of the config file, oils_sip.xml).
>
> [5] Evergreen does support the Renew message.
>
> [5] Evergreen does support the Fee Paid and Renew All messages nowadays.
>
> [6] Evergreen also partially supports the Hold message, in particular
> to cancel hold requests.
>
> Regards,
>
> Galen
> --
> Galen Charlton
> Manager of Implementation
> Equinox Software, Inc. / The Open Source Experts
> email:  gmc at esilibrary.com
> direct: +1 770-709-5581
> cell:   +1 404-984-4366
> skype:  gmcharlt
> web:    http://www.esilibrary.com/
> Supporting Koha and Evergreen: http://koha-community.org &
> http://evergreen-ils.org
>



-- 
Benjamin Shum
Evergreen Systems Manager
Bibliomation, Inc.
24 Wooster Ave.
Waterbury, CT 06708
203-577-4070, ext. 113
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://libmail.georgialibraries.org/pipermail/open-ils-dev/attachments/20140709/1eb8faeb/attachment.htm>