exercise4.md

{% include nav.wkshop.html %}

Exercise 4: Running DSpace 7 with Docker-Compose

• Running DSpace 7
• Running DSpace 7 with entities

Start DSpace 7

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

Verify that DSpace is Running

docker ps

It will take 3-5 minutes for the services to start completely.

You can track the startup with the following command. Hit Ctrl-C to exit the log output.

docker logs -f dspace

Once the services have started, you can view them on the web. The first time you start DSpace, it will load some default AIP content. This process takes an additional 3-5 minutes.

• REST API: http://localhost:8080/spring-rest
• Angular UI: http://localhost:3000

Explore the HAL Browser and the Angular UI.

docker-compose -p d7 -f docker-compose.yml -f d7.override.yml down

Start the DSpace 7 Preview Release with the Entities Dataset

Note that we will create a separate set of DSpace 7 entities (-p d7ent) for this step.

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

Verify that DSpace is Running

docker ps

You can track the startup with the following command. Hit Ctrl-C to exit the log output.

docker logs -f dspace

It will take 3-5 minutes for the services to start completely. Once they have started, you can view them on the web. The first time you start DSpace, it will load some default AIP content. This process takes an additional 3-5 minutes.

• REST API: http://localhost:8080/spring-rest
• Angular UI: http://localhost:3000

Explore the HAL Browser and the Angular UI. See Testing Entities Data for additional testing notes.

Shutdown DSpace 7.

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

Run DSpace 7 with a modified (published image)

For this test, we are going to use a tagged version of the DSpace image.

• Open https://hub.docker.com/r/dspace/dspace/tags to explore the available images
  • Look for or2019-workshop-7x
  • Pull Request Used to Create This Image

Set the variable DSPACE_VER to select a different image.

DSPACE_VER=or2019-workshop-7x docker-compose -p d7 -f docker-compose.yml -f d7.override.yml config | grep image:

Run the following commands to start DSpace with this image.

DSPACE_VER=or2019-workshop-7x docker-compose -p d7 -f docker-compose.yml -f d7.override.yml pull
DSPACE_VER=or2019-workshop-7x docker-compose -p d7 -f docker-compose.yml -f d7.override.yml up -d

Open the REST HAL Browser and notice the change listed in the Properties Section.

Override Angular Image

Shutdown your running copy of DSpace

docker-compose -p d7 -f docker-compose.yml -f d7.override.yml down

For this test, we are going to use a tagged version of the DSpace image.

• Open https://hub.docker.com/r/dspace/dspace-angular/tags to explore the available images
  • Look for or2019-workshop-7x
  • Pull Request Used to Create This Image

Set the variable ANGULAR_VER to select a different image.

ANGULAR_VER=or2019-workshop-7x docker-compose -p d7 -f docker-compose.yml -f d7.override.yml config | grep image:

Run the following commands to start DSpace with this image.

ANGULAR_VER=or2019-workshop-7x docker-compose -p d7 -f docker-compose.yml -f d7.override.yml pull
ANGULAR_VER=or2019-workshop-7x docker-compose -p d7 -f docker-compose.yml -f d7.override.yml up -d

Open the Angular UI and notice the change in the text color.