KSP v7.7 (2021-04-22 Image)
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:
KeyServer 18.104.22.168 - 22.214.171.124 can write incorrect user idle events (2021-04-22)
KeyServers in this range of versions can write idle events with an incorrect property which leads to Login reports showing too much Active time. To avoid this issue, upgrade to KeyServer version 126.96.36.199 or higher.
Cautions when upgrading from an earlier major version – i.e., 7.6 or earlier (2020-08-10)
Read the Major Upgrade documentation!
The Sassafras KeyServer Platform server 7.7 requires a new license certificate (server.lic) and new KeyConfigure. Before upgrading an older KeyServer version (7.6 or earlier) you must receive a new license certificate configured for 7.7 support -- a 7.6 or earlier certificate will not enable version 7.7.
The major version of KeyConfigure version and KeyServer version must match (e.g., first two digits must match). KeyConfigure 7.6 won't connect to KeyServer 7.7, KeyConfigure 7.7 won't connect to KeyServer 7.6.
Any KeyShadow installs must be discarded whenever the KeyServer process is upgraded. The KeyShadows must be recreated with a version 7.7 shadow certificate created by the version 7.7 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 you upgrade directly from KeyServer 7.4 (or older), and the KeyServer data is stored at a non-default location (for example on a non-system drive), the 7.7 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 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.7.x upgrades.