INSTALL-WEB.TXT:  TclPro 1.2

Copyright (c) 1998-1999 by Scriptics Corporation
All rights reserved
-------------------

Contents
========
    1. Introduction
    2. Upgrading to the Latest TclPro Version
    3. Installing TclPro or Scriptics License Server on UNIX
    4. Using Shared Network Licenses on Windows
    5. Target Directory for TclPro Installation
    6. TclPro Components
    7. Running TclPro Tools
    8. Installing Adobe Acrobat Reader
    9. Contact Info

1. Introduction
===============

This file describes how to install TclPro on the supported platforms:

  Operating System	Architecture	Version
  ----------------      ------------    -------
  Irix			SGI (Mips)	6.2+
  HP-UX			HP (PARISC)	10.20+
  Linux			Intel		Red Hat 5.0+ or SuSE 5.3+ *
  Solaris		Sun (Sparc)	2.5+
  Windows		Intel		95/98/NT 4.0+

* We believe that TclPro will work with other Linux distributions,
such as Caldera Linux, that use glibc2.

After installing, consult the README file in the install target
directory for more information about running TclPro.


2. Upgrading to the Latest TclPro Version
=========================================

This version of TclPro includes a major rework of the TclPro Debugger
user preferences and projects.  Because of these changes, the
preferences and projects from previous TclPro Debugger versions cannot
be brought over to the new release.

If you are upgrading from a prior version of TclPro (1.1 or earlier),
we recommend that you install and use the new version before
uninstalling the prior version.  After installing this release, please
see the sections on Licensing and Upgrading in the README file of your
new installation for information on how to gracefully uninstall prior
versions of TclPro.

If you are upgrading from an alpha or beta version of TclPro 1.2, we
recommend the following before installing this release: on Windows you
should uninstall the prior version before installing the final 1.2
release; on Unix, you should remove the TclPro Debugger preference
files that match ~/.TclPro/1.2/* from your filesystem.  If you
previously installed Scriptics License Server, please see the sections
on Licensing and Upgrading in the README file of your new installation
for information on how to gracefully uninstall prior versions of
TclPro.


3. Installing TclPro or Scriptics License Server on UNIX
========================================================

TclPro is available on the Scriptics Web site as a compressed tar
file.  After you download the file, uncompress the file, then untar it
to create the tclpro<version> directory.  To run the installer, run
the shell script:

	tclpro<version>/setup.sh

The installation program begins by asking you whether you are using a
Named User License or a Shared Network License.  Your choice depends
on which type of TclPro license you selected when you downloaded.  See
the Licenses section in the README file for more details about the new
Shared Network License option.

If at any time you need to move any of the files or folders containing
files in the TclPro or Scriptics License Server installation to a new
location, you should uninstall by removing files (see the README file
for details) and reinstall using the install program.

3a. Installing TclPro for a Named User
--------------------------------------

This installation of TclPro is for you if either one of the following
applies to you:

    1) you are using a Named User License
    2) you have a TCP/IP connection to a machine running Scriptics
       License Server, but you can't access the site installation of
       TclPro from your machine.

Please see the "Target Directory" and "TclPro Components" sections for
guidance in choosing which files to install and where to install them.

At the end of the installation, the installer will invoke the License
Manager to allow you to enter your Named User License key (or the
location of Scriptics License Server) that you are using.

Your license key was mailed to the email address you specified when
you registered to download TclPro.

If you need to change your TclPro license key (or the location of the
Scriptics License Server) at any time after installation, you can run
the License Manager program.  For example,

	prolicense

3b. Installing Scriptics License Server
---------------------------------------

Installation of Scriptics License Server is only necessary for people
using the Shared Network License.

Complete installation of Scriptics License Server requires that you
run the installer as root on one of the supported Unix platforms
(listed in the "Introduction" section).  For security purposes, you
will also be asked to enter a User ID and Group ID, so the server will
not actually run as root.  You will then need to specify a port for
communication between the server and TclPro tools.

Following the port, you will be asked to enter a destination directory
and a log directory.  Because log information can grow large over
time, many administrators like the log files to exist on separate
disks from an installation.  The installer will create the following
files:

	<destinationDir>/prolserver
	<destinationDir>/prolserver.conf
	<destinationDir>/prolserver.pid
	<destinationDir>/prolserver.state
	<destinationDir>/INSTALL.LOG
	<logDir>/prolserver.<port>.log

The "<destinationDir>/prolserver.conf" file contains information you
entered during the installation process as well as the license key you
entered via the Web interface to Scriptics License Server.

The "<logDir>/prolserver.<port>.log" file contains all information
regarding usage of TclPro tools.

After installation, you may choose to have the installer launch the
server program, "prolserver", for you.  Note that "prolserver" will
run as the userId you entered during installation, not as root.  Once
you have launched the server, you must enter user information and a
license key via your Web browser at:

	http://<hostname>:<port>

If you are running Scriptics License Server on the machine
"mars.mycompany.com" at the port 2577, your URL should look like the
following:

	http://mars.mycompany.com:2577

At this Web location, you can setup your server and then enter the
Shared Network License key.  The key was mailed to the email address
you specified when you registered to download TclPro.  This Web
location has pointers to more documentation on this subject.

3c. Installing TclPro for Shared Network License Users
------------------------------------------------------

TclPro installation for Shared Network License Users is useful only
for people using Shared Network Licenses.  Please see the "Target
Directory" and "TclPro Components" sections for guidance in choosing
which files to install and where to install them.

At the end of the installation, the installer will ask you to enter
the location (host machine and port number) of your Scriptics License
Server.  If you need to change these values at any time after
installation, you can run the License Manager program with the -admin
flag.  For example,

	prolicense -admin

After setting the location of your Scriptics License Server, no
further setup is required. Tools in this TclPro installation will
automatically access Scriptics License Server running at the
location you specified.

4. Using Shared Network Licenses on Windows
===========================================

Although Scriptics License Server must be installed on Unix, Windows
users can choose to use Shared Network Licenses.  All that is required
is a TCP/IP connection to a Unix machine on which the Scriptics
License Server is running.  Scriptics License Server can run on any of
our supported Unix platforms listed in the "Introduction" section.
You can run the TclPro License Manager (part of the TclPro
installation) to specify the location of the Scriptics License Server.


5. Target Directory for TclPro Installation
===========================================

The installation program allows you to specify an absolute pathname to
the directory where TclPro will be installed.  TclPro creates several
files and directories in the target directory.  It is best to install
each TclPro version in its own directory, for example:

         /opt/scriptics/TclPro1.0
         /opt/scriptics/TclPro1.2

You must also have permission to install to the directory that you
select.  For example, the default destination directory
"/opt/scriptics/TclPro<version>" is normally restricted to the root
user.  If you choose to install to this path, you will need to do so
from the root account.  If you do not have root access to your
machine, ask your system administrator to help you with the
installation, or install the product into a directory where you have
write permission (e.g. your user account).

6. TclPro Components
====================

The installation program allows you to choose among the following
components:

	Basic
	C Development Libraries

Basic installation includes everything you need to run the TclPro
tools, including documentation, demos, libraries (for Tcl, Tk, and
incorporated extensions), and the tools themselves.

The "C Development Libraries" option is only necessary if you are
building a custom Tcl or Tk interpreter, or if you wish to use TclPro
Wrapper to wrap a custom application or an application that requires
any unsupported extensions.  The "C Development Libraries" component
offers libraries and header files needed to build a custom Tcl or Tk
interpreter.  See the README file for details about supported
extensions.

7. Running TclPro Tools
=======================

Please see the README file for details on how to set your PATH
environment variable and run the TclPro tools that you've just
installed.

8. Installing Adobe Acrobat Reader
==================================

The TclPro User's Guide uses PDF format, readable by Adobe Acrobat
Reader 3.0+.  If you do not have Acrobat Reader, or if you have a
version prior to Adobe Acrobat Reader 3.0, you can download it for
free from the Scriptics Web site:

	http://www.scriptics.com/support/acrobat.html

9. Contact Info
===============

If you have any questions or comments, please contact:

    sales@scriptics.com

	   or

    support@scriptics.com

Thank you very much for working with Scriptics and TclPro!

Sincerely,
The Scriptics Team

2593 Coast Ave.
Mountain View,  CA 94043
Phone: 650-210-0100
URL: http://www.scriptics.com/
