This guide was written for CentOS 7.6 with CloneDeploy 1.4.0 and Mono 5.18.0.268.  There may be variances with other versions.

 

Pre-Requisites

  • A DHCP Server
  • Assign your server a static IP
  • Disable selinux, or make necessary changes to keep enabled

Install Web Application

sudo su
yum -y install yum-utils
yum -y install epel-release
rpm --import "http://keyserver.ubuntu.com/pks/lookup?op=get&search=0x3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF"
yum-config-manager --add-repo http://download.mono-project.com/repo/centos7/
yum -y install mono-devel apache2-mod_mono httpd udpcast lz4 mkisofs wget
wget "https://sourceforge.net/projects/clonedeploy/files/CloneDeploy 1.4.0/clonedeploy-1.4.0.tar.gz"
tar xvzf clonedeploy-1.4.0.tar.gz
cd clonedeploy
cp clonedeploy.conf /etc/httpd/conf.d/
mkdir /var/www/html/clonedeploy
cp -r frontend /var/www/html/clonedeploy
cp -r api /var/www/html/clonedeploy
cp -r tftpboot /
ln -s ../../images /tftpboot/proxy/bios/images
ln -s ../../images /tftpboot/proxy/efi32/images
ln -s ../../images /tftpboot/proxy/efi64/images
ln -s ../../kernels /tftpboot/proxy/bios/kernels
ln -s ../../kernels /tftpboot/proxy/efi32/kernels
ln -s ../../kernels /tftpboot/proxy/efi64/kernels
mkdir -p /cd_dp/images
mkdir /cd_dp/resources
mkdir /var/www/.mono
mkdir /usr/share/httpd/.mono
mkdir /etc/mono/registry
chown -R apache:apache /tftpboot /cd_dp /var/www/html/clonedeploy /var/www/.mono /usr/share/httpd/.mono /etc/mono/registry
chmod 1777 /tmp
sysctl fs.inotify.max_user_instances=1024
echo fs.inotify.max_user_instances=1024 >> /etc/sysctl.conf
chkconfig httpd on

Install Database

Change cduser and mypass to something else.

echo "[mariadb]
name = MariaDB
baseurl = http://yum.mariadb.org/10.3/centos7-amd64
gpgkey=https://yum.mariadb.org/RPM-GPG-KEY-MariaDB
gpgcheck=1" >> /etc/yum.repos.d/MariaDB.repo
yum -y install mariadb-server
service mariadb start
chkconfig mariadb on
mysql
create database clonedeploy;
CREATE USER 'cduser'@'localhost' IDENTIFIED BY 'mypass';
GRANT ALL PRIVILEGES ON clonedeploy.* TO 'cduser'@'localhost';
quit
mysql clonedeploy < cd.sql -v

Open /var/www/html/clonedeploy/api/Web.config with a text editor and change the following values:

xx_marker1_xx to your cduser database password you created earlier
On that same line change Uid=root to Uid=cduser
xx_marker2_xx to some random characters(alphanumeric only), probably should be a minimum of 8

service httpd restart

Install Samba Server

yum -y install samba
groupadd cdsharewriters
useradd cd_share_ro
useradd cd_share_rw -G cdsharewriters
usermod -a -G cdsharewriters apache

The following two commands will prompt you to create passwords for the smb share for a read only user and a read write user. Remember these passwords, you will need them again during the Web Interface Initial Setup.

smbpasswd -a cd_share_ro
smbpasswd -a cd_share_rw
echo "[cd_share]
path = /cd_dp
valid users = @cdsharewriters, cd_share_ro
create mask = 02775
directory mask = 02775
guest ok = no
writable = yes
browsable = yes
read list = @cdsharewriters, cd_share_ro
write list = @cdsharewriters
force create mode = 02775
force directory mode = 02775
force group = +cdsharewriters" >> /etc/samba/smb.conf
chown -R apache:cdsharewriters /cd_dp
chmod -R 2775 /cd_dp
service smb restart
chkconfig smb on

Install TFTP Server

yum -y install tftp-server
sed -i 's/\/var\/lib\/tftpboot/\/tftpboot -m \/tftpboot\/remap/g' /usr/lib/systemd/system/tftp.service
systemctl daemon-reload
service tftp restart
chkconfig tftp on

Create Firewall Exceptions

firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-service=https
firewall-cmd --permanent --add-service=samba
firewall-cmd --permanent --add-service=tftp
firewall-cmd --permanent --add-service=dhcp
firewall-cmd --permanent --add-service=proxy-dhcp
firewall-cmd --permanent --add-port=9000-10002/udp
service firewalld reload

Post Install Setup

  1. Open the CloneDeploy Web Interface
http://server-ip/clonedeploy
  1. Login with
clonedeploy / password
  1. Upon login you will be greeted with the Initial Setup Page
  2. Fill out the fields and click Finalize Setup
  3. Enjoy!

Fix ISO/USB Generation Bug

A bug in 1.4.0 has already been discovered that prevents the iso / usb generation from working properly.  To fix:

Download http://files.clonedeploy.org/CloneDeploy-Services.dll

and place it in /var/www/html/clonedeploy/api/bin/ , overwriting the original.

Next Step

Select a Client Boot Method

 

in Getting Started