SUMMARY
How to upgrade the appliance via Unitrends' media (AirGap / Offline updates)
ISSUE
The Unitrends system is unable to access the Unitrends software update repository, and therefore an offline update is required. The upgrade must be applied via local media (DVD, USB, or Samba share). This process is commonly used in Airgap environments.
RESOLUTION
STEP 1: Verify that your RecoveryOS software is not on legacy processes such as DedupNT as per KB 5587 (applies to systems on release prior to 10.1.0 only). Note for systems on current release prior to 10.2.0, see this KB as well
STEP 2: Download the upgrade script and the ISO files. The Upgrade script must be located in the path of /root/. It is recommended that you use the samba option and that the ISO is located in the path of /backups/samba/. If you choose to use the USB option, it is recommended to use an older USB2 flash thumb drive between 4GB and 16GB in size and insert it into the older (black, usually near keyboard) usb port.
The upgrade script will handle all procedures necessary to upgrade the system from one software release to the next. The procedures include; mounting the upgrade media, performing the upgrade, ejecting the upgrade media if applicable (e.g DVD media), and finally rebooting the system.
- Download the correct disk ISO to upgrade to. Copy this file to the appliance /samba share, or, burn the image to a DVD or USB stick using Rufus or similar ISO burner.
Release 10.8.5 for CentOS7 upgradeDVD (md5)
Release 10.8.5 for CentOS6 upgradeDVD (md5)
Need an older version? See: How can I find air gap update media for an older release?
Alternatively, access the appliance using Putty and download the .iso directly to the appliance using the wget command.
Example:
wget https://factoryupdate.s3.amazonaws.com/CentOS7/ROS1083U.el7.x86_64-080524_0822.iso
- Update: New Script updated for 10.6.1+ editions:
Download the upgradeRelease.sh script by RIGHT CLICKING and selecting "save link as". Attempts to download otherwise may corrupt linux carriage returns in this file. The + sign indicates it is usable to upgrade from release 9.1 to the current release.
- upgradeRelease_9.1+.sh <- Right click and 'Save link as' to download the applicable script.
- Save this script to a USB drive or accessible network share. From your appliance, copy the script to the /root directory on your appliance. You can access your appliance through SSH using a console emulator such as PuTTY to run the commands from this KB. Alternatively, you may use WinSCP to leverage a GUI to easily copy the file to the root directory in your appliance. Enter the IP address of your appliance and connect via port 22 for SSH, login as "root" without the quotes and use the same password you use to shutdown or restart your appliance. Note the SSH/OS root password does not mirror the UI user root password and is typically difference.
- Enter the following command to make the 9.1 script executable.
chmod +x /root/upgradeRelease_9.1+.sh - Run the update script to begin the update process.
The command below expects the ISO media to be in the /backups/samba directory. If the ISO media is on a USB or Optical media, substitute -samba for -usb or -dvd respectively (see NOTES below for more details.)/root/upgradeRelease_9.1+.sh -sambaIMPORTANT: If running the ./upgradeRelease script returns an error from the /backups/samba directory, move the script to /root (execute the command: mv upgradeRelease_9.1+.sh /root) and run the script from within root.
-
Once the update has completed, you will see the following output:
Please reboot the system for the upgrade to take effect
Please restart the Unitrends appliance using one of the following two methods presented in the how to Shutdown or restart a Unitrends appliance.
Once the upgrade is complete, any mounted upgrade media will be unmounted from the system and a message regarding rebooting the system will appear. At this time the upgrade media can be removed and the system rebooted.
NOTES
All Procedures must be performed from the Linux OS Command Line.
The upgrade media cannot be used to re-image the Appliance to factory defaults.
Functionality, usage, and expected behavior of the update is explained in the media process and update script:
The upgradeRelease_8.1.sh script and upgradeRelease_9.1+.sh adds a -usb option, and the script no longer has a default run option. Script requires one of three options to be passed:
-dvd (for older systems with internal optical reader)-
-samba (recommended) -usb
The option will dictate which update process the script will use. Expected behavior per media is as follows:
DVD
A DVD created from the ISO download must be used. The DVD may be created using traditional ISO-to-DVD burning methods, ensuring the ISO is extracted and the file/directory structure preserved. Please be advised that this method is not available when updating with upgradeRelease_9.1+.sh
SAMBA
The single ISO file must be placed in the root level of the samba share, if other ISO files exist on samba share delete or move older files. To access the samba share of your appliance you can open Windows Explorer and navigate to the IP address of your Unitrends appliance, open the samba directory and copy the upgrade DVD to this location. The ISO file will then be mounted to the cdrecorder1 directory and the upgrade process will proceed.
USB
The ISO image must be extracted to the USB device. Third party software such as ImageUSB may be used. Once the USB has been created successfully, the -usb flag will perform the auto detection of the USB and mount the USB device appropriately. The update operations will then be performed.
Summary Expectations
-1- " upgradeRelease_x.x+.sh" must be installed & executable from "root" or a "Permission denied" may prevent you from updating.
-2.a- .ios is intended to be placed in following locations related the instructions you chose above.
-dvd-samba-usb
-2.b- ./upgradeRelease_x.x+.sh - (location above) command is ran from "root" is intended to run the update and will show "Starting Update..."
It will stay on this frame for the duration of the installation, verification, and cleanup which can take anywhere from 20 min to 90 minutes depending on system, performance, and amount of data it to manage. If it finds errors, it may take longer to test and resolve those, before a final output is provided.
-3- Once the update has completed, you will see the following output:
Please reboot the system for the upgrade to take effect
Please restart the Unitrends appliance using one of the following two methods presented in the how to Shutdown or restart a Unitrends appliance.