Installing Hot Copy

h1. Getting Started

\\ {excerpt}Getting Started.{excerpt} Hot Copy is comprised of the hcp command line utility and the R1Soft Hot Copy snapshot device driver.

# (/) Download the appropriate Hot Copy installer for your Linux distribution
# (/) Install Hot Copy using by using one of the 5 different installation packages: apt, yum, tar, .deb or .rpm
# (/) Install the Hot Copy Linux device driver from pre-built binary package or build the device driver from source if required.
# (/) Enjoy Hot Copy e.g. (hcp /dev/DEVICE) :-)
{note}Check the Linux Hot Copy System Requirements before proceeding with installation:
[http://www.r1soft.com/tools/linux-hot-copy/sys-req/]
{note}

{note}Save Important Contents of Registration E-mail:
* RPM, .deb, and Tar download links
* APT repository URL and APT gpg Key to check package signatures
* Yum repository URL
{note}
\\

h1. 2. Installing the hcp Command Line Utility Binary 

R1Soft provides apt, yum, tar, .deb and .rpm installation methods for both 32-bit (i386) and 64-bit (AMD64) architectures.
{note}You must be the root user to install and use Hot Copy
{note}

h3. RPM Install

+Install the .rpm Hot Copy package for 32-Bit Linux+
{code}
# rpm -i latest-hotcopy-x32.rpm
{code}
+Install the .rpm Hot Copy package for 64-Bit Linux+
{code}
# rpm -i latest-hotcopy-x64.rpm
{code}

h3. APT (.deb) Package Install

+Install the .deb Hot Copy package for 32-Bit Linux+
{code}
# dpkg -i latest-hotcopy-x32.deb
{code}
+Install the .deb Hot Copy package for 64-Bit Linux+
{code}
# dpkg -i latest-hotcopy-x64.deb
{code}

h3. APT Repository Installation

To install Hot Copy with apt you will need to modify your {color:#0000ff}/etc/apt/sources.list{color} to include the R1Soft repository, and also download the R1Soft apt gpg key.
{code}
# echo deb APT_REPO_URL_PROVIDED_IN_REGISTRATION_EMAIL beta main >> /etc/apt/sources.list
# wget APT_RSA_KEY_URL_PROVIDED_IN_REGISTRATION_EMAIL
# apt-key add r1soft.asc
# apt-get update
# apt-get install r1soft-hotcopy
{code}

h3. Yum Repository Installation

To install Hot Copy with yum you will need to create a yum repo file with the R1Soft repository information inside of it.

First you will need to create the repo file in your {color:#0000ff}yum.repos.d{color} directory.  This is usually found in {color:#0000ff}/etc/yum/yum.repos.d{color}

Create a file called r1soft.repo:
{code}
# cd /etc/yum/yum.repos.d
# touch r1soft.repo
{code}
Open the file with a text editor like vi or nano:
{code}
# vi r1soft.repo
or
# nano r1soft.repo
{code}
Insert the following text into the file

*                *\[r1soft\]
                name=R1Soft Repository Server
                baseurl={color:#0000ff}{_}YUM_REPO_URL_PROVIDED_IN_REGISTRATION_EMAIL{_}{color}
                enabled=1   
                gpgcheck=0
{code}
# yum install r1soft-hotcopy
{code}

h1. .tar package

To install the .tar Hot Copy package at the shell prompt type:
\\
{code}
tar -xvf r1soft-hotcopy.tar --directory /
{code}\\
\\
h1. 3. Install Hot Copy Device Driver 

The Hot Copy device driver is provided as a loadable Linux kernel module.  You do NOT need to re-compile your Linux kernel. 
{note}You need to have loadable modules enabled as a feature in your kernel and this is standard on all popular Linux distributions
{note}

h3. Special Steps If You Are Using 2.0 Continuous Data Protection Linux Agent

If you are using the CDP 2.0 Linux Agent on this computer first unload the CDP device drive.  This will fail if you have a running backup task on this Agent.
{code}
# rmmod backupdriver
{code}
For more information see [LTR1D:Hot Copy and CDP 2.0 Linux Agent]

h3. Choose Device Driver Installation Method

*Pre-Built Binary Compatible Hot Copy Kernel Modules*

R1Soft provides pre-compiled binary compatible loadable Linux kernel modules for the Hot Copy device driver [supporting popular Linux distributions|http://www.r1soft.com/products/linux-hot-copy/system-requirements/].

These modules are available in RPM and .deb packages and Yum and APT repositories.  R1Soft spiders popular Linux distribution download repositories for the latest kernel updates and automatically compiles and tests binary kernel module builds.  New packages with the latest kernels are released daily.  The download links are available in the Hot Copy registration e-mail.

To check if a binary compatible Hot Copy driver is available check for your system's running kernel's /proc/version (# cat /proc/version) string at [http://www.r1soft.com/distros]

*Install Hot Copy Kernel Module from Kernel Source or Devel Headers*

If we don't have a binary compatible module for your kernel version you will need to install the Hot Copy device driver using your kernel source code or kernel headers using the [hcp-setup command line utility|LTR1D:hcp-setup].  See [LTR1D:hcp-setup] for more information.

h3. Binary Compatible Device Driver: RPM Install

+Install the .rpm Kernel Modules package for 32-Bit Linux+
{code}
# rpm -i latest-kernel-modules-x32.rpm
{code}
+Install the .rpm Kernel Modules package for 64-Bit Linux+
{code}
# rpm -i latest-kernel-modules-x64.rpm
{code}

h3. Binary Compatible Device Driver: APT (.deb) Package Install

+Install the .deb Kernel Modules package for 32-Bit Linux+
{code}
# dpkg -i latest-kernel-modules-x32.deb
{code}
+Install the .deb Kernel Modules package for 64-Bit Linux+
{code}
# dpkg -i latest-kernel-modules-x64.deb
{code}

h3. Binary Compatible Device Driver: APT Repository Installation 

To install Hot Copy with apt you will need to modify your {color:#0000ff}/etc/apt/sources.list{color} to include the R1Soft repository, and also download the R1Soft apt gpg key as shown in step (2) above.
{code}
# apt-get install r1soft-hotcopy-kernel-modules
{code}

h3. Binary Compatible Device Driver: Yum Repository Installation

To install Hot Copy with yum you will need to create a yum repo file with the R1Soft repository information inside of it as shown in step (2) above.
\\
{code}
# yum install r1soft-hotcopy-kernel-modules
{code}

h1. 4. Enjoy Hot Copy\!  

You can then use Hot Copy with the "hcp" command.  :-)
{code}
# hcp /dev/DEVICE
{code}
* [Using the Hot Copy command line utility (hcp)|LTR1D:hcp]
 
* [Hot Copy Tips\!|http://www.r1soft.com/products/linux-hot-copy/hot-copy-tips/]
 
* Have a Kewl way to use Hot Copy?  Incorporating Hot Copy into a script?  [Share it on the R1Soft Continuous Data Protection, Tools for Windows and Linux Community Forum\!|http://forum.r1soft.com]

h1. REPORTING BUGS

Report bugs to [http://forum.r1soft.com]

h1. COPYRIGHT

Copyright 2008 BBS Technologies, Inc.  [R1Soft|http://www.r1soft.com] and [Idera|www.idera.com] are divisions of BBS Technologies. 

h1. SEE ALSO

[hcp-setup|http://wiki.r1soft.com/display/LTR1D/hcp-setup|hcp-setup], [hcp|LTR1D:hcp], [hcp-device|LTR1D:hcp-device]