Info |
---|
title | Online Version of Documentation also available |
---|
|
This documentation was produced with Confluence software. A PDF version was generated directly from Confluence. An online, updated version of this 7.x Documentation is also available at: https://wiki.lyrasis.org/display/DSDOC7x |
Welcome to Release 7.0, the next major release of the DSpace platform. Any previous version of DSpace may be upgraded to DSpace 7 directly. For more information, please see Upgrading DSpace.
7.0 Beta 3 Release Notes
Warning |
---|
title | Do not install a Beta release in Production! |
---|
|
DSpace 7 is still under active development. As a Beta release, we do not recommend installing this in production. Rather, we ask that you consider installing it in a test environment, try it out, and report back any issues or bugs you notice via GitHub (UI issues, Backend/API issues) |
Upgrade from any past version of DSpace! |
|
Installing DSpace provides an overview of the DSpace 7 installation process and all prerequisite software. You should review this before attempting an upgrade, in order to ensure you are running the required versions of Java, Node, etc. Upgrading DSpace provides a guide for upgrading from any old version of DSpace to v7. As in the past, your data migrates automatically, no matter which older version you are running. However, as the old XMLUI and JSPUI user interfaces are no longer supported, you must switch to using the new User Interface. |
7.6.1 Release Notes
Info |
---|
title | DSpace 7.6.1 was released on November 15, 2023 |
---|
|
To try out DSpace 7.6.1 immediately, see Try out DSpace 7. This includes instructions for a quick-install via Docker, as well as information on our DSpace demo site. To upgrade to DSpace 7.6.1 from 7.x or any prior version, see Upgrading DSpace - To upgrade to 7.6.1, you MUST upgrade both the backend and frontend (user interface). Many bug fixes require updating both.
To install DSpace 7.6.1 for the first time, see Installing DSpace. - Download DSpace 7.6.1 Backend:
|
Info |
---|
title | Get Started / Try it out! |
---|
|
To try out DSpace 7.0 Beta 3 immediately, see Try out DSpace 7 Full (manual) installation instructions are also available at Installing DSpace. For more information on the upcoming Beta and Final release schedule see DSpace 7 Release Goals. |
Included in Beta 3
DSpace 7.6.1 provides bug fixes & performance improvements to the 7.6.x platform. No new features are provided. As such this release should be an easier upgrade for sites already running 7.6.
Major bug fixes / improvements include:
- Performance improvements
- General fixes
- Processes Admin UI allows Administrators to run backend scripts/processes while monitoring their progress & completion. (Login as an Admin, select "Processes" in sidebar)
- Currently supported processes include "index-discovery" (reindex site), "metadata-export" (batch metadata editing CSV export), and "metadata-import" (batch metadata editing CSV import).
- Manage Account Profile allows logged in users to update their name, language or password. (Login, click on the account icon, and select "Profile")
- Includes "Register for a new account" and "Reset Password", both available on the Login screen.
- Login As (Impersonate) another account allows Administrators to debug issues that a specific user is seeing, or do some work on behalf of that user. Requires "webui.user.assumelogin=true" to be set in your local.cfg on backend. (Login as an Admin, Click "Access Control" in sidebar, Click "People". Search for the user account & edit it. Click the "Impersonate EPerson" button. You will be authenticated as that user until you click "Stop Impersonating EPerson" in the upper right.)
- Manage Authorization Policies of an Item allows Administrators to directly change/update the access policies of an Item, its Bundles or Bitstreams. (Login as an Admin, Click "Edit" → "Item" in sidebar, and search for the Item. Click the "Authorization.." button on its "Status" tab.
- Manage Item Templates of a Collection allows Administrators to create/manage template metadata that all new Items will start with when submitted to that Collection. (Login as an Admin, Click "Edit" → "Collection" in sidebar and search for the Collection. Click the "Add" button under "Template Item" to get started.)
- Administer Active Workflows allows Administrators to see every submission that is currently in the workflow approval process. From there, they have the option to delete Items (if they are no longer needed), or send them back to the workflow pool (to allow another user to review them). (Login as an Admin, Click "Administer Workflow" in sidebar)
- CC License step allows your users to select a Creative Commons License as part of their submission. Once enabled in the "item-submission.xml" (on the backend) it appears as part of the submission form.
- Angular CLI compatibility was added to the User Interface. This allows developers to easily update the User Interface using standard Angular commandline tools. More information (including tutorials) is available at https://cli.angular.io/
- English, Latvian, Dutch, German, French, Portuguese, Spanish and Finnish language catalogs
- Numerous bugs were fixed based on early user testing. (Thanks to all who've tested Beta 1 or Beta 2 and reported your feedback!) Some bugs fixed include:
- Login/Logout session fixes (including compatibility with Firefox and Safari browsers)
- Improved Community/Collection tree browsing performance
- Fixes to editing Communities, Collections and Items. This includes improved drag & drop reordering of bitstreams in an Item.
- Improved performance of Collection dropdown in submission
- Ability to download restricted bitstreams (previously these would error out)
- Authorization & security improvements in both REST API and UI
- Upgraded all REST API dependencies (Spring, Spring Boot, HAL Browser) and enhanced our automated testing via additional Integration Tests.
- All features previous mentioned in 104566901 and 104566901 below
Coming Soon
- For the upcoming Beta release schedule see DSpace 7 Release Goals
Additional Resources
At this time, the DSpace 7 documentation is still in progress, but has begun at https://wiki.lyrasis.org/display/DSDOC7x/
That said, we have a number of recorded presentations and workshops available which provide an overview of all the new 7.0 features.
- Presentations / Workshops from OR2019 (June 2019). Some video recordings exist https://wiki.lyrasis.org/display/DSPACE/DSpace+7+at+OR2019
- Getting Started with DSpace 7 Workshop at the North American User Group Meeting (Sept 2019). Includes slides, workshop materials & a video recording. https://wiki.lyrasis.org/display/DSPACE/2019+DSpace+North+American+User+Group+Meeting
- Additional DSpace 7 presentations/workshops/webinars are planned for 2020 as we get closer to the 7.0 final release.
7.0 Beta 2 Release Notes
Included in Beta 2
- Administrative Search (video) combines retrieval of withdrawn items and private items, together with a series of quick action buttons.
- EPeople, Groups and Roles can now be viewed, created and updated.
- Manage Groups (Login as an Admin → Access Control → Groups)
- Manage EPeople (Login as an Admin → Access Control → EPeople)
- Manage Community/Collection Roles (Login as an Admin → Edit Community/Collection → Assign Roles). Note: this feature is Admin-only in beta 2, but will be extended to Community/Collection Admins in beta 3.
- Bitstream Editing (video) has a drag-and-drop interface for re-ordering bitstreams and makes adding and editing bitstreams more intuitive.
- Metadata Editing (video) introduces suggest-as-you-type for field name selection of new metadata.
- Update Profile / Change Password (Login → Select user menu in upper right → Profile)
- Shibboleth Authentication
- Viewing Item Version History (requires upgrading from a 6.x site that includes Item Versioning)
- Collection and Community (video) creation and edit pages.
- English, Latvian, Dutch, German, French, Portuguese and Spanish language catalogs
- Security and authorization improvements, including REST API support hiding specific metadata fields (metadata.hide property) and upgrades of different software packages on which DSpace 7 depends.
- All features previous mentioned in 104566901 below
Coming Soon
- For the upcoming Beta release schedule see DSpace 7 Release Goals
Additional Resources
At this time, the DSpace 7 documentation is still in progress, but has begun at https://wiki.lyrasis.org/display/DSDOC7x/
That said, we have a number of recorded presentations and workshops available which provide an overview of all the new 7.0 features.
- Presentations / Workshops from OR2019 (June 2019). Some video recordings exist https://wiki.lyrasis.org/display/DSPACE/DSpace+7+at+OR2019
- Getting Started with DSpace 7 Workshop at the North American User Group Meeting (Sept 2019). Includes slides, workshop materials & a video recording. https://wiki.lyrasis.org/display/DSPACE/2019+DSpace+North+American+User+Group+Meeting
- Additional DSpace 7 presentations/workshops/webinars are planned for 2020 as we get closer to the 7.0 final release.
A full list of all changes / bug fixes in 7.x is available in the Changes in 7.x section.
7.0 Beta 1 Release Notes
New features to look for
- Item view fixes
- Browse/Search fixes
- Submission/Workflow form fixes
- Authentication fixes
- Admin tools fixes
- Statistics fixes
- Theming fixes
- Search Engine Optimization fixes
- Accessibility fixes
- A completely new User Interface (demo site). This is the new Javascript-based frontend, built on Angular.io (with support for SEO provided by Angular Universal). This new interface is also via HTML and CSS (SCSS). For early theme building training, see the “Getting Started with DSpace 7 Workshop” from the North American User Group meeting: slides or video recording.
- A completely new, fully featured REST API (demo site), provided via a single "server" webapp backend. This new backend is not only a REST API, but also still supports OAI-PMH, SWORD (v1 or v2) and RDF. See the REST API's documentation / contract at
- Fixes to accessibility of Community List (/community-list) page.
Rest7Contractblob/master/README.md - A newly designed search box. Search from the header of any page (click the magnifying glass). The search results page now features automatic search highlight, expandable & searchable filters, and optional thumbnail-based results (click on the “grid” view).
- A new MyDSpace area, including a new, one-page, drag & drop submission form, a new workflow approval process, and searchable past submissions. (Login, click on your user profile icon, click “MyDSpace”). Find workflow tasks to claim by selecting “All tasks” in the “Show” dropdown.
- Dynamic user interface translations (Click the globe, and select a language). Anyone interested in adding more translations? See DSpace 7 Translation - Internationalization (i18n) - Localization (l10n).
- A new Admin sidebar. Login as an Administrator, and an administrative sidebar appears. Use this to create a new Community/Collection/Item, edit existing ones, and manage registries. (NOTE: A number of Administrative tools are still missing or greyed out. They will be coming in future Beta releases.)
- Optional, new Configurable Entities feature. DSpace now supports “entities”, which are DSpace Items of a specific ‘type’ which may have relationships to other entities. These entity types and relationships are configurable, with two examples coming out-of-the-box: a set of Journal hierarchy entities (Journal, Volume, Issue, Publication) and a set of Research entities (Publication, Project, Person, OrgUnit). For more information see “The Power of Configurable Entities” from OR2019: slides or video recording. Additionally, a test data set featuring both out-of-the-box examples can be used when trying out DSpace 7 via Docker. Early documentation is available at Configurable Entities.
- Support for OpenAIREv4 Guidelines for Literature Repositories in OAI-PMH (See the new “openaire4” context in OAI-PMH).
Additional major changes to be aware of in the 7.x platform (not an exhaustive list):
- XMLUI and JSPUI are no longer supported or distributed with DSpace. All users should immediately migrate to and utilize the new Angular User Interface. There is no migration path from either the XMLUI or JSPUI to the new User interface. However, the new user interface can be themed via HTML and CSS (SCSS).
- The old REST API ("rest" webapp from DSpace v4.x-6.x) is deprecated and will be removed in v8.x. The new REST API (provided in the "server" webapp) replaces all functionality available in the older REST API. If you have tools that rely on the old REST API, you can still (optionally) build & deploy it alongside the "server" webapp via the "-Pdspace-rest" Maven flag.
- The Submission Form configuration has changed. The "item-submission.xml" file has changed its structure, and the "input-forms.xml" has been replaced by a "submission-forms.xml". For early documentation see Configuration changes in the submission process (FULL DOCUMENTATION COMING SOON)
- ElasticSearch Usage Statistics have been removed. Please use SOLR Statistics or DSpace Google Analytics Statistics.
- The traditional, 3-step Workflow system has been removed in favor of the Configurable Workflow System. For most users, you should see no effect or difference. The default setup for this Configurable Workflow System is identical to the traditional, 3-step workflow ("Approve/Reject", "Approve/Reject/Edit Metadata", "Edit Metadata")
- Apache Solr is no longer embedded within the DSpace installer (and has been upgraded to Solr v7). Solr now MUST be installed as a separate dependency alongside the DSpace backend. See Installing DSpace.
- Some command-line tools/scripts are enabled in the new REST API (e.g. index-discovery): See new Scripts endpoint: https://github.com/DSpace/Rest7Contract/blob/master/scripts-endpoint.md
- DSpace now has a single, backend "server" webapp to deploy in Tomcat (or similar). In DSpace 6.x and below, different machine interfaces (OAI-PMH, SWORD v1 or v2, RDF, REST API) were provided via separate deployable webapps. Now, all those interfaces along with the new REST API are in a single, "server" webapp built on Spring Boot. You can now control which interfaces are enabled, and what path they appear on via configuration (e.g. "oai.enabled=true" and "oai.path=oai"). See https://jira.lyrasis.org/browse/DS-4257 (FULL DOCUMENTATION COMING SOON)
- Configuration has been upgraded to Apache Commons Configuration version 2. For most users, you should see no effect or difference. No DSpace configuration files were modified during this upgrade and no configurations or settings were renamed or changed. However, if you locally modified or customized the
[dspace]/config/config-definition.xml
(DSpace's Apache Commons Configuration settings), you will need to ensure those modifications are compatible with Apache Commons Configuration version 2. See the Apache Commons Configuration's configuration definition file reference for more details. - DSpace now has sample Docker images (configurations) which can be used to try out DSpace quickly. See Try out DSpace 7 ("Install via Docker" section)
Additional Resources
At this time, the DSpace 7 documentation is still in progress, but has begun at https://wiki.lyrasis.org/display/DSDOC7x/
That said, we have a number of recorded presentations and workshops available which provide an overview of all the new 7.0 features.
- Presentations / Workshops from OR2019 (June 2019). Some video recordings exist https://wiki.lyrasis.org/display/DSPACE/DSpace+7+at+OR2019
- Getting Started with DSpace 7 Workshop at the North American User Group Meeting (Sept 2019). Includes slides, workshop materials & a video recording. https://wiki.lyrasis.org/display/DSPACE/2019+DSpace+North+American+User+Group+Meeting
- Additional DSpace 7 presentations/workshops/webinars are planned for 2020
- Translation bug fixes
- Replication Task Suite version 7.6 has been released to add compatibility with all DSpace 7.6.x releases. This Maven plugin can be used to provide extra curation tasks for AIP Backup and Restore.
- Many other bug fixes and dependency updates as listed in Changes in 7.x.
Updated Language support:
- Finnish (Suomi) translation updates donated by Reeta Kuukoski (reetagithub)
- Italian (Italiano) language updates donated by 4Science
- Polish (Polski) translation updates donated by Michał Dykas (michdyk)
- Brazilian Portuguese (Português do Brasil) updates donated by Marco Aurelio Cardoso (marcoaureliocardoso)
- Portugese (Português) language updates donated by José Carvalho (j-n-c)
- (New) Serbian Cyrillic (Српски) language translations donated by Milos Ivanovic (imilos)
- (New) Serbian Latin (Srpski (lat)) language translations donated by Milos Ivanovic (imilos)
- Spanish (Español) translation updates donated by Arvo Consultores
7.6.1 Acknowledgments
The DSpace application would not exist without the hard work and support of its community. Thank you to the many developers who have worked very hard to deliver all the bug fixes and improvements. This release was entirely volunteer driven!
Development Acknowledgments
A total of 38 unique individuals contributed to 7.6.1.
Frontend / User Interface Acknowledgments
The following 29 individuals have contributed directly to the new DSpace (Angular) User Interface in this release (ordered by number of GitHub commits): Alexandre Vryghem (alexandrevryghem), Tim Donohue (tdonohue), Hugo Daniel Dominguez de la Cruz (hugo-escire), Davide Negretti (davide-negretti), Vladzislav Novski (vNovski), Eike Löhden (Leano1998), Hrafn Malmquist (J4bbi), Paulo Graça (paulo-graca), Art Lowel (artlowel), Michał Dykas (michdyk), Alan Orth (alanorth), Kristof De Langhe (Atmire-Kristof), Milos Ivanovic (imilos), Mirko Scherf (mirkoscherf), Sascha Szott (saschaszott), Mark Wood (mwoodiupui), William Welling (wwtamu), Lotte Hofstede (LotteHofstede), Flo (floriangantner), Hardy Pottinger (hardyoyo), Sergio Fernández Celorio (sergius02), Yury Bondarenko (ybnd), Agustina Martinez (amgciadev), Reeta Kuukoski (reetagithub), Nona Luypaert (nona-luypaert), Kim Shepherd (kshepherd), Yana De Pauw (YanaDePauw), Marie Verdonck (MarieVerdonck)
The above contributor lists were determined based on contributions to the "dspace-angular" project in GitHub between 7.6 (after June 23, 2023) and 7.6.1: https://github.com/DSpace/dspace-angular/graphs/contributors?from=2023-06-23&to=2023-11-15&type=c
Backend / REST API Acknowledgments
The following 20 individuals have contributed directly to the DSpace backend (REST API, Java API, OAI-PMH, etc.) in this release (ordered by number of GitHub commits): Tim Donohue (tdonohue), Agustina Martinez (amgciadev), Mark Wood (mwoodiupui), Paulo Graça (paulo-graca), Toni Prieto (toniprieto), Adán Román Ruiz (aroman-arvo), Christian Bethge (ChrisBethgster), Alan Orth (alanorth), Nicholas Woodward (nwoodward), Nona Luypaert (nona-luypaert), Alexandre Vryghem (alexandrevryghem), Hrafn Malmquist (J4bbi), Andrea Bollini (abollini), Luca Giamminonni (LucaGiamminonni), damian-joz, Michael Spalti (mspalti),