5/25/2019 Athens Upgrade Full Guide

upgrade-guide.txt

// This builds off the setup here: https://gist.github.com/sirneb/8419e41aea4f2d5770555301006cea20
// This is upgrade storage version (node won't start otherwise) AND convert from archive mode to full mode with a fairly recent snapshot

Step 1: Update the docker-compose.yml from above to include "upgrader" and "importer" service. For this guide, you 
will need to update the <LOCAL_PATH_TO_SNAPSHOT_FILE> line to:
  "- /home/<USERNAME>/mainnet-BLy4Y4M1LtPJRDaiM1QRQog1a7HRfns2J6HKCFacwLBYMUFCG6P.full:/snapshot"
  (Remember to change <USERNAME>)
  
Example:
// docker-compose.yml
...
  upgrader:
    image: tezos/tezos:mainnet
    hostname: node
    command: tezos-upgrade-storage
    volumes:
      - node_data:/var/run/tezos/node
      - client_data:/var/run/tezos/client
      
  importer:
    image: tezos/tezos:mainnet
    hostname: node
    command: tezos-snapshot-import
    volumes:
      - node_data:/var/run/tezos/node
      - client_data:/var/run/tezos/client
      - /home/<USERNAME>/mainnet-BLy4Y4M1LtPJRDaiM1QRQog1a7HRfns2J6HKCFacwLBYMUFCG6P.full:/snapshot
...

Step 2: Stop your node
> docker-compose down

Step 3: Upgrade Storage, this should be very fast
> docker-compose pull && docker-compose up upgrader

// NOTE: If you want to keep your node as archive, at this point, you don't need to do anything else, just start as usual
Step 4: Destroy your existing chain data and download a recent snapshot
> docker volume rm <USERNAME>_node_data
> wget https://s3.us-east-2.amazonaws.com/tezos-snapshot/mainnet-BLy4Y4M1LtPJRDaiM1QRQog1a7HRfns2J6HKCFacwLBYMUFCG6P.full

Step 5: Convert to full mode and import snapshot (this step might take 30+ minutes, be patient!)
> docker-compose pull && docker-compose up importer

DONE!