Support articles

Find clear, step-by-step solutions to common WithSecure issues across installation, configuration, updates, and product performance.

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