Palm Node Migration to Polygon Edge

Palm network is being transitioned from Besu client to Polygon Edge client. As part of the migration, it is required to configure a stop block in existing Besu validators so that Besu clients will stop validating blocks.

Network	Besu Stop Block	Approx. Transition Date	Besu Update Date
mainnet	14286241	2023-10-31	before 2023-10-22
testnet	14223601	2023-10-02	before 2023-10-01

Update Besu Validator Nodes

Existing validators need to be updated with a forked binary available at https://github.com/ConsenSys-Palm/palm-besu/releases/download/22.7.4/besu-22.7.4.tar.gz. Also additional configuration parameters need to be set.

Update the inventory configuration for the Besu validator nodes playbooks/inventories/prd.yaml

all:
  hosts:
    # validator node
    1.2.3.4:
      # Set the fork block. Same block value must be set for all validators
      besu_cmdline_args:
        - "--miner-stop-block=14286241"
        - "--sync-stop-block=14286241"

  vars:
    # Override the default binary location for all nodes
    besu_download_url: "https://github.com/ConsenSys-Palm/palm-besu/releases/download/22.7.4/besu-22.7.4.tar.gz"

Run Ansible playbook to update the nodes

cd playbooks

# Example command updates UAT environment nodes
./update_nodes.sh prd 22.7.4

Verification

Use following to verify the correct binary and configuration has been installed.

# Verify Besu binary
cksum /opt/besu/current/bin/besu
1500358826 16509 /opt/besu/current/bin/besu

# Verify configuration has been added to Besu service file
grep "^ExecStart" /etc/systemd/system/besu.service
ExecStart=/bin/sh -c "/opt/besu/current/bin/besu --config-file=/etc/besu/config.toml --miner-stop-block=14286241 --sync-stop-block=14286241 >> /var/log/besu/besu.log 2>&1"