Versions Compared

Old Version 5

changes.mady.by.user Tim Donohue

Saved on

compared with

New Version 6

changes.mady.by.user Tim Donohue

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updates to instructions on how to run DSpace remotely

...

Download the Database App Development VM image from http://www.oracle.com/technetwork/database/enterprise-edition/databaseappdev-vm-161299.html and import it into virtualbox as a new appliance. I increased the memory for the virtual machine to 3 GB.

...

Initialize virtual machine

Start the virtual machine (as per instructions on the download page, use username+password oracle).

...

(Thanks to user-6062e for the SQL statements.)

Install DSpace on VM OR Run DSpace Remotely

One you have the (empty) database created on this Oracle Virtual Machine, you have two options (choose one):

  1. You can run DSpace remotely (e.g. on your host machine), and just point it at this Oracle Virtual Machine (see: "Run DSpace Remotely")
  2. OR, you can install DSpace directly on this Oracle Virtual Machine and run it there (see: "Install DSpace on Virtual Machine")

 

Info

The remainder of this how-to assumes that you wish to run a test DSpace instance in the virtual machine. If you prefer to run DSpace on the host machine instead, you could instead set up port forwarding for the Virtualbox appliance and use only the database in the virtual machine. In that case, skip the rest of this how-to.

Run DSpace Remotely

If you chose this option, we are assuming you have DSpace installed elsewhere (e.g. on your host machine). 

  1. Follow these instructions to set up port forwarding for this Virtual Machine: http://tombuntu.com/index.php/2008/12/17/configure-port-forwarding-to-a-virtualbox-guest-os/
  2. On the machine where your DSpace is installed, you will need to do the following:
    1. Download the latest Oracle OJDBC JAR from http://www.oracle.com/technetwork/database/enterprise-edition/jdbc-112010-090769.html

    2. Install this JAR into your local Maven cache (~/.m2):

      Code Block
      mvn install:install-file -Dfile=[path-to-downloads]/ojdbc6.jar -DgroupId=com.oracle -DartifactId=ojdbc6 -Dversion=11.2.0.4.0 -Dpackaging=jar -DgeneratePom=true

    3. Rebuild your DSpace with Oracle enabled: 

      Code Block
      mvn -Ddb.name=oracle package
# NOTE: If the version of the Oracle OJDBC JAR has changed, you may need to update the Parent POM to have the correct version
# See the "com.oracle" dependency: https://github.com/DSpace/DSpace/blob/master/pom.xml#L1082

Install DSpace on Oracle Virtual Machine

Install build tools

The virtual machine image comes with ant preinstalled, but the version is too old (1.6.4). There is no maven installation on the machine.

...

export ANT_HOME=$HOME/software/ant/bin

Build + install DSpace

Download the source distribution of DSpace (https://github.com/DSpace/DSpace/archive/dspace-3.0.tar.gz for DSpace 3.0) and unpack the tarball. I then renamed the directory to ~/dspace-src.

...

Info

It may not be readily apparent from the example config lines above, but the SID used by the Oracle VirtualBox image is "orcl".

Install Tomcat

Tomcat isn't installed on the virtual machine. Download the binary distribution from http://tomcat.apache.org/; I used Tomcat 6 and installed it into ~/software/tomcat by unpacking the downloaded tarball and symlinking the directory. You will also need to copy the ojdbc6.jar file that you downloaded in the previous step into ~/software/tomcat/lib.

...