stta/files/howto.es.txt
2021-10-01 20:46:17 +01:00

189 lines
8.0 KiB
Plaintext

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.
________________________________________________________________________
*****************************************************************************