[[TOC(heading=Índice)]]



= Generación de la ISO del ogLive - Debootstrap, schroot y squashfs - =

Ver información en [http://www.opengnsys.es/browser/trunk/client/boot-tools/INSTALL.es.txt]

== Advertencias previas ===
 - No usar este instalador en un sistema OpenGnSys en producción.
 - Se puede ejecutar este script desde un sistema Ubuntu 10.04 o superior.
 - Utilizar siempre el usuario "root" para ejecutar el proceso de generación del cliente.
   {{{
sudo su -
}}}

== Requisitos iniciales ==

 - Instalar Subversion y Wget, si no están previamente instalados:
   {{{
apt-get install subversion wget
}}}
 - Comprobar la conexión a Internet, sobre todo si se utiliza servidor proxy:
   - apt:        {{{/etc/apt.conf}}}
   - subversion: {{{/etc/subversion/servers}}}
   - otras:      variable {{{http_proxy}}}

== Proceso de instalación ==

 1. Es recomendable renombrar el directorio del cliente actual, para poder realizar una recuperación ante posibles errores:
    {{{
mv /opt/opengnsys/tftpboot/ogclient /opt/opengnsys/tftpboot/ogclientOK
}}}
 2. Descargar el proceso de generación del cliente:
    {{{
mkdir -p /opt/opengnsys/client
svn export http://www.opengnsys.es/svn/branches/version1.0/client /tmp/opengnsys_installer/opengnsys/client
}}}

 3. Ejecutar el proceso de generación del cliente (puede tardar bastante tiempo):
    {{{
/tmp/opengnsys_installer/opengnsys/client/boot-tools/boottoolsgenerator.sh;
}}}

 4. Información requerida durante el proceso de generación:
    - Grup-pc:
      - No marcar ningún disco para instalar Grub  ->  {{{<OK>}}}
      - Continuar sin instalar Grub  ->  {{{<Yes>}}}
    - SSH:
      - Fichero de configuración {{{ssh_config}}}  ->  Pulsar {{{Intro}}}
    - Console-data:
      - Pulsar {{{Select keymap from full list}}}
      - Pulsar {{{pc / qwerty / Spanish / Standard / Standard}}}
    - Instalación de paquetes:
      - Si se produce algún error al instalar un paquete de software, pulsar {{{Intro}}} y continuar.



=== Las fases de la generación de la ISO === 
 * Fase 1. Instalación de software requerido para la generación de la ISO.
 * Fase 2. Asignación de valores a usar en la generación de la ISO, basadas en nuestro sistema operativo.  - kernel -l cliente.
 * Fase 3. Creación del sistema de archivos raiz o rootfilesystem (ogclient.img). 
   * Generación de un disco virtual
   * Particionado del disco duro virtual 
   * Instalación del ogLive en la primera partición del disco virtual, basado en los valores de la fase 2.
 * Fase 4. Configuración del acceso al disco virtual para su posterior modificación. 
 * Fase 5. Instalación de los componentes OpenGnsys usando subversion.   
 * Fase 6. Instalación de herramientas GNU necesarias para OpenGnsys - paquetes deb y compiladas-.
 * Fase 7. Generación del initrd.
 * Fase 8. Exportación del disco duro virtual a formato SQFS.
 * Fase 9. Exportación del disco duro virtual a formato ISO.


Los archivos generados se almacenan en {{{/opt/opengnsys/tftpboot/ogclient}}}, con la siguiente estructura:
 - {{{ogLive-}}}''{{{Codename-Kernel-RevisiónOpenGnSys}}}''{{{.iso}}}: imagen ISO con todo el contenido.
 - {{{ogvmlinuz}}}: Kernel Linux.
 - {{{oginitrd.img}}}: Initrd asociado al Kenrel.
 - {{{ogclient.img}}}: sistema raíz, accesible como disco virtual usando schroot desde el host que lo generó, para ser actualizado.
 - {{{ogclient.sqfs}}}: sistema raíz, comprimido para ser usado por los clientes OpenGnSys.




== Procesos a evaluar ==
=== A través de live-helper ===

TODO

Mirar: [wiki:GnSysLive]

=== Generarlo realizando una instalación limpia de Ubuntu ===

TODO