<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<META http-equiv="refresh" CONTENT="0; URL=http://alhambra/cgi-local/stta?howto.html">
<head>
<TITLE>STTA howto</TITLE>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<meta name="description" content="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í."/>
<meta name="Author" content="Jesus Perez" />
<meta name="keywords" content="tarantella services, servicios tarantella, webmin, webmin module" />
<meta name="robots" content="index,follow" />
</head>
<link rel="icon" href="/stta/images/webmin_icon.png" type="image/png">
<link rel="shortcut icon" href="/stta/images/webmin_icon.png">
<link rel="bookmark icon" href="/stta/images/webmin_icon.png">
<body>
<table border="1" cellpadding="2" cellspacing="2">
<tr><td bgcolor="#ba9e79"><h1><font color="#ffffff">Servicios con Tarantella (STTA) - HOWTO</font></h1></td></tr>
<tr><td bgcolor="#ffe0b0"><table>
<tbody>
<tr><td> Preparar la instalación de STTA:</td><td> <a href="#howtoinstall"><b> COMO INSTALAR STTA</b></a> </td></tr>
<tr><td> Actualizar ficheros de Ayuda de STTA:</td><td> <a href="#howtoupdhelp"><b> COMO ACTUALIZAR LA AYUDA DE STTA</b></a> </td></tr>
</tbody>
</td></tr></table>
</table>
<br>
<br>
<hr>
<a name="howtoinstall"></a>
<table border="1" width="100%" cellpadding="2" cellspacing="2" bgcolor="#ba9e79">
<tbody> <tr> <td bgcolor="#ba9e79">
<h2><font color="#ffffff">¿ COMO INSTALLAR STTA ?</font></h2>
</td> </tr> </tbody>
</table>
Para installar le módulo de <a href="#stta" name="STTA">Webmin STTA</a> (Servicios con Tarantella)
se necesita: <br>
<ul>
<li>Instalar or tener instalado el <a href="#tarantella" name="Tarantella">Software de Tarantell</a>a en el servidor.
</li>
<li>Instalar or tener instalado el<a href="#ldap" name="LDAP"> Software de LDAP</a> en el servidor.
</li>
<li>Instalar or tener instalado<a href="#perl" name="Perl"> Perl</a> bajo el entorno del servidor.
</li>
<li>Instalar or tener instalado <a href="#perl-ldap" name="PERL LDAP">Perl LDAP</a> en el servidor. </li>
<li>Instalar or tener instalado <a href="#webmin" name="Webmin">Webmin</a> en el servidor. </li>
</ul>
<br>
Como guía rápida y muy básica estos pasos se describen
más abajo. <br>
En algunos casos se necesitará leer completamente los documentos
específicos. <br>
En otros se puede saltar al siguiente tema si ya está disponible
o se ha realizado. <br>
<br>
<a name="tarantella"></a>
<table border="1" width="100%" cellpadding="2" cellspacing="2">
<tbody> <tr><td bgcolor="#ffe0b0">
<h2>TARANTELLA</h2>
</td></tr></tbody>
</table>
Seguir las notas de instalación del software de Tarantella. <br>
<br>
Asegurarse de que la resolución de "hostname" y del servidor funcionan
correctamente. <br>
<br>
Básicamente hay que ejecutar el fichero ".shx" para la plataforma
elegida como "root" <br>
y seguir las preguntas e instrucciones. <br>
<br>
<i> Para STTA anotar: - Directorio de instalación
de Tarantella <br>
- Puertos
activos de Tarantella</i> <br>
<a name="ldap"></a>
<table border="1" width="100%" cellpadding="2" cellspacing="2">
<tbody> <tr> <td bgcolor="#ffe0b0">
<h2>LDAP</h2>
</td> </tr> </tbody>
</table>
Seguir las notas de instalación del software
de LDAP. <br>
<br>
Si la elección es OpenLDAP usar: <a
href="http://www.openldap.org/software/download/">http://www.openldap.org/software/download/
</a><br>
<br>
Para resultados seguros usar la última versión
de LDAP disponible <br>
para el SO del fabricante o distribuidor. <br>
<br>
Si la elección no es OpenLDAP necesitará
usar los procedimientos del software <br>
para instalar y configurar los servidores y servicios
LDAP <br>
según las necesidades de STTA y Tarantella.
<br>
<br>
<i> Para STTA anotar: - Directorio de instalación
de LDAP </i><br>
-<i> Puertos
activos y nombres de LDAP. (si no es OpenLDAP).</i> <br>
<a name="perl"></a>
<table border="1" width="100%" cellpadding="2" cellspacing="2">
<tbody> <tr> <td bgcolor="#ffe0b0">
<h2>PERL</h2>
</td> </tr> </tbody>
</table>
Comprobar Perl en el Sistema Operativo. Si no está
disponible descargarlo de: <a href="http://www.perl.org">http://www.perl.org
</a><br>
<br>
Para resultados seguros usar la última versión
de PERL disponible <br>
para el SO del fabricante o distribuidor. <br>
<br>
<i> Para Webmin y STTA anotar: - PERL path </i><br>
<a name="perl-ldap"></a>
<table border="1" width="100%" cellpadding="2" cellspacing="2">
<tbody><tr><td bgcolor="#ffe0b0">
<h2>Perl LDAP</h2>
</td> </tr> </tbody>
</table><br>
<b> 1) </b>Perl-ldap usa los siguientes módulos/distribuciones:
<br>
<table align=center cellpadding="2" cellspacing="2" border="1" width="80%">
<tbody> <tr> <td valign="top">
<b>Convert::ASN1</b><br>
<b> URI::ldap</b><br>
<b> Digest::MD5</b><br>
<b> IO::Socket::SSL</b><br>
<b> XML::Parser</b><br>
</td>
<td valign="top">necesario <br>
opcional, se necesita para<br>
opcional, se necesita para autenticar <br>
opcional, se necesita para <br>
opcional, se necesita para<br>
</td>
<td valign="top"><br>
URL parsing <br>
SASL CRAM-MD5 <br>
Net::LDAPS <br>
Net::LDAP::DSML<br>
</td></tr></tbody>
</table>
<br>
Para usar lo básico de perl-ldap tan sólo hay
una dependencia, <br>
Convert::ASN1, todos los otras son opcionales según
el uso y <br>
funcionalidad que se desee. Ver eli fichero README. <br>
Si se precisa installar uno o varios de ellos ir a <a
href="http://search.cpan.org">http://search.cpan.org</a> <br>
o si el servidor está conectado a Internet se
puede usar la infraestructura Perl <br>
para comprobar dependencias e instalar módulos cuando
se necesitan con:
<table align=center cellpadding="2" cellspacing="2" border="1" width="40%">
<tbody> <tr> <td valign="top">
$bash > perl -MCPAN -e shell <br>
cpan> install <b>[nombre-del-módulo]</b><br>
</td> </tr> </tbody>
</table>
<br>
<b>2)</b> Si el servidor está conectado a Internet <br>
se puede usar la infraestructura Perl <br>
para comprobar dependencias e instalar el módulo
con: <br>
<table align=center cellpadding="2" cellspacing="2" border="1" width="40%">
<tbody> <tr> <td valign="top">
$bash > perl -MCPAN -e shell <br>
cpan> install <b>Net::LDAP </b><br>
</td> </tr> </tbody>
</table>
<br>
Si el PERL instaliado todavía no tiene perl-ldap, descargarlo
desde: <br>
<br>
<u>SourceForge</u>: <a
href="http://prdownloads.sourceforge.net/perl-ldap/perl-ldap-0.26.tar.gz?download">http://prdownloads.sourceforge.net/perl-ldap/perl-ldap-0.26.tar.gz?download
</a><br>
<br>
<u>o desde Perl CPAN </u> <a
href="http://search.cpan.org/CPAN/authors/id/G/GB/GBARR/perl-ldap-0.26.tar.gz">http://search.cpan.org/CPAN/authors/id/G/GB/GBARR/perl-ldap-0.26.tar.gz
</a><br>
o desde cualquier "mirror CPAN" disponible. <br>
<br>
Si en el sistema se puede ejecutar Makefile.PL y puede
suar make, <br>
entonces el paquete puede ser instalado con los precedimientos
normales MakeMaker, <br>
esto es: <br>
<table cellpadding="2" align=center cellspacing="2" border="1" width="40%">
<tbody> <tr> <td valign="top">
gunzip perl-ldap-*.**.tar.gz <br>
tar xvf perl-ldap-*.** <br>
cd perl-ldap-*.** <br>
perl Makefile.PL <br>
make <br>
make test <br>
make install <br>
<br>
</td></tr></tbody>
</table>
<br>
Varios de los módulos de la distribución contienen
documentación. Una vez instalado <br>
se puede usar '<i>perldoc </i><b>Net::LDAP</b>' para obtener
la documentación. <br>
Esta documentación puede apuntar a otros módulos.
<br>
<br>
Consultar los ficheros INSTALL y README para obtener más
información. <br>
<a name="webmin"></a>
<table border="1" width="100%" cellpadding="2" cellspacing="2">
<tbody> <tr> <td bgcolor="#ffe0b0">
<h2>Webmin</h2>
</td> </tr> </tbody>
</table>
Descargar Webmin: <br>
<br>
Todas las versiones por encima de "1.0" están recomendadas.
<a href="http://www.webmin.com/download.html">http://www.webmin.com/download.html
</a><br>
<br>
Para trabajar en diferentes plataformas usar el fichero "tar.gz"
conocido como <br>
"archivo tar/gzip de distribución" - "tar/gzip distribution
archive". <br>
<br>
Si hay una versión antigua de Webmin: <br>
<br><ul>
<li> se puede actualizar Webmin por medio de la interface
de webmin, <br>
después de finalizar y comprobarlo todo borrar el contenido del antiguo directorio.</li>
<li> para empezar desde el principio o desde cero: <br>
"parar webmin", borrar "/etc/webmin" y los directorios antiguos de Webmin, <br>
seguir entonces el procedimiento de instalación. </li>
</ul>
Si no está instalado Webmin seguir el "procedimiento de instalación" como "root": <br>
<br>
Si se va a usar SSL con Webmin hay que descargar e instalar:
<ul>
<ul>
<li> Biblioteca OpenSSL desde http://www.openssl.org
o del distribuidor del SO. </li>
</ul>
<ul>
<li>Módulo Perl Net::SSLeay Perl disponible desde
los archivos Perl CPAN<br>
<a href="http://search.cpan.org/search?query=Net::SSLeay&mode=all"> http://search.cpan.org/search?query=Net::SSLeay&mode=all </a> (usar el último) </li>
</ul>
</ul>
Instalar Webmin:
<ul>
<ul>
<li>poner el "archivo de distribución de Webmin"
en /usr/local y extraer el contenido. </li>
</ul>
<ul>
<li> ejecutar "cd [directorio-distribución-webmin]"
desde allí ejecutar "./setup.sh" </li>
</ul>
<ul>
<li> responder a las preguntas de instalación de
Webmin y seguir las instrucciones. </li>
</ul>
</ul>
Para más información y ejemplos ver: <a
href="http://www.webmin.com/download.html">http://www.webmin.com/download.html
</a><br>
<br>
<i>Para STTA anotar: - URL del servidor Webmin, puertos
y credenciales. </i><br>
<a name="stta"></a>
<table border="1" width="100%" cellpadding="2" cellspacing="2">
<tbody> <tr> <td bgcolor="#ffe0b0">
<h2>STTA</h2>
</td> </tr> </tbody>
</table>
Usar a partir de la versión 1.3 o superior y descargar desde:
<a href="http://www.eagora.info/stta"> http://www.eagora.info/stta
</a><br>
<br>
Para evitar problemas llegado este punto:
<ul>
<li> Software de Tarantella debe estar instalado pero
no necesariamente en ejecución. </li>
<li>Software LDAP software debe estar instalado pero no necesariamente
en ejecución. </li>
<li> Perl debe estar disponible en el entorno. </li>
<li> Perl LDAP debe estar instalado y comprobado. </li>
<li> Webmin debe estar en funcionamiento y ejecución.
</li>
</ul>
Desde la interface de Webmin instalar un nuevo módulo
<br>
usar el "archivo de distribución de STTA". <br>
<br>
Intentar conectarse al "módulo STTA" desde un browser
y seguir <br>
los procedimientos de configuración e instalación,
con información paso a paso. <br>
<hr>
<a name="howtoupdhelp"></a>
<table border="1" width="100%" cellpadding="2" cellspacing="2" bgcolor="#ba9e79">
<tbody> <tr> <td bgcolor="#ba9e79">
<h2><font color="#ffffff">¿ COMO ACTUALIZAR LA AYUDA DE STTA</font></h2>
</td> </tr> </tbody>
</table>
Descargar el archivo de distribuci�n de <a href="http://www.eagora.info/stta/downloads.html">http://www.eagora.info/stta/downloads.html </a><br>
<br>
Ir al directorio "stta" de Webmin (cd /usr/local/webmin*/stta)<br>
extraer el contenido del archivo de distribuci�n "tar.gz"<br><br>
Este proceso sobrescribe el contenido del directorio "help" de "stta"<br>
Si se dispone de algún servidor Web con la Ayuda de STTA esta debe actualizarse por el procedimiento para <b>Generar Web de Ayuda</b> de STTA<br>
<br>
<big> Esta actualización no altera el funcionamiento de STTA sólo cambia el contenido de la ayuda on-line. <br>
<br>
<hr>
</BODY></HTML>