Table of Contents

Zimbra Collaboration Server

See also Zimbra Collaboration Server OSE

See also many other Zimbra pages on this wiki.

Quickstart: http://www.zimbra.com/docs/ne/latest/single_server_install

Downloads: http://www.zimbra.com/downloads/ne-downloads.html

Docs: http://www.zimbra.com/support/

FAQ: http://wiki.zimbra.com/wiki/Top_10_FAQ

Zimbra Editions

Compare Versions: http://www.binario01.it/wp-content/uploads/2014/09/Zimbra-Collaboration-8.5-Product-Edition-Comparison-Commercial-Version.pdf

Network Edition

:!: The minimum number of mailboxes is 25.

The paid versions of Zimbra offer more backup options.

https://www.zimbra.com/docs/ne/8.6.0/administration_guide/wwhelp/wwhimpl/js/html/wwhelp.htm#href=860_admin_ne.Backup_and_Restore.html

By default, Zimbra Network Edition automatically:

If you have the disk space for it, it's recommended to leave this configuration. Otherwise you can update it with zmschedulebackup.

For restore operations, you'll be using zmrestore or the web admin interface.

Change the backup location from the default /opt/zimbra/backup:

zmprov mcf zimbraBackupTarget "/ZimbraBackup"

Open Source Edition

Downloads: https://www.zimbra.org/download/zimbra-collaboration

:!: The ZeXtras Suite offers automated backups.

OSE Features: https://www.zimbra.com/open-source/features

http://wiki.zimbra.com/wiki/Open_Source_Edition_Backup_Procedure

Here is a method that uses rsync to minimize the down-time of your Zimbra server during backups:

http://wiki.zimbra.com/wiki/Talk:Backing_up_and_restoring_Zimbra_%28Open_Source_Version%29

Here is a simple method that uses an extra disk drive as the target (Parts 1 and 2):

http://www.youtube.com/watch?v=xhUksAhpBxw

http://www.youtube.com/watch?v=BrHTrXiLU5o

Patching

:!: Take a snapshot before installing patches if you are in a virtualized environment.

FIXME This does not work with Zimbra 9 OSE (Zextras Build)

cd ~
mv -f zcspatch zcspatch.old
mkdir zcspatch && cd zcspatch
wget https://files.zimbra.com/downloads/8.8.6_GA_HF/zcs-patch-8.8.6_GA_HF_108839.tgz

tar -xzvf zcs-patch-*
cd zcs-patch-*
./install_patch.sh

su - zimbra
zmcontrol restart

Upgrades

https://zimbra.github.io/installguides/8.8.9/upgrade.html

:!: Take a snapshot before installing upgrades if you are in a virtualized environment.

:!: This takes some time and may require a couple of reboots

:!: If you see an error pertaining to Required Core package zimbra-core not found, make sure you are using the correct installer package.

  1. Block port 25 inbound in the firewall
    1. Also block HTTP and HTTPS for major upgrades
  2. Update the host OS (reboot)
  3. Install any new prerequisites
  4. Download the latest version of Zimbra
  5. Extract the tarball
  6. Change into the extracted folder
    • cd zcs<tab>
  7. Execute the installer
    • ./install.sh
  8. Reboot
  9. Reopen SMTP/HTTP/HTTPS ports in the firewall
cd ~
mv -f zcsinstall zcsinstall.old
mkdir zcsinstall && cd zcsinstall
wget --limit-rate=300k https://files.zimbra.com/downloads/8.8.10_GA/zcs-8.8.10_GA_3039.RHEL7_64.20180928094617.tgz
tar -xzvf zcs-*.tgz
cd zcs-*
screen ./install.sh

su - zimbra
zmcontrol restart

Uninstall

http://wiki.zimbra.com/wiki/UnInstalling_Zimbra_on_Linux

Prepare to Install

Probably the easiest way to avoid installation problems is to not change the firewall or change the SSH port before getting Zimbra installed, tested and working.
Don't forget to take snapshots as you go if you are using a virtualized host, just in case.

Host OS

:!: You will want to use custom partitioning so that the Zimbra installation is on a large, expandable (LVM) partition (/opt).

:!: Make sure you have at least a 15GB partition or you may have problems upgrading down the road.

:!: If you mount a separate disk or partition for Zimbra, mount it at /opt/zimbra.

See Centos 6 x64 Minimal Install.

DNS

Assure that name resolution is working to the Zimbra host.

Hostname

vim /etc/hosts

vim /etc/hostname

Static IP Address

See also Static IP Address.

Disable Firewall for Installation

See also Zimbra Firewall

:!: Here we disable the firewall so it doesn't cause problems during installation. You should re-enable some firewall after the initial installation and configuration.

iptables -nL

service iptables stop
service ip6tables stop

Update the Host OS

apt-get update && apt-get -y dist-upgrade && apt-get -y autoremove && reboot

Mount Storage

/etc/fstab example:

# add /opt/zimbra/store
/dev/disk/by-uuid/a398b8ef-16b7-42f5-bba5-96e6249af038 /opt/zimbra/store ext4 defaults,noatime,nodiratime,dirsync 1 2

# add /opt/zimbra/store2
/dev/disk/by-uuid/ead24e00-7be4-4e42-be1a-66e37925640c /opt/zimbra/store2 ext4 defaults,noatime,nodiratime,dirsync 1 2

# Add Zextras Backup store
10.0.0.100:/backup/va-backup-zimbra3  /opt/zimbra/backup/zextras  nfs _netdev  0 0

Configure Software Sources

FIXME

These are mostly only needed for the advanced spam filtering steps listed below.

Using the EPEL Repository with Centos 6

Using the RepoForge Repository for Centos 6

Using the Atomic Repository with Centos 6

Install Zimbra OSE on Ubuntu Server

wget --limit-rate=300k https://files.zimbra.com/downloads/8.8.8_GA/zcs-8.8.8_GA_2009.UBUNTU16_64.20180322150747.tgz

tar -xzvf zcs-<tab>

cd zcs-<tab>

./install.sh

License path to type in: /root/ZCSLicense.xml

Near the end of the install you are asked if you want to change the domain name. You should read the message then answer 'Yes'. Change the domain name to just 'domain.tld' instead of 'hostname.domain.tld'.

Configure Zimbra

Trusted Networks

http://wiki.zimbra.com/wiki/ZimbraMtaMyNetworks

Show Current Trusted Networks

This shows what networks Postfix will relay for:

su - zimbra
postconf mynetworks

This checks Zimbra LDAP:

zmprov getServer `zmhostname` | grep zimbraMtaMyNetworks

Modify Trusted Networks

Using info from above:

zmprov modifyServer `zmhostname` zimbraMtaMyNetworks '127.0.0.0/8 192.168.0.0/24 10.10.130.0/24'
postfix reload

Administration

Stop and Start Services

service zimbra start|stop|restart

Run commands as 'zimbra' user:

su - zimbra

zmcontrol status|start|stop

Web Browser Access

Admin

Zimbra admin URL in browser:

https://zimbra.yourdomain.com:7071/

Admin username: admin or admin@yourdomain.com

User

User logins:

http://zimbra.yourdomain.com

Mobile webclient:

http://zimbra.yourdomain.com/zimbra/m/

External Client Access

http://wiki.zimbra.com/wiki/CLI_zmtlsctl_to_set_Web_Server_Mode

http://wiki.zimbra.com/index.php?title=Zmtlsctl

http://wiki.zimbra.com/wiki/Administration_Console_and_CLI_Certificate_Tools

su - zimbra
zmtlsctl both
zmcontrol stop
zmcontrol start

Storage

Volumes

Storage Management: http://docs.zimbra.com/docs/ne/8.0.3/administration_guide/wwhelp/wwhimpl/common/html/wwhelp.htm#href=8.0.3_Network.Storage_Management.html

Backup

http://wiki.zimbra.com/wiki/Backup_and_Restore_Articles

Create a full backup before mucking around with Zimbra

service zimbra stop
rsync -avr --delete /opt/zimbra /opt/zimbra.bak

Once this backup has been created, it will subsequently be much quicker, assuming you have disk space to spare for the backup. You did check that first, right?

Use a Separate Hard Drive for Backups

  1. Install a separate hard drive in your Zimbra server
  2. Connect the new hard drive to a separate disk controller
    • This is important if you have a RAID controller for primary storage
    • You can usually use the controller integrated on the mainboard
  3. Partition the new drive with one large partition
    • Use GPT partition table for drives over 2GB
  4. Format the new partition
    • Consider using the XFS filesystem
      • mkfs.xfs /dev/sdx1
  5. Mount the new drive automatically at boot
    • blkid shows UUID
    • Modify /etc/fstab
      • UUID=<UUID> /opt/zimbra/backup xfs defaults 1 0
    • mount -a

Change Zimbra Backup Directory

Zimbra Network Edition has a default backup location /opt/zimbra/backup. It may be more convenient to use another location.

Global:

zmprov mcf zimbraBackupTarget "/ZimbraBackup"

Per server:

zmprov ms `zmhostname` zimbraBackupTarget /tmp/backup

Backup Schedule

zmschedulebackup --help

zmschedulebackup

Zimlets

Zimlet files must be named exactly or they will not function properly. Check this especially if you use wget to download the zimlet (.zip) file.

http://wiki.zimbra.com/wiki/Ajcody-Zimlet-Notes

https://gallery.zetalliance.org/extend/

ls -al /opt/zimbra/zimlets
ls -al /opt/zimbra/zimlets-deployed

cd /opt/zimbra/zimlets

/opt/zimbra/bin/zmzimletctl deploy <zimlet_name>.zip

/opt/zimbra/bin/zmzimletctl undeploy <zimlet_name>

zmprov fc zimlet

# to enable for one or more CoS
zmzimletctl acl <zimlet_name> <cos_name1> grant <cos_name2> grant

# for all CoS
for cos in `zmprov gac`;do zmzimletctl acl <zimlet_name> $cos grant; done

zmprov ga user@example.com amavisBlacklistSender
zmprov ga user@example.com amavisWhitelistSender

Instant Messaging

:!: The built-in IM feature has been removed as of Zimbra version 8.

http://wiki.zextras.com/wiki/ZxChat

http://gallery.zimbra.com/type/zimlet/zxchat-free-instant-messaging-zimbra-8

http://www.zextras.com/

Split Domain

http://wiki.zimbra.com/wiki/Split_Domain

http://67.228.123.109/node/6413

Domains

Rename domain:

su - zimbra
zmprov -l rd <mail.example.com> <example.com>

Set default domain:

Zimbra Admin → Configure → Global → General → Default Domain

zmprov mcf zimbraDefaultDomainName mycompany.com