# Upgrade

This module provides the basic functions of software version upgrade.

# Available Commands

Name Description
software-upgrade Submit a software upgrade proposal
cancel-software-upgrade Cancel the current upgrade proposal
plan Query the software upgrade plan currently in progress
applied Query the executed software upgrade plan

# plugchaind tx gov submit-proposal software-upgrade

Initiate a software upgrade proposal through the Gov module.

plugchaind tx gov submit-proposal software-upgrade <plan-name> [flags]

Flags:

Name, shorthand Type Required Default Description
--deposit Coins deposit of proposal
--title string title of proposal
--description string description of proposal
--upgrade-height uint64 The height at which the upgrade must happen (not to be used together with --upgrade-time)
--upgrade-time Time The time at which the upgrade must happen (ex. 2006-01-02T15:04:05Z) (not to be used together with --upgrade-height)
--upgrade-info string Optional info for the planned upgrade such as commit hash, etc.

TIP

If you need to support cosmovisor to automatically perform software upgrades, --upgrade-info needs to use a fixed format, such as:

{
    "binaries": {
        "linux/amd64":"https://example.com/Plug Chain Hub.zip?checksum=sha256:aec070645fe53ee3b3763059376134f058cc337247c978add178b6ccdfb0019f"
    }
}

# plugchaind tx gov submit-proposal cancel-software-upgrade

Submit cancellation of the currently ongoing software upgrade proposal through the Gov module.

plugchaind tx gov submit-proposal cancel-software-upgrade [flags]

Flags:

Name, shorthand Type Required Default Description
--deposit Coins deposit of proposal
--title string title of proposal
--description string description of proposal

# plugchaind query upgrade plan

Query the currently ongoing software upgrade plan.

plugchaind query upgrade plan [flags]

# plugchaind query upgrade applied

Query the software upgrade plan that has been executed recently.

plugchaind query upgrade applied <upgrade-name>