Pinole 1.1

Author: Juan Carlos Alarcón Ortiz <jcao@ulsa.mx> HomePage: http://www.sourceforge.net/projects/pinole

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

INDICE: I. Instalación. II. Uso.

I. Instalación:

1.- Descomprimir el archivo pinole-x.x.tar.gz.

tar -xzvf pinole-x.x.tar.gz

Se va a crear un directorio llamado pinole-x.x con el siguiente contenido:

      /pinole-x.x
        + pinole.pl             -       Pinole Perl program.
        + phones.dat.example    -       Ejemplo de archivo de telefonos
        + companias             -       Relación de compañias 
        + README                -       Este archivo
      /perl_modules             -       Modulos de Perl necesarios

2.- Copiar los archivos pinole.pl y phones.dat (renombrar phones.dat.example) del directorio pinole-x.x a un directorio en el cual sendmail tenga acceso.

Normalmente este es: /etc/smrsh

Las últimas versiones de sendmail traen un shell que no permite ejecutar scripts que no se encuentren en este directorio. Pero esto puede ser anulado (lo cual no se recomienda) cambiando la siguiente línea del archivo sendmail.cf:

Mprog, P=/usr/sbin/smrsh, F=lsDFMoqeu9, S=EnvFromL/HdrFromL, R=EnvToL/HdrToL, D=$z:/,

-----> Por:

Mprog, P=/bin/bash, F=lsDFMoqeu9, S=EnvFromL/HdrFromL, R=EnvToL/HdrToL, D=$z:/,

Los permisos que deben llevar estos archivos son:

        chmod 770 pinole.pl
        chmod 660 phones.dat
        chgrp mail pinole.pl phones.dat

3.- Instalar los modulos de perl.

        Normalmente por cada uno:
                perl Makefile.PL
                make
                make test
                make install

        Instalar en el siguiente orden:

        a) MIME-Base64-2.12.tar.gz
        b) libnet-1.0703.tar.gz
        c) MailTools-1.15.tar.gz
        d) HTML-Tagset-3.03.tar.gz
        e) HTML-Parser-3.25.tar.gz
        f) URI-1.12.tar.gz
        g) libwww-perl-5.53_95.tar.gz
        h) LWPng-alpha-0.24.tar.gz
        i) LWP5emu-0.01_01.tar.gz
        j) IO-stringy-1.220.tar.gz
        k) MIME-tools-5.411.tar.gz

4.- Cambiar las variables del archivo pinole.pl como sea necesario:

# BASE_DIR es el directorio en donde se ejecutará PINOLE y donde encontrará # todos los archivos relacionados.
# Debido a que algunas versiones de sendmail solo aceptan por seguridad # ejecutar scripts en el directorio /etc/smrsh, el default es este directorio. $BASE_DIR = "/etc/smrsh";

# PHONE_FILE es el archivo que contiene los nombres, numeros de telefono y # de compañia de servicio de mensajes escritos. # El archivo debe tener el siguiente formato: #
# login:compañía:telefono
#
# Por el momento, PINOLE acepta las siguientes compañias: #

#       Compañía        Texto que debe estar
#                       en el archivo PHONE_FILE
#
#       + Telcel        (telcel)
#       + Iusacell      (iusacell)
#       + PegasoPCS     (pegaso)
#       + NexTel        (nextel)
#       + Intercom      (intercom)
#       + SkyTel        (skytel)
#       + Techtel       (techtel)
#       + Digitel       (digitel)
#       + Biper         (biper)

#
$PHONE_FILE = "phones.dat";

# CONFIRM_MESSAGE_FLAG es una bandera que hay que poner en 1 si se desea que # Pinole envie una mensaje de confirmación del mensaje enviado. $CONFIRM_MESSAGE_FLAG = 1;

# CONFIRM_EMAIL es el email que Pinole utilizará para el campo From del mensaje # de confirmación. Puede ser el del administrador del sistema o uno inexistente. $CONFIRM_EMAIL = "login\@foo.org";

# SENDMAIL_PATH: En caso de estar habilitados los mensajes de confirmación, # Pinole necesitará que se le indique la ruta en donde está sendmail. # Se debe poner la ruta de sendmail en esta variable. $SENDMAIL_PATH= "/usr/sbin/sendmail";

# VERBOSE es una bandera que le indica a Pinole que se desea hacer un debug del # correo electrónico enviado. Además, mostrará los mensajes que utilizará para # enviar la petición al servidor web de la empresa que ofrece el servicio de # mensajes escritos. Si está en 1 entonces el Verbose estará activado. # 0 para desactivarlo.
$VERBOSE=0;

# VERBOSE_FILE: Como Pinole se comunica directamente con sendmail, la salida # estándar se pierde, por lo que se utiliza este archivo para enviar la salida # del verbose. La salida quedará grabada en este archivo que podrá ser revisado # posteriormente a enviar el mensaje.
$VERBOSE_FILE= "pinole.debug";

5.- Modificar el archivo phones.dat en donde se encuentran los usuarios de Pinole.

El archivo phones.dat tiene el siguiente formato:

Ejemplo

$ cat phones.dat
joe:iusacell:85000000
jorge:telcel:87654321
eduardo:digitel:12345678

El login es el parametro que se enviará a pinole.pl en el archivo de aliases.

Por ejemplo:

# cat /etc/aliases
pager_joe: "|pinole.pl joe"

                      ^^^^^
                     Parámetro

6.- Agregar un alias en el archivo de aliases de sendmail. Normalmente este archivo es: /etc/aliases.

Se debe agregar una línea como esta:

En caso de que se utilize smrsh:

joe: "|pinole.pl joe"

En caso de que se utilize otro shell:

joe: "|/ruta/de/pinole/pinole.pl joe"

Si el login ya existe es posible que pinole no funcione correctamente, asi que se recomienda que el login a utilizar sea uno no existente. Una buena idea es utilizar un prefijo como pag_ o p_, por ejemplo:

pag_joe: "|pinole.pl pag_joe"

También es posible hacer que el mensaje original llegue por correo al usuario, esto es útil en caso de que el mensaje no sea entregado, porque de esta manera, el usuario recibirá también un correo electrónico. Ejemplo:

pag_joe: "|pinole.pl pag_joe", joe

IMPORTANTE: (De verdad importante. Luego no digan que no se los advertí)

Después de agregar el alias en el /etc/aliases, hay que ejecutar el comando newaliases desde el shell. De lo contrario, sendmail no reconocerá este nuevo alias.

# newaliases

II. Uso.

1.- Enviar un correo a la dirección dada de alta en el alias:

Por ejemplo:

pag_joe@foo.org

2.- En el Subject, escribir el mensaje que se quiere enviar.

That's all folks! =)

Gracias por usar Pinole.
Comentarios y sugerencias: madss@users.sourceforge.net