Subject: TIA Install & License

      INSTALLATION INSTRUCTIONS FOR THE SINGLE USER VERSION
                  OF THE INTERNET ADAPTER (tm)
                     Revision 1.0.2 (9/20/94)

PLEASE NOTE: Changes are being made weekly to this document as we
receive feedback from the hundreds of new TIA users. 
The latest version of this document is available via email at:

     tia-install-single@marketplace.com.

You should also request and (please!) read the latest TIA Single User FAQ at:

     tia-FAQ-single@marketplace.com. 

If you are using a Macintosh please also read:

     tia-mac-setup@marketplace.com

If you are using a PC running MS Windows please also read:

     tia-win-setup@marketplace.com

All documents are also available by gopher or World Wide Web at:

     marketplace.com

It is strongly suggested you read these documents *in their entirety* 
before you begin installing TIA (as many problems are avoided that
way...)

OVERVIEW

The Internet Adapter (TIA) is a commercial Internet access utility 
that runs on the UNIX computer that hosts your Internet login or 
"shell" account. TIA  does _not_ run on your Macintosh or PC. Your 
Macintosh, PC, or other "client" computer must be setup with the 
software required to use a standard SLIP Internet account (see partial 
instructions at the end of this document).

Since TIA is a binary executable program (i.e. not a script) you must 
run the version that corresponds to the hardware and operating system 
of your UNIX host computer. TIA is currently available for:

Hardware    Operating System 
-----------------------------
Sun Sparc   Solaris 2.x
Sun Sparc   SunOS 4.1.x
386/486     BSDI 1.x
386/486     SCO              beta
386/486     LINUX            beta
DEC Alpha   OSF/1 2.0        beta
DEC         ULTRIX 4.3       beta
IBM RS/6000 AIX 3.2          beta
SGI         IRIX 4.0         beta
HP 9000     HPUX 9.0         beta


STEP 1. CONFIRM THAT THE TIA LICENSE CODE FILE IS PROPERLY INSTALLED

Make sure you have the TIA License Code file properly installed in 
your home directory. These instructions assume you have already 
ordered and received your TIA Evaluation or Registered License Code 
via email. The TIA License Code message containing the actual TIA 
License Code (e.g., TIACODE:6589384766aF30) should have been saved in 
a file called '.tia'.

The .tia file needs to be in the CURRENT directory when you run TIA. 
We recommend you keep the TIA program and the ".tia" file in your home 
directory, i.e. the directory you are automatically taken to when you 
login to your account, and that you start TIA from that directory. To 
confirm the .tia file is there type the following command in your home 
directory:

ls -a

To view the contents of the .tia file type the following command:

more .tia (or cat .tia)

We recommend that you make 2 backup copies of your .tia file. Store 
one in another file (e.g., .tia.backup) and one as a text file on your 
Macintosh or PC.


STEP 2. DETERMINE WHICH BINARY VERSION OF TIA YOU NEED TO RUN

All the TIA binary versions are available via anonymous FTP from 
MarketPlace.com. You need to determine which binary is the correct one 
for your account. If you don't know that already, download the Free 
Software Foundation's (the GNU folks) "config.guess" script from 
Marketplace.com via anonymous FTP and run that on your machine. It 
should tell you what you need to know. If you are not familiar with 
FTP here is what you need to type (each line is a separate step -- 
lines in brackets [] must be replaced with your input, and all 
parentheticals are remarks): 

ftp marketplace.com
[type 'anonymous' when prompted for your login name]
[type your complete email address when prompted for your password]
cd tia
ascii (makes sure your ftp is transferring in ASCII mode)
get config.guess
bye
chmod u+x config.guess
./config.guess

The screen readout will tell you the type of machine and operating 
system you are on.

***NOTE: You may also see if the 'uname' command is supported on your 
host and gives you the information you need. Type: 'uname -a' and see 
what info it provides you. It may or may not tell you enough info.

You may also check on Marketplace.com where we will be creating a 
table of popular sites and binary types.

If you cannot find this information you may also use the "brute force" 
approach: download all the different binary versions of TIA from 
MarketPlace.com and try them until you find one that runs correctly on 
your host computer! (Each binary is approximately 200K.)


STEP 3. DOWNLOAD THE CORRECT VERSION OF TIA FROM MARKETPLACE.COM

Once you know the correct binary you need, connect to marketplace.com 
via FTP and cd to the 'tia' directory. (cd to the 'tiabeta' directory if
the platform you have is listed as 'beta' in the table above.) 
Each version of tia has a descriptive name such as:

     sparc.sunos.tia, sparc.solaris.tia, 386.bsdi1.1.tia, etc.

If there is a binary version of TIA for your host, download that 
version using File Transfer Protocol (FTP) from MarketPlace.com. 
Example steps:

ftp marketplace.com
[type 'anonymous' when prompted for your login name]
[type your complete email address when prompted for your password]
cd tia
binary (makes sure your ftp program is in BINARY transfer mode)
get <tia.pgm.name> (where <tia.pgm.name> is the file name
     corresponding to the binary for your host computer)

(You may also want to check the READ.ME files in this directory for 
any late breaking news, installation notes, or pending ports)

***NOTE: If there is *not* a version of TIA for your host, pleased 
request one by sending an email message to tia-ports@marketplace.com. 
Include the details of your platform and the type of license you would 
like. We will be adding new ports for TIA based on customer demand and 
will notify you via email when your requested port is ready.


STEP 4. ENSURE TIA IS RUNNING PROPERLY

Once the .tia file is in place and the appropriate TIA binary is 
copied to your account type the name of the tia file to run it.

For convenience you will want to rename the file to 'tia'. For example:

mv 386.bsdi1.1.tia  tia

Then make sure TIA has execution permission:

chmod u+x tia

To run TIA type the name of the program. For example:

./tia     (the './' tells UNIX to look in this directory)

For the remainder of these instructions we will refer to the TIA 
binary as just plain 'tia' or TIA.

When TIA is working properly it prints a copyright notice and a brief 
message. For example:

     The Internet Adapter (tm) 1.0 for BSDI Unix
     Copyright (c) 1994 Cyberspace Development, Inc.
     Single License

     Ready to start your SLIP software.

***NOTE: You can ingore any warning messages concerning a library 
revision. For example: "ld.so: warning: /usr/lib/libc.so.1.8 has older 
revision than expected"

If you see the "Ready to start your SLIP software" message above, TIA  
is installed properly and you are ready to proceed to the next step. 
If not, see the Troubleshooting section below.

***NOTE: To exit TIA type five control-C's (control Key + 'C' key) in 
succession, allowing at least two seconds between the first and last 
one. This will cause TIA to exit normally and return you to the UNIX 
prompt. (This is a nice benefit as it means users can connect 
normally, use their SLIP and TCP/IP applications through TIA, but quit 
TIA and then have access to their standard shell account to do things 
for which they don't have a TCP/IP application.)

Here is a short troubleshooting guide to the error messages you may 
receive if TIA is _not_ running properly: 

* If you get the message "Permission Denied" type the following command:

chmod u+x tia

This will give the tia program execution permission. Try it again.

* If you are unable to set the execution permission it may be because 
you have downloaded a binary that is incompatible with your host 
computer (e.g., attempting to run a 386 binary on a SPARC machine).

* If you get a message saying "command not found" it means your path 
probably doesn't include your home directory. You can either add your 
home directory to your PATH or always run TIA by typing:

./tia   (tells UNIX to look for program in the current directory)

* If you run TIA and get no response you probably don't have the 
correct binary version for your host computer.

* If there is a problem with the evaluation time period, finding the 
.tia file, the contents of the .tia file, the login name, the domain 
name, etc. TIA will provide you with a short problem description. 
Follow the instructions in the problem message.

***NOTE: A TIA Single User Evaluation License is valid for 14 days 
from date of issue. To check this, TIA needs to be able to confirm the 
current date with an Internet time server. If the site where you are 
running TIA does not have access to an Internet time server, the 
Evaluation License will not work.

* If you receive an error message concerning the login name or domain 
name when trying to run TIA please check to make sure the spelling of 
the items listed in your .tia file matches those of your host 
environment EXACTLY. Any discrepancies will result in an unusable 
License Code.

If you find a misspelling and this is an Evaluation License Code, 
simply reapply for a new Evaluation License Code using the correct 
spelling.

If you find a misspelling and this is a Registered (i.e. paid) License 
Code, please e-mail a copy of the complete text of your .tia file together 
with an explanation of the misspelled items to:

     tia-support@marketplace.com.

***NOTE: After your Single User Evaluation License expires, you can 
resubmit the same order form you used for it to purchase a Registered 
License. Just change the ORDER TYPE and supply the necessary credit 
card information.

----------------------------------------------------------------------
It is very important not to proceed to any of the following steps 
until TIA is working properly. It is much easier to debug one thing at 
a time!
----------------------------------------------------------------------

STEP 5. SETUP YOUR PC OR MAC SLIP AND TCP/IP SOFTWARE TO USE TIA

SLIP and TCP/IP Software settings:

* To use your account running TIA as a SLIP account you must login to 
your account either manually or under script control using a SLIP 
communications software package and issue the "tia" command as the
final command or script item. Then tell the SLIP software to "connect".
To use your account as a standard shell account just login as you always
have using any serial communications software.

SLIP communications software is available for all popular platforms as 
freeware, shareware, and commercial software. Examples include: 
Trumpet Winsock for PC/Windows, Intercon InterSLIP for Macintosh, 
Synergy's VersaTerm SLIP for Macintosh, NetManage's Chameleon suite 
for PC, Spry's AIR series, etc. For more information on SLIP and 
TCP/IP tools for the "client" (PC) side be sure to check the TIA 
Gopher Brochure and TIA World Wide Web Brochure on MarketPlace.com. 
(gopher marketplace.com or lynx http://marketplace.com)

* With TIA you do not have, or need, your own IP address. Since most 
SLIP and TCP/IP software requires you to enter one, use the dummy IP 
address of 192.0.2.1 (this is reserved for test networks and never 
assigned). The "NetMask" should be 255.255.255.0 (also known as a 
"Class C" address).

***NOTE: TIA itself may be able to help you with the following setup
questions. (This may not work on all platforms or configurations.) Type:

tia -address

and TIA will print out information on the IP addresses and domain 
names of both the Gateway and Nameservers for this host.

* The "Gateway" parameter should be set to the name and/or IP address 
of the computer hosting your login account. 

* You will also need a "Nameserver" name and/or IP address. This may 
be the same as the "Gateway" IP address or it may be a separate domain 
name and IP address. Use tia -address, check with your Internet Access 
Provider, or ask the System Administrator at your site.

* IMPORTANT: Make sure the "Compressed SLIP" or "CSLIP" flag is turned 
OFF in your SLIP software.

* IMPORTANT: The parameter called "MTU Size" or "IP MTU Size" should 
be set to a value equal to or greater than 1,000. We recommend using 
the largest setting which should be 1,500.


STEP 6. SETUP THE TCP/IP APPLICATION SOFTWARE

These applications will be setup the same as if you had a standard 
SLIP account. They do not need to be setup any differently for TIA. 
For your benefit we have included a few notes to help you get started.

WORLD WIDE WEB CLIENTS (e.g., Cello, Mosaic, etc.) - should not 
require any special setup

EMAIL (e.g., Eudora) - the "SMTP Server" field should (in most cases) 
be set to the domain name of the computer hosting your account. The 
"POP Account" field should be the same as your full email address.

NEWS - you will need to enter a news server domain.name
(e.g. news-1.provider.com)

GOPHER - should not require any special setup

FTP - should not require any special setup

TELNET - should not require any special setup

For more info on SLIP and TCP/IP Software and Applications to use with 
TIA send a blank email message to tia-tcpip-info@marketplace.com.


WHAT TIA DOES NOT SUPPORT

TIA does not enable you to provide any routing specific services back 
to the Internet. For example: you cannot operate a world wide web 
server on your PC and have folks connect to that server from the 
Internet while connected via TIA. (To operate gopher and W3 servers 
you must have a standard SLIP connection at least.)

TIA does not support "Ping" and other TCP/IP clients that require the 
use of the ICMP protocol. (It does support 'finger'.)

TIA 1.0 does not support PPP today - but it will in the near future.

For more detailed information on what TIA is, and what it is not, 
please request the TIA Single User FAQ as explained at the start of 
this document.


IMPORTANT NOTES

ABOUT LOGIN ACCOUNTS THAT INCLUDE A MENU: TIA must be run directly 
from the UNIX prompt. If your Internet access provider offers a menu 
that comes up automatically when you login, you will need to either 
ask your provider to switch you to a standard shell account or
add commands to your SLIP login script that take you to
the menu choice for "shell" or "system prompt".

ABOUT DOMAIN NAMES: If you have a custom domain name like 
person@widgets.com that is mapped to a a shell account on an Internet 
access provider like person@csn.org; you will need to use the Internet 
access provider's domain name when you order your TIA License Code.

ABOUT TIME-OUTS: In order to make the best use of limited resources 
most Internet Access Providers include a "time out" on every shell 
account. The result is that if an account is idle (no typing or data 
transfer) for a certain amount of time that account is automatically 
logged out. This applys to TIA as well since it is running on your 
account. To reconnect after a time out just login again manually or 
re-run your SLIP connect script. You do not need to restart any of the 
TCP/IP applications that were up at the time of the time-out.


WHAT ABOUT SUPPORT?

Due to the low price, high volume, and worldwide sales, Cyberspace 
Development regrets that it cannot include free technical support with 
TIA Single Licenses. (TIA Host and Site Licenses do, by the way.) 
However we will make any and all bug fixes available for free to all 
TIA customers via FTP from Marketplace.com (using 1 email broadcast to 
all TIA customers about each major update).

If you purchased TIA, have read these instructions carefully, and 
cannot get TIA to run on your account, please first check the Single 
User FAQ file mentioned at the start of this document -- we are adding 
answers to new questions daily!

If after checking the FAQ you believe you have a legitimate problem 
with TIA itself (NOT with the SLIP, TCP/IP, or TCP/IP applications on 
your PC or Mac, etc.) you may send a detailed description of your 
problem, a complete transcript of what TIA prints out when you attempt
to run it, and the complete contents of your .tia file to:

     tia-support@marketplace.com       (for Registered Licenses)
or
     tia-eval-support@marketplace.com  (for Evaluation Licenses)
or
     tia-beta-support@marketplace.com  (for any TIA Beta Software)

Please note that preference will be given to technical support 
questions from our Registered and Beta Customers.

How to Get an Eval Extension

If your Evaluation license code expires before you have been able to
fully evaluate any version of TIA, we can extend it for you. Just send a
copy of your Order Form to:

        tia-order-desk@marketplace.com

IMPORTANT: Please make the Subject line: "Eval Extension for [your name]",
and include in the COMMENTS section at the end the reason you are requesting
the extension.

We'll send you a new license code by the next business day at the latest, so
make sure to send in your request at least a day or two before your current
eval code expires.

If you need any help related to your eval or registered license code or 
your TIA purchase please send a detailed explanation to:

     tia-order-desk@marketplace.com

If you have any comments, feedback, or suggestions related to TIA or 
Marketplace.com, please send them via email to:

     tia-feedback@marketplace.com

Thank you for using TIA - we appreciate your business.


(Note: the TIA Single User License agreement below is the same one you 
agreed to prior to obtaining your Evaluation or Registered License. It 
is provided here for your records.)

            TIA SINGLE USER SOFTWARE LICENSE AGREEMENT

PLEASE NOTE: ORDERING TIA INDICATES YOU HAVE READ THE LICENSE 
AGREEMENT AND AGREED TO ITS TERMS.

1.  The Internet Adapter ("TIA") is licensed (not sold) to you.

2.  Cyberspace Development, Inc. grants you a nonexclusive license to 
use TIA and its license code ("Code") on a single computer.  Only one 
person may use this copy at a time.

3.  You may not: (1) rent, lease or sublicense all or any portion of 
the TIA or the Code; (2) modify or prepare derivative works of TIA or 
the Code; (3) reverse engineer, decompile or disassemble TIA or the 
Code; or (4) generate unauthorized license codes.  You agree to keep 
confidential and use your best efforts to prevent and protect the 
contents of TIA and the Code from unauthorized disclosure or use.

     Limited Software Product Warranty

4. This warranty does not cover damage caused by improper use or 
neglect.  We do not warrant the contents of TIA or that it will be 
error free.  TIA is furnished "AS IS" and without warranty as to the 
performance or results you may obtain by using TIA.  The entire risk 
as to the results and performance of TIA is assumed by you.

     Disclaimer of Warranty And Limitation of Remedies

5.  You are responsible for installation, management and operation of 
TIA.

6.  THE WARRANTIES IN THIS AGREEMENT REPLACE ALL OTHER WARRANTIES, 
EXPRESS OR IMPLIED, INCLUDING ANY WARRANTIES OF MERCHANTABILITY OR 
FITNESS FOR A PARTICULAR PURPOSE.  WE DISCLAIM AND EXCLUDE ALL OTHER 
WARRANTIES.  IN NO EVENT WILL OUR LIABILITY OF ANY KIND INCLUDE ANY 
SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS, 
EVEN IF WE HAVE KNOWLEDGE OF THE POTENTIAL LOSS OR DAMAGE.

7.  Our entire liability and your exclusive remedies for our liability 
of any kind (including liability for negligence except liability for 
personal injury caused solely by our negligence) for TIA covered by 
this Agreement and all other performance or nonperformance by us under 
or related to this Agreement are limited to the remedies specified by 
this Agreement.

8.  Some states do not allow the exclusion of implied warranties, so 
the above exclusion may not apply to you.  This warranty gives you 
specific legal rights, and you may also have other rights which vary 
from state to state.

Copyright (c) 1994 Cyberspace Development, Inc. and InterMind Corp.
