Page tree
Skip to end of metadata
Go to start of metadata

Overview

Upgrading from a previous version of pulse™ is a fully-automated procedure. The pulse™ Setup Wizard recognises when you are working with data from a previous installation and directs you through the upgrade process.

Warning

When removing previous versions of pulse™, take care not to remove the data directory. In particular, do not run the Windows uninstaller if your data directory is stored with the pulse™ Program Files. Always back up your data before uninstalling or performing an upgrade!

Upgrading from 2.6.19 or earlier

Note that due to changes to unversioned components of Pulse, automatic agent upgrades to 2.7.x will not work from versions earlier than 2.6.20. If you are running 2.6.19 or earlier, you should first upgrade to the latest 2.6.x build, then upgrade again to the latest version. See the Compatibility Notes for more information.

Preparation

To prepare for an upgrade, you should take the following steps:

  1. Check the Compatibility Notes to see if there are any changes of concern to you.
  2. Shut down the current pulse™ server, using pulse shutdown, or by stopping the pulse™ service. Ensure the pulse™ process has exited before continuing.
  3. Back up the current pulse™ data. As all data is stored in the data directory, this can be done by simply backing up that directory.

Keeping a backup protects against any upgrade problems. Note that if you are using the embedded database, pulse™ will take an automatic backup of just the database directory during the upgrade, as a fallback. This is not a replacement for a full backup. We recommend a full data directory backup for every upgrade, and regular backups between upgrades.

External Databases

If you have migrated to an external database, you will also need to manually backup the database before an upgrade. This can be done using either the database's own tools, or by running a "pulse export".

Installing the New Version

To install the new version of pulse™, follow the steps outlined on the Installation page up to the point where the Setup Wizard begins. Instead of choosing a new data directory, enter the path of your current data directory. pulse™ will recognise that there is existing data from a previous installation, and guide you through the automatic upgrade process.

First, you will be shown any upgrade tasks that pulse™ will need to execute during the upgrade. If you choose to proceed, pulse™ will execute each task in order, showing progress, until the upgrade is complete. Upon completion the new version of pulse™ will start and you will be able to begin using it immediately.

Failed Upgrades

If the upgrade fails for any reason, you should roll back your entire data directory to a backup. Rolling back only part of the data directory is likely to result in a broken installation. For assistance with debugging upgrade issues, contact Zutubi support.

Upgrading Agents

After the pulse™ server is upgraded, it will automatically upgrade any agents that have a different version. The upgrade process completely automatic, including a restart of the agent. Progress is reported via the agent status.

Upgrading from 2.6.19 or earlier

Note that due to changes to unversioned components of Pulse, automatic agent upgrades to 2.7.x will not work from versions earlier than 2.6.20. If you are running 2.6.19 or earlier, you should first upgrade to the latest 2.6.x build, then upgrade again to the latest version. See the Compatibility Notes for more information.

Manual Upgrades

In some cases, an agent upgrade may not be able to proceed automatically as a core component has changed. In this case, the agent will need to be upgraded manually. This can be done simply by installing a new version of the agent on the corresponding machine.

Failed Upgrades

If the agent upgrade fails for any reason, the agent will be disabled. To retry the upgrade, reenable the agent using the link provided. Alternatively, upgrade the agent manually and then reenable it.

  • No labels