Notes & Warnings

K2 v7.5 (2018-09-16 Image)  

(a yellow icon above, instead of green, indicates that this local document is not the latest -- the latest warnings are online)

Read this document for notes on bug fix or upgrade issues that warrant emphasis, explanation, or might otherwise be overlooked.

In addition to the specific warnings below, always consult the comprehensive list of all important bug fixes as documented in:

Component History (2018-09-16)

For information on the previous version, consult 7.4 Warnings & 7.4 History.

Partner Notes documents possible issues concerning any third party product which may have been purchased with pre-configured KeyServer control built in by the software publisher. [Note: the icon for a publisher supplied license certificate (.lic file) will appear in KeyConfigure's Licenses window with a green tint.]

KeyAccess versions and cause a compatibility problem with Microsoft Access and Internet Explorer (2018-08-08)

With KeyAccess version or installed, the first launch of either Microsoft Access or Internet Explorer will fail silently. Subsequent launches of the program will succeed. To avoid this compatibility issue, upgrade to KeyAccess version or higher.

KeyServer versions and can crash under normal operation (2018-07-26)

We strongly recommend that you upgrade to version or higher if you are running one of these earlier versions of KeyServer, even if you have not experienced any crashes yet.

KeyServer installers for versions and might fail to upgrade maps from earlier versions (2018-07-26)

If you upgraded from 7.x to or, and had set up any Availability Maps in 7.4, your maps might not have been transfered to the upgraded server. Contact Sassafras Software for help moving the necessary files into place on the new server. Part of the process will include upgrading your KeyServer to version

Cautions when upgrading from an earlier major version – i.e., 7.4 or earlier (2018-07-05)

Read the Major Upgrade documentation!

K2 7.5 requires a new license certificate (server.lic) and new KeyConfigure. Before upgrading an older KeyServer version (6.2, 7.0, 7.1, 7.2, 7.3, 7.4, etc) you must receive a new license certificate configured for 7.5 support -- a 7.4 or earlier certificate will not enable version 7.5.

The major version of KeyConfigure version and KeyServer version must match (e.g., first two digits must match). KeyConfigure 7.4 won't connect to KeyServer 7.5, KeyConfigure 7.5 won't connect to KeyServer 7.4.

Any KeyShadow installs must be discarded whenever the KeyServer process is upgraded. The KeyShadows must be recreated with a version 7.5 shadow certificate created by the version 7.5 KeyConfigure.

In cases where the Windows KeyServer is running in a Service Account, the Service Account must have a valid password that is reflected in properties of the KeyServer Service in the Service control panel. Furthermore, the Account must have full permissions on the KeyServer Data Folder in order for KeyServer and KeyReporter to properly run. Therefore, it is important to double-check permissions if your KeyServer is configured to run as anything other than the local service account.

On Windows, if your 7.4 (or older) KeyServer data is stored at a non-default location (for example on a non-system drive), the 7.5 Server installer will move the converted data to the default location in C:\Program Files\Sassafras K2\Server unless you select the “KeyServer Data Folder” item within the installer's “Sassafras K2 KeyServer Setup” dialog and browse to the existing Data Folder's Drive/Path during the install. This is necessary because the data folder is now a distinct entry in the installer. Choosing this option once will allow the data folder to remain at that location for any subsequent 7.5.x upgrades.

If your KeyServer is configured to Export databases, you should adjust the external tables as described in the New Fields section of the Tables documentation.

Minimum supported version of Mac OS X is 10.8 (2018-07-05)

K2 7.5 has several operational and UI improvements that require Mac OS X 10.8 and higher. Previous versions of K2 support Mac OS X 10.6 and higher, so if you have client computers with OS X 10.6 or 10.7, you should use KeyAccess 7.4.2 on those systems. The older client versions are compatible with the 7.5 server, although the newer functionality will obviously be missing for those clients.