Contribute to the DSpace Development Fund
The newly established DSpace Development Fund supports the development of new features prioritized by DSpace Governance. For a list of planned features see the fund wiki page.
Frequently Asked Questions (FAQs)
- End User FAQ - Attempts to address the most commonly asked questions regarding DSpace (from a user perspective)
- TechnicalFAQ - Attempts to address the most commonly asked technical or installation questions regarding DSpace
- Additional resources for common questions:
- Searching the Mailing Lists archives
- Searching the dspace tag on StackOverflow. Also see our Guide to Posting Technical Questions to StackOverflow
Repository Planning
- The following documents are useful in planning a repository. All are written by Mary R.Barton et al copyright 2004-2005 (RM).
- SUNScholar/Practical Guidelines for Starting an Institutional Repository. Produced by Stellenbosch University Library, this guide provides step-by-step information to help academic institutions in developing countries start an institutional repository.
- Lessons learned building an Institutional Repository with DSpace
Installing DSpace
- Start with the DSpace Documentation.
- Platform and distribution-specific tips and guides can be found on the DSpace Installation Guides page.
- en español: Instalación de Dspace: Deploy de un repositorio básico con Dspace 3.0
Customizing DSpace
- Past Training Materials & Workshops:
- DSpace Training Archives - This is our primary archive of past workshop/webinar materials.
- DuraSpace webinar archive, DuraSpace Slideshare - additional workshops/webinars hosted by DSpace
- DSpace YouTube - Some DSpace related videos (and past meetings/summaries)
- General Tips:
- How-To Guides has a list of all wiki pages which provide "how-to" hints for changing/customizing your DSpace install.
- Build Cookbook has examples of adding your local changes to a DSpace distribution.
- Additional training in spanish: Curso de capacitación en repositorios y DSpace by SeDiCi, Universidad de la Plata, Argentina
Developing with DSpace
- An overall reference for developing code with DSpace (and creating patches) is available on the Developer Guidelines and Tools page.
- Code Contribution Guidelines - How to get your code accepted into DSpace.
Documentation for New DSpace Administrators
- Intro to DSpace (August 19, 2009) - written by Cameron Kainerstorfer and Heather Perkins (both of University of Texas Southwestern Medical Center)
- The DSpace Course (August 2008) - written by Stuart Lewis and Chris Yates, funded by JISC and Repositories Support Project and was funded by JISC
- Instructions for New Admin - This is a simple guide to print off for people who will start uploading documents to your instance of DSpace, by Shawna Sadler.
DSpace Oracle to PostgreSQL migration
The following procedure is only one example of migration done from Version 6.3 to Version 7.2.
It has been made using Ora2pg: https://ora2pg.darold.net/documentation.html
- Install PERL: http://strawberryperl.com/
- Download Ora2Pg: https://sourceforge.net/projects/ora2pg/
- Unzip and access the file from the command line
- Install Ora2Pg :
perl Makefile.PL
gmake && gmake install - ora2pg files will be installed in Strawberry directory
- C:\Strawberry\perl\site\bin
- C:\ora2pg
Note : Do not use another path for Ora2Pg, otherwise configuration will not be made correctly in Strawberry Perl.
- Rename file « C:\ora2pg\ora2pg_conf.dist » en « ora2pg.conf »
- Modify variable ORACLE_HOME to point to Oracle client
- Modify string connexion to Oracle DB :
- User/Password
- ORACLE_DSN, ORACLE_USER, ORACLE_PWD
- TYPE = TABLE,SEQUENCE,INSERT
- UUID_FUNCTION = gen_random_uuid
- STOP_ON_ERROR = 0
- FKEY_DEFERRABLE = 1
- DEFER_FKEY = 1
- MODIFY_TYPE
bitstream:size_bytes:bigint,checksum_history:check_id:bigint,checksum_history:checksum_expected:varchar,checksum_history:checksum_calculated:varchar,checksum_history:result:varchar,checksum_results:result_code:varchar,checksum_results:result_description:varchar,harvested_collection:oai_source:varchar,harvested_collection:oai_set_id:varchar,harvested_collection:harvest_message:varchar,harvested_collection:metadata_config_id:varchar,harvested_collection:harvest_start_time:timestamp with time zone,harvested_collection:last_harvested:timestamp with time zone,harvested_item:last_harvested:timestamp with time zone,harvested_item:oai_id:varchar,item:last_modified:timestamp with time zone,metadatavalue:text_lang:varchar(24),most_recent_checksum:expected_checksum:varchar,most_recent_checksum:current_checksum:varchar,most_recent_checksum:checksum_algorithm:varchar,most_recent_checksum:result:varchar,resourcepolicy:start_date:date,resourcepolicy:end_date:date,webapp:url:varchar,webapp:isui:integer - REPLACE_AS_BOOLEAN NUMBER:1 CHAR:1
- DATA_TYPE NUMBER(*\,0):integer,VARCHAR2(2000):text
- SCHEMA DSPACE
Data migration procedure :
- Open command line and move to following directory:
C:\Strawberry\perl\site\bin. - Execute command line ora2pg to launch migration script from Oracle to SQL files for PostgresSQL objects creation.
- Create a database on PostgreSQL server
- Use extension « pgcrypto »
- And select an appropriate owner for the database (ex: dspace)
- Use extension « pgcrypto »
- Execute obtained SQL scripts as « dspace » using the above mentionned command in point 2.
- For a SQL script that is too large, it is necessary to use the following commands in admin mode:
- SET PGCLIENTENCODING=utf-8
- psql -h localhost -p 5432 -U dspace -d dspace -f INSERT_output.sql 1>out.txt 2>err.txt
Warning: You must have previously defined a password for the user “dspace”. When clicking on OK, you will be prompt for this password.
- Replace content of the « schema_version » table, doing a « truncate » and using the import function in the PostgreSQL admin tool. The file to import is csv. You will have to use “comma” as delimiter and select that there is a Header in the file. In the 2nd tab, use NULL as value for empty strings.
- Run scripts SQL_FUNCTIONS.sql and SQL_SEQUENCES.sql.
Note: These 2 file are a local one. - Run script 0__DS-2701_xml_workflow_migration.sql.
- Run script 0__DS-2701_data_workflow_migration.sql.
- Run script SQL_TABLES.sql.
Note: This file is a local one. - (Optionnal), backup the database and run the migration program to DSpace 7.2 as documented on DSpace 7 Documentation: https://wiki.lyrasis.org/display/DSDOC7x/Upgrading+DSpace.
Overview
Content Tools