K95 2.1 UPGRADE

Kermit 95 2.1.0, 24 October 2002

This page last updated: Wed Nov 20 08:47:10 2002

[ WHAT'S NEW IN VERSION 2.1 ]

  If you do not have Kermit 95 already, CLICK HERE to visit the trial version download page.


SCOPE

This upgrade is for the Windows version of K95 only. We have not yet worked out an upgrade policy or procedure for the OS/2 version. When we have done, this paragraph will be changed to reflect it.


ELIGIBILITY

The K95 2.1 upgrade can be applied to:

  1. Any shrinkwrapped or other single-seat retail copy of Kermit 95 (except the PowerPC and Alpha versions, which have been discontinued);

  2. Any electronically delivered copy purchased from e-academy.com;

  3. Any Bulk Right-to-Copy or Academic Site license in its first year;

  4. Any Bulk or Academic Site license whose annual maintenance payments are current;

  5. Any lifetime academic site license.


DOWNLOADING THE UPGRADE

There are two kinds of upgrade installations: the non-cryptographic one, which can be downloaded to all countries, and the cryptographic version, which due to USA export law and according to its official Export Control Classification (5D002) and US Dept of Commerce Bureau of Industry and Security Export License Exception (ENC), can be downloaded to all countries except Cuba, Iran, Iraq, Libya, North Korea, Sudan, and Syria.

The cryptographic version of Kermit 95 includes SSH, Kerberos, SSL/TLS, and SRP for secure authentation and strong encryption. From a technical (not legal) standpoint, you can install either version, no matter what your current K95 version is or whether it has the security features.

THE CRYPTOGRAPHIC VERSION
IF YOU ARE IN ANY COUNTRY BESIDES CUBA, IRAN, IRAQ, LIBYA, NORTH KOREA, SUDAN, OR SYRIA, you may download the cryptographic version. CLICK HERE for export clearance and to access the upgrade.

THE NON-CRYPTOGRAPHIC VERSION
If you are in a country to which export of the cryptographic version is not allowed, or if you would rather have the non-cryptographic version than the cryptographic version, you may download the non-cryptographic version.

To Upgrade from C-Kermit 2.0 to 2.1 (smaller):
Via FTP: ftp://kermit.columbia.edu/kermit/k95/patches/k95_21_nocrypto_upg.exe
Via HTTP: http://www.columbia.edu/kermit/k95patch/k95_21_nocrypto_upg.exe
Via Kermit:   kermit://kermit.columbia.edu/kermit/k95/patches/k95_21_nocrypto_upg.exe

To Upgrade from C-Kermit 1.1 to 2.1 (larger):
Via FTP: ftp://kermit.columbia.edu/kermit/k95/patches/k95_21_nocrypto_fullupgr.exe
Via HTTP: http://www.columbia.edu/kermit/k95patch/k95_21_nocrypto_fullupg.exe
Via Kermit:   kermit://kermit.columbia.edu/kermit/k95/patches/k95_21_nocrypto_fullupgr.exe

HINT: Use K95 or C-Kermit as your Kermit or FTP client and you can resume interrupted downloads at the point of failure. The HTTP URL is in case no other method will get through your firewall.


INSTALLING THE UPGRADE

  1. You can apply the upgrade only if a previous version of Kermit 95 is installed on your PC. Your current version can be any version at all, 1.0 to 2.0 and it doesn't matter whether it includes security.

  2. If you have any Beta Test versions of K95 2.0 or 2.1 installed, you must remove them with Add/Remove Programs before installing the upgrade.

  3. Pick the appropriate upgrade package, depending on whether you are upgrading from version 2.0 or 1.1, and whether you want the cryptographic version. Note: If you are upgrading from 2.0, you must choose the upgrade package that matches what you currently have. E.g., if you have the cryptographic version, you must download the cryptographic 2.0-to-2.1 upgrade. If you are updating from 1.1, then you can choose either the cryptographic or the non-cryptographic 2.1 update.

  4. Click on the appropriate link to download.

  5. The file you downloaded is an executable program. Run it (e.g. with StartRun) to begin the installation.

  6. Answer the questions; detailed installation instructions are displayed for your convenience.

  7. If you were upgrading from 2.0 to 2.1, you're finished. The upgrade process has simply replaced the files that changed since 2.0.

  8. If you were upgrading from 1.1.xx to 2.1, you now you have a fresh K95 2.1 installation alongside your previous K95 version. At this point you should carefully migrate your data files from the old K95 directory to the new ones, as described in the next section.


MIGRATION INSTRUCTIONS

READ THIS if you are upgrading from K95 1.1.20 or earlier. If you are upgrading from version 1.1.21 or later, then you probably have already followed the migration procedure described below; if not, we recomment you do so now.

Because there have been twenty-some previous K95 releases, and because some installations have security features and some don't, and some have the new directory structure and some haved the old, and because each user may have customized the material in a different way, it is not possible for us to migrate the old version to the new one automatically with any hope of catching everything. So you'll have to do this yourself. This should be a one-time task that gets all K95 users into a configuration that allows future upgrades to be applied in a simple, consistent, and nondisruptive manner.

In the most common situations, your old Kermit 95 installation is confined to a single directory tree, typically rooted at C:\K95. In the new scheme, which is required to allow for multiuser installations as well as clean separation of (possibly read-only) program and (read/write) user data, the Kermit 95 files are scattered across several directories, just like other Windows applications. The exact structure depends on which version of Windows you have; it is described in detail in the README file. The arrangement in Windows XP (English-language version, new installations, not upgrades) would be:

C:\Program Files\Kermit 95 2.1\
The program executables, DLLs, documentation, icons, fonts. In K95 shorthand, this is called EXEDIR, and is represented by the \v(exedir) directory.

C:\Documents and Settings\All Users\Application Data\Kermit 95\
Kermit 95 directories and data files common to all users on a network or a multi-user PC. Kermit name: COMMON, variable: \v(common).

C:\Documents and Settings\username\Application Data\Kermit 95\
Each user's private Kermit 95 data files, one such tree for each user. Kermit name: APPDATA, variable: \v(appdata). This directory might be "hidden" on your PC, in which case you'll need to make it visible so you can open it. In Windows XP this is done in Control Panel → Folder Options → View: Select "Show hidden files and folders".

Use the Kermit variables names to refer to the appropriate directories on your PC. In Explorer, you can open a pair of windows; one on the old K95 directory, the other on the new one, and drag files from old to new.

Essentials

The two files that should always be moved from the old K95 top-level directory to your new \v(appdata) directory are:

K95CUSTOM.INI
Your Kermit 95 customization file.

DIALUSR.DAT
Your personal Dialer database entries and customizations.

HINT: to migrate these files at the K95 2.1 command prompt, do:

K-95> kcd appdata
K-95> copy c:/k95/k95custom.ini .
K-95> copy c:/k95/dialer.dat .

This assumes your old copy of Kermit 95 is in C:\K95. If not, substitute the appropriate path.

Most K95 users can stop right here. But don't remove your old Kermit 95 version for a while, just in case it turns out later you forgot something, or something went amiss in the upgrade installation that you might not notice until later.

Other Files and Directories

Other files and directories that might need attention include:

DIALORG.DAT
Your site-wide organizational Dialer database, if any. DIALORG.DAT, this should be moved to K95 2.1's \v(common) directory, for example (Windows XP):

C:\Documents and Settings\All Users\Application Data\Kermit 95\DIALORG.DAT\

The Host Mode Data Directories
If you use Host Mode, the host-mode data files and directories must be moved:

New Security-Related Directories
SSH, CERTS, and CRLS. This are new to K95 1.1.21. Site-wide keys, certificates, and revocation lists go in \v(common), user-specific ones go in \v(appdata).

Other Directories
The contents of your old Kermit 95 DOWNLOAD, KEYMAPS, PHONES, SCRIPTS, and TMP subdirectories, if any. These are now in \v(appdata).

PATH and Other Environment Variables

Kerberos Configuration

If you had a Kerberos setup with your previous Kermit version, it was outside the Kermit 95 directory tree, and will continue to work with K95 2.1.

Upgrading from K95 1.1.21

If you installed Kermit 95 1.1.21 with the InstallShield installer (as opposed to patching up to it from an earlier version), then after you have completed the previous steps, you must:

  1. Remove version 1.1.21 using Add/Remove Programs in the Control Panel.
  2. Run the 2.1 Upgrade Installer a second time and choose "Repair".

This restores the files from the COMMON directory that are deleted when version 1.1.21 is uninstalled.

Questions?

If you have questions, send them to kermit-support@columbia.edu.


K95 2.1 Upgrade / The Kermit Project / Columbia University / kermit@columbia.edu / 20 November 2002