TN 6: Downgrading from 7.x to 6.2

Instructions for reversing a 6.x to 7.x upgrade

2011.11.03 (reviewed)

If you want to revert your 7.x KeyServer to the 6.x version you upgraded from, the procedure is relatively simple, though you will lose any data collected after the upgrade to 7.x. Clients that have been upgraded to 7.0 do not need to be reverted to 6.x. 7.0 clients are fully compatible with a 6.x KeyServer. For the other components, use the instructions that follow.

Reverting KeyServer

The 6.x formatted KeyServer data was backed up during the upgrade to 7.0. While there is no way to take configuration and Usage generated with KeyServer 7.0 and translate them back to 6.x, you can simply revert to using the archived 6.x data. Bear in mind that the longer the new 7.0 KeyServer has been running, the more usage (etc) data you will lose by the reversion.

Reverting is essentially a matter of renaming two directories. Note that the steps below are assuming the default location on C:. �If your KeyServer is installed in a different location on C: or on another drive entirely, substitute the path values accordingly. This is most important in step 7, where the 6.2 installer will, unless told otherwise, install at the default path instead of your custom path. �To avoid trouble with clients (including denials) be sure to select the newly reinstated 6.x "Server" folder, wherever it happens to be. Steps 4 and 7 are optional but recommended. If you do step 4, you must also do step 7.

  1. Stop the KeyServer Service
  2. Go into “Program Files” (or “Program Files x86”, for a 64 bit OS)
  3. Rename “Server” to “Server 7.4”
  4. Use the Programs and Features (Add / Remove) Control Panel to uninstall “Sassafras K2 KeyServer”.
  5. Rename “Server 6.2” to “Server”
  6. Move “Log Files” from “Server 7.4” to “Server”
  7. Run the appropriate 6.x installer again.
  8. Start the KeyServer Service

Reverting is essentially a matter of renaming two directories:

  1. Run “ksStartStop”, inside /Library/KeyServer
  2. Go into /Library
  3. Rename “KeyServer” to “KeyServer 7.4”
  4. Rename “6.2 KeyServer BACKUP” to “KeyServer”
  5. Move “Log Files” from “Server 7.4” to “Server”
  6. On 10.5 and earlier, delete:
    • /Library/Receipts/K2Server.pkg
    On 10.6 and later, delete:
    • /var/db/receipts/com.sassafras.pkg.K2Server.bom
    • /var/db/receipts/com.sassafras.pkg.K2Server.plist
  7. Run ksStartStop again

Reverting KeyConfigure

The KeyConfigure 7.4 installers also move aside the previous KeyConfigure. One option is to simply run the 6.x KeyConfigure from inside the renamed folder (e.g. “Admin 6.2”). Note however that on Windows, the shortcut in the Start Menu will point to the new 7.4 Admin, so you may want to take some steps to get the 6.x KeyConfigure back in the standard location.

On Windows:

  1. Use the Programs and Features (Add / Remove) Control Panel to uninstall “Sassafras K2 Admin”.
  2. Rename “Admin 6.2” to “Admin”
  3. Run the appropriate 6.x Admin installer again (optional but recommended)

On Mac:

  1. Go into /Applications/Sassafras K2/
  2. Delete “Admin”
  3. Rename “Admin 6.2” to “Admin”
  4. On 10.5 and earlier, delete:
    • /Library/Receipts/KeyConfigure.pkg
    • /Library/Receipts/ksODBC.pkg
    On 10.6 and later, delete:
    • /var/db/receipts/com.sassafras.pkg.KeyConfigure.bom
    • /var/db/receipts/com.sassafras.pkg.KeyConfigure.plist
    • /var/db/receipts/com.sassafras.pkg.ksODBC.bom
    • /var/db/receipts/com.sassafras.pkg.ksODBC.plist

Reverting KeyReporter

The KeyReporter installers do not maintain a copy of the older version. On either platform:

  1. Delete the “Report Modules” folder inside the “KeyReporter Data Folder”.
  2. Run the older KeyReporter installer

Reverting KeyShadows

Any KeyShadows which were upgraded to 7.4 should be torn down and recreated following the same steps as for a major upgrade:

  1. Stop the KeyShadow
  2. Delete the KeyServer Data Folder on the shadow computer, NOT on the main KeyServer computer
  3. Follow the instructions for a first time, "clean", install of KeyShadow.

Reverting KeyAccess

Clients that have been upgraded to 7.4 do not need to be reverted to 6.x. �7.4 clients are fully compatible with a 6.x KeyServer.