README

A docker compose demo that will allow you to spin up a test instance of blacklight in a flash.

Ruby version

3.0.3

System dependencies

Docker, Docker-compose

Configuration

See: https://github.com/projectblacklight/blacklight/wiki

Deployment instructions

Local Deployment

docker compose up -d

(On first run only, to get container name if your folder name is different) docker container ls

(On first run only) docker exec -it demo-blacklight-solr-1 solr create_core -c blacklight

Create full_txt field in blacklight core

(On first run only) docker exec -it demo-blacklight-solr-1 solr create_core -c page

Create pkey field in page core Create page_txt field in page core

(On first run only) docker exec -it demo-blacklight-web-1 bash

(On first run only) rake solr:marc:index MARC_FILE=test.mrc rake solr:marc:index MARC_FILE=issues.mrc

(On first run only) docker logs demo-blacklight-web-1 --follow

(On first run only) Run this script to add page search - https://github.com/crkn-rcdr/crkn-scripting/blob/main/export-alto/export.py

Solr instance will be running at: http://solr:8983

Blacklight instance will be running at: http://localhost:3000

Swift will be running at: http://localhost:8080 (See docs for more info: https://hub.docker.com/r/jeantil/openstack-swift-keystone-docker/)

Go to the above link for Blacklight and run the db migrations by clicking the button.

See CRKN test data!

Notes:

• with docker compose up, use --force-recreate if you want to reset the contents of solr
• or use this Solr API curl command: curl -X POST -H 'Content-Type: application/json' 'http://crkn-solr.c7a.ca:8983/solr/blacklight/update?commit=true' -d '{ "delete": {"query":"*:*"} }' curl -X POST -H 'Content-Type: application/json' 'http://solr:8983/solr/blacklight/update?commit=true' -d '{ "delete": {"query":"*:*"} }' curl -X POST -H 'Content-Type: application/json' 'http://solr:8983/solr/blacklight/update?commit=true' -d '{ "delete": {"query":"*:*"} }' curl -X POST -H 'Content-Type: application/json' 'https://dolphin-app-p9llh.ondigitalocean.app/solr/blacklight/update?commit=true' -d '{ "delete": {"query":"*:*"} }'

To install new javascript libraries enter the docker container. docker exec -it demo-blacklight-web-1 bash

Then, run the importmap script, ex: ./bin/importmap pin react

Then remember to copy the contents of the new importmap file to your local machine. cat config/importmap.rb docker cp demo-blacklight-web-1:/app/vendor/javascript/ ./vendor/javascript

Or, add manually: pin "mirador", to: "https://unpkg.com/mirador@latest/dist/mirador.min.js"

Then download and add files to vendor/javascript.

docker run -v /root/demo-blacklight:/app demo-blacklight-web

Then, for shakapacker: docker exec -it demo-blacklight-web-1 bash

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

source ~/.bashrc && nvm install 18 && corepack enable && rails shakapacker:install

(n/n/n/y)

rails shakapacker:compile

exit docker container restart demo-blacklight-web-1

git add --all git commit

Out of space warning: docker system prune

Deploying to Digital Ocean

docker build . --no-cache docker tag '<image>' brilap/crkn docker push brilap/crkn

Reference:

https://workshop.projectblacklight.org/v7.11.1/solr-in-blacklight/ https://digitalcollections.library.harvard.edu/catalog/990071779400203941 https://catalog.library.cornell.edu/?f%5Bonline%5D%5B%5D=Online https://searchworks.stanford.edu/