1. 1 Institutional Repository Workshop 1 – 3 April 2009 Presented by Leonard Daniels

2. 2 Overview 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. 3 Pre-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. 4 Chapter 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. 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. 6

7. 7

8. 8

9. 9 Copy and start the VMWare Image Copy the contents of the DVDs to somewhere easy accessible i.e: C:\vmware_images\dspace

10. 10

11. 11

12. 12

13. 13

14. 14 Watch you DSpace vmware image boot up

15. 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. 16 Chapter 2 Configure your server setting to your network requirements. Continue to edit your DSpace settings to suit your setup.

17. 17 Log on to your VMWare image with: u ser = dspace ; password = dspace

18. 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. 19 If you don’t see an IP Address, follow these steps: $ cd /etc/network $ sudo nano interfaces

20. 20 Add the following lines Reset network interface: $ sudo /etc/init.d/networking restart $ sudo reboot

21. 21 Check again whether you can see an IP Address: $ sudo ifconfig [type dspace when prompted for a password]

22. 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. 23 Now you should see your DSpace opening up from your vmware image

24. 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. 25 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.zayouremail@org.ac.za mail.admin = youremail@org.ac.za To exit the editor, press CTRL + X, and Yes to save

26. 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…

27. 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…

28. 28 With Special Thanks to Laurence Munro(Stellenbosch University) for creating the image and his assistance!! ANY QUESTIONS?