S/W requirements

We have tested the software on Windows XP, Windows 2000 Professional and Windows 2003 server

Windows OS (Windows XP/Windows 2000 professional/Windows 2000 Server/Windows 2003 Server)

Following other packages to run on Windows platform

Java 1.4 or later (standard SDK is fine, you don't need J2EE)
Apache Ant 1.5 or later (Java make-like tool)
PostgreSQL 7.3 or later, an open source relational database, or Oracle 9 or higher.
Jakarta Tomcat 4.x/5.x or equivalent, such as Jetty or Caucho Resin.
Dspace software

Installation of Java (JDK):

1. Download Java 1.4 or later (standard SDK is fine, you don't need J2EE).

Note: Apache-tomcat-5.5.17 works with jdk-1_5.x+

2. Double click the file jdk-1_5_0_06-windows-i586-p.exe and follow the instructions

Select the folder to install jdk

3. Put the java program into system path by setting PATH environment variable.

�� Right click My Computer->Properties->Advance->Environment Variables->System Variables->path->Edit

Add the text �Program Files\java\jdk1.5.0_06\bin and press Ok.

4. Define JAVA_HOME environment variable.

Right click My Computer->Properties->Advance->Environment Variables->System Variables->path->New

Set the environment variable as above. Click Ok to save it.

Installation of apache-ant

This package is needed to compile Dspace source

1. Download the zip file of the windows version of Apache-Ant (apache-ant-1.6.2-bin.zip)

2. Extract into a folder like C drive.

3. It creates a folder apache-ant-1.6.2. Rename it as ant

4. Add C:\ant\bin into PATH environment variable.

5. Right click My Computer->Properties->Advance->Environment Variables->System Variables->path->Edit

�� Click Ok to save it

Installation of Postgres database server

Note: Make sure your C or any other drive where Postgres is to be installed is formatted as NTFS file system.

If not use the command below to convert it to NTFS. At command prompt type the command:

convert� c: /FS:NTFS

and press enter. It will ask to schedule it at next booting time. Enter yes and reboot the system.

When you boot the system it will convert the FAT32 file system to NTFS.

It takes some time to do it. Now system is ready to install Postgres database server.

Steps

Download the file postgresql-8.1.3-1.zip or any other version of Postgres database software for Windows.
Extract it to any directory like C:\pgsql.
Double click the file postgresql-8.1.exe from the extracted folder (C:\pgsql) (Windows installer package)

and follow the instructions.

Click Start

Click Next

Click Next

Select the location (select default location) and click Next

Set the password for a account postgres to run PostgreSQL database server.

If this account does not exist in the Windows, then will be prompted to create it. Say yes to create account.

Select the default option and click Next

Select default option and click Next

Complete the installation by clicking Finish.

Create dspace user and dspace database in PostgreSQL database server

Start->Run and type the command cmd to go to command prompt
Type the following commands
cd C:\Program Files\PostgreSQL\8.1\bin
createuser -U postgres -d -A -P dspace

Enter password for new role:�� (Enter dspace database user password)

Enter it again:�� (confirm it)

Shall the new role be allowed to create more new roles? (y/n): ( Enter yes)

createdb -U dspace -E UNICODE dspace

Password: �� (Enter dspace password)

Installation of Jakarta Tomcat

Download the file apache-tomcat-5.5.17.exe (or apache-tomcat-5.5.17+)
Double click the file apache-tomcat-5.5.17.exe and follow the instructions

Choose the port 8080 and admin password

Locate the JRE path if not detected by default

Installation of Dspace

Download Dspace source and extract into a directory like C:\Dspace (Rename to Dspace)
Copy the PostgreSQL JDBC driver C:\Program Files\PostgreSQL\8.1\jdbc\postgresql-8.1-404.jdbc3.jar

to C:\Dspace\lib folder

Open the file C:\Dspace\config\dspace.cfg and make changes

dspace.dir = C:/dspace

dspace.url = http://IP_No_of_Machine or hostname/:8080/dspace

dspace.hostname =� hostname or IP No of M/C

dspace.name = DSpace repository name (like IR@youruniversity)

config.template.log4j.properties = c:/dspace/config/log4j.properties

config.template.log4j-handle-plugin.properties = c:/dspace/config/log4j-handle-plugin.properties

config.template.oaicat.properties = c:/dspace/config/oaicat.properties

mail.server=host or IP no of your server

mail.from.address = dspace-noreply@your_email_ID

Go to command prompt (Start->Run then type cmd)
ant� fresh_install
Create Initial Administrator Account
You need to download� two files (dsrun.bat, buildpath.bat) from the sites http://wiki.dspace.org/DSpaceOnWindows?action=AttachFile&do=get&target=dsrun.bat and http://wiki.dspace.org/DSpaceOnWindows?action=AttachFile&do=get&target=buildpath.bat
Copy these two files in C:\Dspace\bin and run the command
dsrun org.dspace.administer.CreateAdministrator
Supply the password
Copy the files dspace.war and dspace-oai.war from the folder C:\Dspace\build to

C:\Program Files\Apache Software Foundation\Tomcat 5.5\webapps folder

Restart tomcat (Start->Programs->Apache Tomcat 5.5->Monitor Tomcat->Restart)
Open browser and browse the URL http://IP_No_of_Machine:8080/dspace

The default home page of Dspace looks like below:

Congratulation!
____________________________________________________
other installation

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

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 system PATH.

Apache Ant 1.7.x. 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

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 org.dspace.administer.CreateAdministrator

(then enter the required info)

Copy the .war Web application files from C:\dspace\webapps to Tomcat's webapps dir, which should be somewhere like C:\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 use dsrun.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 run cleanup on Windows, you'd instead run dsrun 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!!
!!!________________________!!!
And other version

How to Install DSpace on Windows

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.

Ant 1.6.5
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

PostgresSQL 8.1
(http://wwwmaster.postgresql.org/download/mirrors-ftp?file=binary%2Fv8.1.3%2Fwin32%2Fpostgresql-8.1.3-1.zip)
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

DSpace 1.3.2
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

Note: 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

Dịch vụ hữu ích

Thứ Sáu, 15 tháng 7, 2011

Install Dspace on Windows