/
How to migrate from a previous version to Password Depot Enterprise Server 19

How to migrate from a previous version to Password Depot Enterprise Server 19

Deutsche Version

Migrating from an older version of the Enterprise Server to version 19 is a straightforward process that can be normally completed within minutes. This guide provides detailed information on key considerations before and after upgrading, along with a step-by-step migration guide to help you migrate to our latest version.

  • Services: Ensure that all Password Depot services are stopped before installing the new version. Version 19 uses the same REST server port as all previous versions. Installing Password Depot Server 19 while other Password Depot servers are still running will cause a port conflict and prevent the PD_Service_19 from starting.

  • Client: It is not possible to connect to Password Depot 19 using a previous version. Please consider installing the Password Depot 19 Client on your computers.

Tip: You can set your Password Depot Server to read-only mode by opening the Password Depot Server Manager, navigating to Manage → Server Mirroring, and changing the server role to Mirror. This ensures that users cannot create new entries or make any modifications. The default setting is No mirroring.

  • Firewall: To ensure that the Password Depot Server is accessible within your intranet, make sure that the server port (25019 for version 19) is explicitly allowed in the firewall of the respective computer. Create inbound and outbound rules to allow TCP and UDP connections for port 25019.
    The same principle applies to the port number of the web client (if used).
    You can find more information to firewall rules here:
    https://service.portal.password-depot.de/servicedesk/customer/portal/8/article/203063323

  • Server certificate: Password Depot Server 19 automatically creates a self-signed certificate and installs it on the server. The certificate can be found at:
    C:\Program Files\AceBIT\Password Depot Server 19\CA
    We recommend installing this certificate on all computers using the Password Depot Client. Alternatively, you can add your own certificate in the Password Depot Server Manager under Manage → Server Certificates.
    You can find more information to certificates here:
    https://service.portal.password-depot.de/servicedesk/customer/portal/8/article/205094928
    https://service.portal.password-depot.de/servicedesk/customer/portal/8/article/215777312

  • Active Directory: If you are using the SSO authentication method, open the Server Manager and navigate to Manage → Server options → Active Directory. Ensure that the correct SSPI mode and SPN are selected.

  • Server Options: After migration, review your server options. Some settings, such as the origin URL, backup configurations, log settings, and keep-alive settings, are not transferred during migration and may need to be reconfigured manually.

  • Web Client: If you are using the web client, make sure to download the latest production-ready version from our GitHub repository and host it on your web server.

Step-by-Step guides for migrating to version 19

To proceed with the migration, please expand the right section below and follow the steps carefully to minimize the risk of potential errors.

1: Stop the service PD_Service_<Version>.
2: Download and install Password Depot Server 19 from below.
Password Depot Enterprise Server & Corporate Download
3: Stop the service PD_Service_19.
4: Navigate to the program directory of the previous version:
C:\Program Files\AceBIT\Password Depot Server <Version>
5: Copy the \Data folder.
6: Navigate to the program directory of Password Depot Server 19
C:\Program Files\AceBIT\Password Depot Server 19
7: Delete the current \Data folder.
8: Paste the Data folder copied in Step 5.
9: Start the PD_Service_19 service.
10 (optional): If you are using Active Directory (AD), perform a recursive scan after launching the Server Manager for the first time and update all pre-selected AD users (Server Manager → Extras → Active Directory Import). This process will take some time initially but will be significantly faster in future executions.

Ensure that all Password Depot services are stopped before installing the new version. Version 19 uses the same REST server port as all previous versions. Installing Password Depot Server 19 while other Password Depot servers are still running will cause a port conflict and prevent the PD_Service_19 from starting.

1: Stop the service PD_Service_<Version>.
2: Download and install Password Depot Server 19 from below:
Password Depot Enterprise Server & Corporate Download
3: Stop the service PD_Service_19.
4: Navigate to the program directory of the previous version:
C:\Program Files (x86)\AceBIT\AceBIT\Password Depot Server <Version>
5: Copy all Password Depot Databases from the directory \Data\DB:
C:\Program Files (x86)\AceBIT\Password Depot Server <Version>\Data\DB
6: Navigate to the program directory of Password Depot Server 19:
C:\Program Files\AceBIT\Password Depot Server 19
7: Paste all Password Depot Databases that you copied in step 5 to the \Data\DBdirectory of version 19:
C:\Program Files\AceBIT\Password Depot Server 19\Data\DB
8: Navigate to the program directory of the previous version:
C:\Program Files (x86)\AceBIT\Password Depot Server <Version>
9: Copy the file pwd_srv.cfg from the directory \Data:
C:\Program Files\AceBIT\Password Depot Server <Version>\Data
10: Navigate to the program directory of Password Depot Server 19:
C:\Program Files\AceBIT\Password Depot Server 19
11: Paste the file pwd_srv.cfg you copied in step 9 to the \Data directory of version 19:
C:\Program Files\AceBIT\Password Depot Server 19\Data
12: Start the PD_Service_19 service.
13: Log in to the Password Depot Server Manager 19 and check if everything was migrated successfully.
14 (important): If you are using Active Directory (AD), perform a recursive scan after launching the Server Manager for the first time and update all pre-selected AD users (Server Manager → Extras → Active Directory Import). This process will take some time initially but will be significantly faster in future executions.

Databases will automatically be converted from the .psw (or .psw7 etc.) format to the new .pswe format when used by the Enterprise Server. However, this affects databases using another file format than the *.pswe format.

The current server version 19 can automatically convert server installations from version 10.5 or higher. To migrate from versions older than 10.5, you must first migrate your data to version 11, as described below.

If you are already using version 11, start from step 14.

1: Stop the service PD_Service_<Version>.
2: Download and install Password Depot Server 11 from the link below:
https://www.password-depot.de/download/pwdsrv11.exe
3: Stop the service PD_Service_11.
4: Navigate to the program directory of the version from which you are migrating:
C:\Program Files (x86)\AceBIT\Password Depot Server <Version>
5: Copy all Password Depot Databases from the directory \Passwords:
C:\Program Files (x86)\AceBIT\Password Depot Server <Version>\Passwords
6: Navigate to the program directory of Password Depot Server 11:
C:\Program Files (x86)\AceBIT\Password Depot Server 11
7: Paste all Password Depot Databases that you copied in step 5 to the \Passwords directory of version 11:
C:\Program Files (x86)\AceBIT\Password Depot Server 11\Passwords
8: Navigate to the program directory of the version from which you are migrating:
C:\Program Files (x86)\AceBIT\Password Depot Server <Version>
9: Copy the file pwd_srv.cfg.
10: Navigate to the program directory of Password Depot Server 11:
C:\Program Files (x86)\AceBIT\Password Depot Server 11
11: Paste the file pwd_srv.cfg you copied in step 9.
12: Start the service PD_Service_11.
13: Login to the Password Depot Server Manager 11 and check if everything was migrated sucessfully.

Migration to Password Depot Server 19

14: Stop the service PD_Service_11.
15: Download and install Password Depot Server 19 from below:
Password Depot Enterprise Server & Corporate Download
16: Stop the service PD_Service_19.
17: Navigate to the program directory of Password Depot Server 11:
C:\Program Files (x86)\AceBIT\Password Depot Server 11
18: Copy all Password Depot Databases from the directory \Passwords:
C:\Program Files (x86)\AceBIT\Password Depot Server 11\Passwords
19: Navigate to the program directory of Password Depot Server 19:
C:\Program Files\AceBIT\Password Depot Server 19
20: Paste all Password Depot Databases that you copied in step 18 to the \Data\DB directory of version 19:
C:\Program Files\AceBIT\Password Depot Server 19\Data\DB
21: Navigate to the program directory of Password Depot Server 11:
C:\Program Files (x86)\AceBIT\Password Depot Server 11
22: Copy the file pwd_srv.cfg.
23: Navigate to the program directory of Password Depot Server 19:
C:\Program Files\AceBIT\Password Depot Server 19
24: Paste the file pwd_srv.cfg you copied in step 22 to the \Data directory of version 19:
C:\Program Files\AceBIT\Password Depot Server 19\Data
25: Start the PD_Service_19 service.
26: Log in to the Password Depot Server Manager 19 and check if everything was migrated successfully.
27 (important): If you are using Active Directory (AD), perform a recursive scan after launching the Server Manager for the first time and update all pre-selected AD users (Server Manager → Extras → Active Directory Import). This process will take some time initially but will be significantly faster in future executions.

Databases will automatically be converted from the .psw (or .psw7 etc.) format to the new .pswe format when used by the Enterprise Server. However, this affects databases using another file format than the *.pswe format.

The default port in version 19 is 25019. When updating clients to the new main version, you can select the option "Use settings from the previous version" in the installation wizard. If this option is enabled, the client settings from the previous main version will also be applied to the new version.

Therefore, please ensure that you update the port number accordingly, as each new main version uses a unique port number for connection.

Related articles