300 lines
13 KiB
HTML
300 lines
13 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
|
<html>
|
|
<head>
|
|
<META http-equiv="refresh" CONTENT="0; URL=http://www.eagora.info/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>
|