Many people writes to me saying that my article on installing DSpace on Windows was very helpful to them. That article was written on based on DSpace 1.2.2. Later I found that there’s a lot of scope for improvement; but couldn’t do it because of my busy schedule. Now DSpace is in version 1.3.2. Now I’m modifying the previous article and making it more explanatory, including many common errors people get stuck with.
We need the following softwares to work with DSpace:
1. Tomcat (which needs JDK to run)
2. Apache Ant
3. Postgresql Database Server
Now I’ll explain how to install each of them:
Tomcat 5.5.17Download Tomcat here
Tomcat needs JDK (Java Development Kit). So if you have JDK already installed, it’s fine. Otherwise get latest JDK 5 Update 6 here (Click on ‘accept the license and download windows offline installer). Before installing JDK, check whether you have JRE (Java Runtime Environment) installed on your system or not. You can check this by going to Control panel->Add Remove Programs and seeing the list. If JRE is listed there, uninstall it first and then install JDK. Installation is straightforward.
Install Tomcat using the windows installer. While installing, It’ll ask you for setting a password for the Tomcat administrator; give any password you want. It’ll also ask for the JAVA path; point it to the folder where you installed JDK. After installation, go to Control Panel->Advanced-> Environment variables and add a new variable JAVA_HOME with value set to C:/Program Files/Java/jdk1.5.0_06 (or whatever your JDK is) and also add C:/Program Files/ Java/jdk1.5.0_06/bin to the system path.
Download Ant(choose any of the files-zip,gz or bz2) and extract it to C:/Ant. As in the case of JDK, add ANT_HOME as a new environment variable with C:/ant/bin as value. Also add C:/ant/bin to the path
1. Install using windows installer.
2. Go to Start menu->programs->PostgresSQL->start service and then go to pgAdmin, connect to the database server
3. Create a user ‘dspace’ with password ‘dspace’
4. Create a database ‘dspace’ owned by the user ‘dspace’, with UNICODE encoding
Download DSpace from http://prdownloads.sourceforge.net/dspace/dspace-1.3.2-source.tar.gz?download
Extract the downloaded zip file into C:/DSpace132
- Download dsrun.bat and buildpath.bat and copy them into C:/DSpace132/bin
- Copy C:\Program Files\PostgreSQL\8.0\jdbc\postgresql-8.0-310.jdbc2.jar to C:/DSpace132/lib
- Edit C/Dspace132/config/dspace.cfg
- Set dspace.dir = C:/DSpace (Because DSpace will be installed in this directory. If you are planning to install DSpace in some other folder, give that value there.)
- Similarly set all the paths to C:/DSpace/ (or wherever you want to install DSpace)
- Create C:/DSpace folder
- In DOS prompt, change to C:/Dspsce132 and type ant fresh_install
Tip: If you get an error saying that “ant is not recognized as an internal/external command, type C:\Ant\bin\ant fresh_install
- Then DSpace will be built and necessary files and folders will be created in C:/DSpace (or wherever you set the installation path)
- Then change to C:/DSpace/bin (in DOS) and type following commands
- dsrun org.dspace.administer.CreateAdministrator
- dsrun org.dspace.browse.InitializeBrowse
- dsrun org.dspace.search.DSIndexer
- Now two files-dspace.war and dspace-oai.war must have appeared in C:/Dspace132/build. Copy them to C:\Program Files\Apache Software Foundation\Tomcat 5.5\webapps
- Start/Restart Tomcat service
- Go to http://localhost:8080/dspace/Then you should be able to see the DSpace Home page.
Please post your comments/problems using the Comments link below. Keep in mind that, since I’m not a DSpace expert, I may not be able to answer all technical queries. So better post them in the DSpace Forums or to the DSpace mailing list at DRTC, Bangalore
Some of the required softwares for DSpace are available for download in .tar or .tar.gz format. You may need a program to uncompress these file. I recommend the open source program 7-zip.This program can be used to compress and uncompress files