unattended.iredmail.installation.md created online with Bitbucket

This commit is contained in:
Michael Chong 2014-09-16 10:27:08 +00:00
parent 7a7f457245
commit 97a3744bb2
1 changed files with 130 additions and 0 deletions

View File

@ -0,0 +1,130 @@
<http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/Unattended.iRedMail.Installation>
#How to perform silent/unattended iRedMail installation
* iRedMail will store configrations in file iRedMail-x.y.z/config during installation, and ask you whether to use it for installation directly or re-create one.
* iRedMail will read several global variables for automate installation.
You can create a sample config file by executing iRedMail installer:
<pre>
# bash iRedMail.sh
</pre>
After config wizard dialogs, you will find file "config" under iRedMail root directory. For example, __/root/iRedMail-0.8.7/config__. it will ask whether to start installation or not, you can cancel it if you want.
You can copy this config file to deploy as many servers as you want, change the hard-coded passwords in it if you want.
How to deploy a new server with sample config file:
* Copy sample config file to new server, e.g. /root/iRedMail-0.8.7/config.
* Execute iRedMail installer with shell variables:
<pre>
# AUTO_USE_EXISTING_CONFIG_FILE=y \
AUTO_INSTALL_WITHOUT_CONFIRM=y \
AUTO_CLEANUP_REMOVE_SENDMAIL=y \
AUTO_CLEANUP_REMOVE_MOD_PYTHON=y \
AUTO_CLEANUP_REPLACE_FIREWALL_RULES=y \
AUTO_CLEANUP_RESTART_IPTABLES=y \
AUTO_CLEANUP_REPLACE_MYSQL_CONFIG=y \
AUTO_CLEANUP_RESTART_POSTFIX=n \
bash iRedMail.sh
</pre>
--------
Here's how i preform iRedMail tests every day with VMware Fusion on Mac OS X, all are completed with a shell script and VMware command line tool "vmrun" and "scp", "ssh". Hope it helps.
* Install a clean, basic/minimal OS (Debian/CentOS/openSUSE/OpenBSD/etc), set proper hostname, configure network, then shut down this server and create a VMware snapshot named "Latest". The snapshot name will be used in my shell script, it needs a snapshot name to reverse VM to the clean OS.
* Revert VM to the latest snapshot (a clean, basic, minimal OS) with "vmrun".
* Start this VM with "vmrun", sleep 30 (or 60) seconds waiting for OS start up.
* Detect network connection to this VM, if it's up, upload required files with "scp":
* the latest development edition of iRedMail
* source tarballs required by iRedMail (Roundcube, iRedAdmin, iRedAPD, etc)
* downloaded RHEL/CentOS/Debian/Ubuntu/OpenBSD binary packages, FreeBSD distfiles etc. The most important one is a prepared iRedMail config file: iRedMail-x.y.z/config.
* Create/Update iRedMail installation status file: iRedMail-x.y.z/.status to skip downloading source tarballs, etc.
* Perform installation via ssh like this:
<pre>
ssh root@[SERVER] "cd /root/iRedMail/ && IREDMAIL_DEBUG='NO' AUTO_USE_EXISTING_CONFIG_FILE=y AUTO_INSTALL_WITHOUT_CONFIRM=y AUTO_CLEANUP_REMOVE_SENDMAIL=y AUTO_CLEANUP_REMOVE_MOD_PYTHON=y AUTO_CLEANUP_REPLACE_FIREWALL_RULES=y AUTO_CLEANUP_RESTART_IPTABLES=y AUTO_CLEANUP_REPLACE_MYSQL_CONFIG=y AUTO_CLEANUP_RESTART_POSTFIX=n bash iRedMail.sh"
</pre>
* Perform after-installation tasks: upload downloaded ClamAV database, ..., reboot server.
It should be finished in 2-3 minutes (uploading binary packages takes most time), then i got a working iRedMail server. I do this many times each day.
I have 5 prepared iRedMail config files for different backends: OpenLDAP, MySQL, MariaDB, PostgreSQL, ldapd (OpenBSD only). i run my script with an option to install iRedMail with specified backend like below, the script will upload proper config file to server:
<pre>
# bash auto.centos7.sh ldap
# bash auto.centos7.sh mysql
# bash auto.centos7.sh pgsql
# bash auto.ubuntu14.sh mariadb
# bash auto.openbsd55.sh ldapd
</pre>
Below is file of __auto.centos7.sh__ mentioned above, it prepares VMware virtual machine, then execute another script __c7.sh__ to perform the real installation.
<pre>
#!/usr/bin/env bash
# File: auto.centos7.sh
[ X"$#" != X'1' ] && echo 'No backend? ldap, mysql, pgsql' && exit 255
export backend="${1}"
export VMRUN='vmrun -T fusion'
export VM_USER_ROOT='root'
export VM_HOSTNAME='c7'
export VM="/Users/zhb/vm.packages/vm/CentOS-7-x86_64.vmwarevm/CentOS-7-x86_64.vmx"
echo "* Revert to the latest snapshot."
${VMRUN} revertToSnapshot ${VM} Latest
echo "* Start VM."
${VMRUN} start ${VM}
echo "* Sleep 30 seconds to wait VM start up."
sleep 30
echo "* Detect network status with ssh."
while :; do
ssh ${VM_USER_ROOT}@${VM_HOSTNAME} "exit"
if [ X"$?" == X'0' ]; then
break
else
sleep 5
fi
done
echo "* Start testing iRedMail."
sh ${VM_HOSTNAME}.sh ${backend}
</pre>
<pre>
#!/usr/bin/env bash
# File: c7.sh
[ X"$#" != X'1' ] && echo 'No backend?' && exit 255
backend="${1}"
# hostname of your VMware virtual machine set in Mac OS X /etc/hosts.
HOST="c7"
echo 'copying iRedMail ...'
scp -r ~/projects/iredmail/iRedMail root@${HOST}:~ >/dev/null
echo 'copying pkgs/misc ...'
scp -r misc root@${HOST}:~/iRedMail/pkgs/ >/dev/null
scp -r config.${backend} root@${HOST}:~/iRedMail/config >/dev/null
echo 'copying archives ...'
scp -r rhel/7/yum root@${HOST}:/var/cache/ >/dev/null
echo 'updating .status ...'
ssh root@${HOST} "echo export status_check_new_iredmail='DONE' > /root/iRedMail/.status"
ssh root@${HOST} "echo export status_fetch_pkgs='DONE' >> /root/iRedMail/.status"
ssh root@${HOST} "echo export status_fetch_misc='DONE' >> /root/iRedMail/.status"
ssh root@${HOST} "echo export status_cleanup_update_clamav_signatures='DONE' >> /root/iRedMail/.status"
ssh root@${HOST} "cd /root/iRedMail/ && yum clean metadata && AUTO_USE_EXISTING_CONFIG_FILE=y AUTO_INSTALL_WITHOUT_CONFIRM=y AUTO_CLEANUP_REMOVE_SENDMAIL=y AUTO_CLEANUP_REMOVE_MOD_PYTHON=y AUTO_CLEANUP_REPLACE_FIREWALL_RULES=y AUTO_CLEANUP_RESTART_IPTABLES=y AUTO_CLEANUP_REPLACE_MYSQL_CONFIG=y AUTO_CLEANUP_RESTART_POSTFIX=n bash iRedMail.sh"
ssh root@${HOST} "/usr/bin/systemctl stop firewalld"
#ssh root@${HOST} "mkdir /root/pro && cp /var/www/iredadmin/settings.py /root/pro/"
#scp -r clamav/* root@${HOST}:/var/lib/clamav/
#ssh root@${HOST} "chown clamupdate:clamupdate /var/lib/clamav/*"
ssh root@${HOST} "echo 'reboot'; reboot"
</pre>