Diferencias

Muestra las diferencias entre dos versiones de la página.

--- ar:guia_binkd_crashmail_golded [2024/11/17 21:07] – ragnarok
+++ ar:guia_binkd_crashmail_golded [2024/11/18 23:50] (actual) – fix crashexport ragnarok
@@ Línea 1: / Línea 1: @@
 ====== Guía para punto con binkd + crashmail + golded en GNU/Linux ======
-La intensión de esta guía es tener un sistema de un punto para Fido (También puede ser un nodo, la única diferencia básicamente es la dirección FTN, pero a efectos prácticos es lo mismo)
+La intensión de esta guía, es ayudar a tener un sistema de un punto para Fido (también puede ser un nodo, la única diferencia básicamente es la dirección FTN, pero a efectos prácticos es lo mismo)
-Este sistema en conjunto, debería poder enviar/recibir netmails y areas de echomails usando golded como editor.
+Este sistema en conjunto, debería poder enviar/recibir netmails y áreas de echomails usando golded como editor, crashmail como tosser y binkd como mailer.
-El escenario de ejemplo que voy a mostrar es creado en GNU/Linux (para otros OS's seguramente se deben considerar usar los paths y los programas correspondientes)
+Este es un esquema de como seria el funcionamiento:
+{{:ar:bloques.png|Diagrama de bloques}}
+No es la idea ver opción por opción en detalle de los programas, para ello se debe recurrir a la documentación de cada uno de ellos respectivamente.
+El escenario de ejemplo que voy a mostrar es creado en Debian GNU/Linux version 12 [bookworm] (para otros OS's seguramente se deben considerar usar los paths y los programas correspondientes).
 Vamos a usar esas configuraciones como ejemplo:
-^ Configración      ^ valor ^
+^ Configuración      ^ valor ^
 |Nuestra dirección FTN del punto | 4:902/26.10 |
 |Dirección de nuestro uplink/boss donde conectaremos | 4:902/26 |
@@ Línea 21: / Línea 27: @@
 Pero no creo que sea necesario.
-Por defecto binkd busca las configuraciones en **/etc/binkd/binkd.cfg** ( por ejemplo, si lo instalan desde los repos), también puede que corra como servicio (el cual ahora no lo vamos a usar y para mejor de los casos, lo deshabilitan vía systemctl)
+Por defecto binkd busca las configuraciones en **/etc/binkd/binkd.cfg** ( por ejemplo, si lo instalan desde los repos), también puede que corra como servicio (el cual ahora no lo vamos a usar y para mejor de los casos, lo deshabilitan vía systemctl).
 Porque nosotros vamos a crear el archivo de config y vamos a poner todos dentro de un directorio en nuestro home así no tenemos problemas de permisos y esas cosas al ejecutar como root o un usuario de servicio.
-Así se facilita para quienes no están muy experimentados con GNU/Linux
+Así se facilita para quienes no están muy experimentados con GNU/Linux.
 <alert notice>NOTA: Siempre podemos ejecutar todo esto con nuestro usuario de GNU/linux y el uso de root es solamente necesario para instalar los programas.</alert>
@@ Línea 80: / Línea 86: @@
 inbound-nonsecure /home/ragnarok/fido/in.nosecure
-# Programa que se ejecuta al recibir archivos .tic (en este caso tinytic) va a procerar esos archivo y segun la configuracion
+# Programa que se ejecuta al recibir archivos .tic (en este caso tinytic) va a procesar esos archivo y según la configuración
 # va a moverlos a algun directorio que le indicamos
 exec "/home/ragnarok/fido/tinytic -c /home/ragnarok/fido/tinytic.cfg" *.tic
@@ Línea 89: / Línea 95: @@
 # Dirección del nodo de nuestro uplink/boss para enviar y recibir los paquetes
 # El formato es:
-#   node <direccion del uplink> <hostname de internet> <contraseña>
+#   node <dirección del uplink> <hostname de internet> <contraseña>
 #
-# Los fileboxes estan asociados a  un nodo se pueden usar para organizar la cola de entrada y salida. Así se puede separar por nodeo y no se mezclan
+# Los fileboxes están asociados a  un nodo se pueden usar para organizar la cola de entrada y salida. Así se puede separar por nodo y no se mezclan
-# Es util para cuando se tienen varios nodos, aunque este no seria nuestro caso
+# Es útil para cuando se tienen varios nodos, aunque este no seria nuestro caso
 node 4:902/26@fidonet bbs.docksud.com.ar 123456
 filebox /home/ragnarok/fido/filebox
@@ Línea 158: / Línea 164: @@
 ===== Configuración de Crashmail =====
-Crashmail es el Tosser, es el programa que se encarga de procesar los archivos de paquetes que llegaron a la entrada del binkd y guardar los mensajes en las dirferentes areas, echomail y netmail
+Crashmail es el Tosser, es el programa que se encarga de procesar los archivos de paquetes que llegaron a la entrada del binkd y guardar los mensajes en las diferentes áreas, echomail y netmail.
-Es importante tener en cuenta que al guardar las areas se debe elegir el formato de base de datos de las mismas, en la versión que tengo soporta MSG y JAM.
+Es importante tener en cuenta que al guardar las áreas se debe elegir el formato de base de datos de las mismas, en la versión que tengo soporta MSG y JAM.
 El formato Standard MSG (FTS-1) genera un archivo por mensaje en el filesystem, 1.msg, 2.msg etc..
@@ Línea 168: / Línea 174: @@
 Elegir uno u otro es a gusto, semejante a usar MailDir o Mbox para los clientes de correo de internet, cada uno tiene sus pro y contras.
-El JAM seria mas "optimo" porque es mas rápido abrir una base en un solo archivo, pero tiene la contra de que si se corronpe ese archivo se pueden perder todos los mensajes.
+El JAM seria mas "optimo" porque es mas rápido abrir una base en un solo archivo, pero tiene la contra de que si se corrompe ese archivo se pueden perder todos los mensajes.
 En cambio, el MSG es mas costoso porque se tiene que abrir y cerrar cada archivo para cada mensajes, pero la buenas es que si se rompe 1 archivo a lo sumo se pierde un mensaje.
@@ Línea 201: / Línea 207: @@
 **TOSS**: Procesa los paquetes que entraron al binkd y los guarda en sus respectivas áreas como comentaba anteriormente.
-**EXPORT**: Psta tarea toma las areas que estan configuradas en crashmail y general el archivo "areas.golded". Este archivo luego se hace un "//include//" en la config de golded asi levanta toda la bases de mensajes.
+**EXPORT**: Esta tarea toma las áreas que están configuradas en crashmail y general el archivo "areas.golded". Este archivo luego se hace un "//include//" en la config de golded así levanta toda la bases de mensajes.
-El archivo de configuración de crashmail lo vamos a guardar también dentro de /home/ragnarok/fido, es bastante mas extenso que binkd y tiene muchas opciones que también están autodocumentados en los archivos de ejemplo que vienen en /usr/share/doc/crashmail
+El archivo de configuración de crashmail lo vamos a guardar también dentro de /home/ragnarok/fido, es bastante mas extenso que binkd y tiene muchas opciones que también están //autodocumentadas// en los archivos de ejemplo que vienen en /usr/share/doc/crashmail
 Igualmente voy a poner algunos comentarios de las opciones que son necesarias:
@@ Línea 216: / Línea 222: @@
 ; Base de duplicados, crashmail detecta duplicados
-; y los elimina antes de cargarlos en las bases de las areas
+; y los elimina antes de cargarlos en las bases de las áreas
 DUPEFILE "/home/ragnarok/fido/crashmail/crash.dupes" 200
 DUPEMODE KILL
@@ Línea 224: / Línea 230: @@
 OUTBOUND "/home/ragnarok/fido/out"
-; Directorios temporales, estadisticas, logs etc
+; Directorios temporales, estadísticas, logs etc
 TEMPDIR "/home/ragnarok/fido/crashmail/tmp"
 CREATEPKTDIR "/home/ragnarok/fido/crashmail/tmp"
@@ Línea 251: / Línea 257: @@
 JAM_MAXOPEN 5
-; Grupos de areas. Uno puede agrupar las areas, por ejemplo
+; Grupos de áreas. Uno puede agrupar las áreas, por ejemplo
 ; si se usaran varias redes en el mismo sistema, se podría
 ; crear un grupo para cada una de ellas
@@ Línea 371: / Línea 377: @@
 <code>
-crashmail.prefs areas.golded golded
+crashexport crashmail.prefs areas.golded golded
 </code>
-Tener en cuenta que el comando es //crashexport// y no produce ninguna salida si no hay error como todo comando en GNU/Linux
+Tener en cuenta que el comando es //crashexport// y no produce ninguna salida si no hay error como todo comando en GNU/Linux.
 Pero podemos ver el archivo generado:
@@ Línea 425: / Línea 431: @@
 En primer lugar, lo mas probable es que se tenga que bajar el source desde [[https://github.com/golded-plus/golded-plus|Github]] y compilarlo. Al menos en debian12 no esta vía repositorios.
-Si bien se escapa un poco de esta guía, los pasos a seguir son los siguientes
+Si bien se escapa un poco de esta guía, los pasos a seguir son los siguientes:
 Clonar el repo desde github:
@@ Línea 434: / Línea 439: @@
 </code>
-Entrar al directorio golded3 dentro del clonado
+Entrar al directorio golded3 dentro del clonado:
 <code>
@@ Línea 441: / Línea 446: @@
 </code>
-Generar el archivo mygolded.h a partir del que viene de ejemplo
+Generar el archivo mygolded.h a partir del que viene de ejemplo:
 <code>
@@ Línea 470: / Línea 475: @@
 </code>
-volver a la raiz del repositorio (golded-plus)
+Volver a la raiz del repositorio (golded-plus):
 <code>
 cd ..
 </code>
-Crear un dictorio build para cmake
+Crear un dictorio build para cmake:
 <code>
@@ Línea 481: / Línea 487: @@
 </code>
-Generar el build y compilar
+Generar el build y compilar:
 <code>
@@ Línea 575: / Línea 581: @@
 </code>
-Si compilo todo bien, lo instalamos (Como root o por ejemplo usando sudo)
+Si compiló todo bien, lo instalamos (Como root o por ejemplo usando sudo):
 <code>
@@ Línea 631: / Línea 637: @@
 ==== Configuración inicial ====
-Una vez compilado e instalado, generamos el archivo /home/ragnarok/fido/golded.cfg (tambien por compatibilidad toma el archivo si termina con la extension .conf)
+Una vez compilado e instalado, generamos el archivo /home/ragnarok/fido/golded.cfg (tambien por compatibilidad toma el archivo si termina con la extension .conf).
 <file ini /home/ragnarok/fido/golded.cfg>
@@ Línea 686: / Línea 692: @@
 </file>
-Si todo está ok deberíamos poder ejecutar el el comando **golded** (siempre parados sobre nuestro directorio raiz de fido, según el ejemplo en /home/ragnarok/fido)
+Si todo está ok deberíamos poder ejecutar el comando **golded** (siempre parados sobre nuestro directorio raiz de fido, según el ejemplo en /home/ragnarok/fido)
 {{:ar:captura_golded.png?400|}}
+====== Operación y Uso ======
+Bien, se supone que hasta este momento tendríamos el sistema funcional.
+Es muy importante verificar las rutas y las configuraciones, porque es algo común que sucede de poner mal un path o una opción, y el sistema completo falla y no se sabe por donde viene el inconveniente.
+También es preciso entender como interactuan cada uno y en que momento trabaja. Porque entender el flujo de paquetes y procesos nos va a facilitar al momento de solucionar el problema y poder aislarlo donde ocurre.
+El orden de los pasos serian:
+  - Ejecutar **binkd** para que llame a nuestros uplink/boss y nos traiga paquetes
+  - Ejecutar **crashmail toss** para procesar los paquetes recibidos y enviarlas a las bases de datos de las áreas
+  - Usar **crashexport** para generar el archivo de áreas de golded
+  - Abrir **golded** para leer o escribir mensajes algunos mensajes
+  - Ejecutar **crashmail scan** para generar paquetes con mensajes para enviar
+  - Ejecutar **binkd** nuevamente para enviar los paquetes generados
+Los comandos a modo de ejemplo son:
+<code>
+/usr/sbin/binkd -p -P 4:902/26 binkd.cfg
+crashmail settings crashmail.prefs toss
+crashexport crashmail.prefs areas.golded golded
+golded
+crashmail settings crashmail.prefs scan
+/usr/sbin/binkd -p -P 4:902/26 binkd.cfg
+</code>
+<alert info>Obviamente y como tarea para el hogar, uno se puede hacer algún script de bash que automatice estas tareas, como para ejecutar un solo comando "mágico" que se llame "./usar_fido.sh" y listo.</alert>
+Al ejecutar //golded//, de acuerdo a nuestra configuración, arranca con la vista de áreas, si seleccionamos una y le damos //Enter//, vamos a ver el listado de mensajes:
+{{:ar:golded_2024-11-17_22-51.png?400|}}
+Para crear un nuevo mensaje se usa la tecla **E** (enter message)
+Acá nos van a aparecer los campos para que ingresemos para quien va dirigido el mensaje (To:) y el asunto (Subj:).
+Así como también atributos que podamos asignarle al mensaje (Privado, Crash, Direct..etc ver docu de Golded para detalles de cada uno).
+{{:ar:golded_2024-11-17_22-55.png?400|}}
+Luego de ingresas esos datos, damos de nuevo //Enter// y nos abre el popup donde seleccionamos **Internal Editor** para escribir el cuerpo del mensaje:
+{{:ar:golded_2024-11-17_22-57.png?400|}}
+Ahora podemos escribir el cuerpo de nuestro mensaje:
+{{:ar:2024-11-17_23-02.png?400|}}
+Una vez que terminamos tocamos **F2** para que abra el popup y confirmar el envío seleccionando "**Yes, it's great stuff**". De esta forma el mensaje queda marcado para ser enviado y volveremos a la vista de mensajes.
+{{:ar:golded_2024-11-17_23-04.png?400|}}
+Saliendo ahora de golded, vamos a enviar los mensajes, haciendo el scan y luego llamando a binkd:
+<code>crashmail settings crashmaik.prefs scan</code>
+<code>
+CrashMail II 1.7 started successfully!
+Scanning all areas for messages to export
+Found area DEFAULT_D
+Skipping area because it has no messagebase or area type is not echomail or netmail..
+Found area Netmail-fido
+Scanning area Netmail-fido
+Found area Bad-fido
+Scanning area Bad-fido
+Found area ZONA4.GENERAL
+Scanning area ZONA4.GENERAL
+Found area REGION90
+Scanning area REGION90
+Found area ESP.PRUEBAS
+Scanning area ESP.PRUEBAS
+Inspecting message 802
+Exporting message #802 from "Fernando Toledo" to "All" in ESP.PRUEBAS
+Is in HandleMessage()
+message exported
+Scanning for orphan files
+Scanning for old packets
+Scanning for new files to pack
+Packing 3aa1aa00.pkt for 4:902/26.0 with ZIP
+  adding: home/ragnarok/fido/crashmail/tmp/3aa1aa00.pkt (deflated 46%)
+Updating hwm for area ESP.PRUEBAS, old = 801, new = 802
+CrashMail end
+</code>
+Ahí pudimos ver que hay un mensaje en cola y que se genero el paquete. Este quedará el el directorio de salida de binkd. Entonces ahora lo ejecutamos:
+<code>/usr/sbin/binkd -p -P 4:902/26 binkd.cfg</code>
+<code>
+:13 [51544] BEGIN, binkd/1.1a-115/Linux -p -P 4:902/26 binkd.cfg
+:13 [51544] creating a poll for 4:902/26@fidonet (`d' flavour)
+:13 [51544] clientmgr started
+$ -d 4:902/26@fidonet
++ 23:13 [51545] call to 4:902/26@fidonet
+:13 [51545] trying bbs.docksud.com.ar [186.123.101.23]...
+:13 [51545] connected
++ 23:13 [51545] outgoing session with bbs.docksud.com.ar:24554 [186.123.101.23]
+- 23:13 [51545] OPT CRAM-MD5-341234123412312312341234 CRYPT
++ 23:13 [51545] Remote requests MD mode
++ 23:13 [51545] Remote requests CRYPT mode
+- 23:13 [51545] SYS Dock Sud BBS
+- 23:13 [51545] ZYZ Ragnarok
+- 23:13 [51545] LOC Dock Sud, Bs As, Argentina
+- 23:13 [51545] NDL 115200,TCP,BINKP
+- 23:13 [51545] TIME Sun Nov 17 2024 23:13:12 GMT-0300
+- 23:13 [51545] VER BinkIT/2.41,JSBinkP/4,sbbs3.20a/Linux binkp/1.1
++ 23:13 [51545] addr: 4:902/26@fidonet
++ 23:13 [51545] addr: 666:1/1@latinet (n/a or busy)
++ 23:13 [51545] addr: 21:2/151@fsxnet (n/a or busy)
++ 23:13 [51545] addr: 618:500/45@micronet (n/a or busy)
++ 23:13 [51545] addr: 46:10/182@agoranet (n/a or busy)
++ 23:13 [51545] addr: 39:943/0@amiganet (n/a or busy)
++ 23:13 [51545] addr: 39:943/1@amiganet (n/a or busy)
++ 23:13 [51545] addr: 954:895/37@hobbynet (n/a or busy)
++ 23:13 [51545] addr: 15:1/1@zudaka (n/a or busy)
++ 23:13 [51545] addr: 15:1/0@zudaka (n/a or busy)
++ 23:13 [51545] addr: 15:0/0@zudaka (n/a or busy)
++ 23:13 [51545] addr: 4:0/0@fidonet
++ 23:13 [51545] addr: 4:90/0@fidonet
++ 23:13 [51545] addr: 4:900/0@fidonet
++ 23:13 [51545] addr: 4:902/0@fidonet
++ 23:13 [51545] pwd protected session (MD5)
+- 23:13 [51545] session in CRYPT mode
++ 23:13 [51545] sending /home/ragnarok/fido/crashmail/packets/66405b2a.su0 as 66405b2a.su0 (609)
++ 23:13 [51545] sent: /home/ragnarok/fido/crashmail/packets/66405b2a.su0 (609, 609.00 CPS, 4:902/26@fidonet)
++ 23:13 [51545] done (to 4:902/26@fidonet, OK, S/R: 1/0 (609/0 bytes))
+- 23:13 [51545] rc=0
+:13 [51545] session closed, quitting...
+:13 [51544] rc(51545)=0
+:13 [51544] the queue is empty, quitting...
+</code>
+De esa manera, el menaje ha sido enviado.
+====== Tips y problemas comunes ======
+===== Proceso de los paquetes =====
+Hay algo que no supe ajustar correctamente aun. Es que desde el binkd.cfg uno pone las lineas de //exec// para directamente se haga el //toss// ni bien llegan los paquetes.
+Eso nos ahorraría de ejecutar //crashmail toss// luego del binkd.
+Por ejemplo:
+<code>
+exec "crashmail settings /home/ragnarok/fido/crashmail.prefs toss nosecurity" *.pkt
+</code>
+Esto se dispara si vienen archivos .pkt. Pero el tema es que también nos llegan bundles (que son comprimidos de paquetes)
+como por ejemplo ftg12hg2.M01.
+En este caso el toss a eso no se hace, porque primero se deberían "descomprimir" por así decirlo los bundles.
+Posiblemente tengo que investigar mejor de como hacer una linea de //exec// que sirva para todo (o quizás tengan que ser varias, ya lo veré).
+Así que mientras tanto, lo solucioné con un script de bash que luego del binkd, recorre los archivos de su inbound y por cada uno hace un //crashmail tossfile//.
+Para la opción de //tossfile// de crashmail, uno debe pasar como parámetro el nombre de archivo que quiere procesar.
+<file bash poll.sh>
+cd /home/ragnarok/fido
+while [ 1 ]
+do
+    crashmail settings crashmail.prefs scan toss
+    crashexport crashmail.prefs areas.golded golded
+    /usr/sbin/binkd -p -P 4:902/26 binkd.cfg
+    for b in `find "$(pwd)/in" -type f`
+    do
+        crashmail settings crashmail.prefs tossfile $b
+    done
+    for a in `seq 1 5`
+    do
+        echo "Sleep $a de 5"
+        sleep 1m
+    done
+done
+</file>
+Lo que hago es, abro una terminal y ejecuto poll.sh, esto queda en un loop infinito (hasta que lo corte con CTRL+c) que cada 5 minutos que básicamente "envía y recibe" todo el tiempo.
+Luego abro otra terminal con el golded y ahí leo o escribo mensajes normalmente. Y en definitiva, cuando termino, corto el proceso del poll.sh. Ese seria mi "workflow" para usar el sistema
+Se que es un poco redundante y que posiblemente no sea la opción más óptima, pero es la que me sirve por ahora.
+===== El golded no hace nada / no abre =====
+A golded le falta, que si tiene algún error en su config, envíe un buen mensaje con error de salida a la consola (ideal seria al stderr), para uno saber problema hay.
+Un ejemplo es que si no están incluídas las opciones de caracteres, xlats y demas, cuando ejecutan el comando golded no hace nada de nada.
+Por lo tanto, asegúrense de tener estas lineas configuradas en su golded.cfg
+<code>
+include /usr/local/share/doc/golded-plus/cfgs/colorset/gedcol02.cfg
+xlatpath /usr/local/share/doc/golded-plus/cfgs/charset
+include  /usr/local/share/doc/golded-plus/cfgs/config/charsets.cfg
+</code>
+Calculo que esto dependera del build o versión de golded, pero al menos el que compilo desde el git "oficial" se las tengo que agregar al archivo de configuración.