dspace - centos installation

clique aqui para post em português

== Prerequisites ==
CentOS-5.5
wget

== Installing JDK ==

Downloading packages. Download from the site http://www.oracle.com/technetwork/java/javase/downloads/index.html, execute the .bin and create the environment variables bellow.

Environment variables (yum didn't do this automaticaly in my instalation)
vim /root/.bash_profile
export JAVA_HOME=/usr/src/jdk1.6.0_22/
export PATH=$PATH:$JAVA_HOME/bin

Also run the following lines
export JAVA_HOME=/usr/src/jdk1.6.0_22/
export PATH=$PATH:$JAVA_HOME/bin


== Installing apache maven ==

Download the packages from "http://maven.apache.org/download.html".
My decompression was done in /usr/src/apache-maven-3.0.1. THIS DIRECTORY CAN TO CHANGE depending the version that you are using, pay attention to the paths bellow, you may have to change them.
Download and decompress the packages:
wget http://www.apache.org/dyn/closer.cgi/maven/binaries/apache-maven-3.0.1-bin.tar.gz
tar -xzvf apache-maven-3.0.1-bin.tar.gz

Environment variables:
vim /root/.bash_profile
export PATH=$PATH:/usr/src/apache-maven-3.0.1/bin

Also run the following lines:
export PATH=$PATH:/usr/src/apache-maven-3.0.1/bin

Test your configuration
mvn --version


== Installing apache-ant ==

Installation directory
cd /usr/src

You can to download the package from "http://ant.apache.org/bindownload.cgi", however pay attention to the paths names, you may have to change them. I'm downloading the version 1.8.1
Download and decompress the packages in /usr/src:
wget http://mirror.pop-sc.rnp.br/apache//ant/binaries/apache-ant-1.8.1-bin.tar.gz
tar -xzvf apache-ant-1.8.1-bin.tar.gz

Environment variables:
vim /root/.bash_profile
export ANT_HOME=/usr/src/apache-ant-1.8.1/
export PATH=$PATH:$ANT_HOME/bin/

Also run the following lines:
export ANT_HOME=/usr/src/apache-ant-1.8.1/
export PATH=$PATH:$ANT_HOME/bin/

Check if the installation is correct running the following commando, its return must be what's in quotes:
ant -version
"Apache Ant version 1.8.1 compiled on April 30 2010"


== Installing the postgres data base==

Downloading the packages
yum install postgresql84-server postgresql84-libs postgresql84

Starting initial configuration of postgres:
su - postgres
initdb -E utf-8 /var/lib/pgsql/data
exit

Enabling TCP/IP connections by JDBC, just comment the line that has "listen_addresses"
vi /var/lib/pgsql/data/postgresql.conf
.
.
.
#listen_addresses = 'localhost'
.
.
.


Allowing local connections in postgres, add the line "host dspace...":
vi /var/lib/pgsql/data/pg_hba.conf
.
.
.
host dspace dspace 127.0.0.1 255.255.255.255 md5
.
.
.

Restart the service to commit the settings:
/etc/init.d/postgresql restart

Configuring postgres to startup automaticaly:
chkconfig postgresql on

== Installing tomcat ==

Installing the repository that has tomcat for yum:
cd /etc/yum.repos.d/
wget http://www.jpackage.org/jpackage50.repo

Downloading the packages:
yum install tomcat6 tomcat6-webapps tomcat6-admin-webapps --skip-broken

Answer "yes" to the questions about GPG keys:
Importing GPG key 0xC431416D "JPackage Project (JPP Official Keys) " from http://www.jpackage.org/jpackage.asc
Is this ok [y/N]: y

Environment variables:
vim /root/.bash_profile
export TOMCAT_USER=tomcat

Also run the following lines:
export TOMCAT_USER=tomcat

Add the attribute URIEncoding into the server.xml file:
vi /etc/tomcat6/server.xml
.
.
.
<connector port="8080" protocol="HTTP/1.1" connectiontimeout="20000" redirectport="8443" uriencoding="UTF-8">
.
.
.

Remove the tomcat repository. If you want to keep it, jump this line.
rm -f /etc/yum.repos.d/jpackage50.repo

Configuring tomcat to startup automaticaly:
chkconfig tomcat6 on


== Installing perl ==

Downloading the packages
yum install perl

== Installing dspace ==

Download the sources from "http://sourceforge.net/projects/dspace/"
The files were decompressed in "/usr/src/".

Create a database for dspace
createuser -U postgres -d -A -P dspace ; createdb -U dspace -E UNICODE dspace

Execute the package installation command:
cd /usr/src/dspace-1.6.2/dspace
mvn package

Building the packages:
cd /usr/src/dspace-1.6.2/dspace/target/dspace-1.6.2-build.dir/
ant fresh_install

After the execution of the "ant" command, the "dspace" installation will be create in the root directory "/dspace".
Deploy the installation to tomcat:
cp -R /dspace/webapps/* /var/lib/tomcat6/webapps

Create an administrator user for the dspace. Bear in mind: it will ask an e-mail, this e-mail will be your login.
/dspace/bin/create-administrator

Restart the tomcat service
/etc/init.d/tomcat6 restart

Test the dspace installation:
http://YOUR_SERVER_ADDRESS:8080/jspui/

== Possibles errors ==

"Unable to locate the Javac Compiler in: /usr/lib/jvm/java-1.6.0-openjdk-1.6.0.0.x86_64/jre/../lib/tools.jar"
Do not use only the package "*openjdk*" from yum, it isn't complete. Install the JDK like I teach in "Installing JDK".

"WARNING: error instantiating 'org.apache.juli.ClassLoaderLogManager' referenced by java.util.logging.manager, class not found java.lang.ClassNotFoundException: org.apache.juli.ClassLoaderLogManager not found"
If you installed the JDK like I teached in "Installing JDK", complete the installation (only if necessary) with "yum" command. Some packages may be missing.
yum install java-1.6.0-openjdk.x86_64

"org.postgresql.util.PSQLException: Connection refused. Check that the hostname and port are correct and that the postmaster is accepting TCP/IP connections."
This happens because the postgres connection. Check if the service is running or if the login and password are correct, as well the IP, selinux rules, firewall rules, etc...

"The program package-cleanup is found in the yum-utils package"
Resolve the dependencies:
yum install yum-utils


SORRY MY ENGLISH, I'M LEARNING YET!