# Services with Tarantella (STTA) - howto

How to prepare STTA installation: | HOW TO INSTALL STTA
How to update STTA help files: | HOW TO UPDATE STTA HELP FILES

# HOW TO INSTALL STTA ?

To install STTA (Services with Tarantella) Webmin module you will need to:

- To install or have Tarantella Software in the server.
- To install or have LDAP software in the server.
- To install or have Perl available under the server environment.
- To install or have Perl LDAP in the server.
- To install or have Webmin in the server.

As a quick and very basic guide these steps are describe below.
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.

## TARANTELLA

Follow Tarantella software installation notes.
Be sure that hostname and server resolutions works appropiately.
Basically you should run the ".shx" file for your platform as "root" and follow prompts and instructions.
For STTA take note of: - Tarantella installation dir
- Tarantella active ports

## LDAP

Follow Tarantella software installation notes.
Follow LDAP software installation notes.
If the choice is OpenLDAP use: http://www.openldap.org/software/download/
For secure results use the latest LDAP version available for your OS from your manufacture or OS distributor.
If the choice is not OpenLDAP you will need to use LDAP software procedure
to install and config LDAP servers and services following STTA & TTA needs.
For STTA take note of: - LDAP installation dir
- LDAP active ports and names. (if not OpenLDAP).

## PERL

Check Perl in your Operating System, if it is not available download from http://www.perl.org
For secure results use the latest PERL version available for your OS from your manufacture or OS distributor.
For Webmin & STTA take note of: - PERL path

## Perl LDAP

1) Perl-ldap uses the following modules/distributions:

Convert::ASN1 URI::ldap Digest::MD5 IO::Socket::SSL XML::Parser | required optional, needed for optional, needed for optional, needed for optional, needed for | URL parsing SASL CRAM-MD5 Net::LDAPS Net::LDAP::DSML

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
a given functionality. See the README file for a list. If you need to install one or several of these go to http://search.cpan.org
or if the server is connected to internet you can use Perl infraestructure to check dependencies and install modules as needed with:

$bash > perl -MCPAN -e shell cpan> install [nombre-del-módulo]

2) If the servers is connected to internet you can use Perl infraestructure to check dependencies and install module with:

$bash > perl -MCPAN -e shell cpan> install Net::LDAP

If PERL installed still does not have perl-ldap, downloaded from:
SourceForge: http://prdownloads.sourceforge.net/perl-ldap/perl-ldap-0.26.tar.gz?download
or from Perl CPAN http://search.cpan.org/CPAN/authors/id/G/GB/GBARR/perl-ldap-0.26.tar.gz
or any CPAN mirror available.
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,
that is

gunzip perl-ldap-*.**.tar.gz tar xvf perl-ldap-*.** cd perl-ldap-*.** perl Makefile.PL make make test make install

Several modules in the distribution contain documentation. Once installed you can use the 'perldoc Net::LDAP' command to obtain the documentation.
This documentation will contain pointers to the other modules.
Check INSTALL and README files for extended and full info.

## Webmin

Webmin download:
All versions above "1.0" are recommended. http://www.webmin.com/download.html
To work in different platforms use "tar.gz" file known as "tar/gzip distribution archive".
If there is any older Webmin version:

- you can do a Webmin upgrade by using webmin interface,
  after everything is done and fully checked remove older Webmin directory content.
- to start from the scratch:
  "stop webmin", remove "/etc/webmin" and older Webmin directories, then go to installation procedure.

If there is no Webmin installed follow "installation procedure" as "root":
If your plan to use SSL with Webmin you have to download and install:

- OpenSSL library form http://www.openssl.org or your OS distributor.

- Net::SSLeay Perl module available form CPAN Perl module archive
  http://search.cpan.org/search?query=Net::SSLeay&mode=all (get the latest)

Install Webmin:

- put "Webmin distribution archive file" in /usr/local and extract content.
- do "cd [webmin-distribution-directory]" from there do "./setup.sh"
- answer Webmin installation prompts and follow instructions.

For more info and examples see: http://www.webmin.com/download.html
For STTA take note of: - Webmin Server URL, ports and credentials.

## STTA

Start from version 1.3 or above and download from: http://www.eagora.info/stta
To avoid extra problems at this point:

- Tarantella Software should be installed but not necessarily running.
- LDAP software should be installed but not necessarily running.
- Perl should be availble under the environment.
- Perl LDAP should be installed and tested.
- Webmin should be up and running.

Form Webmin interface install a new module, use "STTA distribution archive file".
Try to connect to "STTA module" from your browser and follow configuration and installation procedure, you will find step-by-step info.

## HOW TO UPDATE STTA HELP FILES

Downloads distribution archive from http://www.eagora.info/stta/downloads.html
Go to Webmin "stta" directory (cd /usr/local/webmin*/stta)
extract archive distribution content "tar.gz"
This process overwrite stta "help" directory content
If you have STTA Help Web Servers you need to update their info by STTA procedure for Make a Help Web
This update does not alter STTA functions or features, only on-line help content is changed.