Installing / Converting Tame(R) 4x

Table of contents

1.  Brief summary of installation
2.  Installing the system
      2.1.  About the 'tameroot' directory
      2.2.  Placing the tame script in your cgi-bin
      2.3.  Running the browser install wizard
3.  Where to find documentaiton
4.  Where to get support
5.  Localhost domain key
6.  Accessing web utilities
7.  Special considerations for web servers
      7.1.  Apache
8.  A typical LINUX/UNIX/BSD install with Apache webserver


--------------------------------------------------------------------------------


1.  Brief summary of installation

  a) Unarchive the tar or zip file into the tameroot directory.
       gunzip tame4x.tar.gz
       tar -xvf tame4x.tar
  b) Copy tame to the cgi-bin and make sure it is executable.
  c) Browser access /install and follow wizard's instructions.

--------------------------------------------------------------------------------

2.  Installing the system

2.1.  About the "tameroot" directory

The tameroot directory is the root of the directory tree where tame
keeps all it's library and data files.

The tameroot directory is often named "tame" and, because sensitive
customer data and configuration information is stored there, the tameroot
should never be under the web document area.  It can be inside a user's
home directory, or in the server home directory, or virtually any other
relatively secure place other than in the web document tree.

...tameroot -+--- global (created during the untar/unzip process)
             |
             +--- mirror (created by web based install script)

Under the tameroot directory is a directory named "global".
Unarchive the package file into your tameroot directory.
This should create your global directory and fill it with the
global files.

Also under the tameroot will be created a mirror of the web document
structure called the tame mirror tree.  This directory is named
"mirror" in single domain systems and has the domain name in multiple
domain systems.  This directory will be created by the install wizard.
If you are reinstalling an update, take note of the name of your mirror
tree as the install wizard will be asking for it.


2.2.  Placing the tame script in your cgi-bin

Next, locate your cgi-bin or scripts directory and copy the tame binary to the
cgi-bin directory. On LINUX/UNIX/BSD systems the binary is the file named "tame".
On NT, the binary is named "tame.exe".  In SQL packages, additional SQL
binaries have names like tame_mysql, tame_odbc, etc.  Copy the binary you will
be using and rename it tame or tame.exe in the cgi-bin.

On LINUX/UNIX/BSD systems the executable bits may need to be turned on for the
binary file by typing "chmod ugo+x tame".  It is required to run the tame system
as a user other than "nobody".  The easiest way to do this is to make the tame
binary owned by the user you want to run it as and then turn on it's setuid
bit by typing "chmod 4755 tame".  Some web servers have alternate ways to
select the user for a cgi script.  Consult your server documentation.
For more on permissions, read the permissions.txt file in the distribution.


2.3.  Running the browser install wizard

Finally, run the browser install wizard by accessing the following URL with your
browser.  (Browser with table and java support required, Netscape recommended)

LINUXUNIX/BSD  http://yourdomain/cgi-bin/tame/install
WinNT          http://yourdomain/cgi-bin/tame.exe/install
WinNT IIS      http://yourdomain/scripts/tame.exe/install

If your server requires extra path elements to access scripts in your cgi-bin
then include them in the above url.

Follow the install wizard's instructions.

--------------------------------------------------------------------------------

3.  Where to find documentaiton

Online searchable documentation can be found at:

   http://www.tameable.com/4xDoc

Printable documentation can be found in the doc directory on the
distribution CD and at the download site.  Use Adobe Acrobat or another .pdf
file viewer to view the documentation.

--------------------------------------------------------------------------------

4.  Where to get support

For support contact:

  Scott Lopes
  slopes@virtualsellers.com
  1-877-FOR-TAME (1-877-367-8263)

--------------------------------------------------------------------------------

5.  Localhost domain key

A domain key is required to use the Tame(R) system.  The key is entered
during the browser install wizard steps and allows you to use the
system on that domain.  Tame(R) will not operate without a valid
domain key.

The 4x system requires a new domain key.  Keys made for the 3x and
earlier systems will not work with 4x systems.  You can request
a 30 or 60 day evaluation key for you domain by contacting
slopes@virtualsellers.com, calling 1-877-FOR-TAME (1-877-367-8263),
or from our website at:

   http://www.tameable.com/4xKeys

If you wish to evaluate the system as localhost or 127.0.0.1 you can
use the below key.  In order to use this key you must enter either
localhost or 127.0.0.1 in the domain entry during the install wizard.
Using the localhost key, you will only be able to browse Tame(R)
pages from the local machine.

EE-qfhhdjgkdehidlhedmhidfjeofjlnfklmglllllmlnldlplblcmpkgnojgokiorkhkrefcegfhm

--------------------------------------------------------------------------------

6.  Accessing web utilities

Tame(R) web utilities can be accessed at any tame'd domain with the url:

    http://yourdomain/cgi-bin/tame/global/util/index.txml

Accessing the utilites requires login with a tame user account.

--------------------------------------------------------------------------------

7.  Special considerations for web servers


7.1.  Apache

The Apache web server default installs with a pre-defined /icons alias to
a directory that is outide the normal web documents tree.  Tame(R) also
uses an /icons directory that is expected to be inside the web documents
tree.  Before Tame(R) can be installed, the Apache alias must be disabled.

  a) Edit the apache srm configuration file commonly located at
       /etc/httpd/apache/conf/srm.conf
       (some servers do not use srm.conf and use httpd.conf instead)
  b) Locate the line that reads
       Alias /icons/ /home/httpd/icons/
  c) Comment out this line so that it reads
       #Alias /icons/ /home/httpd/icons/
  d) Determine the PID of the httpd process (using ps x | more)
  e) Restart the httpd server using
       kill -HUP THE_PID

--------------------------------------------------------------------------------

8.  A typical LINUX/UNIX/BSD install with Apache webserver

  -- This install was performed on RedHat Linux 6.1.
  -- Commands or command arguments may change slightly
  -- depending on the system you are installing on.

  -- with the following typical file locations existing
/home/httpd/html                -- web document root (webroot)
/home/httpd/cgi-bin             -- cgi scripts directory (cgi-bin)
/etc/httpd/apache/conf/srm.conf -- apache srm config file

  -- the following directory is created when creating the tame user
/home/tame                      -- tame file root (tameroot)

  -- login as 'root'
groupadd www
useradd tame -p abc123 -g www
  -- (type a different password after -p instead of abc123)

cd /home/tame
  -- copy the TAME package file to this directory
cp /home/download/TAME-Linux.4.10.tar.gz .
  -- uncompress and untar the files
gunzip TAME-Linux.4.10.tar.gz
tar xvf TAME-Linux.4.10.tar
  -- set all the files to be owned by the tame user
chown -R tame:www *

  -- copy the cgi binary to the cgi-bin
cp tame /home/httpd/cgi-bin/tame
  -- or if mysql server is installed
cp tame_mysql /home/httpd/cgi-bin/tame

  -- make all the files owned by the tame user
cd /home/httpd
chown -R tame:www cgi-bin
chown -R tame:www html
chmod -R ug+rw html

  -- make the binary run as the tame user
cd /home/httpd/cgi-bin
chmod 4755 tame

  -- disable apache icon alias
cd /etc/httpd/apache/conf
vi srm.conf
  -- (or choose your own text editor)
  -- locate the line that reads
Alias /icons/ /home/httpd/icons/
  -- and comment it out to read
#Alias /icons/ /home/httpd/icons/
  -- save and exit vi with the keys :wq

  -- restart the httpd server
ps x | more
  -- find the PID of the httpd process, (for example 882)
kill -HUP 882
  -- (882 is an example, you must use the actual PID)

  -- run the browser install wizard with the URL
http://YOURDOMAIN/cgi-bin/tame/install

  -- enter for the tameroot
/home/tame
  -- proceed as directed by the install wizard
