K95 2.1.3 UPGRADE

[ WHAT'S NEW IN VERSION 2.1.3 ]

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

---

SCOPE

---

ELIGIBILITY

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.

You must have a copy of a previous version of Kermit 95 installed on your hard disk. If you don't, you can't apply the free upgrade. If you have removed your old version but still have the original media, reinstall it so the upgrade will find it. If you have lost your original media or can't use it for some reason, then please purchase a new copy of Kermit 95; due to the economic meltdown, we no longer have the staff to handle individual problems of this nature.

---

DOWNLOADING THE UPGRADE

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 K95 2.0 or 2.1 to 2.1.3 (smaller):

Via FTP:	ftp://kermit.columbia.edu/kermit/k95/patches/k95_213_nocrypto_upg.exe
Via HTTP:	http://www.columbia.edu/kermit/k95patch/k95_213_nocrypto_upg.exe

To Upgrade from K95 1.1 to 2.1.3 (larger):

Via FTP:	ftp://kermit.columbia.edu/kermit/k95/patches/k95_213_nocrypto_fullupg.exe
Via HTTP:	http://www.columbia.edu/kermit/k95patch/k95_213_nocrypto_fullupg.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 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 Start→Run) to begin the installation.

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

7. If you were upgrading from 2.0 or later to 2.1.3, you're finished. The upgrade process has simply replaced the files that changed since your previous version.

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.

If the upgrade process failed, which can happen under certain circumstances (for example, because you moved files to where the uninstaller couldn't find them, or file or directory permissions don't allow removing the files, or the installer database has otherwise lost touch with reality), you might need to manually uninstall your old version first. This would be a last resort. First visit the InstallShield site for hints. If that doesn't help, contact us first to make sure manual removal is necessary. Instructions for manual removal are HERE.

---

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

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

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:

• The USERS subdirectory directory should be moved to \v(common). Example (Windows XP): C:\K95\USERS should become:

  C:\Documents and Settings\All Users\Application Data\Kermit 95\USERS\

• The PUBLIC subdirectory should also be moved to \v(common).

• The SCRIPTS directory is now in \v(common), and contains updated Host Mode scripts. If you have made any changes to the host mode scripts in your own installation, you might need to apply them to the new ones (you shouldn't just copy over your old ones because they won't work any more due to the new directory structure).

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

• If you had defined your Windows PATH to include the K95 executable directory, you'll need to change your PATH definition. (Check the PATH definition in a command window by typing "path" or at the K-95> prompt by typing "echo \$(PATH)").

• If you had defined any Windows environment variables whose values indicate K95 directories or file specificiations, such as "K95.INI", these should be adjusted to reflect the new location.

Kerberos Configuration

Upgrading from K95 1.1.21

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?