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.guessThe 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(where 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:
chmod u+x tia
This will give the tia program execution permission. Try it again.
./tia (tells UNIX to look for program in the current directory)
***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.
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:
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)
***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.
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.
Limited Software Product Warranty
Disclaimer of Warranty And Limitation of Remedies
Return to TIA FAQ Pointers