Agent Installation Requirements

General Installation Requirements

Before you start CloudEndure AgentThe Agent is a software program that is installed on machines in the Source location that need to be migrated or replicated to the Target location. installation, verify the following:

• Network requirements – Ensure that all the network requirements are met.
• Ensure that you are installing the AgentThe Agent is a software program that is installed on machines in the Source location that need to be migrated or replicated to the Target location. on a supported operating system.

• TargetThe location where the Replication Server will be located and where Target machines will be created (as a result of Test, Cutover or Recovery). cloud credentials – these credentials are required for the installation of the AgentThe Agent is a software program that is installed on machines in the Source location that need to be migrated or replicated to the Target location.. Prior to installing the AgentThe Agent is a software program that is installed on machines in the Source location that need to be migrated or replicated to the Target location., enter the TargetThe location where the Replication Server will be located and where Target machines will be created (as a result of Test, Cutover or Recovery). cloud credentials into the CloudEndure User ConsoleCloudEndure SaaS User Interface. A web-based UI for setting up, managing, and monitoring the Migration and Disaster Recovery solutions. > Setup & Info > AWS CREDENTIALS page.
  
  
  
• SourceThe location of the Source machine; Currently either a specific Region or Other Infrastructure. and TargetThe location where the Replication Server will be located and where Target machines will be created (as a result of Test, Cutover or Recovery). settings – These settings are required for identifying your SourceThe location of the Source machine; Currently either a specific Region or Other Infrastructure. and TargetThe location where the Replication Server will be located and where Target machines will be created (as a result of Test, Cutover or Recovery). infrastructures. Before the installation, specify the SourceThe location of the Source machine; Currently either a specific Region or Other Infrastructure. and TargetThe location where the Replication Server will be located and where Target machines will be created (as a result of Test, Cutover or Recovery). setting in the User Console > Setup & info > REPLICATION SETTINGS page in the Source and Target fields.
  
  
  

  Note: If you change the values of the Source or Target, you will need to re-install all the Agents, and to resend all the data to the Target infrastructure. Therefore, it is recommended to carefully configure your Replication Settings before you install the Agents.

  Note: If you change other Replication Settings (except for the Source and Target) after installing the Agents, the replication will usually continue as normal, provided that the network requirements are still met. Some setting changes will cause all data to resync.

• MAC address stability – for the proper operation of the AgentThe Agent is a software program that is installed on machines in the Source location that need to be migrated or replicated to the Target location. after the installation, verify that the MAC addresses of the SourceThe location of the Source machine; Currently either a specific Region or Other Infrastructure. machines does not change upon a reboot or any other common changes in your network environment.
  
  Since the unique ID of the SourceThe location of the Source machine; Currently either a specific Region or Other Infrastructure. machines is usually calculated from the MAC addresses, when a MAC address changes, CloudEndure is not able to identify the machineA physical or virtual computer. correctly. Consequently, the replication stops. In this case, you will need to re-install the AgentThe Agent is a software program that is installed on machines in the Source location that need to be migrated or replicated to the Target location. and start the replication process from scratch.
  
• Supported Operating Systems - ensure that you are installing your AgentsThe Agent is a software program that is installed on machines in the Source location that need to be migrated or replicated to the Target location. on operating systems that are supported by your TargetThe location where the Replication Server will be located and where Target machines will be created (as a result of Test, Cutover or Recovery). infrastructure of choice. Learn more about Supported Operating Systems here.

Installation Requirements for Source Machines

The installation requirements for SourceThe location of the Source machine; Currently either a specific Region or Other Infrastructure. machines depend on the type of OS that the machineA physical or virtual computer. runs – either Linux or Windows.

• Root directory -Verify that you have at least 2 GB of free disk on the root directory (/) of your Source machineThe computer, physical or virtual machine that needs to be protected by replication (Disaster Recovery) or migrated (Migration) The CloudEndure Agent is installed on the Source machine.
• /tmp directory (Linux) - You need at least 500 MB of free disk on the /tmp directory for the duration of the installation process.
• Verify that the machineA physical or virtual computer. constantly has at least 300 MB of free RAM to run the AgentThe Agent is a software program that is installed on machines in the Source location that need to be migrated or replicated to the Target location..

Note: CloudEndure does not support Paravirtualized Source machines.

Note: The CloudEndure installer supports multipath.

Installation Requirements for Linux Source Machines

Important! Contact Support if any issues arise during installation.

To install AgentsThe Agent is a software program that is installed on machines in the Source location that need to be migrated or replicated to the Target location. on machines with Linux OS, verify the following:

• Python is installed on the machineA physical or virtual computer. – Python 2 (2.4 or above) or Python 3 (3.0 or above).

• The following tools are required for agentThe Agent is a software program that is installed on machines in the Source location that need to be migrated or replicated to the Target location. installation only. The installer will attempt to install them if they are not present already: make gcc perl tar gawk rpm

• Verify that you have at least 2 GB of free disk on the root directory (/) of your Source machineThe computer, physical or virtual machine that needs to be protected by replication (Disaster Recovery) or migrated (Migration) The CloudEndure Agent is installed on the Source machine. for the installation. To check the available disk space on the root directory, run the following command: df -h /
  Free disk space on the /tmp directory – for the duration of the installation process only, verify that you have at least 500 MB of free disk on the /tmp directory. To check the available disk space on the /tmp directory run the following command:df -h /tmp
  After you have entered the above commands for checking the available disk space, the results will be displayed as follows:
  
• The active bootloader software is GRUB 1 or 2.
• Ensure /tmp is mounted as read+write.
• The CloudEndure user needs to be either a root user or a user in the sudoers list.
• Ensure that dhclient package is installed. If not, install the package. (run yum install dhclient in CMD)

• Verify that you have kernel-devel/linux-headers installed that are exactly of the same version as the kernel you are running.
  The version number of the kernel headers should be completely identical to the version number of the kernel. To handle this issue, follow these steps:

  1. Identify the version of your running kernel.

     
     To identify the version of your running kernel, run the following command:
     uname -r
     
     The 'uname -r' output version should match the version of one of the installed kernel headers packages (kernel-devel-<version number> / linux-headers-<version number).
     The following packages are utilized:
     linux-headers for Ubuntu and Debian
     kernel-devel for CentOS and RHEL
     kernel-default-devel for SLES
     kernel-uek-devel for Oracle Linux
     

  2. Identify the version of your kernel-devel/linux-headers.

     
     To identify the version of your running kernel, run the following command:
     On RHEL/CENTOS/Oracle/SUSE:
     rpm -qa | grep kernel
     
     

     Note: This command looks for kernel-devel.
     

     On Debian/Ubuntu: apt-cache search linux-headers

     

  3. Verifying that the folder that contains the kernel-devel/linux-headers is not a symbolic link.

     
     Sometimes, the content of the kernel-devel/linux-headers, which match the version of the kernel, is actually a symbolic link. In this case, you will need to remove the link before installing the required package.
     To verify that the folder that contains the kernel-devel/linux-headers is not a symbolic link, run the following command:
     On RHEL/CENTOS/Oracle/SUSE:
     ls -l /usr/src/kernels
     On Debian/Ubuntu:
     ls -l /usr/src
     
     In the above example, the results show that the linux-headers are not a symbolic link.

  4. [If a symbolic link exists] Delete the symbolic link.

     
     If you found that the content of the kernel-devel/linux-headers, which match the version of the kernel, is actually a symbolic link, you need to delete the link. Run the following command: rm /usr/src/<LINK NAME>
     For example: rm /usr/src/linux-headers-4.4.1

  5. Install the correct kernel-devel/linux-headers from the repositories.

     
     If none of the already installed kernel-devel/linux-headers packages match your running kernel version, you need to install the matching package.
     

     Note: You can have several kernel headers versions simultaneously on your OS, and you can therefore safely install new kernel headers packages in addition to your existing ones (without uninstalling the other versions of the package.) A new kernel headers package does not impact the kernel, and does not overwrite older versions of the kernel headers.

     Note: For everything to work, you need to install a kernel headers package with the exact sameversion number of the running kernel.

     To install the correct kernel-devel/linux-headers, run the following command:
     On RHEL/CENTOS/Oracle/SUSE:
     sudo yum install kernel-devel-`uname -r`
     On Debian/Ubuntu:
     sudo apt-get install linux-headers-`uname -r`

  6. [If no matching package was found] Download the matching kernel-devel/linux-headers package.

     
     If no matching package was found on the repositories configured on your machineA physical or virtual computer., you can download it manually from the Internet and then install it.
     To download the matching kernel-devel/linux-headers package, navigate to the following sites:
     
  • RHEL, CENTOS, Oracle, and SUSE package directory
  • Debian package directory
  • Ubuntu package directory
    

Installation Requirements for Windows Source Machines

Important! Contact Support if any issues arise during installation.

To install AgentsThe Agent is a software program that is installed on machines in the Source location that need to be migrated or replicated to the Target location. on machines with Windows OS, verify the following:

• NET Framework version 4.5 or above is installed on machines running Windows Server 2008 R2 or higher. .NET Framework version 3.5 or above on machines running Windows Server 2008 or lower.
• The WMI service must be enabled to install the AgentThe Agent is a software program that is installed on machines in the Source location that need to be migrated or replicated to the Target location..
• Windows SourceThe location of the Source machine; Currently either a specific Region or Other Infrastructure. machines need to have at least 2 GB of free space during Target machineThe Machine created during Test, Cutover or Recovery. launch in order to successfully launch a Target machineThe Machine created during Test, Cutover or Recovery..
• Verify that the machineA physical or virtual computer. constantly has at least 300 MB of free RAM to run the AgentThe Agent is a software program that is installed on machines in the Source location that need to be migrated or replicated to the Target location..

Target Machine Launch Requirements

• Machines need to have at least 2 GB of free space during Target machineThe Machine created during Test, Cutover or Recovery. launch in order to successfully launch a Target machineThe Machine created during Test, Cutover or Recovery..