Converting server from CentOS to CloudLinux

From ISPWiki
Jump to: navigation, search

Introduction

ISPmanager Business enables to switch servers from CentOS to CloudLinux using the integration module

The integration module adds the following CloudLinux features to ISPmanager Business:

  • LVE limits - limits user access to system resources.
  • CageFS - virtualized file system and a set of tools to contain each user in its own 'cage'.
  • PHP Selector - allows each user to select PHP version. PHP Selector requires account to have CageFS enabled to work.
  • Mysql Governor - enables to monitor and restrict MySQL usage in shared hosting environment.

Requirements

  • CentOS 6.7 or CentOS 7 (MAKE SURE THAT NO THIRD-PARTY REPOSITORIES OR PACKAGES OF THIRD-PARTY REPOSITORIES ARE CONNECTED )
  • CentOS installed inside the OpenVZ-container cannot be converted
  • Public IP addresses must be assigned to all cluster nodes
  • Wget must be installed on server, because it is used in the cldeploy script

Conversion steps

The conversion process includes the following steps:

1. Module installation. ISPmanager Business -- Modules - CloudLinux - Install.

2. Conversion includes two steps:

2.1 Conversion of local cluster node (if a local cluster node is not present, a new one without roles will be added).During the conversion process all the operations with cluster nodes are forbidden (create/edit).
2.2 Conversion of remote nodes.

Converting cluster nodes

The conversion process includes the following steps:

1. The ISPmanager control panel orders CloudLinux licenses for all cluster nodes;

2. Calls the "cldeploy" script (it is provided by the Cloudlinux company), and gets the license assigned the specific IP address;

3. Reinstalls MySQL;

4. For nodes with certain roles:

4.1 Web

the following packages will be deleted:

   ispmanager-pkg-httpd-itk
   httpd 
   ispmanager-pkg-php
   ispmanager-pkg-webalizer
   httpd-itk
4.2 Email:
   ispmanager-pkg-httpd-itk
   httpd 
   ispmanager-pkg-php
   httpd-itk
   mysql

5. The cluster node is reinstalled.

6. Missing packages are installed and configured based on the cluster node's role.

Possible issues

You can monitor the conversion process in the "Cluster nodes" module -- select a server -- "Logs".

Errors:

  • "Fatal error occurred while converting the operating system" - this error is caused by the cldeploy conversion script error. Click "Details" in the "Log" module for more information about this error.
  • "Server is temporary not accessible" - error connecting to the cluster node. This is a standard situation that occurs when rebooting a cluster node.
  • "Remote servers CloudLinux are currently not accessible" - данная ошибка происходит в связи с отказом от обслуживания установочных серверов CloudLinux. *
  • "Error registering license" - this error occurs if the CloudLinux billing system could not register a license for this cluster node. *
 * ISPmanager will try to restart the OS conversion script.
  • The "PHP versions" module is empty upon conversion

"The control panel takes php versions from the php packages provided by CloudLinux. Make sure those packages are present (rpm -qa)

Install them, if needed

yum groupinstall alt-php

Delete the /usr/local/mgr5/var/.alt_php.xml file to make ISPmanager to get the infomormation about php packages.

More information about the OS conversion process can be found in the "/var/log/cldeploy.log" file of the cluster node.