Adding SIP Users

  1. Type the following commands from the command prompt:

    $ sudo su opensrf
    $ cd /openils/conf
  2. In the <accounts> section, add SIP client login information. Make sure that all <logins> use the same institution attribute, and make sure the institution is listed in <institutions>. All attributes in the <login> section will be used by the SIP client.
  3. In Evergreen, create a new profile group called SIP. This group should be a sub-group of Users (not Staff or Patrons). Set Editing Permission as group_application.user.sip_client and give the group the following permissions:

    COPY_CHECKIN
    COPY_CHECKOUT
    CREATE_PAYMENT
    RENEW_CIRC
    VIEW_CIRCULATIONS
    VIEW_COPY_CHECKOUT_HISTORY
    VIEW_PERMIT_CHECKOUT
    VIEW_USER
    VIEW_USER_FINES_SUMMARY
    VIEW_USER_TRANSACTIONS

    OR use SQL like:

    INSERT INTO permission.grp_tree (name,parent,description,application_perm)
    VALUES ('SIP', 1, 'SIP2 Client Systems', 'group_application.user.sip_client');
    INSERT INTO
      permission.grp_perm_map (grp, perm, depth, grantable)
    SELECT
      g.id, p.id, 0, FALSE
    FROM
      permission.grp_tree g,
      permission.perm_list p
    WHERE
      g.name = 'SIP' AND
      p.code IN (
        'COPY_CHECKIN',
        'COPY_CHECKOUT',
        'RENEW_CIRC',
        'VIEW_CIRCULATIONS',
        'VIEW_COPY_CHECKOUT_HISTORY',
        'VIEW_PERMIT_CHECKOUT',
        'VIEW_USER',
        'VIEW_USER_FINES_SUMMARY',
        'VIEW_USER_TRANSACTIONS'
     );

    Verify:

    SELECT *
    FROM permission.grp_perm_map pgpm
        INNER JOIN permission.perm_list ppl ON pgpm.perm = ppl.id
        INNER JOIN permission.grp_tree pgt ON pgt.id = pgpm.grp
    WHERE pgt.name = 'SIP';
  4. For each account created in the <login> section of oils_sip.xml, create a user (via the staff client user editor) that has the same username and password and put that user into the SIP group.

Note

The expiration date will affect the SIP users' connection so you might want to make a note of this somewhere.