Skip to main content

Upgrading Pryzm Node Installed via Binary and systemd

This documentation provides a detailed guide on how to upgrade your Pryzm node when it has been installed via binary and managed by systemd. The guide also covers scenarios where the node is managed by Cosmovisor, highlighting the differences between major and minor updates. Follow the instructions below to perform the upgrade process.

Prerequisites​

Before proceeding with the upgrade, ensure you have the following:

  • A running Pryzm node installed via binary and managed by systemd.
  • Basic knowledge of Linux, systemd, and terminal commands.
  • Access to the internet to download the new Pryzm version.

Without Cosmovisor​

  1. Visit the official Pryzm repository's releases page on GitHub and download the latest version of Pryzm compatible with your system.

  2. Stop the running Pryzm node service by executing the following command:

    systemctl stop pryzmd.service

  3. Replace the existing Pryzm binary file with the newly downloaded version. Locate the existing Pryzm binary file and replace it with the new version. If necessary, build the Pryzm binary by following the build instructions provided in the Pryzm repository's documentation.

  4. Start the Pryzm node service again:

    systemctl start pryzm.service

  5. Monitor the logs of the Pryzm node service to ensure a successful startup and check for any error messages. Use the following command to view the logs:

    journalctl -u pryzm.service -f

  6. Verify that the upgrade was successful by checking the logs and ensuring the Pryzm node is operating as expected.

With Cosmovisor​

This is the Cosmovisor folder architecture indicating where you need to put the new version of your pryzmd binary.

.pryzm
└── cosmovisor
    ├── current
    ├── genesis
    │   └── bin
    │       └── pryzmd
    └── upgrades
        └── v1
            └── bin
                └── pryzmd

  1. Visit the official Pryzm repository's releases page on GitHub and download the latest version of Pryzm compatible with your system. or build your own version by downloading the source code and following the how to build document.

  2. Stop the running Cosmovisor service.

    systemctl stop cosmovisor.service

  3. Replace the existing Pryzm binary file with the newly downloaded version. Locate the existing Pryzm binary file located at .pryzm/cosmovisor/upgrades/v1/bin/pryzmd and replace it with the new version. Ensure that the new binary has the appropriate permissions.

    cp pryzmd ~/.pryzm/cosmovisor/upgrades/v1/bin/

  4. Start the Cosmovisor service again.

    systemctl start cosmovisor.service

  5. Monitor the logs of the Pryzm node to ensure a successful startup and check for any error messages. Use the following command to view the logs:

    journalctl -u cosmovisor.service -f

  6. Verify that the upgrade was successful by checking the logs and ensuring the Pryzm node is operating as expected.

Note on Major Upgrades​

If you are performing a major upgrade (e.g., from v1.x.x to v2.x.x), you may need to follow additional steps to update the Cosmovisor upgrade folder. In the provided directory architecture, the v1 folder represents a specific upgrade version. For major upgrades, you would need to create a new folder under the upgrades directory (e.g., v2) and place the new Pryzm binary inside the bin folder of the respective upgrade version.

mkdir -p ~/.pryzm/cosmovisor/upgrades/v2/bin
cp pryzmd ~/.pryzm/cosmovisor/upgrades/v2/bin/
systemctl stop cosmovisor.service
systemctl start cosmovisor.service