[[TOC(heading=Índice)]]

= updcast  (udp-sender; udp-receiver) - Implementación Multicast linux-gnu =
version: 20100130

== Introducción comunicación udp-sender y udp-receiver ==
Un cliente (udp-receiver), cuando se inicia, espera hasta encontrar, por broadcast, al equipo que por defecto tenga abierto el puerto (portbase) 9000.

El servidor (udp-sender) recibe las peticiones de participar en la sesión multicast en el puerto (portbase). Después utilizará otro puerto de control (portbase +1; por defecto el 9001) y una dirección de mulitcast donde enviará los datos, y los cliente estará escuchando. (Estos dos últimos valores se los proporciona el servidor a los cliente.

NOTA: el portbase será usado por OpengGnSys como identificador de sessión mulitcast.

=== SESION MULTICAST ===
Para opengnsys, inicialmente una sesión multicast el formato o sintaxis es diferente para el servidor y los clientes (el identificador de la sessión es el $PORTBASE)
NOTA: $PORTBASE será el identificador de la sessión.

==== Sesión Multicast para el servidor ====
Formato: PORTBASE:METHOD:ADDRESS:BITRATE:NCLIENTS:MAXTIME

==== Sesión Multicast para el/los cliente/s ====
Formato:   PORTBASE


== Ejemplo de un Deploy (UpdateCache+restore) con multicast con OG ==

NOTA: observar que el identificador de la sesión es el PORTBASE (9000)


=== El REPO -funcion ogMcastSendFile- ===
Sintaxis funcion: ogMcastSendFile origen destino
{{{
* Origen: file
   1 parametro:   /path_fichero
   2-3   parámetros:  ContenedorIMAGEN  /file                   -- contenedor específico para los ficheros_imagenes
   2-3-4 parámetros:  int_disk          int_partition  /file
* Destinio SESSIONMULTICASTserver
    PORTBASE:METHOD:ADDRESS:BITRATE:NCLIENTS:MAXTIME
}}}


sintaxis scripts para el REPO: 
{{{
sendFileMcast "path_file" "SESSIONMULTICASTserver"
}}}
ejemplo scripts para el REPO: 
{{{
 sendFileMcast "/opt/opengnsys/images/PS1_PH1.img" "9000:full-duplex:239.194.17.36:90M:15:120"
}}}


=== El cliente -funcion ogMcastReceiverFile- ===

Sintaxis funcion: ogMcastReceiverFile Origen Destino
{{{
* param 1 Origen: SESSIONMULTICASTclient
* param 2-3 Destino: 
   2     parametro:   /path_fichero
   2-3   parámetros:  ContenedorIMAGEN  /file                   -- específico para las imagenes
   2-3-4 parámetros:  int_disk          int_partition  /file
}}}

sintaxis scripts:  restoreImage CACHE /imagen 1 1 MULTICAST $SESSIONMULTICASTclient
{{{
ejemplo scripts: restoreImage CACHE /PS1_PH1 1 1 MULTICAST 9000
}}}