Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Minor updates for DSpace 9

...

Warning
titleWarning
Please note that DSpace 9.0-rc1 (9.0 first release candidate) is scheduled to be released on Friday, April 4.  This early release is only meant to be used for the DSpace 9.0 Testathon

Overview

DSpace 9 brings new features and major updates to the DSpace platform.  See the DSpace 9 Release Notes for more information on this release.

...

  1. First, you will need to install the necessary prerequisites.
    1. Git is required.  If you do not already have it installed (try running git version at your command line), you can install it via https://git-scm.com/downloads (or via your local package manager tools for Linux or Mac OS)
    2. Node.js (v18 or v20 or v22) is required.
      1. NPM (v8.x or above) is required.  Don't worry, this gets installed with Node.js though, so you don't need to do anything extra here.
      Yarn (v1.x) package manage.  Just install the latest stable version of 1.x
    3. NOTE: DSpace 9.0 does not  use Yarn.  Instead, you will use "npm" for all build commands.  Yarn is only used for DSpace 7 and 8.
  2. Then, download our "dspace-angular" application (which is the DSpace user interface) and run it.  All you should need to do is the steps in the "Quick Start" at: https://github.com/DSpace/dspace-angular/#quick-start

    Code Block
    # clone the repo
    git clone https://github.com/DSpace/dspace-angular.git
    
    # change directory to our repo
    cd dspace-angular
    
    # Switch to the main branch (pre-8.0 code)
    git checkout main
    
    # install the local dependencies
    yarnnpm install
    
    # start the server
    yarnnpm start


  3. After a few minutes, the user interface will be running on your local machine.  Again, it will be accessing the REST API Demo site, so a stable internet connection is required.
    1. User Interface: http://localhost:4000/
    2. REST API (remote demo site): https://sandbox.dspace.org/server/
    3. Admin Login: dspacedemo+admin@gmail.com, Password: dspace
    4. Submitter Login: dspacedemo+submit@gmail.com, Password: dspace
  4. Objects/Pages of interest (within the test data):
    1. Journal Example represents a journal with journal volumes, issues and articles, as detailed in the Configurable Entities Design.
    2. 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.
    3. Submission/Workflow functionality can be tested using 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.
    4. Once logged in, MyDSpace functionality is found in the user menu (upper right).  Submissions can be started from that page, or via the "New → Item" admin menu (if logged in as an Admin)
  5. One you are done testing, you can stop the locally running DSpace 9 user interface via Ctrl+C

Install both the User Interface and REST API locally

The DSpace 8 9 installation guide describes manually installing both the frontend (User Interface) and backend (REST API) of DSpace on a local machine. The frontend and backend need not be installed on the same machine.

...