Services with Tarantella (STTA)  - howto 

*****************************************************************************
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 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   - required
	URI::ldap       - optional, needed for URL parsing
	Digest::MD5     - optional, needed for SASL CRAM-MD5 auth
	IO::Socket::SSL - optional, needed for Net::LDAPS
	XML::Parser     - optional, needed for 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 [module-name]

 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/downloads 

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

