A guide to configuring the SimplyE Circulation Manager, for hosting/implementation providers or technical library staff
This guide is currently under development. We're converting from a previous set of documents, so a few of the instructions and links are no longer valid. As soon as the conversion and initial edit is complete, we'll update the status to draft. Nevertheless, comments and feedback are welcome.
This document provides the basic instructions necessary to configure a demonstration implementation of the Circulation Manager. They provide access to a single library with a small, open access collection. This configuration does not yet demonstrate configuring a DRM-protected library service stream from a commercial service, such as Overdrive, Bibliotheca, or Axis 360. Instead, the aim here is to meet four goals:
- Ensure that the Circulation Manager is deployed successfully,
- Review how the Circulation Manager works,
- Provide an opportunity to experience actively configuring a Circulation Manager before deploying a production service,
- Review how the Circulation Manager works,
- Ensure that the Circulation Manager is deployed successfully, and
- Promote confidence that the organization is ready to deploy a more robust, production Circulation Manager.
Though this Quickstart does not demonstrate configuring a library's commercial collection of DRM-protected materials, there are other documents which provide step-by-step guidance. After you have configured this demonstration Circulation Manager, you may wish to see the "Configure" articles in the How-to articles section for integrating a one or more specific commercial provider collection.
NOTE: I need to do something with the following block. After reviewing and editing the doc,
This document will provide the following:
- Getting your initial Circulation Manager installed and configured to a state in which a Sysadmin can access and use the configuration UI
- Getting a testable version of the App through test flight so they may evaluate and troubleshoot configurations and operations prior to pilot.
Deployment. Your Circulation Manager should be completely deployed and available on the Internet to fully test the configuration elements presented here. Refer to the Deploying a SimplyE Service document for more information on deployment scenarios and instructions on deploying to virtual servers and or Amazon Web Services.
System and Library Information. This The instructions below refer to data you will need to complete the configuration of several areas of the Circulation Manager. For example, in a production environment as the hosting provider/implementor, you should have already received information from a library to be added to the Circulation Manager. The required library data is described in detail in the document SimplyE Library Implementation Guide. We've included example data below which you will use if following the demonstration library configuration.
|TECHNICAL NOTE: The provider domain above uses a simple HTTP service, not an encrypted site. The simple test deployment instructions referenced in Deploying a SimplyE Service do not install the OpenSSL library/module needed to provide HTTPS service. This is by design: the |
Web Browser. Last, we recommend you must use Google Chrome or Mozilla Firefox to work in the Admin configuration interface. The Admin interface currently does did not render correctly in Microsoft's Internet Explorer or Edge browsers in early 2.x versions of the Circulation Manager and occasionally may still exhibit problems in Explorer/Edge.
Once you have deployed/installed the Circulation Manager software, you're ready to begin configuring the system to connect to the various external systems that make SimplyE work: commercial ebook provider systems and other sources of ebooks, libraries' integrated library systems, indexing/search servers, metadata servers, and analytics systems. The Circulation Manager acts as a nexus of these systems and provides lists of these resources in the form of OPDS feeds, based on the Atom Syndication Format, to remote clients. Currently SimplyE clients are available for both iOS and Android mobile operating systems. Plans are in place for a web-based client as well.
Access the Web-Based Configuration Interface
When the administrator account is created, your browser will be redirected to the Admin login page.
Login as the Administrator
On the Circulation Manager's login page:
Configure the Circulation Manager System
- Click the Patron Authentication sidebar item
- Click the Create a new patron authentication service item
- Again, give the service a descriptive name that is easy to identify in a long list of services; e.g.,
ABC Public Library -- Simple Auth
- Accept the default "Simple Authentication Provider" in the dropdown list for this test
- Enter a test user identifier; for a simulated 14-digit barcode, you might enter the following:
- Enter a test password, which in this case should actually be a PIN, something like:
- In the Libraries dropdown item, select the library you created
- Click the Add Library button at the bottom of the form
- Click the Submit button to create the integration
Register the Library with the NYPL Adobe ID Service
When you create a library with commercial, DRM-protected collections, you must register the library with NYPL so the library will have access to NYPL's shared Adobe ID license. Though you can skip this step for the demonstration library in this example, it is a critical step in making the library's collections usable in production.
Configuring Custom Lanes for the SimplyE Mobile App
The SimplyE mobile app presents subsets of a library's collection, usually specific genres and/or sub-genres of a collection, as a set of carousels termed lanes (swim lanes) in its primary interface. Lanes are automatically generated from the metadata included in an ebook data feed. However, the lanes presented can be customized. The document Customizing Lane Categories, providing a demonstration with step-by-step configuration instructions, is planned for development soon. If you wish to look at the editor interface before that document is ready:
More information will follow in the detailed document.
Accessing the Demonstration Collection
Once the system is configured , with the library you have created a library, and imported the demonstration collection you imported, you can set up the generic production SimplyE mobile app to point to your test library's collection for review. Because this library is not registered with NYPL, its name will not appear in the list of available libraries using SimplyE. Instead, you can review your demonstration collection by using a tap sequence to open up a hidden prompt.
- Download/install the SimplyE app from the app store for your device (Apple Store or Google Play Store)
- Open the SimplyE app on your device
- Tap the menu icon
- Tap the Settings item
- In rapid succession, tap the Version entry eight times
- Tap the Alternate URIs entry which appears
- In the Feed URI field, enter the URL to the demonstration library's OPDS feed; e.g.,
- Click the Set button at the bottom of the form
- Click the back arrow icon to go back to Settings
- Click the menu icon
- Click the Catalog item to display books in the demonstration library's collection
This manual mechanism is available for informally testing the display of library collections. This will work with DRM-protected collections as well as the open collection used in this demo. However, this mechanism will not work correctly when you are ready to test download and reading of DRM-protected commercial collections. For that level of testing, you will need to contact NYPL to include the library in the beta distributions of the iOS and Android mobile apps. For instructions, see Request a Library's Inclusion in Beta/Production App (Draft).
Once you have successfully accessed the library's OPDS feed in the generic app, you have completed the configuration of your first SimplyE deployment.
will be able to view the collection in the Circulation Manager Admin interface.
To access the demonstration collection for the library, log in to the Admin interface as you've done in the sections above. Assuming the demo library is the single library tenant in the Circulation Manager, the library's catalog will be displayed in a series of topic carousels. If you have multiple library tenants in the Circulation Manager, select the desired library name in the library drop-down at the left side of the top Admin interface's top menu. The chosen library's catalog will be displayed.
Register with the Library Simplified Library Registry Service
Viewing a collection in either the beta or production SimplyE mobile apps requires registering the library with NYPL's Library Simplified Library Registry. App use currently is intended only for actual libraries. (Future development tasks have been discussed to enable registering a demonstration library but the feature is not yet available.) Skip this step for the demonstration example.
If you have configured an actual library and wish to include the library in the SimplyE Beta program so staff can fully review their collections in the SimplyE apps, you must register the library. Registration adds the library to the apps' list of libraries participating in SimplyE so users can log in and use materials. It also creates a secret key for the library so the apps can use NYPL's Adobe Vendor ID on behalf of the library in making loan requests of any commercial titles (OverDrive, Bibliotheca, Axis 360, etc.) in the library's collections.
Configuration steps coming soon.