PackFast Files

=====     Notas al instalador de aplicaciones BASH, PACKFAST     ===== 
PACKFAST, constructor de respaldos compactados por version de paquete,
instalador ejecutable del paquete y archivo compacto con los ficheros
de distribucion de los programas.

>>>INTRODUCCION
Este archivo expone una descripcion general de PACKFAST para familiarse con
la filosofia usada en su concepcion. Tambien se expone su instalacion, que es
muy sencilla y finalmente la configuracion para que se ajuste al instalador 
del paquete que se construye.

El requerimiento basico de este instalador es tener instalado el paquete 'openssl'.
En las distribuciones Debian y las basadas en Debian, esto se logra ejecutando 
el siguiente comando:

  apt-get update && apt-get install openssl

La idea funcional de PACKFAST, es construir un paquete compactado con todos
los ficheros distribuibles distribuidos en directorios que semejan a la 
locacion final en las PC y colocarlo embebido (es por esta razon que se
requiere tener instalado el paquete openssl) dentro de un ejecutable que 
actua como instalador automatico de la aplicacion.

>>>DESCRIPCION
PACKFAST es un programa BASH que se usa para construir un instalador de
aplicaciones, que inicialmente fueron pensadas a ser aplicaciones grandes y
complejas en BASH; pero que en la practica se ha usado con exito para otros
tipos de aplicaciones.

PACKFAST esta compuesto de los siguientes fichero:

  packfast     - Ejecutable constructor del instalador de la aplicacion.
  packfast.txt - Este fichero.
  packprepare  - Intrucciones a ejecutar antes de constuir un instalador.
  packinstall  - Plantilla para construir el instalador de la aplicacion
  packfast.conf   - Fichero de configuracion del constuctor de instaladores.
  packpostinstall - Programa de usuario que es llamado al final de un
                 proceso de instalacion para hacer cualquier ajuste
                 pertinente, una vez copiados los ficheros de la aplicacion 
                 en los correspondientes directorios de la maquina.

PACKFAST espera residir en un directorio dentro del cual se desplegaran
todos los ficheros requeridos en la construccion de la aplicacion en
un sub-directorio que se tiene que nombrar "dist" y dentro del cual se
mimetiza la distribucion de ficheros como tienen que quedar finalmente
instaldos en el sistema de ficheros de la maquina donde se haga la
instalacion. Esto se muestra bien en el siguiente esquema:

  <<dir_base>>
      |    packfast
      |    packfast.conf
      |    packinstall
      |    packprepare
      |    packpostinstall
      |       .
      |       .
      |       .
      |    paquete-<version>.tar.bz2   (Todos los archivos de desarrollo)
      |
      |
      -------><dist>
      |         |
      |         ---> mimetizacion de los directorios del sistema donde
      |              se deben desplegar los archivos de la aplicacion
      |
      -------><install>
      |              paquete-<version>.tar.bz2   (Archivos de distribucion)
      |              paquete-install-<version>.sh
      |          
      .
      .
      .
      |
      ---> otros directorios y archivos usados en el desarrollo del paquete


>>>INSTALACION Y USO

  1- Copie los archivos packfast, packfast.txt, packinstall,
  packfast.conf y packpostinstall al directorio base de desarrollo de una
  aplicaccion.

  2- Edite el fichero packfast.conf para establecer los parametros requeridos.
  La explicacion de cada parametro se encuentra dentro del propio fichero y 
  tambien esta expuesto mas adelante.

  3- Ejecute <<dir_base>>/packfast para construir el instalador de la
  aplicacion.

Cada vez que ejecute "packfast", se generaran los siguientes ficheros:

  paquete-<version>.tar.bz2 archivo compactado en el directorio "base" con 
         todos los archivos de desarrollo del paquete.
  paquete-<version>.tar.bz2 archivo compactado en el directorio "/base/install" 
         con todos los archivos distribuibles del paquete.
  paquete-install-<version>.sh ejecutable de instalacion automatica del
         paquete.

y los siguientes archivos auxiliares en el directorio "base"

  paquete.md5 con la suma MD5 de cada fichero de distribucion del paquete.
  paquete.ver conteniendo la ultima version que se compilo del paquete.
  listadofull.lst con la lista de todos los ficheros de desarrollo.

>>>CONFIGURACION
En el fichero de configuracion packfast.conf se tienen que establecer los siguientes
parametros:

NOMBREPRG - El parametro NOMBREPRG contiene el nombre con el que se denominara
        al paquete, los archivos compactados que se generan y el ejecutable de 
        instalacion del paquete.

DESCPRG - Este parametro contiene una descripcion breve en una linea  con la 
       caracterizacion del paquete. Por ejemplo, si el nombre del paquete 
       es una sigla, puede ser el despliege de la sigla.
       DESCPRG="Controlador de servicio de alta disponibilidad"

FICHPRG - Este parametro es el nombre del fichero del cual se obtiene la version 
          del paquete definida una variable con nombre VERSION, que pudiera 
          introducirse con cualquiera de las siguientes modalidades compatibles 
          con los programas BASH:
            VERSION=1.9.23
            VERSION='1.9.23'
            declare VERSION=1.9.23
            typedef VERSION=1.9.23
         o simplemente usar un fichero textual conteniendo VERSION=1.9.23

ALLOWCOMMENTS - Este parametro es una directiva que indica si en el fichero BASH
        de instalacion se deben preservar las lineas de comentarios o no. 
        Para eliminar los comentarios hay que establecer cualquier valor indicado
           COMMENTPRG=0|no|NO
        Para preservar los comentarios, usar 1|si|SI|yes|YES 

>>>INSTALACION DEL PAQUETE CREADO

1- Copiar el archivo paquete-install-<version>.sh que genera PACKFAST para
   la maquina donde se desea instalar el mismo.

2- En la maquina donde se desea instalar un paquete generado por PACKFAST,
   simplemente ejecutar:

       paquete-install-<version>.sh
   
   Si deseamos ver que ficheros se copiarian a la maquina antes de la
   instalacion propiamente, se ejecuta entonces

       paquete-install-<version>.sh -n

  que indica todas las operaciones de copia de ficheros sin hacer copia de
  los mismos, igual que si se estuviera instalando el paquete.