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}
h1. 1. Downloading Hot Copy
To use and download Hot Copy you are required to first register at: [http://www.r1soft.com/tools/linux-hot-copy/]
After registering you will immediately receive the download links and further instructions via e-mail.
{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. *Install Hot Copy Kernel Module from Kernel Source or Devel Headers*
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 [hcp-setup|LTR1D:hcp-setup] for more information.
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]
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-2012 Idera Inc.
h1. SEE ALSO
[hcp-setup|http://wiki.r1soft.com/display/LTR1D/hcp-setup|hcp-setup], [hcp|LTR1D:hcp], [hcp-device|LTR1D:hcp-device]
\\ {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}
h1. 1. Downloading Hot Copy
To use and download Hot Copy you are required to first register at: [http://www.r1soft.com/tools/linux-hot-copy/]
After registering you will immediately receive the download links and further instructions via e-mail.
{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. *Install Hot Copy Kernel Module from Kernel Source or Devel Headers*
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 [hcp-setup|LTR1D:hcp-setup] for more information.
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]
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-2012 Idera Inc.
h1. SEE ALSO
[hcp-setup|http://wiki.r1soft.com/display/LTR1D/hcp-setup|hcp-setup], [hcp|LTR1D:hcp], [hcp-device|LTR1D:hcp-device]