Best Practice Upgrading Policy Manager from Version 15.x to 16.x – Step-by-Step Guide

Issue:

Best Practice Upgrading Policy Manager from Version 15.x to 16.x – Step-by-Step Guide

Resolution:

This following guide provides step-by-step instructions on upgrading your F-Secure Policy Manager from version 15.x to version 16.x. Please ensure that you have backed up your system before proceeding with this upgrade.

1. Backup Your System:
   – Create a system backup. If you're running a virtual machine, create a snapshot.
   – At a minimum, ensure that you have a backup of the Policy Manager Server folder.

2. Stop the Policy Manager Server Services:
   – Open the command prompt.
   – Execute the command: net stop fsms

3. Copy the Following Content:
   – Copy the specified content from your existing installation:
     – `?:\Program Files (x86)\F-Secure\Management Server 5\data\events\`
     – `?:\Program Files (x86)\F-Secure\Management Server 5\data\guts2\`
     – `?:\Program Files (x86)\F-Secure\Management Server 5\data\h2db\`
     – `?:\Program Files (x86)\F-Secure\Management Server 5\data\fspms.jks`
     – `?:\Program Files (x86)\F-Secure\Management Server 5\data\fspms.db.config`
     – `?:\Program Files (x86)\F-Secure\Management Server 5\data\fspms.proxy.config`
     – `?:\Program Files (x86)\F-Secure\Management Server 5\data\fspms-ca.jks`
     – `?:\Program Files (x86)\F-Secure\Management Server 5\data\sdata`

4. Uninstall the Older Version:
   – Uninstall the previous version of Policy Manager (15.x).

5. Download and Install the Latest Version:
   – Download the latest version of Policy Manager (16.x) and install it on your machine.

6. Stop Policy Manager Server 16 Services:
   – Open the command prompt.
   – Execute the command: net stop wspms

7. Move/Paste Copied Content:
   – Paste the content you copied in step 3 to the following path:
     – `C:\ProgramData\WithSecure\NS\Policy Manager\Policy Manager Server\data\events\`
     – `C:\ProgramData\WithSecure\NS\Policy Manager\Policy Manager Server\data\guts2\`
     – `C:\ProgramData\WithSecure\NS\Policy Manager\Policy Manager Server\data\h2db\`
     – `C:\ProgramData\WithSecure\NS\Policy Manager\Policy Manager Server\data\fspms.jks`
     – `C:\ProgramData\WithSecure\NS\Policy Manager\Policy Manager Server\data\fspms.db.config`
     – `C:\ProgramData\WithSecure\NS\Policy Manager\Policy Manager Server\data\fspms.proxy.config`
     – `C:\ProgramData\WithSecure\NS\Policy Manager\Policy Manager Server\data\fspms-ca.jks`
     – `C:\ProgramData\WithSecure\NS\Policy Manager\Policy Manager Server\data\sdata`

8. Execute the Maintenance Tool:
   – Run the maintenance tool located at: `C:\Program Files\WithSecure\Policy Manager\Policy Manager Server\bin\fspms-db-maintenance-tool`

9. Check and Ensure Port Settings:
   – Verify that the HTTPS and HTTP ports are correctly defined in the registry and match the settings from the previous F-Secure installation.
   – For version 15.00 (and older), check the settings in the `?:\Program Files (x86)\F-Secure\Management Server 5\config.txt` file.
   – For version 16.00 (and newer), check the registry location: `HKEY_LOCAL_MACHINE\SOFTWARE\WithSecure\Policy Manager\Policy Manager Server\`

10. Restart Policy Manager Services:
    – Open the command prompt.
    – Execute the command: net start wspms

Note:
– Replace "?" with the source drive for your previous Policy Manager installation. If you're unsure where the old version is installed, check the following registry key: `HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Data Fellows\F-Secure\Management Server 5\InstallationDirectory`.
– For example: `E:\Program Files (x86)\F-Secure\Management Server 5` indicates the target source drive as E:.