Servicios con Tarantella (STTA)  - HOWTO

*****************************************************************************
 COMO INSTALLAR STTA ?
*****************************************************************************

Para installar le mdulo de Webmin STTA (Servicios con Tarantella) se necesita:

    * Instalar or tener instalado el Software de Tarantella en el servidor.
    * Instalar or tener instalado el Software de LDAP en el servidor.
    * Instalar or tener instalado Perl bajo el entorno del servidor.
    * Instalar or tener instalado Perl LDAP en el servidor.
    * Instalar or tener instalado Webmin en el servidor.

 Como gua rpida y muy bsica estos pasos se describen ms abajo.
 En algunos casos se necesitar leer completamente los documentos especficos. 
 En otros se puede saltar al siguiente tema si ya est disponible o se ha realizado.

________________________________________________________________________
 TARANTELLA
________________________________________________________________________
 Seguir las notas de instalacin del software de Tarantella.
  
 Asegurarse de que la resolucin de "hostname" y del servidor funcionan correctamente.

 Bsicamente hay que ejecutar el fichero ".shx" para la plataforma elegida como "root"
 y seguir las preguntas e instrucciones.
  
 Para STTA anotar:   - Directorio de instalacin de Tarantella
                     - Puertos activos de Tarantella

________________________________________________________________________
 LDAP
________________________________________________________________________
  Seguir las notas de instalacin del software de LDAP.

  Si la eleccin es OpenLDAP usar:  http://www.openldap.org/software/download/

  Para resultados seguros usar la ltima versin de LDAP disponible
  para el SO del fabricante o distribuidor.

  Si la eleccin no es OpenLDAP necesitar usar los procedimientos del software
  para instalar y configurar los servidores y servicios LDAP 
  segn las necesidades de  STTA y Tarantella.

  Para STTA anotar: - Directorio de instalacin de LDAP 
                    - Puertos activos y nombres de LDAP. (si no es OpenLDAP).
_______________________________________________________________________________
 PERL
_______________________________________________________________________________
 Comprobar Perl en el Sistema Operativo. Si no est disponible descargarlo de:
 
   http://www.perl.org

 Para resultados seguros usar la ltima versin de PERL disponible
 para el SO del fabricante o distribuidor.

  Para Webmin y STTA anotar:   - PERL path 

________________________________________________________________________
 Perl LDAP
________________________________________________________________________

 1)   Perl-ldap usa los siguientes mdulos/distribuciones:

	Convert::ASN1   - necesario
	URI::ldap       - opcional, se necesita para URL parsing
	Digest::MD5     - opcional, se necesita para autenticar SASL CRAM-MD5 
	IO::Socket::SSL - opcional, se necesita para Net::LDAPS
	XML::Parser     - opcional, se necesita para Net::LDAP::DSML

   Para usar lo bsico de perl-ldap tan slo hay una dependencia,
   Convert::ASN1, todos los otras son opcionales segn el uso y 
   funcionalidad que se desee. Ver el fichero README.
   Si se precisa installar uno o varios de ellos ir a http://search.cpan.org 
   o si el servidor est conectado a Internet se puede usar la infraestructura Perl
   para comprobar dependencias e instalar mdulos cuando se necesitan con:

       $bash > perl -MCPAN -e shell
       cpan> install [nombre-del-mdulo]

 2) Si el servidor est conectado a Internet
    se puede usar la infraestructura Perl
    para comprobar dependencias e instalar el mdulo con:

    $bash > perl -MCPAN -e shell
    cpan> install Net::LDAP

    Si el PERL instaliado todava no tiene perl-ldap, descargarlo desde:

    SourceForge:

    http://prdownloads.sourceforge.net/perl-ldap/perl-ldap-0.26.tar.gz?download

    o desde Perl CPAN  
    http://search.cpan.org/CPAN/authors/id/G/GB/GBARR/perl-ldap-0.26.tar.gz
    o desde cualquier "mirror CPAN" disponible.

    Si en el sistema se puede ejecutar Makefile.PL y puede suar make,
    entonces el paquete puede ser instalado con los precedimientos normales MakeMaker,
    esto es:
    
      gunzip perl-ldap-*.**.tar.gz
      tar xvf perl-ldap-*.**
      cd perl-ldap-*.**
      perl Makefile.PL
      make
      make test
      make install

    Varios de los mdulos de la distribucin contienen documentacin. Una vez instalado
    se puede usar 'perldoc Net::LDAP' para obtener la documentacin.
    Esta documentacin puede apuntar a otros mdulos.

    Consultar los ficheros INSTALL y README para obtener ms informacin.
________________________________________________________________________
 Webmin
________________________________________________________________________
 Descargar Webmin:

   Todas las versiones por encima de "1.0" estn recomendadas.

   http://www.webmin.com/download.html

 Para trabajar en diferentes plataformas usar el fichero  "tar.gz" conocido como
 "archivo tar/gzip de distribucin" - "tar/gzip distribution archive".

 Si hay una versin antigua de Webmin:
  - se puede actualizar Webmin por medio de la interface de webmin,
    despus de finalizar y comprobarlo todo borrar el contenido del antiguo directorio.
  - para empezar desde el principio o desde cero:
    "parar webmin", borrar "/etc/webmin" y los directorios antiguos de Webmin,
    seguir entonces el procedimiento de instalacin.

 Si no est instalado Webmin seguir el  "procedimiento de instalacin" como "root":

  Si se va a usar SSL con Webmin hay que descargar e instalar:
      - Biblioteca OpenSSL desde http://www.openssl.org o del distribuidor del SO.
      - Mdulo Perl Net::SSLeay Perl disponible desde los archivos Perl CPAN
        http://search.cpan.org/search?query=Net::SSLeay&mode=all  (usar el ltimo)

  Instalar Webmin: 
  - poner el "archivo de distribucin de Webmin"  en /usr/local y extraer el contenido.
  - ejecutar "cd [directorio-distribucin-webmin]" desde all ejecutar "./setup.sh"
  - responder a las preguntas de instalacin de Webmin y seguir las instrucciones.

  Para ms informacin y ejemplos ver: http://www.webmin.com/download.html

  Para STTA anotar:   - URL del servidor Webmin, puertos y credenciales.
________________________________________________________________________
 STTA 
________________________________________________________________________

   Usar a partir de la versin 1.3 o superior y descargar desde:

   http://www.eagora.info/stta 

   Para evitar problemas llegado este punto:

    * Software de Tarantella debe estar instalado pero no necesariamente en ejecucin.
    * Software LDAP software debe estar instalado pero no necesariamente en ejecucin.
    * Perl debe estar disponible en el entorno.
    * Perl LDAP debe estar instalado y comprobado.
    * Webmin debe estar en funcionamiento y ejecucin.

  Desde la interface de Webmin instalar un nuevo mdulo
  usar el "archivo de distribucin de STTA".

  Intentar conectarse al "mdulo STTA" desde un browser y seguir
  los procedimientos de configuracin e instalacin, con informacin paso a paso.
________________________________________________________________________
*****************************************************************************
 COMO ACTUALIZAR LA AYUDA DE STTA
*****************************************************************************
  Descargar el archivo de distribucin de http://www.eagora.info/downloads 

  Ir al directorio "stta" de Webmin (cd /usr/local/webmin*/stta)
  extraer el contenido del archivo de distribucin "tar.gz"

  Este proceso sobrescribe el contenido del directorio "help" de "stta"
  Si se dispone de algn servidor Web con la Ayuda de STTA
  esta debe actualizarse por el procedimiento
  para "Generar Web de Ayuda" de STTA

  Esta actualizaciin no altera el funcionamiento de STTA
  slo cambia el contenido de la ayuda on-line. 
________________________________________________________________________
*****************************************************************************
