187 lines
7.4 KiB
Plaintext
187 lines
7.4 KiB
Plaintext
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.
|
|
________________________________________________________________________
|
|
*****************************************************************************
|
|
|