Skip to content

Latest commit

 

History

History
121 lines (87 loc) · 5.35 KB

run.DSpace7Entities.md

File metadata and controls

121 lines (87 loc) · 5.35 KB
Raw

{% include nav.html %}

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
[email protected] dspace
[email protected] dspace
[email protected] dspace
[email protected] dspace
[email protected] 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

  • Journal Example represents a journal with journal volumes, issues and articles, as detailed in the Configurable Entities Design.
  • Publications Example contains publications which contain a combination of plain-text authors and related author entities. It also contains relations to Research Projects and Organizational Units, as detailed in the Configurable Entities design. Navigating to e.g. a Person will reveal their relations to Publications, Research Projects and Organizational Units.
  • The submission can be verified in one of the collections in this community where the workflow is enabled. You can use the accounts mentioned above to perform the submission and workflow steps. The admin account can perform the submission and all workflow steps as well.

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