Ask the Community
Groups
How to safely update the Unitrends appliance from the SSH Command Line Interface - Connect IT Community | Kaseya
<main> <article class="userContent"> <h2 data-id="issue"><strong>ISSUE</strong></h2> <p>The unitrends-cli command should be used to perform command line updates of the Unitrends appliance.</p> <h2 data-id="resolution"><strong>RESOLUTION</strong></h2> <p><br><br>Use the <strong>unitrends-cli</strong> commands performs routines before and after the software update which ensure data integrity.<br><br><em><strong>Note: </strong>Not all rpm packages are updates with every release. </em></p> <h2 data-id="tasks"><strong>TASKS</strong></h2> <p>First, enter a "screen session" to ensure that the update process is not disrupted by a communication loss with your SSH session.</p> <pre class="code codeBlock" spellcheck="false" tabindex="0">[root@UMyUnitrendsDPU ~]# <strong>screen</strong></pre> <p><br>If the session is broken, the work will continue in the background, and you can return to the process by executing the command <strong>screen -x</strong>.<br><br>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</p> <pre class="code codeBlock" spellcheck="false" tabindex="0">[root@MyUnitrendsDPU ~]# <strong>unitrends-cli post updates</strong> </pre> <p><br>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.<br> </p> <pre class="code codeBlock" spellcheck="false" tabindex="0">root@MyUnitrendsDPU ~]# <strong>rpm -qa | grep unitrends | sort</strong></pre> <p><br>Once this is all completed, by execute the following command to terminate the screen session: <strong>exit</strong><br></p> <pre class="code codeBlock" spellcheck="false" tabindex="0">root@MyUnitrendsDPU ~]# e<strong>xit</strong></pre> <p><br>You can now close the session or type and execute the exit command again and it will be done for you.<br><br>CAUTION: Please don't reboot your appliance immediately after updating it. We have some post update processes running. Wait at least 3 hours before rebooting the appliance.<br> </p> <h2 data-id="notes"><strong>NOTES</strong></h2> <p>Not all rpm packages are updates with every release. Below is an example of a successful update.</p> <p>In the example below, the Unitrends Backup Enterprise virtual appliance was updated from 10.4.3-2 to 10.4.4-3</p> <pre class="code codeBlock" spellcheck="false" tabindex="0">[root@UB107COS6 ~]# 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 } </pre> </article> </main>