#acl jesusp:read,write InformaticaGrupo:read,write All:read
= 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
||<tablewidth="931px" tableheight="426px"50%  style="border-top:1px solid #000000;border-bottom:1px solid #000000;border-left:1px solid #000000;border-right:none;padding-top:0.1cm;padding-bottom:0.1cm;padding-left:0.1cm;padding-right:0cm">dspace.dir                       = /dspace ||<50%  style="border:1px solid #000000;padding:0.1cm">Directorio                         donde se desea instalar el Dspace  en este caso es /dspace ||
||<50%  style="border-top:none;border-bottom:1px solid #000000;border-left:1px solid #000000;border-right:none;padding-top:0cm;padding-bottom:0.1cm;padding-left:0.1cm;padding-right:0cm">dspace.ui =                    jspui ||<50%  style="border-top:none;border-bottom:1px solid #000000;border-left:1px solid #000000;border-right:1px solid #000000;padding-top:0cm;padding-bottom:0.1cm;padding-left:0.1cm;padding-right:0.1cm">Interfaz a                        usar por defecto en este caso  se utilizara la jspui ||
||<50%  style="border-top:none;border-bottom:1px solid #000000;border-left:1px solid #000000;border-right:none;padding-top:0cm;padding-bottom:0.1cm;padding-left:0.1cm;padding-right:0cm">dspace.url                     = http://repositoriodigital.fundacite-merida.gob.ve/ ||<50%  style="border-top:none;border-bottom:1px solid #000000;border-left:1px solid #000000;border-right:1px solid #000000;padding-top:0cm;padding-bottom:0.1cm;padding-left:0.1cm;padding-right:0.1cm">Url  por la                        cual se va acceder al dspace en este caso es :                  http://repositoriodigital.fundacite-merida.gob.ve/ ||
||<50%  style="border-top:none;border-bottom:1px solid #000000;border-left:1px solid #000000;border-right:none;padding-top:0cm;padding-bottom:0.1cm;padding-left:0.1cm;padding-right:0cm">dspace.name                    = Repositorio Digital FUNDACITE M\u00erida ||<50%  style="border-top:none;border-bottom:1px solid #000000;border-left:1px solid #000000;border-right:1px solid #000000;padding-top:0cm;padding-bottom:0.1cm;padding-left:0.1cm;padding-right:0.1cm">Nombre el                    cual va a utilizar el dspace ( En este caso la letra é se escribe                       \u00e debido a que posee acento). ||
||<50%  style="border-top:none;border-bottom:1px solid #000000;border-left:1px solid #000000;border-right:none;padding-top:0cm;padding-bottom:0.1cm;padding-left:0.1cm;padding-right:0cm">default.language                       = es_VE ||<50%  style="border-top:none;border-bottom:1px solid #000000;border-left:1px solid #000000;border-right:1px solid #000000;padding-top:0cm;padding-bottom:0.1cm;padding-left:0.1cm;padding-right:0.1cm">Idioma por                      defecto ||
||<50%  style="border-top:none;border-bottom:1px solid #000000;border-left:1px solid #000000;border-right:none;padding-top:0cm;padding-bottom:0.1cm;padding-left:0.1cm;padding-right:0cm">db.username                    = dspace ||<50%  style="border-top:none;border-bottom:1px solid #000000;border-left:1px solid #000000;border-right:1px solid #000000;padding-top:0cm;padding-bottom:0.1cm;padding-left:0.1cm;padding-right:0.1cm">Nombre de                      usuario de la base de datos ||
||<50%  style="border-top:none;border-bottom:1px solid #000000;border-left:1px solid #000000;border-right:none;padding-top:0cm;padding-bottom:0.1cm;padding-left:0.1cm;padding-right:0cm">db.password                    = dspace ||<50%  style="border-top:none;border-bottom:1px solid #000000;border-left:1px solid #000000;border-right:1px solid #000000;padding-top:0cm;padding-bottom:0.1cm;padding-left:0.1cm;padding-right:0.1cm">Contraseña                     de usuario de la base de datos ||
||<50%  style="border-top:none;border-bottom:1px solid #000000;border-left:1px solid #000000;border-right:none;padding-top:0cm;padding-bottom:0.1cm;padding-left:0.1cm;padding-right:0cm">default.locale                         = es ||<50%  style="border-top:none;border-bottom:1px solid #000000;border-left:1px solid #000000;border-right:1px solid #000000;padding-top:0cm;padding-bottom:0.1cm;padding-left:0.1cm;padding-right:0.1cm">Idioma ||
||<50%  style="border-top:none;border-bottom:1px solid #000000;border-left:1px solid #000000;border-right:none;padding-top:0cm;padding-bottom:0.1cm;padding-left:0.1cm;padding-right:0cm">webui.supported.locales                        = es, en ||<50%  style="border-top:none;border-bottom:1px solid #000000;border-left:1px solid #000000;border-right:1px solid #000000;padding-top:0cm;padding-bottom:0.1cm;padding-left:0.1cm;padding-right:0.1cm">Para que                       soporte diferentes idiomas en este caso tiene la opción de                      español y ingles ||




== 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.

[[attachment: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
}}}