Notes & Warnings

K2 v7.5 (2018-10-22 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-10-22)

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.]


KeyServer versions 7.5.0.3 and 7.5.0.4 installed on Windows as a 32-bit process can give incorrect report results and have other subtle problems (2018-10-22)

Running the 32-bit Windows version of KeyServer 7.5.0.3 or 7.5.0.4 can result in reports that show "Policy not found" and other incorrect or inaccurate information. The raw user data is not affected, so there is no loss of accurate data. To avoid this issue, upgrade to KeyServer version 7.5.0.5 or higher. Most modern computers are capable of running 64-bit OSs, so we recommend using the 64-bit KeyServer when possible. There is no need to convert data when upgrading from 32-bit to 64-bit executables; the same data can be used on all platforms regardless of OS type, “bitness”, or version.

KeyAccess versions prior to 7.5.0.5 might exhibit excessive CPU usage on Windows (2018-10-22)

Windows KeyAccess versions older than 7.5.0.5, in rare cases, will show high CPU usage after running without issue for some length of time. The chance of this happening is low, but is more likely on multi-user systems such as Windows Terminal Server when many sessions are connected, depending on usage patterns. To avoid this issue, especially important when KeyAccess is installed on WTS with heavy use, upgrade to KeyAccess version 7.5.0.5 or higher.

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

With KeyAccess version 7.5.0.0 or 7.5.0.1 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 7.5.0.3 or higher.

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

We strongly recommend that you upgrade to version 7.5.0.2 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 7.5.0.0 and 7.5.0.1 might fail to upgrade maps from earlier versions (2018-07-26)

If you upgraded from 7.x to 7.5.0.0 or 7.5.0.1, 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 7.5.0.2.

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.