History

Guía de implantación del servicio de fax¶

Preparación básica¶

Descargar la imagen de: ---
Preparar la máquina virtual con los siguientes parametros:
- Tamaño Volumen: 3GB
- RAM: 256 MB
- Nombre: fax

  vmcreate --size 3G --file fax-1.1_1.tgz --mem 256 --ip 192.168.69.28 fax

Arrancar la máquina virtual

  xm create -c /etc/xen/auto/fax

Entrar como root con clave passwd.root y cambiar la clave

Configuración de la máquina¶

Existen dos opciones de configuración:

Configuración centralizada: Si la maquina va a estar integrada en una infraestructura de gestión ModularIT
Configuración local: Si la maquina no va a estar integrada en una infraestructura de gestión ModularIT

Configuración centralizadas¶

En el servidor Puppet

Crear la entrada de la maquina que estamos instalando, con su nombre ModularIT

  node "devel.fax" inherits "devel" {
        # First installation?
        $bootstrap = yes

        $modularit_name = "devel.fax" 
        $comment = "Development Fax" 
        include modularit 
  }

En el cliente (la máquina que estamos instalando)

Paramos puppetd y lo arrancamos en modo debug para comprobar que actualiza todo:

  /etc/init.d/puppet stop
  puppetd --debug --no-daemonize --runinterval 60 --fqdn NOMBRE_MODULARIT --server PUPPET_MODULARIT

Los parámetros NOMBRE_MODULARIT y PUPPET_MODULARIT serán facilitados por el responsable del servicio.
Una vez que el puppet completa varios ciclos sin error, lo ejecutamos como servicio:

  /etc/init.d/puppet restart

Para comprobar que las notificaciones al Nagios funcionan correctamente, ejecutamos el planificador de PIFIA

  /var/lib/pica/bin/scheduler Emergency
  /var/lib/pica/bin/scheduler Warning

En el Nagios comprobamos si hay alguna alerta que no genere un OK. En este punto es normal tener alertas critical de AIDE

Configuración local

Este tipo de instalacion es necesaria cuando la maquina no esta integrada en un entorno de gestion centralizado ModularIT

Ir al directorio /opt
Descargar el árbol de configuraciones de ModularIT

  links --source "http://git.modularit.org/?p=modularit.git;a=snapshot;h=HEAD;sf=tgz" | tar xvzf -

Esto nos creo un directorio /opt/modularit
Creamos el directorio de modulos de puppet y enlazamos a modularit

  mkdir /etc/puppet/modules
  ln -s /opt/modularit/Puppet/modularit /etc/puppet/modules/

Editamos el fichero de variables de configuracion /opt/modularit/Puppet/offline/variables.pp y lo adaptamos a la configuración que queremos usar. Este fichero sera comun para todas las maquinas ModularIT de esa instalacion concreta
Editamos el fichero /opt/modularit/Puppet/offline/offline.pp para establecer el nombre y el tipo de maquina ModularIT, en este caso fax. Este fichero sera diferente para cada maquina (el nombre y el tipo de maquina cambia)
Una vez que tenemos la configuración, ejecutamos puppet en modo offline

  puppet --debug /opt/modularit/Puppet/offline/offline.pp

El proceso debería terminar sin errores

Preparación del Fax/Modem¶

El servidor de Fax puede funcionar con dos tipos de Fax/Modem:

Fax/Modem por software utilizando IAXModem y una centralita Asterisk (esta es la configuración por defecto)
Fax/Modem real conectado a un puerto serie

IAXModem / Asterisk¶

Si la instalación ModularIT incluye una centralita Asterisk, el proceso de despliegue configurara automáticamente el software IAXmodem, que emula un modem por software. Para verificar que el iaxmodem funciona correctamente:

Arrancar el servicio y asegurarnos que esta configurado para arrancar en el inicio de la maquina

  service iaxmodem restart

Comprobar que el iaxmodem esta registrado en el asterisk (En la consola del Asterisk)

  iax2 show peers

Preparacion de Fax/Modem serie¶

Si se va a utilizar un modem/Fax real conectado a un puerto serie, hay que exportar ese puerto serie a la maquina virtual de Fax. OJO: Al hacer eso, inutilizamos todos los puertos serie del dom0, así que si tiene otros dispositivos como UPS, etc tendrán que conectarse por otros medios (USB). IMPORTANTE: Este procedimiento implica el reinicio del dom0, lo que provoca el corte de todos los servicios. Habrá que tenerlo en cuenta a la hora de la implantación. Por defecto Xen utiliza el puerto ttyS0 como consola de Xen, tenemos que cambiar esto para liberar el puerto. En el grub.conf ponemos el parametro xencons=off al kernel. Por ejemplo:

  title CentOS (2.6.18-8.1.15.el5xen)
          root (hd0,0)
          kernel /xen.gz-2.6.18-8.1.15.el5
          module /vmlinuz-2.6.18-8.1.15.el5xen ro root=/dev/sys/dom0 xencons=off
          module /initrd-2.6.18-8.1.15.el5xen.img

En el hierro hay que evitar que se carguen los modulos del puerto serie. En el fichero /etc/modprobe.d/blacklist añadimos:

  # Blacklist serial port modules (to use it from a domU)
  blacklist 8250
  blacklist 8250_pnp
  blacklist serial_core

REINICIAMOS el dom0
Comprobamos que no se ha cargado el soporte de puerto serie: dmesg | grep serial no debería devolvernos ninguna linea.
Ahora le pasamos el puerto serie a la maquina virtual. Para ello le añadimos las siguientes lineas al fichero de configuración de la maquina virtual fax:

  irq = [ 4 ]
  ioports = [ "3f8-3ff" ]

En la maquina virtual de Fax:

En /etc/hylafax/etc borramos cualquier fichero config.*
Configuramos el modem con:

  faxaddmodem ttyS0

Contestar a todas las preguntas de configuración, el programa detectara lo parámetros de inicialización del módem. En /etc/inittab comentar la linea de ttyIAX y descomentar la de ttyS0. Luego ejecutar init q

  # Run iaxmodem
  #m1:345:respawn:/usr/sbin/faxgetty ttyIAX
  m1:345:respawn:/usr/sbin/faxgetty ttyS0

Comprobación del Fax/Modem (IAXmodem o Serie)¶

Comprobar el estado del módem con faxstat. Si todo va bien debería decirnos que el módem esta Running and idle
Una vez que ha arrancado la máquina virtual, desde el root de la misma debemos poder usar el minicom para interactuar con el módem. Los comandos atz y ati deberán devolver OK y la identificación del módem respectivamente.
Podemos hacer una llamada de prueba con atdtNUMERO

Configuración de AvantFax¶

AvantFax es un interfaz Web para configuración y gestión de Faxes.

Accedemos a AvantFax en http://fax/admin/
El usuario administrador es admin/modularit. OJO! este usuario es solo para administrar, en la URL anterior. No sirve para acceder como usuario
Configurar correctamente la dirección de correo del usuario admin, es la que se usa para el envío de notificaciones
Podemos ir a Configurar Modems y cambiar la dirección de correo del contacto. A esta dirección se envían las notificaciones del servicio de Fax. Es MUY IMPORTANTE poner la dirección de email correcta o las notificaciones por correo de fax entrante no llegaran...
Borramos el módem que no vayamos a usar...
En Preferencias del Administrador podemos cambiar la clave y los datos del administrador de avantfax
- Deberemos crear uno o varios usuarios de avantfax...
- Para que los usuarios puedan ver los fax entrantes hay que indicar a que lineas de Fax tienen acceso

Instalación del cliente Windows¶

Instalamos el PylaFax
Instalamos la impresora Fax:
- Nos vamos a instalar nueva impresora.
- Seleccionamos impresora local.
- Seleccionamos nuevo puerto.
- Seleccionamos el tipo Redirected Port, si no esta, es que necesitamos registrar el redmon ejecutando el programa setup.exe de c:\pylafax\redmon17
- Como nombre de puerto ponemos FAX:
- Seleccionamos el driver de impresora: Apple LaserWriter 12/600
- Como nombre de impresora usamos Fax
Nos vamos a las propiedades de la impresora, seleccionamos el puerto y vamos a configurar puerto
- Programa: pyla.pyw (Poner la ruta completa)

ModularIT

Wiki