Apuntes de Zimbra

Embed Size (px)

Citation preview

  • 8/9/2019 Apuntes de Zimbra

    1/37

    Zimbra: Email and collaboration for the Post-PC era

    Search

    User Help | Forums | Blog | Contact Us | Buy Zimbra

    LearnProducts

    CommunitySupportPartnersDownloads About

    delacruz-Notes

    From Zimbra :: Wiki

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

    Contents

    1 Single-Node Commercial Certificate1.1 Generating the CSR 1.2 Checking the content of the SSL Certificate1.3 Buying the Commercial SSL Certificate1.4 Installing the Commercial SSL Certificate1.5 Creating the commercial.crt1.6 Creating the commercial_ca.crt1.7 Checking if every file is OK 

    1.8 Launching the last command2 Single-Node Multi-SAN Commercial Certificate

    2.1 Generating the MultiSAN.csr file2.2 Checking the content of the SSL Certificate2.3 Buying the Commercial SSL Certificate2.4 Installing the Commercial SSL Certificate2.5 Creating the commercial_ca.crt2.6 Checking if every file is OK 2.7 Launching the last command2.8 Forcing the Server to use only HTTPS

    3 Forcing the Server to use only HTTPS4 Upgrade Ubuntu 10.04 64bit to Ubuntu 12.04 64bit and update ZCS 8.0.8

    4.1 Stopping the Zimbra Collaboration Services4.2 Upgrading the Ubuntu Version4.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.95.1 Stopping the Zimbra Collaboration Services5.2 Upgrading the Ubuntu Version5.3 Update Zimbra 8.0.9 with Ubuntu 14.04 package

    6 Upgrade Zimbra Collaboration 8.0.7 to 8.5.0 - Ubuntu 12.046.1 Verifying the expiration date of the SSL Certificate6.2 Upgrade Instructions

    7 Upgrade Ubuntu 12.04 to Ubuntu 14.04 and update ZCS 8.5.07.1 Stopping the Zimbra Collaboration Services7.2 Upgrading the Ubuntu Version7.3 Update Zimbra 8.5.0 with Ubuntu 14.04 package

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    2/37

    8 Zimlet LinkedIn Images8.1 Description8.2 Configuration8.3 LinkedIn API Key8.4 Configuring & Installing the Zimlet8.5 Configuring & Using in our Web Client

    9 VMware HA script in Zimbra Collaboration9.1 VMware vSphere HA VM Monitoring9.2 How to activate it in Zimbra Collaboration

    9.3 How to activate vSphere HA VM Monitoring9.3.1 vSphere Client9.3.2 vSphere web Client

    9.4 Testing the Zimbra vmware-ha script9.5 Log File

    10 Migrate from cPanel/Plesk to Zimbra Collaboration 8.0.x 8.x10.1 Export the cPanel account list10.2 Creating the 2 main XML files

    10.2.1 Account provision XML10.2.2 IMAP data import xml

    10.3 The Zimbra Account Migration Tool

    Single-Node Commercial CertificateSome theory about SSL Certificates and words that we will use in this tutorial:

    CSR (Certificate Signing Request): A CSR or also Certificate Signing request is a encrypted file withinformation about the company. This file is generated in our server, the Information that contains inside wediscussed in a previous article. A Certificate authority uses this CSR for take the information and create the SSLCertificate.Private Key: We told before that CSR is a encrypted file, we used for encrypt it a Private Key, that is unique. TheCSR and the SSL certificate will only works if we have the Private key. So the best practice is do a Backup of thePrivate 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 files 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 theexisting 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.comSubjectAltName=zimbra@help:#

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

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

    Checking the content of the SSL Certificate

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

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    3/37

    zimbra@help:/tmp# /opt/zimbra/bin/zmcertmgr viewcsr comm commercial.csrsubject=/C=GB/ST=London/L=London/O=Zimbra/OU=Zimbra IT/CN=help.zimbra.comSubjectAltName=

     Another good method to check if everything is allright is using external websites, the only thing that we need to do ispaste 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 thisexample in Symantec Website:

    Buying the Commercial SSL CertificateThe next step is buy a valid commercial SSL certificate. 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 verification has a success theywill send to us a file with the SSL Certificate (usually is a file with .crt extension)

    Installing the Commercial SSL Certificate

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

    Creating the commercial.crt

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    4/37

    This file is easy to create, we only need to create that and paste inside the content of the file that the Certificateauthority gave it to us:

    zimbra@help:/tmp# vi commercial.crt

    Creating the commercial_ca.crt

    The file called commercial_ca.crt needs to be created with the correct information, we need to mix the RootCertificate and also The Intermediate Certificate, the order matters, so the file 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 file commercial_ca.crt with date September 2014 with a Geotrust QuickSSLPremium Certificate:

    -----BEGIN CERTIFICATE-----MIID+jCCAuKgAwIBAgIDAjbSMA0GCSqGSIb3DQEBBQUAMEIxCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1HZW9UcnVzdCBJbmMuMRswGQYDVQQDExJHZW9UcnVzdCBHbG9iYWwgQ0EwHhcNMTAwMjI2MjEzMjMxWhcNMjAwMjI1MjEzMjMxWjBhMQswCQYDVQQGEwJVUzEWMBQGA1UEChMNR2VvVHJ1c3QgSW5jLjEdMBsGA1UECxMURG9tYWluIFZhbGlkYXRlZCBTU0wxGzAZBgNVBAMTEkdlb1RydXN0IERWIFNTTCBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKa7jnrNpJxiV9RRMEJ7ixqy0ogGrTs8KRMMMbxp+Z9alNoGuqwkBJ7O1KrESGAA+DSuoZOv3gR+zfhcIlINVlPrqZTP+3RE60OUpJd6QFc1tqRi2tVI+Hrx7JC1Xzn+Y3JwyBKF0KUuhhNAbOtsTdJU/V8+Jh9m

    cajAuIWe9fV1j9qRTonjynh0MF8VCpmnyoM6djVI0NyLGiJOhaRO+kltK3C+jgwhw2LMpNGtFmuae8tk/426QsMmqhV4aJzs9mvIDFcN5TgH02pXA50gDkvEe4GwKhz1SupKmEn+Als9AxSQKH6a9HjQMYRX5Uw4ekIR4vUoUQNLIBW7Ihq28BUCAwEAAaOB2TCB1jAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFIz02ZMKR7wAoErOS3VuoLawsn78MB8GA1UdIwQYMBaAFMB6mGiNifurBWQMEX2qfWW4ysxOMBIGA1UdEwEB/wQIMAYBAf8CAQAwOgYDVR0fBDMwMTAvoC2gK4YpaHR0cDovL2NybC5nZW90cnVzdC5jb20vY3Jscy9ndGdsb2JhbC5jcmwwNAYIKwYBBQUHAQEEKDAmMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5nZW90cnVzdC5jb20wDQYJKoZIhvcNAQEFBQADggEBADORNxHbQPnejLICiHevYyHBrbAN+qB4VqOC/btJXxRtyNxflNoRZnwekcW22G1PqvK/ISh+UqKSeAhhaSH+LeyCGIT0043FiruKzF3mo7bMbq1vsw5h7onOEzRPSVX1ObuZlvD16lo8nBa9AlPwKg5BbuvvnvdwNs2AKnbIh+PrI7OWLOYdlF8cpOLNJDErBjgyYWE5XIlMSB1CyWee0r9Y9/k3MbBn3Y0mNhp4GgkZPJMHcCrhfCn13mZXCxJeFu1evTezMGnGkqX2Gdgd+DYSuUuVlZzQzmwwpxb79k1ktl8qFJymyFWOIPllByTMOAVMIIi0tWeUz12OYjf+xLQ=-----END CERTIFICATE----------BEGIN CERTIFICATE-----MIIDfTCCAuagAwIBAgIDErvmMA0GCSqGSIb3DQEBBQUAME4xCzAJBgNVBAYTAlVTMRAwDgYDVQQKEwdFcXVpZmF4MS0wKwYDVQQLEyRFcXVpZmF4IFNlY3VyZSBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkwHhcNMDIwNTIxMDQwMDAwWhcNMTgwODIxMDQwMDAwWjBCMQswCQYDVQQGEwJVUzEWMBQGA1UEChMNR2VvVHJ1c3QgSW5jLjEbMBkGA1UEAxMSR2VvVHJ1c3QgR2xvYmFsIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2swYYzD99BcjGlZ+W988bDjkcbd4kdS8odhM+KhDtgPpTSEHCIjaWC9mOSm9BXiLnTjoBbdqfnGk5sRgprDvgOSJKA+eJdbtg/OtppHHmMlCGDUUna2YRpIuT8rxh0PBFpVXLVDviS2Aelet8u5fa9IAjbkU+BQVNdnARqN7csiRv8lVK83Qlz6cJmTM386DGXHKTubU1XupGc1V3sjs0l44U+VcT4wt/lAjNvxm5suOpDkZALeVAjmRCw7+OC7RHQWa9k0+bw8HHa8sHo9gOeL6NlMTOdReJivbPagUvTLrGAMoUgRx5aszPeE4uwc2hGKceeoWMPRfwCvocWvk+QIDAQABo4HwMIHtMB8GA1UdIwQYMBaAFEjmaPkr0rKV10fYIyAQTzOYkJ/UMB0GA1UdDgQWBBTAephojYn7qwVkDBF9qn1luMrMTjAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjA6BgNVHR8EMzAxMC+gLaArhilodHRwOi8vY3JsLmdlb3RydXN0LmNvbS9jcmxzL3NlY3VyZWNhLmNybDBOBgNVHSAERzBFMEMGBFUdIAAwOzA5BggrBgEFBQcCARYtaHR0cHM6Ly93d3cuZ2VvdHJ1c3QuY29tL3Jlc291cmNlcy9yZXBvc2l0b3J5MA0GCSqGSIb3DQEBBQUAA4GBAHbhEm5OSxYShjAGsoEIz/AIx8dxfmbuwu3UOx//8PDITtZDOLC5MH0Y0FWDomrLNhGc6Ehmo21/uBPUR/6LWlxz/K7ZGzIZOKuXNBSqltLroxwUCEm2u+WR74M26x1Wb8ravHNjkOR/ez4iyz0H7V84dJzjA1BOoa+Y7mHyhD8S-----END CERTIFICATE----------BEGIN CERTIFICATE-----MIIDIDCCAomgAwIBAgIENd70zzANBgkqhkiG9w0BAQUFADBOMQswCQYDVQQGEwJVUzEQMA4GA1UEChMHRXF1aWZheDEtMCsGA1UECxMkRXF1aWZheCBTZWN1cmUgQ2VydGlmaWNhdGUgQXV0aG9yaXR5MB4XDTk4MDgyMjE2NDE1MVoXDTE4MDgyMjE2NDE1MVowTjELMAkGA1UEBhMCVVMxEDAOBgNVBAoTB0VxdWlmYXgxLTArBgNVBAsTJEVx

    dWlmYXggU2VjdXJlIENlcnRpZmljYXRlIEF1dGhvcml0eTCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAwV2xWGcIYu6gmi0fCG2RFGiYCh7+2gRvE4RiIcPRfM6fBeC4AfBONOziipUEZKzxa1NfBbPLZ4C/QgKO/t0BCezhABRP/PvwDN1Dulsr4R+AcJkVV5MW8Q+XarfCaCMczE1ZMKxRHjuvK9buY0V7xdlfUNLjUA86iOe/FP3gx7kCAwEAAaOCAQkwggEFMHAGA1UdHwRpMGcwZaBjoGGkXzBdMQswCQYDVQQGEwJVUzEQMA4GA1UEChMHRXF1aWZheDEtMCsGA1UECxMkRXF1aWZheCBTZWN1cmUgQ2VydGlmaWNhdGUgQXV0aG9yaXR5MQ0wCwYDVQQDEwRDUkwxMBoGA1UdEAQTMBGBDzIwMTgwODIyMTY0MTUxWjALBgNVHQ8EBAMCAQYwHwYDVR0jBBgwFoAUSOZo+SvSspXXR9gjIBBPM5iQn9QwHQYDVR0OBBYEFEjmaPkr0rKV10fYIyAQTzOYkJ/UMAwGA1UdEwQFMAMBAf8wGgYJKoZIhvZ9B0EABA0wCxsFVjMuMGMDAgbAMA0GCSqGSIb3DQEBBQUAA4GBAFjOKer89961zgK5F7WF0bnj4JXMJTENAKaSbn+2kmOeUJXRmm/kEd5jhW6Y7qj/WsjTVbJmcVfewCHrPSqnI0kBBIZCe/zuf6IWUrVnZ9NA2zsmWLIodz2uFHdh1voqZiegDfqnc1zqcPGUIWVEX/r87yloqaKHee9570+sB3c4-----END CERTIFICATE-----

    Checking if every file is OK 

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    5/37

     Also with all of these steps, we could do something wrong, we could check if everything is alright before deploy theSSL Certificate, for test all files 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.keyCertificate (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 Logfile will be like this:

    ** Verifying commercial.crt against /opt/zimbra/ssl/zimbra/commercial/commercial.keyCertificate (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 Certificate

    Have a Multi-SAN certificate simplify the task of secure the Zimbra Infrastructure with only one Certificate, so we willhave only one CSR to renew each year, etc. Also the Multi-SAN SSL Certificates 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 file

    We will create a file that we can update per each domain that we will need to use in the future. Also we can update itfor remove, or modify domains inside it.

    We will start moving us to the correct folder inside our Server for generate the files that we will need:

    cd /tmp/

    Then is time to create the CSR file, in this file we need to change the name of our Private Key, our Common Name andalso 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.doma** 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.dom** 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 Certificate

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

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    6/37

    zimbra@help:/tmp# /opt/zimbra/bin/zmcertmgr viewcsr comm commercial.csrsubject=/C=GB/ST=London/L=London/O=Zimbra/OU=Zimbra IT/CN=mail.domain.comSubjectAltName= 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 Certificate

    The next step is buy a valid commercial SSL certificate. 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 verification has a success theywill send to us a file with the SSL Certificate (usually is a file with .crt extension)

    Installing the Commercial SSL Certificate

    We can use the same instructions explained here:

    Creating the commercial_ca.crt

    We can use the same instructions explained here:

    Checking if every file 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

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    7/37

  • 8/9/2019 Apuntes de Zimbra

    8/37

      Do you want to start the upgrade?5 packages are going to be removed. 69 new packages are going to beinstalled. 234 packages are going to be upgraded.You have to download a total of 158 M. This download will take about1 minute with your connection.Installing the upgrade can take several hours. Once the download hasfinished, 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 , soonly 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 final and good message, reboot time: System upgrade is complete.

      Restart requiredTo 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 first 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

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

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    9/37

      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 finished

      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 Zimbrapackages from Ubuntu 10.04 to Ubuntu 12.04

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    10/37

      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...doneOperations logged to /tmp/zmsetup.10252014-014753.logRunning zmldapapplyldif...done.Checking ldap status....not running.Starting ldap...done.

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    11/37

    Setting defaults...done.Setting defaults from existing config...done.Checking for port conflictsSetting defaults from ldap...done.Saving config in /opt/zimbra/config.23712...done.Operations logged to /tmp/zmsetup.10252014-014753.logSetting 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 wecan 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 ([email protected])

      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 64bitand update ZCS 8.0.9

    Stopping the Zimbra Collaboration Services

    The first 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 incase if we lose the actual SSH connection:

      Continue running under SSH?This session appears to be running under ssh. It is not recommendedto perform a upgrade over ssh currently because in case of failure itis 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 sshdTo make recovery in case of failure easier, an additional sshd willbe started on port '1022'.

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    12/37

      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, inthis 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 beinstalled. 362 packages are going to be upgraded.You have to download a total of 204 M. This download should takeabout 1 minute with your connection.Installing the upgrade can take several hours. Once the download hasfinished, 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 , soonly 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 final and good message, reboot time: System upgrade is complete.

      Restart requiredTo 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 first 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

    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

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

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    13/37

    Now launch the installation process with the -s flag 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 finished

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

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

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    14/37

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

      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

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    15/37

    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...doneOperations logged to /tmp/zmsetup.10252014-014753.logRunning zmldapapplyldif...done.Checking ldap status....not running.Starting ldap...done.Setting defaults...done.Setting defaults from existing config...done.Checking for port conflictsSetting defaults from ldap...done.Saving config in /opt/zimbra/config.23712...done.Operations logged to /tmp/zmsetup.10252014-014753.logSetting 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 ([email protected])

      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 namewill be different):

      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 Certificate

    Zimbra Collaboration requires always, at least, a Self-Signed SSL Certificate for do the communication between thedifferent components. The Self-Signed SSL certificate is auto-deployed once we install Zimbra Collaboration.

    Is highly recommend check the SSL Certificate 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 Certificate before do theUpgrade:

    root@help:/opt/zimbra/ssl/zimbra# /opt/zimbra/bin/zmcertmgr createca -newroot@help:/opt/zimbra/ssl/zimbra# /opt/zimbra/bin/zmcertmgr createcrt -new -days 365root@help:/opt/zimbra/ssl/zimbra# /opt/zimbra/bin/zmcertmgr deploycrt self

    Upgrade Instructions

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

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    16/37

    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

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

      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, weneed 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-ldap…FOUND zimbra-ldap-8.0.7.GA.6020.UBUNTU12.64  zimbra-logger…FOUND zimbra-logger-8.0.7.GA.6020.UBUNTU12.64  zimbra-mta…FOUND zimbra-mta-8.0.7.GA.6020.UBUNTU12.64  zimbra-dnscache…NOT FOUND  zimbra-snmp…FOUND zimbra-snmp-8.0.7.GA.6020.UBUNTU12.64  zimbra-store…FOUND zimbra-store-8.0.7.GA.6020.UBUNTU12.64  zimbra-apache…FOUND zimbra-apache-8.0.7.GA.6020.UBUNTU12.64  zimbra-spell…FOUND zimbra-spell-8.0.7.GA.6020.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.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 theend, 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:

      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

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    17/37

      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 thesize 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 mysqld…done.  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 newpackage:

      Checking for installable packages

      Found zimbra-core  Found zimbra-ldap  Found zimbra-logger  Found zimbra-mta  Found zimbra-dnscache  Found zimbra-snmp  Found zimbra-store  Found zimbra-apache  Found zimbra-spell  Found zimbra-memcached  Found 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 forcontinue with the process:

      The system will be modified. Continue? [N] y  Shutting down zimbra mail

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    18/37

      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 directoriesInstalling packages

    zimbra-core……zimbra-core_8.5.0.GA.3040.UBUNTU12.64_amd64.deb…done

    zimbra-ldap……zimbra-ldap_8.5.0.GA.3040.UBUNTU12.64_amd64.deb…donezimbra-logger……zimbra-logger_8.5.0.GA.3040.UBUNTU12.64_amd64.deb…donezimbra-mta……zimbra-mta_8.5.0.GA.3040.UBUNTU12.64_amd64.deb…donezimbra-snmp……zimbra-snmp_8.5.0.GA.3040.UBUNTU12.64_amd64.deb…donezimbra-store……zimbra-store_8.5.0.GA.3040.UBUNTU12.64_amd64.deb…donezimbra-apache……zimbra-apache_8.5.0.GA.3040.UBUNTU12.64_amd64.deb…donezimbra-spell……zimbra-spell_8.5.0.GA.3040.UBUNTU12.64_amd64.deb…done

    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 services…done.  This appears to be 8.0.7_GA  Starting mysql…done.  Checking ldap status…not running.  Checking ldap status…not running.  Starting ldap…done.  Checking ldap status…already running.

      Running mysql_upgrade…done.  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 mysql…done.  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 COS’s with attributes introduced after 8.0.7_GA…done.  Stopping ldap…done.  Upgrade complete.

    In the end of the Installation, the wizard will ask us about Notify Zimbra, is always appreciated and good idea if wecan 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 ([email protected])  Notify Zimbra of your installation? [Yes] yes

    The last message is the pat to the Log file 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 updateZCS 8.5.0

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

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    19/37

    Stopping the Zimbra Collaboration Services

    The first 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 SSHdaemon, 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 it’s 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, inthis 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 pressENTER all time:

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    20/37

      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] ?

     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 final 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: Ubuntu  Description: Ubuntu 14.04.1 LTS  Release: 14.04  Codename: trusty

    Update Zimbra 8.5.0 with Ubuntu 14.04 package

    The first 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

    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#

    Once we've downloaded the package, is time for extract it:

      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:

      Operations logged to /tmp/install.log.1821  Checking for existing installation…  zimbra-ldap…FOUND zimbra-ldap-8.5.0.GA.3040.UBUNTU12.64  zimbra-logger…FOUND zimbra-logger-8.5.0.GA.3040.UBUNTU12.64  zimbra-mta…FOUND zimbra-mta-8.5.0.GA.3040.UBUNTU12.64  zimbra-dnscache…NOT FOUND  zimbra-snmp…FOUND zimbra-snmp-8.5.0.GA.3040.UBUNTU12.64  zimbra-store…FOUND zimbra-store-8.5.0.GA.3040.UBUNTU12.64  zimbra-apache…FOUND zimbra-apache-8.5.0.GA.3040.UBUNTU12.64  zimbra-spell…FOUND zimbra-spell-8.5.0.GA.3040.UBUNTU12.64  zimbra-convertd…NOT FOUND  zimbra-memcached…NOT FOUND  zimbra-proxy…NOT FOUND

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    21/37

      zimbra-archiving…NOT FOUND  zimbra-cluster…NOT FOUND  zimbra-core…FOUND 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: paxFOUND: perl-5.18.2FOUND: sysstatFOUND: sqlite3Prerequisite check complete.

    We can run again the Database Integrity Check, it will takes some minutes or hours, depends of the size of it and alsoif 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 duringthis Upgrade time:

    Checking for installable packages

      Found zimbra-core  Found zimbra-ldap  Found zimbra-logger  Found zimbra-mta  Found zimbra-dnscache  Found zimbra-snmp  Found zimbra-store  Found zimbra-apache  Found zimbra-spell

      Found zimbra-memcached  Found 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 priorto 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 herewe can add the additional packages if we want:

      Do you wish to upgrade? [Y]

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

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    22/37

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

      The system will be modified. Continue? [N] y  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.5.0.GA.3040.UBUNTU14.64_amd64.deb…done  zimbra-ldap……zimbra-ldap_8.5.0.GA.3040.UBUNTU14.64_amd64.deb…done  zimbra-logger……zimbra-logger_8.5.0.GA.3040.UBUNTU14.64_amd64.deb…done  zimbra-mta……zimbra-mta_8.5.0.GA.3040.UBUNTU14.64_amd64.deb…done  zimbra-snmp……zimbra-snmp_8.5.0.GA.3040.UBUNTU14.64_amd64.deb…done  zimbra-store……zimbra-store_8.5.0.GA.3040.UBUNTU14.64_amd64.deb…done  zimbra-apache……zimbra-apache_8.5.0.GA.3040.UBUNTU14.64_amd64.deb…done  zimbra-spell……zimbra-spell_8.5.0.GA.3040.UBUNTU14.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/zmsetup08272014-130758.log  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.12706…done.  Operations logged to /tmp/zmsetup08272014-130758.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 help.zimbra.com…already exists.  Setting Zimbra IP Mode…done.  Saving CA in ldap …done.  Saving SSL Certificate in ldap …done.  Setting spell check URL…done.  [...]  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 wecan do it:

      You have the option of notifying Zimbra of your installation.

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    23/37

      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 ([email protected])  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 crontab…done.  Moving /tmp/zmsetup08272014-130758.log to /opt/zimbra/log  Configuration complete – press return to exit

    - This article is NOT official 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, orother 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 pictureof our Contacts and show it automatically in our Zimbra Web Client.

    Configuration

    The Zimlet LinkedIn Images came with the last Release of Zimbra 8.5, and it's free, we can use it in Open SourceEdition and also in Network Edition. But, first, we need to modify one file and also do some stuff 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 ourCompany can do it for free if have LinkedIn account.

    We need to go to [15] (https://www.linkedin.com/secure/developer) and Login with our credentialsWe need to fill the fields with our Information, an example (sorry for the spanish content but my LinkedInaccount is in spanish) Change my domain for yours.

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    24/37

    Next and very important is fill the next fields 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 

    Configuring & 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 file called com_zimbra_linkedinimage.xml and change the next variable with your own LinkedIn API KEY

    Save all of your files in a zip called com_zimbra_linkedinimage.zip with all of the files inside, no folders, justall the files.Go to your Zimbra Collaboration Administration Console, Configure>Zimlets and select the LinkedIn ImageZimlet and First Toggle Status for disable and second Undeploy 

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    25/37

    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 flush the zimlet cache

    Configuring & Using in our Web Client

    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.

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    26/37

    Next we will push in Start Scanning, and all of our Zimbra contacts that match with our LinkedIn Contacts willbe 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:

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    27/37

    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 Sourceusers can't use it. This vmware-ha service works combine with VMware vSphere HA VM Monitoring and offer us thepossibility to restart our Zimbra VM when any Zimbra service was down during the heartbeat defined time. Thezmhactl 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 different arguments (so zmhactl -> vmware-heartbeat -> vmware-appmonitor -> VMware HA).

     A. When the vmware-heartbeat script starts, it sends a vmware-appmonitor "enable" signalB. While running it does the following on a set schedule (every 15 seconds). This is supposedly configurable withlocalconfig vmware_heartbeat_interval, but it doesn't look like zmhactl actually uses that.

    i. runs vmware-appmonitor "isEnabled" to verify that application monitoring is enabledii. runs "zmcontrol status" and checks the return codeiii. 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 official information(http://blogs.vmware.com/vsphere/2014/03/vsphere-ha-vm-monitoring-back-basics.html) . What is vSphere HA VMmonitoring? 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) andThe VM isn't generating any storage or network IO (for 120 seconds by default, though this can be changedusing 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 customsettings for any of these options.

    Failure Interval Minimum uptime Maximum per-VM resets Maximum resets time window 

    Low  120 secs 480 secs 3 7 days

    Medium 60 secs 240 secs 3 24 hours

    High 30 secs 120 secs 3 1 hour

     What do the different options mean?

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

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    28/37

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

    How to activate it in Zimbra Collaboration

    The first step after the theory is activate it in our Zimbra different VM, we can check first 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>Configure>Servers (select the server that we want to activatethe 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:

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    29/37

    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 bestMonitoring sensitivity  for your environment is out of the Scope of the Zimbra Wiki and you need to have deepunderstand in VMware for select the best option for your Infrastructure. We are selecting the Low Monitoringsensitivity , 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 configure the best time for our Zimbra VM, if we select Custom VM Monitoring Settings.

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    30/37

     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 testit.

      [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 theWeb Page in a cPanel or Plesk service, but put the email in a Zimbra Collaboration Server. In this Wiki we will see howto 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 first step is obtain a complete list of the users that we want to import into our ZimbraCollaboration server. cPanel doesn't have any easy way to export all the email accounts, and neither the email accountwith password, so we can select all of them and then copy/paste in a excel or follow these steps: Login into our cPanel

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    31/37

    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

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    32/37

    use it later.

    Creating the 2 main XML files

    The Account Migration tool works perfect in Bulk if we prepare well two differents XML.

    The first xml is for the Account provisionThe second xml is for the IMAP data import

     Account provision XML

    The following example shows an XML file that is used to provision multiple email accounts without importing mail, wewill use the email accounts list that we exported before:

    SampleSamSam [email protected]

    ZackryZak

    Zak [email protected]

    In this Wiki example, the name of the account provision xml file 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 andintroduce all the usernames and passwords correctly. The following example shows an XML file that is used to importemail 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 file.

    imap.gmail.com143cleartext0

    SampleSamSam [email protected]@example.comtest123Account Migration

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    33/37

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

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

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

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    34/37

    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 file

    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.

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    35/37

    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 21:48:35,785 INFO [Thread-95] [] mailop - Adding Message: id=2552, Message-ID=, parentId=-1, folderId=257, folde2014-10-25 21:48:35,799 INFO [Thread-95] [] mailop - Adding Message: id=2553, Message-ID=, parentId=-1, folderId=257, folde2014-10-25 21:48:35,819 INFO [Thread-95] [] mailop - Adding Message: id=2554, Message-ID=, parentId=-1, folderId=257, fol2014-10-25 21:48:35,882 INFO [Thread-95] [] mailop - Adding Message: id=2555, Message-ID=, parentId=-1, folderId2014-10-25 21:48:35,896 INFO [Thread-95] [] mailop - Adding Message: id=2556, Message-ID=, parentId=-1, folderId=257, fo2014-10-25 21:48:35,915 INFO [Thread-95] [] mailop - Adding Message: id=2557, Message-ID=, parentId=-1, folderId=257, fol2014-10-25 21:48:36,000 INFO [Thread-95] [] mailop - Adding Message: id=2558, Message-ID=, parentId=-1, folderId2014-10-25 21:48:36,037 INFO [Thread-95] [] datasource - Import completed for data source '__imap_import__'

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

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    36/37

     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

    Zimbra.com|Popular Searches| About Zimbra

    Learn

    What is Zimbra?BenefitsDemos and VideosIndustry SolutionsCustomersCase Studies Awards

    Products

    Zimbra Collaboration ServerZimbra Cloud and VirtualizationZimbra Open Source

    Zimbra DesktopCompare ProductsPricingWhat’s NewDownloads

    Community 

    ForumsDocumentationWikiBlogGallery

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz

    e 37 25/11/1

  • 8/9/2019 Apuntes de Zimbra

    37/37

    Submit BugRelease StatusDeveloper ZoneContribute

    Support

    Zimbra Support Program OverviewUser HelpZimbra Customer Support Portal

    Partners

    Zimbra Hosting ProvidersZimbra VARsZimbra Training ProvidersResources For Partners

     About

    CareersNews

    EventsWebinarsMediaContact Us

    TwitterLinkedInFacebook 

    Email SoftwareEmail HostingZimbra Mail ServerEmail Archiving and Compliance Software

    Calendar and Collaboration

    Microsoft Outlook AlternativeZimbra for BlackBerry & iPhoneSecure Email & Anti SpamUnified Messaging

    Zimbra powers collaboration for the way you work. Zimbra connects people and information with unifiedcollaboration software that includes email, calendaring, file sharing, activity streams, social communities and more.With technology designed for social, mobile and the cloud, Zimbra gives individuals the flexibility to work from virtually anywhere, through nearly every computer, tablet and mobile device.

    acruz-Notes - Zimbra :: Wiki https://wiki.zimbra.com/index.php?title=Jdelacruz