# STTA howto
STTA es una herramienta para administrar Servicios alrededor de Tarantella. Construída como un módulo de Webmin, permite na sincronizar diferentes tecnologías: LDAP, servidor Web, Tarantella, etc. STTA es GPL y puede descargarse aquí.
Author: Jesus Perez
Keywords: tarantella services, servicios tarantella, webmin, webmin module

# Servicios con Tarantella (STTA) - HOWTO

Preparar la instalación de STTA: | COMO INSTALAR STTA
Actualizar ficheros de Ayuda de STTA: | COMO ACTUALIZAR LA AYUDA DE STTA

## ¿ 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 URI::ldap Digest::MD5 IO::Socket::SSL XML::Parser | necesario opcional, se necesita para opcional, se necesita para autenticar opcional, se necesita para opcional, se necesita para | URL parsing SASL CRAM-MD5 Net::LDAPS 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 eli 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/stta/downloads.html
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 actualización no altera el funcionamiento de STTA sólo cambia el contenido de la ayuda on-line.