Requirements

To implement this functionality you must have access to the following

  • Circulation Manager ver 3.0.10
  • MARC or ONIX Files
  • EPUBs or PDF files
  • Cover Art (JPEG, PNG) for the respective EPUBs or PDFs.
  • Network reachable location (for example, a file share in LAN).

Steps

  1. Create a new S3 storage by setting up the following settings as it’s shown in the picture below:
    1. Access key should be set up to an AWS access key
    2. Secret key should be set up an AWS secret key
    3. S3 region should be set up to an AWS region where buckets are located (the default is us-east-1)
    4. S3 addressing style should be set up to Virtual to allow virtual hosted-style URLs
    5. S3 presigned URL expiration should be set to S3 Default
    6. URL format should be set to S3 Default
    7. Book Covers Bucket should be set up to to the open-access bucket
    8. Protected Access content Bucket should be set up to the bucket with restricted access



2. Create a new collection in Circulation Manager and set up the following settings:

    1. Covers Mirror should be set up to the newly created S3 storage (it will appear in the dropdown only in the case you filled in Book Covers Bucket in S3 settings)
    2. Protected access mirror should be set up to the newly created S3 storage (it will appear in the dropdown only in the case you filled in Protected Access Content Bucket in S3 settings)
    3. URL signing should be set up to Sign URL and make them expirable



3. Import an ONIX collection into Circulation Manager

/bin/directory_import \
    --collection Manual \
    --collection-type PROTECTED_ACCESS \
    --data-source-name oapen \
    --metadata-format onix \
    --metadata-file ./onix_collection/onix2.xml \
    --ebook-directory ./onix_collection \
    --rights-uri http://librarysimplified.org/terms/rights-status

Please make sure that MARC/ONIX files, books and their covers are located on a local machine or at a network reachable location (for example, a file share in LAN).

4. Update the search index: 

/bin/search_index_refresh

5. Try to download a book and Circulation Manager must generate a pre signed URL

  • No labels