{toc:location=top|maxLevel=3|minLevel=3|type=flat|separator=pipe|style=border:1}
h2. Option 1 - Install the Backup Agent using APT
Configure an APT repository on Debian and Ubuntu to install the Backup Agent using apt. This repository also helps to manage upgrades of the Backup Agent in the future. For more information about upgrading the Backup Agent, see [ServerBackup:Upgrade Backup Agent for Linux].
*To configure an APT repository*:
# Modify the {{/etc/apt/sources.list}} to include the R1Soft repository, and then download the R1Soft {{apt gpg}} key using a command similar to the following:
{code}echo deb http://repo.r1soft.com/apt stable main >> /etc/apt/sources.list
wget http://repo.r1soft.com/r1soft.asc
apt-key add r1soft.asc{code}
!echo_wget_.png!
# Run the following command:
{code}apt-get update{code}
!update.png|border=1!
# Once the APT repository is configured, you can use the following command to install the Backup Agent:
{code}apt-get install serverbackup-enterprise-agent{code}
!apt-get-install_5.2.0.png!
----
h2. Option 2 - Install the Backup Agent using DPKG
h3. Download Backup Agent
For more information about downloading the Backup Agent, see [ServerBackup:Obtain Linux Backup Agent].
h3. Make sure you can unzip the download
Most Linux distributions come with the *unzip* utility pre-installed.
*To determine if you have the unzip utility*:
Run the following command:
{code}which unzip{code}
The system returns output similar to the following:
{code}which unzip
/usr/bin/unzip{code}
!which-unzip1.png|border=1!
If it returns nothing, install the *unzip* utility first.
*To install unzip on Debian or Ubuntu*:
Execute the following command:
{code}apt-get install unzip{code}
!install-unzip.png|border=1!
h3. Extract the Zip file
Use the {{unzip}} command to extract the files.
{code}unzip ServerBackup-Enterprise-Agent-linux64.zip{code}
!unzip-agent_5.20..png!
h3. Install the packages
{note:title=Notice}You must be a Linux root user to install the Backup Agent.
{note}
The archive extracted contains two folders: one with {{.deb}} packages (in our case, "*deb-linux64*") and one with {{.rpm}} packages ("*rpm-linux64*"). If you are installing on Debian or Ubuntu, choose the folder with {{.deb}} packages.
Each folder contains a set of the Backup Agent components:
* {{serverbackup-setup}}
* {{serverbackup-agent}}
* {{serverbackup-enterprise-agent}}
* {{serverbackup-async-agent-2-6}}
You must install all of the previous folders in one step. Use the {{cd}} command to go to the folder with the packages (in our case, "*deb-linux64*"), and then run the following command:
{code}dpkg -i *.deb{code}
!dpkg1_5.2.0.png!
h3. Install Server Backup Linux device driver
Server Backup Device Driver is a proprietary, loadable Linux kernel module distributed by R1Soft. It is loadable at run-time without restarting Linux, and you do *not* need to recompile your Linux kernel to use it. R1Soft does not provide pre-built modules for the popular kernels, so you must compile the module from source.
{note:title=Notice}You need to have loadable modules enabled as a feature in your kernel. This is an advanced feature on all popular Linux distributions.
{note}
h4. 1. Compiling Server Backup kernel module against kernel headers
You must compile the kernel module using the kernel headers. The program {{serverbackup-setup}} obtains all the information needed to compile a module from your running kernel.
In order for kernel module compilation to work, you should have Internet connectivity directly from the Linux server you are installing the Backup Agent on, to TCP port HTTPS (443), on the host {{krnlbld.r1soft.com}}.
You can test connectivity with the following command (this may take a minute):
{code}serverbackup-setup --test-connection{code}
!test-connection1.png|border=1!
h4. 2. Install kernel sources
If you are using an unmodified kernel provided by Ubuntu installer, install the kernel-devel package:
{code}apt-get install linux-headers-`uname -r`{code}
!apt-get-headers.png|border=1!
{info:title=Note}
In the recent versions of Ubuntu Server the correct version of Linux-headers is probably already installed, so you don't have to install it.
{info}
h4. 3. Build Server Backup kernel module online (direct Internet connection to R1Soft build server)
To attempt to build the kernel module, run the following command (this may take several minutes):
{code}serverbackup-setup --get-module{code}
!get-module2.png|border=1!
If module is compiled and installed successfully, the system displays output similar to the following:
{code}Saving kernel module to '/lib/modules/r1soft/hcpdriver-cki-3.2.0-29-generic.ko'
Kernel module is now installed.
Use '/etc/init.d/cdp-agent restart' to load the new driver{code}
h4. 4. Build the Server Backup kernel module offline (without direct Internet connection to R1Soft build server)
If there is no direct Internet connection between your Server Backup Manager and R1Soft build server, it is still possible to compile the kernel module. In this case:
# Create tarball file with the kernel headers.
# Copy this tarball file from the server to some other computer which has Internet connection to R1Soft build server.
# From this computer, upload the tarball to the R1Soft build server, and then wait for the compilation to finish.
# When compilation is finished, download binary module, and then copy it back to the Backup Agent machine. Start by executing the following command:
{code}serverbackup-setup --no-binary --tarball-only /tmp/kernel-headers.tar.gz{code}
After running this command, the system displays output similar to the following:
{code}Gathering kernel information
Gathering kernel information complete.
Creating kernel headers package
Checking '/tmp/r1soft-cki.1353084109' for kernel headers
Found headers in '/tmp/r1soft-cki.1353084109'
Compressing...
Header package created '/tmp/kernel-headers.tar.gz'
visit https://krnlbld.r1soft.com/ to do an offline module build
After it is complete, you will need to copy the module to /lib/modules/r1soft{code}
!no-binary1.png|border=1!
h4. 5. Last steps
* Copy the generated {{tar.gz}} file to a computer with Internet access.
* Go to [https://krnlbld.r1soft.com/] and upload the {{.tar.gz}} file to build a kernel module.
* After the build, download a kernel module.
* Copy this module to your Linux Server and place in the folder {{/lib/modules/r1soft}}.
* Restart the Backup Agent ({{/etc/init.d/cdp-agent restart}}).
!agent-restart1.png|border=1!
{excerpt:hidden=true}Instructions on how to install the Backup Agent on Debian and Ubuntu.{excerpt}
h2. Option 1 - Install the Backup Agent using APT
Configure an APT repository on Debian and Ubuntu to install the Backup Agent using apt. This repository also helps to manage upgrades of the Backup Agent in the future. For more information about upgrading the Backup Agent, see [ServerBackup:Upgrade Backup Agent for Linux].
*To configure an APT repository*:
# Modify the {{/etc/apt/sources.list}} to include the R1Soft repository, and then download the R1Soft {{apt gpg}} key using a command similar to the following:
{code}echo deb http://repo.r1soft.com/apt stable main >> /etc/apt/sources.list
wget http://repo.r1soft.com/r1soft.asc
apt-key add r1soft.asc{code}
!echo_wget_.png!
# Run the following command:
{code}apt-get update{code}
!update.png|border=1!
# Once the APT repository is configured, you can use the following command to install the Backup Agent:
{code}apt-get install serverbackup-enterprise-agent{code}
!apt-get-install_5.2.0.png!
----
h2. Option 2 - Install the Backup Agent using DPKG
h3. Download Backup Agent
For more information about downloading the Backup Agent, see [ServerBackup:Obtain Linux Backup Agent].
h3. Make sure you can unzip the download
Most Linux distributions come with the *unzip* utility pre-installed.
*To determine if you have the unzip utility*:
Run the following command:
{code}which unzip{code}
The system returns output similar to the following:
{code}which unzip
/usr/bin/unzip{code}
!which-unzip1.png|border=1!
If it returns nothing, install the *unzip* utility first.
*To install unzip on Debian or Ubuntu*:
Execute the following command:
{code}apt-get install unzip{code}
!install-unzip.png|border=1!
h3. Extract the Zip file
Use the {{unzip}} command to extract the files.
{code}unzip ServerBackup-Enterprise-Agent-linux64.zip{code}
!unzip-agent_5.20..png!
h3. Install the packages
{note:title=Notice}You must be a Linux root user to install the Backup Agent.
{note}
The archive extracted contains two folders: one with {{.deb}} packages (in our case, "*deb-linux64*") and one with {{.rpm}} packages ("*rpm-linux64*"). If you are installing on Debian or Ubuntu, choose the folder with {{.deb}} packages.
Each folder contains a set of the Backup Agent components:
* {{serverbackup-setup}}
* {{serverbackup-agent}}
* {{serverbackup-enterprise-agent}}
* {{serverbackup-async-agent-2-6}}
You must install all of the previous folders in one step. Use the {{cd}} command to go to the folder with the packages (in our case, "*deb-linux64*"), and then run the following command:
{code}dpkg -i *.deb{code}
!dpkg1_5.2.0.png!
h3. Install Server Backup Linux device driver
Server Backup Device Driver is a proprietary, loadable Linux kernel module distributed by R1Soft. It is loadable at run-time without restarting Linux, and you do *not* need to recompile your Linux kernel to use it. R1Soft does not provide pre-built modules for the popular kernels, so you must compile the module from source.
{note:title=Notice}You need to have loadable modules enabled as a feature in your kernel. This is an advanced feature on all popular Linux distributions.
{note}
h4. 1. Compiling Server Backup kernel module against kernel headers
You must compile the kernel module using the kernel headers. The program {{serverbackup-setup}} obtains all the information needed to compile a module from your running kernel.
In order for kernel module compilation to work, you should have Internet connectivity directly from the Linux server you are installing the Backup Agent on, to TCP port HTTPS (443), on the host {{krnlbld.r1soft.com}}.
You can test connectivity with the following command (this may take a minute):
{code}serverbackup-setup --test-connection{code}
!test-connection1.png|border=1!
h4. 2. Install kernel sources
If you are using an unmodified kernel provided by Ubuntu installer, install the kernel-devel package:
{code}apt-get install linux-headers-`uname -r`{code}
!apt-get-headers.png|border=1!
{info:title=Note}
In the recent versions of Ubuntu Server the correct version of Linux-headers is probably already installed, so you don't have to install it.
{info}
h4. 3. Build Server Backup kernel module online (direct Internet connection to R1Soft build server)
To attempt to build the kernel module, run the following command (this may take several minutes):
{code}serverbackup-setup --get-module{code}
!get-module2.png|border=1!
If module is compiled and installed successfully, the system displays output similar to the following:
{code}Saving kernel module to '/lib/modules/r1soft/hcpdriver-cki-3.2.0-29-generic.ko'
Kernel module is now installed.
Use '/etc/init.d/cdp-agent restart' to load the new driver{code}
h4. 4. Build the Server Backup kernel module offline (without direct Internet connection to R1Soft build server)
If there is no direct Internet connection between your Server Backup Manager and R1Soft build server, it is still possible to compile the kernel module. In this case:
# Create tarball file with the kernel headers.
# Copy this tarball file from the server to some other computer which has Internet connection to R1Soft build server.
# From this computer, upload the tarball to the R1Soft build server, and then wait for the compilation to finish.
# When compilation is finished, download binary module, and then copy it back to the Backup Agent machine. Start by executing the following command:
{code}serverbackup-setup --no-binary --tarball-only /tmp/kernel-headers.tar.gz{code}
After running this command, the system displays output similar to the following:
{code}Gathering kernel information
Gathering kernel information complete.
Creating kernel headers package
Checking '/tmp/r1soft-cki.1353084109' for kernel headers
Found headers in '/tmp/r1soft-cki.1353084109'
Compressing...
Header package created '/tmp/kernel-headers.tar.gz'
visit https://krnlbld.r1soft.com/ to do an offline module build
After it is complete, you will need to copy the module to /lib/modules/r1soft{code}
!no-binary1.png|border=1!
h4. 5. Last steps
* Copy the generated {{tar.gz}} file to a computer with Internet access.
* Go to [https://krnlbld.r1soft.com/] and upload the {{.tar.gz}} file to build a kernel module.
* After the build, download a kernel module.
* Copy this module to your Linux Server and place in the folder {{/lib/modules/r1soft}}.
* Restart the Backup Agent ({{/etc/init.d/cdp-agent restart}}).
!agent-restart1.png|border=1!
{excerpt:hidden=true}Instructions on how to install the Backup Agent on Debian and Ubuntu.{excerpt}