Skip to content

TAMULib/SAGE

Folders and files

NameName
Last commit message
Last commit date

Latest commit

eb6c5dc · Oct 17, 2024
Oct 17, 2024
Feb 16, 2023
Sep 13, 2023
Sep 23, 2022
Aug 10, 2023
Sep 28, 2023
Aug 5, 2022
Aug 30, 2023
Jul 25, 2023
Mar 3, 2021
Aug 25, 2022
Jan 13, 2023
Sep 13, 2023
Aug 25, 2022
Aug 7, 2023
Aug 25, 2022
Dec 6, 2022
Aug 25, 2022
Sep 23, 2022
Aug 15, 2023
Sep 5, 2023

Repository files navigation

Build Status Coverage Status Performance Accessibility Best Practices SEO Progressive Web App

Search Aggregation Engine

Search Aggregation Engine (SAGE), consisting of a service back-end and a client front-end, is developed and maintained by Texas A&M University Libraries.

SAGE's feature set includes both the ability aggregate disparate searchable sources into a common Solr index, as well as the ability expose Solr indexes through a dynamic user interface.

User Documentation

SAGE user documentation can be found in the wiki.

For more technical users, deployment related configurations are described in the Deployment Guide.

Deployment

A quick and easy deployment method using docker-compose is described in the Deployment Guide.

For advanced use cases, or when docker-compose is unavailable, the use of docker or npm/mvn is also described in the Deployment Guide.

Deployment, in general, may look something like this:

Starting Solr

# Switch into solr directory.
cd solr/

# Create and use a local volume.
mkdir -vp volume/solr-data_var/data/sage-1_0
docker volume create solr-data_var
cp -vR configsets volume/solr-data_var/data/
cp -v core.properties volume/solr-data_var/data/sage-1_0/

# Run the Docker, using the desired pre-built image, such as solr:9.3.0-slim.
docker run --name local_solr --mount source=solr-data_var,target=/var/solr/ -p 8983:8983 -it solr:9.3.0-slim

Starting Sage

cp example.env .env
cp example.env.client .env.client
cp example.env.service .env.service

# Make any changes to the .env, .env.client, and .env.service files before here.
docker-compose up

* Note: It may be necessary to disable caching during build by passing --no-cache to the docker-compose up command.

Notes on Dependencies

SAGE utilizes the angular-openseadragon library when displaying some media types. This dependency was removed from npm, so the original JavaScript is now packaged in the SAGE code base at src/main/webapp/app/resources/scripts/ng-openseadragon/build/angular-openseadragon.js.

Additional Resources

Please feel free to file any issues concerning SAGE to the issues section of the repository.

Any questions concerning SAGE can be directed to helpdesk@library.tamu.edu.

Copyright © 2022 Texas A&M University Libraries under the MIT License.