Installing Dspace 1.6.1 on Windows XP 
                 Gerard Sylvester (gerardsylvester@gmail.com)



Prerequisites 
 
J...
 
Accept the JAVA License Agreement  
 




                                                                              ...
Step 2: Setting Environment variables for JAVA

Add JAVA_HOME to your environment variables, goto  
START->SETTINGS->CONTR...
 
 




                                                                        
 
Create a Variable Key in the Environmen...
Also remember to add %CATALINA_HOME%/bin to your PATH 
 

          Step 4: Install PostGreSQL

 




                    ...
 
 




                                                                                
 
After PostGreSQL installs, it p...
 
 
In the Stack Builder select pgJDBC v8.4‐701‐1, DSpace needs just this Database Driver. 
Click next to proceed 
 
 



...
 
 
Once it is done, PostGreSQL is installed on your machine 
 
 

          Step 5: Configure username and database on Po...
 
 
After the server is started, right click on Login Roles and select New Login Role to create 
a new user 
 




       ...
 
                                             
                                             
Switch to the tab on Role Pr...
 
 
 
Save the settings by clicking on OK, now we go about creating a new database called as 
dspace. 
 
Right click on DA...
 
Remember, to add dspace as the owner of the database dspace and also the encoding 
to be UTF8 and the tablespace as pg_d...
Enter the path in the Environment variables as 
 
ANT_HOME and MAVEN_HOME 
 
Add %ANT_HOME%/bin; %MAVEN_HOME%bin; to the P...
You should get a output similar to  
 




                                                                               ...
 
 
 

         Step 10: Compiling DSpace

 
Compile DSpace source using MAVEN. 
 
Goto the DSpace source directory, c:dsp...
 
 
You will see outputs similar to the one below and might take a few minutes 
 




                                    ...
 
Goto the <dspace src directory>/dspace/target/dspace‐<version>‐build directory, it is 
c:dspace‐1‐6‐1‐src‐releasedspacet...
 
 
A lot of stuff takes place before you get this screen that says BUILD SUCCESSFUL 
 
 

         Step 12: Completing th...
Do you see the webapps directory in c:dspace as shown below? Now, that has to be 
copied to the tomcat directory as show ‐...
Now create a Administrator user for your DSpace installation, goto <drive>DSpacebin 
directory and execute dsrun org.dspac...
Upcoming SlideShare
Loading in …5
×

D Space Installation

5,332 views

Published on

Step-by-step guide to installing DSpace 1.6.1 on Windows XP machine

Published in: Technology, News & Politics
0 Comments
8 Likes
Statistics
Notes
  • Be the first to comment

No Downloads
Views
Total views
5,332
On SlideShare
0
From Embeds
0
Number of Embeds
3
Actions
Shares
0
Downloads
0
Comments
0
Likes
8
Embeds 0
No embeds

No notes for slide

D Space Installation

  1. 1. Installing Dspace 1.6.1 on Windows XP  Gerard Sylvester (gerardsylvester@gmail.com) Prerequisites    Java (version 1.6 in this document, J2SDK would do fine)  Apache Tomcat (version 5.5 in this document)  PostGreSQL (version 8.4.4.1 in this document)  Apache Ant (version 1.8.1 in this document)  Apache Maven (version 2.2.1 in this document)  DSpace (version 1.6.1 in this document)        Step 1: Install JAVA and JRE    
  2. 2.   Accept the JAVA License Agreement         JAVA is gets installed        Finish with JAVA installs        2 | document created on 14.July.2010 by Gerard Sylvester (gerardsylvester@gmail.com)
  3. 3. Step 2: Setting Environment variables for JAVA Add JAVA_HOME to your environment variables, goto   START->SETTINGS->CONTROL PANEL->SYSTEM->ADVANCED and click on  Environment Variables.         Create a new variable name called JAVA_HOME and enter the path to JAVA installed in  the previous step, click OK         Also remember to add %JAVA_HOME%/bin to your PATH    Step 3: Install Tomcat 3 | document created on 14.July.2010 by Gerard Sylvester (gerardsylvester@gmail.com)
  4. 4.         Create a Variable Key in the Environment Variables (as done for JAVA_HOME) for  Tomcat. Call the variable key as CATALINA_HOME and enter the path to your tomcat  installation.    4 | document created on 14.July.2010 by Gerard Sylvester (gerardsylvester@gmail.com)
  5. 5. Also remember to add %CATALINA_HOME%/bin to your PATH    Step 4: Install PostGreSQL           5 | document created on 14.July.2010 by Gerard Sylvester (gerardsylvester@gmail.com)
  6. 6.         After PostGreSQL installs, it prompts you to start with the stack builder, In the stack  builder select just your PostGreSQL installation as shown below.        6 | document created on 14.July.2010 by Gerard Sylvester (gerardsylvester@gmail.com)
  7. 7.     In the Stack Builder select pgJDBC v8.4‐701‐1, DSpace needs just this Database Driver.  Click next to proceed          Stack Builder connect to the internet to download the corresponding DB drivers   7 | document created on 14.July.2010 by Gerard Sylvester (gerardsylvester@gmail.com)
  8. 8.     Once it is done, PostGreSQL is installed on your machine      Step 5: Configure username and database on PostGres We now, configure PostGreSQL and create a new user called as dspace and a database  called dspace.    Start pgAdmin III from your START-> PROGRAMS-POSTGRESQL 8.4 link        Start the PostgreSQL 8.4 service by right clicking on the server name and chose  CONNECT  8 | document created on 14.July.2010 by Gerard Sylvester (gerardsylvester@gmail.com)
  9. 9.     After the server is started, right click on Login Roles and select New Login Role to create  a new user        Follow the instructions as shown in the screenshot below to create a new user called as  dspace          9 | document created on 14.July.2010 by Gerard Sylvester (gerardsylvester@gmail.com)
  10. 10.       Switch to the tab on Role Privileges and make the settings as shown below  10 | document created on 14.July.2010 by Gerard Sylvester (gerardsylvester@gmail.com)
  11. 11.       Save the settings by clicking on OK, now we go about creating a new database called as  dspace.    Right click on DATABASE under the server name in the initial pgAdmin III screen and  create a new database called as dspace as shown below  11 | document created on 14.July.2010 by Gerard Sylvester (gerardsylvester@gmail.com)
  12. 12.   Remember, to add dspace as the owner of the database dspace and also the encoding  to be UTF8 and the tablespace as pg_default. Keep postgres running.      Step 6: ANT and MAVEN configurations Extract and configure ANT and MAVEN; extract these two zip files to any location on  your harddisk.       12 | document created on 14.July.2010 by Gerard Sylvester (gerardsylvester@gmail.com)
  13. 13. Enter the path in the Environment variables as    ANT_HOME and MAVEN_HOME    Add %ANT_HOME%/bin; %MAVEN_HOME%bin; to the PATH                    Step 7: Check settings   Check to see if JAVA, ANT and MAVEN have been configured correctly  Goto COMMAND PROMPT (START->RUN->CMD) and type the following    C:> ANT – version  C:>MAVEN –version  C:> JAVA –version    13 | document created on 14.July.2010 by Gerard Sylvester (gerardsylvester@gmail.com)
  14. 14. You should get a output similar to         Remember, we will refer to C: as the <drive> henceforth   Step 8: Onto DSpace   Unzip/Untar the DSpace SRC to a folder on your harddisk, also create a new directory  called DSpace in the same drive.        Step 9: Proxy for MAVEN   MAVEN needs a proxy to access the internet (this is only if you are connected to the  internet through a proxy).     Goto your MAVEN directory and navigate to conf directory. Edit settings.xml and look  for the place where you have to enter any proxy settings, if needed. SAVE and EXIT    14 | document created on 14.July.2010 by Gerard Sylvester (gerardsylvester@gmail.com)
  15. 15.       Step 10: Compiling DSpace   Compile DSpace source using MAVEN.    Goto the DSpace source directory, c:dspace‐1.6.1‐src‐release in my this document.    Execute mvn –Dmaven.test.skip=true clean package install  (or mvn package). Some  packages are downloaded from the internet and others extracted from the source     c:dspace-1.6-1-src-release>mvn package (OR)  c:dspace-1.6-1-src-release>mvn –Dmaven.test.skip=true clean package install 15 | document created on 14.July.2010 by Gerard Sylvester (gerardsylvester@gmail.com)
  16. 16.     You will see outputs similar to the one below and might take a few minutes        Finally the BUILD SUCCESSFUL will be shown if all went well.      Step 11: Compiling with ANT 16 | document created on 14.July.2010 by Gerard Sylvester (gerardsylvester@gmail.com)
  17. 17.   Goto the <dspace src directory>/dspace/target/dspace‐<version>‐build directory, it is  c:dspace‐1‐6‐1‐src‐releasedspacetargetdspace‐1‐6‐1‐build.dir in this document, and  execute ant fresh_install as shown below ‐    c:dspace-1-6-1-src-releasedspacetargetdspace-1-6-1-build.dir> ant fresh_install       A compiling report similar to the one shown below should be generated; at the end of it  you would find a BUILD SUCCESSFUL message. This step should take a slightly longer  time to execute.  17 | document created on 14.July.2010 by Gerard Sylvester (gerardsylvester@gmail.com)
  18. 18.     A lot of stuff takes place before you get this screen that says BUILD SUCCESSFUL      Step 12: Completing the installation   Now, goto <drive>/dspace, it is c:dspace in this document, and you would find a folder  called a WEBAPPS, copy that folder to your tomcat’s director replacing the existing  webapps of tomcat.  18 | document created on 14.July.2010 by Gerard Sylvester (gerardsylvester@gmail.com)
  19. 19. Do you see the webapps directory in c:dspace as shown below? Now, that has to be  copied to the tomcat directory as show ‐          My tomcat installation is at c:program filesapache software foundationtomcat 5.5,  delete the webapps found in this directory and copy and paste the webapps found in  c:dspace.            Step 13: Create Administer for your dSpace installation 19 | document created on 14.July.2010 by Gerard Sylvester (gerardsylvester@gmail.com)
  20. 20. Now create a Administrator user for your DSpace installation, goto <drive>DSpacebin  directory and execute dsrun org.dspace.administer.CreateAdministrator    c:dspacebin> dsrun org.dspace.administer.CreateAdministrator   Follow the instructions to create a super user for your dspace installation.    Step 14: Voila! DSpace is installed   Start Tomcat, Check if PostGreSQL is running and then navigate to     http://localhost:8080/xmlui for the MANDAKINI theme of DSpace and  http://localhost:8080/jspui for the JSP interface of DSpace            20 | document created on 14.July.2010 by Gerard Sylvester (gerardsylvester@gmail.com)

×