Sitemap

Updating Software

Discover how Pleasant Password Server will enhance KeePass for business

We recommend keeping updated with security software upgrades, which can be downloaded from the website. Currently, for added safety precautions, the software will not auto-update itself.

Upgrades and Support are included in your subscription plan (renewed annually). Select to install a software version which was created before your License Expiry date.

Often customers may wish to also: 

Have Questions?  Contact Us 

Versions 7.3.5 and earlier:

Related Topics:

Step 1: Confirm your Maintenance Subscription

  • Determine your subscription's Expiry Date, and if your subscription is expired, renew it before you continue to the steps below. Either:
    • Click Check License Status button on License Status page to confirm expiry date
    • Enter your License Key on this page and click Upgrade/Renew

Step 2: Make a backup

Note: There is no way to restore a previous version without a backup.
  • Take a VM snapshot, if you wish
  • Check before proceeding:
    • Backup was successfully completed:
      • Open Event Logging | Logged Events - check that the backup file was created successfully
    • Encryption keys are saved. These are needed for Backup/Restore functionality, or opening encrypted SQLite databases.
      1. Backup encryption key
      2. SQLite: Regular encryption key (from the Connection String in your Service Config utility)
    • Decide if you want to manually save additional files / folders. Reference: Items included in the Database Backup

Step 3: Restart the Machine (Optional)

  • You may wish to restart the machine, so that any file locks are released, or OS updates are resolved first before beginning.
  • You may also wish to uninstall, if there were any problems installing. This will still retain the database and connection information.

Step 4: Download and Run the Installer

  • If you are running versions 7.3.5 or earlier: Update an Earlier Version
  • If you are running versions 7.3.7 or later, install these directly:
  • Latest  or Stable version

    • Latest Version contains the newest features and fixes. Some of these features may still be undergoing additional Quality Assurance (not recommended for large enterprise production implementations).

Step 5: Monitor Install Progress

  • There are 2 parts the install:

  • 1. INSTALL FILES - once the files are replaced, you will see:
    • Installation completed successfully

  • 2. DATABASE CONVERSION - at site/service startup, the database is the converted to the new version, you will see website is running
    • During the install updates will be applied to the database, and there may be some database conversion steps. Depending on the number of releases between version updates, there may be quite a number of changes.

      Please be patient, as the service may take some time to restart while processing the upgrade changes. This time will vary depending on the number of releases between the version updates or the amount of records to update.
    • Monitoring progress:
      • You can view in the default SQLite database folder: you may notice a journal.db file, and that the database will grow to the size of the database file while changes are being made. This will continue until all changes are committed together at once. If this process is interrupted, all changes are rolled back.
    • Startup delays:
      • We would recommend waiting for awhile and monitoring progress,
      • If there has been years since the last update, you may wish to download and install intermediate upgrades (with one or two Stable Versions found in Historic Versions),
      • Otherwise, see the troubleshooting steps below.
  • Troubleshooting:

Step 6: Re-apply custom config settings

  • If you have changed advanced custom settings, e.g. Switched Databases, Moved to IIS Hosting, or Applied Custom Config File changes which are not managed in the install/upgrade, re-apply those custom settings now.

    • IIS HOSTING - stop and disable the service
    • CHANGED DATABASE (to MS-SQL, Postgres,...) running with the IISExpress Service - you will need to re-apply changes to the Service Account, and restart the service.
  • Now login to the website.

Step 7: Reactivate License Key on License Tab

  • This is only necessary if license details have be cleared out, or to refresh the license status.

Step 8: Update KeePass on Client Machines

  • Check Compatibility Chart:

    • Compatibility Chart: Enterprises can distribute new KeePass client versions to maintain full compatibility between the Server and KeePass clients
  • Automatic Method: IT staff can distribute the new KeePass version automatically to client machines using the methods listed below:

  • Manual Method: Users can download KeePass from the Client Download tab. This is the version that best corresponds to your Password Server version.

 

Have Questions?  Contact Us

Problems?

The upgrade of Password Server is a quick and simple process on all Windows Servers, Computers, and VM's mentioned here. Sometimes however, an unexpected problem may occur.

License details look wrong

  • Re-activate the license in the web application (License tab) to see any new renewal / license updates. This will show new expiry dates and user counts.

Upgrade Issues

  • Increase your Logging Details, and check if:

    • The Log output files are still changing, which means the Update is still in progress, or,
    • If there are errors.
  • Service startup problems 

  • Viewing Windows Events may provide some insight

  • Contact Support with your Detailed Logs, and a description of the problem you are seeing.

Changing Servers

Some users may choose to switch servers as part of their upgrade procedure. See Migration Steps, where all information and links are provided.

You can use the Database Backup and Restore feature to migrate your data to the new database. It is recommended to have the same version of the Password Server software running on the new server as on the old server.

However in instances of server failure or incompatibility with new versions, this may not be possible.

In such cases, move your database to the new server and follow the Updating Software instructions.

Further Reference: Items included in the Database Backup

Locating your database file

The default location of the Pleasant Password Server database can be found here: locating your database file.

Previous Versions