Versions Compared

Old Version 1

changes.mady.by.user Unknown User (wiki_transfer)

Saved on

compared with

New Version 2

changes.mady.by.user Bradley McLean

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. bash() shell and environment variables
  2. Redhat + package + and + service + management.

It assumes the RHEL 5 Supplementary package channel is available, which provides Sun's Java and which requires registration with RHN, the following packages are expected to be available

...

Note: set the environment variables for JAVA_HOME and JRE_HOME as described in the environment section.

Code Block


 # to cut to the chase.. you may try this in your .bash_profile

 x='/etc/java/java.conf'
 [ -a "$x" ] && source "$x"

 x='/etc/tomcat5/tomcat5.conf'
 [ -a "$x" ] && source "$x" 

 export JAVA_HOME

 # then in the shell try
 printenv |fgrep -i java

 # to obtain 
 JAVA_HOME=/usr/lib/jvm/java

...

Code Block
<!-- DEFINE A CONTEXT PATH FOR DSpace JSP User Interface  -->
<Context path="/jspui" docBase="/usr/local/dspace/webapps/jspui" debug="0" reloadable="true" cachingAllowed="false" allowLinking="true"/>

<!-- DEFINE A CONTEXT PATH FOR DSpace XML User Interface (Manakin) -->
<Context path="/xmlui" docBase="/usr/local/dspace/webapps/xmlui" debug="0" reloadable="true" cachingAllowed="false" allowLinking="true"/>
	
<!-- DEFINE A CONTEXT PATH FOR DSpace OAI User Interface  -->
<Context path="/oai" docBase="/usr/local/dspace/webapps/oai" debug="0" reloadable="true" cachingAllowed="false" allowLinking="true"/>

...

Add the following in /home/dspace/.bash_profile..

Code Block


x='/etc/java/java.conf'
[ -a "$x" ] && source "$x"

x='/etc/tomcat5/tomcat5.conf'
[ -a "$x" ] && source "$x" 

export JAVA_HOME

# This value is decided after installing apache maven
export PATH=/usr/local/maven/bin:$PATH

# UNDER CONSTRUCTION
export CLASSPATH=/usr/local/dspace/lib:$CLASSPATH

...

Panel

cd /home/dspace/.m2/repository/org/apache/maven/plugins/maven-site-plugin/

From http://repo1.maven.org/maven2/org/apache/maven/plugins/maven-site-pluginImage Removed

get 2.0-beta-6/maven-site-plugin-2.0-beta-6.jar

...

Code Block
 cd /home/dspace/src/LATEST/dspace
 mvn clean package > /var/tmp/mvn_clean_package_log 2>&1

 # to view progress, at another terminal window, use
 tail /var/tmp/mvn_clean_package_log

 # at this stage, if there are warnings about missing environment variables
 # you should refer to the section on setting environment variables above

 # on completion, you should see

[INFO] ------------------------------------------------------------------------
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 7 minutes 48 seconds
[INFO] Finished at: Mon Jan 12 12:35:07 EST 2009
[INFO] Final Memory: 23M/51M
[INFO] ------------------------------------------------------------------------

 # if the target directory does not exist
 # go through the mvn_clean_package_log and look for
 # any lines with the word 'missing'
 # a network resource could have been unreachable

 cd /home/dspace/src/LATEST/dspace/target/dspace-1.5.1-build.dir

 # to initialise and install the database and DSpace
 ant fresh_install

 # to create the administrator account 
 cd /usr/local/dspace/bin
 ls -l create-administrator
  -rwxrw-r-- 1 dspace dspace 2121 Jan 13 15:45 create-administrator
 ./create-administrator

 # you then see ...
  Creating an initial administrator account
  E-mail address: [change]
  First name: [set]
  Last name: [set]
  WARNING: Password will appear on-screen.
  Password: 
  Again to confirm: 
  Is the above data correct? (y or n): y
  Administrator account created

...

  1. See 5.1.1. of 1.5.1. Dspace Manual
Code Block

## in the build target directory, to expose the ant switches

$ ant -p
Buildfile: build.xml

====================== DSpace platform build file ======================

Common usage:

  Fresh install, including database setup and registry loading:
    % ant fresh_install
  
  Update existing installation, leaving data and configuration intact:
    % ant -Dconfig=/installdir/config/dspace.cfg update

========================================================================
  
Main targets:

 build_webapps_wars  Compress Web Applications into .war files
 clean_database      Removes DSpace database tables, destroying data
 fresh_install       Do a fresh install of the system, overwriting any data
 load_registries     Load initial contents of registries
 setup_database      Create database tables
 update              Update installed code and web applications (without clobber
ing data/config)
 update_code         Update installed code (without clobbering data/config)
 update_webapps      Update Web Applications (without clobbering data/config)
Default target: help
Code Block


 when you change DS_SRC/LATEST/dspace/config/dspace.cfg 
 go to DS_SRC/LATEST/dspace/target/dspace-X.Y.Z-build.dir and 
 run '''ant init_configs''' for settings to apply

 when you change DS_DST/config/dspace.cfg
 run DS_DST/bin/install_configs for settings to apply

 for settings to apply across applications you may need 
 to restart processes such as tomcat5

...

Point your web browser to the setting for dspace.url in dspace.cfg

Panel

http://localhost:8080/jspuiImage Removed
http://localhost:8080/jspui/dspace-adminImage Removed

Redirecting web-server port 80 requests to tomcat servlet

...

To install the JAI components, download the Java Advanced Imaging API (jre version) and the Java Advanced Imaging - Image I/O Tools from http://java.sun.com/products/java-media/jai/current.htmlImage Removed.

JAI Imaging API

...

...

Unfortunately, the version of Tomcat 5 that is packaged with RHEL5 does not work cleanly with the proprietary Javas (including Sun's). Fortunately, the binary distribution of Tomcat 5.5 that you can download from the Tomcat website installs and runs cleanly.

Download

Wiki Markup
Grab the tarball of the *Core* version of Tomcat 5.5 \[ download site\|http://tomcat.apache.org/download-55.cgi\] and put it in /tmp directory.

Install

Change to the dspace user, copy it to the dspace user's home directory and extract it.

Code Block
[privuser@dhost ~]$ sudo su - dspace
[dspace@dhost ~]$ cp /tmp/apache-tomcat-5.5.26.tar.gz ./
[dspace@dhost ~]$ tar zxf apache-tomcat-5.5.26.tar.gz 
[dspace@dhost ~]$ exit
[privuser@dhost ~]$

As root, move the extracted apache-tomcat-5.5.x directory to /usr/local/

...

You should now be able to see DSpace running as the root application on port 8080 of your host, e.g. http://www.example.com:8080/Image Removed

Set Up mod_proxy_ajp

...

Check your site, e.g. go to http://www.example.com/Image Removed with your browser.

...