a guide to dspace installation on
debian sqeeze 6.0.3 [revised]
Md. Rafiqur Rahman
Assistant Librarian (Electronic Resourc...
Prerequisite
 This guide assumes that you have minimal experiences and
understanding with Linux system administration for...
Java Runtime Configuration
 2. To avoid Java runtime misconfiguration, you have
to do this
 update-alternatives --config...
Downloading The Software Package
 3. Go to the following link location & download the latest src release of
dspace
 http...
Unpack the package
 4. Unpack the package Downloaded Software
Package. To unpack, please use the following
command-
 tar...
Creating The Dspace System
User
 5. Create Linux user account for Dspace
 useradd dspace
 Note: This step depends upon ...
Changing The Ownership
 6. Change ownership of newly unpacked directory
 chown -R dspace:dspace dspace-1.8.0-src-release...
Configuring The Postgresql
 7. The next step involves Postgresql. It requires you to change the file system permission
se...
Restarting The Postgresql
Server
 8. Restart Postgresql to use the modified configuration
 /etc/init.d/postgresql restart
Creating psql User and
Database
 9. Create Postgresql user account & database for
DSpace
 createuser -U postgres -d -A -...
Change the initial
configuration
 10. Change the initial configuration files of the
repository to build your own package-...
Change the initial configuration
(Cont…)
 # DSpace base host URL
 dspace.baseUrl = http://dspace.your-domain.edu:8080 or...
Change the initial
configuration (Cont…)
 # JDBC Driver
 #db.driver = ${default.db.driver} >>>>>> comment this
 db.driv...
Building Maven Package
 11. Build the Maven package
 cd dspace-1.8.0-src-release/dspace
 mvn package
 it will start do...
Running Ant
 12. Change directory to Dspace source directory and run ant
 cd dspace-1.8.0-src-release/dspace/target/dspa...
Setting up Webapps
 13. Setup your own webapps container for Tomcat
 Aad the DSpace webapps directory content to the
Tom...
Creating Initial Administrator Account
 14. Create the initial administrator account.
 cd /dspace/bin
 chmod 775 dspace...
Access on your repository
 15. Access your Dspace home page at
 http://dspace_server_address:8080/xmlui
 in general: ht...
Upcoming SlideShare
Loading in...5
×

Dspace installation on debian sqeeze 6 [revised]

2,036

Published on

Dspace installation on debian sqeeze 6 [revised]

Published in: Technology
4 Comments
3 Likes
Statistics
Notes
No Downloads
Views
Total Views
2,036
On Slideshare
0
From Embeds
0
Number of Embeds
1
Actions
Shares
0
Downloads
50
Comments
4
Likes
3
Embeds 0
No embeds

No notes for slide

Dspace installation on debian sqeeze 6 [revised]

  1. 1. a guide to dspace installation on debian sqeeze 6.0.3 [revised] Md. Rafiqur Rahman Assistant Librarian (Electronic Resources) East West University A/2 Jahurul Islam Avenue, Jahurul Islam City, Aftabnagar, Dhaka-1212, Bangladesh Mobile: +880-1912571724 Email: rafiqur83@gmail.Com Website: http://rafiqurrahman.zxq.net http://rafiq.uphero.Com
  2. 2. Prerequisite  This guide assumes that you have minimal experiences and understanding with Linux system administration for executing the necessary steps to reach the predefined goals.  1. First install software dependencies as follows:  apt-get install openjdk-6-jdk  apt-get install openjdk-6-jre  Apt-get install apache2 (if you don't have a previous installation)  apt-get install tomcat6  apt-get install maven (Ant is bundled with this package. No need to install separately)  apt-get install postgresql
  3. 3. Java Runtime Configuration  2. To avoid Java runtime misconfiguration, you have to do this  update-alternatives --config java  Then select the selection number that shows the following message & press enter:  /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 manual mode (for openjdk , option 1/2)
  4. 4. Downloading The Software Package  3. Go to the following link location & download the latest src release of dspace  http://sourceforge.net/projects/dspace/  You can use wget command to downloads it in the following way-  wget http://sourceforge.net/projects/dspace/files/DSpace%20Stable/1.8.0/d space-1.8.0-src-release.tar.gz
  5. 5. Unpack the package  4. Unpack the package Downloaded Software Package. To unpack, please use the following command-  tar -zxvf dspace-1.8.0-src-release.tar.gz
  6. 6. Creating The Dspace System User  5. Create Linux user account for Dspace  useradd dspace  Note: This step depends upon your accessibility, privileges & ownership of the software on the system.
  7. 7. Changing The Ownership  6. Change ownership of newly unpacked directory  chown -R dspace:dspace dspace-1.8.0-src-release  Note: This step depends on step 5
  8. 8. Configuring The Postgresql  7. The next step involves Postgresql. It requires you to change the file system permission setting to trust localhost connections you do this by editing the pg_hba.conf file.   nano /etc/postgresql/8.4/main/pg_hba.conf  When you open the file, scroll down to the last portion where you will see the following entries   # Database administrative login by Unix domain socket  #local all postgres ident >>>>>> comment this line and add line below  local all postgres trust   # TYPE DATABASE USER CIDR-ADDRESS METHOD  # “local” is for Unix domain socket connections only  #local all all ident >>>>>> comment this line and add line below  local all all trust
  9. 9. Restarting The Postgresql Server  8. Restart Postgresql to use the modified configuration  /etc/init.d/postgresql restart
  10. 10. Creating psql User and Database  9. Create Postgresql user account & database for DSpace  createuser -U postgres -d -A -P dspace  createdb -U dspace -E UNICODE dspace  key-in dspace when prompted for password and when asked to confirm password  key-in y when prompted to take action on role
  11. 11. Change the initial configuration  10. Change the initial configuration files of the repository to build your own package-  cd dspace-1.8.0-src-release/dspace/config/  nano dspace.cfg  This is the crucial part of a successful installation. So please make any change with special care, particularly on the following parameters:  # DSpace host name  dspace.hostname = dspace.your-domain-name.edu
  12. 12. Change the initial configuration (Cont…)  # DSpace base host URL  dspace.baseUrl = http://dspace.your-domain.edu:8080 or http://ip_address:8080  NOTE  – It is extremely important that you enter the correct information otherwise Dspace will not work  – If hostname is used, then an entry on your DNS server is a must. In BIND for exa mple  dspace.xxxxxx.edu. IN A x.x.x.x  # Name of the site  dspace.name — Dspace for AIIAS Hardinge Library  # Database name (“oracle”, or “postgres”)  #db.name = ${default.db.name} >>>>>>comment this entry  db.name = postgres >>>>>>uncomment this  #db.name = oracle  # URL for connecting to database  #db.url = ${default.db.url} >>>>>>comment this  db.url = jdbc:postgresql://localhost:5432/dspace >>>>>> uncomment this
  13. 13. Change the initial configuration (Cont…)  # JDBC Driver  #db.driver = ${default.db.driver} >>>>>> comment this  db.driver = org.postgresql.Driver >>>>>> uncomment this  # Database username and password  #db.username = ${default.db.username} __ comment these  #db.password = ${default.db.password} /  db.username = dspace __ uncomment these  db.password = dspace /  # SMTP mail server  mail.server = smtp.your-domain.edu  # From address for mail  mail.from.address = dspace-noreply@your-domain.edu  # Currently limited to one recipient!  feedback.recipient = dspace-help@your-domain.edu  # General site administration (Webmaster) e-mail  mail.admin = dspace-help@your-domain.edu
  14. 14. Building Maven Package  11. Build the Maven package  cd dspace-1.8.0-src-release/dspace  mvn package  it will start downloading a lot of jar and pom files… until you see something like this:  [INFO] Copying files to /home/rafiq/dspace-1.8.0-src-release/dspace/target/dspace-1.8.0-build  [INFO] ------------------------------------------------------------------------[INFO] Reactor Summary:  [INFO] ------------------------------------------------------------------------[INFO] DSpace Addon Modules .................................. SUCCESS [6:13.698s]  [INFO] DSpace XML-UI (Manakin) :: Web Application ............ SUCCESS [18:23.730s]  [INFO] DSpace LNI :: Web Application ......................... SUCCESS [58.337s]  [INFO] DSpace OAI :: Web Application ......................... SUCCESS [18.432s]  [INFO] DSpace JSP-UI :: Web Application ...................... SUCCESS [59.002s]  [INFO] DSpace SWORD :: Web Application ....................... SUCCESS [5.667s]  [INFO] DSpace SWORDv2 :: Web Application ..................... SUCCESS [2:39.825s]  [INFO] DSpace SOLR :: Web Application ........................ SUCCESS [3:40.907s]  [INFO] DSpace Assembly and Configuration ..................... SUCCESS [2:50.369s]  [INFO] ------------------------------------------------------------------------[INFO]  [INFO] BUILD SUCCESSFUL  [INFO] ------------------------------------------------------------------------[INFO] Total time: 36 minutes 14 seconds  [INFO] Finished at: Wed Nov 16 15:17:21 EST 2011  [INFO] Final Memory: 56M/68M
  15. 15. Running Ant  12. Change directory to Dspace source directory and run ant  cd dspace-1.8.0-src-release/dspace/target/dspace-1.8.0-build  ant fresh_install  this will start a process, connecting database and updating a lo t of files. Until you will see  something like this:  [echo] =========================================================  [echo] The DSpace code has been installed, and the database initialized.  [echo] To complete installation, you should do the following:  [echo] * Setup your Web servlet container (e.g. Tomcat) to look for your  [echo] DSpace web applications in: /dspace/webapps/  [echo] OR, copy any web applications from /dspace/webapps/ to  [echo] the appropriate place for your servlet container.  [echo] (e.g. '$CATALINA_HOME/webapps' for Tomcat)  [echo] * Make an initial administrator account (an e-person) in DSpace:  [echo] /dspace/bin/dspace create-administrator  [echo] * Start up your servlet container (Tomcat etc.)  [echo] You should then be able to access your DSpace's 'home page':  [echo] http://localhost:8080/xmlui  [echo] You should also be able to access the administrator UI:  [echo] http://localhost:8080/xmlui/dspace-admin  =========================================================  [echo]  BUILD SUCCESSFUL  Total time: 17 minutes 33 seconds
  16. 16. Setting up Webapps  13. Setup your own webapps container for Tomcat  Aad the DSpace webapps directory content to the Tomcat webapps directory.  cp -R /dspace/webapps/* /var/lib/tomcat6/webapps/
  17. 17. Creating Initial Administrator Account  14. Create the initial administrator account.  cd /dspace/bin  chmod 775 dspace  ./dspace create-administrator  Creating an initial administrator account  E-mail address: xxxxxxx@xxxxx.edu  First name: xxxxxxx  Last name: xxxxxxx  WARNING: Password will appear on-screen.  Password: your_password  Again to confirm: your_password  Is the above data correct? (y or n): y  Administrator account created
  18. 18. Access on your repository  15. Access your Dspace home page at  http://dspace_server_address:8080/xmlui  in general: http://localhost:8080/xmlui OR http://127.0.0.1:8080/xmlui
  1. A particular slide catching your eye?

    Clipping is a handy way to collect important slides you want to go back to later.

×