{page-title}{excerpt}{*}Hot Copy device driver installation utility{*}{excerpt}
hcp-setup \[-k KERNEL_SOURCE_DIR\]
h3. DESCRIPTION
hcp-setup is used to build a proprietary R1Soft Hot Copy Linux device driver. hcp-setup will first compute the MD5 checksum of your running kernel's /proc/version string (same as # echo \-n "$(cat /proc/version)"\|md5sum). It will then look for an existing binary compatible device driver on the R1Soft download servers. If one exists it will be downloaded. If an existing binary Hot Copy device driver exactly matching your running kernel is not available than hcp-setup will attempt to build a new device driver from source using your system's kernel source or kernel headers.
h3. BUILDING HOT COPY DRIVER FROM SOURCE
hcp-setup will tar up your kernel source tree or headers and upload them to an R1Soft build server over HTTPS. Once your system's kernel headers or source have been uploaded the R1Soft build server will compile a Hot Copy device driver as a kernel module and hcp-setup will automatically download it to your system.
*In order for hcp-setup to work your Linux server must have HTTPS Internet access to kmod32.r1soft.com (32-bit systems) and kmod64.r1soft.com (64-bit systems) on TCP port 443*
h3. OPTIONS
*\-k, \--kernel* specify location of kernel source or kernel headers (default is /lib/modules/`uname \-r`/build)
*\-d, \--destdir download compiled kernel module to this directory (default is /lib/modules/r1soft)*
*\-i, \--test* test connection to R1Soft build servers kmod32.r1soft.com, kmod64.r1soft.com
*\-z, \--no-cache* don't get a pre-built binary module, force building from source
*\-o, \--cache-only* Don't compile a module form source check for a matching binary device driver only
*\--debug* print debugging information
*\-s, \--server* specify an alternative R1Soft build server
*\-v, \--version* print version information about hcp command line utility and hcp device driver
*\-h, \--help* print help dialogue
*KERNEL_SOURCE_DIR* path to kernel module source or devel header files (default is /lib/modules/`uname \-r`/build)
h3. EXAMPLES
Install a Hot Copy device driver:
hcp-setup
h3. REPORTING BUGS
Report bugs to [http://forum.r1soft.com]
h3. COPYRIGHT
Copyright 2008-2012 Idera, Inc.
h3. SEE ALSO
[hcp|hcp], [hcp-device|hcp-device]
hcp-setup \[-k KERNEL_SOURCE_DIR\]
h3. DESCRIPTION
hcp-setup is used to build a proprietary R1Soft Hot Copy Linux device driver. hcp-setup will first compute the MD5 checksum of your running kernel's /proc/version string (same as # echo \-n "$(cat /proc/version)"\|md5sum). It will then look for an existing binary compatible device driver on the R1Soft download servers. If one exists it will be downloaded. If an existing binary Hot Copy device driver exactly matching your running kernel is not available than hcp-setup will attempt to build a new device driver from source using your system's kernel source or kernel headers.
h3. BUILDING HOT COPY DRIVER FROM SOURCE
hcp-setup will tar up your kernel source tree or headers and upload them to an R1Soft build server over HTTPS. Once your system's kernel headers or source have been uploaded the R1Soft build server will compile a Hot Copy device driver as a kernel module and hcp-setup will automatically download it to your system.
*In order for hcp-setup to work your Linux server must have HTTPS Internet access to kmod32.r1soft.com (32-bit systems) and kmod64.r1soft.com (64-bit systems) on TCP port 443*
h3. OPTIONS
*\-k, \--kernel* specify location of kernel source or kernel headers (default is /lib/modules/`uname \-r`/build)
*\-d, \--destdir download compiled kernel module to this directory (default is /lib/modules/r1soft)*
*\-i, \--test* test connection to R1Soft build servers kmod32.r1soft.com, kmod64.r1soft.com
*\-z, \--no-cache* don't get a pre-built binary module, force building from source
*\-o, \--cache-only* Don't compile a module form source check for a matching binary device driver only
*\--debug* print debugging information
*\-s, \--server* specify an alternative R1Soft build server
*\-v, \--version* print version information about hcp command line utility and hcp device driver
*\-h, \--help* print help dialogue
*KERNEL_SOURCE_DIR* path to kernel module source or devel header files (default is /lib/modules/`uname \-r`/build)
h3. EXAMPLES
Install a Hot Copy device driver:
hcp-setup
h3. REPORTING BUGS
Report bugs to [http://forum.r1soft.com]
h3. COPYRIGHT
Copyright 2008-2012 Idera, Inc.
h3. SEE ALSO
[hcp|hcp], [hcp-device|hcp-device]