...

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.

...

You should also read the DSpace install docs corresponding to your DSpace version (for the latest stable version they're available online). 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.

...

• 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.

• Wiki Markup[Apache Maven 2.0.8\+|http://maven.apache.org/download. html]. Just unzip it wherever you want it installed, and add {{\[path-to-apache-maven\]\bin}} to your system {{PATH}}. Wiki Markup[

• Apache Ant 1.7.x|http://ant.apache.org/]. Just unzip it wherever you want it installed, and add {{\[path-to-apache-ant\]\bin}} to your system {{PATH}}.

• 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 password dspace (feel free to set your own password
  • Create a database called dspace owned by the user dspace, with UTF-8 encoding

• Wiki MarkupUpdate 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)

• Wiki MarkupBuild DSpace in the normal fashion. From {{\[dspace-source\]\dspace\}} run:

mvn package

• Wiki MarkupThen 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\dspace.bat dsrun org.dspace.administer.CreateAdministrator

...

• 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.

...