failed to connect to server: connection refused

# 1. Verify server is running
sudo systemctl status backup-server
ps aux | grep "xreplicator server"
 
# 2. Check agent config matches server address
# storage.grpc.server_address: "192.168.1.100:50051"
 
# 3. Test connectivity
telnet 192.168.1.100 50051
nc -zv 192.168.1.100 50051
 
# 4. Open firewall port
sudo ufw allow 50051
# or
sudo firewall-cmd --add-port=50051/tcp --permanent
sudo firewall-cmd --reload

FATAL: License validation failed

# Check license file exists
ls -la /var/lib/backup/repo/license.json
 
# Verify hostname matches
hostname
 
# Inspect license content
cat /var/lib/backup/repo/license.json | jq .
 
# Check environment for public key
echo $LICENSE_PUBLIC_KEY

# Check throughput in logs
sudo journalctl -u backup-agent | grep "Throughput"
 
# Test raw network bandwidth
iperf3 -c backup-server-ip

# Increase batch size and workers
daemon:
  pipeline:
    batch_size: 400
    workers: 8
  compression:
    level: 1   # Fastest compression

daemon:
  pipeline:
    batch_size: 100
    max_pipeline_memory_mb: 1024
    max_io_queue_depth: 5
    channel_buffer_mult: 2
    workers: 2

snapshot not found: <id>

# List available snapshots
xreplicator snapshots --server localhost:50051
 
# Check snapshot directory
ls -la /var/lib/backup/repo/snapshots/
 
# Retrieve specific snapshot
xreplicator snapshots --server localhost:50051 --id <snapshot-id>

sudo systemctl status backup-agent
sudo systemctl status backup-server

# Windows agent service
Get-Service XReplicatorAgent

# Individual services
sudo journalctl -u backup-agent -f
sudo journalctl -u backup-server -f
 
# All backup services at once
sudo journalctl -u backup-* -f

# WinSW logs
Get-Content "C:\ProgramData\xreplicator\logs\XReplicatorAgent.err.log" -Tail 200
Get-Content "C:\ProgramData\xreplicator\logs\XReplicatorAgent.out.log" -Tail 200

# Basic TCP test
telnet backup-server-ip 50051
 
# gRPC reflection (if enabled)
grpcurl -plaintext backup-server-ip:50051 list

# CPU and memory
top | grep xreplicator
 
# Disk I/O
iotop | grep xreplicator
 
# Network
nethogs

cat /etc/xreplicator/agent.yaml
yamllint /etc/xreplicator/agent.yaml

daemon:
  pipeline:
    batch_size: 400
    workers: 8
  compression:
    enabled: true
    level: 1

daemon:
  pipeline:
    batch_size: 20
    workers: 2
  compression:
    enabled: true
    level: 3

daemon:
  pipeline:
    max_io_queue_depth: 3
    channel_buffer_mult: 2
    max_pipeline_memory_mb: 1024
    workers: 2
    fixed_block_size_mb: 8
  compression:
    enabled: true
    level: 1

daemon:
  pipeline:
    max_io_queue_depth: 20
    channel_buffer_mult: 8
    max_pipeline_memory_mb: 4096
    workers: 8
    fixed_block_size_mb: 16
  compression:
    enabled: true
    level: 1