Skip to main content

Configuring Fixed Virtual MAC in HA VIP Setup

Objective​

To configure a Fixed Virtual MAC Address in the HA VIP setup to prevent MAC move storms on network switches and ensure stable High Availability behavior between Primary and Secondary App servers.

Prerequisites​

  • Motadata AIOps HA architecture must already be configured.
  • Ensure backup of /motadata/motadata/config/motadata.json is taken on both servers.
  • Both Primary and Secondary App servers must be up and reachable.
  • Ensure no active failover activity is in progress during configuration.

Procedure​

Step 1: Stop Motadata Services (In Sequence)

Stop the Motadata service on both App servers in the following order:

  1. Secondary App Server
  2. Primary App Server

Run the following command on each server:

sudo motadata service stop
info

Ensure the service is completely stopped on the Secondary server before stopping it on the Primary server.

Step 2: Configure Fixed Virtual MAC in motadata.json

On both Primary and Secondary App servers, update the following configuration file:

/motadata/motadata/config/motadata.json

Add the below keys:

"vip.interface" : "eth0",
"vip.netmask" : "255.255.248.0",
"vip.virtual.interface" : "macvlan0",
"vip.virtual.mac.address" : "02:1A:11:00:00:01",
"virtual.network.ha.enabled" : "yes"
note

If default parameters are required, use only the key:

"virtual.network.ha.enabled" : "yes"

Use all keys only when custom interface, netmask, or MAC configuration is required.

Step 3: Start Motadata Services (In Sequence)

Start the Motadata service in the following order:

  1. Primary App Server
  2. Secondary App Server

Run the following command on each server:

sudo motadata service start

Important: Ensure the service is fully started on the Primary server before starting it on the Secondary server.

Wait until the following process is spawned on the Primary App server before proceeding:

python3 /motadata/motadata/metricagent/bootstrap.pyc

Expected Outcomes​

  • VIP is correctly assigned with a fixed virtual MAC address.
  • No MAC move storms are observed on network switches.
  • HA failover functions correctly without MAC instability.
  • All Motadata services are running properly on both Primary and Secondary servers.