Migrate Pleasant Password Server
If you want to transfer password entries to a new computer, you can use the migration process, or use a simple KeePass export and import.
The server migration process is to simply follow the Backup procedure on the old host and then restore the database on the new host.
The database stores all the data, which includes settings and audit logs. But be sure to save your encryption keys and database connection string.
Have Questions? Contact Us!
- The same license can be used, see Activating on a New Machine
Migration Options Summary
- Restore from Backup - use Automatic Backup & Restore
- Restore from an original database (manual file copy) - Manual Backup & Manual Restore
Enterprise Edition or higher
You can use these basic steps to migrate:
- Download and Install the same PPASS version on the new machine: Finding Historic Versions
- Stop the service / site. Note: Stop IISExpress.exe task if necessary.
- If you are Hosting with IIS, also disable the service.
- Backup your current production machine: Settings > Database Backups
- Copy the Backup file to a fileshare visible on the new server.
- Save the Backup Encryption key to a secure location.
- Stop the current service / IIS site.
- This step will cause an outage (the current server will be unavailable to the users), until we re-start on the new server.
- Set the Database Connection on the new server (using Service Config utility):
- Copy the connection string and database type from the current server
- Note: If this is an external database on another server, you can skip the restore step (next step) and just restart.
- Restore the Database onto the new server:
- Login onto the web application on the new server (with: "admin" / "admin")
- Click "Restore Database", enter the Backup Encryption key, and click Restore. The application will notify when the process is complete.
- Once the Restore is complete, restart the new service / IIS site.
Use the same steps as above, using the Manual Backup & Manual Restore process.
All Related Links:
- Backup / Restore
- What's included in the database? (etc.)
- Finding Historic Versions
- Install steps / Upgrade steps / Server Requirements
- Activation info - Troubleshooting
- Database Switch / Database Migration
- Disaster Recovery / Recovery Options
- Best Practices / Server Hardening
Please follow these Troubleshooting steps.
Complete File Migration
You may also wish to thoroughly save all related file information and/or copy them to the new machine. Especially if any custom install configurations have been made.
Steps: First copy all file / information from the old installation to the new machine, and then install over-top.
The above steps can also be followed in the case of Data Recovery. See additional Data Recovery Options.
If you are upgrading the Server OS (i.e. from Microsoft Server 2008 to 2012) and afterwards your users are having trouble logging in:
Reactivate License Key on License Tab
- This is only necessary to refresh the license status, or if license details have be cleared out.