WIXLIB

Linux CDP Standard Edition Getting Started Guide, Version 3.18Use Pre-Built Binary Compatible CDP Kernel ModulesR1Soft provides pre-compiled binary compatible loadable Linux kernel modules for the CDPdevice driver supporting popular Linux distributions. These modules are available in RPM and.deb packages and Yum and APT repositories. R1Soft spiders popular Linux distributiondownload repositories for the latest kernel updates and automatically compiles and tests binarykernel module builds. New packages with the latest kernels are released daily.Install Hot Copy Kernel Module from Kernel Source or Devel HeadersIf we do not have a binary compatible module for your kernel version, you will need to install theHot Copy device driver using your kernel source code, or kernel headers using the hcp-setupcommand line utility. See hcp-setup for more information.Download Binary Compatible Device DriverUse binary compatible device driver direct download with r1soft-setup.r1soft-setup candownload a binary compatible kernel module from R1Soft for you if one is available. (This isattempted automatically by RPM/APT cdp-agent package installation).In order for this to work, you will need to have Internet connectivity directly from the Linux serveryou are installing CDP on, to TCP port HTTPS (443) on host krnlbld.r1soft.com.You can test connectivity with (may take a minute):To attempt to directly download a binary compatible kernel module (may take several minutes):If it was successful, you will see something similar to:Binary Compatible Device Driver: RPM/APT InstallR1Soft also maintains RPM and APT packages for many popular Linux kernels available fordownload using the R1Soft Yum or APT repositories.You will need to configure access to the Yum/APT repository as directed in step 5 in order forthis to work.Kernel using Yum14

Linux CDP Standard Edition Getting Started Guide, Version 3.18Install the Kernel Modules package for your running Kernel using Yum:Kernel using AptInstall the Kernel Modules package for your running Kernel using Apt:Binary Compatible Device Driver: RPM/APT (All Modules)R1Soft maintains two large APT and RPM packages that contain ALL pre-built binary drivers.This is useful if you frequently switch running kernels and do not want to update ther1soft-kernel-module package after switching kernels.You will need to configure access to the Yum/APT repository as directed in step 5 in order forthis to work.Kernel using YumInstall All the binary Kernel Modules package for your running Kernel using Yum:Kernel using APTInstall All the binary Kernel Modules package for your running Kernel using APT:15

Linux CDP Standard Edition Getting Started Guide, Version 3.18Compiling CDP Kernel Module Against Kernel Headers or Kernel Source TreeR1Soft CDP driver is a proprietary Linux device driver. You can compile a kernel module againstyour distributions installed kernel headers or kernel source. Using a pre-built binary package isrecommended, but is not always an option. If you are using a vanilla kernel from kernel.org or apatched or in-house kernel, you will definitely need to use this option.You may also need to build a kernel module from source if we are unable to make a pre-builtbinary for your distribution and kernel version. In some cases, we are not able to compile kernelmodules from kernel-devel packages supplied by most major Linux distributions. In some cases,there are missing header files (broken), or they have been stripped of information any devicedriver would need to compile. In these cases, we can typically build using your installedkernel-devel package on your Linux server and r1soft-setup will obtain the missing information itneeds to compile from your running kernel.Install Kernel Headers1. If you are using an unmodified kernel compiled by a Popular Linux Distribution, install thekernel headers (kernel-devel).CentOS/RHE/Fedora/SuseInstall Kernel Headers for CentOS/RHE/Fedora/Suse:Debian/Ubuntu16

Linux CDP Standard Edition Getting Started Guide, Version 3.18Install Kernel Headers for Debian/Ubuntu:2. Build a Kernel Module using your installed Kernel Headers (this may take several minutes):If it is successful, you will see something similar to:Verify if the Source Matches Your Running KernelFollow this step if you are using a patched or custom kernel and have the kernel source tree.To build a kernel module against a kernel source tree, make sure it is the correct source tree thatexactly matches your running kernel.NoticeAny time you are compiling a kernel module against a different source tree (e.g.samekernel version but different gcc version was used to build tree), you can cause kernelpanics when the incompatible module is loaded. R1Soft performs very safepreventative measures to make sure this never happens when you use a pre-builtbinary kernel module or build against your system's kernel-devel package. When youbuild from a kernel source tree, we trust you know how to do it properly.Verify Kernel Source TreeMake sure your kernel source tree is configured and correctly prepared. You may be able to skipthese steps if you are knowledgeable about the process.cd into your kernel source tree e.g.Prepare the kernel source without actually compiling it:17

Linux CDP Standard Edition Getting Started Guide, Version 3.18Build the CDP Kernel Module Online (direct Internet Connection to R1Soft build server)After running this, you will see:Build the CDP Kernel Module Online (offline no direct Internet connection to R1Soft build server)After running this, you will see:Last StepNow 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, you will download a kernel module.Copy this module to your Linux Server and folder /lib/modules/r1softRestart the agent (/etc/init.d/cdp-agent restart).18

Linux CDP Standard Edition Getting Started Guide, Version 3.18Configuring a ReplicationCreating Disk SafesA Host must have a Disk Safe before any Replication can be run.NoticeDisk Safes should always be placed on reliable storage. For more Disk Safe bestpractices, see Disk Safe Best Practices.Follow the instructions below to create a Disk Safe in your CDP 3.0.1. Open the Web browser connected to the CDP Server 3.0 Web Interface and log in (SeeAccessing Standard Edition Web Interface, Accessing Enterprise Edition Web Interface, andAccessing Advanced Edition Web Interface).2. Click on "Disk Safes" in the Main Menu to access the "Disk Safes" page.Standard EditionEnterprise EditionAdvanced Edition3. In the "Disk Safes" menu, click on "Create New Disk Safe."19

Linux CDP Standard Edition Getting Started Guide, Version 3.18TipAlternatively, you can click on "Create a Disk Safe" located at the top of theDashboard.NoteYou can also create Disk Safes using the "Disk Safes" tab of the Agent "Details"Pane. This screen provides the same functionality as the main "Disk Safes" screen.See more information in Accessing Agents.4. The "Create New Disk Safe" window will open.Standard EditionEnterprise EditionAdvanced E20

Linux CDP Standard Edition Getting Started Guide, Version 3.185. The window contains the following tabs:SettingsData SettingsLimits6. Define the following settings specific to the new Disk Safe:Settings Tab Data Settings Tab Limits TabSettings TabIdentificationName - Define the name for the Disk Safe. It will be used to identify the Disk Safe in thelist.Agent (Enterprise Edition)Agent - Here you can select an Agent from the drop-down menu.Disk Safe LocationPath - Path where the Disk Safe is physically located. For example, C:\Disk Safe.21

Linux CDP Standard Edition Getting Started Guide, Version 3.18NoteHere you can assign a Disk Safe to a Volume. Click on the correspondingcheckbox.DevicesAutomatically add new devices - This option will automatically add all available Devicesto the Disk Safe. Uncheck the checkbox to select the devices you want to add to the DiskSafe. If you do not select this option, then the "Add Devices to Protect" dialog window willappear once you save the Disk Safe. Read more Accessing Devices, Adding Devices.Protect Storage Configuration (Enterprise Edition, Advanced Edition) - This optionallows you to back up partition tables.Backup Windows System Reserved and Unmounted Partitions (Advanced Edition) This option allows you to back up hidden Windows system partition.Data Settings TabCompressionCompression Type - The compression level set for the Disk Safe. Possible values: "ZLibLow," "ZLib Medium," "ZLib High," "QuickLZ," and "NONE."EncryptionEncryption Type - You can assign an AES 256-Bit encryption to the Disk Safe. In that22

Linux CDP Standard Edition Getting Started Guide, Version 3.18case, you will be asked to create a password. If you choose to encrypt a Disk Safe, thepassword must be supplied to: browse files, browse Control Panel users, browsedatabases, and initiate BMR. Read more in Managing Disk Safe Encryption.NoteConfigured at create, encryption cannot be turned on/off.Limits TabThis tab allows File Excludes, Recovery Point Archiving ,and Control Panels to beenabled/disabled. Limits can be defined for Replication, Recovery Points, and Archive Points.TipWhen you assign a Disk Safe to a Volumes, all Volume's limits are applied to thatDisk Safe. That it why the Disk Safe's limits should be at least as restrictive asVolume's. For example, if a Volume has a Recovery Point limit set to 100, the DiskSafe can only contain 100 Recovery Points or less.23

Linux CDP Standard Edition Getting Started Guide, Version 3.18OptionsAllow File Excludes - Check this option to activate the File Excludes feature for the DiskSafe. If you check this option, then the system will allow you to specify files/folders whichwill not to be backed up during the replication Policy. By default, all file/folders from theselected Devices are replicated. Read more in About File and Folder Excludes, ExcludingFiles and Folders.You cannot activate this option if it is not activated for the Volume to which theDisk Safe belongs.Allow Recovery Point Archiving - Check this option to activate the Archiving feature forthe Disk Safe. If you check this option, the system will allow you to create archives of yourdata on a specified hour, day, week, or month. If the option is enabled, then you canspecify the "Archive Point Limit" under "Data Retention." Read more in Archiving.You cannot activate this option if it is not activated for the Volume to which theDisk Safe belongs.Allow Control Panels - Check this option to activate the Control Panels feature for the24

Linux CDP Standard Edition Getting Started Guide, Version 3.18Disk Safe. If you check this option, the system will allow you to backup and restore HostingControl Panel user accounts. Read more in CDP for Hosting Control Panels.TipYou cannot activate this option if it is not activated for the Volume to which theDisk Safe belongs.TipThere is a system-wide option to enable the Hosting Control Panels feature(Configuration Product features "Enable Hosting Control Panels" option under"Hosting Control Panels"). Read more in Enabling Hosting Control PanelsFeature.Replication Limit - This option defines the lowest replication frequency for that Disk Safe.For example, if you set the replication limit to "weekly," then the Policy assigned to thatDisk Safe can only be weekly or higher (hourly and daily replications will be restricted).TipThe Disk Safe Replication Limit must be within the limits of the Replication Limitof the Volume to which the Disk Safe is assigned.Data RetentionRecovery Point Limit - The maximum number of Recovery Points stored in the Disk Safe.TipThe Disk Safe Recovery Point Limit must be within the limits of the RecoveryPoint Limit of the Volume to which the Disk Safe is assigned.Archive Point Limit - The maximum number of Archive Points stored in the Disk Safe.TipThe Disk Safe Archive Point Limit must be within the limits of the Archive PointLimit of the Volume to which the Disk Safe is assigned.QuotasQuota Type - The type of quota assigned to the Disk Safe. Quotas are set to limit the diskusage of the Disk Safe. The limit is set on the basis of space occupied by Disk Safes or thesize of deltas.Soft Quota - The value in bytes or in deltas. Soft Quota is a warning level that informsusers that they are close to reaching their effective limit.Hard Quota - The value in bytes or in deltas. Hard Quota allows resources to be occupiedby data. If the Hard Quota is reached, then the system forbids generation of new RecoveryPoints. The replication is interrupted and fails.25

Linux CDP Standard Edition Getting Started Guide, Version 3.185. Define the necessary Disk Safe properties and click "Create."7. If you have specified a non-existing directory for the Disk Safe, you are now prompted tocreate a new directory. Click "OK."8. The new Disk Safe will be created.Adding the DevicesHere you can find brief instructions on how to add Devices. You can find more information inAdding Devices. If you have selected the "Choose Devices to Backup" option, follow theinstructions below.1. You will be asked if you want to manage the Devices at this time. Click "Choose" to open the"Devices" window.2. In the "Devices" window, click on "Get Devices from Agent."26

Linux CDP Standard Edition Getting Started Guide, Version 3.18TroubleshootingThe following error message may appear after clicking the "Get Devices From Agent"button.In this case, make sure that server.allow folders in both the Server and Agentdirectories contain the text file with the same Server Public Key. The key can befound in Configuration Server Information. For more information, see Adding theServer Key to Windows Agentand Adding the Server Key to Linux Agent.3. All Host Devices are listed in the "Devices On Agent" pane.4. Click on "Add" (the green plus icon) in front of a Device.5. The assigned Devices will be listed in the "Devices in Disk Safe" on the right side.27

Linux CDP Standard Edition Getting Started Guide, Version 3.186. Add as many Devices as you need for the Host.7. After you have assigned all needed Devices, close the "Devices" window.Viewing Created Disk Safe1. The new Disk Safe will appear in the Disk Safes list.28

Linux CDP Standard Edition Getting Started Guide, Version 3.18TipClick on an item in the Disk Safes list to see the Disk Safe details in the bottom pane.You can find more information on how to use the "Disk Safes" window in Accessing Disk Safes.NoticeYou need to create a Policy to replicate (back up) the Devices assigned to the DiskSafe. See Creating Policies.Creating PoliciesFollow the instructions below to add a Data Protection Policy in CDP 3.0.1. Open the Web browser connected to the CDP Server 3.0 Web Interface and log in (SeeAccessing Standard Edition Web Interface, Accessing Enterprise Edition Web Interface, andAccessing Advanced Edition Web Interface).2. Click on "Policy" in the Main Menu to open the "Policies" screen.29

Linux CDP Standard Edition Getting Started Guide, Version 3.18Standard EditionEnterprise EditionAdvanced Edition3. In the Policy menu, click on "Create New Policy."4. The "Create New Policy" window will open. It contains the following tabs:Policy SettingsData RetentionFile ExcludesAdvanced ExcludesDatabasesControl PanelsAdvanced Policy Settings30

Linux CDP Standard Edition Getting Started Guide, Version 3.18NoteDepending on the limits, defined for the Disk Safe to which the current Policy isassigned, some of the tabs might be disabled. See Creating Disk Safes#lim5. Define the following settings specific to the new Policy:Policy Settings Tab Data Retention Tab File Excludes Tab Advanced Excludes Tab DatabasesTab Control Panels Tab Advanced Policy Settings TabPolicy Settings TabThis is the main tab for creating a Policy. The following options are available:Identification31

Linux CDP Standard Edition Getting Started Guide, Version 3.18Enabled - Select this checkbox to enable the Policy. The Enabled Policy will run accordingto the schedule.Name - Enter a name you can use to identify this Policy among others in the Policies list.Description - Describe your Policy in details. The description can be shown in the Policieslist in the corresponding column.Disk SafeAgent (Enterprise Edition) - From the drop-down menu, select an Agent for which datayou are going to replicate. Then you will be able to select a Disk Safe assigned to theAgent.Disk Safe - From the drop-down menu, select a Disk Safe in which to save the replicateddata.NoteThe Policy will replicate data from the Devices assigned to the selected DiskSafe.SchedulingReplication Schedule - Define the schedule and recurrence for the new Policy (OnDemand, Minutely, Hourly, Daily, Weekly, Monthly, or Yearly). See Scheduling theRecovery Points Replication.NoteThe lowest possible replication frequency for all the Disk Safes assigned toVolume is defined in Volume properties (Volume properties window "Limits"tab "Options" section "Replication Limit" option).Merge Schedule - Define the schedule and recurrence for the Recovery Points merge(After Replication, Hourly, Daily, Weekly). See Scheduling the Recovery Points Merge.Data Retention TabOn this tab, you can set the Recovery Points Limit for the Policy and create an ArchivingSchedule. See Creating Archiving Policies.32

Linux CDP Standard Edition Getting Started Guide, Version 3.18NoteThe Recovery Point limit you set on this tab cannot be greater than the limit definedfor the current Disk Safe. See Creating Disk Safes#lim.File Excludes TabThis tab allows you to manually exclude files and folders from the replication.See Excluding Files and Folders.Advanced Excludes TabThis tab allows you to define a pattern (mask) to exclude files from the replication.See Excluding Files and Folders.33

Linux CDP Standard Edition Getting Started Guide, Version 3.18Databases TabThis tab allows you to include MySQL databases in

Linux CDP Standard Edition Getting Started Guide, Version 3.18 9 Debian, Ubuntu To install unzip on Debian, Ubuntu: 3. Extract the Zip File We recommend you create a temporary dir