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
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.
(then enter the required info)
____________________________________________________
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.
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
- 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
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)
- 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.)
- 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
- dsrun org.dspace.administer.CreateAdministrator
- 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
- Download dsrun.bat and buildpath.bat and copy them into C:/DSpace132/bin
Không có nhận xét nào:
Đăng nhận xét