2,187
edits
Difference between revisions of "Zimbra"
Jump to navigation
Jump to search
m
Updated to use Depreciated template
(→Procedures: Added "Change Hostname") |
m (Updated to use Depreciated template) |
||
| (5 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{Depreciated|category=Zimbra}} | |||
== Installation == | == Installation == | ||
The notes below are for the situation of installing a Zimbra server in a split-DNS scenario. Split DNS is required where you have a Zimbra server on an internal (private address range) network. Zimbra needs to be able to resolve its own MX DNS record, therefore if your server is known publicly by one IP address, but in fact has an internal address (and the public IP is NAT'ed to the internal IP) you'll need to use split DNS. The method below uses a DNS server installed locally on the Zimbra server, however you can also use a DNS server on your local network, if you have one available. | |||
=== DNS Records === | === DNS Records === | ||
Firstly, you need to own a public domain name, then get your ISP to create two DNS records... | Firstly, you need to own a public domain name, then get your ISP to create two DNS records... | ||
| Line 7: | Line 11: | ||
# '''A record''' - Standard DNS record | # '''A record''' - Standard DNS record | ||
#* EG <code> mail.sandfordit.com [A] -> 158.25.34.124 </code> | #* EG <code> mail.sandfordit.com [A] -> 158.25.34.124 </code> | ||
#* <code> 158.25.34.124 </code> is the static IP address assigned by your ISP. You'll need to set-up a NAT on your router (often oddly called a virtual server in domestic routers) to map incoming mail on TCP 25 to your email server's actual address (EG <code> 158.25.34.124:25 -> 192.168.1.150:25 </code>. | #* <code> 158.25.34.124 </code> is the static IP address assigned by your ISP. You'll need to set-up a NAT on your router (often oddly called a virtual server in domestic routers) to map incoming mail on TCP 25 to your email server's actual address (EG <code> 158.25.34.124:25 -> 192.168.1.150:25 </code>). | ||
Note, instead of an A record you can use a CNAME record if you prefer, though obviously the CNAME record will still need to point to a valid A record. Using a CNAME might be preferable, if for example you've multiple services running from a single public IP, that you might want to split out in the future to run on separate IP's, at which point you can replace the CNAME records with A records. | Note, instead of an A record you can use a CNAME record if you prefer, though obviously the CNAME record will still need to point to a valid A record. Using a CNAME might be preferable, if for example you've multiple services running from a single public IP, that you might want to split out in the future to run on separate IP's, at which point you can replace the CNAME records with A records. | ||
| Line 195: | Line 199: | ||
# Exit Zimbra user and create copy of directory | # Exit Zimbra user and create copy of directory | ||
#* EG <code> cp -rp /opt/zimbra /home/simons/zimbra_backup_100301 </code> | #* EG <code> cp -rp /opt/zimbra /home/simons/zimbra_backup_100301 </code> | ||
# Once completed, go back to zimbra user and start | |||
#* <code> su - zimbra </code> | |||
#* <code> zmcontrol start </code> | |||
<br>'''More elaborate scripted version'''<br> | <br>'''More elaborate scripted version'''<br> | ||
| Line 211: | Line 218: | ||
To restore, see http://www.zimbra.com/forums/administrators/15275-solved-yet-another-backup-script-community-version-24.html | To restore, see http://www.zimbra.com/forums/administrators/15275-solved-yet-another-backup-script-community-version-24.html | ||
I've modified the above script, to suit my own purposes. I've added an FTP option so that completed backup's are copied off to a remote FTP server (the copy isn't encrypted so should only be used within a private/secure network - [[Zimbra FOSS Full Backup]] | |||
=== Upgrade === | === Upgrade === | ||
| Line 378: | Line 387: | ||
and so update to say 20 MB, use... | and so update to say 20 MB, use... | ||
* <code> zmprov modifyConfig zimbraMailContentMaxSize 20480000 </code> | * <code> zmprov modifyConfig zimbraMailContentMaxSize 20480000 </code> | ||
== Troubleshooting == | |||
=== Account Export Incomplete === | |||
When trying to export an entire (or partial) account's data (either via the web or Zimbra clients, or through a <code>/zmmailbox -z -m "user@domain.com" getRestURL -o user.tgz "//?fmt=tgz"</code>), the export can occasionally be incomplete, this can be due to two reasons (maybe more)... | |||
* '''Large account / export time-out''' | |||
** If you've a large account, and/or a slow server, the export process can time out. | |||
** This is due to known bug - http://bugzilla.zimbra.com/show_bug.cgi?id=56458 | |||
*''' Invalid tags ''' | |||
** This is essentially down to some database corruption. | |||
** To confirm that its the issue, tail your <code>/opt/zimbra/log/mailbox.log</code> file when creating an export and look out for the following errors (tag 68 is the problem tag ID in this example) | |||
*** <code> Code:mail.NO_SUCH_TAG Arg:(itemId, IID, "68")</code> | |||
*** <code> java.io.IOException: data error: java.io.IOException: tag error: com.zimbra.cs.mailbox.MailServiceException$NoSuchItemException: no such tag: 68</code> | |||
** To resolve... | |||
**# Confirm that the account doesn't have the tag | |||
**#* <code> zmmailbox -z -m "user@domain.com" gat </code> | |||
**# Get the user to create enough dummy tags to reach the problem ID number | |||
**# Reattempt the export - it may fail again, but on a higher tag ID (repeat the above until it succeeds) | |||
**# Delete the dummy tags, and retest | |||
The above is based on info gleamed from http://www.zimbra.com/forums/administrators/48724-no_such_tag-while-exporting.html | |||
== Documentation Links == | == Documentation Links == | ||
* '''[http://wiki.zimbra.com/index.php?title=Working_with_Zimlets Zimlets]''' | * '''[http://wiki.zimbra.com/index.php?title=Working_with_Zimlets Zimlets]''' | ||
* '''[http://wiki.zimbra.com/wiki/Zimbra_Desktop_FAQ#How_to_install_spell_checker_dictionaries.3F Zimbra Client Dictionary Install]''' | * '''[http://wiki.zimbra.com/wiki/Zimbra_Desktop_FAQ#How_to_install_spell_checker_dictionaries.3F Zimbra Client Dictionary Install]''' | ||