P. 1
73355452 Build and Deploy Your Own Digital Repository With DSpace on Ubuntu 10 04 LTS Server

73355452 Build and Deploy Your Own Digital Repository With DSpace on Ubuntu 10 04 LTS Server

|Views: 181|Likes:
Published by Ermias Tenaw

More info:

Published by: Ermias Tenaw on Jun 02, 2012
Copyright:Attribution Non-commercial

Availability:

Read on Scribd mobile: iPhone, iPad and Android.
download as PDF, TXT or read online from Scribd
See more
See less

12/04/2013

pdf

text

original

Sections

  • Step-By-Step Install Guide DSpace 1.7 on Ubuntu 10.04 LTS Server
  • Introduction
  • Part 1: Background Information
  • 1.5 Marketing Your Institutional Repository Service
  • Part 2: Prepare DSpace Repository Server Requirements
  • Step 1: DSpace Hardware Requirements
  • Step 2: Install and Configure Ubuntu 10.04 LTS Server
  • Part 3: Install & Configure Ubuntu 10.04 LTS Server
  • Step 1: Getting Started & Hardware Pre-requisites
  • Step 2: Update Ubuntu 10.04 Operating Systems
  • Part 4: Installing Additional Infrastructure Packages
  • Step 1: Install OpenSSH Package
  • Step 2: Install Sun Java
  • 2.3 Change the in-use Java to Sun Java, as opposed to OpenJDK
  • Step 3: Install LAMP (Apache2, MySQL & PHP) Server
  • Step 4: Creating “dspace” Database Users
  • 4.2 Allow the database user (dspace) to connect to the database
  • Step 5: Configure Tomcat to know about the DSpace webapps
  • Step 6: Install the Compile / Build Tool "Maven2"
  • Part 5: Download and Install DSpace
  • Step 1: Introduction
  • Step 2: Create the "dspace" directory
  • Step 3: Download the DSpace Source Release
  • Step 4: Edit the DSpace configuration
  • Step 5: Compile and Build DSpace
  • Step 6: Fix Tomcat permissions, and restart the Tomcat server
  • Step 7: Test it out in your browser
  • Step 8: Setting an Admin Account
  • Step 9: Creating E-People on DSpace using Manakin
  • Part 6: Creating DSpace Community
  • 1.1 The DSpace Collection
  • 1.2 Example Repository Structures
  • Step 2: Creating Communities
  • 2.1 Introduction
  • 2.2 Hands-on Creation of Communities
  • Step 3 Creating DSpace Collections
  • 3.1 Hands-on Creation of Collections
  • Step 4: Submitting to a Collection
  • Part 7: Hands-on Lab Assignments
  • Ubuntu Server Administration Training

Global Open Versity, ICT Labs

Step-By-Step Install Guide DSpace on Ubuntu 10.04 LTS v1.0

Global Open Versity Cloud Computing Hands-on Labs Training Manual

Step-By-Step Install Guide DSpace on Ubuntu 10.04 LTS Server
Kefa Rabah Global Open Versity, Vancouver Canada
krabah@globalopenversity.org

www.globalopenversity.org Table of Contents Page No.

STEP-BY-STEP INSTALL GUIDE DSPACE 1.7 ON UBUNTU 10.04 LTS SERVER Introduction Part 1: Background Information 1.1 How do People Use Institutional Repositories? 1.2 Ways of Organizing Content 1.3 Creating a Service Plan 1.4 Running a Pilot or Early Adopter Programme 1.5 Marketing Your Institutional Repository Service 1.6 Training and User Support 1.7 Getting Started Part 2: Prepare DSpace Repository Server Requirements Step 1: DSpace Hardware Requirements Step 2: Install and Configure Ubuntu 10.04 LTS Server Part 3: Install & Configure Ubuntu 10.04 LTS Server Step 1: Getting Started & Hardware Pre-requisites Step 2: Update Ubuntu 10.04 Operating Systems Part 4: Installing Additional Infrastructure Packages Step 1: Install OpenSSH Package Step 2: Install Sun Java 2.1 Enable the Canonical Partners repository. 2.2 Install Sun Java 2.3 Change the in-use Java to Sun Java, as opposed to OpenJDK Step 3: Install LAMP (Apache2, MySQL & PHP) Server Step 4: Creating “dspace” Database Users 4.1 Create dspace user 4.2 Allow the database user (dspace) to connect to the database 4.3 Set the PostgreSQL Listening Port Wide 4.4 Create the dspace database Step 5: Configure Tomcat to know about the DSpace webapps. Step 6: Install the Compile / Build Tool "Maven2" Part 5: Download and Install DSpace Step 1: Introduction
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada

3 3 4 4 4 5 5 5 5 6 6 7 7 8 8 8 8 9 9 9 9 9 10 11 11 11 11 12 12 12 13 13 1

www.globalopenversity.org

ICT105 – Ubuntu Server Administration Training

Global Open Versity, ICT Labs

Step-By-Step Install Guide DSpace on Ubuntu 10.04 LTS v1.0

Step 2: Create the "dspace" directory. Step 3: Download the DSpace Source Release Step 4: Edit the DSpace configuration Step 5: Compile and Build DSpace Step 6: Fix Tomcat permissions, and restart the Tomcat server Step 7: Test it out in your browser Step 8: Setting an Admin Account Step 9: Creating E-People on DSpace using Manakin Part 6: Creating DSpace Community Step 1: Introduction 1.1 The DSpace Collection 1.2 Example Repository Structures Step 2: Creating Communities 2.1 Introduction 2.2 Hands-on Creation of Communities Step 3 Creating DSpace Collections 3.1 Hands-on Creation of Collections Step 4: Submitting to a Collection Part 7: Hands-on Lab Assignments Ubuntu Server Administration Training

13 13 13 14 16 16 18 21 23 23 24 24 24 24 25 27 28 33 40 40

A GOV Open Access Technical Academic Publications Enhancing education & empowering people worldwide through eLearning in the 21st Century 2
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada

www.globalopenversity.org

ICT105 – Ubuntu Server Administration Training

Global Open Versity, ICT Labs

Step-By-Step Install Guide DSpace on Ubuntu 10.04 LTS v1.0

Global Open Versity Cloud Computing Hands-on Labs Training Manual

Step-By-Step Install Guide DSpace 1.7 on Ubuntu 10.04 LTS Server
By Kefa Rabah, krabah@globalopenversity.org Nov, 2011 GTS Institute

Introduction
DSpace was designed in 2002 by MIT Libraries in collaboration with the Hewlett-Packard Company. Its focus in the submission, storage, access and preservation of research material in digital format makes it well suited to the needs of an institutional repository. DSpace open source software is a turnkey institutional repository application. DSpace is an open-source digital repository software adopted in 2005 by the Texas Digital Library as the platform for its digital repository service offering. The software allows institutions to create online institutional repositories that ingest, store, and provide open access to all types of digital content, including documents, images, video, audio, and datasets. DSpace is the software of choice for academic, nonprofit, and commercial organizations building open digital repositories. It is free and easy to install "out of the box" and completely customizable to fit the needs of any organization. During the past 5 years, there was a significant growth in libraries implementing institutional repositories, and it is still growing (http://www.opendoar.org ). Institutional repositories have been implemented to digitally preserve and archive the research assets of individual institutions, but also to provide open access to research conducted by members of the research communities from these institutions. The Open Access and Open Source Software movements have gained rapid momentum world over. Many institutions and organizations are setting up open access repositories using open source software, following open standards. There are a number of free open source software products available for developing digital libraries, and DSpace (http://www.dspace.org ) is one of the most popular software developed jointly by MIT Libraries and HP labs. DSpace is a digital asset management system. It helps create, index and retrieve various forms of digital content. DSpace is adaptable to different community needs. Interoperability between systems is built-in and it adheres to international standards for metadata.

Hands-on Lab Session
In this Hands-on Labs, you will learn how to install Ubuntu 10.04 LTS server and prepare it for the installation of DSpace Digital Repository. You’ll also learn how to perform post-installation configuration e.g., upgrade the system with new patches and bug fixes, configure static IP address from dynamic one, change the computer hostname, modify hosts file, perform ping test among others. Next, you will learn how to install DSpace on Linux Ubuntu 10.04 server .Upon completion of this lab session you should have gained a capability and expertise to install and maintain DSpace Digital Repository which you can use to manage your digital content repository hosting solutions. The entire lab training was performed on VMware. But you can also use the open source VirtualBox from Oracle.

3
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada

www.globalopenversity.org

ICT105 – Ubuntu Server Administration Training

or by proxy. Example: Neuroscience Dept. Changes over time. Many universities organize according to academic research centers or departments.Global Open Versity. 1.0 Part 1: Background Information 1. Vancouver Canada www. How you organize content communities depends on the interests and allegiances of your academics. membership limited to academic choice. Most software systems call for customizations based on your content communities. 2. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. Established submission guidelines and workflow.04 LTS v1. Formal Community – Consists of departments. research centers. Example: Social Science – cuts across departments. Example: Policy Research Institute. all academics can submit. Kefa Rabah. The information model that best suits your university would not fit another campus. Library staff review content before going online. crosses depts. Subject Community – Open access. Scholar-driven.org ICT105 – Ubuntu Server Administration Training .1 How do People Use Institutional Repositories? Universities and research libraries around the world use institutional repository in the following ways: • • • • • • • • • • • Scholarly communication Storing learning materials and courseware Electronic publishing Managing collections of research documents Preserving digital materials for the long term Adding to the university’s prestige by showcasing its academic research Institutional leadership role for the Library Knowledge management Research assessment Encouraging open access to scholarly research Housing digitized collections Each university has a unique culture and assets that require a customized approach. This is by no means the only organizing principle. 4 April 2007.globalopenversity. 3. One university (the University of Kansas) organizes its content using ″hybrid communities″ in the following ways: 1. Global Open Versity. and groups already existing.2 Ways of Organizing Content Each institutional repository service organizes content in a way to suit its university’s unique culture and academic organizations. Community of Interest – An ad hoc group.

Growth and Maturity. test the software.3 Creating a Service Plan A typical institutional repository Service Plan is divided into three periods: Start-up.org ICT105 – Ubuntu Server Administration Training . units. iron out procedures. These are groups that contribute content to an institutional repository – either academic or administrative departments. manageable service conducted alongside a targeted marketing and communication program to build awareness in the community. In addition. centers. This helps you to focus on adding one discrete group of content and users to the system. Vancouver Canada www. Kefa Rabah.0 1. and field test your policies and assumptions before launching the service to the entire university. Each of the varied user groups needs general exposure to the service –its features and how it is it used. Global Open Versity. to do some marketing to advertise the service on campus.04 LTS v1. etc.globalopenversity. Many institutions prefer to begin with a small. or labs. As momentum grows. Some teams have been successful in targeting a handful of “thought leaders” on campus – getting them on board early to leverage their interest in the service.Global Open Versity. it is critical to communicate how the service benefits the university community – in other words.4 Running a Pilot or Early Adopter Programme Each Institutional repository service is comprised of content collections – sometimes called communities. library staff who create metadata and add content need training specific to their jobs. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. they add content communities and reach additional academic departments. 5 April 2007. 1. consider the amount of training and support you will want to offer.5 Marketing Your Institutional Repository Service As you begin to build a service. Another team contacted all the webmasters and writers at the university to raise awareness and generate leads among those who currently post scholarly content to university and department websites. Academics and their designated content contributors need training in adding content to the system and setting up content areas for departments or research centres.6 Training and User Support As you plan your service. 1. showcasing a handpicked short list of early adopters who test the software and agree to join the programme early on. These periods reflect milestones in phased development and allow for differing levels of resource commitment to meet those objectives. colleges. 1. Many universities have found it helpful to run a pilot programme for their institutional repository service.

globalopenversity.org ICT105 – Ubuntu Server Administration Training . departments. In the case of MIT (a large research university) "Communities" are defined to be the schools. and regional laws differ. Global Open Versity. Online materials are similarly governed by government copyright. Because each institutional repository is unique. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. Fig.04 LTS v1. We include a checklist of policy issues to consider as you design and build a service. Part 2: Prepare DSpace Repository Server Requirements DSpace is designed to make participation by depositors easy. 1: DSpace information model 6 April 2007. Each Community can adapt the system to meet its particular needs and manage the submission process itself.0 1. Vancouver Canada www.Global Open Versity. and then populate it with electronic content. your policies will be unique to your service. The system's information model is built around the idea of organizational "Communities"—natural sub-units of an institution that have distinctive information management needs. labs. legal deposit laws. and publishing contracts. and centers of the Institute. Kefa Rabah.7 Getting Started Library staff and researchers routinely deal with intellectual property policies and publishing rights issues for printed matter. Each university that develops an institutional repository needs to research and write policies and regulations for its collections.

4GHz). Global Open Versity. with the addition of two more drive enclosures. the Tomcat Servlet engine. Options include a second controller and. HP Server rx2600. b.0 Step 1: DSpace Hardware Requirements 1. Ultra 3. c. 2GB memory. 436-GB. What about sizing the server? How much disk space do I need? From Dspace FAQ: • “There are no specific server requirements for DSpace except UNIX.04 LTS 64-bit server: 1. in theory it will run on other platforms as well. powered by dual 64-bit Intel Itanium 2 processors (900MHz). A DLT tape library to back up the DB/jsps etc. or 12 x 26. such as the Apache Web server.org ICT105 – Ubuntu Server Administration Training . open-source tools. Step-By-Step Install Guide Ubuntu 10.Global Open Versity. Kefa Rabah.) DSpace is built on top of free. 24MB std cache. Of course. DVD. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. What sort of hardware does DSpace require? 2. Some examples from the community (not necessarily endorsements): a. or Ultra320 SCSI drives. One 2. Vancouver Canada www. controls up to 42 Ultra2. Total capacity can be six terabytes “SunFire 280R Server.globalopenversity. your mileage (and costs) will vary depending on what you plan to do with the system ” • • However for Hands-on training purposes we'll setup DSpace repository server on Ubuntu 10. 26 GB internal disk storage.04 LTS Server Assumptions It’s assumed that you have a good knowledge of Linux Ubuntu OS. If not then you can check this article which discuses how to install Ubuntu 10. 2GB RAM.04 LTS virtual machine powered by VMWare server.000rpm HH internal FCAL disk drives. Dell PowerEdge 2650 with dual Xeon processors (2.4 Gbyte 10K RPM disks.04 LTS v1. 8MB E-cache.5TB Apple XServe. two 36GB 10. Step 2: Install and Configure Ubuntu 10. 2GB RAM. (Because the application is written in Java. and the postgreSQL relational database system • “For a research university.04 LTS (Lucid Lynx) Server 7 April 2007. Sun StorEdge A1000 rack-mountable w/ 1 HW RAID controller. 2x73GB scsi disks. DSpace requires a reasonably good server and a decent amount of memory and disk storage. two 900MHz UltraSPARC-III Cu processors. HP StorageWorks Modular SAN Array 1000 (msa1000) with a single high-performance controller.

2. one option is to order the machine with Ubuntu pre-installed. For maximum subsystem compatibility. When used to manipulate the core packages of the operating system. If you are purchasing a computer to run Webserver. After installing the operating system. 1. If you are capable of installing the user friendly Ubuntu GNU/Linux operating system or any other Linux distros. We’re done with this section 3.globalopenversity. $ sudo apt-get update $ sudo apt-get -u upgrade Note 1: The sudo command is used to run privileged operations on the Ubuntu platform. then you should be able to follow along with ease.04 Operating Systems It is useful to update your system with the latest components and system patches. we suggest that you install the 32bit version of Ubuntu.Global Open Versity. Step 2: Update Ubuntu 10.org ICT105 – Ubuntu Server Administration Training .0 Part 3: Install & Configure Ubuntu 10. enter the following commands. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. In this Hands-on Labs. 2Gb RAM. The first time you run the command. log into your machine and ensure you perform software updates to bring your systems up-to-date. 8 April 2007. it needs to be run in conjunction with the sudo command. it will ask for your password. From the command line. You’re now ready to begin any other application installation as desired! Part 4: Installing Additional Infrastructure Packages These instructions are written for an audience comfortable with invoking instructions from the command line and GUI option.04 LTS Server Step 1: Getting Started & Hardware Pre-requisites Ubuntu runs on inexpensive. and a 2GHz Intel Dual Core CPU.04 LTS v1. we recommend a minimum configuration of 200Gb Disk. The first command below asks Ubuntu to update its database of available packages. webserver or ISP hosing using IPConfig etc. it will not ask for your password again for a short period of time (typically 15 minutes). Global Open Versity. and the second command installs the latest packages based on your current configuration. commodity hardware. Subsequently. Vancouver Canada www.. it’s assumed that your target computer is connected to the internet. To support a small practice like OSCAR EMR. Kefa Rabah. Note 2: apt-get is the program Ubuntu uses for managing the system’s packages. We run the upgrade command twice to ensure that any packages that may have post-upgrade dependencies also have an opportunity to be upgraded. one at a time.

ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. By default this package is already installed in the Ubuntu server option. you will need to install the OpenSSH package. From the GUI this can be changed by going to Software Sources.list # Uncomment the line: deb http://archive. Global Open Versity. Vancouver Canada www. then we set the sun java to be the new default.168.2 Install Sun Java 4. 3. Kefa Rabah. you use the ssh username@hostname command. Step 2: Install Sun Java 2. 192. example. First we list the available jdk's installed on the system.83.com/ubuntu lucid partner sudo apt-get update 2.04) sudo vi /etc/apt/sources. as opposed to OpenJDK 5. run: sudo apt-get install sun-java6-jdk sun-java6-plugin 2.3 Change the in-use Java to Sun Java. and replacing hostname with either the fully qualified host name (e. Change "natty" to the name of the Ubuntu version you're using (if you aren't using Ubuntu 10. This package will come in handy in the future to support administrative tasks on the system. 9 April 2007.g. To install OpenSSH.0 Step 1: Install OpenSSH Package In order to support secure remote connections to your server. 1. To install Sun Java.50). To log into a remote computer that is running OpenSSH.04 LTS v1. replacing username with a valid user name on the computer you are trying to log into. We're done with this section. The Sun Java is available in the partners repository which makes for an easy installation.canonical. or it’s IP address (e.org ICT105 – Ubuntu Server Administration Training .1 Enable the Canonical Partners repository. issue the following command: $ sudo apt-get install openssh-server -y 2. sudo update-java-alternatives -l 6.com) of your server.Global Open Versity.g.globalopenversity.

To install LAPM server using Tasksel utility. Kefa Rabah. MySQL & PHP) Server 1. Global Open Versity. run: sudo aptitude install tasksel 2.org ICT105 – Ubuntu Server Administration Training . 3 3.globalopenversity. issue the following command: $ sudo taskel Note: select the following packages (or change as desired): [*] LAMP server [*] PostgreSQL database [*] Tomcat Java server Click OK and hit Enter to start installation.04 LTS v1. We’re done with this section. Fig. 10 April 2007.0 Step 3: Install LAMP (Apache2. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. Vancouver Canada www.Global Open Versity. Install the server stack tasksel.

globalopenversity. netadmin@server01:~$ sudo su postgres -c 'createuser -d -A -P dspace' Note: run createuser with –help switch to get an overview of available options. Running the following command will create database user 'dspace' who is not a superuser. Add this line to the configuration: local all dspace md5 3. Restart PostgreSQL server: # /etc/init.conf 5.2 Allow the database user (dspace) to connect to the database 1.conf 2. Using your favorite Text editor.3 Set the PostgreSQL Listening Port Wide 4.1 Create dspace user 1.d/postgresql restart 11 April 2007. Restart PostgreSQL server: sudo /etc/init. $ createuser –help 4. Add on line 57 in the configuration: listen_address = '*' 6.4/main/pg_hba.0 Step 4: Creating “dspace” Database Users 4. open: sudo vi /etc/postgresql/9. open: Sudo vi /etc/postgresql/9. Vancouver Canada www.Global Open Versity. You will be asked to give new user's password as '-P' option is passed.0/main/postgresql. Kefa Rabah. can create databases.04 LTS v1. cannot create new roles and his password is stored encrypted. Using your favorite Text editor. Global Open Versity.org ICT105 – Ubuntu Server Administration Training .d/postgresql restart 4. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. Database users can be created in command line with createuser tool.

Global Open Versity. 12 April 2007. As root user. We’re done with this section. we need to install Maven2 package. Restart Apache Tomcat server: sudo /etc/init.4 Create the dspace database 7.04 LTS v1. Vancouver Canada www. Kefa Rabah. run: sudo aptitude install ant maven2 2. Here. Here. Global Open Versity. Step 6: Install the Compile / Build Tool "Maven2" 1.Define a new context path for all DSpace web apps -->″: <Context path="/xmlui" docBase="/dspace/webapps/xmlui" allowLinking="true"/> <Context path="/sword" docBase="/dspace/webapps/sword" allowLinking="true"/> <Context path="/oai" docBase="/dspace/webapps/oai" allowLinking="true"/> <Context path="/jspui" docBase="/dspace/webapps/jspui" allowLinking="true"/> <Context path="/lni" docBase="/dspace/webapps/lni" allowLinking="true"/> <Context path="/solr" docBase="/dspace/webapps/solr" allowLinking="true"/> 2. run: netadmin@server01:~$ sudo su postgres postgres@server01:/home/netadmin$ createdb -U dspace -E UNICODE dspace Step 5: Configure Tomcat to know about the DSpace webapps. run: sudo vi /etc/tomcat6/server. we need to modify ″/etc/tomcat6/server. As the postgres user.globalopenversity. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10.xml″ file to integrate DSpace: 1.org ICT105 – Ubuntu Server Administration Training .xml Insert the following block of text just above the closing ″</Host><!-.d/tomcat6 restart 3. We’re done with this section.0 4.

this is standard stuff. extract the file: tar -xvzf dspace-1. Ubuntu has an application to help with setting up the web application stack.7.0 Part 5: Download and Install DSpace Step 1: Introduction Installing DSpace is almost as simple as changing between DSpace versions (eg between 1. run: wget http://sourceforge.6.Global Open Versity.xsrc-release directory is typically referred to as [dspace-src]. and unpacks it in your current directory. Type the following to edit the Dspace (dspace.6 and 1. Within the world of the Ubuntu server.2-src-release. The installation and configuration of the prerequisites is the step that takes all the time.gz 2. You can check out our great hands-on training manuals from Docstoc. This step downloads the compressed archive from SourceForge.cfg 13 April 2007.globalopenversity.2-src-release/dspace/config/dspace. Kefa Rabah.tar. The dspace-1. 1. Next.7.2/dspace1. Step 4: Edit the DSpace configuration Here we need prepare DSpace configuration file to meet our environment requirement (change as desired).org ICT105 – Ubuntu Server Administration Training .04 (Natty Narwhal).tar. As the root user: sudo mkdir /dspace Step 3: Download the DSpace Source Release The DSpace source release allows you to customize every aspect of DSpace. or from runlevel 3 command-line with networking.net/projects/dspace/files/DSpace%20Stable/1. To download DSpace release source.10 (Maverick Meerkat) and Ubuntu 11. The same steps can be used to DSpace on Ubuntu 10.7). ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. Global Open Versity.04 LTS v1.x. The ″/dspace″ directory is where the running dspace code will reside. It can be done in only a few minutes.gz 3. Vancouver Canada www. 1.com: Step 2: Create the "dspace" directory.2-src-release.7. These steps can also be done through a ssh secure shell from any machine with a ssh client. We're done with this section.cfg) config file: sudo nano /home/dspace/dspace-1.

Global Open Versity.org ICT105 – Ubuntu Server Administration Training .driver = org.name = %DSpace for My University% db.Driver db.hostname = %hostname% dspace.username = %dspace% db.language = en_ZA 2. and must be compiled to machine code for the server to run it. dspace. as it doesn’t alter the database or modify your assetstore.password = %dspace% mail. 3. and run mvn command: # cd dspace-1.7. 4.url = jdbc:postgresql://localhost:5432/dspace db. Kefa Rabah.address = %my_email_address% feedback.baseUrl = http://%hostname% dspace.globalopenversity.name = postgres db. Global Open Versity.recipient = %my_email_address% mail.recipient = %my_email_address% registration.04 LTS v1.postgresql. and “ant” will do all the work necessary to initialize the database with the DSpace schema.server = %my_university_mail_server_address% mail. and copy all of the compiled machine code to a location where the web server can serve it.2-src-release # mvn -U package Note: it will take several minutes. “mvn package” compiles the source code. Vancouver Canada www.dir = /home/dspace dspace. • For upgrades the better command to use would be ″ant update″. Step 5: Compile and Build DSpace The source release that has been obtained is human readable source code.url = http://%hostname% dspace.0 Replace all the places with a pair of percent signs (%something%) with the settings for your system. Change to the extracted directory. depending of Internet download bandwidth. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. when done you observe the print as shown below: 14 April 2007.notify = %my_email_address% default. We're done with this section.from.admin = %my_email_address% alert. As the root user perform the following steps” Note: ″ant fresh_install″ will populate the dspace database and [dspace] directory with new information. This will overwrite any existing installation of DSpace that you may have.

and then run ″ant fresh_install″: # cd dspace/target/dspace-1. copy any web applications from /dspace/webapps/ to [echo] the appropriate place for your servlet container.7.) [echo] [echo] You should then be able to access your DSpace's 'home page': [echo] [echo] http://localhost:8080/xmlui [echo] [echo] You should also be able to access the administrator UI: [echo] [echo] http://localhost:8080/xmlui/dspace-admin [echo] ==================================================================== [echo] BUILD SUCCESSFUL Total time: 5 minutes 3 seconds netadmin@server01:~/dspace-1. change to directory as shown. Tomcat) to look for your [echo] DSpace web applications in: /dspace/webapps/ [echo] [echo] OR. Next.2build.dir$ 15 April 2007.g. you should do the following: [echo] [echo] * Setup your Web servlet container (e.2-src-release/dspace/target/dspace-1. Global Open Versity. and the database initialized.04 LTS v1. depending of Internet download bandwidth. [echo] [echo] To complete installation.7.g.7. Kefa Rabah. '$CATALINA_HOME/webapps' for Tomcat) [echo] [echo] * Make an initial administrator account (an e-person) in DSpace: [echo] [echo] /dspace/bin/dspace create-administrator [echo] [echo] * Start up your servlet container (Tomcat etc.2-build.Global Open Versity. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. when done you observe the print as shown below: [java] Started: 1321728701436 [java] Ended: 1321728701672 [java] Elapsed time: 0 secs (236 msecs) [echo] [echo] ==================================================================== [echo] The DSpace code has been installed.0 [INFO] [INFO] [INFO] [INFO] [INFO] [INFO] [INFO] [INFO] --------------------------------------------------------------------------------------------------------------------------------------BUILD SUCCESSFUL -------------------------------------------------------------------Total time: 14 minutes 13 seconds Finished at: Sat Nov 19 09:11:08 PST 2011 Final Memory: 94M/252M -------------------------------------------------------------------- 5.dir # ant fresh_install Note: it will take several minutes. Vancouver Canada www.globalopenversity.org ICT105 – Ubuntu Server Administration Training . [echo] (e.

so we have to change the owner of the files to tomcat6. There are two main webapps that provide a similar turn-key repository interface 9.0 Note: in future.Global Open Versity.cfg″ in [dspace-source]/dspace/config/. whenever you edit ″dspace. We’re done with this section Step 7: Test it out in your browser That is all that is required to install DSpace on Ubuntu. Global Open Versity. sudo chown tomcat6:tomcat6 /dspace -R sudo /etc/init.dir″ so that any changes you may have made are reflected in the configuration files of other applications. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10.04 LTS v1. for example Apache. and restart the Tomcat server This guide follows the convention where the tomcat user will own all of the files in [dspace]. The first one is powered by DSpace/Manakin site: http://localhost:8080/xmlui 16 April 2007.2-build. you should then run ″ant init_configs″ in the ″directory [dspacesource]/dspace/target/dspace-1. Kefa Rabah.d/tomcat6 restart 8.globalopenversity. Restarting tomcat will deploy the dspace webapps that are now ready to be viewed. You may then need to restart those applications. depending on what you changed. 6.org ICT105 – Ubuntu Server Administration Training . Vancouver Canada www.7. 7. We’re done with this section Step 6: Fix Tomcat permissions.

Global Open Versity. The second one is powered by DSpace: http://localhost:8080/jspui 17 April 2007.Global Open Versity. Vancouver Canada www.04 LTS v1.0 Fig.org ICT105 – Ubuntu Server Administration Training . ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. Kefa Rabah.globalopenversity. 2 10.

Vancouver Canada www. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. go to ″/dspace/bin/″ directory and run the command sudo ./dspace create-administrator Creating an initial administrator account E-mail address: szulu@govhostinglabs. Global Open Versity.org ICT105 – Ubuntu Server Administration Training . 3 11. Step 8: Setting an Admin Account 1. To add an admin account for administering Dspace.com First name: Shaka 18 April 2007.globalopenversity. netadmin@server01:/dspace/bin# . We’re done with this section.Global Open Versity. Kefa Rabah.04 LTS v1./dspace create-administrator The following lines are an (almost) exact display of how that application works.0 Fig.

″ 19 April 2007. You should now be able to login to DSpace site with your admin account. Fig.Global Open Versity.globalopenversity. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. From Fig. as shown in Fig. 4 3. Kefa Rabah.org ICT105 – Ubuntu Server Administration Training .04 LTS v1. you have the option to add your contact telephone and also update your password. Global Open Versity. 4. Vancouver Canada www. Password: your-admin’s-secret-password Again to confirm: your-admin’s-secret-password Is the above data correct? (y or n): y Administrator account created netadmin@server01:/dspace/bin# 2. 5. Click ″Update Profile″ when done.0 Last name: Zulu WARNING: Password will appear on-screen.

Global Open Versity.globalopenversity. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. 5 4. as shown in Fig. Global Open Versity.0 Fig. 6 20 April 2007.04 LTS v1. You should be able to login to DSpace/Manakin Respository.org ICT105 – Ubuntu Server Administration Training . 6. Kefa Rabah. Vancouver Canada www. Fig.

are branded with the university logo of the contributing member institution New tools that allow the creation of modular extensions to the repository. including: • • The ability to create a unique look and feel for each repository. From DSpace/Manakin login with Admin credentials. 6 above.04 LTS v1. allowing the modification of content display and the creation of new workflow and ingestion applications. for instance. Scroll to Administrative Access Control menu. one product of these new tools is Vireo. shown in Fig. to access the "Eperson management" page. • From Actions menu. the TDL’s electronic thesis and dissertation submission and management system The ability to visualize metadata.5 was released.0 was released in January 2007 and became the default user interface for DSpace in March 2008. as with Fig.0 Note: DSpace Manakin: Developers affiliated with the Texas Digital Library and Texas A&M University contributed a major enhancement to DSpace in Manakin. Kefa Rabah. select ″Click here to a add a new E-Person″ 21 April 2007. 7.org ICT105 – Ubuntu Server Administration Training . under Create a new E-Person.globalopenversity. Global Open Versity. making it possible to match the design and user experience of existing institutional Web sites The ability to brand content at the item level.Global Open Versity. including dates and geospatial information. so that individual documents within the TDL federated repository. community. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. a customizable XML user interface designed to be more adaptable to the needs of repository users. and click on People link. in the form of timelines and maps • • Step 9: Creating E-People on DSpace using Manakin To create E-People on DSpace Repository server. Manakin 1. Vancouver Canada www. Manakin contributes several key improvements to DSpace. 2. and collection. perform the following procedures from Manakin admin console: 1. when DSpace version 1.

04 LTS v1.org ICT105 – Ubuntu Server Administration Training . from Create a new user page. Kefa Rabah.globalopenversity. From Fig.0 Fig. Vancouver Canada www. Fig. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10.Global Open Versity. enter the New E-Person's Information. 8. and then click ″Create E-Person″ button. 8 22 April 2007. Global Open Versity. (Note: you'll be prompted with “The user was added successfully” notice). 7 3.

Vancouver Canada www.0 4. Communities and Collections are used within DSpace to provide the repository with an easily navigable structure often representing an institutions organizational makeup 2. Each DSpace service is comprised of Communities – the highest level of the DSpace content hierarchy. Part 6: Creating DSpace Community Step 1: Introduction 1. your E-Person management page should look like shown in Fig. 9.Global Open Versity. 9 5. Kefa Rabah. Communities may be: • Institutes 23 April 2007.globalopenversity. Add as many users as desired.org ICT105 – Ubuntu Server Administration Training . ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. 3. Global Open Versity. Fig. and when done. You're done with this section.04 LTS v1.

should not be too deep. 4. Global Open Versity. tagged with metadata.04 LTS v1. departments.org ICT105 – Ubuntu Server Administration Training . Vancouver Canada www. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. edited.1 Introduction To create a community. 1. 1. works with the head of a community to set up workflows for content to be approved. More information on users. etc. and for this reason. Each Community contains descriptive metadata about itself and the Collections contained within it 5.0 • • • • • Faculties/Schools Departments Labs Research Centers Other administrative unit within an institution. usually the DSpace User Support Manager. Creation of a typical Community involves: 24 April 2007. Some example structures may be: i) ii) iii) Department / Research Group / Item Department / Item Type / Item Faculty / Department / Step 2: Creating Communities 2.globalopenversity.2 Example Repository Structures Repository structures are often based around organizational units of a company or institution such as faculty. each collection contains descriptive metadata about itself and the items contained within it. Collections can belong to a single community or multiple communities (collaboration between communities may result in a shared collection). labs or research centers. An administrator on the DSpace team. 2. They are often hierarchical to provide ease of navigation. 1. Kefa Rabah. 3. groups and administration can be found in the module ‘An introduction to users and groups’. Each Community in turn has collections which contain items or files that are logically related material.Global Open Versity. As with communities. you must be an administrator of the repository and signed into DSpace.1 The DSpace Collection 1.

3. Vancouver Canada www. Completing the descriptive metadata for the community There are basic descriptive fields for each community which describes information about the community and its collections. Complete the descriptive metadata for the Community 25 April 2007. These are the access rights which determine who can view.2 Hands-on Creation of Communities To create a DSpace Community. select the Collections & Communities button from the browse menu to list the communities available in DSpace. Configuring the community’s authorizations. 2. When signed into DSpace. click "Communities & Collection" 3. it resides within another parent community. Introductory text: Introductory text describing the community Copyright text: Copyright text pertaining to anything contained within the community Side bar text Logo: A logo for the community . 2. Select "Create Top-Level Community. i..globalopenversity. These generally are the community o o o o o o Title: The title of the community.04 LTS v1. modify and delete the community and its associated metadata.. i. 2.e.Global Open Versity. in our case user szulu. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10.0 • Choosing the type of community: Is this a top level community. 4. Is this a sub community." button from the Admin Tools menu 4.org ICT105 – Ubuntu Server Administration Training . Short title: A short description of the community. it does not reside in any other communities. Kefa Rabah.e. Login to the DSpace as an administrator. Global Open Versity. Under Browse heading. perform the following procedure: 1. Choose the ‘create top level community’ to create a community at the current level or navigate into an existing community to and choose ‘create sub community’ to create a sub level community..

You should observe your first created Community . ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10.Global Open Versity.0 Fig.org ICT105 – Ubuntu Server Administration Training .04 LTS v1. 10 5. Vancouver Canada www. 11. Global Open Versity. 26 April 2007. 6. Kefa Rabah. Click on the "Create " to complete the Community.globalopenversity.Institute of Africa Studies as shown in Fig.

11 7.globalopenversity. select the Collections & Communities button from the browse menu to list the communities available in DSpace. Select the parent community and then choose ″create collection″ 3. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. When signed into DSpace.Global Open Versity. if items are publically viewable etc. Global Open Versity. you must be an administrator of the parent community and signed into DSpace.org ICT105 – Ubuntu Server Administration Training .0 Fig. Answering some initial questions about the collection The initial questions will determine how the collection is constructed. 2. Vancouver Canada www. Each is described below: 27 April 2007. Creation of a typical collection involves: Selecting the parent community of the collection o Collections can only exist within a community.04 LTS v1. We're done with this section. Step 3 Creating DSpace Collections 1. To create a collection. Kefa Rabah.

This collection will have delegated collection administrators.Global Open Versity.04 LTS v1. add submission users etc). Kefa Rabah.org ICT105 – Ubuntu Server Administration Training . Fig.e. Navigate into your newly created community. This is discussed in the section ‘Introduction to workflows’. New submissions will have some of metadata already filled out with defaults: Selecting this will allow the user to pre-populate some of the metadata fields in the submission process.0 o New items should be publicly readable: Checking this will make any items submitted to this collection viewable to users not signed in to DSpace (i. Global Open Versity. 12. o o o o 3. as shown in Fig. the outside world) Some users will be able to submit to this collection: Checking this will allow the user to select who can submit items to this collection.. 12 28 April 2007. in our case: "Institute of African Studies" 3.e. Vancouver Canada www. The Submission Workflow.1 Hands-on Creation of Collections 1.globalopenversity.. This will allow the user to select who can administer the collection (i. Select "Collections & Communities" from the browse menu 2. modify metadata. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. Select "Create Collection" from the Admin Tools menu.

click "Select E-people" button and click on the default administrator user. Fill in the metadata (Name. accept the default statements. 29 April 2007. Fig. Introductory Text) and click ‘Next’ 6. and click Next Fig. From Fig. 13 5.0 4. Fig. 14 7. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10.globalopenversity. 13.org ICT105 – Ubuntu Server Administration Training . select the desired E-People. 14. 15. Global Open Versity.04 LTS v1.Global Open Versity. Short Description. From Fig. From the pop-up window. when done click Close button. Describe the Collection page. Vancouver Canada www. Kefa Rabah.

click ‘Next’ Fig.Global Open Versity. 16.04 LTS v1. Kefa Rabah. 15 8.org ICT105 – Ubuntu Server Administration Training . Global Open Versity.globalopenversity. Vancouver Canada www. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10.0 Fig. 17 30 April 2007. From Fig.

Global Open Versity. On the next page. and then scroll down and click on the "Update" button to create you collection Fig. Kefa Rabah. as shown in Fig.0 9. 31 April 2007.org ICT105 – Ubuntu Server Administration Training .globalopenversity. Fig. Vancouver Canada www. you should be able to view your newly created collection and community. Finally.04 LTS v1. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. 18. 19. 18 10. accept the default or change as desired. Global Open Versity.

Internet users are now able to view your exiting Communities and Collections.04 LTS v1. when they select "Communities & Collections" from the browse menu. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. Vancouver Canada www. 32 April 2007. 19 11. Kefa Rabah.Global Open Versity. as shown in Fig.org ICT105 – Ubuntu Server Administration Training . Global Open Versity. 20.globalopenversity.0 Fig.

3. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. Kefa Rabah. 20 Step 4: Submitting to a Collection To submit an item to a Community/Collection.04 LTS v1. perform the following procedure: 1.Global Open Versity.org ICT105 – Ubuntu Server Administration Training . 21. From the Community --> Collection page. click on the "Submit to this Collection" button. Login with Admin credentials 2. Global Open Versity. Click Communities & Collections --> select desired Community --> Collection.globalopenversity. 33 April 2007. as shown in Fig. Vancouver Canada www.0 Fig.

From Fig. accept the default or change as desired. Fig. complete the requested information. Global Open Versity. 34 April 2007. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. click Next. Vancouver Canada www.globalopenversity. 21 4. and when done. 23 5.From Fig.org ICT105 – Ubuntu Server Administration Training .04 LTS v1. 22.0 Fig. 24. Kefa Rabah. and then click Next. .Global Open Versity. Submit: Describe this item page.

Global Open Versity.Global Open Versity. Kefa Rabah.04 LTS v1. 24 6. and when done. Vancouver Canada www. complete the requested information. 35 April 2007.globalopenversity. 25. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. click Next.0 Fig. From Fig.org ICT105 – Ubuntu Server Administration Training .

27. click Next. Fig. 36 April 2007.0 Fig. 25 7. and when done. click Browse button to upload the desired item. and then click Next. Kefa Rabah. Global Open Versity.04 LTS v1. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. 26 8.org ICT105 – Ubuntu Server Administration Training .Global Open Versity. Fig. From Fig. On the next page. 26.globalopenversity. the Upload page. Vancouver Canada www. verify the file upload.

Global Open Versity. verify Submission.0 Fig. Fig.globalopenversity. 28 37 April 2007. Vancouver Canada www.Global Open Versity. 27 9.org ICT105 – Ubuntu Server Administration Training . 28. and then click Next. On the next page.04 LTS v1. Kefa Rabah. Fig. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10.

You're done with the submission of an item.org ICT105 – Ubuntu Server Administration Training . 29 11. 38 April 2007. 29. You should see your newly submitted item listed under Recent Submission menu to the right as shown in Fig. Fig.04 LTS v1. 30. Global Open Versity.Global Open Versity. Click Communities and Collections link. modify/update the license as desired and then click “I Grant the License” button at the bottom. as shown in Fig. 31. From Fig. Fig.globalopenversity. you have option to Submit another item or go to your home. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10.0 10. Kefa Rabah. Vancouver Canada www. 30 12. the License page.

39 April 2007. Kefa Rabah. 32. as shown in Fig.globalopenversity. You can follow the link to view the collection item.org ICT105 – Ubuntu Server Administration Training .0 Fig. 31 13.Global Open Versity. Vancouver Canada www. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. Global Open Versity.04 LTS v1.

Install and configure Zimbra messaging solutions 5. Vancouver Canada www. Computing. Ubuntu Server Administration Training You can now register and take our superb Ubuntu Server Training course. Setup Astaro SG firewall/router to protect your LAN infrastructure. Ubuntu Enterprise Cloud.0 Fig.04 LTS. EJBCA PKI solution and many more • ICT105 . Plan Design Implement & Deploy DNS Master and Slave Servers for redundancy. covering Ubuntu 10. and Video) to your Collection. 4.Global Open Versity. Install and configure Webmin admin tool 3.org ICT105 – Ubuntu Server Administration Training .Ubuntu Server Administration Training 40 April 2007. Install and Configure DSpace Repository Server on Ubuntu 10. EHCP and ISPConfig ISP hosting solutions. The Slave DNS should be on a separate machine. • Create your own organizational structure within DSpace • Create a Community and a Collection. 6. You can also perform the above tasks from DSpace/Manakin Repository URL: http://localhost:8080/xmlui 15.globalopenversity. Install and update Linux Ubuntu 10. Part 7: Hands-on Lab Assignments 1. Kefa Rabah. Global Open Versity. You're done with this section and also with this lab session.04 LTS v1. and add items (Text.04 LTS (Lucid Lynx) 2. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. RESTORE backup. Image. 32 14.04 LTS.

04 LTS Server v1. a place to enhance your educating and career goals using the latest innovations and technologies. 5.globalopenversity.0 Other Related Articles: 1. Global Open Versity. 18.3g on RHEL5 Server v1. He is also the founder of Global Open Versity. Using Webmin and Bind9 to Setup Enterprise DNS Server on Linux Deploy Secure Messaging Solutions using Sendmail & Dovecot Servers with ClamAV on Linux Install Guide Secure Postfix Messaging Server with Dovecot and ClamAV on Linux v1. 7. 19. 11. 17.04 LTS Server Step-By-Step Install Guide DTC on Linux CentOS5 Server v1. 10. Vancouver Canada www.3 27.0 Install Guide Linux CentOS-5 VM on Windows Server 2008 Hyper-V R2 Step-By-Step Install Guide Windows Server 2008 R2 Virtualization With Hyper-V v1. ICT Labs Step-By-Step Install Guide DSpace on Ubuntu 10. 8. Install & Setup Astaro Security Gateway to Protect Corporate Network ----------------------------------------------Kefa Rabah is the Founder of Global Technology Solutions Institute. Fellow us on Twitter: Global Open Versity and Kefa Rabah A GOV Open Access Technical Academic Publications Enhancing education & empowering people worldwide through eLearning in the 21st Century 41 April 2007.0 Step-By-Step Build & Deploy Citrix XenServer and XenCenter v1.Global Open Versity. 14.04 LTS v1.0 Step-By-Step Deploy Ubuntu 10. 21.0 26. 6. Kefa is knowledgeable in several fields of Science & Technology. 2. 15.10 LTS Enterprise Cloud Platform Build and Deploy Your Own Private PIAF-GOLD with Asterisk VoIP Telephony System Step-By-Step Install Guide Ubuntu 10. 16. 9. Thunderbird Mail Client with Addressbook using OpenLDAP on Linux HowTo v1.2 Build and Deploy Enterprise sipXecs Integration with Openfire Integrate MS Outlook 2007 Addressbook with SugarCRM Contacts on Windows Build Private Clouds with Ubuntu 10. 22. 24.1 Step-By-Step Build & Deploy Citrix XenServer and XenCenter v1.0 Build your own ISP Hosting using EHCP on Ubuntu 10.04 LTS VM on Citrix XenServer v1.0 Deploy Secure Messaging Solutions using USendUmail & Dovecot Servers with ClamAV on Linux Build your Own Private Data Center Backup Solutions using Ubuntu Powered RESTORE Backup Server v1.0 Step-By-Step Install Guide Joomla CMS on Ubuntu 10. 3.10 Maverick Meerkat Server Step-By-Step Install Guide Linux CentOS-5 VM on Citrix XenServer v1. and Renewable Energy Systems. 20. 23. 4.0 Step-By-Step Install Guide Mahara ePortfolio & Integration with Moodle LMS v1. 13. 12.0 Step-By-Step Install Guide Xen Hypervisor on Linux Server v1. Kefa Rabah. Information Security Compliance and Project Management.2 Install Guide Linux Samba as Primary DC and SSO Identity Management Using Samba 3 Client Technology and Kerberos for Win2k8 AD-based identity management Step-by-step Install Guide for Moodle with Dimdim Web Meeting Step-By-Step Install Guide Alfresco Community 3.org ICT105 – Ubuntu Server Administration Training . 25.

You're Reading a Free Preview

Download
scribd
/*********** DO NOT ALTER ANYTHING BELOW THIS LINE ! ************/ var s_code=s.t();if(s_code)document.write(s_code)//-->