National Workshop on Institutional Digital Repository (NDL) Project Samrat Guha Roy Assistant Librarian, Central Library IIT Kharagpur Email : samrat@library.iitkgp.ernet.in
DSpace Installation
Setup DSpace Environment Variables Login as dspace user 2. Copy the content [IDR.tar.gz] file of CD/WebSite to your Desktop 3. Untar the file under the folder /home/dspace/ 4. Copy the bash_profile contents to /home/dspace/.bash_profile 5. Install the PostgreSQL RDBMS using the command a. chmod 777 /home/dspace/IDR/postgresql-9.4.2-1-linux-x64.run b. $ su Password: ndl123 # /home/dspace/IDR/postgresql-9.4.2-1-linux-x64.run c. Click on next to continue and give dspace123 as root password
Create Database and User Execute �pgadmin III : Click on Applications - > Postgre SQL 9.4 - > pgadmin III a. Give password as dspace123 b. Create a new dspace user with password dspace123 c. Create a new database as �dspace� and owner as �dspace�
DSpace Checking Prerequisites $ java –version $ ant –version $ mvn –version $ echo $JAVA_HOME $ echo $M2_HOME Create a folder under the directory /home/dspace/ as dspace_inst
Edit build.properties file Browse to /dspace/home/IDR/dspace-5.2-src-release/build.properties # DSpace installation directory. dspace.install.dir= /home/dspace/dspace-inst # Name of the site dspace.name = DSpace @ <your University Name> # DATABASE CONFIGURATION db.password=dspace123 # HANDLE CONFIGURATION # handle.canonical.prefix = ${dspace.url}/handle/ #handle.canonical.prefix = http://hdl.handle.net/
DSpace mvn packaging $ cd /home/dspace/IDR/ dspace-5.2-src-release $ mvn package Sample Output [INFO] BUILD SUCCESS
Ant Fresh Installation of DSpace $ cd /home/dspace/dspace-5.2-src-release/dspace/target/dspace-5.2-build.dir/dspace-3.1-build $ ant fresh_install Sample Output [INFO] BUILD SUCCESS
Creating Administrator account $ /home/dspace/dspace_inst/bin/dspace create-administrator Now Final Step Create Context Paths of all web applications from web site Download server.xml and paste it on the Tomcat Config Folder - /home/dspace/IDR/apache-tomcat-8.0.23/config Start the apache tomcat – $ /home/dspace/IDR/apache-tomcat-8.0.23/bin/startup.sh
Browse Dspace Home Page You should then be able to access your DSpace's 'home page' in Morzill firefox: http://localhost:8080/xmlui
Metadata Registration
Metadata Registry – Editing Steps Login as Administrator Click on Metadata Click on the namespace i.e dc Enter the new metadata elements
1. Create Two metadata elements as mentioned below dc.subject.pedagogicobjective Enter the pedagogic objective in this field dc.type.typeoflearningmaterial Enter the type of learning material in this field 2. Edit /home/dspace/dspace_inst/config/input-forms.xml and add the following lines <field><dc-schema>dc</dc-schema><dc-element>subject</dc-element><dc-qualifier>pedagogicobjective</dc-qualifier><repeatable>false</repeatable><label>Pedagogic Objective</label><input-type>onebox</input-type><hint>Educational purpose of learning material being described(e.g. Three to four objectives seperated by semicolon).</hint><required/></field> <field><dc-schema>dc</dc-schema><dc-element>type</dc-element><dc-qualifier>typeoflearningmaterial</dc-qualifier><repeatable>true</repeatable><label>Type of Learning Material</label><input-type value-pairs-name="common_learningmaterial_types">dropdown</input-type><hint>Enter the name of the learning material types.</hint><required/></field>
<value-pairs value-pairs-name="common_learningmaterial_types" dc-term="type_typeoflearningmaterial"><pair><displayed-value>Text book</displayed-value><stored-value>Textbook</stored-value></pair><pair><displayed-value>Video Lecture</displayed-value><stored-value>Video Lecture</stored-value></pair><pair><displayed-value>Audio Lecture</displayed-value><stored-value>Audio Lecture</stored-value></pair><pair><displayed-value>Excercise</displayed-value><stored-value>Excercise</stored-value></pair><pair><displayed-value>Solution</displayed-value><stored-value>Solution</stored-value></pair><pair><displayed-value>Quiz</displayed-value><stored-value>Quiz</stored-value></pair><pair><displayed-value>Animation</displayed-value><stored-value>Animation</stored-value></pair><pair><displayed-value>Simulation</displayed-value><stored-value>Simulation</stored-value></pair><pair><displayed-value>Class Note</displayed-value><stored-value>Class Note</stored-value></pair><pair><displayed-value>Data Set</displayed-value><stored-value>Data Set</stored-value></pair><pair><displayed-value>Experiment</displayed-value><stored-value>Experiment</stored-value></pair><pair><displayed-value>Self Assessment</displayed-value><stored-value>Self Assessment</stored-value></pair><pair><displayed-value>Tutorial</displayed-value><stored-value>Tutorial</stored-value></pair><pair><displayed-value>Question Set</displayed-value><stored-value>Question Set</stored-value></pair><pair><displayed-value>Model Answers</displayed-value><stored-value>Model Answers</stored-value></pair></value-pairs> Download the input-forms.xml and paste in the folder path /home/dspace/dspace_inst/config Restart Apache Tomcat and Test by submitting an Item
Controlled Vocabulary - Configuration
Subject Classification DDC is Implemented Implemented using Controlled Vocabulary
DDC Implementation Steps 1. Download ddcE.xml file from web site to the path /home/dspace/dspace_inst/config/controlled-vocabularies 2. edit /home/dspace/dspace_inst/config/dspace.cfg File choices.plugin.dc.subject = srsc to ddcE 3. edit /home/dspace/dspace_inst/input-forms.xml
Restart Apache Tomcat and Test by submitting and Item <page number="2"> <field> <dc-schema>dc</dc-schema> <dc-element>subject</dc-element> <dc-qualifier></dc-qualifier> <!-- An input-type of twobox MUST be marked as repeatable --> <repeatable>true</repeatable> <label>Subject Keywords</label> <input-type>twobox</input-type> <hint>Enter appropriate subject keywords or phrases. </hint> <required></required> <vocabulary>ddcE</vocabulary> </field> Restart Apache Tomcat and Test by submitting and Item
Restart Apache Tomcat Shutdown the apache tomcat � $ /home/dspace/IDR/apache-tomcat-8.0.23/bin/shutdown.sh Start the apache tomcat � $ /home/dspace/IDR/apache-tomcat-8.0.23/bin/startup.sh
Item Work-Flow Management
Article / Document / Class Notes Metadata Data Entry File Submission Process Metadata Entry into IDR Publishers Reference is given Bits-Stream Upload Modify - Entry Proof Checking N Wrong Entry Archived into IDR Y Correct Entry
OAI-PMH and Metadata Harvesting
URL/oai/request?verb=ListSets
verb=ListRecords&metadataPrefix=oai_dc
Interfacing with DSpace Web UI LNI and SWORD Ingest and export scripts Crosswalks Ingestion Dissemination DSpace offers several methods to interface with the repository
Collection Settings for Harvesting Data Content Source OAI-PMH provider Information OAI Set Metadata Format Harvesting Level
Collection Settings for Harvesting Data
Collection Settings for Harvesting Data OAI-PMH Provider OAI Set Id DMD Format
Collection Source Settings
Harvest Level Settings
Return to Import Data Content Source OAI-PMH provider Information OAI Set Metadata Format Harvesting Level Click on Return Button for Importing the data
After all Settings Click on Import Now Button to Harvest data from “Data Provider”
Harvesting Processes
Harvesting Metadata Local collection (OAI-PMH harvester) Remote collection (OAI-PMH provider) Protocol Layer MD = Metadata
Harvesting ORE ReMs Local collection (OAI-PMH harvester) Remote collection (OAI-PMH provider) Protocol Layer MD = Metadata
Harvesting Metadata + Content Local collection (OAI-PMH harvester) Remote collection (OAI-PMH provider) MD = Metadata