		1


NCSA TELNET FOR THE SUN (TELTOOL)


version 1.1 - draft installation document (tk)
Copyright 1988 Board of Trustees of the University of 
Illinois
March 31, 1988


INSTALLATION


Step 1 - Tar File Extraction 

The distribution of NCSA Telnet for the Sun, which we will 
usually refer to as Teltool, comes in UNIX tar format.  When 
extracted from the tar file, it creates a directory tree with 
all of the Teltool source code and makefiles.  This directory 
tree starts inside the current directory.  To set up the 
Teltool program, first create a directory for the Teltool 
source code, then use tar to extract the files.

Extracting Teltool.tar from disk:

% mkdir MyTeltool
% cd MyTeltool
% tar -xvf /tmp/Teltool.tar
( produces lots of messages as files are extracted)

Extracting Teltool from tape:

% mkdir MyTeltool
% cd MyTeltool
% tar -xvbf 126 /dev/rst0
( produces lots of messages as files are extracted)



Subdirectories

You should find the following subdirectories in the tree:

Src		-- source code for Teltool
Doc		-- documentation, including installation documents 
and man page
Bin		-- utilities for Teltool, including configuration 
script
Fonts		-- Fonts for Teltool, including vt100 special 
font 
Icons		-- Icons which are used by Teltool
Defaults	-- defaultsedit master file 
Help		-- on-line help files


Step 2 - Configuration Information

The Teltool installation scripts will compile and install all 
of the programs and support files that you will need.  The 
first installation step is to set up the configuration 
information in the file Bin/Configure.  Edit this file with a 
standard editor and find the configuration section at the 
beginning of the file.  Edit each of the entries in the list 
so that they will produce your desired Teltool setup.  This 
section explains each of these configuration options for 
Teltool.

Defaultsedit will allow you to interactively change most of 
the configuration values that you specify here.  The initial 
configuration values are used as defaults only.

Directory defaults

You must establish which directories the teltool program will 
reside in and add their names to the Configure script.  The 
directories which you need are:

bindir	
Where the executable program is found.  This directory should 
be in the user's path.  Not modifiable with defaultsedit.

libdir	
Where support files and other subdirectories are found.  The 
directories "dumpdir", "helpdir" and the font directory are 
usually found in libdir.  Not modifiable with defaultsedit.

mandir	
Where the man pages for teltool should be placed.  Usually 
/usr/lib/man/manl.  Not modifiable with defaultsedit.


defdir	
Where the SunView defaults database should be placed.  If the 
user does not have a customized Teltool defaults file, then 
Teltool uses defaults from a file called Teltool.d in 
"defdir".  Not modifiable with defaultsedit.

dumpdir
Where core files are left.  When (that should be "if") 
Teltool crashes for any reason, the corefile is placed into 
"dumpdir".  Not modifiable with defaultsedit.

helpdir
Where the on-line help files are stored.  Teltool has an on-
line help menu which accesses text files when the user wants 
to view them.


Fonts

The bold and icon fonts for Teltool originated from the 
standard /usr/lib/fonts/fixedwidthfonts directory.  During 
installation, copies of those fonts are placed into the 
"libdir"/Fonts directory for your convenience.  The normal 
text font is usually screen.r.14 and is provided by SunView 
automatically.  Fontsedit can be used to modify these font 
files.

boldfont
The font to use for VT100 bold characters.  We suggest 
"libdir"/Fonts/screen.b.14, the standard 14 point bold roman 
characters.

iconfont
The font to use on icons.  The "closed" icon for Teltool 
contains the host name in small type.  We suggest 
"libdir"/Fonts/screen.r.7 to make the characters conveniently 
fit.

grphfont
The special VT100 graphics font.  We provide this font which 
contains all of the extended graphics characters required for 
VT100 emulation.  It is called vt100g.r.14.

Other Defaults

teluser
The Teltool super user.  This user gets mail whenever Teltool 
crashes.

defcapname
Where captured text should be stored or sent.  This is 
usually a file name which the "Capture Session" command uses 
to store the text of a session.

defpsout
Where PostScript output should be stored or sent.  This 
setting is used when the Tektronix emulator writes out an 
image in PostScript.  It may be a file name, or if it begins 
with a pipe symbol (|), a program which will process the 
output.  If you have the Transcript Laserwriter drivers, use 
"| lpr -Plw".

defhpout
Where HPGL (Hewlett-Packard Graphics Language) should be 
stored or sent.  This may be a file name, or if you have a 
plotter available, use "| lpr -Pplot".

deftekout
Where the Tektronix data stream should be stored or sent.  
When the "dump Tek" command is chosen, the data stream which 
created the original Tektronix drawing will be regenerated 
and stored here.

defbmout
Where a bitmap image should be stored or sent.  Teltool can 
generate a Sun bitmap format file from a Tektronix image.  If 
you have the Transcript software, the bitmap can be sent 
directly to the printer by setting defbmout to "| lpr -Plw -
v"

defscrollback
How many lines of scrollback should be kept for each session.  
Lines which scroll off of the top of the screen are saved in 
Teltool.  The scroll bars can be used to scroll back up to 
"defscrollback" lines.


Step 3 - Installation

The first installation step is to run the configuration file 
you have just edited.  Change directory back to the root of 
the Teltool subtree and do a make config.

% make config

The configuration script will run and ask you to confirm your 
choices.  Enter "ok" to start the configuration.  This stage 
of the configuration just updates Src/Main/Makefile and the 
Defaults/Teltool.d file.  Now you are ready to do the actual 
compile/install step.

Before doing the make install, you should check the 
following.  Make sure that the directories which are one 
above the target directories "libdir","bindir","defdir" and 
"helpdir" all exist.  If these directories are owned by root, 
you must log in as root (or su to root) before invoking the 
make.  If you own all of the needed directories, you don't 
need to be superuser to make install.  Make sure you have 2MB 
of disk space and 10 minutes to wait for the compilations to 
finish.

% cd MyTeltool
% make install
(10 minutes of messages and compilation results)

Your installation of Teltool should now be complete.  Make 
sure that the "bindir" is in your path and invoke Teltool 
from within suntools.  If you have installed the man page in 
the system man directory, then you can use the "man" command 
to read the user documentation.



