This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Upgrade

    Learn how to upgrade your Piglet Run installation.

    Overview

    Piglet Run upgrades include:

    • Minor Updates: Bug fixes and security patches
    • Major Upgrades: New features and improvements
    • PostgreSQL Upgrades: Database version upgrades

    Quick Upgrade

    Upgrade to latest version:

    pig upgrade

    Check for Updates

    View Current Version

    pig version

    Check Available Updates

    pig upgrade check

    Perform Upgrade

    Standard Upgrade

    pig upgrade --backup

    Upgrade to Specific Version

    pig upgrade --version 2.5.0

    Dry Run

    pig upgrade --dry-run

    Upgrade PostgreSQL

    Check Compatible Versions

    pig upgrade pg --list

    Upgrade Database Version

    pig upgrade pg --version 17

    With Full Backup

    pig upgrade pg --version 17 --backup

    Before Upgrading

    1. Create Backup

      pig backup create --full

    2. Check Compatibility

      pig upgrade check --verbose

    3. Review Release Notes

      pig upgrade notes

    Rollback

    If upgrade fails:

    Restore from Backup

    pig restore --backup pre-upgrade

    Rollback to Previous Version

    pig upgrade rollback

    Upgrade History

    View upgrade history:

    pig upgrade history

    Example output:

    Version    Date         Status
-------    ----------   -------
2.5.0      2024-01-15   Current
2.4.1      2024-01-01   Previous
2.4.0      2023-12-15   Archived

    Configuration

    Upgrade settings in /etc/piglet/upgrade.yml:

    upgrade:
  auto_backup: true
  notify: true
  channel: stable  # stable, beta, nightly

    Next Steps