BFM Setup Guide

Bidirectional Failover Manager (BFM)

Prerequisites

PostgreSQL cluster
Linux (for this guide, we focus on Rocky Linux/CentOS/RHEL)
Root or sudo privileges
Docker (optional, for containerized deployment)
Network connectivity between all nodes

Installation Process

1. Repository Setup & Installation

Linux (RockyLinux/CentOS/RHEL)

sudo dnf install -y https://nexus.bisoft.com.tr/repository/bfm-yum/repo/bisoft-repo-1.0-1.noarch.rpm

sudo dnf install -y bfm-rpm-package

sudo yum install -y https://nexus.bisoft.com.tr/repository/bfm-yum/repo/bisoft-repo-1.0-1.noarch.rpm
sudo yum install -y bfm-rpm-package

1. Source Code Deployment (Development)git clone https://github.com/bisoftbilgi/bfm.git
cd bfm

./mvnw clean package

1. Configuration Setup

Edit /etc/bfm/config/application.properties:

# Core Configuration
bfm.use-tls = false                 # Set to 'false' for testing without certificates
bfm.user-crypted = false            # Set to 'true' if using encrypted passwords
server.pgpassword = StrongPassword  # PostgreSQL password

# Network Configuration
server.port = 8080                  # Web UI and API port
bfm.vip.enabled = true              # Enable Virtual IP feature
bfm.vip.interface = eth0            # Network interface for VIP
bfm.vip.address = 192.168.1.100     # Virtual IP address

# PostgreSQL Instance Configuration
bfm.nodes[0].name = pg-node1
bfm.nodes[0].host = 192.168.1.101
bfm.nodes[0].port = 5432
bfm.nodes[0].priority = 100

bfm.nodes[1].name = pg-node2
bfm.nodes[1].host = 192.168.1.102
bfm.nodes[1].port = 5432
bfm.nodes[1].priority = 90

# High Availability Configuration
bfm.ha-mode = true                  # Enable dual BFM instances
bfm.ha-partner = 192.168.1.150      # Partner BFM address

1. Launch BFM Service

System Service (Linux)

sudo systemctl enable bfm
sudo systemctl start bfm
sudo systemctl status bfm

Docker Container

docker run -d --name bfm \
  -p 8080:8080 \
  -v /path/to/config:/etc/bfm/config \
  --restart unless-stopped \
  bfm/bfm:latest

Manual Execution

java -jar /etc/bfm/bfmwatcher/bfm-app.jar

1. Verify Installation

Check for successful startup messages:

Tomcat started on port(s): 8080 (http)
BFM is now managing PostgreSQL cluster

Access the web interface at http://[server-ip]:8080
Verify logs at:
- /var/log/bfm/bfm.log (system installation)
- Console output (manual execution)
Test command-line functionality:
```
bfm_ctl status
```

Troubleshooting

Common Issues

Issue	Resolution
Connection refused	Check firewall rules and PostgreSQL’s pg_hba.conf
Authentication failure	Verify credentials in application.properties
Service won’t start	Check logs for missing dependencies or permission errors