Cloudlinux Documentation Documentation Release Latest
Total Page:16
File Type:pdf, Size:1020Kb
CloudLinux Documentation Documentation Release latest Nov 24, 2018 Contents 1 Overview 51 2 Types of Users 53 3 Types of Limits 55 4 What happens when reseller or reseller’s end user hits the limit? 57 5 Requirements 59 6 Installation 61 7 How to Disable Reseller Limits 63 8 How to exclude mounts from namespaces for all LVEs 135 9 ‘ <>‘__Requirements 193 10 ‘ <>‘__Hoster 195 11 ‘ <>‘__End User 199 12 ‘ <>‘__Hoster 203 13 ‘ <>‘__End User 207 14 Installation: 289 15 Command-line Interface 295 16 Yum fails to install Perl rpms coming with OptimumCache 301 17 Uninstalling OptimumCache lasts for too long 303 18 ‘Failed to attach peer: Invalid argument’ appears in syslog 305 i ii CloudLinux Documentation Documentation, Release latest Author CloudLinux Inc Date 2018-10-23 Contents • CloudLinux Documentation – Overview – Types of Users – Types of Limits – What happens when reseller or reseller’s end user hits the limit? – Requirements – Installation – How to Disable Reseller Limits – How to exclude mounts from namespaces for all LVEs – ‘ <>‘__Requirements – ‘ <>‘__Hoster – ‘ <>‘__End User – ‘ <>‘__Hoster – ‘ <>‘__End User – Installation: – Command-line Interface – Yum fails to install Perl rpms coming with OptimumCache – Uninstalling OptimumCache lasts for too long – ‘Failed to attach peer: Invalid argument’ appears in syslog OPF/cloudlinuxos-docs.png Installation •Converting existing servers oAdvanced Options for cldeploy oExplanation Of Changes •Installing new servers •CloudLinux OS Images oXen Images Contents 1 CloudLinux Documentation Documentation, Release latest •Net Install •Installing on H-Sphere Server oConverting from mod_fastcgi to mod_fcgid •Virtuozzo and OpenVZ •Getting Trial License •Registering CloudLinux Server •CloudLinux on DigitalOcean •CloudLinux on Linode •Servers with LILO boot loader •cPanel EasyApache 4 •Uninstalling CloudLinux Converting Existing Servers It is easy to switch server from CentOS 6.x or 7.x to CloudLinux. The process takes a few minutes and replaces just a handful of RPMs. • Get <activation_key> either by getting trial subscrip- tion or by purchasing subscription. • Download script: cldeploy. • Execute sh cldeploy -k <activation_key> (if you have IP based license, execute sh cldeploy -i). • Reboot. If you have activation key: $ wget https://repo.cloudlinux.com/cloudlinux/sources/cln/cldeploy $ sh cldeploy -k <activation_key> If you have IP-based license: $ sh cldeploy -i $ reboot 2 Contents CloudLinux Documentation Documentation, Release latest Once you have rebooted, you are running CloudLinux kernel with LVE enabled. The script automatically detects and supports the following control panels: cPanel with EA3, Plesk, DirectAdmin, InterWorx. It will install CloudLinux kernel, Apache module, PAM module, command line tools as well as LVE Manager. ISPmanager 5 has native support for CloudLinux. To deploy CloudLinux on a server with ISPmanager 5, you would need to purchase CloudLinux license directly from ISPSystems and follow ISPmanager’s deployment guide. Note. If you are converting Hyper-V server, please, make sure you upgrade to the latest CentOS 6.9 or CentOS 7.4 first. Advanced Options for cldeploy sh cldeploy –help Usage: -h, –help Print this message -k, –key <key> Update your system to CloudLinux with activation key -i, –byip Update your system to CloudLinux and register by IP -c, –uninstall Convert CloudLinux back to CentOS —serverurl Use non-default registratio server (default is https://xmlrpc.cln.cloudlinux.com/XMLRPC) –components-only Install control panel components only —conversion-only Do not install control panel components after converting –hostinglimits Install mod_hostinglimits rpm —skip-kmod-check Skip check for unsupported kmods –skip-version-check Do not check for script updates —skip-registration Don’t register on CLN if already have access to CL repos The script will install the following to the server: Register server with CLN. 1. Install CloudLinux kernel, lve libraries, lve-utils, lve- 2. stats and pam_lve packages. Contents 3 CloudLinux Documentation Documentation, Release latest It will attempt to detect control panel and do the follow- 3. ing actions: For cPanel & DirectAdmin: 1. recompile Apache to install mod_hostinglimits; 1. install LVE Manager. 2. For Plesk, ISPManager & InterWorx: 2. Update httpd and install mod_hostinglimits; 1. install LVE Manager. 2. To disable installation of LVE Manager and mod_hostinglimits, please use –conversion-only option. To disable installation of kernel & CLN registration, please use –components-only option. To install mod_hostinglimits only, use –hostinglimits option. Examples: $ cldeploy –key xx-xxxxxx # convert RHEL/CentOS to CL by using activation key, install control panel components $ cldeploy –byip –conversion-only # convert RHEL/CentOS to CL by ip, don’t install control panel components $ cldeploy –components-only # install control panel components on already converted system $ cldeploy –hostinglimits # update httpd and install mod_hostinglimits Explanation Of Changes CloudLinux uses the fact that it is very close to CentOS and RHEL to convert systems in place, requiring just one reboot. Our conversion script does the following actions: •Backup of original repository settings into /etc/cl-convert-saved. 4 Contents CloudLinux Documentation Documentation, Release latest •Backup of RHEL system id into /etc/cl-convert-saved (RHEL systems only). •Installs CL repository settings & imports CL RPM key. •Replaces redhat/centos-release, redhat-release-notes, redhat-logos with CL version. •Removes cpuspeed RPM (as it conflicts with CPU limits). •Re-installs CL version of rhnlib/rhnplugin. •Checks for binary kernel modules, finds replacement if needed. •Detects OVH servers and fixes mkinitrd issues. •Detects Linode servers and fixes grub issues. •Checks if LES is installed. •Checks that /etc/fstab has correct /dev/root •Checks for efi. •Installs CL kernel, lve-utils, liblve, lve-stats RPMs. •Installs LVE Manager for cPanel, Plesk, DirectAdmin, ISPManager & InterWorx •Installs mod_hostinglimits apache module: oRPM install for Plesk, ISPManager & InterWorx; oOn Plesk, replaces psa-mod_fcgid* with mod_fcgid; oEasyApache rebuild for cPanel; ocustombuild for DA. Script for converting back: •Restores CentOS repositories, and centos-release/release-notes/logos. •Removes lve, mod_hostinglimits, lve-stats, lvemanager. •mod_hostinglimits RPM is removed. The kernel is not removed - to prevent condition when server has no kernels and wouldn’t boot. The command line to remove the kernel is provided. On cPanel servers, rebuild of Apache with EasyApache will complete the conversion back, but doesn’t have to be performed immediately. On DirectAdmin servers, rebuild of Apache with custombuild will complete the conversion back, but doesn’t have to be performed immediately. Installing new servers You can download the latest CloudLinux ISO and use it to install CloudLinux on your server: Latest stable CloudLinux 7.5 ISO: x86_64 version: http://repo.cloudlinux.com/cloudlinux/7/iso/x86_64/CloudLinux-DVD-x86_64-7.5.iso Last Updated: May 14, 2018 Latest stable CloudLinux 6.9 ISO: x86_64 version: http://repo.cloudlinux.com/cloudlinux/6/iso/x86_64/CloudLinux-6.9-x86_64-DVD.iso i386 version: http://repo.cloudlinux.com/cloudlinux/6/iso/i386/CloudLinux-6.9-i386-DVD.iso Contents 5 CloudLinux Documentation Documentation, Release latest Last Updated: April 6, 2017 Latest stable CloudLinux 5.11 ISO (OBSOLETE): x86_64 version: http://repo.cloudlinux.com/cloudlinux/5.11/iso/x86_64/CloudLinux-5.11-x86_64-DVD.iso i386 version: http://repo.cloudlinux.com/cloudlinux/5.11/iso/i386/CloudLinux-5.11-i386-DVD.iso Last Updated: Oct 10, 2014 Note: Once you install server from the ISO, make sure you register your system and then run yum update. CloudLinux OS Images •OpenStack QEMU/KVM •VMware •Google Cloud Engine •Amazon Web Services •Alibaba Cloud •Xen Xen Images To start using Xen image: Decompress xen image to: /var/lib/xen/images/ (depends on your setup) Create a config file in /etc/xen Like: name = “cl6-sample” uuid = “4230bccf-5882-2ac6-7e1c-0e2a60208001” maxmem = 1024 memory = 1024 vcpus = 1 bootloader = “/usr/bin/pygrub” on_poweroff = “destroy” on_reboot = “restart” on_crash = “restart” vfb = [ “type=vnc,vncunused=1,key=en-us” ] disk = [ “tap:aio:/var/lib/xen/images/cl6-sample.img,sda,w” ] vif = [ “mac=00:16:3e:23:09:10,bridge=xenbr0,script=vif-bridge” ] where: name = “cl6-sample” - unique name of the server disk = [ “tap:aio:/var/lib/xen/images/cl6-sample.img,sda,w” ] - path to image file uuid = “4230bccf-5882-2ac6-7e1c-0e2a60208001” - uniquie id for that server 6 Contents CloudLinux Documentation Documentation, Release latest vif = [ “mac=00:16:3e:23:09:10,bridge=xenbr0,script=vif-bridge” ] - unique MAC [maxmem = 1024 memory = 1024 vcpus = 1] resources Root password: cloudlinux Disk Images CloudLinux 6 Minimal: http://download.cloudlinux.com/images/cl6-7/cl6-hvm-base.img.tgz CloudLinux 7 Minimal: http://download.cloudlinux.com/images/cl6-7/cl7-hvm-base.img.tgz CloudLinux 6 + cPanel: http://download.cloudlinux.com/images/cl6-7/cl6-hvm-cPanel.img.tgz CloudLinux 6 + Parallels Plesk: http://download.cloudlinux.com/images/cl6-7/cl6-hvm-Plesk.img.tgz CloudLinux 6 + DirectAdmin: http://download.cloudlinux.com/images/cl6-7/cl6-hvm-da.img.tgz CloudLinux 7 + DirectAdmin: http://download.cloudlinux.com/images/cl6-7/cl7-hvm-da.img.tgz Net Install To install CloudLinux over network: 1.Download & boot from netboot image from: http://repo.cloudlinux.com/cloudlinux/6.6/iso/x86_64/CloudLinux-6.