Overview

Preparation for migration

info

We recommend familiarizing yourself with the new features and data migration specifics in a test environment before updating your on-premises version. For testing, you can deploy Passwork 7 on a separate server — this will allow you to explore all the changes in the new version without affecting your current working environment.

Creating backup

danger

Attention

Before starting the migration, you need to create a backup of the MongoDB databases. Without a backup, data recovery in case of an incorrect migration completion will be impossible, and Passwork technical support will not be able to assist.

Examples of creating and restoring backups

We also recommend updating the MongoDB database before performing the migration if you are using versions 4.2 or 4.4 — Examples of MongoDB updates

Migration overview

Migration includes the following stages:

1. First migration stage:
   1. Update Passwork to version 6.5.x, which includes migration algorithms and a special page Migration to Passwork 7.
   2. Log in under the Owner account of Passwork, go to the Migration to Passwork 7 tab, and start the migration process.
   3. After that, a message about successful migration will be displayed. Then you need to log in to the Passwork Customer Portal and confirm the first stage in the “Update” section (bottom left corner).
2. Second migration stage:
   1. Update PHP to version 8.3, since starting from Passwork version 7, support for older PHP versions is not available.
   2. Update Passwork to version 7.
   3. Run the migration responsible for transferring, updating, and actualizing data of all objects from the legacy Passwork database.
3. Third migration stage (When using client-side encryption):
   1. The final migration stage re-encrypts data in password revisions for all vaults. Old revisions and password movements will not be available until the last stage is completed in the Passwork 7 web interface.

Migration

danger

Before starting the migration, you need to create a backup of the MongoDB databases. Without a backup, data recovery in case of an incorrect migration completion will be impossible, and Passwork technical support will not be able to assist.

Examples of creating and restoring backups

1.1 Updating Passwork to version 6.5

1.2 Initial data migration

1.3 Migration confirmation on Customer Portal

2.1 Updating PHP to 8.3

2.2 Updating Passwork to version 7

2.3 Migration of Passwork database objects

3.1 Data migration in Passwork web interface