proxmox/docs/06-besu/VALIDATOR_UPDATE_SCRIPTS_CREATED.md

# Validator Update Scripts Created

**Last Updated:** 2026-01-31  
**Document Version:** 1.0  
**Status:** Active Documentation

---

**Date**: 2025-01-20  
**Status**: ✅ **SCRIPTS READY FOR EXECUTION**

---

## Summary

All required scripts and configurations have been prepared to update validators with transaction pool settings. Multiple execution methods are available.

---

## Scripts Created

### 1. ✅ `scripts/update-all-validators-txpool.sh`
**Purpose**: Automated script to update all validators via SSH

**Features**:
- Updates validators on both ml110 and r630-01
- Checks if settings already exist
- Restarts validator services
- Handles multiple config file locations

**Usage**:
```bash
bash scripts/update-all-validators-txpool.sh
```

**Requirements**: SSH access to Proxmox hosts

---

### 2. ✅ `scripts/update-validator-config-standalone.sh`
**Purpose**: Standalone script to be executed on Proxmox hosts

**Features**:
- Can be copied to Proxmox hosts
- Executes directly on Proxmox host
- Updates validators using `pct exec`
- Handles both ml110 and r630 validators

**Usage**:
```bash
# Copy to Proxmox host
scp scripts/update-validator-config-standalone.sh intlc@192.168.11.10:/tmp/

# Execute on Proxmox host
ssh intlc@192.168.11.10 "bash /tmp/update-validator-config-standalone.sh"
```

---

### 3. ✅ `scripts/validator-txpool-one-liners.sh`
**Purpose**: Generates one-line commands for manual execution

**Features**:
- Provides ready-to-use one-line commands
- Can be copy-pasted directly on Proxmox hosts
- Updates and restarts in single command
- Separate commands for each validator

**Usage**:
```bash
# View commands
bash scripts/validator-txpool-one-liners.sh

# Copy and paste commands on Proxmox hosts
```

---

## Configuration Files Updated

### ✅ `smom-dbis-138/config/config-validator.toml`
- Added transaction pool settings
- Ready for deployment

### ✅ `smom-dbis-138-proxmox/templates/besu-configs/config-validator.toml`
- Added transaction pool settings
- Template updated for future deployments

---

## Configuration Added

All configs now include:
```toml
# Transaction Pool Configuration
tx-pool-max-size=8192
tx-pool-limit-by-account-percentage=0.5
tx-pool-price-bump=10
```

---

## Execution Methods

### Method 1: Automated Script (Requires SSH)
```bash
bash scripts/update-all-validators-txpool.sh
```

### Method 2: Standalone Script (Copy to Host)
```bash
# On local machine
scp scripts/update-validator-config-standalone.sh intlc@192.168.11.10:/tmp/

# On Proxmox host
bash /tmp/update-validator-config-standalone.sh
```

### Method 3: One-Line Commands (Manual)
```bash
# View commands
bash scripts/validator-txpool-one-liners.sh

# Execute on Proxmox host (example for validator 1003)
pct exec 1003 -- bash -c 'if ! grep -q "tx-pool-max-size" /etc/besu/config-validator.toml; then echo "" >> /etc/besu/config-validator.toml && echo "# Transaction Pool Configuration" >> /etc/besu/config-validator.toml && echo "tx-pool-max-size=8192" >> /etc/besu/config-validator.toml && echo "tx-pool-limit-by-account-percentage=0.5" >> /etc/besu/config-validator.toml && echo "tx-pool-price-bump=10" >> /etc/besu/config-validator.toml; fi && systemctl restart besu-validator'
```

---

## Validators to Update

### ml110 (192.168.11.10)
- ⏳ Validator 1003
- ⏳ Validator 1004

### r630-01 (192.168.11.11)
- ⏳ Validator 1000
- ⏳ Validator 1001
- ⏳ Validator 1002

---

## Verification

After updating validators, verify:

### Check Configuration
```bash
pct exec <VMID> -- grep -i "tx-pool" /etc/besu/config-validator.toml
```

Expected output:
```
# Transaction Pool Configuration
tx-pool-max-size=8192
tx-pool-limit-by-account-percentage=0.5
tx-pool-price-bump=10
```

### Check Service Status
```bash
pct exec <VMID> -- systemctl status besu-validator
```

### Monitor Block Production
```bash
# Check if blocks include transactions
cast rpc eth_getBlockTransactionCountByNumber "0x<block_number>" --rpc-url http://192.168.11.211:8545
```

---

## Next Steps

1. ⏳ **Execute update scripts** on Proxmox hosts
2. ⏳ **Verify configuration** on all validators
3. ⏳ **Monitor block production** for transaction inclusion
4. ⏳ **Verify pending transactions** are being confirmed

---

## Status

**Scripts**: ✅ **CREATED**  
**Configs**: ✅ **UPDATED**  
**Ready**: ✅ **YES**  
**Execution**: ⏳ **PENDING MANUAL EXECUTION**

---

**All scripts and configurations are ready. Choose the execution method that works best for your environment and execute the updates on all 5 validators.**