📋 Post-Installation Management Guide
Validator Operations: Comprehensive post-installation tips for professional validator node management and optimization.
⚙️ Update Validator Information
Configuration Flexibility: Modify validator settings using the same command structure as create-validator, specifying only the fields requiring updates.
📝 edit-validator Command
Command Structure: Use the same format as your create-validator command, but replace create-validator with edit-validator:
🎯 Selective Updates: Send edit-validator commands with only the specific fields requiring modification.
🔧 Required Parameters
Mandatory Fields: Always include these parameters with any configuration change:
🌐 --node - Shard 0 endpoint for all validator updates
⚙️ staking edit-validator - Blockchain command identifier
📍 --validator-addr - Your validator address
🔐 --passphrase - Wallet authentication (or --passphrase-file passphrase.txt)
⛽ --gas-price 100 - Minimum transaction gas requirement
📋 Configurable Options
Customization Parameters: Available fields for validator configuration updates:
🔐 bls-pubkeys - BLS public key management (minimum 1 key required)
📛 name - Validator display name on staking page
🖼️ identity - Keybase.io logo identifier (setup guide (opens in a new tab))
📝 details - Validator description on staking page
📧 security-contact - Administrator email for network updates
🌐 website - Official website or social media link
💰 rate - Commission fee percentage
📊 max-total-delegation - Maximum ONE delegation per wallet
💎 min-self-delegation - Minimum self-stake (10,000 ONE minimum)
Immutable Settings: max-change-rate and max-rate cannot be modified after validator creation.
🔧 Harmony Application Troubleshooting
Systematic Debugging: Follow this structured approach for comprehensive error diagnosis:
🛑 Step 1: Stop Service
sudo service harmony stop🔍 Step 2: Manual Execution
Debug Mode: Run harmony manually to bypass service restrictions and access detailed error messages:
cd ~/harmony
./harmony -c harmony.conf💬 Step 3: Error Analysis
Community Support: Analyze error messages and seek solutions in our Discord Chat (opens in a new tab) for expert assistance.
🧰 Validator Toolbox Troubleshooting
Reset Capability: Easily restart toolbox configuration by removing environment file and re-executing setup script.
🔄 Reset Command: Remove ~/.easynode.env and rerun installation script to trigger fresh setup.
🐛 Issue Reporting: Log bugs and issues on our GitHub repository (opens in a new tab).
⚠️ Common Installation Issues
Timing Consideration: Allow user data setup completion before running installer. If installation fails, wait momentarily and re-execute the pip3 command.
📦 Requirements Missing
Dependency Error: Missing pip3 installation or failed execution. Retry the pip3 command.
🔐 Sudoless Root Configuration
Privilege Issue: Installation freeze indicates improper sudoless root setup. Enter user password to continue or revisit Server Prep section.
🐍 Module Import Error
Quick Resolution: Common on DigitalOcean or when skipping toolbox requirements installation.
Error Pattern:
ModuleNotFoundError: No module named 'xxxxxxxxxx'🔧 Solution:
cd ~/harmony-toolbox
pip3 install -r requirements.txt💰 Rewards System Guide
Reward Structure: Comprehensive information for both validators and delegators on earning and claiming rewards.
🎯 Delegator Rewards
Timeline: Rewards begin in real-time at the next epoch after delegation activation.
✅ Real-time Earning - Rewards accrue with each new epoch
💎 Flexible Claiming - Withdraw rewards at any time
📈 Compound Capability - Reinvest rewards (minimum 1,000 ONE to delegate)
🏆 Validator Rewards
Fee Structure: Validator fees are automatically deducted from delegator rewards and included in your claimable balance.
💹 Variable Earning - Rewards correlate with total ONE staked
💻 Entry-Level Viability - Single-key validators typically earn enough to cover monthly server costs
📊 Node Monitoring Guide
Essential Monitoring: Basic monitoring strategies for new validators - minimal oversight required when systems operate correctly.
🧰 Validator Toolbox Monitoring
Built-in Statistics: Use menu option #1 for comprehensive server statistics. Manual users can implement our python stats script for sync status monitoring.
🛠️ Administrative Tools
Resource Reference: Comprehensive monitoring tools available in our Admin Tools section.
🎯 BINGO Verification
Sync Confirmation: The community-standard "BINGO" command verifies node synchronization by monitoring block signatures. Note: Only visible when validator is elected.
tail -f latest/zerolog-harmony.log | grep BINGO🖥️ SSH Multi-Connection Setup
Professional Monitoring: Multi-pane SSH configuration for comprehensive node oversight using MobaXterm's split-screen functionality.
📊 Resource Monitoring: Run htop in upper pane to track system resources
- ⚠️ CPU Usage: Restart harmony service when load average exceeds 1.0 sustained
- 📈 Optimal Range: AMD systems typically maintain 0.30-0.50 load average
💻 Command Terminal: Lower pane for operational tasks:
- Easy Node stats script execution
- BINGO log verification
- Edit-validator commands (opens in a new tab) for key management
- Additional validator operations (refer to official guide (opens in a new tab))
📈 Advanced Monitoring Solutions
Future Enhancement: Prometheus, Grafana, and advanced monitoring solutions available for operators requiring detailed node statistics. Documentation may be added for larger deployments.
Linux Operating System Updates
You can run Linux OS upgrades from time to time when restarting your node. If you'd like you can also reboot at that point and wait for syncing to come back online before doing the same on your 2nd node.
To run linux updates without rebooting on Ubuntu 20.04 LTS run the following:
sudo apt-get update && sudo apt-get upgrade -yI use a Mac to connect!
You can do this with 4 terminal windows. I'm sure there's applications out there for Mac that do the same but I would just use the terminal myself.
"Backup" Node
Our notes on running a 2nd server for redundancy
⚠️ Backup Server Considerations
Deprecated Practice: Harmony no longer recommends backup nodes. Discontinue duplicate node operations - this practice will be disallowed soon.
🔄 Legacy Backup Setup
Not Recommended: For operators who proceed despite official deprecation:
🔑 Configuration Requirements:
- Import existing wallet (do not create new)
- Copy
.keyand.passfiles to~/harmony/.hmy/blskeysfolder
🔄 Shard Migration Guide
Advanced Operation: Shard migration requires extensive previous knowledge and careful execution timing.
📋 Migration Process
Coordination Requirements: Systematic approach for epoch-based shard transitions:
🏗️ Preparation Phase:
- Deploy new shard server with fresh .key/.pass files
- Achieve full database synchronization
⚡ Transition Phase:
- Add new shard keys via
edit-validatorcommands - Remove old shard keys from blockchain
- Maintain both servers online during epoch election
🎯 Completion Phase:
- Monitor election results and signing transitions
- Retire old server after final epoch signatures
- Confirm new server assumes signing responsibilities
🤖 Telegram Notification Bots
Essential Monitoring: Professional validator management through automated telegram notifications.
📊 vStats Bot
Comprehensive Monitoring: Created by Fortune.ONE Validator (opens in a new tab) for professional validator issue notifications and portfolio tracking.
🚀 Setup: Message @vstatsbot (opens in a new tab) and type /start
✨ Features:
- Real-time validator issue alerts
- Delegation summaries (including MetaMask)
- Multi-wallet balance monitoring
- Multi-validator portfolio tracking
📱 Harmony Analytics Bot
Epoch Timing: Excellent for epoch transition notifications and wallet/validator change alerts.
🎯 Purpose: Use Harmony Analytics Bot (opens in a new tab) for wallet and validator change notifications, particularly epoch timing alerts.
To pull up the menu send
/menu
To set your favorite wallets add, mutliples separate with a comma no spaces
/setaddress <one wallet address>
To set your validator address
/setfav <one validator wallet address>
Robovalidator Autobidder
Automatically bid for slots
Robovalidator (opens in a new tab) has an autobidder application. You'll find the github on this page (opens in a new tab). The setup instructions are included in the readme.md file in the repository.
Installation
The autobidder can be run with the configuration as is on any Shard 0 node along side your ~/harmony folder. You will always get the best response running autobidder on a Shard 0 node.
If you're not running it on a Shard 0 node (it can be run anywhere hmy is installed in ~/harmony/) you just need to set the following to True so your node will send requests to the blockchain and depending on traffic may need to increase your gas.
USE_REMOTE_NODE = True
Control and operation
If you're having troubles launching autobidder and it's failing for the password, try using an empty ~/harmony/passphrase.txt file and see if you get a different result.
We use VS Code with Remote SSH to manage the files, see our Admin Tools post from earlier on that application.
Autobidder Support
I don't provide support for this application, join the harmony staking telegram chat (opens in a new tab) if you have questions.