DSpaceOnWindows

From DSpace Wiki

Jump to: navigation, search

Contents

[edit] Installing DSpace on Windows

As of version 1.2.2 beta 2, with its PostgreSQL 8.0 compatibility, running DSpace on Windows is much easier than it was previously. With a couple of Windows batch files (which you can download below), Cygwin is no longer required.

Caution: These instructions are themselves in 'beta' ;-) See 'Notes' below. Only tested on Windows XP.

You should also read the DSpace install docs corresponding to your DSpace version (for the latest stable version they're available online).

/OlderInstructions for pre-1.2.2 + Cygwin

[edit] Pre-requisite Software

You'll need to install this pre-requisite software.

  • Java SDK of course; v 1.4+ should work OK; J2SE 5.0+ is best. 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 an installer app now, so Cygwin is no longer required. Make sure the ODBC + JDBC options are selected, as well as the pgAdmin III tool.
  • Apache Ant 1.6.x. A little trickier to install. I just unzipped it in `C:\`, and added `C:\apache-ant-1.6.2\bin` to my `PATH`.

[edit] Installation Steps

  • Grab these two batch files and put them in `[dspace-source]/bin`. (Click the names to download.) (If they're already there, don't worry, it means we've put them in the main code base):
    • attachment:dsrun.bat
    • attachment:buildpath.bat
  • Copy the PostgreSQL JDBC driver across to the DSpace source tree. They'll be in `C:\Program Files\PostgreSQL\8.x\jdbc\`. `postgresql-8.x-yyy.jdbc2.jar` is the one you need, copy it to `[dspace-source]/lib`.
  • Ensure the PostgreSQL service is running, and then run pgAdmin III (Start -> PostgreSQL 8.0 -> pgAdmin III). Connect to the local database as the `postgres` user, and:
    • Create a 'Login Role' (user) called `dspace` with the password `dspace`
    • Create a database called `dspace` owned by the user `dspace`, with UTF-8 encoding
  • Update paths in `[dspace-source]\config\dspace.cfg`.

Note: Use forward slashes `/` for path separators, though you can still use drive letters, e.g.: 

 dspace.dir = C:/DSpace


Make sure you change all of the parameters with file paths to suit, specifically: 

 dspace.dir 
 config.template.log4j.properties 
 config.template.log4j-handle-plugin.properties
 config.template.oaicat.properties 
 assetstore.dir
 history.dir
 log.dir
 upload.temp.dir
 report.dir
 handle.dir


  • Create the directory for the DSpace installation (e.g. `C:\DSpace`)
  • Run: 
 ant fresh_install


  • Create an administrator account, e.g. assuming `C:\dspace` is where your DSpace installation is: 
 C:\dspace\bin\dsrun org.dspace.administer.CreateAdministrator

(then enter the required info)

  • Copy the `.war` Web application files from `[dspace-source]\build` to Tomcat's `webapps` dir, which should be somewhere like `C:\Program Files\Apache Software Foundation\Tomcat 5.5\webapps`
  • Start the Tomcat service

[edit] Notes

  • Only tested on Windows XP
  • When you install PostgreSQL 8.0, there is no option to use UNICODE or UTF-8 as the default locale. the installer FAQ has some details. I don't know if this will cause any problems with multi-byte characters (currently untested.)
  • 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 use `dsrun.bat` with the class name as shown in the install steps above
  • No information yet about how to initialise regular scheduled tasks (e.g. e-mail notification of new items) -- please feel free to add!!
  • More security info needed
  • Haven't tested everything (e.g. batch import/export). Theoretically, if the code is behaving wrt paths (e.g. using `File.separator`) everything should work OK.

added by Lester Bowser I have a test server running on windows 2003 enterprize Postgres 8.0.2 Tomcat 5.5.9 http://idcs0200.lib.iup.edu:8080/dspace Server has since been disabled by university.


added by SonoraMike just followed instructions above on win2kpro, all seems to be working ok so far. great instructions

Retrieved from "http://wiki.dspace.org/index.php/DSpaceOnWindows"
Personal tools