InstantVoice HA is the solution to provide high availability of InstantVoice
services. With this module the system is able to check services and perform
actions to handle errors, restarting or even switching the services to another
server, keeping it available.
Configuration
Note
At least two servers with two network interfaces
each one are needed, one acting as active(or primary) and other acting as
passive(or secondary) server. The second interface of both servers must be
connected directly with a crossover cable.
Primary Server
The HA configuration is very simple, after have configured one server, access
the InstantVoice web interface and login as ‘localadmin’. This server will be configured as
primary(active) server.
Click on menu ‘HA’ and after ‘Configuration’.
Now fill all form as presented bellow
Identify this server as primary server.
Select ‘eth0’, this interface should be configured with the network IP.
Select the interface connected through crossover cable. Do not configure IP address for this interface.
Enter the hostname of the secondary server.
Mirror hostname: iv-instant-dac-02
Enter the IP address of the secondary server.
Mirror IP Address: 192.168.0.2
Enter the float IP shared between these servers. This IP will be used to access the active server.
The IP address of three equipments in the same network, used to check if the network connection is up and reliable. The IP address of these equipments have to be always reachable.
Reference IP address: 192.168.0.10 192.168.0.15 192.168.0.20
All traps will be sent to this IP address
Trap Server IP: 192.168.0.200
The username to auth on the trap server
Click on ‘Save and activate HA’
Secondary Server
Access the web interface of this server and login as ‘localadmin’.
First you have to configure the network of this server.
After that, click on ‘HA’ and then ‘Configuration’
Now fill all form as presented bellow.
Identify this server as secondary server.
Type: HA Secondary Server
Select eth0, this interface should be configured with the network IP.
Select the interface connected through crossover cable. Do not configure IP address for this interface.
Enter the hostname of the primary server.
Mirror hostname: iv-instant-dac-01
Enter the IP address of the primary server.
Mirror IP Address: 192.168.0.1
Enter the float IP shared between these servers. This IP will be used to access the active server.
The IP address of three equipments in the same network, used to check if the network connection is up and reliable. The IP address of these equipments have to be always reachable.
Reference IP address: 192.168.0.10 192.168.0.15 192.168.0.20
All traps will be sent to this IP address
Trap Server IP: 192.168.0.200
The username to auth on the trap server
Click on ‘Save and activate HA’
Management
First click on ‘HA’ and then ‘Management’. This page presents the system
status, allowing identify where the services are running and what services are on fail.
This page also allows recovery a server after a failure, activate secondary
server to maintenance purpose or just restart all services.
Checking The System Status
Access the webinterface of the primary server and login as ‘localadmin’.
Access ‘HA’ and then ‘Management’
Check if services are up(green) on both servers
Services that are stopped will appear red.
Server Switch
Sometimes could be necessary power off the primary server to do maintenance.
The services can be migrated to the secondary server using the button ‘Active
Server 2’.
Service Restart
If a problem happen when starting services, and the other server is already
on fail, could be necessary restart all services to the system come back to the
availiable state. It can be done clicking on ‘Restart Services’.
Server Recovery
After a disaster, to recover the primary server, the server must be installed
and with HA configured as presented before. Then just click on ‘’Recover and Activate Server 1’.
All data will be resynchronized and services moved to the primary server.
Command Line Utilities
There are some scripts to help on HA configuration and management. These
scripts are used by the web interface too.
This script is used to configure the InstantVoice HA module.
This script is used to stop and start HA service. Don’t use heartbeat scripts directly.
/etc/init.d/instantvoice-ha
This script is used to manage services monitored by HA. All services must be started/stopped by this
script instead of your own /etc/init.d/ scripts.
/etc/init.d/instantvoice-ha-service
