1

Institutional Repository Workshop

1 – 3 April 2009

Presented by Leonard Daniels

2

OverviewOverview

DSpace in a VMware Image

This is an easy way to get DSpace 1.5 up and running with very little effort. DSpace 1.5 has been pre-loaded on this vmware image. Only a few amendments are required to get your own DSpace running.

Chapter 1

Get your Vmware player or Vmware server running. Once installed, import and start the vmware image of DSpace from the hard drive (provided on DVDs).

Chapter 2

Configure your server setting to your network requirements. Continue to edit your DSpace settings to suit your setup.

3

Pre-RequisitesPre-Requisites

Hardware Configuration• Any computer (preferably a server) that can run • Linux-type Operating System• RAM memory about 2GB• Hard disk Size (Repository size will decide the storage capacity)

Software Configuration• Linux Operating System (Ubuntu, Fedora, Debian, Suse, Red Hat)• Java Software• Apache 2 or higher (web application service)• Tomcat 5 or higher (web application service)• PostgreSQL 8.3 (database software)• DSpace 1.5

4

Chapter 1Chapter 1

VMware Player installation

What is the VMware Player?

•VMware Player is free software that enables users to easily run any virtual machine on a Windows or Linux PC•VMware Player enables you to run, evaluate and share software in a virtual machine•A virtual machine is a self-contained operating environment that behaves as if it is a separate computer•Essentially, you’ll use VMware Player to emulate a pre-installed version of DSpace so that you don’t have to set up all the hardware and software required to work with DSpace yourself

5

VMware Player installation continues….

Why does this VM look so strange? It’s supposed to be another PC, so where is Windows?

The operating system that is preloaded on this Virtual Machine is a Linux distribution named Ubuntu and you will, at first, see the text-based console (shell) that is popular with Linux users. For those of you with experience using MS-DOS, this text-based environment shouldn’t be new. Remember, though, that the only purpose of using VMware Player is to have a version of DSpace pre-installed on your PC so that you can work with DSpace. It is expected that you may have trouble with a command-line interface, so don’t worry if the shell CLI environment seems strange and intimidating.

6

7

8

9

Copy and start the VMWare ImageCopy and start the VMWare Image

Copy the contents of the DVDs to somewhere easy accessible Copy the contents of the DVDs to somewhere easy accessible i.e: i.e:

C:\vmware_images\dspaceC:\vmware_images\dspace

10

11

12

13

14

Watch you DSpace vmware image boot up

15

Note:

If you want to shut down your virtual machine, type

sudo halt

and after a few moments vmware player will close. If you simply close the

player, the virtual machine will 'hybernate' and not shut down properly. It is strongly advisable to use the shut

down command instead.

16

Chapter 2Chapter 2

Configure your server setting to your network requirements. Continue to edit your DSpace settings to suit your setup.

17

Log on to your VMWare image with:

user = dspace ; password = dspace

18

Your vm machine has been set up to automatically obtain an IP. To find out your vm's IP, do the following:

$ sudo ifconfig sudo means super user do and allows you to work as if you were an administrator

ifconfig means interface configurator and allows you to view or control a computer’s network

interfaces

[type dspace when prompted for a password]

19

If you don’t see an IP Address, follow these steps: $ cd /etc/network

$ sudo nano interfaces

20

Add the following lines

Reset network interface: $ sudo /etc/init.d/networking restart

$ sudo reboot

21

Check again whether you can see an IP Address:

$ sudo ifconfig

[type dspace when prompted for a password]

22

Make a note of your IP address In the example the IP address is 192.168.44.128

Open your web browser and point it to the IP above in the following way:

http://192.168.44.128/jspui - replacing 192.168.44.128. with the IP you noted previously

23

Now you should see your DSpace opening up from your vmware image

24

Now we need to change the configuration on DSpace to personalize it and get working with your details

Edit the dspace.cfg file by typing the following lines in the black console:

$ cd /dspace/config

$ sudo nano dspace.cfg

25

Continue…Continue…Now look for the following lines and edit them:

• dspace.url = http://dspace.local/jspui #change if testing on network

• dspace.hostname = dspace.local #change if testing on network

• dspace.name = dspace Collection

• mail.server = localhost #campus mail server here

• mail.from.address = dspace-noreply@localhost # change from localhost

• feedback.recipient = youremail@org.ac.za

• mail.admin = youremail@org.ac.za

• To exit the editor, press CTRL + X, and Yes to save

26

$ cd /dspace-source/dspace-1.5.0-release/dspace/target/dspace-1.5.0-build.dir

$ sudo ant update

$ sudo /etc/init.d/postgresql-8.3 restart

$ sudo /etc/init.d/tomcat5.5 restart

Continue…Continue…

27

Create an admin account to login to DSpace with:

$ sudo /dspace/bin/create-administrator

The following admin user has already been set up:

User: dspace@local

Password: dspace

Continue…Continue…

28

With Special Thanks to Laurence Munro(Stellenbosch University) for creating the image and his assistance!!

ANY QUESTIONS?