MerMEId is a system for the editing, handling, and (pre-)viewing of music metadata, based on the the Music Encoding Initiative (MEI) XML schema. As of March 2019 MerMEId supports MEI 4.0.0.
MerMEId was originally developed at the Danish Centre for Music Editing (DCM) both for the production of thematic catalogues of works and for organizing source- and work-related information during the preparation of scholarly editions of music. It is now maintained as a community effort.
MerMEId is used for the creation and maintenance of
- Catalogue of Carl Nielsen's Works, CNW,
- Johann Adolph Scheibe. A Catalogue of His Works, and
- J.P.E. Hartmann. A Thematic-Bibliographic Catalogue of His Works
The services mentioned are delivered using DCM Catalog UI.
Try MerMEId at the demo website.
The most convenient way to set up MerMEId is by pulling the ready made Docker images from DockerHub.
Starting a MerMEId instance is simple:
$ docker run --name my-mermeid -p 8080:8080 -d edirom/mermeid:develop-java11-ShenGC… where my-mermeid is the name you want to assign to your container and 8080 is the local port where the MerMEId server will listen.
Example stack.yml for MerMEId:
version: '3'
services:
mermeid:
image: edirom/mermeid:develop-java11-ShenGC
ports:
- 8080:8080
environment:
- MERMEID_exist_endpoint=http://localhost:8080Run docker stack deploy -c stack.yml mermeid (or docker-compose -f stack.yml up),
wait for it to initialize completely, and visit http://localhost:8080.
The default credentials to log in to the MerMEId are username "mermeid" and password "mermeid".
When you start the MerMEId image, you can adjust the configuration of the MerMEId instance by passing one or more environment variables on the docker run command line.
In general, all settings from properties.xml can be overridden by providing the respective environment variable prefixed with 'MERMEID_'. Commonly used variables include:
this variable must reflect the deployment URL.
E.g., if you deploy MerMEId to https://my.mermeid.org the MERMEID_exist_endpoint variable must be set to https://my.mermeid.org as well.
provide an admin password. CAUTION: This will override any previously set password!
provide an admin password via a secrets file.
The environment variable MERMEID_admin_password_file must provide the path to that file within the container.
CAUTION: This will override any previously set password!
provide a password for the mermeid user (defaults to "mermeid"). CAUTION: This will override any previously set password!
provide a password for the mermeid user via a secrets file (defaults to "mermeid").
The environment variable MERMEID_mermeid_password_file must provide the path to that file within the container.
CAUTION: This will override any previously set password!
For running the MerMEId service in production you probably want to persist the data volume. Otherwise restarting the container might result in data loss!
The database files are stored within /exist/data in the container so you simply mount a host directory there:
$ docker run --name my-mermeid -p 8080:8080 -d --mount type=bind,source="$(pwd)/exist-data",target=/exist/data edirom/mermeid:develop-java11-ShenGC
Orbeon logs everything to stdout, so you can access them with docker logs my-mermeid. eXist-db writes most information into logfiles though, so in case you want to access them you should mount a host directory to /exist/logs like this:
$ docker run --name my-mermeid -p 8080:8080 -d --mount type=bind,source="$(pwd)/exist-logs",target=/exist/logs edirom/mermeid:develop-java11-ShenGC
A word of warning: It is always recommended to back up your data before
updating! eXist-db has various ways to do a full or partial backup, at least
you should save the files from the $data-dir (defaults to
/db/apps/mermeid-data).
Without a persistent data directory you can simply pull the updated Docker image and run it as described above.
When you start an updated Docker image and mount your data directory to it as described above, only the base image including eXist-db and Orbeon will be updated but not the MerMEId app. This needs to be done in a dedicated step via the eXist-db dashboard:
- Download the latest MerMEId xar package from the assets section at https://github.com/Edirom/MerMEId/releases, e.g.
mermeid-2.0.0-alpha.7.xar - Login as admin in the MerMEId or eXide app (needs to be done here due to a bug in the eXist-db dashboard)
- Open
http://localhost:8080/apps/dashboard/admin#/packagemanagerand drop the xar package in the blue section to upload and install it
The Dockerfile in this repository has a ARG for specifying a base image containing an exist-db. The reason for this is that we need different flavours of Java and exist-db to test with or for special deployment scenarios. If you just do the standard
docker build --tag edirom/mermeid:latest .
The official exist-db 6.0.1 container will be used as the base image but you can supply any image that is build using the same process instead. This is by running
mvn -Pdocker -DskipTests clean package
after checking out the particular version of exist 6.x to be built and changing the Dockerfile in
exist-docker/src/main/resources-filtered/Dockerfile as needed
docker build --build-arg EXISTDB_IMAGE=acdhch/existdb:6.0.1-java11-ShenGC --tag edirom/mermeid:java11-ShenGC .
When you run MerMEId on a production system and make it accessible from a public website, like with any other website please be advised to include an imprint page and a privacy policy that adheres to your applicable jurisdiction. Links to respective pages could for instance be included in the footer which can be configured in the ./properties.xml
In addition, here you can find information about running eXist-db on a production system: eXist-db documentation.
Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.