Servicios con Tarantella (STTA)  - HOWTO

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

Para installar le módulo 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 guía rápida y muy básica estos pasos se describen más abajo.
 En algunos casos se necesitará leer completamente los documentos específicos. 
 En otros se puede saltar al siguiente tema si ya está disponible o se ha realizado.

________________________________________________________________________
 TARANTELLA
________________________________________________________________________
 Seguir las notas de instalación del software de Tarantella.
  
 Asegurarse de que la resolución de "hostname" y del servidor funcionan correctamente.

 Básicamente hay que ejecutar el fichero ".shx" para la plataforma elegida como "root"
 y seguir las preguntas e instrucciones.
  
 Para STTA anotar:   - Directorio de instalación de Tarantella
                     - Puertos activos de Tarantella

________________________________________________________________________
 LDAP
________________________________________________________________________
  Seguir las notas de instalación del software de LDAP.

  Si la elección es OpenLDAP usar:  http://www.openldap.org/software/download/

  Para resultados seguros usar la última versión de LDAP disponible
  para el SO del fabricante o distribuidor.

  Si la elección no es OpenLDAP necesitará usar los procedimientos del software
  para instalar y configurar los servidores y servicios LDAP 
  según las necesidades de  STTA y Tarantella.

  Para STTA anotar: - Directorio de instalación 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 versión 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 módulos/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 básico de perl-ldap tan sólo hay una dependencia,
   Convert::ASN1, todos los otras son opcionales según 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 módulos cuando se necesitan con:

       $bash > perl -MCPAN -e shell
       cpan> install [nombre-del-módulo]

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

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

    Si el PERL instaliado todavía 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 módulos de la distribución contienen documentación. Una vez instalado
    se puede usar 'perldoc Net::LDAP' para obtener la documentación.
    Esta documentación puede apuntar a otros módulos.

    Consultar los ficheros INSTALL y README para obtener más información.
________________________________________________________________________
 Webmin
________________________________________________________________________
 Descargar Webmin:

   Todas las versiones por encima de "1.0" están recomendadas.

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

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

 Si hay una versión antigua de Webmin:
  - se puede actualizar Webmin por medio de la interface de webmin,
    después 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 instalación.

 Si no está instalado Webmin seguir el  "procedimiento de instalación" 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.
      - Módulo 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 distribución de Webmin"  en /usr/local y extraer el contenido.
  - ejecutar "cd [directorio-distribución-webmin]" desde allí ejecutar "./setup.sh"
  - responder a las preguntas de instalación de Webmin y seguir las instrucciones.

  Para más información 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 versión 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 ejecución.
    * Software LDAP software debe estar instalado pero no necesariamente en ejecución.
    * Perl debe estar disponible en el entorno.
    * Perl LDAP debe estar instalado y comprobado.
    * Webmin debe estar en funcionamiento y ejecución.

  Desde la interface de Webmin instalar un nuevo módulo
  usar el "archivo de distribución de STTA".

  Intentar conectarse al "módulo STTA" desde un browser y seguir
  los procedimientos de configuración e instalación, con información paso a paso.
________________________________________________________________________
*****************************************************************************
 COMO ACTUALIZAR LA AYUDA DE STTA
*****************************************************************************
  Descargar el archivo de distribución de http://www.eagora.info/downloads 

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

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

  Esta actualizaciión no altera el funcionamiento de STTA
  sólo cambia el contenido de la ayuda on-line. 
________________________________________________________________________
*****************************************************************************
