stta/files/howto.es.txt

Servicios con Tarantella (STTA)  - HOWTO

*****************************************************************************
<EFBFBD> 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<67>a r<>pida y muy b<>sica estos pasos se describen m<>s abajo.
 En algunos casos se necesitar<61> leer completamente los documentos espec<65>ficos. 
 En otros se puede saltar al siguiente tema si ya est<73> disponible o se ha realizado.

________________________________________________________________________
 TARANTELLA
________________________________________________________________________
 Seguir las notas de instalaci<63>n del software de Tarantella.
  
 Asegurarse de que la resoluci<63>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<63>n de Tarantella
                     - Puertos activos de Tarantella

________________________________________________________________________
 LDAP
________________________________________________________________________
  Seguir las notas de instalaci<63>n del software de LDAP.

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

  Para resultados seguros usar la <20>ltima versi<73>n de LDAP disponible
  para el SO del fabricante o distribuidor.

  Si la elecci<63>n no es OpenLDAP necesitar<61> usar los procedimientos del software
  para instalar y configurar los servidores y servicios LDAP 
  seg<65>n las necesidades de  STTA y Tarantella.

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

 Para resultados seguros usar la <20>ltima versi<73>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<65>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<73> 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<73> 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<61>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<63>n contienen documentaci<63>n. Una vez instalado
    se puede usar 'perldoc Net::LDAP' para obtener la documentaci<63>n.
    Esta documentaci<63>n puede apuntar a otros m<>dulos.

    Consultar los ficheros INSTALL y README para obtener m<>s informaci<63>n.
________________________________________________________________________
 Webmin
________________________________________________________________________
 Descargar Webmin:

   Todas las versiones por encima de "1.0" est<73>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<63>n" - "tar/gzip distribution archive".

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

 Si no est<73> instalado Webmin seguir el  "procedimiento de instalaci<63>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 <20>ltimo)

  Instalar Webmin: 
  - poner el "archivo de distribuci<63>n de Webmin"  en /usr/local y extraer el contenido.
  - ejecutar "cd [directorio-distribuci<63>n-webmin]" desde all<6C> ejecutar "./setup.sh"
  - responder a las preguntas de instalaci<63>n de Webmin y seguir las instrucciones.

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

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

  Intentar conectarse al "m<>dulo STTA" desde un browser y seguir
  los procedimientos de configuraci<63>n e instalaci<63>n, con informaci<63>n paso a paso.
________________________________________________________________________
*****************************************************************************
 COMO ACTUALIZAR LA AYUDA DE STTA
*****************************************************************************
  Descargar el archivo de distribuci<63>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<63>n "tar.gz"

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

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