How to safely update the Unitrends appliance from the SSH Command Line Interface

ISSUE

The unitrends-cli command should be used to perform command line updates of the Unitrends appliance.

RESOLUTION



Use the unitrends-cli commands performs routines before and after the software update which ensure data integrity.

Note: Not all rpm packages are updates with every release. 

TASKS

First, enter a "screen session" to ensure that the update process is not disrupted by a communication loss with your SSH session.

[[email protected] ~]# screen

If the session is broken, the work will continue in the background, and you can return to the process by executing the command screen -x.

Now, it is safe to run the next command, which begins the update process. There are no updates during the proceedure, but at the end it will provide an output of the results. You will now execute the command unitrends-cli post updates
[[email protected] ~]# unitrends-cli post updates

To confirm the update was successful, review the unitrends rpms using the command below. Confirm that the unitrends-rr package is running the latest software version.
 
[email protected] ~]# rpm -qa | grep unitrends | sort

Once this is all completed, by execute the following command to terminate the screen session: exit
​​​​​​
[email protected] ~]# exit

You can now close the session or type and execute the exit command again and it will be done for you.


 

NOTES

Not all rpm packages are updates with every release. Below is an example of a successful update.

In the example below, the Unitrends Backup Enterprise virtual appliance was updated from 10.4.3-2 to 10.4.4-3

[[email protected] ~]# unitrends-cli post updates
{
    "result": [
        {
            "message": "<pre>Status of specified packages:\nInstalled: unitrends-ui-10.4.4-1.202004162020.CentOS6.noarch\nInstalled: unitrends-monitoring-10.4.4-3.202004291840.CentOS6.noarch\nInstalled: unitrends-elk-10.4.4-1.202004162019.CentOS6.x86_64\nInstalled: xg-portal-client-3.0.2-1.202004132046.CentOS6.noarch\nInstalled: unitrends-rr-windowmgr-10.4.4-3.202004291840.CentOS6.x86_64\nInstalled: unitrends-snmp-10.4.4-3.202004291840.CentOS6.x86_64\nInstalled: unitrends-agentpush-win32-10.4.4-3.202004291838.CentOS6.noarch\nInstalled: winexe11-1.1-6.el6.x86_64\nInstalled: unitrends-cloudhook-10.4.4-3.202004291840.CentOS6.x86_64\nInstalled: unitrends-common-10.4.4-3.202004291840.CentOS6.x86_64\nInstalled: unitrends-aprotect-10.4.4-3.202004291840.CentOS6.x86_64\nInstalled: unitrends-ipmi-10.4.4-3.202004291840.CentOS6.x86_64\nInstalled: unitrends-ndmp-10.4.4-3.202004291840.CentOS6.x86_64\nInstalled: unitrends-vprotect-10.4.4-3.202004291840.CentOS6.x86_64\nInstalled: unitrends-doc-10.4.4-2.202004140830.noarch\nInstalled: unitrends-security-10.4.4-3.202004291840.CentOS6.x86_64\nInstalled: unitrends-winbm-10.4.4-3.202004291838.CentOS6.noarch\nInstalled: unitrends-config-vm-2.0.2-0.noarch\nInstalled: unitrends-rr-10.4.4-3.202004291840.CentOS6.x86_64\nInstalled: unitrends-agentpush-win64-10.4.4-3.202004291838.CentOS6.noarch\nInstalled: unitrends-repqueuer-10.4.4-1.202004161929.CentOS6.x86_64\nInstalled: unitrends-agentpush-winBM-10.4.4-3.202004291838.CentOS6.noarch\nInstalled: unitrends-xprotect-10.4.4-3.202004291840.CentOS6.x86_64\n</pre>"
        }
    ],
    "timestamp": 1588765625
}

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Contact us