Upgrade GoQuroum¶

The following information is for upgrading GoQuorum only.

You can have multiple versions of GoQuorum running on the same network, allowing you to perform a rolling (node-by-node) upgrade. Ensure your network maintains full uptime availability when upgrading to provide redundancy and reversibility if anything goes wrong.

Incremental upgrades¶

Stop the GoQuorum node you wish to upgrade, update the binary to the next version, and restart the node. Check that the node starts without errors and has the latest block from the network.

We don’t recommend jumping versions during an upgrade; some versions require manual intervention. Check the release log for any actions you might need to take.

Upgrade to GoQuorum 22.7.1¶

This release is an upstream merge of Geth v1.10.3 there are a couple of changes to note.

Support for eth/64 has been removed¶

The minimum protocol version is now eth/65 If you wish to upgrade any client in your network to this version all other clients should be running at least v21.4.0. Clients running prior to this version will continue to function if there are other nodes running on the network that support eth/64 and eth/65 (for example, v21.4.0 through v22.7.1). However, they will stop receiving block headers and transactions if this is not the case. For example if nodeA and nodeB are running v22.7.1 while nodeC is running v21.1 - nodeC will not be able to communicate with nodeA and nodeB.

Berlin Hard Fork¶

It is no longer possible to upgrade snapshot databases generated by pre-Berlin geth #22663. You must specify a block for berlinBlock if you wish to use snap sync.

Upgrade to GoQuorum 22.4.1¶

When upgrading to and past this version, you can specify a block for berlinBlock as the milestone block in your genesis file and run geth init again. The block needs to be sufficiently in the future to allow ALL your nodes in the network to upgrade before that block height is reached.

If you do not specify a value for berlinBlock, it is not applied. However, specifying a berlinBlock is required for some features (such as snap sync) to continue working and for subsequent forks to be applied (for example, london fork).

For more details about EIPs included in this upgrade and how they impact gas calculations, refer to the Ethereum blog.

Upgrade to GoQuorum 22.1.0¶

There are several significant changes to the underlying Geth 1.10 in the release of GoQuorum 22.1.0. Before you upgrade to this GoQuorum version, consider and prepare for these changes. The main things to be aware of are option deprecations and chain ID enforcement.

Option deprecations¶

Several command line interface (CLI) options are deprecated in the 1.9.x releases of Geth (first merged into GoQuorum as of version 2.6.0). Support for deprecated options is removed in GoQuorum 22.1.0.

See the full list of deprecated options.

Chain ID enforcement¶

Signing transactions with a chain ID is enforced as the default behavior in Geth 1.10 and GoQuorum 22.1.0 for raw transactions. This impacts client libraries, tooling, and applications.

You can send signed raw private transactions that include a chain ID to GoQuorum, but when you use sendTransaction for private transactions, GoQuorum continues to sign it using the Homestead signer (that is, without chain ID).

Recommended changes¶

We recommend you sign transactions using the chain ID on your network. If you use a client library, for example, web3j-quorum, you must use the latest QuorumTransactionManager to specify a chain ID. With web3js-quorum you can add the chainId property to the transaction, as seen in the Quorum Developer Quickstart examples.

If you don’t want to make application changes¶

From version 22.1.0, you can start GoQuorum with the option --rpc.allow-unprotected-txs. This allows you to submit transactions that aren’t signed with a chain ID.

Upgrade to GoQuorum 2.6.0¶

GoQuorum 2.6.0 upgrades the base Geth version from 1.8.18 to 1.9.7. See Ethereum 1.9.0 for the complete list if new features added as a part of Geth 1.9.7.

A node running on GoQuorum 2.6.0 can coexist in a network with other nodes on lower versions of GoQuorum, so you can perform a rolling upgrade to GoQuorum 2.6.0. The following is the recommended upgrade process:

1. Stop the node you wish to upgrade to GoQuorum 2.6.0. Modify the genesis.json file to include istanbulBlock and petersburgBlock. Set these parameters to an appropriate value in future by when the entire network will be upgraded to GoQuorum 2.6.0.

   Warning

   Setting the milestone blocks is necessary because the gas calculation logic changes in Geth 1.9.7. Not setting these values properly can result in a Bad block error.

2. GoQuorum 2.6.0 deprecates genesis parameters maxCodeSize and maxCodeSizeChangeBlock. A new attribute maxCodeSizeConfig is added to genesis to allow tracking of multiple maxCodeSize value changes.

   In earlier GoQuorum versions, if the maxCodeSize is changed multiple times, any node joining the network might get a Bad block error. The changes in GoQuorum 2.6.0 enable tracking of historical changes of maxCodeSize in the genesis file and thus allow it to be changed multiple times in the network’s life. When init is executed in GoQuorum 2.6.0, Geth forces use of maxCodeSizeConfig.

   Example

   "config": {
       "homesteadBlock": 0,
       "byzantiumBlock": 0,
       "constantinopleBlock": 0,
       "petersburgBlock": 0,
       "istanbulBlock": 0,
       "chainId": 10,
       "eip150Block": 0,
       "eip155Block": 0,
       "eip150Hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
       "eip158Block": 0,
       "isQuorum": true,
       "maxCodeSizeConfig": [
         {
           "block": 5,
           "size": 35
         },
         {
           "block": 15,
           "size": 24
         },
         {
           "block": 20,
           "size": 35
         }
       ]
     },
   

3. Execute geth --datadir path/to/datadir init genesis.json with the modified genesis.json.

4. Start the node in GoQuorum 2.6.0.