|
|
> **[!]IMPORTANTE[!]**: página en construcción
|
|
|
> **[!] IMPORTANTE [!]**: página en construcción
|
|
|
|
|
|
## Configuración de Tomcat
|
|
|
Para instalar y configurar Apache Tocamt leer la documentación [Configuración de Tomcat para DSpace](https://github.com/crai-unrn/DSpace/wiki/Configuraci%C3%B3n-de-Tomcat-para-DSpace)
|
|
|
|
|
|
### Deploy de las aplicaciones web de DSpace
|
|
|
Existen dos tecnicas u opciones para que tomcat encuentre las aplicaciones web de nuestro DSpace:
|
|
|
|
|
|
#### Técnica A
|
|
|
Indicar la instalación de la aplicación web a Tomcat mediante un archivo XML alojado en `[tomcat]/conf/Catalina/localhost`. Por ejemplo:
|
|
|
|
|
|
```sh
|
|
|
nano /etc/tomcat8/conf/Catalina/localhost/jspui.xml
|
|
|
```
|
|
|
|
|
|
```xml
|
|
|
# Define un contexto para la interfaz JSPUI de DSpace
|
|
|
<?xml version='1.0'?>
|
|
|
<Context
|
|
|
docBase="[dspace]/webapps/jspui"
|
|
|
reloadable="true"
|
|
|
cachingAllowed="false"
|
|
|
/>
|
|
|
```
|
|
|
De la misma forma, podemos crear contextos adicionales para las demás aplicaciones web de DSpace. Tener en cuenta que, por lo mínimo, deberemos crear contextos para JSPUI y/o XMLUI, SOLR y OAI.
|
|
|
|
|
|
> **Aclaración**: El nombre del archivo (sin incluir el sufijo "_.xml_") será el nombre del contexto Por ejemplo, `jspui.xml` define el contexto en `http://host:8080/jspui`
|
|
|
|
|
|
Para definir un contexto raíz utilizando esta técnica:
|
|
|
```sh
|
|
|
nano /etc/tomcat8/conf/Catalina/localhost/ROOT.xml
|
|
|
```
|
|
|
```xml
|
|
|
# Define un contexto RAÍZ para la interfaz JSPUI de DSpace
|
|
|
<?xml version='1.0'?>
|
|
|
<Context
|
|
|
docBase="[dspace]/webapps/jspui"
|
|
|
reloadable="true"
|
|
|
cachingAllowed="false"
|
|
|
/>
|
|
|
```
|
|
|
De esta forma, `ROOT.xml` define el contexto en `http://host:8080`, dejando más limpia la url de nuestro repositorio.
|
|
|
|
|
|
> La configuración de contexto de Tomcat anterior muestra la adición de lo siguiente a cada elemento <Context>:
|
|
|
`reloadable="true"` y `cachingAllowed="false"`. Esta configuración es extremadamente útil cuando recién comienza a utilizar DSpace, ya que le permite modificar el DSpace XMLUI (XSLTs o CSS) o JSPUI (JSPs) y ver cómo Tomcat recarga sus cambios automáticamente (sin tener que reiniciar el servicio). Sin embargo, vale la pena señalar que la documentación de Apache Tomcat recomienda que los sitios de producción dejen los valores predeterminados en su lugar (`reloadable = "false"` y `cachingAllowed = "true"`), ya que permitir que Tomcat recargue automáticamente todos los cambios puede generar una "sobrecarga de tiempo de ejecución significativa".
|
|
|
|
|
|
#### Técnica B
|
|
|
Es una técnica simple y completa que permite a Tomcat, mediante enlaces simbólicos, conocer el directorio en todo momento de las aplicaciones web de DSpace.
|
|
|
|
|
|
```sh
|
|
|
ln -s [dspace]/webapps/jspui [tomcat]/webapps/jspui
|
|
|
ln -s [dspace]/webapps/solr [tomcat]/webapps/solr
|
|
|
ln -s [dspace]/webapps/oai [tomcat]/webapps/oai
|
|
|
```
|
|
|
De igual manera, podemos asignar un contexto ROOT, llamando al directorio de esa misma forma. Ejemplo:
|
|
|
```sh
|
|
|
ln -s [dspace]/webapps/jspui [tomcat]/webapps/ROOT
|
|
|
```
|
|
|
|
|
|
## Configuración de Apache Server
|
|
|
En un servidor de producción para aplicaciones DSpace, generalmente se utiliza un Apache Web Server como punto de entrada a DSpace. En este caso podemos configurar Apache Web como un **proxy reverso o inverso** para ocultar los servidores que contienen realmente las aplicaciones web. En este enfoque, DSpace es levantado por un Web Container, como por ejemplo Apache Tomcat, y todas las solicitudes hacia Tomcat son manejadas primero por Apache Web Server y luego son pasadas a Tomcat.
|
... | ... | @@ -12,7 +69,7 @@ apt-get install apache2 |
|
|
Seguir atentamente los pasos de la guía [Configurar Apache Server](https://github.com/crai-unrn/DSpace/wiki/Configurar-Apache-Server)
|
|
|
|
|
|
### Configurar SOLR para que sea accesible desde Apache
|
|
|
> **[!]Importante[!]**: tener en cuenta que hay que restringir el acceso a la ruta hacia SOLR (por ejemplo `/solr`) desde la configuración del proxy reverso (p.e. desde Apache HTTPD).
|
|
|
> **(!) Atención (!)**: tener en cuenta que hay que restringir el acceso a la ruta hacia SOLR (por ejemplo `/solr`) desde la configuración del proxy reverso (p.e. desde Apache HTTPD).
|
|
|
|
|
|
Agregar al archivo [vhost de Apache](https://github.com/crai-unrn/DSpace/wiki/Configurar-Apache-Server#crear-archivo-vhost-de-dspace) lo siguiente:
|
|
|
```xml
|
... | ... | |