Running DSpace 7 With Entities

Our recommended Docker installation instructions are here. Be sure to configure Docker with at least 6G of RAM when running this test.

A test dataset exists to illustrate the functionality of DSpace Configurable Entities .

An optional docker compose file exists to trigger the population of new DSpace containers with this content.

Go to the Docker Compose Directory

cd
cd DSpace-Docker-Images/docker-compose-files/dspace-compose

Ingest the Entities Test Dataset and Start DSpace 7 (localhost setup)

These instructions describe how to run DSpace in Docker on your local PC, Mac or Linux desktop. This is the most common deployment option. This option is suitable for personal testing of DSpace.

To run the DSpace 7 Preview Release images.

docker-compose -p d7 -f docker-compose.yml -f d7.override.yml -f d7.preview.yml -f load.entities.yml pull
docker-compose -p d7 -f docker-compose.yml -f d7.override.yml -f d7.preview.yml -f load.entities.yml up -d

To run the latest DSpace 7 images.

docker-compose -p d7 -f docker-compose.yml -f d7.override.yml -f load.entities.yml pull
docker-compose -p d7 -f docker-compose.yml -f d7.override.yml -f load.entities.yml up -d

Verify that DSpace is Running

docker ps

It will take approximately 5 minutes for the services to start completely. Once they have started, you can view them on the web.

Ingest the Entities Test Dataset and Start DSpace 7 (Server Setup)

These instructions describe how to run DSpace in Docker on a remote server or cloud server. This option is most suitable for sharing a DSpace instance with your colleagues.

Edit Angular environment.dev.js on your server.
Replace locahost with your server’s hostname.

To run the DSpace 7 Preview Release images.

export BASEROOT=http://<server-dns>:8080
docker-compose -p d7 -f docker-compose.yml -f d7.override.yml -f d7.preview.yml -f load.entities.yml pull
docker-compose -p d7 -f docker-compose.yml -f d7.override.yml -f d7.preview.yml -f load.entities.yml up -d

To run the latest DSpace 7 images.

export BASEROOT=http://<server-dns>:8080
docker-compose -p d7 -f docker-compose.yml -f d7.override.yml -f load.entities.yml pull
docker-compose -p d7 -f docker-compose.yml -f d7.override.yml -f load.entities.yml up -d

To stop the services

docker-compose -p d7ent -f docker-compose.yml -f d7.override.yml -f d7.preview.yml -f load.entities.yml down

Verify that DSpace has stopped

docker ps

On subsequent restart, you do not need the load.entities.yml file

To run the DSpace 7 Preview Release images.

docker-compose -p d7ent -f docker-compose.yml -f d7.override.yml -f d7.preview.yml up -d

To run the latest DSpace 7 images.

docker-compose -p d7ent -f docker-compose.yml -f d7.override.yml up -d

Testing the entities functionality

Test User credentials

e-mail password
dspacedemo+submit@gmail.com dspace
dspacedemo+admin@gmail.com dspace
dspacedemo+acceptreject@gmail.com dspace
dspacedemo+acceptrejectedit@gmail.com dspace
dspacedemo+edit@gmail.com dspace

Note about indexing

After the applications have started, discovery reindexing will start. This will require approximately 5 minutes as well. You can view the status here. Once complete, the index should contain 462 totalElements.

Search Results

Collections of interest

Next steps

See Common Tasks for additional actions you can take with your DSpace instance.

Delete docker Volumes

This will allow you to build a fresh installation with new data.

docker volume rm d7_assetstore d7_pgdata d7_solr_authority d7_solr_oai d7_solr_search d7_solr_statistics