ILLiad and Rapido can connect to each other using ISO standard communication between the two systems. This allows a partner in Rapido to Borrow and Lend materials with a partner in ILLiad, and vice versa. The requests are processed in each system more or less the same as any other request in that system.

ILLiad Configuration

The library using ILLiad needs to open a few IP addresses and make a partner for the Rapido library in their ILLiad instance since Rapido libraries are not in WorldCat. The configuration is in two parts that are generally handled by different people in the library. The first part of the configuration usually requires library or campus IT and the second part can be done by anyone with access to ILLiad Customization Manager.

Campus IT

The first part of the configuration was created by faculty and staff at Brandeis University and made public in a Google Doc. To ensure the the information is available it is also pasted below. The following steps are very technical and are done by Library IT if your ILLiad is self hosted, or by Atlas Systems through a support case if your ILLiad is hosted on their servers.

Instructions from Brandeis

1. Log into your ILLiad server and open Windows PowerShell

2. Navigate to c:\illiad\iso\

3. Extract the file c:\illiad\iso\iso.zip and move the file install.ps1 and the InstallFiles folder to make it a subfolder of c:\illiad\iso\

4. Type the following command into the PowerShell: c:\illiad\ISO\Install.ps1 -InstallPath "C:\ILLiad\ISO\"

5. Your screen should be similar to the image above

6. Open the Windows Administrative Tools and go to Services

7. Start the service, ILLiad ISO Service

8. Start the service, ILLiad ISO Manager

   1. If the ILLiad ISO Manager is not showing up, you likely need to install the manager. Going into the command prompt as an administrator on the server, navigate to c:\illiad\iso and type “isomanager.exe -install”

   2. Go back to services and refresh the list (F5); the ILLiad ISO Manager should now appear on the list

9. Open ports 1611 and 9001 for bi-directional traffic. 1611 is the ILLiad port for ISO while 9001 is the Alma port for ISO. Both need to be open. (2/14/22 note: 9011 may not need to be open for incoming requests in ILLiad based on recent testing.)

   1. Ports will need to be opened on Campus firewall and local server firewall (if self hosted)

      1. 64.74.237.233

      2. 64.74.237.229

   2. Contact campus IT for campus firewall

   3. For local server

      1. From the server desktop, click on Search (magnifying glass) and type Firewall

      2. Open Windows Defender Firewall

      3. Click on Advanced Settings

      4. Click on Inbound Rules

      5. Click New Rule

      6. Select Port, then Next

      7. Select TCP, Specific Ports and enter 9001, 1611 into text box, then Next

      8. Allow the Connection, then Next

      9. Next

      10. Name it ISO and click Finish

Resource Sharing Faculty/Staff

The following steps can be performed in ILLiad Customization Manager and ILLiad by either library IT or Resource Sharing Staff.

Customization Manager

1. Open Customization Manager

2. Go to System → ISOILLDefaults

3. Set ISOEnabled = Yes

4. Set ISOIFMBorrowing = Yes (probably already default)

5. Set ISOIFMLending = Yes (probably already default)

6. Set ISOReturnIPAddress = <your webserver ip address>:1611

7. Set ISOSystemID = <your symbol when sending to other ISO libraries - usually your OCLC Symbol or similiar>

8. Set SystemIDISOSymbol = Same as above...normally these identifiers should match

ILLiad

All the previous steps up to this point only need to be done once to allow any number of Rapido partners in ILLiad. The following steps will need to be configured for each individual partner.

1. Open ILLiad and go to the Lending Tab and select Address: New. This will open the settings to add the Rapido library partner.

2. Add the appropriate symbol for the CSU partner you are adding to ILLiad. If you want to add all the CSU libraries you will need to add a partner for each library. The symbols are:

3. Fill out the following Shipping Address Information:

4. Under ISO Information add the following:

   1. ISO Enabled: ☑️

   2. ISO Type: TCP/IP

   3. IP Address: na03.alma.exlibrisgroup.com:9001

      1. There are several Ex Libris servers based on region, so this may change if adding a Rapido library other than the CSU.

   4. Email Address: The CSU Contact Email

      1. Bakersfield:

      2. Channel Islands:

      3. Chico:

      4. Dominguez Hills:

      5. East Bay:

      6. Fresno:

      7. Fullerton:

      8. Humboldt:

      9. Long Beach:

      10. Los Angeles:

      11. Maritime Academy:

      12. Monterey Bay:

      13. Moss Landing:

      14. Northridge:

      15. Pomona:

      16. Sacramento:

      17. San Bernardino:

      18. San Diego:

      19. San Francisco:

      20. San Jose:

      21. San Luis Obispo:

      22. San Marcos:

      23. Sonoma:

      24. Stanislaus:

Send Request

Test the setup by sending a dummy request to the CSU library you are adding. The request needs the following:

1. Title of a book owned by the specific CSU library

2. Lending String: Rapido Library Symbol (Example: 01CALS_XYZ)

3. Lender: Rapido Library Symbol (Example: 01CALS_XYZ)

4. System ID: ISO

This request will go to the CSU library and if the Rapido library has activated the Automatically Create Partner feature the system will automatically generate the ILLiad partner in Rapido. The ILLiad Partner in ILLiad will still need some slight configuration, but the setup is complete in ILLiad.

The ILLiad library may want to add their new CSU Rapido partners to an ISO Custom Holdings Groups where you can request from the entire CSU with the System ID set to ISO.

Rapido Configuration

Rapido also needs the ILLiad partner added, along with a rota, and ideally a locate profile. Setup in Rapido is fairly straight forward, but all the steps will need to be done for each added ILLiad partner.

Activate on Automatically Create Partner

In Alma go to Configuration → Resource Sharing → General → Other Settings and find the parameter with the Parameter Key rapido_automatically_create_partner. Change the Parameter Value to true. With this setting active Rapido can receive a Resource Sharing request from the ILLiad partner and have the partner record automatically created (mostly). This will make it much easier to configure the partner.

Add Partner

In Alma go to Fulfillment → Resource Sharing → Partners and find the partner made by the ILLiad library. The Partner will likely be named the ILLiad library’s OCLC symbol. For example, in testing the ILLiad library appeared as CNO, the OCLC symbol for CSU Northridge. Open the partner.

General Information Tab

The General Information tab for the Resource Sharing partner should come prefilled. If not, the following settings need to be added:

Parameters Tab

Go the the Parameters tab and add the following information provided by the ILLiad library:

Save the newly created partner!

Add Locally Managed Pod

To add a Locally Managed Pod you will make a Rota (like with CSU+ before Rapido) and mark it as a Locally Managed Pod. In Alma, go to Fulfillment → Resource Sharing → Rota Templates and select Add Rota. Make a Rota with the following settings:

Then click Add Partners and add all the ISO partners you want to share with.

Order Pods

The new Locally Managed Pod will appear in your Borrowing Pod Priority list. Go to Alma Configuration → Resource Sharing → Configuration → Members and select your library. Go to the Borrowing Policies tab to access the list and order the pod as you see fit. Eventually, you may want to make multiple pods based on region so you can request from CA ISO partners before Western US ISO partners and US ISO partners.

Locate Profiles

We will soon be able to add Z39 Locate profiles so Rapido can see what items are held by the ISO partners (and vice versa). Testing and directions coming soon.