====== Zimbra Collaboration Server ======

See also **[[internet:mail:zimbra:zimbra_ose|Zimbra Collaboration Server OSE]]**

See also many other **[[https://www.sonoracomm.com/wiki/doku.php?do=search&id=zimbra|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

  * Minimum 10G Disk
  * Minimum 2GB RAM
  * 2GHz+ CPU
  * 64-Bit OS Required

===== 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:

  * Does full backups (including LDAP) weekly
  * Incremental backups (user data diffs) nightly
  * Retains data for one month

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'':

<file>
zmprov mcf zimbraBackupTarget "/ZimbraBackup"
</file>

==== Open Source Edition ====

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

:!: The [[http://www.zextras.com|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)

<file>
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
</file>

===== 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**.

  - **Block port 25** inbound in the firewall
    - Also block HTTP and HTTPS for major upgrades
  - **Update the host** OS (reboot)
  - Install any new prerequisites
  - **Download the latest** version of Zimbra
    * **Network**: http://www.zimbra.com/downloads/zimbra-collaboration
    * **OSE**: https://www.zimbra.org/download/zimbra-collaboration
  - **Extract** the tarball
  - **Change into the extracted folder**
    * ''cd zcs<tab>''
  - **Execute** the installer
    * ''./install.sh''
  - **Reboot**
  - **Reopen SMTP/HTTP/HTTPS ports** in the firewall

<file>
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
</file>

===== Uninstall =====

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

===== Prepare to Install =====

<note tip>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.</note>

<note tip>Don't forget to take snapshots as you go if you are using a virtualized host, just in case.</note>

==== 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 **[[computing:linux:minimal_centos_install|Centos 6 x64 Minimal Install]]**.

==== DNS ====

Assure that name resolution is working to the Zimbra host.

  * **Forward**
    * A record
  * **Reverse**
    * PTR record
  * **Mail Exchanger**
    * MX record

==== Hostname ====

<file>
vim /etc/hosts

vim /etc/hostname
</file>

==== Static IP Address ====

See also **[[networking:linux:static_ip_addr|Static IP Address]]**.

==== Disable Firewall for Installation ====

See also **[[internet:mail:zimbra:zimbra_firewall|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.

<file>
iptables -nL

service iptables stop
service ip6tables stop
</file>

==== Update the Host OS ====

<file>
apt-get update && apt-get -y dist-upgrade && apt-get -y autoremove && reboot
</file>

==== Mount Storage ====

/etc/fstab example:

<file>
# 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
</file>

===== Configure Software Sources =====

FIXME

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

**[[computing:linux:epel|Using the EPEL Repository with Centos 6]]**

**[[computing:linux:repoforge|Using the RepoForge Repository for Centos 6]]**

**[[computing:linux:atomic|Using the Atomic Repository with Centos 6]]**

===== Install Zimbra OSE on Ubuntu Server =====

<file>
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
</file>

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

<note warning>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**'.</note>

===== Configure Zimbra =====

==== Trusted Networks ====

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

=== Show Current Trusted Networks ===

This shows what networks Postfix will relay for:

<file>
su - zimbra
postconf mynetworks
</file>

This checks Zimbra LDAP:

<file>
zmprov getServer `zmhostname` | grep zimbraMtaMyNetworks
</file>

=== Modify Trusted Networks ====

Using info from above:

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

===== Administration =====

==== Stop and Start Services ====

<file>
service zimbra start|stop|restart
</file>

Run commands as 'zimbra' user:

<file>
su - zimbra

zmcontrol status|start|stop
</file>

==== 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

<file>
su - zimbra
zmtlsctl both
zmcontrol stop
zmcontrol start
</file>

==== Storage ====

=== Volumes ===

  * Primary - Uncompressed
    * Current - Where New Messages Are Stored
  * Secondary - HSM Target - Compressed
  * Index

**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 ====

  * With Zimbra 8, there is now an 80GB (sparse) database file that takes a long time to copy

<file>
service zimbra stop
rsync -avr --delete /opt/zimbra /opt/zimbra.bak
</file>

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 ====

  - Install a separate hard drive in your Zimbra server
  - 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
  - Partition the new drive with one large partition
    * Use [[computing:storage:disk_partitioning|GPT]] partition table for drives over 2GB
  - Format the new partition
    * Consider using the XFS filesystem
      * ''mkfs.xfs /dev/sdx1''
  - 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:
<file>
zmprov mcf zimbraBackupTarget "/ZimbraBackup"
</file>

Per server:
<file>
zmprov ms `zmhostname` zimbraBackupTarget /tmp/backup
</file>

==== Backup Schedule ====

<file>
zmschedulebackup --help

zmschedulebackup
</file>

===== Zimlets =====

<note tip>**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.</note>

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

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

<file>
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
</file>

===== 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/

  * ZxCHat is a free feature of the ZeXtras Suite
  * The ZxChat feature continues working even after the trial period has expired

===== Split Domain =====

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

http://67.228.123.109/node/6413

===== Domains =====

Rename domain:

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

Set default domain:

**Zimbra Admin -> Configure -> Global -> General -> Default Domain**

<file>
zmprov mcf zimbraDefaultDomainName mycompany.com
</file>