Installation

CCMP will be ran as an application server on 64-bit Ubuntu 16.04 operation system on a physical server. It uses physical server as resource node to provide CPU and RAM resources for virtual machines (VMs). It supports running on single node or multiple nodes. A single node installation can be dynamically extended to multiple nodes without re-installation.

 

1. Single node installation

System requirements of a physical server:

  • Operation system: 64-bit Ubuntu 16.04
  • Memory: minimum 4GB RAM (recommend 8GB RAM or above)
  • Disk space: minimum 100 GB (recommend 500 GB or above)  to store VM images
  • At least one network interface card (NIC) for external access

On the physical server, download and run the install script installCloud.sh:

wget https://ccmp.clustertech.com/installCloud.sh -O installCloud.sh; sudo bash installCloud.sh

The script will first install all dependant Ubuntu packages used by CCMP, e.g. MySQL and QEMU. Please choose a MySQL root password if the server hasn’t installed it before. Then, it will install and setup CCMP in 4 steps:

  1. Select external NIC: The IP of the NIC is used to allow external access (e.g. within the network in your company) of Admin and User web portals.
  2. Choose disk space in directory /etc/ccmp/volume: The directory is used to store qcow2 images of virtual machines.
  3. Enter email address for default administrator user 'admin': This is the admin user used to login to Admin portal.
  4. Create CCMP MySQL database: Enter MySQL password for user root

After the installation, User and Admin portals can be visited at (Assume the IP of external NIC of the physical server is 192.168.1.2):

  • User portal: http://192.168.1.2, login with a default user ‘user’ with password ‘123456’
  • Admin portal: http://192.168.1.2/admin, login with a default admin user ‘admin’ and password ‘8ik,*IK<’

 

Uninstall

Run /etc/ccmp/removeCloud.sh

 

 

2. Multi nodes installation (Optional)

After single node installation, additional physical server (can be diskless) can be added as resource node. The first physical server is the cloud server that provide backend services for User and Admin portals.

System requirements:

  • Physical server used as resource node: at leaset 4G RAM, one NIC
  • Cloud server has one more NIC (total 2)
  • Network switch: to setup management network, connects cloud server’s extra NIC and NIC of any resource node to this network

On the cloud server, download and run install script installNetboot.sh to install resource node network boot package:

wget https://ccmp.clustertech.com/installNetboot.sh -O installNetboot.sh; sudo bash installNetboot.sh

Please choose a NIC connected to management network in the installation:

 

After installing resource node network boot package, new physical server can be added as resource node in 3 steps:

  1. Connect its 1st NIC to management network;
  2. Boot the resource node to BIOS setup, use PXE network boot as 1st boot device.
  3. Reboot resource node: It will download and start its operation system Ubuntu 16.04 using PXE from management network. Finally, it will register itself and can be viewed in Admin portal in 'Resource Nodes' page.