error: can't find command 'blscfg'.

Products

Messaging Gateway

Issue/Introduction

You have attempted to upgrade to 10.9.1 but the following error appears after reboot and the system will not fully boot up:

error: file '/grub2/i386-pc/increment.mod' not found.
error: can't find command 'blscfg'.

Cause

This occurs for appliances that were originally installed with version 10.7.4 or previous and have been upgraded over time. The older appliances have smaller boot partitions that are not large enough for the installations of current appliance updates. Please note that this is specifically related to the boot partition and not the general system partitions.

Resolution

If the appliance receives the grub boot error, it is not possible to recover directly from that state. If the appliance is on a virtualization platform and a snapshot was taken prior to upgrade, you can revert the snapshot to recover back to the prior version.

To resolve this issue for future upgrade attempts, if you have not encountered the issue yet and are preparing to update an appliance originally installed prior to version 10.7.5 or you can revert the appliance after encountering the issue, you will need to take a full backup of the appliance, and a backup of the Message Audit Logs if wanted. You can also use a full backup that was previously created if you cannot create a new backup.

Reinstall the appliance to the version that matches the backup using an installation .iso image and restore the backup prior to upgrade. The installation from .iso image will correct the boot partition size. Once the appliance is been restored from backup, you will be able to perform the upgrade.

Control Centers hosts

Scanner only hosts

Scanners do not require backup or restore unless you want to preserve audit log data

Download the SMG 10.9.0 ISO from the Broadcom Support portal
Install Messaging Gateway 10.9.0 from ISO into a new virtual machine
(optional) Back up audit log data from the old 10.9.0 scanner using the command line mallog command
(optional) Restore audit log data to the new 10.9.0 scanner
Delete the old scanner entry from Administration > Configuration in the new Control Center VM
Add the new scanner to the new Control Center via the Administration > Configuration > Add Scanner wizard

Once all SMG virtual machines have been reinstalled and the new scanners have been added to the new Control Center, all SMG system may be safely updated to 10.9.1 by using the command line update install command (10.9.1 upgrade must be done by the command line).