Sitemap

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!

Licensing: 

Migration Options Summary

Migration Steps

Enterprise Edition or higher

You can use these basic steps to migrate:

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. Once the Restore is complete, restart the new service / IIS site.

Community Edition

Use the same steps as above, using the Manual Backup & Manual Restore process.

 

All Related Links:

Problems?

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.

Data Recovery

The above steps can also be followed in the case of Data Recovery. See additional Data Recovery Options.

Troubleshooting

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.