Ask the Community
Groups
Linux Client / Agent - Connect IT Community | Kaseya
<main> <article class="userContent"> <h2 data-id="summary"><strong>SUMMARY</strong></h2> <p>Linux Client / Agent</p> <h2 data-id="issue"><strong>ISSUE</strong></h2> <p> </p> <p><strong><em>Note: <u>The instructions in this article are for agent versions earlier than 7.4.</u> Installer enhancements included in the 7.4 release greatly simplify the installation process by reducing the need to locate dependencies. The 7.4 agent is available in 32- and 64-bit versions. For details, see <a href="/home/leaving?allowTrusted=1&target=http%3A%2F%2Fwww.unitrends.com%2Fdocuments%2Frs-ueb-admin-guide%2FDefault.htm%23cshid%3D1273" rel="noopener nofollow">Installing and updating the Linux agent</a>.</em></strong></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;"><span style="font-size: large;"><strong>Purpose</strong></span> </span></span><br><br><span style="font-family: DejaVu;"><span style="font-size: small;">Add a Linux backup client to the Unitrends backup system.</span></span><br> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;"><span style="font-size: large;"><strong>Description</strong></span> </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">Add protection for a Linux client to the Unitrends backup system by installing </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">the Linux backup agent and required dependencies on the Linux client system, </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">and registering that client with the Unitrends appliance. </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;"><span style="font-size: large;"><strong>Cause</strong></span> </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">The Unitrends Linux backup agent and its required dependencies must be installed on the Linux client system, and the </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">Linux client system must be registered with the Unitrends backup appliance. </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;"><span style="font-size: small;"><strong>Dependencies</strong></span> </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;"><strong>Xinetd</strong> </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">The internet super server, xinetd, is required by the Unitrends Linux backup </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">agent. Many Linux distributions do not install xinetd by default. </span></span></p> <p> </p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">32-bit Shared Libraries </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">The Unitrends agent also requires certain 32-bit shared libraries to complete installation and execute properly. </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">Many 64-bit Linux installations do not, by default, include these libraries. Some minimal 32-bit installations may also </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">be missing some of these libraries. </span></span></p> <p> </p> <p> </p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;"><span style="font-size: large;"><strong>Resolution</strong></span> </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">Note: All commands detailed in this document should be executed as the root, </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">or super user. </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;"><span style="font-size: small;"><strong>Install Required Dependencies</strong></span> </span></span></p> <p> </p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;"><strong>Redhat based distributions</strong> </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">On Redhat based systems, such as RHEL, CentOS, Scientific Linux, etc., do </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">yum -y install xinetd </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">chkconfig xinetd on </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">service xinetd start </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">yum -y install libattr.i686 libcom_err.i686 krb5-devel.i686 libmenu.i686 ncurses-libs.i686 zlib-devel.i686 libxml2.i686 </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">To locate a package which contains a missing library/file, execute the following command: </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">yum provides */libraryname </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;"><strong>Debian based distributions</strong> </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">On Debian based systems, such as Debian, Ubuntu, Linux Mint, etc., do </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">apt-get install xinetd </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">apt-get install ia32-libs </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">If ia32-libs responds unable to install, you may need to enable 32bit platform support:</span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">dpkg --add-architecture i386<br>apt-get update<br>apt-get install ia32-libs</span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">May also require in some cases:</span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">apt-get install cifs-utils<br>apt-get install lib32ncurses5</span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">To locate any additional packages the installer requests dependencies be met for which contains a missing library/file, execute the following command: </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">apt-get install apt-file </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">apt-file update </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">apt-file search libraryname </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;"><strong>SUSE based distributions</strong> </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">NOTE: libkeyutils1 is missing from SLES 10 and cannot run the latest Linux agent.<br><br>The 4.1.2 agent must be used instead and can be downloaded here: <a href="/home/leaving?allowTrusted=1&target=ftp%3A%2F%2Fftp.unitrends.com%2Fbp%2F4.1.2%2FOES%2Foes_cnt">ftp://ftp.unitrends.com/bp/4.1.2/OES/oes_cnt</a><br><br>On Novell based systems, such as OES, and OpenSuSE, do</span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">zypper install xinetd </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">zypper install -y libattr1-32bit libcom_err2-32bit krb5-32bit libxml2-32bit zlib-32bit</span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">To locate a package which contains a missing library/file, execute the following command: </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">zypper what-provides libraryname<br><br>If zypper is not found, you may install the packages via yast2.<br><br>yast2 -i package_name <br><br>You may search for a package with yast2 by entering the yast2 menu:<br>yast2 --ncurses<br>Within this menu, select Software, then Software Management. From here you may search for, and install packages. </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">Note: </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">On some 64-bit systems, such as RHEL 6, 64-bit and 32-bit package version numbers may differ. </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">This will cause a conflict when installing the 32-bit package. The quickest solution is to downgrade the 64-bit </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">package so that the installed version coincides with that of the 32-bit package. Another possible solution </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">would be to obtain the latest stable source RPM from Redhat's website and build 32-bit and 64-bit rpms. </span></span></p> <p> </p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;"><span style="font-size: small;"><strong>Download the Backup Agent</strong></span> </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">Download the current Linux agent installer from </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;"><a href="/home/leaving?allowTrusted=1&target=http%3A%2F%2Fftp.unitrends.com%2Fbp%2Flatest_build%2FLinux%2Flnx32_cnt.run">http://ftp.unitrends.com/bp/latest_build/Linux/lnx32_cnt.run</a> </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">If wget or curl are installed on the Linux system, the backup agent may </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">downloaded via the Linux command line with either of the following commands: </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">wget <a href="/home/leaving?allowTrusted=1&target=http%3A%2F%2Fftp.unitrends.com%2Fbp%2Flatest_build%2FLinux%2Flnx32_cnt.run">http://ftp.unitrends.com/bp/latest_build/Linux/lnx32_cnt.run</a> </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">curl -O <a href="/home/leaving?allowTrusted=1&target=http%3A%2F%2Fftp.unitrends.com%2Fbp%2Flatest_build%2FLinux%2Flnx32_cnt.run">http://ftp.unitrends.com/bp/latest_build/Linux/lnx32_cnt.run</a> </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">Make the installer binary executable </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">Set the executable bit on the file. </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">chmod +x lnx32_cnt.run </span></span></p> <p> </p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;"><span style="font-size: small;"><strong>Install the Backup Agent</strong></span> </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">Please read the paragraph below before launching the installer binary: </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">You will be given the opportunity to enter the directory where you would like to </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">install the software. Press enter to accept the default installation directory </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">(/usr/bp). </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">If it does not exist, you will be asked if you wish to create it, enter y to continue. </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">There will be an option to enter an email address for the computer’s backup </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">summaries. Typically, backups will be launched using schedules on the system. </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">Schedule reports will be sent from the system. Enter none to disable reports </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">directly from the Linux client. </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">You will be asked to enter the hostname of the system. This name should be </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">resolvable using DNS or the /etc/hosts file. </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">You will be asked if the client and the server (backup system) are separated by a </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">firewall. If using a low, medium, or high security setting on the system, enter y </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">when answering this question. Saying yes will force data communication between </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">the system and the client to use port 1745. </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">The client can now be registered on the Unitrends backup appliance. </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">To launch the installer binary, execute the following command, in the same </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">directory where the installer resides: </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">./lnx32_cnt.run </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">To register a Linux client </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">1 From the backup system, select Settings > Clients, Networking, and Notifications </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">> Clients. </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">2 Click Add Client. </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">3 Enter the name of the client in the Client/Server name field. </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">4 Click Confirm. </span></span></p> <p> </p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">Please refer to Chapter 12, Linux Protection, in the Administrator's guide for more information </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">concerning Linux protection. The administrator's guide may be found in PDF or </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;">html format at </span></span></p> <p><span style="font-family: DejaVu;"><span style="font-size: small;"><a href="/home/leaving?allowTrusted=1&target=http%3A%2F%2Fwww.unitrends.com%2Fsupport%2Fcustomer-care-center%2Ftechnical-documents.html">http://www.unitrends.com/support/customer-care-center/technical-documents.html</a> </span></span></p> <p> </p> <p> </p> <p> </p> </article> </main>