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

Issue:

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