Loading...
 

Installing Enterprise Edition on Linux


There are two methods of installing CDP Enterprise Server:

  • Automatic. Adding the R1Soft packages repository to the Aptitude or yum configuration when installing CDP Enterprise Server using apt-get or yum.
  • Manual. Downloading the R1Soft binary packages and installing them using dpkg or rpm.

All four package managers apt-get, yum, dpkg, and rpm are Linux console applications. They can be started in a remote SSH session, in a GUI terminal window (Konsole in KDE, Gnome Terminal in Gnome, etc.), or on the Linux text console.

 Note

PuTTY is the recommended SSH client. PuTTY allows you to paste text from the Windows clipboard by pressing the right mouse button.


You can download PuTTY here: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html

After the installation is complete, a reboot is not required.
Establish an SSH connection to the Linux server or log in on the Linux text console. You should either log in as root or obtain root permissions after logging in via the su or sudo command.

Install Agent on Debian and Ubuntu

  1. Download CDP Agent (See Downloads page).
  2. Configure APT Repository.
    You should also configure an APT repository on Debian and Ubuntu to manage upgrades of CDP Standard Edition (See Upgrading Enterprise Agent for Linux), to install the unzip utility, etc.

    • Modify your /etc/apt/sources.list to include the R1Soft repository.
    • Download the R1Soft apt gpg key.

    # echo deb http://repo.r1soft.com/apt stable main >> /etc/apt/sources.list 
    # wget http://repo.r1soft.com/r1soft.asc 
    # apt-key add r1soft.asc 
    # apt-get update
  3. Option 1 - Install Agent Using APT

     Tip

    You must be a Linux root user to install CDP Agent

    After configuring the APT repository, execute the following command to install CDP Agent:

    apt-get install r1soft-cdp-enterprise-agent
  4. Option 2 - Install Agent Using DPKG
    • Check for unzip utility

     Tip


    Most Linux distributions come with the unzip utility pre-installed. To determine if you have the unzip utility, run:
    # which unzip

    This should return this output:
    # which unzip /usr/bin/unzip

    or
    unzip: Command not found.

    If the latter, you will need to install unzip:
    # apt-get install unzip
  5. Extract the ZIP File

     Tip

    We recommend creating a temporary directory to which you can extract the contents of the ZIP file.
      • Use the mkdir command to create a temporary directory (in our case, cdp-agent).

    # mkdir cdp-agent
      • Use the mv command to move the archive to that directory.

     Note

    Note that Linux file names are case sensitive. Make sure you type the name correctly (in our case, "r1soft-enterprise-agent-linux64-3.18.2.zip").

    # mv r1soft-enterprise-agent-linux64-3.18.2.zip cdp-agent
      • Use the cd command to go to that directory.

    # cd cdp-agent
      • Use the unzip command to extract the files.

    # unzip r1soft-enterprise-agent-linux64-3.18.2.zip
  6. Install the Packages

     Tip

    You must be a Linux root user to install CDP Agent.

    The archive you have extracted contains two folders: one with .deb packages (in our case, "deb-linux64") and one with .rpm packages ("rpm-linux64"). If you are installing on Debian or Ubuntu, choose the .deb package.

    Each folder contains a set of CDP components:
    • r1soft-setup
    • r1soft-cdp-enterprise-agent
    • r1soft-cdp-agent
    • r1soft-cdp-async-agent-2-6

    You will need to install all of them in one step. Use the cd command to open the folder with the packages (in our example, "deb-linux64") and run the following command:

    DEB 32-bit (x86) / DEB 64-bit (x86_64)
    dpkg -i *.deb
  7. Install CDP Linux Device Driver

    CDP Device Driver is a proprietary, loadable Linux kernel module distributed by R1Soft. It is loadable at run-time without restarting Linux, and you do not need to recompile your Linux kernel to use it. R1Soft does not provide pre-built modules for the popular kernels anymore, so you will have to compile the module from source.

     Note

    You need to have loadable modules enabled as a feature in your kernel. This is an advanced feature on all popular Linux distributions.
    • Compiling CDP Kernel Module against Kernel Headers or Kernel Source Tree

    Using a pre-built binary module package is not possible anymore. You will have to compile this module against kernel headers or a kernel source tree. We are not always able to compile kernel modules from kernel-devel packages supplied by most major Linux distributions. In some cases, packages are missing header files (broken), or the packages have been stripped of information that any device driver would need to compile a kernel module. In these cases, we can build using your installed kernel-devel package on your Linux server, as r1soft-setup will obtain the missing information it needs to compile a module from your running kernel.
    In order for kernel module compilation to work, you should have Internet connectivity directly from the Linux server you are installing CDP on, to TCP port HTTPS (443), on the host krnlbld.r1soft.com.

    You can test connectivity with the following command (this may take a minute):

    # r1soft-setup --test-connection
  8. Install Kernel Sources

    If you are using an unmodified kernel provided by Ubuntu installer, install the kernel-devel package:

    # apt-get install kernel-devel
    • Verify that the Source matches your running Kernel

    Sometimes the kernel-devel package is newer than the installed and running kernel. If the kernel-devel is too old and not found, please follow the instructions on how to setup access to older yum packages as documented here.
  • Build the CDP Kernel Module online (direct Internet connection to R1Soft build server).

    To attempt to build the kernel module, run the following command (this may take several minutes):

    # r1soft-setup --get-module

    Install Standard 8a
    If module has been compiled and installed successfully, you will see an output similar to the following:

    Saving kernel module to '/lib/modules/r1soft/hcpdriver-cki-2.6.32-220.4.1.el6.x86_64.ko' Kernel module is now installed. Use '/etc/init.d/cdp-agent restart' to load the new driver
    • Build the CDP Kernel module offline (without direct Internet connection to R1Soft build server).

    If there is no direct Internet connection between your CDP server and R1Soft build server, it is still possible to compile the kernel module. In this case, this will be tree-step process. First, you will have to create tarball file with the kernel headers. When you should copy this tarball file from the server to some other computer which has Internet connection to R1Soft build server. From this computer you should upload the tarball to the R1Soft build server and wait for the compilation to finish. When it is finished, you should download binary module and copy it back to the CDP server.

    Start with executing the following command:

    # r1soft-setup --no-binary --kernel-dir /usr/src/kernels/YOUR_KERNEL_TREE --tarball-only /tmp/kernel-headers-for-r1soft.tar.gz

    After running this command, you will see:

    # r1soft-setup --no-binary --kernel-dir /usr/src/kernels/2.6.32-220.4.1.el6.x86_64 --tarball-only /tmp/kernel-headers-for-r1soft.tar.gz Gathering kernel information Gathering kernel information complete. Creating kernel headers package Checking '/usr/src/kernels/2.6.32-220.4.1.el6.x86_64' for kernel headers Found headers in '/usr/src/kernels/2.6.32-220.4.1.el6.x86_64' Compressing... Header package created '/tmp/kernel-headers-for-r1soft.tar.gz' visit https://krnlbld.r1soft.com/ to do an offline module build After it is complete, you will need to copy the module to /lib/modules/r1soft

Finish

Copy the generated tar.gz file and paste it 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 and paste it to your Linux Server and the folder /lib/modules/r1soft.
Restart the Server /etc/init.d/cdp-agent restart.

See also: