From b7deb9f456cb09ab8b4fba516bdf2b6c83386623 Mon Sep 17 00:00:00 2001 From: kaustubhkapatral Date: Wed, 16 Apr 2025 15:17:59 +0530 Subject: [PATCH 1/3] added v2.5.0 upgrade doc --- passage-2/upgrades/v2.5.0.md | 77 ++++++++++++++++++++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 passage-2/upgrades/v2.5.0.md diff --git a/passage-2/upgrades/v2.5.0.md b/passage-2/upgrades/v2.5.0.md new file mode 100644 index 0000000..03ff4ab --- /dev/null +++ b/passage-2/upgrades/v2.5.0.md @@ -0,0 +1,77 @@ +## Upgrade Guide v2.5.0 + +This document provides guidelines for node operators upgrading from Passage `v2.4.0` to `v2.5.0`. + +**Important Note**: Please ensure you have set the minimum gas prices to `12.5upasg` in the `app.toml` file. If the value is not set then the node will panic and fail to start after applying the upgrade. +``` +minimum-gas-prices = "12.5upasg" +``` + +### Option 1: Using Cosmovisor + +The following instructions assume the `cosmovisor` binary is already installed and cosmovisor is set up as a systemd service. If this is not the case, please refer to [Using Cosmovisor](https://docs.cosmos.network/main/build/tooling/cosmovisor) for instructions on how to install and set up `cosmovisor`. + +Build the upgrade binary `v2.5.0` from source: + +``` +git clone https://github.com/envadiv/Passage3D +cd Passage3D +git checkout v2.5.0 +make build +``` + +Ensure the `passage` binary has been built: +``` +./build/passage version +``` +You should see the following: + +`2.5.0` + + +Create a `v2.5.0` directory and copy the upgrade binary (v2.5.0) to the directory: + +``` +mkdir -p $HOME/.passage/cosmovisor/upgrades/v2.5.0/bin +cp ~/Passage3D/build/passage $HOME/.passage/cosmovisor/upgrades/v2.5.0/bin +``` + +Ensure the right `passage` binary has been placed in the directory: +``` +$HOME/.passage/cosmovisor/upgrades/v2.5.0/bin/passage version +``` + + +You should see the following: + +`2.5.0` + +At the proposed block height, cosmovisor will automatically stop the current binary ``(v2.4.0)``, set the upgrade binary as the current binary ``(v2.5.0)``, and then (depending on the cosmovisor settings) perform a backup and restart the node. + +### Option 2: Without Cosmovisor + +Using `cosmovisor` to perform the upgrade is not necessary. Node operators also have the option to manually update the `passage` binary at the time of the upgrade. + +When the chain halts at the proposed upgrade height, stop the current process running passage. + +**Warning**:- Please execute these steps only after the upgrade height is reached on the network. Building and restarting the process before the upgrade height might cause data corruption in the node database. + +Build the upgrade binary ``(v2.5.0)`` from source: + +``` +git clone https://github.com/envadiv/Passage3D +cd Passage3D +git checkout v2.5.0 +make install +``` + + +Ensure the passage binary has been updated: + +`passage version` + +You should see the following: + +`2.5.0` + +Restart the process running `passage`. From 2883c9b16d514cd2783800454d4572e8b5611da7 Mon Sep 17 00:00:00 2001 From: Kaustubh K <54210167+kaustubhkapatral@users.noreply.github.com> Date: Wed, 16 Apr 2025 15:20:22 +0530 Subject: [PATCH 2/3] Update v2.5.0.md --- passage-2/upgrades/v2.5.0.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/passage-2/upgrades/v2.5.0.md b/passage-2/upgrades/v2.5.0.md index 03ff4ab..3492eda 100644 --- a/passage-2/upgrades/v2.5.0.md +++ b/passage-2/upgrades/v2.5.0.md @@ -2,7 +2,9 @@ This document provides guidelines for node operators upgrading from Passage `v2.4.0` to `v2.5.0`. -**Important Note**: Please ensure you have set the minimum gas prices to `12.5upasg` in the `app.toml` file. If the value is not set then the node will panic and fail to start after applying the upgrade. +### Important Note + +Please ensure you have set the minimum gas prices to `12.5upasg` in the `app.toml` file. If the value is not set then the node will panic and fail to start after applying the upgrade. ``` minimum-gas-prices = "12.5upasg" ``` From 71d0734858e1e15fd2ee5f90b578d40f9404e56a Mon Sep 17 00:00:00 2001 From: kaustubhkapatral Date: Wed, 16 Apr 2025 15:46:30 +0530 Subject: [PATCH 3/3] added sed cmd --- passage-2/upgrades/v2.5.0.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/passage-2/upgrades/v2.5.0.md b/passage-2/upgrades/v2.5.0.md index 3492eda..da33d19 100644 --- a/passage-2/upgrades/v2.5.0.md +++ b/passage-2/upgrades/v2.5.0.md @@ -8,7 +8,10 @@ Please ensure you have set the minimum gas prices to `12.5upasg` in the `app.tom ``` minimum-gas-prices = "12.5upasg" ``` - +You can set the gas prices on your node using this command: +``` +sed -i '/minimum-gas-prices =/c\minimum-gas-prices = "12.5upasg"' $HOME/.passage/config/app.toml +``` ### Option 1: Using Cosmovisor The following instructions assume the `cosmovisor` binary is already installed and cosmovisor is set up as a systemd service. If this is not the case, please refer to [Using Cosmovisor](https://docs.cosmos.network/main/build/tooling/cosmovisor) for instructions on how to install and set up `cosmovisor`.