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