PostRestURL Without Split DNS: Difference between revisions

No edit summary
No edit summary
Line 1: Line 1:
{{ZC}}{{Article Infobox|{{admin}}|{{ZCS 6.0}}|{{ZCS 5.0}}|}}<small>''For a complete listing of troubleshooting articles and categories, see [[:Category:Troubleshooting]].''</small>
{{ZC}}{{Archive}}{{WIP}}{{Article Infobox|{{admin}}|{{ZCS 6.0}}|{{ZCS 5.0}}|}}<small>''For a complete listing of troubleshooting articles and categories, see [[:Category:Troubleshooting]].''</small>


=Symptoms=
=Symptoms=

Revision as of 18:24, 25 March 2015

Admin Article

Article Information

This article applies to the following ZCS versions.

ZCS 6.0 Article ZCS 6.0 ZCS 5.0 Article ZCS 5.0

For a complete listing of troubleshooting articles and categories, see Category:Troubleshooting.

Symptoms

A zmmailbox postRestURL command fails with an UnknownHostException.

zmmailbox -z -m user@domain.com postRestURL "inbox?fmt=zip&timestamp=0&subfolder=/test" /tmp/sentmail.zip
ERROR: zclient.IO_ERROR (webmail.domain.com) (cause: java.net.UnknownHostException webmail.domain.com)

Cause

This issue usually occurs when the mailbox server is running in "reverse-proxied" mode and the configured value of the domain's public service hostname and port are unreachable by the server. This condition is normally caused when the architecture is configured without split DNS and/or the public service ports are blocked preventing access by the mailbox server.

zmprov -l gs `zmhostname` zimbraMailReferMode
zimbraMailReferMode: reverse-proxied

zmprov -l gd domain.com zimbraPublicServiceHostname zimbraPublicServicePort zimbraPublicServiceProtocol
zimbraPublicServiceHostname:webmail.domain.com
zimbraPublicServicePort: 443
zimbraPublicServiceProtocol: https

In the example, the error returned is java.net.UnknownHostException webmail.domain.com meaning the mailbox server is unable to resolve the public service hostname in DNS.

Solution

Add an entry in the /etc/hosts file on the mailbox server for the public service hostname that points directly to a valid reverse proxy server or the load balanced IP address (VIP) for the proxy server. If more than one proxy server is in use without a VIP, just point the public service hostname to any production proxy server and make sure TCP connectivity to the public service port is successful.

Verified Against: ZCS 6.0, 5.0 Date Created: 7/14/2011
Article ID: https://wiki.zimbra.com/index.php?title=PostRestURL_Without_Split_DNS Date Modified: 2015-03-25



Try Zimbra

Try Zimbra Collaboration with a 60-day free trial.
Get it now »

Want to get involved?

You can contribute in the Community, Wiki, Code, or development of Zimlets.
Find out more. »

Looking for a Video?

Visit our YouTube channel to get the latest webinars, technology news, product overviews, and so much more.
Go to the YouTube channel »

Jump to: navigation, search