DSPACE Installation

Raghuraman K P
NCSI

1
DSPACE
Main Objective
z Captures Data in any Format
z Text, Audio, Video and Data
z Distributes over the web
z Indexes the work
z Preserves digital work for a longer term

2
DSPACE - Development
z Application is written in Java
z Built on top of free open source tools
z Apache web server
z Tomcat servlet engine
z PostgreSQL relational database system
z Tools run on any UNIX type OS
z Linux, HP/UX or Solaris

3
Pre - Requisites
Hardware configuration

z Any computer that can run Unix-type

OS
z Server configuration preferred
z RAM memory about 2GB
z The repository size will decide the storage
capacity (hard disk size)

4
Pre - Requisites
Software
z UNIX-like OS (Linux, HP/UX etc)
z Java 1.4 or later (standard SDK is fine, you don't
need J2EE) – Sun Java preferred
z Apache Ant 1.6.2 or later (Java make-like tool)
z PostgreSQL 7.3 or later - an open source relational
database, or Oracle 9 or higher.
z Java Servlet Container – Tomcat, Resin, Jetty,
JBoss etc.
(From the Dspace website)

5
Unix like OS
z Any flavor of UNIX like
z Linux, any flavor
z Redhat
z Suse
z Mandrake
z Debian
z Fedora etc.
z Solaris (Sun system)
z HP-UX (Hewlett Packard)
z AIX (IBM)
z Mac OS X

6
Java Compiler
z Sun Java (preferred)
z IBM Java
z GNU Java

NOTE
z Some Linux versions might have already been loaded with GNU
java.
z Make sure of the PATH variable points to Sun Java

7
Ant

z Java based build tool, similar to make in the

world of ‘C’
z Compiles java programs of dspace source
code, generates war files

War files - A Web application is a group of HTML pages, JSP pages, servlets,
resources and source file, which can be managed as a single unit. A Web
archive (WAR) file is a packaged Web application. WAR files can be used to
import a Web application into a Web server.

8
DBMS

z PostgreSQL (open source)

z Oracle (commercial)

z Database backend of DSpace

z Stores information on
z Communities

z Collection

z Members - passwords

z E-groups

9
Servlet containers
z Tomcat (most popular with DSpace)
z Jetty
z Resin
z JBoss (more professional)
z J2EE

z Can be integrated with Apache, you have to build connectors

Servlets are server-side Java™ programs. These Java programs extend the
functionality of a Web server by generating dynamic content and responding
to Web client requests. When a browser sends a request to the server, the
server can send the request information to a servlet, so that the servlet can
construct the response that is sent back to the browser.

10
Workshop - Config
z Operating System – Fedora 8.0
z Java – jdk-6-linux-i586.rpm
z Apache Ant – apache-ant-1.7.0-bin.tar.gz
z PostgreSQL
z postgresql-8.2.5-2PGDG.f7.i686.rpm
z postgresql-server-8.2.5-2PGDG.f7.i686.rpm
z Postgresql-8.2.507.jdbc4.jar
z Tomcat – apache-tomcat-5.5.23-compat.tar.gz
z Dspace – dspace-1.4.2-source.tar

11
Downloads
Site address of downloads
z DSpace
z http://www.sourceforge.net/projects/dspace
z Apache-Tomcat
z http://tomcat.apache.org
z Apache-ant
z http://ant.apache.org
z Postgre-sql
z http://www.postgresql.org

Note:
z ant may be available with your OS
z Tomcat may be available with your OS, But use the downloaded tomcat

12
 Installation
Demonstration and Practical
Session

13
Install JAVA
z Check whether java is installed
z #java –version

z Copy the java rpm given

z cp jdk-6-linux-i586

z Install the package

z #rpm –ivh jdk-6-linux-i586.rpm

z Remove any old installed java

z #rm /usr/bin/java
14
Install JAVA (contd)
z Create symbolic link to new installed Java
z #cd /usr/bin
z #ln –s /usr/java/jdk1.6.0/java java
z Set environment variable by editing file profile
z #vi /etc/profile
z Type the following lines
z # JAVA_HOME=/usr/java/jdk1.6.0
z #export JAVA_HOME
z Save the file
15
Install Apache-Ant
z Check if ant is installed
z #which ant
z Copy the apache-ant-1.7.0-bin.tar as follows
z #cp apache-ant-1.7.0-bin.tar /usr/local
z Install as follows
z #cd /usr/local
z #gunzip apache-ant-1.7.0-bin.tar.gz
z #tar –xvf apache-ant-1.7.0-bin.tar
z #mv apache-ant-1.7.0 ant
z Set environment variable
z #vi /etc/profile
z Add the line
z PATH=$PATH:/usr/local/ant/bin
z Save the file

16
Install PostgreSQL
z Copy the postgresql-8.2.5-
2PGDG.f7.i686.rpm and postgresql-server-
8.2.5-2PGDG.f7.i686.rpm
z Install the files in the same sequence
z #rpm –ivh postgresql-8.2.5 -2PGDG.f7.i686.rpm
z #rpm –ivh postgresql-server-8.2.5-
2PGDG.f7.i686.rpm

17
Install PostgreSQL (contd)
z Log into postgres
z #su –l postgres
z Initialize database
z $initdb
z Configuration changes
z Open /data/postgresql.conf and remove comment for
listen_addresses = ‘localhost’
z $vi /data/postgresql.conf
z Open /data/pg_hba.conf and add a line in the section #IPv4-style
local connections:
z host dspace dspace 127.0.0.1 255.255.255.255 md5
z Save the file
18
Install Tomcat
z Copy apache-tomcat-5.5.23.tar.gz to /usr/local
z #cp apache-tomcat-5.5.23.tar.gz /usr/local

z Change directory
z #cd /usr/local

z Uncompress and extract files

z #gunzip apache-tomcat-5.5.23.tar.gz
z #tar –xvf apache-tomcat-5.5.23.tar

z Rename the directory

z #mv apache-tomcat-5.5.23 tomcat 19
Install Tomcat (contd)

z Configuration changes
z Open the file /etc/profile and the add the following
z JAVA_OPTS="-Xmx512M -Xms64M -Dfile.encoding=UTF-8"
z export JAVA_OPTS
z Save the file

z Locate the following section in file /usr/local/tomcat/config/server.xml

z <!-- Define a non-SSL HTTP/1.1 Connector on port 8080 --> <Connector
port="8080" maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="100"
connectionTimeout="20000" disableUploadTimeout="true" />
z Add the following
z <!-- Define a non-SSL HTTP/1.1 Connector on port 8080 --> <Connector
port="8080" maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="100"
connectionTimeout="20000" disableUploadTimeout="true" URIEncoding="UTF-8"
/>
z Save the file 20
Install Dspace
z Copy dspace-1.4.2-source.tar to root directory
z #cp dspace-1.4.2-source.tar /
z Change directory
z #cd /
z Uncompress and extract files
z #gunzip dspace-1.4.2-source.tar
z #tar -xvf dspace-1.4.2-source.tar
z Rename directory
z #mv dspace-1.4.2-source dspace

21
Install Dspace (contd)
z Create an user dspace
z #useradd –d /dspace dspace
z #passwd dspace
z Download file postgresql-8.2.507.jar and rename
z #mv postgresql-8.2.507.jar postgresql
z Copy postgres jdbc driver
z cp postgresql /dspace/lib
z Login to dspace
z #su –l dspace
z $cd /dspace
22
Install Dspace (contd)
z Create dspace database
z $createuser –U postgres –d –A –P dspace
(Give password and remember it)
z createdb –U dspace –E UNICODE dspace

z Start postgres service

z $service postgres start

23
Install Dspace (contd)
Minimal configuration changes
z Open the file /dspace/config/dspace.cfg
z dspace.url = [like http://10.183.xx.xx/dspace]
z dspace.hostname = [IP address of server]
z dspace.name =[ Dspace at IISC Workshop]
z db.password = [the password you entered in the last step of
postgresql installation]
z mail.server =[l10.183.xx.xx]
z mail.from.address = [dspace@localhost]
z feedback.recipient =[dspace@localhost]
z mail.admin = [dspace@localhost]
z alert.recipient =[email address (not essential but very useful!)]
z Save the file

24
Install Dspace (contd)
z Compile and install
z $ant fresh_install
z Copy the war files created
z $cp /dspace/build/*.war /usr/local/tomcat/webapps
z Create initial administrator account
z $/dspace/bin/create-administrator
z Enter details as prompted

25
Install Dspace (contd)
z Change ownership to user dspace for tomcat
z #chown –R dspace.dspace /usr/local/tomcat
z Start tomcat
z $/usr/local/tomcat/bin/startup.sh
z Open browser
z Give address http://10.183.xx.xx:8080/dspace
z There you will have the dspace page
z Successful installation

26
 Thank you

Visit the web site for further information:

http//casin.ncsi.iisc.ernet.in

27