Contribute to the DSpace Development Fund
The newly established DSpace Development Fund supports the development of new features prioritized by DSpace Governance. For a list of planned features see the fund wiki page.
Contents
Installing DSpace on Windows
Running DSpace on Windows is actually rather similar to running it on any other operating system. For the most part, you should be able to follow the normal DSpace Installation Documentation. However, this page provides you with some hints that are specific to Windows.
Caution: These instructions are themselves in 'beta' See 'Notes' below.
You should also read the DSpace install docs corresponding to your DSpace version Make sure to look most closely at the section on "Windows Installation" in the System Documentation.
Pre-requisite Software
You'll need to install this pre-requisite software (for DSpace 1.5.x and higher). Check the "Windows Installation" section of the System Documentation for the most recent pre-requisites, as they sometimes differ based on the version of DSpace you are running.
- Java SDK of course; v 1.5+ For Ant to work properly, you should ensure that
JAVA_HOME
is set. (Why in the world the Sun installer doesn't do this, I know not.)
- PostgreSQL 8.x for Windows. This comes with a Windows installer app. Make sure the ODBC + JDBC options are selected, as well as the pgAdmin III tool.
- Apache Maven 2.0.8+. Just unzip it wherever you want it installed, and add
[path-to-apache-maven]\bin
to your systemPATH
.
- Apache Ant 1.7.x. Just unzip it wherever you want it installed, and add
[path-to-apache-ant]\bin
to your systemPATH
.
- Jakarta Tomcat 5.x+. This comes with a Windows installer app and is again easy to install.
General Installation Steps
- Get the DSpace software, download the source from SourceForge and untar it somewhere (WinZip will do this). Or better yet, grab a SVN checkout.
- Ensure the PostgreSQL service is running, and then run pgAdmin III (Start -> PostgreSQL 8.x -> pgAdmin III). Connect to the local database as the
postgres
user, and:- Create a 'Login Role' (user) called
dspace
with the passworddspace
(feel free to set your own password - Create a database called
dspace
owned by the userdspace
, with UTF-8 encoding
- Create a 'Login Role' (user) called
- Update paths in
[dspace-source]\dspace\config\dspace.cfg
.
Note: Use forward slashes /
for path separators, though you can still use drive letters, e.g.:
dspace.dir = C:/DSpace
- Create the directory for the DSpace installation (e.g.
C:\DSpace
)
- Build DSpace in the normal fashion. From
[dspace-source]\dspace
run:
mvn package
- Then install DSpace to your specified location. From
[dspace-source]\dspace\target\dspace-[version].dir
run:
ant fresh_install
- Create an administrator account, e.g. assuming
C:\dspace
is where your DSpace installation is:
C:\dspace\bin\dsrun.bat org.dspace.administer.CreateAdministrator
(then enter the required info)
- Copy the
.war
Web application files fromC:\dspace\webapps
to Tomcat'swebapps
dir, which should be somewhere likeC:\Program Files\Apache Software Foundation\Tomcat\webapps
- Start the Tomcat service
- Browse http://localhost:8080/dspace. You should see the DSpace home page!
Run Handle Server as a Service
See instructions at Handle Server Setup as Windows Service (using Tanuki)
Notes
- This should work for either Windows XP or Windows 7. Not tested on other versions of Windows.
- If you run into any problems with the PostgreSQL install, you may wish to refer to the PostgreSQL Windows FAQ
- Only
dsrun
has been translated to a Windows.bat
file. The other scripts (e.g.cleanup
,index-all
) won't work on Windows, hence you have to usedsrun.bat
with the class name as shown in the install steps above. You can run any other script by opening up the file, and finding the class name after "$BINDIR/dsrun". So, to runcleanup
on Windows, you'd instead rundsrun org.dspace.storage.bitstore.Cleanup
- No information yet about how to initialise regular scheduled tasks (e.g. e-mail notification of new items) – please feel free to add!!