Documentación en ficheros README; reestructuración del directorio de escripts de gestión del arranque de clientes.

git-svn-id: https://opengnsys.es/svn/trunk@402 a21b9725-9963-47de-94b9-378ad31fedc9

11 files changed, 109 insertions, 18 deletions

diff --git a/client/README.es.txt b/client/README.es.txt
new file mode 100644
index 00000000..83ee38ce
--- /dev/null
+++ b/client/README.es.txt
@@ -0,0 +1,12 @@
+OpenGNSys Client   README
+=========================
+
+
+Este directorio contiene la estructura de datos del cliente OpenGNSys.
+
+- boot      gestión del proceso de arranque de los clientes.
+- browser   código fuente del cliente gráfico OpenGNSys Browser.
+- engine    funciones del motor (se instalará en el servidor en
+            /opt/opengneys/client/lib/engine).
+- nfsroot   estructura principal del cliente exportado por NFS
+            (se instalará en el servidor en /opt/opengneys/client).
diff --git a/server/clients/README.es b/client/boot/README.es.txt
index 411f8d0a..ea332621 100644
--- a/server/clients/README.es
+++ b/client/boot/README.es.txt
@@ -1,11 +1,15 @@
-Scripts de gestión de clientes de OpenGNSys Server
-==================================================
+OpenGNSys Client Boot   README
+==============================
 
-En este directorio se incluyen los scripts y ficheros necesarios
-para configurar los clientes, ejecutables directamente desde el
-servidor de OpenGNSys.
+En este directorio se incluyen los scripts y ficheros, ejecutables
+directamente desde el servidor de OpenGNSys, y que son necesarios
+para configurar los procesos de arranque de los clientes.
 
 
+initrd-generator            (copiar en /opt/opengnsys/bin)
+    Script de generación de los básicos de arranque del cliente
+    (initrd y kernel).
+
 upgrade-clients-udeb.sh     (copiar en /opt/opengnsys/bin)
     Script de descarga de paquetes udeb, que serán incluidos en
     el directorio de librerías importadas por los clientes.
diff --git a/server/clients/udeblist.conf b/client/boot/udeblist.conf
index d5858518..d5858518 100644
--- a/server/clients/udeblist.conf
+++ b/client/boot/udeblist.conf
diff --git a/server/clients/upgrade-clients-udeb.sh b/client/boot/upgrade-clients-udeb.sh
index a97ce937..a97ce937 100755
--- a/server/clients/upgrade-clients-udeb.sh
+++ b/client/boot/upgrade-clients-udeb.sh
diff --git a/client/engine/README.es.txt b/client/engine/README.es.txt
index 7651e630..10b20779 100644
--- a/client/engine/README.es.txt
+++ b/client/engine/README.es.txt
@@ -2,10 +2,28 @@
 OpenGNSys Client Cloning Engine  README
 =======================================
 
-En este directorio se incluirán las funciones del motor de clonación de
-OpenGNSys y la documentación asociada.
+En este directorio se incluirán las funciones del motor de
+clonación de OpenGNSys y la documentación asociada.
+
+Este directorio estará localizado en el directorio del servidor
+/opt/opengnsys/client/lib/engine/bin
 
 Las funciones serán accesibles por el cliente en el directorio
 /opt/opengnsys/lib/engine/bin
 
+OpenGNSys Client Cloning Engine se distribuye en un conjunto
+de librerías que incluyen funciones BASH que deben ser exportadas
+al entorno del cliente.
+
+Librerías:
+
+- Boot.lib         funciones de arranque y posconfiguración de
+                   sistemas operativos.
+- Disk.lib         funciones de control de dispositivos de disco.
+- File.lib         funciones de manipulación de ficheros.
+- FileSystem.lib   funciones de gestión de sistemas de ficheros.
+- Image.lib        funciones de administración de imágenes de
+                   sistemas operativos.
+- Inventory.lib    funciones de control de inventario e informes.
+- System.lib       funciones básicas del sistema.
 
diff --git a/client/engine/System.lib b/client/engine/System.lib
index 8e5eaa5a..b4cd0e42 100755
--- a/client/engine/System.lib
+++ b/client/engine/System.lib
@@ -83,7 +83,7 @@ local MSG CODE
 #/// Obtener código y mensaje de error.
 CODE=$1
 case "$CODE" in
-     $OG_ERR_FORMAT)    MSG="$MSG_ERR_FORMAT $*" ;;
+     $OG_ERR_FORMAT)    MSG="$MSG_ERR_FORMAT \"$2\"" ;;
      $OG_ERR_NOTFOUND)	MSG="$MSG_ERR_NOTFOUND \"$2\"" ;;
      $OG_ERR_PARTITION)	MSG="$MSG_ERR_PARTITION \"$2\"" ;;
      $OG_ERR_LOCKED)   	MSG="$MSG_ERR_LOCKED \"$2\"" ;;
diff --git a/client/nfsexport/README.es.txt b/client/nfsexport/README.es.txt
new file mode 100644
index 00000000..4ad361cb
--- /dev/null
+++ b/client/nfsexport/README.es.txt
@@ -0,0 +1,25 @@
+OpenGNSys Client (NFS root)   README
+====================================
+
+
+Este directorio contiene la estructura principal de datos que
+será importada por los cleintes OpenGNSys mediante NFS.
+
+Los subdirectorios se copian íntegramente al servidor bajo
+/opt/opengnsys/client, y serán importados por los clientes en
+/opt/opengnsys.
+
+La estructura de datos es la siguiente:
+
+- bin       binarios ejecutables por el cliente (compilados
+            estáticamente).
+- cache     directorio donde se montará la caché local del cliente.
+- etc       ficheros de configuración del cliente.
+- lib       librerías de funciones.
+- lib/engine/bin   directorio donde se copiarán las funciones del
+                   motor de clonación.
+- images    repositorio de imágenes de sistemas operativos.
+- log       registro de incidencias de los clientes.
+- scripts   funciones de alto nivel ejecutables por OpenGNSys Browser
+            y OpenGNSys Admin.
+
diff --git a/client/nfsexport/etc/lang.es_ES.conf b/client/nfsexport/etc/lang.es_ES.conf
index 387b0037..9f61f647 100644
--- a/client/nfsexport/etc/lang.es_ES.conf
+++ b/client/nfsexport/etc/lang.es_ES.conf
@@ -23,7 +23,9 @@ MSG_INSTALLED="instalado"
 MSG_RESERVEDVALUE="Valor reservado"
 
 MSG_HELP_ogBoot=""
-MSG_HELP_ogCreateImage=""
+MSG_HELP_ogCheckFs=""
+MSG_HELP_ogCopyFile=""
+MSG_HELP_ogCreateImage="Genera una imagen exacta de un sistema operativo instalado localmente."
 MSG_HELP_ogCreatePartitions=""
 MSG_HELP_ogDeleteFile=""
 MSG_HELP_ogDeleteTree=""
@@ -31,13 +33,15 @@ MSG_HELP_ogDevToDisk="Devuelve el nº de orden de dicso o de partición correspo
 MSG_HELP_ogDiskToDev="Devuelve el camino del fichero de dispositivo correspondiente al nº de orden de dicso o de partición."
 MSG_HELP_ogEcho=""
 MSG_HELP_ogExtendFs="Extiende el tamaño de un sistema de archivo al máximo de su partición."
-MSG_HELP_ogGetFormat=""
-MSG_HELP_ogGetFormatCache=""
-MSG_HELP_ogGetFormatFs=""
+MSG_HELP_ogFormat=""
+MSG_HELP_ogFormatCache=""
+MSG_HELP_ogFormatFs=$MSG_HELP_ogFormat
 MSG_HELP_ogGetFsType=""
+MSG_HELP_ogGetHostname=""
 MSG_HELP_ogGetImageSize="Devuelve el tamaño de una imagen de sistema."
+MSG_HELP_ogGetMountPoint="Devuelve el directorio donde está montado un sistema de archivos local."
+MSG_HELP_ogGetOsType="Devuelve el tipo de un sistema operativo instalado."
 MSG_HELP_ogGetOsVersion="Devuelve el tipo y la versión de un sistema operativo instalado."
-MSG_HELP_ogGetMountPoint="Muestra el punto de montaje de un sistema de archivos."
 MSG_HELP_ogGetParentPath=""
 MSG_HELP_ogGetPartitionActive="Indica cual es la partición marcada como activa en un disco."
 MSG_HELP_ogGetPartitionId="Devuelve el identificador de tipo de una partición."
@@ -47,7 +51,7 @@ MSG_HELP_ogGetRegistryValue="Devuelve el dato de un valor del registro de Window
 MSG_HELP_ogGetWindowsName="Devuelve el nombre del cliente guardado en el registro de Windows."
 MSG_HELP_ogHelp="Muestra mensajes de ayudas para las funciones."
 MSG_HELP_ogIsLocked="Comprueba si una partición está bloqueada para una operación de uso exclusivo."
-MSG_HELP_ogIsMounted="Comprueba si un sistema de archivos está montado."
+MSG_HELP_ogIsMounted="Comprueba si un sistema operativo está montado."
 MSG_HELP_ogLinuxBootParameters=""
 MSG_HELP_ogListHardwareInfo="Lista el inventario de dispositivos del cliente."
 MSG_HELP_ogListHardwareInfo="Lista el inventario de dispositivos del cliente."
@@ -61,8 +65,9 @@ MSG_HELP_ogMountCdrom=""
 MSG_HELP_ogMountFs=$MSG_HELP_ogMount
 MSG_HELP_ogRaiseError="Muestra y registra mensajes de error y devuelve el código correspondiente."
 MSG_HELP_ogReduceFs="Reduce el tamaño del sistema de archivos al mínimo ocupado por sus datos."
-MSG_HELP_ogRestoreImage=""
+MSG_HELP_ogRestoreImage="Restaura una imagen de sistema operativo."
 MSG_HELP_ogSetPartitionActive="Establece el número de partición activa de un disco."
+MSG_HELP_ogSetPartitionId="Modifica el identificador de tipo de una partición física."
 MSG_HELP_ogSetPartitionSize="Establece el tamaño de una partición."
 MSG_HELP_ogSetRegistryValue="Asigna un dato a un valor del registro de Windows."
 MSG_HELP_ogSetWindowsName="Asigna el nombre del cliente en el registro de Windows."
diff --git a/client/nfsexport/scripts/README.es.txt b/client/nfsexport/scripts/README.es.txt
new file mode 100644
index 00000000..e0a15177
--- /dev/null
+++ b/client/nfsexport/scripts/README.es.txt
@@ -0,0 +1,23 @@
+OpenGNSys Client (Scripts)    README
+====================================
+
+
+Este directorio contiene algunos scripts de ejemplo que pueden
+utilizarse para realizar las operaciones más comunes de gestión
+de imágenes y arranque de clientes.
+
+Dichos scripts están desarrollados en BASH y utilizan las
+funciones básicas del motor de clonación.
+
+OpenGNSys Client Cloning Engine incluye un completo conjunto de
+funiones para que le administrador pueda personalizar sus scripts
+de gestión.  Sin embargo, estos ejemplos son completamente
+operativos y pueden ser utilizados directamente.
+
+
+Scripts distribuidos:
+
+- boot.sh            arranca un sistema operativo instalado.
+- create-image.sh    genera una imagen de un sistema operativo.
+- restore-image.sh   restaura una imagen de sistema operativo.
+
diff --git a/client/nfsexport/scripts/boot.sh b/client/nfsexport/scripts/boot.sh
index 17408ee7..2a97d8f2 100755
--- a/client/nfsexport/scripts/boot.sh
+++ b/client/nfsexport/scripts/boot.sh
@@ -11,6 +11,8 @@ fi
 # Procesos previos.
 
 # Arrancar.
+ogEcho info "$PROG: Desmontar todos los sistemas operativos del disco."
+ogUnmountAll "$1" | exit $?
 ogEcho info "$PROG: Arrancar sistema operativo."
 ogBoot "$1" "$2"
 
diff --git a/installer/opengnsys_installer.sh b/installer/opengnsys_installer.sh
index e336bca6..9ce19572 100755
--- a/installer/opengnsys_installer.sh
+++ b/installer/opengnsys_installer.sh
@@ -495,9 +495,11 @@ openGnsysCopyServerFiles () {
 
 	local path_opengnsys_base=$1
 
-	local SOURCES=( server/clients/upgrade-clients-udeb.sh \
-                    server/clients/udeblist.conf )
-	local TARGETS=( bin/upgrade-clients-udeb.sh \
+	local SOURCES=( client/boot/initrd-generator \
+                    client/boot/upgrade-clients-udeb.sh \
+                    client/boot/udeblist.conf )
+	local TARGETS=( bin/initrd-generator \
+                    bin/upgrade-clients-udeb.sh \
                     etc/udeblist.conf )
 
 	if [ ${#SOURCES[@]} != ${#TARGETS[@]} ]; then