fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands - CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround - CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check - NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere - MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates - LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference Co-authored-by: Cursor <cursoragent@cursor.com>
195 lines
6.3 KiB
Markdown
195 lines
6.3 KiB
Markdown
# Besu Configuration Cleanup - Complete
|
|
|
|
**Last Updated:** 2026-01-31
|
|
**Document Version:** 1.0
|
|
**Status:** Active Documentation
|
|
|
|
---
|
|
|
|
**Date**: 2026-01-17
|
|
**Status**: ✅ **ALL DEPRECATED OPTIONS REMOVED**
|
|
|
|
---
|
|
|
|
## Summary
|
|
|
|
All Besu configuration files have been cleaned to remove deprecated and invalid options that cause Besu v23.10.0+ to fail. Additionally, logging levels have been optimized for minimal logging on validators and RPC nodes, while maintaining detailed logging for sentry archive nodes.
|
|
|
|
---
|
|
|
|
## Changes Applied
|
|
|
|
### 1. Logging Optimization
|
|
|
|
#### Validators → WARN (Minimal Logs)
|
|
- `smom-dbis-138/config/config-validator.toml`
|
|
- `smom-dbis-138-proxmox/templates/besu-configs/config-validator.toml`
|
|
|
|
#### RPC Nodes → WARN (Minimal Logs)
|
|
- All 13 RPC configuration files updated
|
|
- Includes: core, public, perm, thirdweb, putu, luis, member configs
|
|
|
|
#### Sentry Nodes → INFO (Archive Logs)
|
|
- `smom-dbis-138-proxmox/templates/besu-configs/config-sentry.toml`
|
|
- Maintains INFO logging for full archive node functionality
|
|
|
|
### 2. Deprecated Options Removed
|
|
|
|
The following deprecated/invalid options were removed from **all 16 configuration files**:
|
|
|
|
| Option | Reason | Impact |
|
|
|--------|--------|--------|
|
|
| `log-destination` | Deprecated - use `logging` option | Besu v23.10.0+ ignores this option |
|
|
| `fast-sync-min-peers` | Incompatible with `sync-mode="FULL"` | Causes configuration errors |
|
|
| `database-path` | Deprecated - use `data-path` instead | Besu v23.10.0+ ignores this option |
|
|
| `trie-logs-enabled` | Deprecated | No longer used |
|
|
| `accounts-enabled` | Deprecated | No longer used |
|
|
| `max-remote-initiated-connections` | Deprecated in Besu v23.10.0 | No longer used |
|
|
| `rpc-http-host-allowlist` | Deprecated | Use firewall rules instead |
|
|
| `rpc-tx-feecap="0x0"` | Invalid value - cannot convert to Wei | Causes parsing errors |
|
|
| `tx-pool-max-size` | Legacy - incompatible with layered implementation | Causes configuration errors |
|
|
| `tx-pool-price-bump` | Legacy - incompatible with layered implementation | Causes configuration errors |
|
|
| `tx-pool-retention-hours` | Legacy - incompatible with layered implementation | Causes configuration errors |
|
|
|
|
---
|
|
|
|
## Files Cleaned
|
|
|
|
### Validator Configurations (2 files)
|
|
- ✅ `smom-dbis-138/config/config-validator.toml`
|
|
- ✅ `smom-dbis-138-proxmox/templates/besu-configs/config-validator.toml`
|
|
|
|
### RPC Node Configurations (13 files)
|
|
- ✅ `smom-dbis-138/config/config-rpc-core.toml`
|
|
- ✅ `smom-dbis-138/config/config-rpc-public.toml`
|
|
- ✅ `smom-dbis-138/config/config-rpc-perm.toml`
|
|
- ✅ `smom-dbis-138/config/config-rpc-thirdweb.toml`
|
|
- ✅ `smom-dbis-138/config/config-rpc-4.toml`
|
|
- ✅ `smom-dbis-138/config/config-rpc-putu-1.toml`
|
|
- ✅ `smom-dbis-138/config/config-rpc-putu-8a.toml`
|
|
- ✅ `smom-dbis-138/config/config-rpc-luis-1.toml`
|
|
- ✅ `smom-dbis-138/config/config-rpc-luis-8a.toml`
|
|
- ✅ `smom-dbis-138/config/config-member.toml`
|
|
- ✅ `smom-dbis-138-proxmox/templates/besu-configs/config-rpc-core.toml`
|
|
- ✅ `smom-dbis-138-proxmox/templates/besu-configs/config-rpc.toml`
|
|
- ✅ `smom-dbis-138-proxmox/templates/besu-configs/config-rpc-4.toml`
|
|
|
|
### Sentry Node Configurations (1 file)
|
|
- ✅ `smom-dbis-138-proxmox/templates/besu-configs/config-sentry.toml`
|
|
|
|
**Total**: 16 configuration files cleaned
|
|
|
|
---
|
|
|
|
## Scripts Created
|
|
|
|
### 1. `scripts/optimize-besu-logging.sh`
|
|
- Updates logging levels across all Besu configs
|
|
- Supports dry-run mode
|
|
- Creates backups before modification
|
|
- Validates changes after application
|
|
|
|
### 2. `scripts/cleanup-besu-deprecated-options.sh`
|
|
- Removes all deprecated Besu configuration options
|
|
- Supports dry-run mode
|
|
- Creates timestamped backups
|
|
- Comprehensive cleanup of 11 deprecated options
|
|
|
|
---
|
|
|
|
## Verification
|
|
|
|
### Deprecated Options Check
|
|
```bash
|
|
# Verify no deprecated options remain
|
|
grep -rE '^(log-destination|fast-sync-min-peers|database-path|trie-logs-enabled|accounts-enabled|max-remote-initiated-connections|rpc-http-host-allowlist|rpc-tx-feecap="0x0"|tx-pool-max-size|tx-pool-price-bump|tx-pool-retention-hours)' \
|
|
smom-dbis-138/config/*.toml \
|
|
smom-dbis-138-proxmox/templates/besu-configs/*.toml
|
|
# Result: 0 matches (all removed)
|
|
```
|
|
|
|
### Logging Levels Check
|
|
- ✅ Validators: `logging="WARN"`
|
|
- ✅ RPC Nodes: `logging="WARN"`
|
|
- ✅ Sentry Nodes: `logging="INFO"`
|
|
|
|
### Configuration Structure
|
|
- ✅ All configs use `data-path` (not deprecated `database-path`)
|
|
- ✅ All configs use `sync-mode="FULL"` (no incompatible `fast-sync-min-peers`)
|
|
- ✅ No deprecated transaction pool options
|
|
- ✅ No invalid `rpc-tx-feecap="0x0"` values
|
|
|
|
---
|
|
|
|
## Configuration Summary by Node Type
|
|
|
|
### Validators
|
|
- **Logging**: WARN (minimal)
|
|
- **RPC**: Disabled (security)
|
|
- **Sync Mode**: FULL
|
|
- **Purpose**: QBFT consensus participation
|
|
|
|
### RPC Nodes
|
|
- **Logging**: WARN (minimal)
|
|
- **RPC**: Enabled (varies by type)
|
|
- **Sync Mode**: FULL
|
|
- **Purpose**: JSON-RPC API serving
|
|
|
|
### Sentry Nodes
|
|
- **Logging**: INFO (archive)
|
|
- **RPC**: Enabled (internal)
|
|
- **Sync Mode**: FULL (archive)
|
|
- **Purpose**: Full archive nodes, P2P relay
|
|
|
|
---
|
|
|
|
## Backups Created
|
|
|
|
All modified files have timestamped backups:
|
|
- Format: `{filename}.backup.{YYYYMMDD_HHMMSS}`
|
|
- Total backups: 16 files
|
|
- Location: Same directory as original config files
|
|
|
|
---
|
|
|
|
## Next Steps
|
|
|
|
1. **Test Configurations**
|
|
- Validate configs with Besu v23.10.0+
|
|
- Ensure no "Unknown options" errors
|
|
|
|
2. **Deploy to Nodes**
|
|
- Copy cleaned configs to running Besu nodes
|
|
- Restart services to apply changes
|
|
|
|
3. **Monitor**
|
|
- Verify services start without errors
|
|
- Check that logging levels are appropriate
|
|
- Confirm no configuration-related restarts
|
|
|
|
4. **Documentation**
|
|
- Update deployment guides with cleaned configs
|
|
- Document which options are valid for Besu v23.10.0+
|
|
|
|
---
|
|
|
|
## Benefits
|
|
|
|
✅ **Compatibility**: All configs compatible with Besu v23.10.0+
|
|
✅ **Performance**: Minimal logging reduces I/O overhead on validators/RPC nodes
|
|
✅ **Archive**: Sentry nodes maintain detailed logs for archival purposes
|
|
✅ **Reliability**: No deprecated options causing service failures
|
|
✅ **Maintainability**: Clean, standardized configuration files
|
|
|
|
---
|
|
|
|
## Related Scripts
|
|
|
|
- `scripts/optimize-besu-logging.sh` - Optimize logging levels
|
|
- `scripts/cleanup-besu-deprecated-options.sh` - Remove deprecated options
|
|
|
|
---
|
|
|
|
**Status**: ✅ **COMPLETE**
|
|
**All configuration files cleaned and optimized**
|