Dspace on Windows. Pre-requisite Software: 1. Java Development Kit. 2. PostgreSQL 3. Apache Tomcat 4. Apache Maven 5. Apache ANT 6.

Size: px

Start display at page:

Download "Dspace on Windows. Pre-requisite Software: 1. Java Development Kit. 2. PostgreSQL 3. Apache Tomcat 4. Apache Maven 5. Apache ANT 6."

Stanley Norton
6 years ago
Views:

1 Dspace on Windows. DSpace is a software of choice for academic, non-profit, and commercial organizations who are building and running open digital repositories. It is free and easy to install. DSpace preserves and enables easy and open access to all types of digital content including text, images, videos and data sets. Pre-requisite Software: 1. Java Development Kit. 2. PostgreSQL 3. Apache Tomcat 4. Apache Maven 5. Apache ANT 6. DSpace Java Development Kit: JDK is a development environment for building applications, applets, and components using the Java programming language. You can download it from: PostgreSQL: PostgreSQL is a powerful, open source object-relational database system. It has native programming interfaces for C/C++, Java,.Net, Perl, Python, Ruby, Tcl, ODBC, among others. We will be using it for storing the database of our repository. You can download it from: Apache Tomcat: Apache Tomcat is an open source software implementation of the Java Servlets. This will work and help us to make our own Web server. You can download it from: Apache Maven: Apache Maven is a software project management and comprehension tool. Based on the concept of a project object model (POM), Maven can manage a project's build, reporting and documentation from a central piece of information. You can get it from: Apache ANT: Ant is a Java-based build tool. In theory, it is kind of like Make, without Make's wrinkles and with the full portability of pure Java code. You can download Apache Ant from: DSpace: You know about it already, this will be everything you ll need to set up a repository. You will get it at. First of all download all above mentioned softwares and save it in one folder.

Software versions used: JDK : jdk-6u14-javafx-1_2-windows-i586 PostgreSQL : postgresql-8.4.0-1-windows Apache Tomcat : apache-tomcat-5.5.28 Apache Tomcat : apache-maven-2.2.1-bin Apache Tomcat : apache-ant-1.

2 Software versions used: JDK : jdk-6u14-javafx-1_2-windows-i586 PostgreSQL : postgresql windows Apache Tomcat : apache-tomcat Apache Tomcat : apache-maven bin Apache Tomcat : apache-ant bin Dspace : dspace src-release At first install JDK. Double click and execute the installer file of Java which you have downloaded. ( jdk-6u14-javafx-1_2- windows-i586) Click on Accept.

3 Click next here

4 Installation will start.

5 Another installer will start for installing JRE. Click next.

6 Click finish to close the installer. After this you will also need to set up Environmental variables. And JAVA HOME. Right click on My computer and to Properties.

7 Go to Advanced TAB. And click on Environmental variables.

8 Here select PATH in system variables section and click EDIT button.

9 Open your program files directories in C drive and locate JAVA > JDK x.x.x.x.> bin folder. Now copy the file path from the address bar of windows explorer. Like this.

10 Paste this path in system variable window, Use as a separator.

11 Click ok Now in User Variable segment. Click on NEW to set up a new user variable of JAVA_HOME. Variable name: JAVA_HOME Variable Value: C:\Program Files\Java\jdk1.6.0_14

12 Paste here the path of you java home directory in program files. Click ok, and apply the settings. After this we will install Apache maven. Apache maven is binary distribution, there is no installer file in that. So we will just Extract the zip folder of apache ant in to root of C drive. C:/..

13 This will make the folder of apache maven in C drive.

14 Extract the files of apache ant into C drive, same way. And a folder for apache maven will be created in C drive.

15 Now give path for apache maven in system variables the same way like we did. Right click my computer >> properties >> Advanced >> Environmental variables Click on path and edit it Add path C:\apache-maven-2.2.1\bin (use semicolon to add with existing Path)

16 Now define path variable for apache ant in the same way we did earlier.. Open the extracted folder of apache ant in C drive, copy the folder path from windows explorer address bar and paste it in system path.

17 Click ok. So all system paths are defined. C:\Program Files\Java\jdk1.6.0_14\bin; C:\apache-maven-2.2.1\bin; C:\apache-ant-1.8.0\bin. Ok it s done!!...now define ANT_HOME in user variables Variable name: ANT_HOME Variable value: C:\apache-ant-1.8.0

18 Click ok and apply the settings. All system paths and user variables are defined. We can also check, what we have done till now. Open command prompt and run the following command to see the java version C:/ java version

19 Same way you can check ant version mvn version and the command prompt will show the following screen.

20 It means all packages java, maven and ant are successfully installed and paths are appropriately defined. After this we will install Apache Tomcat, Double click on Apache tomcat installer file and follow the instruction.

21 Click next.

22 Click I Agree.

23 Now, tick mark all the components in order to do full installation and then click next.

24 Again click next here.

25 In this window give your username and password, that will give you access to monitor and control you tomcat server web interface. Then click next.

26 Make sure that your java virtual machine path is appropriate with your JRE installation folder. Click install.

Click finish.. And then tomcat service will start automatically. And you will see this type of icon in Notification area of Taskbar. Ok now.let s install PostgreSQL.

27 Click finish.. And then tomcat service will start automatically. And you will see this type of icon in Notification area of Taskbar. Ok now.let s install PostgreSQL. But first of all check that for installing PostgreSql, the file system of your local disc must be NTFS To identify this, right click the local disc(c; E; F etc), select Properties, see the File system If all the drives in your system are FAT, then convert a convenient disc to NTFS For converting, go to command prompt and type C:\>CONVERT C: /fs:ntfs this command will convert your c drive into NTFS filesystem. But if you already have C drive with NTFS filesystem partition, you can simply proceed to install PostgreSQL. Double click the Installer file of postgresql. And installer will start.

28 Click Next

29 Check installation directory and click next.

30 Check data directory and click next.

31 In this window you must provide the database password which will allow you to administrate your DATABASE. Click next.

32 Check DATABASE port no. The port no. should be Click next.

33 Installation will start.

34 Click finish to exit the installer. Ok. So postgresql has been installed. And now we will create database and login rolls... So open pgadmin III

35 pgadmin will start.. Click on small icon of postgresql 8.4 (localhost:5432)

36 Database will start... and then create login roll.

37 Right click on Login roles icon and click New Login Role.

38 Fill up the fields of role name with dspace and your desired password... Then open role privileges tab.

39 Tick mark on icons named: Can create database objects, and can create roles. And then click ok.

40 Login role is created. Now create Database.

41 Right click on Database icon and click New Database.

42 Fill up Database name: dspace and select database owner dspace. Click ok.

43 Dspace database is created. You can close the postgresql window now. We have reached to the final step Extract Dspace zip folder in C drive.

44 A directory dspace src-release will be created in C drive. Here you create one more folder named DSpace in C drive

45 Open C:\dspace src-release\dspace\config\dspace.cfg. Open this dspace.cfg file in wordpad. We need to edit this file here. In this configuration file, change the Dspace installation directory path.

46 Change it to. dspace.dir =C:/DSpace Here you can also make other changes. Like your mail server, your Dspace URL. If you are going to use dspace on you Local machine only, you must leave the URL as it is But if you want to run it on your LAN then you must replace localhost with the IP address of your pc. e.g ( is IP address of my pc) Make other changes if you want to, those are optional, (you will be able to do it later also). But above mentioned two changes are compulsory. After changing it, save and close the file. Now we will run mvn package to make installer for Dspace. But first make sure that postgresql service is running. If it is not then restart it from Start >>all programs >> PostgreSQL 8.4 >> Restart Server.

$following command. C:\>cd dspace-1.5.$

47 After this open command prompt and go to DSpace directory by typing the following command. C:\>cd dspace src-release\dspace Then type mvn package

48 DOS Screen will start running like this

49 This may take a bit long (be sure your internet connection is running properly while performing this task. These two tasks are very critical, so better leave the system free while performing this. Play safe!!). If it successfully completes it must show this screen.

50 Yeah!! This will generate the installer package in your C:\dspace src-release\dspace\target\dspace build.dir directory. Now open command prompt and switch to C:\dspace src-release\dspace\target\dspace build.dir. with this command C:\>cd dspace src-release\dspace\target\dspace build.dir And now run this command here Ant fresh_install

51 After finishing the task, this will show this screen...

52 You made it dude!! Finally you need to copy directories of your dspace web applications (jspui, xmlui, oai) into your webservers folder. Dspace webapps directories are in C:/DSpace/webapps folder. You must copy 3 folders jspui, xmlui and oai and paste these folders in C:\Program Files\Apache Software Foundation\Tomcat 5.5\webapps Open your web browser and open the url Or You will see the following screen...

$Open command prompt and give the following command... C:\>DSpace\bin\dsrun org.dspace.administer.$

53 Now only thing required is just to create an Administrator account for DSpace. Open command prompt and give the following command... C:\>DSpace\bin\dsrun org.dspace.administer.createadministrator

Here it will ask you for some more inputs, like E-mail Address, first name, last name,

54 Here it will ask you for some more inputs, like Address, first name, last name, password, (while giving password be careful coz the console will display the password on the screen).

55 Ok your administrator account has been created. You can use this id and password to login on DSpace administrator window and to manage your Dspace from

56 And if your login is successful you can create community and collection in this window.

57 Now you will be able to browse your Dspace from any pc on the network. Congrats buddy!! U made it! Regards Rupinder singh Dhammu IIAS Shimla jesse@ .ru

Dspace Installation Guide (Windows 2003 Server)

Pre-requisite Software: Java Development Kit. PostgreSQL Apache Tomcat Apache Maven Apache ANT DSpace Dspace Installation Guide (Windows 2003 Server) 1. Java Development Kit: JDK is a development environment