Collapse AllExpand All

8.1. PostBooks updater packages

If you are currently on version 4.4.0 or greater, you will be able to upgrade to any newer version in a single step. For example, to upgrade from version 4.4.0 to 4.10.1, you would use the updater package called postbooks-upgrade-4101.gz.

If you are currently running a version lower than 4.4.0, you'll have to find the packages for each of the releases between your current version and 4.4.0 and run those one after another to get to 4.4.0, after which you can update the rest of the way with a single package. To know which files to download, you need to understand the naming conventions for the update packages.

PostBooks® update packages are named pbOLDtoNEW.gz, where OLD and NEW are version numbers corresponding to releases of xTuple ERP. If you are upgrading production databases you should only download update packages where OLD and NEW are simple 3 digit numbers, such as pb40xto410.gz - this is the upgrade package for PostBooks® from release 4.0.0 to 4.1.0. Anything else, such as pb310alphato310beta.gz, is an upgrade from an intermediate release to another intermediate release (in this case from an alpha to a beta) and should only be used if you want to test upcoming functionality in a test database. In this test case you'll need to get all of the individual update packages for all of the intervening alpha, beta, and possibly release candidate releases, and apply them in turn.

In summary using examples:

  • If you are updating PostBooks from 4.4.0 or higher, you need to download and install one updater package to get to the current version.

  • If you are updating PostBooks® from a version prior to 4.4.0 you need to download a package for each version up until 4.4.0, and then one more to get to the current version. For example, to go from 4.2.0 to 4.10, you need:

    • pb42xto430.gz

    • pb43xto440.gz

    • postbooks-upgrade-410x.gz

Tip

A note to Mac users: The Safari web browser uncompresses .gz files after it downloads them (read this article). For the time being, your options are to recompress the package files after downloading them (you can use gzip in a Terminal window or various GUI tools) or download them with a different web browser.