====== DSpace ======

  * [[en:filetype:dspace|DSpace]]: Importing DSpace collections into Greenstone, and exporting Greenstone collections as DSpace format.
  * [[en:plugin:dspaceplugin|DSpacePlugin]]

===== Installing DSpace =====

Old notes about Dspace installation.

  *Install Prerequisites:
    * Linux
    * Java 1.4 or later
    * Apache Ant 1.5 or later
    * PostgreSQL 7.3 or later
    * Jakarta Tomcat 4.x/5.x: already exist in the system: /research/chi/gsdl3/comms/jarkata/tomcat/

  * Step 1: Installation-PostgreSQL setting
<code>     * modify /home/chi/local/pgsql/data/postgresql.conf => tcpip_socket = true
    * modify /home/chi/local/pgsql/data/pg_hba.conf => host  all chi  130.217.244.123  255.255.255.255 trust
                                                 => recommended by DSPace: host dspace chi  127.0.0.1 
                                                     255.255.255.255 md5</code> 

  * Step 2: DSpace configuration setting
<code>  dspace.url : https://toetoe.cs.waikato.ac.nz:9090/dspace
 dspace.hostname: toetoe.cs.waikato.ac.nz
 dspace.name:
 ds.username: chi
 db.password: letmein
 mail.server: smtp.cs.waikato.ac.nz
 mail.from.address:
 feedback.recipient:
 mail.admin:
 alert.recipiemt: chi@cs.waikato.ac.nz
 Note that if you change dspace.dir, you'll also need to change other properties with values that start with /dspace e.g. assetstore, dir, log.dir</code> 

  * Step 3: Install DSpace
<code>  *create the directory for the DSpace installation: /home/chi/local/dspace; chown chi [[dspace]]
 * cd [[dspace-source]]; ant fresh_install
 * cp [[dspace-source]]/build/*.war [[tomcat]]/webapps
 * create an initial administrator : [[dspace]]/bin/create-administrator</code> 

  * Step 4: Start PostgreSQL database server
<code>  $ postmaster -D /home/chi/local/pgsql/data >logfile 2>&1 &
 or
 $ pg_ctl stop -D /home/chi/local/pgsql/data
 This will enable the server run as a background</code> 

  * Step 5: Startup Tomcat
<code>  $ cd /reseach/chi/gsdl3/comms/jakarta/tomcat/bin
 $ startup.sh (shutdown.sh to shutdown the server)</code> 

  * Step 6: Running Dspace through the web:

<code>  http://toetoe.cs.waikato.ac.nz:9090/dspace</code> 

  * Problems:
  - wrong version of Java: the system was using 1.3.XXX but need JAVA 1.4 or later version
 solution from the Web:
   Check which version of java your system is trying to use in the path, the
   script that [[dspace]]\bin\dsrun (which create-administrator calls) uses the
   version it finds in the path (it ignores JAVA_HOME)

   The two solutions that I know of is to modify the path for your system so
   that no other versions of java exist in it, or to modify the
   [[dspace]]\bin\dsrun script to reference the correct version of java.  AFAIK,
   this only effects this one particular script (and not the normal operations
   of dspace or tomcat).

   Add this  line in dsrun:
   PATH=/opt/sun-jdk-1.4.2.06/bin:/opt/sun-jdk-1.4.2.06/jre/bin:$PATH

   *Import Collection to DSpace
 <code> $ /home/chi/local/dspace
 $ bin/dsrun org.dspace.app.itemimport.ItemImport --add --eperson=chi@cs.waikato.ac.nz --collection=collectionID
   --source=item_dir --mapfile=mapfile
 or
 $ bin/dsrun org.dspace.app.itemimport.ItemImport -a -e chi@cs.waikato.ac.nz -c collectionID -s item_dir -m mapfile</code> 

  *Exporting Items in DSpace
<code>  $ /home/chi/local/dspace
 $ bin/dsrun org.dspace.app.itemexport.ItemExport --type=COLLECTION --id=collID --dest=dest_dir --number=seq_num
 or
 $ bin/dsrun org.dspace.app.itemexport.ItemExport --type=ITEM --id=itemID --dest=dest_dir --number=seq_num</code> 

  *Exporting METS in DSpace
<code>  $ /home/chi/local/dspace
 $ bin/dsrun org.dspace.app.mets.METSExport --item [[handle]]
 or
 $ bin/dsrun org.dspace.app.mets.METSExport --collection hdl:1234567898
 or
 $ bin/dsrun org.dspace.app.mets.METSExport --all</code> 

  *Log in My Dspace
<code>  user : chi@cs.waikato.ac.nz
 password: chi (letmein)</code> 

  *Postgres -- Run a Postgres single-user backend
<code>  postgres dbname
 postgres -B nBuffers -C -D DataDir -E -F -O -P -Q -S SortSize -d DebugLevel -e -o OutputFile -s -v protocol dbname</code> 

  *Shutdown PostgreSQL server
<code>  $ pg_ctl stop -D /home/chi/local/pgsql/data</code> 

  *Shutdown Tomcat
<code>  $ cd /reseach/chi/gsdl3/comms/jakarta/tomcat/bin> shutdown.sh</code>