Configuración de YajHFC para grupos de trabajo pequeños


Esta guía muestra cómo puedes configurar YajHFC para un grupos de trabajo pequeños. Esto significa que el estado de leído/no leído se comparte entre los diferentes equipos almacenando la información en una tabla de una base de datos en un servidor. Adicionalmente, la base de datos del servidor se utiliza para compartir una agenda telefónica de manera conjunta.

En esta guía se utiliza PostgreSQL (versión 8.1) como servidor de base de datos.
YajHFC también tiene soporte para otros tipos de bases de datos compatibles con SQL como MySQL o Apache Derby. No existe ningún problema en utilizar un servidor de base de datos distinto (YajHFC sólo utiliza instrucciones SQL básicas), aunque por supuesto, la configuración del servidor de base de datos y los ajustes de JDBC para YajHFC serán diferentes a los de esta guía. Revisa más abajo la estructura necesaria para las tablas de la base de datos.

A. Configuración del servidor de la base de datos

Los comandos de esta sección han sido probados en Debian/Ubuntu. Deberían ser similares en otras distribuciones.

  1. Instalar PostgreSQL: Si todavía no lo has hecho, el primer paso es instalar PostgreSQL.
    Si utilizas Debian o Ubuntu, puedes hacerlo introduciendo el comando aptitude install postgresql.
  2. Configurar PostgreSQL:

    En el siguiente paso, se tiene que configurar PostgreSQL para que se pueda acceder a las bases de datos a través de la red utilizando nombre de usuario y contraseña.

    Para ello, tendrás que editar los archivos pg_hba.conf y postgresql.conf. Puedes encontrarlos en el directorio /etc/postgresql/<version>/main si utilizas Debian/Ubuntu, o en /var/lib/pgsql/data para OpenSUSE. En otras distribuciones, estos archivos podrían estar en un lugar diferente.

    Asegúrate de que el archivo pg_hba.conf contiene la siguiente línea (normalmente tendrás que añadirla):

     host    all     all     192.168.X.0/24                 md5

    192.168.X.0/24 tiene que ser sustituido por las direcciones de tu red local en notación CIDR.
    Eso significa que si usas direcciones IP de este tipo 192.168.115.X en tu red, tendrás que introducir 192.168.115.0/24 aquí.

    En el archivo postgresql.conf tienes que activar la escucha en la interfaz de red externa (de tu red local). Para hacerlo, añade la siguiente línea en este archivo:

     listen_addresses = '*'

    Para finalizar este paso tienes que reiniciar el servidor de base de datos para que los cambios de la configuración tengan efecto:

     /etc/init.d/postgresql restart
  3. Creación de la base de datos:

    En primer lugar, cambia tu identidad de usuario a la del usuario administrador del sistema PostgreSQL:

     su postgres

    Ahora crea una base de datos para YajHFC:

     createdb yajhfc 

    Por último, utiliza este script para crear las tablas necesarias en la base de datos y los usuarios. De manera predeterminada, el script genera un usuario llamado "fax" con la contraseña "fax". Si quieres crear usuarios adicionales o una contraseña diferente (lo cual se recomienda), edita el script antes de ejecutar el siguiente comando.
    Para crear las tablas, copia el script createdb.sql en el servidor y escribe el siguiente comando (como usuario postgres):

     psql yajhfc -f createdb.sql 

B. Configuración de YajHFC

  1. Descarga el controlador JDBC para PostgreSQL: http://jdbc.postgresql.org/download.html. (Si no sabes cuál elegir, elige el controlador JDBC3.)

  2. Inicia YajHFC, abre el cuadro de diálogo de Opciones, añade el archivo JAR recién descargado como driver JDBC (Opciones->Complementos & JDBC->Añadir controlador JDBCA) y pulsa OK.

    JDBC & Plugins panel
  3. Abre el cuadro de diálogo de Opciones de nuevo, establece la ubicación de almacenamiento en Servidor->estado de los faxes leídos/no leídos a "Tabla de base de datos" y pulsa "Configurar...".

    Server panel
  4. Introduce las siguientes opciones en el cuadro de diálogo de configuración que aparecerá:

    Configuration dialog

    En la dirección URL de la base de datos tienes que reemplazar hylafax-test con el nombre del equipo de la base de datos.
    Por ejemplo: si el servidor de la base de datos se llama server la dirección URL correcta es: jdbc:postgresql://server/yajhfc

    El resto de ajustes que se muestran arriba se pueden utilizar sin llevar a cabo ninguna modificación (si configuras el servidor de base de datos de acuerdo a esta guía).

    Nota: "Probar la conexión" debería funcionar correctamente en este punto.

  5. Cierra todos los cuadros de diálogo pulsando "OK".
  6. Abre la agenda telefónica y pulsa en el elemento del menú Agenda telefónica->Añadir a la lista->agenda telefónica JDBC. Introduce los siguientes ajustes en el cuadro de diálogo de configuración que aparecerá y pulsa OK:

    Configuration dialog

    Aquí tendrás que modificar la dirección URL de la base de datos de la misma forma que antes (utiliza la misma dirección URL en ambos casos).

    Nota: "Probar la conexión" debería funcionar correctamente en este punto, también.

  7. ¡Ya está!

Estructura necesaria de la tabla

Si quieres crear las tablas de la base de datos de forma manual, las tablas de la base de datos y los campos son:

Tabla para almacenar el estado de leído/no leído:

Campo Tipo de datos
Nombre del archivo de fax         Texto (datos de longitud de carácter variable), debería tener espacio para 20 caracteres (es decir, VARCHAR(20)). Este campo debería ser definido como clave principal de la tabla.
Estado leído/no leído Valor lógico/booleano (puede ser verdadero o falso)

Tabla para la agenda telefónica:

Un campo de la base de datos por cada campo de la agenda telefónica. El tipo de dato para todos los campos es texto (datos de longitud de carácter variable); debería ser lo suficientemente largo (al menos 30-40 caracteres; por ejemplo VARCHAR(40)).
Para el campo de los comentarios se recomienda utilizar un campo de texto de longitud indeterminada (es decir, un campo de tipo TEXT/MEMO).


Creado por: Jonas Wolz

Última modificación: Monday, 12-Dec-2016 11:52:08 CET