Changes between Version 2 and Version 3 of how-it-works

Timestamp:

10/28/08 17:44:51 (1 year ago)

Author:

oriol (IP: 80.35.31.228)

Comment:

completadas secciones configuración y servicios

how-it-works

@@ -79 +79 @@
 == Servicios ==
 
-Se describe una lista de servicios que hacen falta tener funcionando en el frontend y el backend.
-
-= TODO!!! =
+=== Servidor frontend (Gat) ===
+
+El único servicio especial que corre en el servidor GatV2 es el '''learn_spam'''. Se trata de un simple servidor SMTP que su única función es recibir correos que van a unas direcciones reservadas y educar al servidor '''dspam''' para que aprenda sobre correos buenos, malos, falsos positivos y falsos negativos. Este servicio esta en el directorio '''/opt/learn_dspam'''. En este directorio a parte del propio servicio hay el fichero de logs (.log), el fichero PID con el ID del proceso del servicio (.pid) y el fichero que se usa para lanzar, parar y saber el estado del demonio (.sh).
+
+El resto de servicios del servidor frontend son:
+  * postfix (SMTP)
+  * dspam (sistema anti-spam)
+  * mysql (base de datos del DSPAM y el policyd)
+  * apache (UI DSPAM)
+  * clamav-daemon y clamav-fresh (antivirus)
+  * saslauthd (autenticación SMTP)
+
+=== Servidor backend ===
+
+En este servidor deben correr dos servicios:
+  * '''transport''': este serivicio sirve para saber cual es el servidor destino donde se debe entregar un correo.
+  * '''verify_domain''': su finalidad es saber si un dominio es o no local. O sea, si debemos aceptar los correos que van hacia ese dominio.
+Ambos demonios se configuran con el fichero '''config.ini''' que se encuentra en el mismo directorio que los demonios, por defecto en: '''/opt/mail-gateway'''.
+En este directorio también podemos encontrar el fichero de '''.pid''', el '''.log''' y el '''.sh'''. El primero sirve para identificar el PID del proceso del servicio, el segundo es el fichero de logs y el tercero sirve para 'iniciar', 'parar' y preguntar el estado del servicio.
 
 == Configuración ==
 
-Ficheros de configuración que hace falta tener actualizados para un buen funcionamiento del sistema.
-
-= TODO!!! =
-
+El único fichero de configuración no estándard de todo el sistema, es el que se usa en el '''backend''' para configurar los demonios '''transport''' y '''verify_domain'''. Para explicar este fichero de configuración se hará a partir del siguiente ejemplo:
+
+{{{
+; virtual local domains
+[domains]
+VIRTUALDOAMINSFILE=/var/qmail/control/virtualdomains
+
+; host per on entrara el correu que te bustia al plesk
+[transport]
+TRANSPORT_DEFAULT=[3.3.3.3]:25
+
+; overload delivery target for some domains
+[transports]
+example.com=[1.1.1.1]:25
+example2.com=dev.lana2.com:25
+
+; where to deliver education mail for DSPAM
+[learn_dspam]
+ham@example.com=[127.0.0.1]:25001
+spam@example.com=[127.0.0.1]:25001
+learn_ham@example.com=[127.0.0.1]:25001
+learn_spam@example.com=[127.0.0.1]:25001
+
+;source connections permited
+[permited_sources]
+1.1.1.1=ip
+2.2.2.2=ip
+}}}
+
+La primera parte del fichero, sección '''[domains]''' indica donde se encuentra el fichero con el listado de dominios locales, en este caso se refiere a la ruta y a un fichero con el formato de dominios virtuals de qmail concretamente generado por la inerface Plesk. Este fichero tiene el formato:
+
+{{{
+domain1.com:1
+domain2.com:2
+}}}
+
+Estos son los dominios que seran procesados por el servidor de correo '''backend''' como dominios locales, así pues el servidor '''frontend''' debe aceptarlos también.
+
+En la sección '''[transport]''' se define donde se entregará el correo para los dominios anteriormente mencionados. O sea, en la IP (o hostname) del servidor backend. De esta forma se almacenarán en los buzones de los usuarios. La información de esta sección puede ser sobrecargada por la información de la siguiente sección: '''[transports]''', que indica donde debe entregarse el correo para ciertos dominios que pueden o no estar en la lista definida en el fichero de la primera sección. En el contenido de esta sección que nos ocupa, podemos ver que hay una lista de dominios seguida por las IPs y puertos, o hostnames y puertos donde se entregarán los correos para estos dominios. Estos es usado por dominios especiales que deben ser entregados en servidores dedicados. Por ejemplo, en el caso de un ISP estos dominios no descargan el correo del servidor del ISP sinó que el correo se entrega directamente en el servidor de la empresa.
+
+La sección '''[learn_dspam]''' se definen una lista de direcciones de correo especiales, la finalidad de las mismas es recibir correos con información para educar a '''dspam'''. En caso de modificar estas direcciones también se debe modificar el código del demonio '''learn_dspam''' del servidor '''frotend''', concretamente el fichero por defecto esta en '''/opt/learn_dspam/learn_dspam.tac.py'''.
+
+Finalmente la sección '''[permited_sources]''' tiene un listado de IPs permitidas, o sea, una lista con las IPs que pueden conectarse a los demonios '''transport''' y '''local_domains''' del servidor de '''backend'''.
 
 == Monitorización de colas ==