tn3270 Installer Documentation

by Scott McGuire (smcguire@mit.edu)
December 4, 1997


This document covers revision 1.0 of the installer.

Table of Contents

Packages

Guide To Files Table

What the Installer Does


Packages

There are four packages that the user can install.

Easy Install:

Installs tn3270 2.5b5, tn3270 documentation, extra configuration options, Read Me, connection files configured for encrypted connections to MITVMA and MITVMC, KClient (Kerberos 4), and the Kerberos Telnet Plugin.

Custom Install:

* "KClient" package - installs the KClient (Kerberos 4) files.

* "tn3270 2.5b5" package - installs the tn3270 app and support files, connection files, and the Kerberos Telnet Plugin.

* "Kerberos Telnet Plugin" package - installs just the Kerberos Telnet Plugin.

[In theory there should be a "Kerberos 5" package which installs the Kerberos 5 files (GSSLib, CNSConfig, etc.). However the Kerberos 5 package has been deleted, even though placeholder files are still in the installer - there's no way for the user to install them.]

The "Easy Install" and "tn3270" packages are set to "restart after installing" to force the installer to quit any other programs that are running, and the installer is set to "Force Restart" so that a restart is required when it's done installing.

Guide to Files Table

File

Install to:

Packages

Replace

Before installing

After installing

Gestalts

Move Action Item:
KClient
(from Extensions to Trash)
(moves all matching items)

---

Easy Install, KClient

Move Action Item:
KClient
(from Control Panels to Trash if currently installed version isn't 1.7.6)
(moves all matching items)

---

Easy Install, KClient

Move Action Item:
KClient
(from Extensions (disabled) to Trash)
(moves all matching items)

---

Easy Install, KClient

Move Action Item:
Kerberos Client
(from Extensions to Trash)
(moves all matching items)

---

Easy Install, KClient

Move Action Item:
Kerberos Client
(from Extensions (disabled) to Trash)
(moves all matching items)

---

Easy Install, KClient

KClient

Control Panels

Easy Install, KClient

if Newer

ftp

Rename action item:
Kerberos Client Preferences
(to Kerberos Client Preferences.bak)

---

Easy Install, KClient

Kerberos Client Preferences

Preferences

Easy Install,KClient

Always

ftp

GSSLib

Extensions

none

if Newer

ftp

krb5.ini

Preferences

none

if Newer

ftp

Move Action Item:
GSSLibrarySAP
(from Extensions to Trash)

---

none

Move Action Item:
K5Logout
(from anywhere to Trash)

---

none

Kerberos Utilities (folder)

Install Folder

none

CNS Config-SAP

Kerberos Utilities

none

if Newer

ftp

K5Logout

Kerberos Utilities

none

if Newer

ftp

Alias Action Item:
K5Destroy

ShutDown Items

none

System 7.5 or Greater

tn3270 Folder(folder)

Install Folder

Easy Install, tn3270

tn3270

Install Folder

Easy Install, tn3270

if Newer

ftp

tn3270 Readme

Install Folder

Easy Install, tn3270

if Newer

ftp

MITVMA

Install Folder

Easy Install, tn3270

if Newer

ftp

MITVMC

Install Folder

Easy Install, tn3270

if Newer

ftp

tn3270 Documentation (folder)

Install Folder

Easy Install, tn3270

[all files in the "tn3270 Documentation" folder]

Install Folder

Easy Install, tn3270

if Newer

ftp

tn3270 Customizations (folder)

Install Folder

Easy Install, tn3270

[all files in the "tn3270 Customizations " folder]

Install Folder

Easy Install, tn3270

if Newer

ftp

tn3270 Additions (folder)

Install Folder

Easy Install, tn3270

[all files in the "tn3270 Additions" folder]

Install Folder

Easy Install, tn3270

if Newer

ftp

Put in Extensions (folder)

---

Easy Install, tn3270, Kerberos Telnet Plugin

Kerberos Telnet plugin

Extensions

Easy Install, tn3270, Kerberos Telnet Plugin

if Newer

ftp

What the Installer Does

(1) For info about the KClient and Kerberos 5 files, see the Kerberos Installer Docs - no changes to behavior have been made here. KClient is part of the Easy Install.

(2) The files in the "tn3270 Folder" folder are installed on the volume specified by the user. There are no special cases or unusual circumstances.

(2a) WARNING: There are fonts in the "tn3270 Customizations" folder. VISE, by default, marks font files with "Restart After Installing" even if the font files aren't going into the System Folder. These should be unchecked to avoid unnecessary reboots. (This could probably be regarded as a VISE bug.)

(3) Put in Extensions folder - this folder itself is not installed (it's marked as a placeholder). The Kerberos Telnet Plugin inside it is installed to the Extensions folder. (This file can also go in the same folder as the Telnet app, but if we put it here NSCA Telnet can share it too.)

(4) For the final build of the installer, we edited the STR# resource ID 1000, item #26 to be "tn3270 Installer Log File".

All files are set to execute the FTP code resource after they're installed, since only aliases are in the installer binary.

Also see the tn3270 Installer Version History for details about the changes the Telnet installer has gone through.