Dspace on Windows
Transcript of Dspace on Windows
![Page 1: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/1.jpg)
Dspace Installation Guide (Windows 2003 Server)
Pre-requisite Software:
Java Development Kit.
PostgreSQL
Apache Tomcat
Apache Maven
Apache ANT
DSpace
1. Java Development Kit: JDK is a development environment for building applications, applets, and components using the Java programming language. You can download it from: http://www.oracle.com/technetwork/java/javase/downloads/index.html
2. 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: http://www.postgresql.org/download/windows
3. 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: http://tomcat.apache.org/download-60.cgi
4. 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: http://maven.apache.org/download.html
5. 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: http://ant.apache.org/bindownload.cgi
6. DSpace: You know about it already, this will be everything you’ll need to set up a repository. You will get it at: http://sourceforge.net/projects/dspace/files
7. First of all download all above mentioned softwares and save it in one folder.
![Page 2: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/2.jpg)
Software versions used:
JAVA SDK: jdk-6u24-windows-i586.exe
APACHE MAVEN: apache-maven-3.0.3-bin.zip
APACHE ANT: apache-ant-1.8.2-bin.zip
APACHE TOMCAT: apache-tomcat-7.0.11.exe
POSTGRESQL: postgresql-9.0.3-1-windows.exe
DSPACE: dspace-1.8.0-src-release.zip
At first install JDK.
Double click and execute the installer file of Java which you have downloaded. (jdk-6u24-windows-i586.exe)
![Page 3: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/3.jpg)
Another installer will start for installing JRE. Click next.
![Page 4: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/4.jpg)
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 click Properties.
![Page 5: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/5.jpg)
Go to Advanced TAB. And click on Environmental variables.
Here select PATH in system variables section and click EDIT button.
![Page 6: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/6.jpg)
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.
Paste this path in system variable window, Use ; as a separator. Click ok
![Page 7: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/7.jpg)
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_24
Paste here the path of you java home directory in program files.
Click ok, and apply the settings.
![Page 8: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/8.jpg)
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:\
This will make the folder of apache maven in C drive.
![Page 9: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/9.jpg)
Extract the files of apache ant into C drive, same way. And a folder for apache ant will be created in C drive.
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-3.0.3\bin” (use semicolon to add with existing Path)
![Page 10: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/10.jpg)
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.
Click ok.
So all system paths are defined.
C:\Program Files\Java\jdk1.6.0_24\bin; C:\apache-maven-3.0.3\bin; C:\apache-ant-1.8.2\bin.
![Page 11: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/11.jpg)
Ok it’s done!!....now define ANT_HOME in user variables
Variable name: ANT_HOME
Variable value: C:\apache-ant-1.8.2
Click ok and apply the settings.
All system paths and user variables are defined.
We can also check, what we have done till now.
![Page 12: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/12.jpg)
Open command prompt and run the following command to see the java version
java -version
Same way you can check
ant -version
mvn –version
and the command prompt will show the following screen.
![Page 13: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/13.jpg)
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.
Click next.
Click I Agree.
![Page 14: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/14.jpg)
Click next
In this window give your username and password, that will give you access to monitor and control your tomcat server web interface.
Then click next.
![Page 15: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/15.jpg)
Make sure that your java virtual machine path is appropriate with your JRE installation folder.
Click next.
Click Install
![Page 16: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/16.jpg)
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.
Double click the Installer file of postgreSQL. And installer will start.
Click Next
![Page 17: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/17.jpg)
Check installation directory and click next.
Check data directory and click next.
![Page 18: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/18.jpg)
In this window you must provide the database password which will allow you to administrate your DATABASE.
Click next.
Check DATABASE port no. The port no. should be 5432.
Click next.
![Page 19: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/19.jpg)
Installation will start.
You may be asked to “Launch Stack Builder at Exit” Please do not check if you don’t want to install additional tools (not required for DSpace). Click on Finish button to complete the installation
![Page 20: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/20.jpg)
Ok. So postgreSQL has been installed. And now we will create database and login rolls. ..
So open pgAdmin III
pgAdmin will start.
![Page 21: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/21.jpg)
Click on small icon of postgreSQL 9.0 (localhost:5432)
Database will start... and then create login role.
Right click on Login roles icon and click New Login Role.
![Page 22: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/22.jpg)
Now create a user named ‘dspace’ with your desired password (in this case password is ‘dspace’) as shown in following screen and click OK. Then open role privileges tab.
Tick mark on icons named: Can create database objects, and can create roles. And then click ok.
![Page 23: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/23.jpg)
Login role is created. Now create Database.
To create a data base right click on “Databases” and click on “New Database” as shown in figure below:
You will get following screen, in that enter database name as ‘dspace’ , select Owner as ‘dspace’ and choose Encoding as ‘UTF8’ (this is required for handling multilingual data) and click on ok button.
![Page 24: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/24.jpg)
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.
A directory “dspace-1.8.8-src-release” will be created in C drive.
![Page 25: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/25.jpg)
Here you create one more folder named “DSpace” in C drive
Open C:\dspace-1.8.0-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.
Change it to. dspace.dir = C:/DSpace
Here you can also make other changes. Like your mail server, your Dspace URL.
![Page 26: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/26.jpg)
Make other changes if you want to, those are optional, (you will be able to do it later also). But above mentioned change is compulsory. After changing it, save and close the file.
Once you have edited dspace configuration file open the command prompt and go to “C:\ dspace-1.8.0-src-release \dspace” folder
Now type “mvn package” and press enter
Please note that internet connection is required to perform this operation, Maven will download dspace source dependencies online.
When the execution is successfully over you will get following message:
Now go to “C:\ dspace-1.8.0-src-release\dspace\target\dspace-1.8.0-build” on command prompt
CD C:\ dspace-1.8.0-src-release\dspace\target\dspace-1.8.0-build and execute command “ant fresh_install”.
![Page 27: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/27.jpg)
After successful execution you will get following message:
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 7.0\webapps
Open your web browser and open the url http://localhost:8080/jspui
Or http://localhost:8080/xmlui
You will see the following screen...
![Page 28: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/28.jpg)
Now it is time to create default system administrator. To create administrator execute following command: C:\dspace\bin\dspace create-administrator
Here it will ask you for some more inputs, like E-mail Address, first name, last name, password, (while giving password be careful coz the console will display the password on the screen).
Ok your administrator account has been created.
![Page 29: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/29.jpg)
You can use this email id and password to login on DSpace administrator window and to manage your Dspace from http://localhost:8080/jspui/password-login or http://localhost:8080/xmlui/password-login.
And if your login is successful you can create community and collection in this window.
![Page 30: Dspace on Windows](https://reader031.fdocuments.net/reader031/viewer/2022013120/577ccd281a28ab9e788ba683/html5/thumbnails/30.jpg)