----

= '''***ATENCIÓN.- Esta documentación para desarrolladores del proyecto pertenece a la nueva versión de opengnsys y no es aplicable a la actual***''' =

----

== INTRODUCCIÓN ==

Un sistema opengnsys completo está formado por un '''''"servidor de administración"''''', una o varias aulas de ordenadores a los que llamaremos '''''"clientes"''''' y uno o varios servidores opengnsys, también llamados '''''"repositorios"''''', que son los encargados de asignar direcciones ipes a dichos clientes además de enviarles, vía PXE, una pequeña distribución linux con la que arrancarán. En este contexto tiene lugar continuamente una comunicación bidireccionalentre entre los distintos elementos del sistema. Esta comunicación se implementa mediante mensajes que son envíados por estas máquinas a través de la red y que pueden ser:[[BR]]

 * '''Comados''': ''Son mensajes enviados desde el servidor y que tienen como destinatarios tanto a los clientes como a los repositorios''. Con ellos se llevan a cabo todo tipo de acciones como pueden ser: Restaurar Imagenes, crear y formater particiones, Recuperar inventarios hardware, etc.[[BR]]
 
 * '''Notificaciones''': ''Son mensajes enviados desde los clientes o repositorios hacía el servidor de administración''. Con ellos se recibe información de éstos como pueden ser su estructura de particiones, software instalado, resultados de acciones ejecutadas sobre ellos (Comandos), etc. Toda esta información proveniente de los clientes y de los repositorios es registrada en la base de datos o los logs del sistema.

== Estructura de los mensajes ==

Los mensajes emitidos tanto por el servidor como por los clientes o repositorios son enviados por la red y viajan encapsulados en un paquete de red o datagrama TCP o UDP. La estructura puede variar según se trate de un mensaje tipo "comando" o un mensaje tipo "notificación, pero en ambos casos está descrito con código XML. 

 '''''1. Estructura de un mensaje tipo comando'''''
 
----

{{{
<COMANDO cod="código_de_comando" nom="nombre_del_comando" ids="identificador_de_la_acción_en_la_BD">
		<PARAM nombre="nombre_del_parametro" valor="valor_del_parametro">
		<PARAM nombre="nombre_del_parametro" valor="valor_del_parametro">
		<PARAM nombre="nombre_del_parametro" valor="valor_del_parametro">
		<PARAM nombre="nombre_del_parametro" valor="valor_del_parametro">
		...
	</COMANDO>

}}}

Hay dos formas básicas y se corresponden con el tipo de mensaje ya sea comando o notificación.  [http://www.informatica.us.es:8080/opengnsys/wiki OpenGnSys]:
 * Con un script de instalación. El cual hace uso de Subversion para bajarse la aplicación.
 * A partir de un tar.gz. En este ya está la aplicación completa.
 * Instalación manual a paso a paso. Se obvia el script de instalación y se instala componente a componente.

== Tabla de mnemónicos de tipos de particiones ==

||Identificador||Mnemónico||Tipo de partición||
||00           ||EMPTY    ||Partición vacía no definida||
||05           ||EXTENDED ||Partición extendida que puede contener varias particiones lógicas||
||06, 0e       ||BIGDOS   ||FAT16||
||07           ||NTFS     ||NTFS||
||0b, 0c       ||FAT32    ||FAT32||
||16, 1e       ||HBIGDOS  ||FAT16 oculta||
||17           ||HNTFS    ||NTFS oculta||
||1b, 1c       ||HFAT32   ||FAT32 oculta||
||82           ||LINUX-SWAP||Paginación para Linux (''swap'')||
||83           ||EXT2, EXT3, EXT4, REISERFS, REISER4||Partición Linux tipo Extension o Reiser||
||8e           ||LINUX-LVM||Partición de volumen lógico para Linux||
||a7           ||CACHE    ||Caché local para EAC (se formateará como Ext3)||.
||fd           ||RAID-EXT2, RAID-EXT3, RAID-EXT4||Partición RAID para Linux tipo Ext2, Ext3 o Ext4||
||-            ||UNKNOWN  ||Tipo de partición desconocido.||
||-            ||EXCED    ||Indica cuando una partición tiene espacio libre o se solapa con la siguiente (no es un mnemónico real).||