You are on page 1of 37

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

Zimbra: Email and collaboration for the Post-PC era


Search
User Help | Forums | Blog | Contact Us | Buy Zimbra
Learn
Products
Community
Support
Partners
Downloads
About

Jdelacruz-Notes
From Zimbra :: Wiki

1 de 37

- This article is a Work in Progress, and may be unnished or missing sections.

Contents
1 Single-Node Commercial Certicate
1.1 Generating the CSR
1.2 Checking the content of the SSL Certicate
1.3 Buying the Commercial SSL Certicate
1.4 Installing the Commercial SSL Certicate
1.5 Creating the commercial.crt
1.6 Creating the commercial_ca.crt
1.7 Checking if every le is OK
1.8 Launching the last command
2 Single-Node Multi-SAN Commercial Certicate
2.1 Generating the MultiSAN.csr le
2.2 Checking the content of the SSL Certicate
2.3 Buying the Commercial SSL Certicate
2.4 Installing the Commercial SSL Certicate
2.5 Creating the commercial_ca.crt
2.6 Checking if every le is OK
2.7 Launching the last command
2.8 Forcing the Server to use only HTTPS
3 Forcing the Server to use only HTTPS
4 Upgrade Ubuntu 10.04 64bit to Ubuntu 12.04 64bit and update ZCS 8.0.8
4.1 Stopping the Zimbra Collaboration Services
4.2 Upgrading the Ubuntu Version
4.3 Update Zimbra 8.0.8 with Ubuntu 12.04 package
5 Upgrade Ubuntu 12.04 64bit to Ubuntu 14.04 64bit and update ZCS 8.0.9
5.1 Stopping the Zimbra Collaboration Services
5.2 Upgrading the Ubuntu Version
5.3 Update Zimbra 8.0.9 with Ubuntu 14.04 package
6 Upgrade Zimbra Collaboration 8.0.7 to 8.5.0 - Ubuntu 12.04
6.1 Verifying the expiration date of the SSL Certicate
6.2 Upgrade Instructions
7 Upgrade Ubuntu 12.04 to Ubuntu 14.04 and update ZCS 8.5.0
7.1 Stopping the Zimbra Collaboration Services
7.2 Upgrading the Ubuntu Version
7.3 Update Zimbra 8.5.0 with Ubuntu 14.04 package

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

8 Zimlet LinkedIn Images


8.1 Description
8.2 Conguration
8.3 LinkedIn API Key
8.4 Conguring & Installing the Zimlet
8.5 Conguring & Using in our Web Client
9 VMware HA script in Zimbra Collaboration
9.1 VMware vSphere HA VM Monitoring
9.2 How to activate it in Zimbra Collaboration
9.3 How to activate vSphere HA VM Monitoring
9.3.1 vSphere Client
9.3.2 vSphere web Client
9.4 Testing the Zimbra vmware-ha script
9.5 Log File
10 Migrate from cPanel/Plesk to Zimbra Collaboration 8.0.x 8.x
10.1 Export the cPanel account list
10.2 Creating the 2 main XML les
10.2.1 Account provision XML
10.2.2 IMAP data import xml
10.3 The Zimbra Account Migration Tool

Single-Node Commercial Certicate


Some theory about SSL Certicates and words that we will use in this tutorial:
CSR (Certicate Signing Request): A CSR or also Certicate Signing request is a encrypted le with
information about the company. This le is generated in our server, the Information that contains inside we
discussed in a previous article. A Certicate authority uses this CSR for take the information and create the SSL
Certicate.
Private Key: We told before that CSR is a encrypted le, we used for encrypt it a Private Key, that is unique. The
CSR and the SSL certicate will only works if we have the Private key. So the best practice is do a Backup of the
Private Key and the CSR just in case we can have any problem. But keep in a secure place.
We will moving us to the correct folder inside our Server for generate the les that we will need:
cd /tmp

Generating the CSR


Using the tool zmcertmgr, the Zimbra system will create the CSR, and also automatically doing a Backup of the
existing Cert, great.
zimbra@help:# /opt/zimbra/bin/zmcertmgr createcsr comm -new -subject "/C=GB/ST=London/L=London/O=Zimbra/OU=Zimbra IT/CN=help.zimbra.com"
** Generating a server csr for download comm -new -subject /C=GB/ST=London/L=London/O=Zimbra/OU=Zimbra IT/CN=help.zimbra.com
** Creating /opt/zimbra/conf/zmssl.cnf...done
** Backup /opt/zimbra/ssl/zimbra to /opt/zimbra/ssl/zimbra.20141006233154
** Creating /opt/zimbra/conf/zmssl.cnf...done
** Creating server cert request /opt/zimbra/ssl/zimbra/commercial/commercial.csr...done.
** Saving server config key zimbraSSLPrivateKey...done.
root@help:/opt/zimbra/ssl/zimbra/commercial# /opt/zimbra/bin/zmcertmgr viewcsr comm commercial.csr
subject=/C=GB/ST=London/L=London/O=Zimbra/OU=Zimbra IT/CN=help.zimbra.com
SubjectAltName=
zimbra@help:#

We will need this two les located in this location: /opt/zimbra/ssl/zimbra/commercial/:


commercial.csr: This is the le that we need to provide to the CA Authority
commercial.key: The Private Key that we need to save, or do a Backup if we want to install the CRT in other
Server, or restore it in case of any fail.

Checking the content of the SSL Certicate


Now we can check trough CLI if everything in the SSL is allright with the next command:

2 de 37

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

zimbra@help:/tmp# /opt/zimbra/bin/zmcertmgr viewcsr comm commercial.csr


subject=/C=GB/ST=London/L=London/O=Zimbra/OU=Zimbra IT/CN=help.zimbra.com
SubjectAltName=

Another good method to check if everything is allright is using external websites, the only thing that we need to do is
paste our CSR content, we can view it doing a more command:
zimbra@help:/tmp# more /opt/zimbra/ssl/zimbra/commercial/commercial.csr

We recommend one of this three:


[1] (https://secure.comodo.net/utilities/decodeCSR.html) Comodo DecodeCSR
[2] (https://ssltools.websecurity.symantec.com/checker/views/csrCheck.jsp) Symantec CSR Check
[3] (https://www.sslshopper.com/csr-decoder.html) SSLShoper CSR Decoder
Using these web pages is quite easy, we just copy the CSR content and paste into this pages, take a look of this
example in Symantec Website:

Buying the Commercial SSL Certicate


The next step is buy a valid commercial SSL certicate. Have tons of webpages around the World that you can use.
This Companies will ask us about the CSR and our Business Information. And once the verication has a success they
will send to us a le with the SSL Certicate (usually is a le with .crt extension)

Installing the Commercial SSL Certicate


When we have everything from our SSL Certicate authority, is time to put it in the correct folder.

Creating the commercial.crt

3 de 37

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

This le is easy to create, we only need to create that and paste inside the content of the le that the Certicate
authority gave it to us:
zimbra@help:/tmp# vi commercial.crt

Creating the commercial_ca.crt


The le called commercial_ca.crt needs to be created with the correct information, we need to mix the Root
Certicate and also The Intermediate Certicate, the order matters, so the le need to include CA
INTERMEDIATE or INTERMEDIATES, CA ROOT one in the end of other with only one Backspace:
zimbra@help:/tmp# vi commercial_ca.crt

For example, this is how looks the le commercial_ca.crt with date September 2014 with a Geotrust QuickSSL
Premium Certicate:
-----BEGIN CERTIFICATE----MIID+jCCAuKgAwIBAgIDAjbSMA0GCSqGSIb3DQEBBQUAMEIxCzAJBgNVBAYTAlVT
MRYwFAYDVQQKEw1HZW9UcnVzdCBJbmMuMRswGQYDVQQDExJHZW9UcnVzdCBHbG9i
YWwgQ0EwHhcNMTAwMjI2MjEzMjMxWhcNMjAwMjI1MjEzMjMxWjBhMQswCQYDVQQG
EwJVUzEWMBQGA1UEChMNR2VvVHJ1c3QgSW5jLjEdMBsGA1UECxMURG9tYWluIFZh
bGlkYXRlZCBTU0wxGzAZBgNVBAMTEkdlb1RydXN0IERWIFNTTCBDQTCCASIwDQYJ
KoZIhvcNAQEBBQADggEPADCCAQoCggEBAKa7jnrNpJxiV9RRMEJ7ixqy0ogGrTs8
KRMMMbxp+Z9alNoGuqwkBJ7O1KrESGAA+DSuoZOv3gR+zfhcIlINVlPrqZTP+3RE
60OUpJd6QFc1tqRi2tVI+Hrx7JC1Xzn+Y3JwyBKF0KUuhhNAbOtsTdJU/V8+Jh9m
cajAuIWe9fV1j9qRTonjynh0MF8VCpmnyoM6djVI0NyLGiJOhaRO+kltK3C+jgwh
w2LMpNGtFmuae8tk/426QsMmqhV4aJzs9mvIDFcN5TgH02pXA50gDkvEe4GwKhz1
SupKmEn+Als9AxSQKH6a9HjQMYRX5Uw4ekIR4vUoUQNLIBW7Ihq28BUCAwEAAaOB
2TCB1jAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFIz02ZMKR7wAoErOS3VuoLaw
sn78MB8GA1UdIwQYMBaAFMB6mGiNifurBWQMEX2qfWW4ysxOMBIGA1UdEwEB/wQI
MAYBAf8CAQAwOgYDVR0fBDMwMTAvoC2gK4YpaHR0cDovL2NybC5nZW90cnVzdC5j
b20vY3Jscy9ndGdsb2JhbC5jcmwwNAYIKwYBBQUHAQEEKDAmMCQGCCsGAQUFBzAB
hhhodHRwOi8vb2NzcC5nZW90cnVzdC5jb20wDQYJKoZIhvcNAQEFBQADggEBADOR
NxHbQPnejLICiHevYyHBrbAN+qB4VqOC/btJXxRtyNxflNoRZnwekcW22G1PqvK/
ISh+UqKSeAhhaSH+LeyCGIT0043FiruKzF3mo7bMbq1vsw5h7onOEzRPSVX1ObuZ
lvD16lo8nBa9AlPwKg5BbuvvnvdwNs2AKnbIh+PrI7OWLOYdlF8cpOLNJDErBjgy
YWE5XIlMSB1CyWee0r9Y9/k3MbBn3Y0mNhp4GgkZPJMHcCrhfCn13mZXCxJeFu1e
vTezMGnGkqX2Gdgd+DYSuUuVlZzQzmwwpxb79k1ktl8qFJymyFWOIPllByTMOAVM
IIi0tWeUz12OYjf+xLQ=
-----END CERTIFICATE---------BEGIN CERTIFICATE----MIIDfTCCAuagAwIBAgIDErvmMA0GCSqGSIb3DQEBBQUAME4xCzAJBgNVBAYTAlVT
MRAwDgYDVQQKEwdFcXVpZmF4MS0wKwYDVQQLEyRFcXVpZmF4IFNlY3VyZSBDZXJ0
aWZpY2F0ZSBBdXRob3JpdHkwHhcNMDIwNTIxMDQwMDAwWhcNMTgwODIxMDQwMDAw
WjBCMQswCQYDVQQGEwJVUzEWMBQGA1UEChMNR2VvVHJ1c3QgSW5jLjEbMBkGA1UE
AxMSR2VvVHJ1c3QgR2xvYmFsIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB
CgKCAQEA2swYYzD99BcjGlZ+W988bDjkcbd4kdS8odhM+KhDtgPpTSEHCIjaWC9m
OSm9BXiLnTjoBbdqfnGk5sRgprDvgOSJKA+eJdbtg/OtppHHmMlCGDUUna2YRpIu
T8rxh0PBFpVXLVDviS2Aelet8u5fa9IAjbkU+BQVNdnARqN7csiRv8lVK83Qlz6c
JmTM386DGXHKTubU1XupGc1V3sjs0l44U+VcT4wt/lAjNvxm5suOpDkZALeVAjmR
Cw7+OC7RHQWa9k0+bw8HHa8sHo9gOeL6NlMTOdReJivbPagUvTLrGAMoUgRx5asz
PeE4uwc2hGKceeoWMPRfwCvocWvk+QIDAQABo4HwMIHtMB8GA1UdIwQYMBaAFEjm
aPkr0rKV10fYIyAQTzOYkJ/UMB0GA1UdDgQWBBTAephojYn7qwVkDBF9qn1luMrM
TjAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjA6BgNVHR8EMzAxMC+g
LaArhilodHRwOi8vY3JsLmdlb3RydXN0LmNvbS9jcmxzL3NlY3VyZWNhLmNybDBO
BgNVHSAERzBFMEMGBFUdIAAwOzA5BggrBgEFBQcCARYtaHR0cHM6Ly93d3cuZ2Vv
dHJ1c3QuY29tL3Jlc291cmNlcy9yZXBvc2l0b3J5MA0GCSqGSIb3DQEBBQUAA4GB
AHbhEm5OSxYShjAGsoEIz/AIx8dxfmbuwu3UOx//8PDITtZDOLC5MH0Y0FWDomrL
NhGc6Ehmo21/uBPUR/6LWlxz/K7ZGzIZOKuXNBSqltLroxwUCEm2u+WR74M26x1W
b8ravHNjkOR/ez4iyz0H7V84dJzjA1BOoa+Y7mHyhD8S
-----END CERTIFICATE---------BEGIN CERTIFICATE----MIIDIDCCAomgAwIBAgIENd70zzANBgkqhkiG9w0BAQUFADBOMQswCQYDVQQGEwJV
UzEQMA4GA1UEChMHRXF1aWZheDEtMCsGA1UECxMkRXF1aWZheCBTZWN1cmUgQ2Vy
dGlmaWNhdGUgQXV0aG9yaXR5MB4XDTk4MDgyMjE2NDE1MVoXDTE4MDgyMjE2NDE1
MVowTjELMAkGA1UEBhMCVVMxEDAOBgNVBAoTB0VxdWlmYXgxLTArBgNVBAsTJEVx
dWlmYXggU2VjdXJlIENlcnRpZmljYXRlIEF1dGhvcml0eTCBnzANBgkqhkiG9w0B
AQEFAAOBjQAwgYkCgYEAwV2xWGcIYu6gmi0fCG2RFGiYCh7+2gRvE4RiIcPRfM6f
BeC4AfBONOziipUEZKzxa1NfBbPLZ4C/QgKO/t0BCezhABRP/PvwDN1Dulsr4R+A
cJkVV5MW8Q+XarfCaCMczE1ZMKxRHjuvK9buY0V7xdlfUNLjUA86iOe/FP3gx7kC
AwEAAaOCAQkwggEFMHAGA1UdHwRpMGcwZaBjoGGkXzBdMQswCQYDVQQGEwJVUzEQ
MA4GA1UEChMHRXF1aWZheDEtMCsGA1UECxMkRXF1aWZheCBTZWN1cmUgQ2VydGlm
aWNhdGUgQXV0aG9yaXR5MQ0wCwYDVQQDEwRDUkwxMBoGA1UdEAQTMBGBDzIwMTgw
ODIyMTY0MTUxWjALBgNVHQ8EBAMCAQYwHwYDVR0jBBgwFoAUSOZo+SvSspXXR9gj
IBBPM5iQn9QwHQYDVR0OBBYEFEjmaPkr0rKV10fYIyAQTzOYkJ/UMAwGA1UdEwQF
MAMBAf8wGgYJKoZIhvZ9B0EABA0wCxsFVjMuMGMDAgbAMA0GCSqGSIb3DQEBBQUA
A4GBAFjOKer89961zgK5F7WF0bnj4JXMJTENAKaSbn+2kmOeUJXRmm/kEd5jhW6Y
7qj/WsjTVbJmcVfewCHrPSqnI0kBBIZCe/zuf6IWUrVnZ9NA2zsmWLIodz2uFHdh
1voqZiegDfqnc1zqcPGUIWVEX/r87yloqaKHee9570+sB3c4
-----END CERTIFICATE-----

Checking if every le is OK

4 de 37

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

Also with all of these steps, we could do something wrong, we could check if everything is alright before deploy the
SSL Certicate, for test all les we will execute the next:
zimbra@help:/opt/zimbra/bin/zmcertmgr verifycrt comm commercial.key commercial.crt commercial_ca.crt

If everything is allright, the result of the command will be:


** Verifying commercial.crt against commercial.key
Certificate (commercial.crt) and private key (commercial.key) match.
Valid Certificate: commercial.crt: OK

Launching the last command


If we don't have any issue in the previous step, is time to launch the last two command here:
zimbra@help:/tmp# /opt/zimbra/bin/zmcertmgr deploycrt comm commercial.crt commercial_ca.crt

The Logle will be like this:


** Verifying commercial.crt against /opt/zimbra/ssl/zimbra/commercial/commercial.key
Certificate (commercial.crt) and private key (/opt/zimbra/ssl/zimbra/commercial/commercial.key) match.
Valid Certificate: commercial.crt: OK
** Copying commercial.crt to /opt/zimbra/ssl/zimbra/commercial/commercial.crt
** Appending ca chain commercial_ca.crt to /opt/zimbra/ssl/zimbra/commercial/commercial.crt
** Importing certificate /opt/zimbra/ssl/zimbra/commercial/commercial_ca.crt to CACERTS as zcs-user-commercial_ca...done.
** NOTE: mailboxd must be restarted in order to use the imported certificate.
** Saving server config key zimbraSSLCertificate...done.
** Saving server config key zimbraSSLPrivateKey...done.
** Installing mta certificate and key...done.
** Installing slapd certificate and key...done.
** Installing proxy certificate and key...done.
** Creating pkcs12 file /opt/zimbra/ssl/zimbra/jetty.pkcs12...done.
** Creating keystore file /opt/zimbra/mailboxd/etc/keystore...done.
** Installing CA to /opt/zimbra/conf/ca...done.

Single-Node Multi-SAN Commercial Certicate


Have a Multi-SAN certicate simplify the task of secure the Zimbra Infrastructure with only one Certicate, so we will
have only one CSR to renew each year, etc. Also the Multi-SAN SSL Certicates permit us add more ALT names if we
need it and modify as well, we only need to generate the CSR with the changes and send it to the CA Authority.

Generating the MultiSAN.csr le


We will create a le that we can update per each domain that we will need to use in the future. Also we can update it
for remove, or modify domains inside it.
We will start moving us to the correct folder inside our Server for generate the les that we will need:
cd /tmp/

Then is time to create the CSR le, in this le we need to change the name of our Private Key, our Common Name and
also the alternative domains that we want to protect with our SSL.

/opt/zimbra/bin/zmcertmgr createcsr comm -new -subject "/C=GB/ST=London/L=London/O=Zimbra/OU=Zimbra IT/CN=mail.domain.com" -subjectAltNames "mail.domain.com,mail


** Generating a server csr for download comm -new -subject /C=GB/ST=London/L=London/O=Zimbra/OU=Zimbra IT/CN=mail.domain.com -subjectAltNames mail.domain.com,mai
** Creating /opt/zimbra/conf/zmssl.cnf...done
** Backup /opt/zimbra/ssl/zimbra to /opt/zimbra/ssl/zimbra.20141007154948
** Creating /opt/zimbra/conf/zmssl.cnf...done
** Creating server cert request /tmp/commercial.csr...done.
** Saving server config key zimbraSSLPrivateKey...done.
zimbra@help:/opt/zimbra/ssl/zimbra/commercial#

Checking the content of the SSL Certicate


Now we can check trough CLI if everything in the SSL is allright with the next command:

5 de 37

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

zimbra@help:/tmp# /opt/zimbra/bin/zmcertmgr viewcsr comm commercial.csr


subject=/C=GB/ST=London/L=London/O=Zimbra/OU=Zimbra IT/CN=mail.domain.com
SubjectAltName= mail.domain.com, mail2.domain.com, mail3.domain.com

We will check the CSR that we've generated, just copy the result of this command:
more commercial.csr

Inside any of this CSR Decoder's Web:


[4] (https://secure.comodo.net/utilities/decodeCSR.html) Comodo DecodeCSR
[5] (https://ssltools.websecurity.symantec.com/checker/views/csrCheck.jsp) Symantec CSR Check
[6] (https://www.sslshopper.com/csr-decoder.html) SSLShoper CSR Decoder

Buying the Commercial SSL Certicate


The next step is buy a valid commercial SSL certicate. Have tons of webpages around the World that you can use.
This Companies will ask us about the CSR and our Business Information. And once the verication has a success they
will send to us a le with the SSL Certicate (usually is a le with .crt extension)

Installing the Commercial SSL Certicate


We can use the same instructions explained here:

Creating the commercial_ca.crt


We can use the same instructions explained here:

Checking if every le is OK
We can use the same instructions explained here:

Launching the last command


We can use the same instructions explained here:

Forcing the Server to use only HTTPS


We can use the same instructions explained here:

Forcing the Server to use only HTTPS

6 de 37

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

Now that we have a valid SSL, the best option is force to our server that only use SSL for our Web Client Access. For
do it we will use zmtlsctl command, let's take a look of all of the options here:
http - http only, the user can access to our Zimbra Web Client trough http://webmail.zimbra.com
https https only, the user can access to our Zimbra Web Client trough https://webmail.zimbra.com
both The user can access trough both protocols http:// or https:// and it will keep in the same protocol during
all session.
mixed With this option, the user will come in trought http:// and will be redirect to https:// only for the login
form, after that will be redirect to http:// again. If the user come directly trough https:// the user will be under
https:// all the time.
redirect - If the user came trough http, it will be automatically redirect to https:// and it will keep on it during all
session.

Upgrade Ubuntu 10.04 64bit to Ubuntu 12.04 64bit


and update ZCS 8.0.8
Stopping the Zimbra Collaboration Services
The rst step in this Upgrade guide is stop our Zimbra Collaboration Services:
zimbra@help:/home/# zmcontrol stop

Once we have stopped the Zimbra Collaboration services and we have a full Backup or Snapshot, we can continue.

Upgrading the Ubuntu Version


In Ubuntu 10, we need to install the update-manager-core if isnt installed.
root@zimbralab03:/# sudo apt-get install update-manager-core

Next we need to be sure that in the update manager are only selected LTS versions, check the next le, and the
prompt line must be prompt=lts
root@zimbralab03:/# sudo vi /etc/update-manager/release-upgrades

Update all the packages and dependencies before do a upgrade with the next command
root@zimbralab03:/# sudo apt-get update && sudo apt-get upgrade & sudo apt-get autoremove

Now is time for start the Upgrade proces with the next command
root@zimbralab03:/# sudo do-release-upgrade

The process will start and do some previous questions, for example about create an alternate SSH daemon, just in
case if we lose the actual SSH connection:
Continue running under SSH?
This session appears to be running under ssh. It is not recommended
to perform a upgrade over ssh currently because in case of failure it
is harder to recover.
If you continue, an additional ssh daemon will be started at port
'1022'.
Do you want to continue?
Continue [yN] y
Starting additional sshd
To make recovery in case of failure easier, an additional sshd will
be started on port '1022'. If anything goes wrong with the running
ssh you can still connect to the additional one.
To continue please press [ENTER]

After a while checking packages, the wizard will ask about the total MB to download and will require our answer, in
this case we will write Y and press ENTER:

7 de 37

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

Do you want to start the upgrade?


5 packages are going to be removed. 69 new packages are going to be
installed. 234 packages are going to be upgraded.
You have to download a total of 158 M. This download will take about
1 minute with your connection.
Installing the upgrade can take several hours. Once the download has
finished, the process cannot be canceled.
Continue [yN] Details [d]y

During the proccess, have questions like this or others, we need to take careful and select the default answer, so
only need to press ENTER all time:
Configuration file `/etc/sysctl.conf'
==> Modified (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it ? Your options are:
Y or I : install the package maintainer's version
N or O : keep your currently-installed version
D
: show the differences between the versions
Z
: start a shell to examine the situation
The default action is to keep your current version.
*** sysctl.conf (Y/I/N/O/D/Z) [default=N] ?

During the proccess will have questions prompt about delete packages, again select the dafult option:
Remove obsolete packages?
18 packages are going to be removed.
Continue [yN] Details [d]y

And after a while, the nal and good message, reboot time: System upgrade is complete.
Restart required
To finish the upgrade, a restart is required.
If you select 'y' the system will be restarted.
Continue [yN] y

Update Zimbra 8.0.8 with Ubuntu 12.04 package


The rst step is download now the correct version for our new OS, Ubuntu 14.04 LTS:
[7] (http://www.zimbra.com/downloads/os-downloads.html) Open Source Edition Download
[8] (http://www.zimbra.com/downloads/ne-downloads.html) Network Edition Download

Go into a root session and download the new version package:


root@zimbralab03:~# wget http://files2.zimbra.com/downloads/8.0.8_GA/zcs-8.0.8_GA_6184.UBUNTU12_64.20140925165850.tgz
--2014-10-25 01:40:19-- http://files2.zimbra.com/downloads/8.0.8_GA/zcs-8.0.8_GA_6184.UBUNTU12_64.20140925165850.tgz
Resolving files2.zimbra.com (files2.zimbra.com)... 54.230.10.252, 54.230.10.250, 54.230.9.119, ...
Connecting to files2.zimbra.com (files2.zimbra.com)|54.230.10.252|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 887979105 (847M) [binary/octet-stream]
Saving to: `zcs-8.0.8_GA_6184.UBUNTU12_64.20140925165850.tgz'
100%[=============================================================================================================================>] 887,979,105 12.1M/s

in

Once downloaded the package, extract it:


root@zimbralab03:~# tar xzvf zcs-8.0.8_GA_6184.UBUNTU12_64.20140925165850.tgz

Before launch the Zimbra installation, need to install some new depencies for Ubuntu 12.04
root@zimbralab03:~/zcs-8.0.8_GA_6184.UBUNTU12_64.20140925165850# apt-get install libgmp3c2 libperl5.14

Now launch the installation process with the -s ag option (Software only installation)
root@zimbralab03:~/zcs-8.0.8_GA_6184.UBUNTU12_64.20140925165850#./install.sh -s

Select yes in the 2 questions about the Software License:

8 de 37

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

Do you agree with the terms of the software license agreement? [N] y

Important! In the next step please skip it, will launch the database integrity check later:
Do you want to verify message store database integrity? [Y]

Select Yes to this question


Do you wish to upgrade? [Y]

Select yes to this question


The system will be modified.

Continue? [N] y

When have this message, means that the install.sh -s nished


Restoring existing configuration file from /opt/zimbra/.saveconfig/localconfig.xml...done
Software Installation complete!
Operations logged to /tmp/install.log.3954
Run /opt/zimbra/libexec/zmsetup.pl to configure the system

Now launch the install.sh script, but this time without the -s option
root@zimbralab03:~/zcs-8.0.8_GA_6184.UBUNTU12_64.20140925165850# ./install.sh

Operations logged to /tmp/install.log.13242 The Zimbra install process will check about the packages.
Checking for existing installation...
zimbra-ldap...FOUND zimbra-ldap-8.0.8.GA.6184.UBUNTU12.64
zimbra-logger...FOUND zimbra-logger-8.0.8.GA.6184.UBUNTU12.64
zimbra-mta...FOUND zimbra-mta-8.0.8.GA.6184.UBUNTU12.64
zimbra-snmp...FOUND zimbra-snmp-8.0.8.GA.6184.UBUNTU12.64
zimbra-store...FOUND zimbra-store-8.0.8.GA.6184.UBUNTU12.64
zimbra-apache...FOUND zimbra-apache-8.0.8.GA.6184.UBUNTU12.64
zimbra-spell...FOUND zimbra-spell-8.0.8.GA.6184.UBUNTU12.64
zimbra-convertd...NOT FOUND
zimbra-memcached...NOT FOUND
zimbra-proxy...NOT FOUND
zimbra-archiving...NOT FOUND
zimbra-cluster...NOT FOUND
zimbra-core...FOUND zimbra-core-8.0.8.GA.6184.UBUNTU12.64
ZCS upgrade from 8.0.8 to 8.0.8 will be performed.

Answer yes to the 2 questons about the Software License


Do you agree with the terms of the software license agreement? [N] y

The process will check about the prerequisites


Checking for prerequisites...
FOUND: NPTL
FOUND: netcat-openbsd-1.89-4ubuntu1
FOUND: sudo-1.8.3p1-1ubuntu3.6
FOUND: libidn11-1.23-2
FOUND: libpcre3-8.12-4
FOUND: libgmp3c2-2:4.3.2+dfsg-2ubuntu1
FOUND: libexpat1-2.0.1-7.2ubuntu1.1
FOUND: libstdc++6-4.6.3-1ubuntu5
FOUND: libperl5.14-5.14.2-6ubuntu2.4
FOUND: libaio1-0.3.109-2ubuntu1

Checking for suggested prerequisites...


FOUND: pax
FOUND: perl-5.14.2
FOUND: sysstat
FOUND: sqlite3
Prerequisite check complete.

And now, we can run without problem the Database integrity, is a good practice do it before Upgrade Zimbra
packages from Ubuntu 10.04 to Ubuntu 12.04

9 de 37

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

Checking current number of databases...


Do you want to verify message store database integrity? [Y]
Verifying integrity of message store databases. This may take a while.
Starting mysqld...done.
mysqld is alive
No errors found
mysqld is alive
Stopping mysqld... done.

The process will ask about if continues, press yes


The Zimbra Collaboration Server appears already to be installed.
It can be upgraded with no effect on existing accounts,
or the current installation can be completely removed prior
to installation for a clean install.
Do you wish to upgrade? [Y]

Select the packages that you want to install, in this example, without the memcached and proxy packages
Select the packages to install
Upgrading zimbra-core
Upgrading zimbra-ldap
Upgrading zimbra-logger
Upgrading zimbra-mta
Upgrading zimbra-snmp
Upgrading zimbra-store
Upgrading zimbra-apache
Upgrading zimbra-spell
Install zimbra-memcached [N]
Install zimbra-proxy [N]
Checking required space for zimbra-core
Checking space for zimbra-store

The last question before start the installation process


The system will be modified.

Continue? [N] y

And the process will start


Shutting down zimbra mail

Backing up the ldap database...done.

Removing existing packages

zimbra-ldap...done
zimbra-logger...done
zimbra-mta...done
zimbra-snmp...done
zimbra-store...done
zimbra-spell...done
zimbra-apache...done
zimbra-core...done

Removing deployed webapp directories


Installing packages

zimbra-core......zimbra-core_8.0.8.GA.6184.UBUNTU12.64_amd64.deb...done
zimbra-ldap......zimbra-ldap_8.0.8.GA.6184.UBUNTU12.64_amd64.deb...done
zimbra-logger......zimbra-logger_8.0.8.GA.6184.UBUNTU12.64_amd64.deb...done
zimbra-mta......zimbra-mta_8.0.8.GA.6184.UBUNTU12.64_amd64.deb...done
zimbra-snmp......zimbra-snmp_8.0.8.GA.6184.UBUNTU12.64_amd64.deb...done
zimbra-store......zimbra-store_8.0.8.GA.6184.UBUNTU12.64_amd64.deb...done
zimbra-apache......zimbra-apache_8.0.8.GA.6184.UBUNTU12.64_amd64.deb...done
zimbra-spell......zimbra-spell_8.0.8.GA.6184.UBUNTU12.64_amd64.deb...done

The system will start to update, we can see all the progress in interactive way
Restoring existing configuration file from /opt/zimbra/.saveconfig/localconfig.xml...done
Operations logged to /tmp/zmsetup.10252014-014753.log
Running zmldapapplyldif...done.
Checking ldap status....not running.
Starting ldap...done.

10 de 37

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

Setting defaults...done.
Setting defaults from existing config...done.
Checking for port conflicts
Setting defaults from ldap...done.
Saving config in /opt/zimbra/config.23712...done.
Operations logged to /tmp/zmsetup.10252014-014753.log
Setting local config values...done.
Initializing core config...Setting up CA...done.
Deploying CA to /opt/zimbra/conf/ca ...done.
Setting replication password...done.
Setting Postfix password...done.
Setting amavis password...done.
Setting nginx password...done.
Creating server entry for zimbralab03.zimbra.lab...already exists.
Setting Zimbra IP Mode...done.
Saving CA in ldap ...done.
Saving SSL Certificate in ldap ...done.
Setting spell check URL...done.
[...]
Updating non-standard zimlets...
Finished updating non-standard zimlets.
Restarting mailboxd...done.
Skipping creation of default domain GAL sync account - existing install detected.

In the end of the Installation, the wizard will ask us about Notify Zimbra, is always appreciated and good idea if we
can do it:
You have the option of notifying Zimbra of your installation.
This helps us to track the uptake of the Zimbra Collaboration Server.
The only information that will be transmitted is:
The VERSION of zcs installed (8.0.8_GA_6184_UBUNTU12_64)
The ADMIN EMAIL ADDRESS created (admin@zimbralab03.zimbra.lab)
Notify Zimbra of your installation? [Yes] yes
Setting up zimbra crontab...done.

And now we will have Zimbra 8.0.8 and Ubuntu 12.04 working together. We can check all the log here:
Moving /tmp/zmsetup.10252014-014753.log to /opt/zimbra/log
Configuration complete - press return to exit

Upgrade Ubuntu 12.04 64bit to Ubuntu 14.04 64bit


and update ZCS 8.0.9
Stopping the Zimbra Collaboration Services
The rst step in this Upgrade guide is stop our Zimbra Collaboration Services:
zimbra@help:/home/# zmcontrol stop

Once we have stopped the Zimbra Collaboration services and we have a full Backup or Snapshot, we can continue.

Upgrading the Ubuntu Version


Now is time for start the Upgrade proces with the next command
root@zimbra-sn-u12-01:/home/oper# do-release-upgrade

The process will start and do some previous questions, for example about create an alternate SSH daemon, just in
case if we lose the actual SSH connection:

11 de 37

Continue running under SSH?


This session appears to be running under ssh. It is not recommended
to perform a upgrade over ssh currently because in case of failure it
is harder to recover.
If you continue, an additional ssh daemon will be started at port
'1022'.
Do you want to continue?
Continue [yN] y
Starting additional sshd
To make recovery in case of failure easier, an additional sshd will
be started on port '1022'.

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

Do you want to continue?

Continue [yN] y

After a while checking packages, the wizard will ask about the total MB to download and will require our answer, in
this case we will write Y and press ENTER:
Do you want to start the upgrade?
2 packages are going to be removed. 104 new packages are going to be
installed. 362 packages are going to be upgraded.
You have to download a total of 204 M. This download should take
about 1 minute with your connection.
Installing the upgrade can take several hours. Once the download has
finished, the process cannot be cancelled.
Continue [yN] Details [d]y

During the proccess, have questions like this or others, we need to take careful and select the default answer, so
only need to press ENTER all time:
Configuration file `/etc/security/limits.conf'
==> Modified (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it ? Your options are:
Y or I : install the package maintainer's version
N or O : keep your currently-installed version
D
: show the differences between the versions
Z
: start a shell to examine the situation
The default action is to keep your current version.
*** limits.conf (Y/I/N/O/D/Z) [default=N] ?

During the proccess will have questions prompt about delete packages, again select the dafult option:
Remove obsolete packages?
18 packages are going to be removed.
Continue [yN] Details [d]y

And after a while, the nal and good message, reboot time: System upgrade is complete.
Restart required
To finish the upgrade, a restart is required.
If you select 'y' the system will be restarted.
Continue [yN] y

Update Zimbra 8.0.9 with Ubuntu 14.04 package


The rst step is download now the correct version for our new OS, Ubuntu 14.04 LTS:
[9] (http://www.zimbra.com/downloads/os-downloads.html) Open Source Edition Download
[10] (http://www.zimbra.com/downloads/ne-downloads.html) Network Edition Download

Go into a root session and download the new version package:


root@zimbralab03:~# wget http://files2.zimbra.com/downloads/zcs-8.0.9_GA_6191.UBUNTU14_64.20141103151539.tgz
--2014-10-25 01:40:19-- http://files2.zimbra.com/downloads/8zcs-8.0.9_GA_6191.UBUNTU14_64.20141103151539.tgz
Resolving files2.zimbra.com (files2.zimbra.com)... 54.230.10.252, 54.230.10.250, 54.230.9.119, ...
Connecting to files2.zimbra.com (files2.zimbra.com)|54.230.10.252|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 887979105 (847M) [binary/octet-stream]
Saving to: `zcs-8.0.9_GA_6191.UBUNTU14_64.20141103151539.tgz'
100%[=============================================================================================================================>] 887,979,105 12.1M/s

in

Once downloaded the package, extract it:


root@zimbra-sn-u12-01:/home/oper# tar xzvf zcs-8.0.9_GA_6191.UBUNTU14_64.20141103151539.tgz

Before launch the Zimbra installation, need to install some new depencies for Ubuntu 12.04

12 de 37

root@zimbralab03:~/# apt-get install unzip libperl5.18

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

Now launch the installation process with the -s ag option (Software only installation)
root@zimbralab03:~/zcs-8.0.9_GA_6191.UBUNTU14_64.20141103151539#./install.sh -s

Select yes in the 2 questions about the Software License:


Do you agree with the terms of the software license agreement? [N] y

Important! In the next step please skip it, will launch the database integrity check later:
Do you want to verify message store database integrity? [Y]

Select No to this question


Do you wish to upgrade? [Y]

Select yes to this question


The system will be modified.

Continue? [N] y

When have this message, means that the install.sh -s process has nished
Restoring existing configuration file from /opt/zimbra/.saveconfig/localconfig.xml...done
Software Installation complete!
Operations logged to /tmp/install.log.3954
Run /opt/zimbra/libexec/zmsetup.pl to configure the system

Now launch the install.sh script, but this time without the -s option
root@zimbralab03:~/zcs-8.0.9_GA_6191.UBUNTU14_64.20141103151539# ./install.sh

Operations logged to /tmp/install.log.13242 The Zimbra install process will check about the packages. Checking for
existing installation...
zimbra-ldap...FOUND zimbra-ldap-8.0.9.GA.6191.UBUNTU12.64
zimbra-logger...FOUND zimbra-logger-8.0.9.GA.6191.UBUNTU12.64
zimbra-mta...FOUND zimbra-mta-8.0.9.GA.6191.UBUNTU12.64
zimbra-snmp...FOUND zimbra-snmp-8.0.9.GA.6191.UBUNTU12.64
zimbra-store...FOUND zimbra-store-8.0.9.GA.6191.UBUNTU12.64
zimbra-apache...FOUND zimbra-apache-8.0.9.GA.6191.UBUNTU12.64
zimbra-spell...FOUND zimbra-spell-8.0.9.GA.6191.UBUNTU12.64
zimbra-convertd...NOT FOUND
zimbra-memcached...NOT FOUND
zimbra-proxy...NOT FOUND
zimbra-archiving...NOT FOUND
zimbra-cluster...NOT FOUND
zimbra-core...FOUND zimbra-core-8.0.9.GA.6191.UBUNTU12.64

ZCS upgrade from 8.0.9 to 8.0.9 will be performed Answer yes to the 2 questions about the Software License
Do you agree with the terms of the software license agreement? [N] y

The process will check about the prerequisites

13 de 37

Checking for prerequisites...


FOUND: NPTL
FOUND: netcat-openbsd-1.105-7ubuntu1
FOUND: sudo-1.8.9p5-1ubuntu1
FOUND: libidn11-1.28-1ubuntu2
FOUND: libpcre3-1:8.31-2ubuntu2
FOUND: libgmp10-2:5.1.3+dfsg-1ubuntu1
FOUND: libexpat1-2.1.0-4ubuntu1
FOUND: libstdc++6-4.8.2-19ubuntu1
FOUND: libperl5.18-5.18.2-2ubuntu1
FOUND: libaio1-0.3.109-4
FOUND: unzip-6.0-9ubuntu1

Checking for suggested prerequisites...

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

FOUND: pax
FOUND: perl-5.18.2
FOUND: sysstat
FOUND: sqlite3
Prerequisite check complete.

And now, we can run without problem the Database integrity, is a good practice do it before Upgrade Zimbra
packages from Ubuntu 12.04 to Ubuntu 14.04
Checking current number of databases...
Do you want to verify message store database integrity? [Y]
Verifying integrity of message store databases. This may take a while.
Starting mysqld...done.
mysqld is alive
No errors found
mysqld is alive
Stopping mysqld... done.

The process will ask about if continues, press yes


The Zimbra Collaboration Server appears already to be installed.
It can be upgraded with no effect on existing accounts,
or the current installation can be completely removed prior
to installation for a clean install.
Do you wish to upgrade? [Y]

Select the packages that you want to install, in this example, without the memcached and proxy packages
Select the packages to install
Upgrading zimbra-core
Upgrading zimbra-ldap
Upgrading zimbra-logger
Upgrading zimbra-mta
Upgrading zimbra-snmp
Upgrading zimbra-store
Upgrading zimbra-apache
Upgrading zimbra-spell
Install zimbra-memcached [N]
Install zimbra-proxy [N]
Checking required space for zimbra-core
Checking space for zimbra-store

The last question before start the installation process


The system will be modified.

Continue? [N] y

And the process will start

14 de 37

Shutting down zimbra mail

Backing up the ldap database...done.

Removing existing packages

zimbra-ldap...done
zimbra-logger...done
zimbra-mta...done
zimbra-snmp...done
zimbra-store...done
zimbra-spell...done
zimbra-apache...done
zimbra-core...done

Removing deployed webapp directories


Installing packages

zimbra-core......zimbra-core_8.0.9.GA.6191.UBUNTU14.64_amd64.deb...done
zimbra-ldap......zimbra-ldap_8.0.9.GA.6191.UBUNTU14.64_amd64.deb...done
zimbra-logger......zimbra-logger_8.0.9.GA.6191.UBUNTU14.64_amd64.deb...done
zimbra-mta......zimbra-mta_8.0.9.GA.6191.UBUNTU14.64_amd64.deb...done
zimbra-snmp......zimbra-snmp_8.0.9.GA.6191.UBUNTU14.64_amd64.deb...done
zimbra-store......zimbra-store_8.0.9.GA.6191.UBUNTU14.64_amd64.deb...done
zimbra-apache......zimbra-apache_8.0.9.GA.6191.UBUNTU14.64_amd64.deb...done
zimbra-spell......zimbra-spell_8.0.9.GA.6191.UBUNTU14.64_amd64.deb...done

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

The system will start to update, we can see all the progress in interactive way
Restoring existing configuration file from /opt/zimbra/.saveconfig/localconfig.xml...done
Operations logged to /tmp/zmsetup.10252014-014753.log
Running zmldapapplyldif...done.
Checking ldap status....not running.
Starting ldap...done.
Setting defaults...done.
Setting defaults from existing config...done.
Checking for port conflicts
Setting defaults from ldap...done.
Saving config in /opt/zimbra/config.23712...done.
Operations logged to /tmp/zmsetup.10252014-014753.log
Setting local config values...done.
Initializing core config...Setting up CA...done.
Deploying CA to /opt/zimbra/conf/ca ...done.
Setting replication password...done.
Setting Postfix password...done.
Setting amavis password...done.
Setting nginx password...done.
Creating server entry for zimbralab03.zimbra.lab...already exists.
Setting Zimbra IP Mode...done.
Saving CA in ldap ...done.
Saving SSL Certificate in ldap ...done.
Setting spell check URL...done.
[...]
Updating non-standard zimlets...
Finished updating non-standard zimlets.
Restarting mailboxd...done.
Skipping creation of default domain GAL sync account - existing install detected.

In the end of the Installation, the wizard will ask us about Notify Zimbra, is always appreciated and good idea if we
can do it:
You have the option of notifying Zimbra of your installation.
This helps us to track the uptake of the Zimbra Collaboration Server.
The only information that will be transmitted is:
The VERSION of zcs installed (8.0.9_GA_6191_UBUNTU14_64)
The ADMIN EMAIL ADDRESS created (admin@zimbralab03.zimbra.lab)
Notify Zimbra of your installation? [Yes] yes
Setting up zimbra crontab...done.

And now we will have Zimbra 8.0.9 and Ubuntu 14.04 working together. We can check all the log here (your log name
will be dierent):
Moving /tmp/zmsetup.10252014-014753.log to /opt/zimbra/log
Configuration complete - press return to exit

Upgrade Zimbra Collaboration 8.0.7 to 8.5.0 Ubuntu 12.04


Verifying the expiration date of the SSL Certicate
Zimbra Collaboration requires always, at least, a Self-Signed SSL Certicate for do the communication between the
dierent components. The Self-Signed SSL certicate is auto-deployed once we install Zimbra Collaboration.
Is highly recommend check the SSL Certicate expiration's date, with the next command:
/opt/zimbra/bin/zmcertmgr viewdeployedcrt

If the date is near to expires, is extremely recommended re-generate the Self-Signed SSL Certicate before do the
Upgrade:
root@help:/opt/zimbra/ssl/zimbra# /opt/zimbra/bin/zmcertmgr createca -new
root@help:/opt/zimbra/ssl/zimbra# /opt/zimbra/bin/zmcertmgr createcrt -new -days 365
root@help:/opt/zimbra/ssl/zimbra# /opt/zimbra/bin/zmcertmgr deploycrt self

Upgrade Instructions
The rst thing that need to to, is download the proper Zimbra Collaboration Version, in this case for Ubuntu 12.04

15 de 37

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

LTS:
[11] (http://www.zimbra.com/downloads/os-downloads.html) Open Source Edition Downloads
[12] (http://www.zimbra.com/downloads/ne-downloads.html) Network Edition Downloads

Like root user, in this case /tmp, download the package to this folder:
root@help:/tmp# wget http://files2.zimbra.com/downloads/8.5.0_GA/zcs-8.5.0_GA_3040.UBUNTU12_64.20140816142548.tgz
HTTP request sent, awaiting response 200 OK
Length: 964955796 (920M) [binary/octet-stream]
Saving to: `zcs-8.5.0_GA_3040.UBUNTU12_64.20140816142548.tgz
100%[=============================================================================================================================>] 964,955,796 3.11M/s

in

2014-10-08 13:47:52 (2.76 MB/s) `zcs-8.5.0_GA_3040.UBUNTU12_64.20140816142548.tgz saved [964955796/964955796]


root@help:/tmp#

Once we've download it, is time to extract the le:


root@help:/tmp# tar xzvf zcs-8.5.0_GA_3040.UBUNTU12_64.20140816142548.tgz

The extract may take some time, depends on which Storage we are working. Before continue with the Upgrade, we
need to install a new depedency for Zimbra 8.5, the dependency is unzip:
root@help:/tmp/zcs-8.5.0_GA_3040.UBUNTU12_64.20140816142548# apt-get install unzip

Now we can continue with the Upgrade, is time to execute the install.sh script:
root@help:/tmp/zcs-8.5.0_GA_3040.UBUNTU12_64.20140816142548# ./install.sh
Operations logged to /tmp/install.log.895
Checking for existing installation
zimbra-ldapFOUND zimbra-ldap-8.0.7.GA.6020.UBUNTU12.64
zimbra-loggerFOUND zimbra-logger-8.0.7.GA.6020.UBUNTU12.64
zimbra-mtaFOUND zimbra-mta-8.0.7.GA.6020.UBUNTU12.64
zimbra-dnscacheNOT FOUND
zimbra-snmpFOUND zimbra-snmp-8.0.7.GA.6020.UBUNTU12.64
zimbra-storeFOUND zimbra-store-8.0.7.GA.6020.UBUNTU12.64
zimbra-apacheFOUND zimbra-apache-8.0.7.GA.6020.UBUNTU12.64
zimbra-spellFOUND zimbra-spell-8.0.7.GA.6020.UBUNTU12.64
zimbra-convertdNOT FOUND
zimbra-memcachedNOT FOUND
zimbra-proxyNOT FOUND
zimbra-archivingNOT FOUND
zimbra-clusterNOT FOUND
zimbra-coreFOUND zimbra-core-8.0.7.GA.6020.UBUNTU12.64
ZCS upgrade from 8.0.7 to 8.5.0 will be performed.
Saving existing configuration file to /opt/zimbra/.saveconfig

Once we pass all the checks, without errors, we can see the new EULA, we will write Yes or press ENTER in the
end, default option:
PLEASE READ THIS AGREEMENT CAREFULLY BEFORE USING THE SOFTWARE.
ZIMBRA, INC. (ZIMBRA) WILL ONLY LICENSE THIS SOFTWARE TO YOU IF YOU
FIRST ACCEPT THE TERMS OF THIS AGREEMENT. BY DOWNLOADING OR INSTALLING
THE SOFTWARE, OR USING THE PRODUCT, YOU ARE CONSENTING TO BE BOUND BY
THIS AGREEMENT. IF YOU DO NOT AGREE TO ALL OF THE TERMS OF THIS
AGREEMENT, THEN DO NOT DOWNLOAD, INSTALL OR USE THE PRODUCT.
License Terms for the Zimbra Collaboration Suite:
http://www.zimbra.com/license/zimbra-public-eula-2-5.html
Do you agree with the terms of the software license agreement? [N] y

Now Zimbra Collaboration will check all of the Zimbra Collaboration prerequisites:

16 de 37

Checking for prerequisites


FOUND: NPTL
FOUND: netcat-openbsd-1.89-4ubuntu1
FOUND: sudo-1.8.3p1-1ubuntu3.4
FOUND: libidn11-1.23-2
FOUND: libpcre3-8.12-4
FOUND: libgmp3c2-2:4.3.2+dfsg-2ubuntu1
FOUND: libexpat1-2.0.1-7.2ubuntu1.1
FOUND: libstdc++6-4.6.3-1ubuntu5
FOUND: libperl5.14-5.14.2-6ubuntu2.4
FOUND: libaio1-0.3.109-2ubuntu1

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

FOUND: resolvconf-1.63ubuntu16
FOUND: unzip-6.0-4ubuntu2
Checking for suggested prerequisites
FOUND: pax
FOUND: perl-5.14.2
FOUND: sysstat
FOUND: sqlite3
Prerequisite check complete.
Checking current number of databases

We always recommend do the Database Integrity Check. We can take some minutes, sometimes hours, depends of the
size and the number of errors, in case that we have, keep calm:
Do you want to verify message store database integrity? [Y]
Verifying integrity of message store databases. This may take a while.
Starting mysqlddone.
mysqld is alive
No errors found
mysqld is alive
Stopping mysqld done.

In this step we can add some additional packages in case that we want it, in this case, we will not select any new
package:
Checking for installable packages
Found
Found
Found
Found
Found
Found
Found
Found
Found
Found
Found

zimbra-core
zimbra-ldap
zimbra-logger
zimbra-mta
zimbra-dnscache
zimbra-snmp
zimbra-store
zimbra-apache
zimbra-spell
zimbra-memcached
zimbra-proxy

If we are totally sure that everything is allright, and we can continue with the Upgrade, then we need to select Yes.
The Zimbra Collaboration Server appears already to be installed.
It can be upgraded with no effect on existing accounts,
or the current installation can be completely removed prior
to installation for a clean install.
Do you wish to upgrade? [Y]
Select the packages to install
Upgrading zimbra-core
Upgrading zimbra-ldap
Upgrading zimbra-logger
Upgrading zimbra-mta
Install zimbra-dnscache [N]
Upgrading zimbra-snmp
Upgrading zimbra-store
Upgrading zimbra-apache
Upgrading zimbra-spell
Install zimbra-memcached [N]
Install zimbra-proxy [N]
Checking required space for zimbra-core
Checking space for zimbra-store
Checking required packages for zimbra-store
zimbra-store package check complete.
Installing:
zimbra-core
zimbra-ldap
zimbra-logger
zimbra-mta
zimbra-snmp
zimbra-store
zimbra-apache
zimbra-spell

Once again, Zimbra do double check, and if we are complete sure that we want to upgrade, please write Y for
continue with the process:

17 de 37

The system will be modified.


Shutting down zimbra mail

Continue? [N] y

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

Backing up the ldap databasedone.


Removing existing packages
zimbra-ldapdone
zimbra-loggerdone
zimbra-mtadone
zimbra-snmpdone
zimbra-storedone
zimbra-spelldone
zimbra-apachedone
zimbra-coredone
Removing deployed webapp directories
Installing packages
zimbra-corezimbra-core_8.5.0.GA.3040.UBUNTU12.64_amd64.debdone
zimbra-ldapzimbra-ldap_8.5.0.GA.3040.UBUNTU12.64_amd64.debdone
zimbra-loggerzimbra-logger_8.5.0.GA.3040.UBUNTU12.64_amd64.debdone
zimbra-mtazimbra-mta_8.5.0.GA.3040.UBUNTU12.64_amd64.debdone
zimbra-snmpzimbra-snmp_8.5.0.GA.3040.UBUNTU12.64_amd64.debdone
zimbra-storezimbra-store_8.5.0.GA.3040.UBUNTU12.64_amd64.debdone
zimbra-apachezimbra-apache_8.5.0.GA.3040.UBUNTU12.64_amd64.debdone
zimbra-spellzimbra-spell_8.5.0.GA.3040.UBUNTU12.64_amd64.debdone

Zimbra Collaboration starts to upgrading, also the LDAP, etc, we can follow all the process in interactive way:
Upgrading from 8.0.7_GA_6020 to 8.5.0_GA_3040
Stopping zimbra servicesdone.
This appears to be 8.0.7_GA
Starting mysqldone.
Checking ldap statusnot running.
Checking ldap statusnot running.
Starting ldapdone.
Checking ldap statusalready running.
Running mysql_upgradedone.
Schema upgrade required from version 92 to 103.
Running /opt/zimbra/libexec/scripts/migrate20130226_alwayson.pl
Tue Aug 26 18:59:38 2014: Verified schema version 92.
Tue Aug 26 18:59:39 2014: Verified schema version 92.
Tue Aug 26 18:59:39 2014: Updating DB schema version from 92 to 100.
Running /opt/zimbra/libexec/scripts/migrate20140319-MailItemPrevFolders.pl
Tue Aug 26 18:59:42 2014: Verified schema version 100.
Tue Aug 26 18:59:43 2014: Migrating mboxgroup1. This can take a substantial amount of time
Tue Aug 26 18:59:44 2014: done.

Near the end, we can see from which Versions we can upgrade, just info:
Stopping mysqldone.
Updating from 8.0.8_GA
Updating from 8.5.0_BETA1
Updating from 8.5.0_BETA2
Updating from 8.5.0_BETA3
Updating from 8.5.0_GA
Updating global config and COSs with attributes introduced after 8.0.7_GAdone.
Stopping ldapdone.
Upgrade complete.

In the end of the Installation, the wizard will ask us about Notify Zimbra, is always appreciated and good idea if we
can do it.
You have the option of notifying Zimbra of your installation.
This helps us to track the uptake of the Zimbra Collaboration Server.
The only information that will be transmitted is:
The VERSION of zcs installed (8.5.0_GA_3040_UBUNTU12_64)
The ADMIN EMAIL ADDRESS created (admin@YYYYYIIII.es)
Notify Zimbra of your installation? [Yes] yes

The last message is the pat to the Log le if we can check or save our process:
Moving /tmp/zmsetup08262014-185850.log to /opt/zimbra/log
Configuration complete press return to exit

Upgrade Ubuntu 12.04 to Ubuntu 14.04 and update


ZCS 8.5.0
Template:Note Is very important before continue with this process, take a Snapshot or do a Full Backup of your
System.

18 de 37

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

Stopping the Zimbra Collaboration Services


The rst step in this Upgrade guide is stop our Zimbra Collaboration Services:
zimbra@help:/home/# zmcontrol stop

Once we have stopped the Zimbra Collaboration services and we have a full Backup or Snapshot, we can continue.

Upgrading the Ubuntu Version


For Upgrade the Ubuntu version, in root session we will execute this command:
root@help:/home/# do-release-upgrade

This process will start and do some previous questions, for example it will ask us about create an alternate SSH
daemon, just in case if we lose the actual SSH connection:
Continue running under SSH?
This session appears to be running under ssh. It is not recommended
to perform a upgrade over ssh currently because in case of failure it
is harder to recover.
If you continue, an additional ssh daemon will be started at port
1022.
Do you want to continue?
Continue [yN] y
Starting additional sshd
To make recovery in case of failure easier, an additional sshd will
be started on port 1022. If anything goes wrong with the running
ssh you can still connect to the additional one.
If you run a firewall, you may need to temporarily open this port. As
this is potentially dangerous its not done automatically. You can
open the port with e.g.:
iptables -I INPUT -p tcp dport 1022 -j ACCEPT
To continue please press [ENTER]

After a while checking packages, the wizard will ask about the total MB to download and will require our answer, in
this case we will write Y and press ENTER:
Do you want to start the upgrade?
2 packages are going to be removed. 113 new packages are going to be
installed. 380 packages are going to be upgraded.
You have to download a total of 216 M. This download will take about
5 minutes with your connection.
Installing the upgrade can take several hours. Once the download has
finished, the process cannot be canceled.
Continue [yN] Details [d]y

The Wizard will ask us during the process some questions with Yes or No for answer it, we will let the default Answer:
Unpacking replacement libc6
Processing triggers for ureadahead
Processing triggers for man-db
Setting up libc6 (2.19-0ubuntu6.1)
Generating locales
en_AG.UTF-8 done
en_AU.UTF-8 done
en_BW.UTF-8 done
en_CA.UTF-8 done
en_DK.UTF-8 done
en_GB.UTF-8 done
en_HK.UTF-8 done
en_IE.UTF-8 done
en_IN.UTF-8 done
en_NG.UTF-8 done
en_NZ.UTF-8 done
en_PH.UTF-8 done
en_SG.UTF-8 done
en_US.UTF-8 done
en_ZA.UTF-8 done
en_ZM.UTF-8 done
en_ZW.UTF-8 done
Generation complete.

We will have questions like this, we need to take careful and select the default answer, so we only need to press
ENTER all time:

19 de 37

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

Configuration file `/etc/security/limits.conf


==> Modified (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it ? Your options are:
Y or I : install the package maintainers version
N or O : keep your currently-installed version
D
: show the differences between the versions
Z
: start a shell to examine the situation
The default action is to keep your current version.
*** limits.conf (Y/I/N/O/D/Z) [default=N] ?

Also, we will have questions prompt us about delete packages, again we will select the dafult answer:
Remove obsolete packages?
22 packages are going to be removed.
Continue [yN] Details [d]y

And after a while, the nal and good message, reboot time:
System upgrade is complete.
Restart required
To finish the upgrade, a restart is required.
If you select y the system will be restarted.
Continue [yN] y

Once we do a reboot, we will have Ubuntu 14.04 LTS running in our System:
Distributor ID:
Description:
Release:
Codename:

Ubuntu
Ubuntu 14.04.1 LTS
14.04
trusty

Update Zimbra 8.5.0 with Ubuntu 14.04 package


The rst step is download now the correct version for our new OS, Ubuntu 14.04 LTS:
[13] (http://www.zimbra.com/downloads/os-downloads.html) Open Source Edition Download
[14] (http://www.zimbra.com/downloads/ne-downloads.html) Network Edition Download

Go into a root session and download the new version package, in this example I will use the /home folder:
root@help:/home# wget http://files2.zimbra.com/downloads/8.5.0_GA/zcs-8.5.0_GA_3040.UBUNTU14_64.20140816142548.tgz
HTTP request sent, awaiting response 200 OK
Length: 964955796 (920M) [binary/octet-stream]
Saving to: `zcs-8.5.0_GA_3040.UBUNTU14_64.20140816142548.tgz
100%[=============================================================================================================================>] 964,955,796 3.11M/s

in

2014-10-08 14:47:52 (2.76 MB/s) `zcs-8.5.0_GA_3040.UBUNTU14_64.20140816142548.tgz saved [964955796/964955796]


root@help:/home#
<pre>
Once we've downloaded the package, is time for extract it:
<pre>
root@help:/home/# tar xzvf zcs-8.5.0_GA_3040.UBUNTU14_64.20140816142548.tgz

We need to install also a new dependency, perl5.18, if not we will obtain an error during the install process:
root@help:/home# apt-get install libperl5.18

And now, we are ready to launch the install.sh script:

20 de 37

Operations logged to /tmp/install.log.1821


Checking for existing installation
zimbra-ldapFOUND zimbra-ldap-8.5.0.GA.3040.UBUNTU12.64
zimbra-loggerFOUND zimbra-logger-8.5.0.GA.3040.UBUNTU12.64
zimbra-mtaFOUND zimbra-mta-8.5.0.GA.3040.UBUNTU12.64
zimbra-dnscacheNOT FOUND
zimbra-snmpFOUND zimbra-snmp-8.5.0.GA.3040.UBUNTU12.64
zimbra-storeFOUND zimbra-store-8.5.0.GA.3040.UBUNTU12.64
zimbra-apacheFOUND zimbra-apache-8.5.0.GA.3040.UBUNTU12.64
zimbra-spellFOUND zimbra-spell-8.5.0.GA.3040.UBUNTU12.64
zimbra-convertdNOT FOUND
zimbra-memcachedNOT FOUND
zimbra-proxyNOT FOUND

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

zimbra-archivingNOT FOUND
zimbra-clusterNOT FOUND
zimbra-coreFOUND zimbra-core-8.5.0.GA.3040.UBUNTU12.64
ZCS upgrade from 8.5.0 to 8.5.0 will be performed.
Saving existing configuration file to /opt/zimbra/.saveconfig

Once the wizard complete the check, we can see the EULA, we need to write Y and press ENTER:
PLEASE READ THIS AGREEMENT CAREFULLY BEFORE USING THE SOFTWARE.
ZIMBRA, INC. (ZIMBRA) WILL ONLY LICENSE THIS SOFTWARE TO YOU IF YOU
FIRST ACCEPT THE TERMS OF THIS AGREEMENT. BY DOWNLOADING OR INSTALLING
THE SOFTWARE, OR USING THE PRODUCT, YOU ARE CONSENTING TO BE BOUND BY
THIS AGREEMENT. IF YOU DO NOT AGREE TO ALL OF THE TERMS OF THIS
AGREEMENT, THEN DO NOT DOWNLOAD, INSTALL OR USE THE PRODUCT.
License Terms for the Zimbra Collaboration Suite:
http://www.zimbra.com/license/zimbra-public-eula-2-5.html
Do you agree with the terms of the software license agreement? [N] y

Is time now for check if all the prerequisites are installed already:
Checking for prerequisites
FOUND: NPTL
FOUND: netcat-openbsd-1.105-7ubuntu1
FOUND: sudo-1.8.9p5-1ubuntu1
FOUND: libidn11-1.28-1ubuntu2
FOUND: libpcre3-1:8.31-2ubuntu2
FOUND: libgmp10-2:5.1.3+dfsg-1ubuntu1
FOUND: libexpat1-2.1.0-4ubuntu1
FOUND: libstdc++6-4.8.2-19ubuntu1
FOUND: libperl5.18-5.18.2-2ubuntu1
FOUND: libaio1-0.3.109-4
FOUND: resolvconf-1.69ubuntu1.1
FOUND: unzip-6.0-9ubuntu1
Checking for suggested prerequisites
FOUND: pax
FOUND: perl-5.18.2
FOUND: sysstat
FOUND: sqlite3
Prerequisite check complete.

We can run again the Database Integrity Check, it will takes some minutes or hours, depends of the size of it and also
if the system found some errors:
Checking current number of databases
Do you want to verify message store database integrity? [Y] y

Once again, we can add some new packages to our system, but the regular way is not install any new package during
this Upgrade time:
Checking for installable packages
Found
Found
Found
Found
Found
Found
Found
Found
Found
Found
Found

zimbra-core
zimbra-ldap
zimbra-logger
zimbra-mta
zimbra-dnscache
zimbra-snmp
zimbra-store
zimbra-apache
zimbra-spell
zimbra-memcached
zimbra-proxy

The Zimbra Collaboration Server appears already to be installed.


It can be upgraded with no effect on existing accounts,
or the current installation can be completely removed prior
to installation for a clean install.

The wizard will ask us if we are sure that we want to Upgrade, per default is Y we only need to press ENTER,also here
we can add the additional packages if we want:

21 de 37

Do you wish to upgrade? [Y]


Select the packages to install
Upgrading zimbra-core
Upgrading zimbra-ldap

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

Upgrading zimbra-logger
Upgrading zimbra-mta
Install zimbra-dnscache [N]
Upgrading zimbra-snmp
Upgrading zimbra-store
Upgrading zimbra-apache
Upgrading zimbra-spell
Install zimbra-memcached [N]
Install zimbra-proxy [N]
Checking required space for zimbra-core
Checking space for zimbra-store
Checking required packages for zimbra-store
zimbra-store package check complete.
Installing:
zimbra-core
zimbra-ldap
zimbra-logger
zimbra-mta
zimbra-snmp
zimbra-store
zimbra-apache
zimbra-spell

The double check of zimbra will ask us again if we are really sure that we want to Upgrade the Zimbra Collaboration
System:
The system will be modified. Continue? [N] y
Shutting down zimbra mail
Backing up the ldap databasedone.
Removing existing packages
zimbra-ldapdone
zimbra-loggerdone
zimbra-mtadone
zimbra-snmpdone
zimbra-storedone
zimbra-spelldone
zimbra-apachedone
zimbra-coredone
Removing deployed webapp directories
Installing packages
zimbra-corezimbra-core_8.5.0.GA.3040.UBUNTU14.64_amd64.debdone
zimbra-ldapzimbra-ldap_8.5.0.GA.3040.UBUNTU14.64_amd64.debdone
zimbra-loggerzimbra-logger_8.5.0.GA.3040.UBUNTU14.64_amd64.debdone
zimbra-mtazimbra-mta_8.5.0.GA.3040.UBUNTU14.64_amd64.debdone
zimbra-snmpzimbra-snmp_8.5.0.GA.3040.UBUNTU14.64_amd64.debdone
zimbra-storezimbra-store_8.5.0.GA.3040.UBUNTU14.64_amd64.debdone
zimbra-apachezimbra-apache_8.5.0.GA.3040.UBUNTU14.64_amd64.debdone
zimbra-spellzimbra-spell_8.5.0.GA.3040.UBUNTU14.64_amd64.debdone

The system will start to update, we can see all the progress in interactive way:
Restoring existing configuration file from /opt/zimbra/.saveconfig/localconfig.xmldone
Operations logged to /tmp/zmsetup08272014-130758.log
Checking ldap status.not running.
Starting ldapdone.
Setting defaultsdone.
Setting defaults from existing configdone.
Checking for port conflicts
Setting defaults from ldapdone.
Saving config in /opt/zimbra/config.12706done.
Operations logged to /tmp/zmsetup08272014-130758.log
Setting local config valuesdone.
Initializing core configSetting up CAdone.
Deploying CA to /opt/zimbra/conf/ca done.
Setting replication passworddone.
Setting Postfix passworddone.
Setting amavis passworddone.
Setting nginx passworddone.
Creating server entry for help.zimbra.comalready exists.
Setting Zimbra IP Modedone.
Saving CA in ldap done.
Saving SSL Certificate in ldap done.
Setting spell check URLdone.
[...]
Finished updating non-standard zimlets.
Restarting mailboxddone.
Skipping creation of default domain GAL sync account existing install detected.

In the end of the Installation, the wizard will ask us about Notify Zimbra, is always appreciated and good idea if we
can do it:

22 de 37

You have the option of notifying Zimbra of your installation.

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

This helps us to track the uptake of the Zimbra Collaboration Server.


The only information that will be transmitted is:
The VERSION of zcs installed (8.5.0_GA_3040_UBUNTU14_64)
The ADMIN EMAIL ADDRESS created (admin@help.zimbra.com)
Notify Zimbra of your installation? [Yes]

And now we will have Zimbra 8.5.0 and Ubuntu 14.04 working together. We can check all the log here:
Setting up zimbra crontabdone.
Moving /tmp/zmsetup08272014-130758.log to /opt/zimbra/log
Configuration complete press return to exit

- This article is NOT ocial Zimbra documentation. It is a user contribution and may include unsupported
customizations, references, suggestions, or information. This Step-by-Step is not taking care about the Apache, or
other kind of Software that you maybe have inside the Server. This steps are just for Upgrade Zimbra Collaboration

Zimlet LinkedIn Images


Description
The Zimlet LinkedIn Images us permit merge our LinkedIn account with our contacts, and in the end have the picture
of our Contacts and show it automatically in our Zimbra Web Client.

Conguration
The Zimlet LinkedIn Images came with the last Release of Zimbra 8.5, and it's free, we can use it in Open Source
Edition and also in Network Edition. But, rst, we need to modify one le and also do some stu in LinkedIn.

LinkedIn API Key


For have our Zimlet working, frist we need an LinkedIn API Key, is only once and any IT Administrator in our
Company can do it for free if have LinkedIn account.

23 de 37

We need to go to [15] (https://www.linkedin.com/secure/developer) and Login with our credentials


We need to ll the elds with our Information, an example (sorry for the spanish content but my LinkedIn
account is in spanish) Change my domain for yours.

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

Next and very important is ll the next elds with this information, like here, change my domain for yours.
http://localhost:7070,https://labjorge.zimbra.lab,http://host.local

Congratulations, you will obtain your LinkedIn API KEY, Secret Key, etc. We will only need the LinkedI API KEY

Conguring & Installing the Zimlet


Download the Zimlet from your own Zimbra server, you will found it in the next path:
/opt/zimbra/zimlets/com_zimbra_linkedinimage.zip

Edit the le called com_zimbra_linkedinimage.xml and change the next variable with your own LinkedIn API KEY
<property type="string" name="linkedinZimlet_api_key" value="LINKEDIN API KEY HERE"/>

24 de 37

Save all of your les in a zip called com_zimbra_linkedinimage.zip with all of the les inside, no folders, just
all the les.
Go to your Zimbra Collaboration Administration Console, Congure>Zimlets and select the LinkedIn Image
Zimlet and First Toggle Status for disable and second Undeploy

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

Then click in the right gaf icon, and Deploy your new and fresh com_zimbra_linkedinimage.zip cooked by
yourself, be sure to mark the checkbox for ush the zimlet cache

Conguring & Using in our Web Client

25 de 37

Well done! Is time to do F5 in your Web Browser and time to play!

Now the Zimlet will requires our credentials of Linkedin. For each user their credentials, the Linkedin API KEY is
only generated once.

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

26 de 37

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

Next we will push in Start Scanning, and all of our Zimbra contacts that match with our LinkedIn Contacts will
be updated with picture.

We will see the resume of the operation.

And if we go to any of our contacts, and also we have this contact in Linkeding we will see him/her like that:

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

That's all

VMware HA script in Zimbra Collaboration


Zimbra introduce VMware HA scripts in Zimbra 8. This feature is only available in Network Edition, so Open Source
users can't use it. This vmware-ha service works combine with VMware vSphere HA VM Monitoring and oer us the
possibility to restart our Zimbra VM when any Zimbra service was down during the heartbeat dened time. The
zmhactl script starts /opt/zimbra/libexec/vmware-heartbeat, which runs as a service (continuously), and interacts with
VMware HA by running /opt/zimbra/libexec/vmware-appmonitor with dierent arguments (so zmhactl -> vmwareheartbeat -> vmware-appmonitor -> VMware HA).
A. When the vmware-heartbeat script starts, it sends a vmware-appmonitor "enable" signal
B. While running it does the following on a set schedule (every 15 seconds). This is supposedly congurable with
localcong vmware_heartbeat_interval, but it doesn't look like zmhactl actually uses that.
i. runs vmware-appmonitor "isEnabled" to verify that application monitoring is enabled
ii. runs "zmcontrol status" and checks the return code
iii. if the status is OK then it sends vmware-appmonitor "markActive"
C. When vmware-heartbeat is stopped, it sends a vmware-appmonitor "disable" signal

VMware vSphere HA VM Monitoring


Let's go to some basic information about VMware vSphere HA VM Monitoring, based in the ocial information
(http://blogs.vmware.com/vsphere/2014/03/vsphere-ha-vm-monitoring-back-basics.html) . What is vSphere HA VM
monitoring? HA VM monitoring will restart a VM if:
That VMs VMware Tools heartbeats are not received in a set period of time (see below for details) and
The VM isn't generating any storage or network IO (for 120 seconds by default, though this can be changed
using the following advanced cluster level setting: das.iostatsInterval)
When exactly will the VM be reset? There are 3 built in presets (Low, Medium & High) and the option to select custom
settings for any of these options.
Failure Interval

Minimum uptime

Maximum per-VM resets

Maximum resets time window

120 secs

480 secs

7 days

Medium

60 secs

240 secs

24 hours

High

30 secs

120 secs

1 hour

Low

What do the dierent options mean?

27 de 37

Failure interval: HA will restart the VM if the VM heartbeat has not been received in this interval
Minimum uptime: HA will wait this long after a VM is started to begin monitoring for VM tools heartbeats,
storage and network IO

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

Maximum per-VM resets: HA will restart the VM a maximum of this many times within the Maximum resets time
window
Maximum resets time window: (see Maximum per-VM resets above)

How to activate it in Zimbra Collaboration


The rst step after the theory is activate it in our Zimbra dierent VM, we can check rst if it's activated
[zimbra@archiving ~]$ zmprov gs `zmhostname` zimbraServiceInstalled | grep vmware-ha

If not we can enable it with trough CLI


[zimbra@mail ~]$ zmprov ms `zmhostname` +zimbraServiceEnabled vmware-ha
[zimbra@mail ~]$ zmhactl start

Also we can enable it trough Admin Console Home>Congure>Servers (select the server that we want to activate
the vmware-ha) and then click in Services>VMware HA Heartbeat

How to activate vSphere HA VM Monitoring


We can follow two ways to activate it in VMware vSphere; vSphere Client or vSphere web Client.

vSphere Client
In our VMware vSphere Cluster and right-click>Edit Settings:

28 de 37

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

We need to have activated VMware vSphere HA functionality, and go to VM Monitoring, mark the option VM and
Application Monitoring for be able to activate the Application Monitoring. In this moment, select the best
Monitoring sensitivity for your environment is out of the Scope of the Zimbra Wiki and you need to have deep
understand in VMware for select the best option for your Infrastructure. We are selecting the Low Monitoring
sensitivity, but in the VM, or VMs that we want to activate the Zimbra vmware-ha, will select VM Monitoring High,
with Application Monitoring also activated.

Also we can personalize and congure the best time for our Zimbra VM, if we select Custom VM Monitoring Settings.

29 de 37

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

vSphere web Client


We can follow the same steps but in the new vSphere Web client, following these steps (http://blogs.vmware.com
/vsphere/2014/03/vsphere-ha-vm-monitoring-back-basics.html) .

Testing the Zimbra vmware-ha script


We've selected High option, is time to test it in our Zimbra VM, we will stop one Zimbra service intentionally, for test
it.
[zimbra@mail~]$ zmmailboxdctl stop

And when the time conditions happen, vSphere HA will restart the VM and we will have a Log action into our vSphere

Server

Log File
The Zimbra vmware-ha script log everything in the next log
root@mail:/home/oper# tail -f /opt/zimbra/log/vmware-heartbeat.log

And the result of the Log File will be like this:


Fri Oct 24 17:59:49 2014: Checking ZCS status
Fri Oct 24 17:59:51 2014: Sending heartbeat to VM

Migrate from cPanel/Plesk to Zimbra Collaboration


8.0.x 8.x
cPanel or Plesk are the typical Hosting Software products, a lot of people use it for hosting Web Pages, Mail accounts,
FTP, etc. But the email functionalities in this software are very limited, so the best option is split the services, let the
Web Page in a cPanel or Plesk service, but put the email in a Zimbra Collaboration Server. In this Wiki we will see how
to import all the cPanel/Plesk accounts trough IMAP protocol using the Account Migration tool that Zimbra include
(Open Source and Network Edition)

Export the cPanel account list


>>Firebug needed. The rst step is obtain a complete list of the users that we want to import into our Zimbra
Collaboration server. cPanel doesn't have any easy way to export all the email accounts, and neither the email account
with password, so we can select all of them and then copy/paste in a excel or follow these steps: Login into our cPanel

30 de 37

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

account and go to the Mail section and click into Email accounts

Click into the right section and select 100 results, if we have more accounts, we need to repeat the next steps.

Open Firebug in the website and go into Console>Show command editor, and paste the next code in the right

window, and press run.

var rows = $("#table_email_accts tr.dt_info_row"),


returnString = "";
rows.each(function(i, item){
var tdList = [];
$(item).find('td:eq(0)').each(function(s, subItem){
tdList.push($(subItem).text());
});
returnString += tdList + "\n";
});
console.log(returnString);

We will obtain in plain-text all the email accounts in the left window, and we can copy paste into a notepad, we will

31 de 37

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

use it later.

Creating the 2 main XML les


The Account Migration tool works perfect in Bulk if we prepare well two dierents XML.
The rst xml is for the Account provision
The second xml is for the IMAP data import

Account provision XML


The following example shows an XML le that is used to provision multiple email accounts without importing mail, we
will use the email accounts list that we exported before:
<?xml version="1.0" encoding="UTF-8"?>
<ZCSImport>
<ImportUsers>
<User>
<sn>Sample</sn>
<givenName>Sam</givenName>
<displayName>Sam Sample</displayName>
<RemoteEmailAddress>ssample@example.com</RemoteEmailAddress>
<password>test123</password>
<zimbraPasswordMustChange>TRUE</zimbraPasswordMustChange>
</User>
<User>
<sn>Zackry</sn>
<givenName>Zak</givenName>
<displayName>Zak Zackry</displayName>
<RemoteEmailAddress>zzackry@example.com</RemoteEmailAddress>
<password>test123</password>
<zimbraPasswordMustChange>TRUE</zimbraPasswordMustChange>
</User>
</ImportUsers>
</ZCSImport>

In this Wiki example, the name of the account provision xml le is cPanel-IMAP-users.xml

IMAP data import xml


The second xml is the one that will include the information about the old IMAP server, so we need to take careful and
introduce all the usernames and passwords correctly. The following example shows an XML le that is used to import
email for one account via IMAP from a gmail account without provisioning the email account in ZCS. The account
must be provisioned on ZCS before running this type of XML le.
<?xml version="1.0" encoding="UTF-8"?>
<ZCSImport>
<IMAPHost>imap.gmail.com</IMAPHost>
<IMAPPort>143</IMAPPort>
<ConnectionType>cleartext</ConnectionType>
<UseAdminLogin>0</UseAdminLogin>
<ImportUsers>
<User>
<sn>Sample</sn>
<givenName>Sam</givenName>
<displayName>Sam Sample</displayName>
<RemoteEmailAddress>sam@example.com</RemoteEmailAddress><RemoteIMAPLogin>sam@example.com</RemoteIMAPLogin><remoteIMAPPassword>test123</remoteIMAPPassword>
</User>
<User>
<sn>Zackry</sn>
<givenName>Zak</givenName>
<displayName>Zak Zackry</displayName>
<RemoteEmailAddress>zzackry@example.com</RemoteEmailAddress><RemoteIMAPLogin>sam@example.com</RemoteIMAPLogin><remoteIMAPPassword>test123</remoteIMAPPassword>
</User>
</ImportUsers>
</ZCSImport>

In this Wiki example, the name of the account provision xml le is cPanel-IMAP-users3.xml

The Zimbra Account Migration Tool


Once we have everything prepared, and the xml correctly prepare, is time to use the Tool, in Admin Console, go
Home>Tools and Migration>Account Migration

32 de 37

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

Click in the right corner and select the user Migration Tool, will starts the Wizard that we will use, select Generic
IMAP Server, and both options; Provisionin accounts and Importing Mailboxes

In the next step, we will select the option Import from a XML le (use the rst XML)

The wizard will detect all the accounts that we wrote in the XML le and will show a resume

33 de 37

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

Once the wizard provisioned all the accounts, we will see the result status

Now is time to import all the IMAP data in our new accounts, select now the second XML le

In this step we need to select the proper type of connction of our old IMAP server, clear text is the 143 default port

without SSL.

34 de 37

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

So, we need to select the proper type hostname and port of our old IMAP Server

The wizard will show us a resume of the options that we've selected, press Next for start

And the process will start

If we go to console, we can check the status in the log /opt/zimbra/log/mailbox.log


zimbra@zimbralab01:/root$ tail -f /opt/zimbra/log/mailbox.log

2014-10-25
2014-10-25
2014-10-25
2014-10-25
2014-10-25
2014-10-25
2014-10-25
2014-10-25

21:48:35,785
21:48:35,799
21:48:35,819
21:48:35,882
21:48:35,896
21:48:35,915
21:48:36,000
21:48:36,037

INFO
INFO
INFO
INFO
INFO
INFO
INFO
INFO

[Thread-95]
[Thread-95]
[Thread-95]
[Thread-95]
[Thread-95]
[Thread-95]
[Thread-95]
[Thread-95]

[]
[]
[]
[]
[]
[]
[]
[]

mailop - Adding Message: id=2552,


mailop - Adding Message: id=2553,
mailop - Adding Message: id=2554,
mailop - Adding Message: id=2555,
mailop - Adding Message: id=2556,
mailop - Adding Message: id=2557,
mailop - Adding Message: id=2558,
datasource - Import completed for

Message-ID=<2a3cdaedd0c833@email.com>, parentId=-1, folderId=257, folderName=Trash


Message-ID=<ea211c82528531@email.com>, parentId=-1, folderId=257, folderName=Trash
Message-ID=<4f59d8aed0d9b95f@email.com>, parentId=-1, folderId=257, folderName=Tra
Message-ID=<b40b586d720c4a4e.squirrel@email.com>, parentId=-1, folderId=257, folde
Message-ID=<6f5de1286203fcf10@email.com>, parentId=-1, folderId=257, folderName=Tr
Message-ID=<fa77cfe13ab00774@email.com>, parentId=-1, folderId=257, folderName=Tra
Message-ID=<b40b586d720c4a4e.squirrel@email.com>, parentId=-1, folderId=258, folde
data source '__imap_import__'

In the Admin Console we can also see the status of the process

35 de 37

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

And once all account was imported, we can just login into our account and see all the imported emails, and folders.

Note We need to review the log for check what email or emails was fail during the import process.
Retrieved from "http://wiki.zimbra.com/index.php?title=Jdelacruz-Notes&oldid=56350"
Category: WorkInProgress

36 de 37

Zimbra.com
|
Popular Searches
|
About Zimbra

Learn
What is Zimbra?
Benets
Demos and Videos
Industry Solutions
Customers
Case Studies
Awards

Products
Zimbra Collaboration Server
Zimbra Cloud and Virtualization
Zimbra Open Source
Zimbra Desktop
Compare Products
Pricing
Whats New
Downloads

Community
Forums
Documentation
Wiki
Blog
Gallery

25/11/14 11:31

Jdelacruz-Notes - Zimbra :: Wiki

https://wiki.zimbra.com/index.php?title=Jdelacruz-Note...

Submit Bug
Release Status
Developer Zone
Contribute

Support
Zimbra Support Program Overview
User Help
Zimbra Customer Support Portal

Partners
Zimbra Hosting Providers
Zimbra VARs
Zimbra Training Providers
Resources For Partners

About
Careers
News
Events
Webinars
Media
Contact Us
Twitter
LinkedIn
Facebook
Email Software
Email Hosting
Zimbra Mail Server
Email Archiving and Compliance Software
Calendar and Collaboration
Microsoft Outlook Alternative
Zimbra for BlackBerry & iPhone
Secure Email & Anti Spam
Unied Messaging
Zimbra powers collaboration for the way you work. Zimbra connects people and information with unied
collaboration software that includes email, calendaring, le sharing, activity streams, social communities and more.
With technology designed for social, mobile and the cloud, Zimbra gives individuals the exibility to work from
virtually anywhere, through nearly every computer, tablet and mobile device.

37 de 37

25/11/14 11:31

You might also like