<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<META http-equiv="refresh" CONTENT="0; URL=http://alhambra/cgi-local/stta?howto.html">
<title>STTA howto</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<meta name="description" content="STTA Is a tool to admin Services around Tarantella, built as a Webmin module allows full synchronization among different technologies: LDAP, Web-Server,Tarantella, etc. STTA is GPL, it can be downloaded here."/>
<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">Services with Tarantella (STTA) - howto <font></h1>
</td></tr>
<tr><td bgcolor="#ffe0b0"><table> <tbody>
<tr><td> How to prepare STTA installation:</td><td> <a href="#howtoinstall"><b> HOW TO INSTALL STTA</b></a> </td></tr>
<tr><td> How to update STTA help files:</td><td> <a href="#howtoupdhelp"><b> HOW TO UPDATE STTA HELP FILES</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">
<h1><font color="#ffffff">HOW TO INSTALL STTA ?</font></h1>
</td> </tr></tbody>
</table>
To install <a href="#stta" name="STTA"> STTA (Services with
Tarantella)</a> Webmin module you will need to:<br>
<ul>
<li>To install or have <a href="#tarantella" name="Tarantella">Tarantella
Software</a> in the server. </li>
<li>To install or have <a href="#ldap" name="ldap"> LDAP software</a>
in the server. </li>
<li>To install or have <a href="#perl" name="Perl"> Perl</a> available
under the server environment. </li>
<li>To install or have <a href="#perl-ldap" name="Perl Ldap"> Perl
LDAP</a> in the server. </li>
<li>To install or have <a href="#webmin" name="Webmin"> Webmin </a>in
the server.</li>
</ul>
As a quick and very basic guide these steps are describe below.<br>
In some cases you will need to fully read item specific
docs. In others you can jump to the next if you already have it.<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>
Follow Tarantella software installation notes.<br>
<br>
Be sure that hostname and server resolutions works appropiately.<br>
Basically you should run the ".shx" file for your platform
as "root" and follow prompts and instructions.<br>
<br>
<i> For STTA take note of: - Tarantella installation dir<br>
- Tarantella active ports</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>
Follow Tarantella software installation notes.<br>
Follow LDAP software installation notes.<br>
If the choice is OpenLDAP use: <a
href="http://www.openldap.org/software/download/"
name="http://www.openldap.org/software/download/">http://www.openldap.org/software/download/</a><br>
<br>
For secure results use the latest LDAP version available for
your OS from your manufacture or OS distributor.<br>
<br>
If the choice is not OpenLDAP you will need to use LDAP software
procedure<br>
to install and config LDAP servers and services following STTA &
TTA needs.<br>
<br>
<i> For STTA take note of: - LDAP installation dir<br>
- LDAP active ports and names. (if not 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>
Check Perl in your Operating System, if it is not available
download from <a href="http://www.perl.org%20"
name="http://www.perl.org ">http://www.perl.org </a><br>
<br>
For secure results use the latest PERL version available for
your OS from your manufacture or OS distributor.<br>
<i><br>
For Webmin & STTA take note of: - 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 uses the following modules/distributions:<br>
<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">required<br>
optional, needed for<br>
optional, needed for<br>
optional, needed for<br>
optional, needed for<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>
To use the basics of perl-ldap there is only one dependancy,
Convert::ASN1, all others are optional depending on if you want to use<br>
a given functionality. See the README file for a list.
If you need to install one or several of these go to<a
href="%20http://search.cpan.org" name=" http://search.cpan.org"> http://search.cpan.org</a><br>
or if the server is connected to internet you can use Perl infraestructure
to check dependencies and install modules as needed with:<br>
<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>[nombre-del-módulo]</b><br>
</td> </tr> </tbody>
</table>
<br>
<b>2)</b> If the servers is connected to internet you can
use Perl infraestructure to check dependencies and install module with:<br>
<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>
If PERL installed still does not have perl-ldap, downloaded from:<br>
<br>
SourceForge: <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<br>
</a> or from Perl CPAN <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>
or any CPAN mirror available. <br>
<br>
If you are on a system where you can run the Makefile.PL and use make,
then the package can be installed using the normal MakeMaker process,<br>
that is<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>
</td> </tr> </tbody>
</table>
<br>
Several modules in the distribution contain documentation. Once installed
you can use the '<i>perldoc</i> <b>Net::LDAP</b>' command to obtain the documentation.<br>
This documentation will contain pointers to the other modules.<br>
<br>
Check INSTALL and README files for extended and full info.<br>
<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>
Webmin download: <br>
<br>
All versions above "1.0" are recommended.<a
href="http://www.webmin.com/download.html"> http://www.webmin.com/download.html
</a><br>
To work in different platforms use "tar.gz" file known as "tar/gzip
distribution archive". <br>
<br>
If there is any older Webmin version:
<ul>
<li>you can do a Webmin upgrade by using webmin interface,<br>
after everything is done and fully checked remove older Webmin directory
content.</li>
<li>to start from the scratch:<br>
"stop webmin", remove "/etc/webmin" and older Webmin directories, then
go to installation procedure.</li>
</ul>
If there is no Webmin installed follow "installation procedure" as
"root": <br>
<br>
If your plan to use SSL with Webmin you
have to download and install:<br>
<ul>
<ul>
<li>OpenSSL library form http://www.openssl.org or your OS distributor.</li>
</ul>
<ul>
<li>Net::SSLeay Perl module available form CPAN Perl module archive<br>
http://search.cpan.org/search?query=Net::SSLeay&mode=all (get
the latest)</li>
</ul>
</ul>
Install Webmin:<br>
<ul>
<li>put "Webmin distribution archive file" in /usr/local and extract content.</li>
<li>do "cd [webmin-distribution-directory]" from there do "./setup.sh" </li>
<li>answer Webmin installation prompts and follow instructions.</li>
</ul>
For more info and examples see: <a href="http://www.webmin.com/download.html">http://www.webmin.com/download.html</a><br>
<i> <br>
For STTA take note of: - Webmin Server URL, ports and credentials.
</i><br>
<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>
<br>
Start from version 1.3 or above and download from: <a
href="http://www.eagora.info/stta"> http://www.eagora.info/stta</a><br>
<br>
To avoid extra problems at this point:<br>
<ul>
<li>Tarantella Software should be installed but not necessarily running.</li>
<li>LDAP software should be installed but not necessarily running.</li>
<li>Perl should be availble under the environment.</li>
<li>Perl LDAP should be installed and tested.</li>
<li>Webmin should be up and running.</li>
</ul>
Form Webmin interface install a new module, use "STTA distribution
archive file".<br>
<br>
Try to connect to "STTA module" from your browser and follow
configuration and installation procedure, you will find step-by-step info.<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">HOW TO UPDATE STTA HELP FILES</font></h2>
</td> </tr> </tbody>
</table>
Downloads distribution archive from <a href="http://www.eagora.info/stta/downloads.html">http://www.eagora.info/stta/downloads.html </a><br>
<br>
Go to Webmin "stta" directory (cd /usr/local/webmin*/stta)<br>
extract archive distribution content "tar.gz"<br><br>
This process overwrite stta "help" directory content<br>
If you have STTA Help Web Servers you need to update their info by STTA procedure for <b>Make a Help Web</b><br>
<br>
<big> This update does not alter STTA functions or features, only on-line help content is changed. <br>
<br>
<hr>
<br>
</body>
</html>