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