155 lines
5.6 KiB
Markdown
155 lines
5.6 KiB
Markdown
# 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 create a new one.
|
|
|
|
You can create a sample config file by executing iRedMail installer:
|
|
|
|
```bash
|
|
# bash iRedMail.sh
|
|
```
|
|
|
|
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:
|
|
|
|
```bash
|
|
# 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
|
|
```
|
|
|
|
## Sample Deployment
|
|
|
|
Here's how i preform iRedMail tests every day with VMware Fusion on Mac OS X,
|
|
all are completed automatically with a shell command.
|
|
|
|
* Install a clean, basic/minimal OS (Debian/CentOS/OpenBSD/FreeBSD, 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 VMware
|
|
command line tool `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:
|
|
|
|
```shell
|
|
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"
|
|
```
|
|
|
|
* Reboot server.
|
|
|
|
It should complete in 2-3 minutes (uploading binary packages takes most time),
|
|
then i got a working iRedMail server. I do this many times every 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:
|
|
|
|
```shell
|
|
# 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
|
|
```
|
|
|
|
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.
|
|
|
|
```shell
|
|
#!/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}
|
|
```
|
|
|
|
```shell
|
|
#!/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"
|
|
```
|