Zimbra Collaboration 7 or previous, zmlicense error handshake failure

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Zimbra Collaboration 7 or previous, zmlicense error handshake failure

   KB 22395        Last updated on 2015-10-16  

(0 votes)


Zimbra is aware of the vulnerabilities that exist with the SSLv3 protocol. Zimbra has recently disabled SSLv3 on our Licensing Server due to the various security vulnerabilities that exist in the protocol. As a result, Customers that are running Zimbra Collaboration Server 7 or previous are going to be affected when they try to activate their servers, even if the license is properly issued and still valid.

Error when trying to activate the license in ZCS 7 or previous

In this example, you can see ZCS 7.2.7 running over a RHEL 6:

# su - zimbra
$ zmcontrol -v
Release 7.2.7_GA_2942.RHEL6_64_20140314190059 RHEL6_64 NETWORK edition.

Let's try now to see if the license is activated or not in a fresh install:

$ zmlicense -c
license not activated for 7.2.7_GA_2942

If you try to activate it, you will see the next error, due the security reasons we've explained:

$ zmlicense -a
system failure: javax.net.ssl.SSLHandshakeException: Received fatal alert: handshake_failure


1. Get the information required (fingerprint, activation ID, license ID and version) for the manual activation from the Admin Console at:

Global Settings ⇒ License ⇒ Manually Activate License


2. Go to https://support.zimbra.com and log in, then go to the license page.


3. Enter the required information and download the .xml file.

4. Upload the .xml file to the Zimbra server and enter:

$ zmlicense -A /path/to/activation/file

4.1. You can also do this using the Admin Console in Global Settings ⇒ License ⇒ Manually Activate License


5. Check for successful activation with:

$ zmlicense -t

If you have any problems, please don't hesitate contact the Zimbra Support Team.

Additional Content

You can read the Manual Activation Wiki:

Verified Against: Zimbra Collaboration Suite 7.0 Date Created: 10/16/2015
Article ID: https://wiki.zimbra.com/index.php?title=Zimbra_Collaboration_7_or_previous,_zmlicense_error_handshake_failure Date Modified: 2015-10-16

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