This information applies to versions 14.x and lower

Introduction

This guide will walk you through the process of setting up a warm spare server.

You will need 2 PBX servers of the same model with identical hardware including analog and digital cards.

This article assumes the following:

Setup

SSH Keys

First we will set up share keys between the two servers so they can communicate across SSH on port 22.

Begin by creating a user and an SSH key on your warm standby server so that it can log in to the primary production server and transfer backups to itself.

Login to your backup server with an SSH client such as PuTTy, SecureCRT, or other SSH client.

At the prompt type:  sudo -u asterisk ssh-keygen

You will be asked 3 questions. Simply press "Enter" to accept the defaults.

Next we will copy the key to the primary server so that the backup server can SSH to the primary server without needing a password. Issue the command. 

At the prompt type: sudo -u asterisk ssh-copy-id -i  /home/asterisk/.ssh/id_rsa.pub root@PrimaryServerIP and enter the password when prompted. 

Make sure you replace the PrimaryServerIP with the IP Address of your primary PBX. (use IP and not a hostname that may be common to both primary and warmspare)

If this command completes without error, you are ready to test:

At the prompt type: ssh -i /home/asterisk/.ssh/id_rsa root@PrimaryServerIP

If all went well, you should now be logged in to the Primary server.

Creating the Backup Job

Now we will log into the warm spare's administration GUI.

Replace IPADDRESS with the actual IP address of your warm spare. This assumes you are on standard port 80. If you are using a different port or https, please adjust accordingly.

Once Logged in:

You should now see the following:

We will now define the primary PBX as a new server for this warm spare server to reach into and perform the backup on.

Click on the Servers option on the right side. It will bring up a page like this:

Click on the Add Server button.

Select the New SSH server option from the drop down menu.
 

 

You will be taken to a form where you can enter information on where and how to connect to the primary PBX in order to get the backup data.

We are going to define the following fields for this server:

Click the Save button. Note: there is no apply config button.

Now that we have set up the primary server location information in the backup module, we will create an actual backup job by clicking on the Backups option on the right side of the screen. This brings us back to the landing screen.

Click on the New Backup button.

This will take you to a form where you can enter information about a new backup job as described below.

Click the Save button when done.

Running the Backup Job Manually

After saving, if not already back on the main page, click Backups in the menu at the right side of the screen. This will take you back to the main page.

To run the backup job and test all the settings, click the run button  for the backup. The backup job may take a while.

Failing Over to the Backup Server

In the event that you would like to make your backup server become the production server, you would need to perform a few tasks.

Network

You need to update the IP Address of the backup box to be the (current) Primary PBX's IP Address so the phones and trunks know how to register to it.

Log into the web UI of the warm spare and go to Admin → System Admin.

You should see the page below:

On the right, click Network Settings. You will then see the following:

From here, you can change the IP address of the backup server to be the same IP that your production server was.

Don't forget to remove the production server from the network before changing the IP address here, or you will have an IP address conflict.