[[TranslatedPages]]
[[TOC(heading=Índice)]]

== Introducción ==
La versión 1.0 de !OpenGnsys sólo trabaja con imágenes monolíticas.
El proceso de incorporar una imagen para su posterior distribución sería:
  * Alta del objeto imagen en la aplicación OG y la vinculación con el fichero-imagen, desde el botón de opcion general "Imagenes".
  * Almacenar la imagen en el repositorio:
    * Desde el comando->Crear Imagen sobre un ordenador en cuya partición tenga un Sistema Operativo Instalado.
    * Incorporar y reutilizar una imagen desde otra versión !OpenGnsys u otro servidor !OpenGnsys.
    * Incorporar y reutilizar una imagen desde otra aplicación de clonación basada en Softare Libre.
  * La vinculación entre el objeto imagen y el fichero físico de la imagen es automática si coinciden los nombres.

== Alta del objeto imagen en la consola de administración ==

Entramos en la '''pestaña imágenes''' pulsamos con el botón derecho y pulsamos '''definir nueva imagen'''. Nos aparece un formulario que nos pide los siguientes datos:

 * '''Nombre canónico''': Nombre del fichero de la imagen almacenado en el directorio /opt/opengnsys/images del repositorio sin la extensión. 
 *  '''Nombre Imagen''': Nombre con el que se mostrará la imagen en la consola de administración.
 *  '''Perfil Software ''': El perfil de software contiene la información de sistema operativo de la imagen y de los programas que tiene instalados. se creará al crear la imagen o de forma independiente.
 * '''Partición''': Número de la partición donde está instalado
 *  '''Tipo partición''': NTFS, LINUX, etc
 *  '''Repositorio''': Repositorio opengnsys donde está almacenada la imagen. La consola puede administrar varios repositorios 
 *  '''Comentarios''': Información extra sobre la imagen.


[[Image(imagen_nueva.png)]]

Conviene tener en cuenta: 


* La vinculación entre el objeto imagen y el fichero físico de la imagen es automática si coinciden los nombres (nombre canónico con el nombre del fichero).
* Para evitar problemas con el nombre canónico, intentar no utilizar algunos caracteres especiales tales como [ espacios, \ / ` ' . ]
* Todos los campos son obligatorios, a pesar de que algunos no son validados por la aplicación web.


== Crear una imagen desde una partición de un cliente !OpenGnsys ==

Una vez que la imagen esta dada de alta, podemos crearla a partir de una partición de un equipo modelo que está iniciado con el cliente opengnsys. Desde la consola de administración en la pestaña aulas, nos vamos al equipo que deseemos y utilizamos el comando crear imagen. 

Me permite seleccionar la partición que quiero clonar, el nombre de la imagen y el repositorio donde la almacenaré.

[[Image(imagen_crear.png, 100%)]]

El fichero de imagen se almacenará en el repositorio que hayamos elegido en el directorio /opt/opengnsys/images con el nombre canónico acabado en .img

== Incorporar una imagen desde otro servidor o aplicación de clonación ==

Opengnsys puede gestionar imágenes creadas en otros servidores. Es compatible con Brutalix, HIDRA, EAC, FOG, Clonezilla y todas las imágenes creadas con partclone o partimage y comprimidas con lzop o gzip.

El sistema detecta automáticamente el tipo de imagen, en cuanto a compresión, herramenta de clonación y tipo de sistema de ficheros, de forma que podrá restaurarla correctamente.

=== Copiando la imagen a nuestro servidor ===

La imagen deberá ser almacenada en /opt/opengnsys/images del servidor repositorio.

La imagen debe ser un sólo archivo. En el caso de que nuestra imagen haya sido creada en un modo multivolumen, debemos de convertirla en un solo archivo, utilizando para ello la instrucción: cat imagen* >> nuevaimagen.

El nombre de la imagen será la composición del nombre canónico que se introdujo al dar de alta el objeto imagen desde la opción "imagen" de la consola web. 

Según la situación de la imagen tenemos dos casos:

* Si la imagen ya está en /opt/opengnsys/images (debido a que la partición o el disco duro ha sido reutilizado)
  * Eliminamos los .sum y .torrent asociados a dicha imagen, si existen.
  * En el caso de que el nombre de la imagen tuviese una extensión distinta a .img renombrarla para que así sea.

* Si la imagen no está en el directorio /opt/opengnsys/images.
  * Copiarla con una extensión distinta a .img. 
  * Una vez terminado el proceso de copiado, renombrar la imagen para que tenga la extensión .img

!OpenGnsys realiza una serie de procesos para confirmar la integridad de la imagen que guardarán la información en el fichero .sum y el .torrent. Estos procesos acceden a la imagen y la bloquean, de forma que si copiamos la imagen directamente con la extensión .img puede estropearse. 

El proceso de incorporación habrá finalizado cuando aparezcan en /opt/opengnsys/images los correspondientes ficheros asociados a la imagen: para el fichero-imagen.img serán el fichero-imagen.img.sum y fichero-imagen.img.torrent.

Un método para comprobar que la imagen incorporada será reconocida por !OpenGnsys es ejecutar, desde un cliente PXE !Opengnsys la siguiente instrucción:
{{{
(IMGogclient)root@ING2-111:/# ogGetImageInfo /opt/opengnsys/images/201011b1.img
# En este caso, la información que nos proporciona es:
#Herramienta de clonacion : Compresor : Sistema de archivos : tamaño en KB requeridos para ser restaurada
PARTCLONE:LZOP:NTFS:72100000
}}}

== Restaurar una imagen ==
Una vez creada la imagen desde la consola de administración tenemos tres formas de restaurar las imágenes.

 * Comando restaurar: restaura una imagen desde el repositorio por unicast sin utilizar la cache
 * Asistente Deploy de imágenes. Restaura una imagen utilizando la cache. La trae del repositorio a la cache con los protocolos multicast o torrent
 * Asistente Clonación Particiones Remotas. Entre otras opciones, restaura las imagenes contenidas en cache o traidas desde el repo por unicast al resto de equipos del grupo con el protocolo unicast o multicast


=== Comando restaurar ===

En la '''pestaña aulas''' pulsaremos sobre el ámbito deseado con el botón derecho pulsamos el comandos '''Restaurar Imagen'''.

Mostrará la información sobre las particiones del equipo/equipos y el sistema operativo que contienen. 

Nos pedirá información sobre:
 * '''par''': partición de destino de la imagen. 
 * '''Imagen''' (mismo sistema o distinto sistema): la imagen que queremos restaurar
 * '''Método''': sólo utilizará unicast

[[Image(clonacion_comando.png, 100%)]]

=== Asistente de Deploy de imágenes ===

Este asistente realiza los siguientes pasos:
* Se comprueba si existe la imagen en la cache y si coincide con la del repositorio.
* Si no es así, la imagen se guarda desde el servidor en la partición cache de los clientes, utilizando los protocolo P2P, multicast o unicast. 
* Se restaurar dicha imagen desde la cache a la partición destino del cliente. 

Para realizar esta acción en la pestaña aulas pulsaremos sobre el ámbito deseado con el botón derecho  el asistente Deploy de Imagenes.

Nos muestra un formulario que pide que le demos unas opciones básicas y además nos permite modificar los parámetros por defecto que para de cada protocolo se ha definido en el aula.

Las opciones del asistente son:.

    * '''partición a restaurar'''. (destino)
    * '''imagen a utilizar''' (origen)
    * '''protocolo a utilizar''': [multicast|torrent]
    * Opcional: Revisar los parámetros del protocolo.

Una vez incluidos los valores daremos a  '''Generar Instrucción OG''' que creará el codigo a utilizar por los clientes y pulsaremos aceptar para enviarselo.

[[Imagen(deployImage.png, 100%)]]