Update re-compute certificates hashes runbook

Author: jpraynaud

docs/runbook/recompute-certificates-hash/README.md

@@ -5,12 +5,14 @@ Export the environment variables:
 ```bash
 export MITHRIL_VM=**MITHRIL_VM**
 export CARDANO_NETWORK=**CARDANO_NETWORK**
+export MITHRIL_DISTRIBUTION_LINUX_PKG=**MITHRIL_DISTRIBUTION_LINUX_PKG**
 ```
 
 Here is an exmaple for the `release-mainnet` network:
 ```bash
 export MITHRIL_VM=aggregator.release-mainnet.api.mithril.network
 export CARDANO_NETWORK=mainnet
+export MITHRIL_DISTRIBUTION_LINUX_PKG=https://github.com/input-output-hk/mithril/releases/download/2342.0/mithril-2342.0-linux-x64.tar.gz
 ```
 
 ## Make a backup of the aggregator database
@@ -30,29 +32,64 @@ And copy the SQLite database file `aggregator.sqlite3`:
 cp /home/curry/data/$CARDANO_NETWORK/mithril-aggregator/mithril/stores/aggregator.sqlite3 /home/curry/data/$CARDANO_NETWORK/mithril-aggregator/mithril/stores/aggregator.sqlite3.bak.$(date +%Y-%m-%d)
 ```
 
-And connect to the aggregator container:
+## Create a temp directory
+
+Create a temp directory:
 ```bash
-docker exec -it mithril-aggregator bash
+rm -rf /home/curry/temp
+mkdir -p /home/curry/temp/config
+cd /home/curry/temp
 ```
 
-Once connected to the aggregator container, recompute the certificates hashes:
+And download the configuration file for tools:
 ```bash
-/app/bin/mithril-aggregator -vvvv tools recompute-certificates-hash
+wget https://raw.githubusercontent.com/input-output-hk/mithril/main/docs/runbook/recompute-certificates-hash/config/tools.json -O /home/curry/temp/config/tools.json
 ```
 
-Then disconnect from the aggregator container:
+## Download the pre-compiled aggregator binary
+
+Download the mithril pre-compiled binaries package:
 ```bash
-exit
+wget $MITHRIL_DISTRIBUTION_LINUX_PKG -O mithril-bin.tar.gz
+```
+
+Unpack the mithril aggregator binary:
+```bash
+tar xzf mithril-bin.tar.gz mithril-aggregator
+```
+
+Make mithril aggregator binary executable:
+```bash
+chmod u+x mithril-aggregator
+```
+
+Make sure you are running the expected version of the aggregator:
+```bash
+./mithril-aggregator --version
+```
+
+## Stop the aggregator
+
+Stop the aggregator container:
+```bash
+docker stop mithril-aggregator
+```
+
+## Run the migration
+
+Once connected to the aggregator container, recompute the certificates hashes:
+```bash
+DATA_STORES_DIRECTORY=/home/curry/data/$CARDANO_NETWORK/mithril-aggregator/mithril/stores/ ./mithril-aggregator --run-mode tools -vvv tools recompute-certificates-hash
 ```
 
 ## Restart the aggregator
 
 Restart the aggregator to make sure that the certificate chain is valid:
 ```bash
-docker restart mithril-aggregator
+docker start mithril-aggregator
 ```
 
-Make sure that the certificate chain is valid (wait for the state machiene to go into the state `READY`):
+Make sure that the certificate chain is valid (wait for the state machine to go into the `READY` state):
 ```bash
 docker logs -f --tail 1000 mithril-aggregator
 ```
@@ -62,6 +99,13 @@ Then disconnect from the aggregator VM:
 exit
 ```
 
+## Cleanup the temp directory
+
+Remove the temp directory:
+```bash
+rm -rf /home/curry/temp
+```
+
 ## Rollback procedure
 
 If the recomputation fails, you can rollback the database.

docs/runbook/recompute-certificates-hash/config/tools.json

@@ -0,0 +1,17 @@
+{
+    "cardano_cli_path": "-",
+    "cardano_node_socket_path": "-",
+    "network": "-",
+    "network_magic": 0,
+    "run_interval": 0,
+    "protocol_parameters": {
+        "k": 0,
+        "m": 0,
+        "phi_f": 0
+    },
+    "snapshot_store_type": "local",
+    "snapshot_uploader_type": "local",
+    "genesis_verification_key": "-",
+    "era_adapter_type": "bootstrap",
+    "cardano_node_version": "-"
+}