Synchronous Upgrade of Two Appliances in a Failover Relationship
With synchronous updating, the primary appliance is updated first and maintains its role as primary. This method does involve some downtime; it is recommended for simple deployments and scenarios that will not suffer from being offline during the update.
Bomgar recommends performing upgrades during scheduled maintenance windows. Your Bomgar site will be temporarily unavailable during the upgrade. All logged in users and active sessions will be terminated. You will need to schedule two separate maintenance windows in which to complete the upgrade. Installation usually takes between 15 minutes to an hour. However, if you are storing a large amount of data on your appliance (e.g., session recordings), the installation could take significantly longer. Plan an interim period between the two maintenance windows adequate enough to confirm the new software version in your production environment but brief enough to minimize the exposure of temporarily not having a failover configuration. Bomgar also recommends testing the update in a controlled environment prior to deploying into production. If you experience any issues during the Base update, do not restart the Bomgar Appliance. Please contact Bomgar Technical Support.
In these instructions, Appliance A is the primary appliance (i.e., the appliance to which the primary hostname resolves), while Appliance B is the backup appliance.
Backup and Sync
Prior to upgrading, make a backup of your current Bomgar software settings. On Appliance A, go to /login > Management > Software Management.
Click the Download Backup button, and save the backup file to a secure location.
Go to /login > Management > Failover, click Sync Now, and wait for synchronization to complete.
Once synchronization has finished, click Break Failover Relationships.
Update Appliance A
Update Appliance A using either the automatic or the manual update method.
In most cases, Bomgar customers can download and install updates with no assistance from Bomgar Technical Support. To see if an upgrade is available, go to /appliance > Updates.
Click on Check for updates.
If a software update is available, it will appear under Available Updates. Once you click Install This Update, the appliance will download and automatically install the new version of the Bomgar software.
Note: Some packages require another package to be installed first. Install the available package to enable the dependent one.
If automatic updates fail when expected to work, please review the Check for Updates troubleshooting FAQ at www.bomgar.com/help/SolutionFAQ.aspx?id=377.
If you are unable to use automatic updates (e.g., if your appliance exists on a restricted network), you may perform manual updates.
Go to /appliance > Updates.
From the Updates page, browse to the file from the Manual Installation section and then click the Update Software button to complete the installation. The appliance will install the new version of the Bomgar software.
Note: Be prepared to install software updates directly after download. Once an update has been downloaded, it no longer appears in your list of available updates. Should you need to re-download an update, contact Bomgar Technical Support.
Verify and Test
After completing the upgrade process, verify that the update completed successfully and that your software is working as expected.
Update Appliance B
Update Appliance B using either the automatic or the manual update method as defined above. Then verify and test that the update completed successfully.
Reestablish Failover Relationship
From Appliance A, go to /login > Management > Failover.
Note: To configure a valid connection, both appliances must have identical Inter-Appliance keys. See the /login > Management > Security page to verify the key for each appliance.
Reestablish the failover relationship with the backup appliance, using Appliance B as the backup and keeping Appliance A as the primary.
Establishing the relationship between the two appliances occurs on the Failover page of the appliance intended to be the primary appliance. The addresses that are entered here will establish the relationship and allow either appliance to connect to each other at any time. The fields on this page called New Backup Site Connection Details tell the primary appliance how to connect to the appliance that will become the backup appliance. The fields called Reverse Connection Details to this Primary Site will be given to the backup appliance and tell it how to connect back to this primary appliance. You must use a valid hostname or IP address and the TLS port number for these fields. When all of these fields are set, click the Establish Relationship button to attempt to establish the relationship.
Note: Whenever possible, Bomgar recommends using the unique IP address of each appliance when configuring these settings.
Once the relationship has been established, extraneous tabs will be removed from the backup site. It takes about 60 seconds for the first data synchronization to initiate, but you may also click the Sync Now button to force synchronization and pull the most current information from the primary appliance into the memory of the backup appliance. Synchronization itself may take anywhere from a few seconds to a few hours, depending on the amount of data that needs to be synchronized. The Failover page will list the last date and time of data synchronization when synchronization is completed.