Page History

...

1. If upgrading from 6.x or below, install the new User Interface per the Installing DSpace guide. The JSPUI and XMLUI are no longer supported and cannot work with the DSpace 7 backend. You will need to install the new (Angular.io) User Interface.
   1. JSPUI or XMLUI based themes cannot be migrated.  That said, since the new Angular UI also uses Bootstrap, you may be able to borrow some basic CSS from your old themes.  But any HTML-level changes will need to be reimplemented in the new UI.
2. If upgrading from a prior version of 7.x, upgrading just requires installing the latest version of the User Interface code
   1. Download the the latest dspace-angular release from the DSpace GitHub repository. You can choose to either download the zip or tar.gz file provided by GitHub, or you can use "git" to checkout the appropriate tag (e.g. dspace-7.1) or branch.
      1. If you've cloned or copied this code into your own GitHub or GitLab repository, you may wish to simply pull the latest tagged code into your codebase using Git. That will allow you to more easily address any "code conflicts" between your local changes and the new version of DSpace (if any are found).

   2. Install any updated local dependencies using Yarn in the "dspace-angular" source code directory:

      Code Block
      # change directory to our repo cd dspace-angular # install/update the local dependencies yarn install

      
      

   3. (Optional) Review changes to the "environment.common.ts" Configuration changes to see if you wish to update any new configurations
      1. In 7.1, we added the ability to "extend" themes in the "themes" section. See the User Interface Configuration documentation for details.

   4. Build the latest User Interface code for Production:

      Code Block
      yarn run build:prod

      
      

   5. Restart the User Interface  Interface.  

      1. If you are using PM2 as described in the Installing DSpace instructions, you'd stop it and then start it back up:

         Code Block
         pm2 stop dspace-angular.json pm2 start dspace-angular.json

         
         

      2. If you are using a different approach, you simply need to stop the running UI, and re-run yarn run serve:ssr
   6. Verify the UI and REST API are both working properly.
      1. If you hit errors, see the "Troubleshooting Upgrade Issues" section below.  Additionally, check the "Common Installation Issues" section of the Installing DSpace documentation for other common misconfiguration or setup issues.

...