Next
Previous
Contents
Solaris
Installing the Files
The current version of Tango 3.x for Solaris is Tango 3.62. There is not
expected to be any further updates to the 3.x codebase. The installation path
is designed for incremental upgrades, so is a bit tricky.
First, you'll need the
Tango 3.6 version.
This is a compressed tarball, and will untar itself into /var/opt/EDI/. You'll
need to be superuser to install this.
$su -
Password: ********
# uncompress tango36sol.tar.Z
# tar -xvf tango36sol.tar
Next, you'll need to grab the
Tango 3.62 patch file.
This too is a compressed tarball. This one will uncompress to whatever directory
it's in, so make a temp directory somewhere and use that.
$su -
Password: ********
# mkdir Tango362
# cp ./tangoSol362.tar.Z ./Tango362/
# cd Tango362
# uncompress tangoSol362.tar.Z
# tar -xvf tangoSol362.tar
What you'll wind up with are three binary files, a Readme.txt, and an 'odbc'
directory. Move the TangoNS_ep3.so to /var/opt/EDI/lib and the t3.cgi and tangod
files to /var/opt/EDI/bin. Finally, remove your /var/opt/EDI/odbc directory
and replace it with this one.
# mv./TangoNS_ep3.so /var/opt/EDI/lib/TangoNS_ep3.so
#mv ./t3.cgi /var/opt/EDI/bin/t3.cgi
#mv ./tangod /var/opt/EDI/bin/tangod
# rm -rf /var/opt/EDI/odbc
#mv ./odbc /var/opt/EDI/
Setting up the Tango user account
Next, you'll need to use your favourite method to create a user account
to run Tango. You can use the graphical 'admintool' program, or command line
programs such as 'adduser' or 'useradd' depending on your installation.
Generally, you'll want to call the account 'tango' and also perhaps make
a group called 'pvsw'. The user should be given ownership of everything in
the /var/opt/EDI directory tree. If deploying in a production environment,
especially on something outside of a firewall or the like, set the account
to have no password, no login capabilities.
Linux
There is no version of Tango 3.x for Linux. Had you going, though.
Solaris
Tango 2000 is shipped in the form of a Solaris Package Archive. You'll
need to login as root, and using either the 'admintool' graphical utility,
or run the pkgadd command. If you have a CD-ROM copy,mount the CD. The automounter
will generally mount it in /cdrom. Copy the /cdrom/tango_as-2000/tango2000/T2000Install.tar
file to a temporary directory. If you downloaded Tango 2000, it will be a compressed
tar file, and you'll need to uncompress it first. If it's already uncompressed,
skip the first step below.
# uncompress T2000Install.tar.Z
# tar -xvf T2000Install.tar
# cd T2000Install
# pkgadd -d. PVSWtango
and follow the prompts.
Warning: the shipping Tango 2000 installer sometimes rejects valid CD-keys
as being invalid. If this occurs, leave the CD-Key blank, and manually add
your key later (see section x.x).
Linux
Tango 2000 for Linux is distributed as an RPM. On a distribution CD, you'll
find the file in the tango2000 directory. Copy the appropriate file to a temp
directory; Tango2000-server-4-Linux_i386.rpm if you're using Red Hat 6, Caldera
2.2 or S.U.S.E 6.2 or later. Tango2000-server-4-RedHat52_i386.rpm if you're
using Red Hat 5.2. Either way, you'll need to be root.
Note that to use Red Hat 5.2, you'll need to manually upgrade your kernel
to version 2.2 or higher.
#rpm -Uvh Tango2000-server-4-Linux_i386.rpm
Solaris
Tango 2000 SP1 for Solaris is a Solaris Package Archive, designed to replace/update
the existing installation. It is, however, a full install, so if you don't
have Tango installed already, you'll get a working install. Otherwise, the
procedure to install is the same as Tango 2000, only the archive is T2000InstallSP1.tar.Z
You'll probably want to back up your t4client.ini and t4server.ini files,
as well as your web server configuration files.
Linux
Tango 2000 SP1 for Linux is an RPM designed to replace/update the existing
installation. It is, however, a full install, so if you don't have Tango installed
already, you'll get a working install. Otherwise, the procedure to install
is the same as Tango 2000, only the RPM is Tango2000-server-4.05.i386.rpm,
or Tango2000-server-4.05.RedHat52.i386.rpm if you're using Red Hat 5.2.
Tango uses a file called 't3server.ini' or 't4server.ini' to control many
of it's behaviors and functions. For Tango 3.x, this file is /var/opt/EDI/t3server.ini
and for Tango 2000, it's $TANGO_HOME/configuration/t4server.ini. You
can find a complete description of all entries in your Metatags and Configuration
Variables book, but the most important/commonly used ones are listed here.
Cache
Possible entries: TRUE, FALSE
This controls weather or not Tango caches TAF files. Caching will reduce
disk access, speeding up TAF execution.
CacheIncludeFiles
Possible entries: TRUE, FALSE
This controls weather or not Tango caches included files. Caching will
prevent repeated disk access, speeding up TAF execution.
CacheSize
Possible entries: Numeric, measured in bytes
This measures the size of the cache for TAFs and included files. If cache
grows to near this size, older documents will be flushed.
ConfigPasswd
Possible entries: text
This is the password of the config.taf online configuration application.
DataSourceLife
Possible entries: numeric, measured in minutes.
This controls how long an unused datasource connection will live. A setting
of 0 will cause a datasource connection to be closed as soon as it's query
is finished.
DebugMode
Possible entries: ForceOn, ForceOff, appFileSetting
This controls how the TAS handles placing debug information on the bottom
of each page created; always, never, or per file settings.
DSConfigFile
Possible entries: path to file
This points to the Data Source configuration file, which gives you some
finer control over how Tango uses data sources. See the Data Sources section
for more details.
ItemBufferSize
Possible entires: numeric, measured in bytes
This is the maximum size of any given field that can be returned in a database
action. It's main function is to prevent Tango from becoming bogged down while
downloading an unusually large piece of data from a database.
License
Possible entries: alphanumeric CD-Key
This is the Tango license. The CD-Key contains the licensing information
which tells Tango how to configure itself in terms of licenses and behavior.
ListenerPort
Possible entries: TCP/IP Port number
This tells Tango what port to monitor for incoming connections from the
Tango CGI or Plugins. Ports cannot be shared between server software, so multiple
servers running on one machine will need their own ports.
LoggingLevel
Possible entries: NoLogging, LogLevel1, LogLevel2, LogLevel3, LogLevel4
This controls how much logging Tango does. The log, "Tango.log", is written
to the location specified in the LOGDIR config variable. LogLevel 3 is the
best to use if you're trying to debug a Tango problem, but will slow Tango
down, and will eat disk space.
MaxActions
Possible entires: numeric, 0 for no limit
This controls how many actions Tango will allow in a TAF file. This guards
against things like infinite loops and overly large programs; most often used
in development environments.
MaxHeapSize
Possible entries: numeric, measured in bytes
This controls how much memory the Tango Daemon process will allow itself
to consume. Memory is consumed by variables, datasource connections, and cache.
If Tango exceeds this number, it will shut itself down with a 'process size
exceeded' message and attempt to restart itself normally. This number should
be changed to provide 20% more than what you record Tango as generally
using during peak use.
QueryTimeOut
Possible entries: numeric, measured in seconds
This controls how long Tango will wait for a response from a database call
before timing out. Note that not all databases and drivers support this functionality.
RequestQueueLimit
Possible entries: numeric
This controls how many requests from a CGI Tango will allow to 'queue'.
A very busy site can sometimes have so many CGIs stacked, waiting for Tango
to service them, that some will get lost and orphaned. This helps prevent that
situation.
ThreadPoolSize
Possible entries: numeric
This controls how many simultaneous threads Tango will run with. On Solaris,
it is generally better to have several Tango servers running a few threads
apiece than to have one Tango server running the same number of threads.
ValidHosts
Possible entries: TCP/IP addresses, colon delimited.
This is a list of what IP addresses Tango will allow incoming requests
from. On a machine where the web server and Tango server are both running,
this should be set to 127.0.0.1, the localhost.
Next
Previous
Contents
|