Updated on 2024-06-03 GMT+08:00

Upgrade Parameters

IsInplaceUpgrade

Parameter description: Specifies whether an upgrade is ongoing. This parameter is an upgrade parameter and cannot be modified. Only the sysadmin user can access the parameter.

This parameter is a SUSET parameter. Set it based on instructions provided in Table1 GUC parameter types.

Value range: Boolean

  • on indicates an upgrade is ongoing.
  • off indicates no upgrade is ongoing.

Default value: off

inplace_upgrade_next_system_object_oids

Parameter description: Indicates the OID of a new system object during the in-place upgrade. This parameter is used for upgrade and cannot be modified by users.

This parameter is a SUSET parameter. Set it based on instructions provided in Table1 GUC parameter types.

Value range: a string

Default value: empty

upgrade_mode

Parameter description: Specifies the upgrade mode. This parameter is used for upgrade. You are advised not to modify it.

This is a fixed INTERNAL parameter. It can be viewed but cannot be modified.

Value range: an integer ranging from 0 to 2147483647

  • 0: indicates that the local upgrade and the minor version gray upgrade are not in progress.
  • 1: indicates that the upgrade is in progress. The upgrade command is executed and takes effect after the check is completed.
  • 2: indicates that the major version gray upgrade is in progress. The upgrade command is executed and takes effect after the check is completed.

Default value: 0

Execute the precommand on new packages, switch to the cluster user, and use the source command to invalidate environment variables. Run the gs_upgradectl -t chose-strategy command to check whether the upgrade is a major version upgrade or minor version upgrade.

If "Upgrade strategy: large-binary-upgrade" is returned, the major version is upgraded.

If "Upgrade strategy: small-binary-upgrade" is returned, the minor version is upgraded.