Instalación del portal¶

Note

Obtener aquí la última versión del fichero unredd-portal.war.

La instalación del portal se realiza mediante el copiado del fichero .war de la aplicación al directorio webapps de la instancia Tomcat. Por ejemplo:

sudo cp unredd-portal.war /var/lib/tomcat/webapps/portal.war

En respuesta a esta acción, Tomcat descomprimirá los contenidos del WAR en un directorio con el mismo nombre que el fichero .war y la aplicación se podrá acceder en:

http://localhost:8080/portal/

Para exponer la aplicación por el puerto HTTP 80 a través de Apache2, editar el fichero /etc/apache2/sites-enabled/000-default.conf y añadir lo siguiente bajo <VirtualHost *:80>:

ProxyPass        /portal ajp://localhost:8009/portal
ProxyPassReverse /portal ajp://localhost:8009/portal

Reiniciar el servidor:

sudo service apache2 restart

Y acceder a:

http://localhost/portal/

Configuración del portal¶

Para la personalización del portal es necesario crear un directorio de configuración en /var/portal. Se puede encontrar un directorio de configuración de ejemplo en el portal desempaquetado en la operación anterior, en /var/lib/tomcat/portal/webapps/portal/WEB-INF/default_config. La forma más fácil de crear el directorio de configuración es tomar el de ejemplo como base:

sudo mkdir /var/portal
sudo cp -R /var/tomcat/webapps/portal/WEB-INF/default_config/* /var/portal/

Y luego, hay que indicar a la aplicación cuál es la nueva ubicación. Editar /etc/default/tomcat, añadiendo la opción PORTAL_CONFIG_DIR a JAVA_OPTS:

...
PORTAL_CONFIG_DIR=/var/portal
...
JAVA_OPTS="... -DPORTAL_CONFIG_DIR=$PORTAL_CONFIG_DIR"

El resultado final de /etc/default/tomcat7 sería:

JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64
GEOSERVER_DATA_DIR=/var/geoserver
PORTAL_CONFIG_DIR=/var/portal

JAVA_OPTS="-server -Xms1560m -Xmx2048m -XX:PermSize=256m -XX:MaxPermSize=512m -XX:+UseConcMarkSweepGC -XX:NewSize=48m -Dorg.geotools.shapefile.datetime=true -Duser.timezone=GMT -DGEOSERVER_DATA_DIR=$GEOSERVER_DATA_DIR -Dfile.encoding=UTF-8 -DMINIFIED_JS=true -DPORTAL_CONFIG_DIR=$PORTAL_CONFIG_DIR"

Y reiniciamos tomcat:

sudo service tomcat7 restart

Funcionalidades con acceso a base de datos¶

Para algunas funcionalidades, como la herramienta de feedback o las estadísticas, el portal interactúa con una base de datos. Para configurar el acceso a la base de datos será necesario configurar dos cosas: la conexión a la base de datos y el esquema en el que se meten las tablas que necesita el portal.

Conexión¶

La conexión se configura en un fichero META-INF/context.xml existente dentro del directorio de la aplicación, en webapps, por ejemplo:

<Context copyXML="true">

    <!-- Default set of monitored resources -->
    <WatchedResource>WEB-INF/web.xml</WatchedResource>

    <!-- Uncomment this to disable session persistence across Tomcat restarts -->
    <!--
    <Manager pathname="" />
    -->

    <!-- Uncomment this to enable Comet connection tacking (provides events
         on session expiration as well as webapp lifecycle) -->
    <!--
    <Valve className="org.apache.catalina.valves.CometConnectionManagerValve" />
    -->

        <Resource name="jdbc/unredd-portal" auth="Container" type="javax.sql.DataSource"
                driverClassName="org.postgresql.Driver" url="jdbc:postgresql://postgis.unredd:5432/spatialdata"
                username="spatial_user" password="unr3dd" maxActive="20" maxIdle="10"
                maxWait="-1" />

</Context>

En concreto en el elemento Resource. Dicho elemento debe tener:

Un atributo name con valor “jdbc/unredd-portal”, que es el que buscará el portal.
Un atributo url con la URL para conectar a la base de datos.
Atributos username y password con las credenciales para conectar a la URL anterior.

Si se instala un .war genérico lo más probable es que este recurso no esté adaptado a la situación de nuestro servidor. Por ejemplo, si tenemos el servidor de base de datos en el mismo servidor que corre el portal, la URL deberá hacer referencia a 127.0.0.1, en lugar de “postgis.unredd”. Para configurarlo correctamente tendremos que modificar este fichero. Sin embargo, no podemos modificarlo ahí porque cuando se despliegue un nuevo war, los contenidos que hay en el directorio webapps serán eliminados y reemplazados por los contenidos del nuevo .war. Es por esto que Tomcat copia ese fichero a /var/tomcat/conf/Catalina/localhost/portal.xml, para poder modificarlo allí y que no se sobreescriba cada vez que se despliega un nuevo .war.

Basta entonces con editar ese fichero y cambiar la URL, usuario y password a nuestras necesidades:

<Context copyXML="true">

    <!-- Default set of monitored resources -->
    <WatchedResource>WEB-INF/web.xml</WatchedResource>

    <!-- Uncomment this to disable session persistence across Tomcat restarts -->
    <!--
    <Manager pathname="" />
    -->

    <!-- Uncomment this to enable Comet connection tacking (provides events
         on session expiration as well as webapp lifecycle) -->
    <!--
    <Valve className="org.apache.catalina.valves.CometConnectionManagerValve" />
    -->

        <Resource name="jdbc/unredd-portal" auth="Container" type="javax.sql.DataSource"
                driverClassName="org.postgresql.Driver" url="jdbc:postgresql://127.0.0.1:5432/mibasededatos"
                username="miusuario" password="mipassword" maxActive="20" maxIdle="10"
                maxWait="-1" />

</Context>

Una vez editado el fichero hay que reiniciar el portal como se explica aquí: Reinicio del portal.

Esquema¶

Todas las funcionalidades que necesitan apoyo de la base de datos acceden a tablas con nombre conocido en un esquema que se configura en el fichero “portal.properties”, situado en el directorio de configuración del portal, mediante la propiedad db-schema.

Así, para configurar estas funcionalidades hay que seguir dos pasos:

Especificar el esquema con la propiedad db-schema. Ver portal.properties.
Crear las tablas de nombre conocido según la funcionalidad que se desee instalar.
- Servicio de estadísticas, ver Instalación
- Herramienta de feedback, ver Configuración

Reinicio del portal¶

Cuando se modifican datos relativos a la base de datos es necesario reiniciar el portal. Esto se hace forzando a que Tomcat redespliegue la aplicación y puede hacerse copiando el fichero de nuevo en /var/tomcat/webapps/ o, más simple, mediante el comando touch:

$ touch /var/tomcat/webapps/portal.war

Este comando cambia la fecha y hora de última modificación del fichero, forzando así a Tomcat a que vuelva a desplegar el .war. A los pocos segundos el portal se habrá reiniciado.

Warning

En algunos casos, sobre todo cuando la conexión a la base de datos apunta a algún servidor que no existe, el comando touch puede no ser efectivo. En tales casos, es necesario reiniciar Tomcat:

sudo service tomcat7 restart

Verificación del despliegue¶

Para verificar que la inicialización del portal ha sido exitosa es conveniente realizar dos comprobaciones por orden.

La primera es acceder a la URL del navegador y visualizar el portal. Es posible que la primera petición devuelva algún tipo de error pero tras unos pocos segundos el portal se deberá mostrar normalmente.

Warning

Cuando se reinicia el servicio de Tomcat entero en lugar de sólo el portal, se da el caso de que todas las aplicaciones se inicializan una detrás de otra. Por tanto, el tiempo que tarda el portal en iniciarse depende de cuántas aplicaciones haya además de ésta y de lo “pesadas” que sean. Por ejemplo, si tenemos GeoServer con muchos datos cargados, es probable que durante el reinicio de Tomcat el portal tome más tiempo que si estuviera sólo.

La segunda es verificar en los logs que la inicialización del portal y la visualización en el navegador no han dado ningún error. Para ver los errores que se dan internamente en el portal es necesario visualizar los logs. Cada vez que el portal se inicializa o se carga en un navegador, el sistema escribe información relevante en un fichero de log de Tomcat, en concreto en el fichero /var/tomcat/logs/catalina.out.

El comando less nos permite visualizar este fichero fácilmente:

$ less /var/tomcat/logs/catalina.out

donde encontraremos algo como esto:

INFO: Despliegue del archivo portal.war de la aplicación web
2015-04-02 02:22:39 INFO  ConfigFolder:55 - ============================================================================
2015-04-02 02:22:39 INFO  ConfigFolder:56 - PORTAL_CONFIG_DIR: /var/portal
2015-04-02 02:22:39 INFO  ConfigFolder:57 - ============================================================================
2015-04-02 02:22:39 DEBUG ConfigFolder:73 - Reading portal properties file /var/argentina/portal.properties
2015-04-02 02:22:39 DEBUG ConfigFolder:73 - Reading portal properties file /var/argentina/portal.properties

En caso de que haya algún error nos encontraremos con algo así:

INFO: Despliegue del archivo portal.war de la aplicación web
2015-04-02 02:34:50 INFO  ConfigFolder:55 - ============================================================================
2015-04-02 02:34:50 INFO  ConfigFolder:56 - PORTAL_CONFIG_DIR: /var/argentina
2015-04-02 02:34:50 INFO  ConfigFolder:57 - ============================================================================
2015-04-02 02:34:50 DEBUG ConfigFolder:73 - Reading portal properties file /var/argentina/portal.properties
2015-04-02 02:34:50 DEBUG ConfigFolder:73 - Reading portal properties file /var/argentina/portal.properties
2015-04-02 02:34:50 ERROR FeedbackContextListener:66 - Database error notifying the comment authors
org.fao.unredd.portal.PersistenceException: Database error
        at org.fao.unredd.portal.DBUtils.processConnection(DBUtils.java:41)
        at org.fao.unredd.portal.DBUtils.processConnection(DBUtils.java:14)
        at org.fao.unredd.feedback.DBFeedbackPersistence.getValidatedToNotifyInfo(DBFeedbackPersistence.java:122)
        at org.fao.unredd.feedback.Feedback.notifyValidated(Feedback.java:83)
        at org.fao.unredd.feedback.servlet.FeedbackContextListener$1.run(FeedbackContextListener.java:61)
        at java.util.TimerThread.mainLoop(Timer.java:512)
        at java.util.TimerThread.run(Timer.java:462)
Caused by: org.apache.tomcat.dbcp.dbcp.SQLNestedException: Cannot create PoolableConnectionFactory (Conexión rechazada. Verifique que el nombre del Host y el puerto sean correctos y que postmaster este aceptando conexiones TCP/IP.)
        at org.apache.tomcat.dbcp.dbcp.BasicDataSource.createPoolableConnectionFactory(BasicDataSource.java:1549)
        at org.apache.tomcat.dbcp.dbcp.BasicDataSource.createDataSource(BasicDataSource.java:1388)
        at org.apache.tomcat.dbcp.dbcp.BasicDataSource.getConnection(BasicDataSource.java:1044)
        at org.fao.unredd.portal.DBUtils.processConnection(DBUtils.java:37)
        ... 6 more
Caused by: org.postgresql.util.PSQLException: Conexión rechazada. Verifique que el nombre del Host y el puerto sean correctos y que postmaster este aceptando conexiones TCP/IP.
        at org.postgresql.core.v3.ConnectionFactoryImpl.openConnectionImpl(ConnectionFactoryImpl.java:215)
        at org.postgresql.core.ConnectionFactory.openConnection(ConnectionFactory.java:64)
        at org.postgresql.jdbc2.AbstractJdbc2Connection.<init>(AbstractJdbc2Connection.java:144)
        at org.postgresql.jdbc3.AbstractJdbc3Connection.<init>(AbstractJdbc3Connection.java:29)
        at org.postgresql.jdbc3g.AbstractJdbc3gConnection.<init>(AbstractJdbc3gConnection.java:21)
        at org.postgresql.jdbc4.AbstractJdbc4Connection.<init>(AbstractJdbc4Connection.java:31)
        at org.postgresql.jdbc4.Jdbc4Connection.<init>(Jdbc4Connection.java:24)
        at org.postgresql.Driver.makeConnection(Driver.java:410)
        at org.postgresql.Driver.connect(Driver.java:280)
        at org.apache.tomcat.dbcp.dbcp.DriverConnectionFactory.createConnection(DriverConnectionFactory.java:38)
        at org.apache.tomcat.dbcp.dbcp.PoolableConnectionFactory.makeObject(PoolableConnectionFactory.java:582)
        at org.apache.tomcat.dbcp.dbcp.BasicDataSource.validateConnectionFactory(BasicDataSource.java:1556)
        at org.apache.tomcat.dbcp.dbcp.BasicDataSource.createPoolableConnectionFactory(BasicDataSource.java:1545)
        ... 9 more
Caused by: java.net.ConnectException: Connection refused
        at java.net.PlainSocketImpl.socketConnect(Native Method)
        at java.net.PlainSocketImpl.doConnect(PlainSocketImpl.java:351)
        at java.net.PlainSocketImpl.connectToAddress(PlainSocketImpl.java:213)
        at java.net.PlainSocketImpl.connect(PlainSocketImpl.java:200)
        at java.net.SocksSocketImpl.connect(SocksSocketImpl.java:366)
        at java.net.Socket.connect(Socket.java:529)
        at org.postgresql.core.PGStream.<init>(PGStream.java:61)
        at org.postgresql.core.v3.ConnectionFactoryImpl.openConnectionImpl(ConnectionFactoryImpl.java:109)
        ... 21 more

Para más información, consulte Portal: Configuración inicial.

Resolución de problemas¶

En los casos en los que el portal no se despliegua correctamente, es necesario buscar información sobre lo que puede estar funcionando mal.

Lo primero y más sencillo es abrir una herramienta como FireBug, las herramientas para desarrolladores de Firefox o de Google Chrome y realizar de nuevo la operación que da problemas. A continuación podemos echar un vistazo a:
1. La pestaña Consola, para ver si hay algún mensaje de error.
2. La pestaña Red, para ver si hay algún recurso del portal que no está descargándose de forma correcta. En caso de encontrar algún recurso con error de carga que pueda ser sospechoso, es posible hacer clic en él con el botón derecho del ratón y abrirlo en una nueva ventana, de manera que el navegador nos reporte directamente el mensaje de error.
La segunda consiste en visualizar los logs como se explica en el punto anterior: Verificación del despliegue.