d-bis/proxmox
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
4eead3e53fecdb2b7e629bb9f56b22ff92c61d2e
proxmox/docs/04-configuration/BESU_CONFIG_CLEANUP_COMPLETE.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
Details
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates 
- 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>
2026-02-12 15:46:57 -08:00

6.3 KiB
Raw Blame History

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

# 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

Reference in New Issue View Git Blame Copy Permalink