Manual de Instalación del Dspace 6.0

1.0 Descarga de paquetes necesarios para la instalación

Para la instalación del dspace son necesario los siguientes paquetes.

Update :

        apt-get update

Upgrade :

        apt-get upgrade

Instalar OpenJDK 8 :

         apt-get install openjdk-8-jdk

Apache Maven 3.x y Apache ant :

         apt-get install ant maven

PostgreSQL :

        apt-get install postgresql postgresql-contrib

Apache Tomcat 8 :

        apt-get install tomcat8

2.0 Crear el Usuario Dspace

Luego de haber instalado los paquetes necesarios procedemos a crear un usuario para el dspace

        useradd -m dspace

        passwd dspace

3.0 Crear usuario para la base de datos Dspace

Ahora se procede a crear el usuario para la base de datos en postgre para ello:

Ingresar con el usuario postgres:

        sudo su postgres

A continuación, crearemos una base de datos llamada "dspace" y un usuario de base de datos denominado "dspace" con la contraseña "dspace".

        createuser -U postgres -d -A -P dspace

Al ejecutar este comando introduzca la contraseña, luego de ello salgase del usuario postgres con el comando

        exit

4.0 Crear la base de datos 'dspace' de PostgreSQL

Ya con el usuario creado procederemos a crear la base de datos

     sudo su dspace

     createdb -U dspace -E UNICODE dspace

     exit

5.0 Añadir extensión pgcrypto a la base de datos

Para añadir la extensión ejecutaremos los siguientes comandos:

     sudo su postgres

     psql --username=postgres dspace -c "CREATE EXTENSION pgcrypto;"

     /etc/init.d/postgresql restart

6.0 Descargar el Dspace

Para la descargar el paquete del dspace es necesario crear un directorio desde este se ejecutara la instalación en este caso el directorio sera /build

     mkdir /build

     chmod -R 755 /build

     cd /build

Para la descarga:

     wget https://github.com/DSpace/DSpace/releases/download/dspace-6.0/dspace-6.0-src-release.tar.gz

     tar -zxf dspace-6.0-src-release.tar.gz

7.0 Configuración Básica de el Dspace

Para realizar la configuración del Dspace es necesario dirigirse al directorio config

cd /build/dspace-6.0-src-release/dspace/config

• luego abrir el archivo dspace.cfg con su editor de texto preferido

En la siguiente tabla se detallara parte de la configuración Básica

9.0 Añadir un nuevo campo a la tabla de búsqueda.

Para añadir un nuevo campo a la tabla de búsqueda descomentamos la linea donde se encuentra

    webui.itemlist.columns

eliminando el # y agregamos el campo deseado, partiendo del nombre que tiene en los medatados en este caso se desea agregar el campo materia el cual es llamado:

     dc.subject.

En este caso la linea webui.itemlist.columns quedaría

webui.itemlist.columns = dc.date.issued(date),dc.title, dc.subject, dc.contributor.*

10.0 Modificar mensajes para el nuevo campo.

Debido a que el sistema no trae este campo se le debe agregar al los mensajes para que no aparezca como si fuese un error para ello es necesario dirigirse a la siguiente ruta

cd /build/dspace-6.0-src-released/dspace.api/src/main/resources

Alli encontraran un archivo llamado Messages.properties cual posee los mensajes del sistema en ingles a este se le agregara la linea

itemlist.dc.subject       = Subject

Para que en el campo agregado me muestre la palabra Subject en el caso del sistema estar en ingles.

En el caso de el idima español añadir el siguiente archivo en la misma ruta el cual ya contiene lo cambios realizados.

Messages_es.properties

11.0 Desempaquetar e instalar.

Antes de desempaquetar eliminar del archivo

/build/dspace-6.0-src-release/dspace-api/pom.xml

las siguientes lineas

<plugin>

<groupId>org.codehaus.mojo</groupId>

<artifactId>buildnumber-maven-plugin</artifactId>

<version>1.4</version>

<executions>

<execution>

<phase>validate</phase>

<goals>

<goal>create</goal>

</goals>

</execution>

</executions>

</plugin>

Para desempaquetar nos dirigimos a:

cd /build/dspace-6.0-src-release

y ejecutamos el siguiente comando

mvn -fn package

Luego creamos el directorio para la instalación

mkdir /dspace

chown dspace /dspace

y procedemos a realizar la instalación

cd dspace/target/dspace-installer

ant fresh_install

12.0 Configurar Tomcat 8

Añadir a

nano /etc/profile

las siguientes lineas:

export CATALINA_BASE=/var/lib/tomcat8

export CATALINA_HOME=/usr/share/tomcat8

Guardar los cambios y ejecutar el siguiente comando:

source /etc/profile

13.0 Creación de enlaces simbólicos

Dirigirse al directorio webapps del tomcat y ejecutar los siguientes comandos:

ln -s /dspace/webapps/xmlui
ln -s /dspace/webapps/jspui ROOT
ln -s /dspace/webapps/solr
ln -s /dspace/webapps/sword
ln -s /dspace/webapps/swordv2

14.0 Configurar tomcat y java para solución al error java.lang.OutOfMemoryError: Java heap space

Abrir el archivo :

nano /etc/default/tomcat8

y modificar los valores tal cual como se encuentran a continuación:

# You may pass JVM startup parameters to Java here. If unset, the default

# options will be: -Djava.awt.headless=true -Xmx128m -XX:+UseConcMarkSweepGC

JAVA_OPTS="-Djava.awt.headless=true –Xmx768m –Xms128m -XX:MaxPermSize=1024m"

# Use "-XX:+UseConcMarkSweepGC" to enable the CMS garbage collector (improved

# response time). If you use that option and you run Tomcat on a machine with

# exactly one CPU chip that contains one or two cores, you should also add

# the "-XX:+CMSIncrementalMode" option.

JAVA_OPTS="-Djava.awt.headless=true -Xmx512m -XX:+UseConcMarkSweepGC"

Luego abrir el archivo:

nano /etc/init.d/tomcat8

y modificar los valores tal cual como se encuentran a continuación:

# Default Java options

# Set java.awt.headless=true if JAVA_OPTS is not set so the

# Xalan XSL transformer can work without X11 display on JDK 1.4+

# It also looks like the default heap size of 64M is not enough for most cases

# so the maximum heap size is set to 128M

if [ -z "$JAVA_OPTS" ]; then

JAVA_OPTS="-Djava.awt.headless=true -Xmx1024M"

Abrir

nano /etc/environment

y agregar al final las siguientes lineas:

JAVA_HOME="/usr/lib/jvm/default-java"

JAVA_OPTS="-Djava.awt.headless=true -Xmx1024m -Xms512m -Dfile.encoding=UTF-8"

Luego se procede a dar los permisos necesarios al dspace y reiniciar el tomcat

chown tomcat8:tomcat8 /dspace -R

/etc/init.d/tomcat8 restart

15.0 Migrar datos del Dspace 3.0 al 6.0.

Primero realizar copia de seguidad de la base de datos del Dspace el cual se quiere actualizar para ello se debe usar el comando pg_dump por ejemplo:

pg_dump -U [database-user] -f my-dspace-db-backup.sql [database-name]

también se debe realizar una copia de seguridad del directorio assetstore.

Luego de realizar estos dos pasos se procede a actualizar la base de datos del Dspace Actual con el siguiente comando:

psql -U [database-user] -f my-dspace-db-backup.sql dspace-upgrade

Ya al realizar este proceso se pega el directorio assetstore dentro de la carpeta de instalación del dspace y se procede al ejecutar el siguiente comando:

/dspace/bin/dspace index-discovery –f