Zimbra Next Generation Modules/Things To Know Before Upgrading: Difference between revisions

mNo edit summary
(24 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<div class="col-md-12"><br></div>
<div class="col-md-12"><br></div>
<ol class="breadcrumb">
  <li>[[Main Page|Zimbra Wiki]]</li>
  <li>[[Zimbra_Next_Generation_Modules]]</li>
  <li class="active">Things to Know Before Upgrading</li>
</ol>
__NOTOC__
<div class="col-md-12"><br /></div>
<div class="col-md-9">
    <h2 class="title-header" style="padding-bottom: 9px; border-bottom: 4px solid #0087c3;">Zimbra NG - Things to Know Before Upgrading</h2>
    <div class="col-md-12">
        <div class="ibox-content">
            <div class="post animated fadeInLeft animation-delay-8" style="padding-top:5px">
                <div class="panel panel-default">
                    <div class="panel-body">
                        <h5 class="post-title">Zimbra NG - Things to Know Before Upgrading</h5>
                        <div class="row">
This wiki will provide an overview on what you need to know when migrating to 8.8 and how the Next Generation Modules will effect your experience.


<div class="alert alert-dark fade in"> <p>'''The NG modules should not be enabled unless you plan to upgrade all nodes in your deployment. Doing so will surface problems in the admin console. This is applicable for upgrades as well as brand new multi-node installations. We recommend disabling the modules on upgraded nodes until all are upgraded and then enabling.'''




==<b>Upgrading from version between 8.0 to 8.6</b>==
'''Mobile NG is not currently compatible with two factor authentication or S/MIME. For those who need these two features, please use the legacy mobile sync service at this time.'''


'''The beta version of the remote IMAP service (imapd) ships in this release, but defaults does not install by default during installation. Please do not enable for production environments'''
</p></div>
==Upgrading from version between 8.0 to 8.6==
Upgrading to 8.8 is supported but there are a number of items you need to be aware of:
Upgrading to 8.8 is supported but there are a number of items you need to be aware of:
* 8.8 requires the installation of the proxy server on all setups.  In most cases a single server installation does not have proxy installed and configured.  The following command can be used to see if proxy is installed and enable.  
* 8.8 requires the installation of the proxy server on all setups.  In most cases a single server installation does not have proxy installed and configured.  The following command can be used to see if proxy is installed and enable.  
  [zimbra@Server ~]$ zmprov gs `zmhostname` |grep zimbraService |grep proxy  
  [zimbra@Server ~]$ zmprov gs `zmhostname` |grep zimbraService |grep proxy  
  zimbraServiceEnabled: proxy
  zimbraServiceEnabled: proxy
  zimbraServiceInstalled: proxy
  zimbraServiceInstalled: proxy


If proxy shows as installed and enabled then proxy is running within your system.  If not, then you will need to enable proxy by following the [[Enabling_Zimbra_Proxy_and_memcached|'''Enabling Zimbra Proxy and memcached''']] wiki.
If proxy shows as installed and enabled then proxy is running within your system.  If not, then you will need to enable proxy by following the [[Enabling_Zimbra_Proxy_and_memcached|'''Enabling Zimbra Proxy and memcached''']] wiki.


 
==Upgrading from version between 6.0.8 to 7.2.x==
<b>Upgrading from version between 6.0.8 to 7.2.x </b>
 
 
In most cases, Zimbra Support recommends doing a migration to a new system, for more information, please see [[ZCS88-zxbackup-migration |'''Incremental Migration using Next Generation Backup''']]  
In most cases, Zimbra Support recommends doing a migration to a new system, for more information, please see [[ZCS88-zxbackup-migration |'''Incremental Migration using Next Generation Backup''']]  


==<b>Licensing</b>==
==Licensing==
 
There are no new license requirements for next generation modules.  All new modules require a valid license and the number of accounts that can use the Mobile modules will be limited to the number defined by MobileSyncAccountsLimit within the license.  You can verify the license by running the following from the command line:
There are no new license requirements for next generation modules.  All new modules require a valid license and the number of accounts that can use the Mobile modules will be limited to the number defined by MobileSyncAccountsLimit within the license.  You can verify the license by running the following from the command line:
  zmlicense -p
  zmlicense -p


==<b>Migration</b>==
==Zimbra  Suite Plus (ZSP) or Zextras Suite Network Edition User==
 
Customers who are running Network Edition 8.7 and below and are using Zimbra  Suite Plus (ZSP) or Zextras Suite licensing will no longer need to install separate licensing components.  If selected, 8.8 will have all features found within ZSP and Zextras Suite installed during the upgrade. You must select zimbra-network-modules-ng during the upgrade process for this to be enabled


Zimbra  Suite Plus (ZSP)  version 2.5 and higher are only supported on Open Source servers, the installer will no longer allow you to install on network addition.


==<b> Upgrade Process </b>==
==Migration==


==Upgrade Process==
During the upgrade process you will be prompted to install the new Modules
During the upgrade process you will be prompted to install the new Modules
 
  Install zimbra-chat [Y]
  <i>Install zimbra-chat [Y]
  Install zimbra-drive [Y]
  Install zimbra-drive [Y]
  Install zimbra-imapd [Y]
  Install zimbra-imapd [Y]
  Install zimbra-network-modules-ng [Y]</i>
  Install zimbra-network-modules-ng [Y]


IMAPD is a beta feature but the installer is set to install the packages as part of the default installation for upgrades and new installations.  Because the module is independent from the remaining modules and needs to be enabled after installation, this will not effect your current production installation.  If you like to exclude the module from your installation, you can enter <b><i>N</i></b> when selecting modules section of the installation process.   
IMAPD is a beta feature but the installer is set to install the packages as part of the default installation for upgrades and new installations.  Because the module is independent from the remaining modules and needs to be enabled after installation, this will not effect your current production installation.  If you like to exclude the module from your installation, you can enter <b><i>N</i></b> when selecting modules section of the installation process.   
 
  Install zimbra-imapd [Y] N
  <i> Install zimbra-imapd [Y] <b>N </b> </i>


Because IMAPD is a beta module, it is not a supported feature and is recommended only to be enabled on non production systems.
Because IMAPD is a beta module, it is not a supported feature and is recommended only to be enabled on non production systems.


If network modules are excluded during a new installation or upgrade, to install them at a later date, you will need to run the installer and select the packages.  After installation is complete, please review [[Zimbra_Next_Generation_Modules/Known_Issue/Missing_NG_Modules_After_Installation |'''Missing NG Modules After Installation''']]


If network modules are excluded during a new installation or upgrade, to install them at a later date, you will need to run the installer and select the packages.  After installation is complete, please review
==NG Features OverView==
 
<u>NG HSM Module:</u>  After a successful upgrade the new HSM will be enabled.  No action needed
==<b> NG Features OverView</b>==
 
<b> <u>NG HSM Module:</u></b>  After a successful upgrade the new HSM will be enabled.  No action needed


<b> <u>NG Mobile Module:</u></b> With a successful upgrade, you will need to know the following:
<u>NG Mobile Module:</u>
<div class="alert alert-dark fade in"> <p>'''NOTE: If you are upgrading and/or migrating from an older version of Zimbra to Zimbra 8.8 Production Ready and you plan to enable the new mobile sync for a deployment currently using Zimbra's mobile sync feature, please use caution before enabling the new mobile sync as the token reset will cause all user devices to reload their account data.'''</p></div>  
With a successful upgrade, you will need to know the following:
* Activation of NG mobile module needs to be performed on each mail store
* Activation of NG mobile module needs to be performed on each mail store
* All accounts on the mail store will be migrated to the new NG mobile module at the time of activation
* All accounts on the mail store will be migrated to the new NG mobile module at the time of activation
Line 66: Line 82:




<b> <u>NG Admin Module:</u></b>With a successful upgrade, you will need to know the following:
<u>NG Admin Module:</u> With a successful upgrade, you will need to know the following:
* Admin NG is not enabled by default during upgrades from a version earlier than 8.8, so it must be enabled manually before migrating to it.
* Activation of NG Admin module needs to be performed after upgrade.
* Activation of NG Admin module needs to be performed after upgrade.
* When activating NG Admin module all servers in the cluster will be effected.
* When activating NG Admin module all servers in the cluster will be effected.
* Activating NG Admin module will convert existing ACL’s rules into NG Admin rules
* Existing ACL’s rules will be removed from the system.
* Existing ACL’s rules will be removed from the system.
* There is no option to restore legacy ACL’s.  
* There is no option to restore legacy ACL’s.  
* Support recommend testing NG Admin Module on a test system to verify it meets your origination needs.  
* Support recommend testing NG Admin Module on a test system to verify it meets your origination needs.
 


<b> <u>NG Backup Module:</u></b> With a successful upgrade, you will need to know the following:


<u>NG Backup Module:</u> With a successful upgrade, you will need to know the following:
* NG Backup Module will be installed on each Mail Store doing the upgrade or installation.
* NG Backup Module will be installed on each Mail Store doing the upgrade or installation.
* NG Backup Module will only backup the account on the mail store  
* NG Backup Module will only backup the account on the mail store  
Line 82: Line 97:
* NG Backup Module will perform a full scan at initialization - we recommend during after hours to limit system performance  
* NG Backup Module will perform a full scan at initialization - we recommend during after hours to limit system performance  
* Legacy backup needs to disabled after completion of first scan
* Legacy backup needs to disabled after completion of first scan
                        </div>
                    </div>
                    <div class="col-md-9">
                        <div class="panel-footer">
                        </div>
                    </div>
                </div>
            </div>
        </div>
    </div>
</div>
<div class="col-md-3"><br /></div>
<div class="col-md-3">
    <div class="panel panel-zimbrared-light-border">
        <div class="panel-heading">
            <h3 class="panel-title"><i class="fa fa-gear pull-left"></i> Zimbra Next Generation Modules</h3>
        </div>
        <div class="panel-body">
            {{ZNG}}
        </div>
    </div>
</div>
<div class="col-md-3">
    <div class="panel panel-primary-light-border">
        <div class="panel-heading">
            <h3 class="panel-title"><i class="fa fa-info-circle pull-left"></i> Zimbra Next Generation Modules Resources</h3>
        </div>
        <div class="panel-body">
            {{ZNGL}}
        </div>
    </div>
</div>
<div class="clearfix"></div>
<div class="col-md-12"><br></div>
{{FH}}

Revision as of 18:25, 15 November 2017




Zimbra NG - Things to Know Before Upgrading

Zimbra NG - Things to Know Before Upgrading

This wiki will provide an overview on what you need to know when migrating to 8.8 and how the Next Generation Modules will effect your experience.

The NG modules should not be enabled unless you plan to upgrade all nodes in your deployment. Doing so will surface problems in the admin console. This is applicable for upgrades as well as brand new multi-node installations. We recommend disabling the modules on upgraded nodes until all are upgraded and then enabling.


Mobile NG is not currently compatible with two factor authentication or S/MIME. For those who need these two features, please use the legacy mobile sync service at this time.


The beta version of the remote IMAP service (imapd) ships in this release, but defaults does not install by default during installation. Please do not enable for production environments

Upgrading from version between 8.0 to 8.6

Upgrading to 8.8 is supported but there are a number of items you need to be aware of:

  • 8.8 requires the installation of the proxy server on all setups. In most cases a single server installation does not have proxy installed and configured. The following command can be used to see if proxy is installed and enable.
[zimbra@Server ~]$ zmprov gs `zmhostname` |grep zimbraService |grep proxy 
zimbraServiceEnabled: proxy
zimbraServiceInstalled: proxy

If proxy shows as installed and enabled then proxy is running within your system. If not, then you will need to enable proxy by following the Enabling Zimbra Proxy and memcached wiki.

Upgrading from version between 6.0.8 to 7.2.x

In most cases, Zimbra Support recommends doing a migration to a new system, for more information, please see Incremental Migration using Next Generation Backup

Licensing

There are no new license requirements for next generation modules. All new modules require a valid license and the number of accounts that can use the Mobile modules will be limited to the number defined by MobileSyncAccountsLimit within the license. You can verify the license by running the following from the command line:

zmlicense -p

Zimbra Suite Plus (ZSP) or Zextras Suite Network Edition User

Customers who are running Network Edition 8.7 and below and are using Zimbra Suite Plus (ZSP) or Zextras Suite licensing will no longer need to install separate licensing components. If selected, 8.8 will have all features found within ZSP and Zextras Suite installed during the upgrade. You must select zimbra-network-modules-ng during the upgrade process for this to be enabled

Zimbra Suite Plus (ZSP) version 2.5 and higher are only supported on Open Source servers, the installer will no longer allow you to install on network addition.

Migration

Upgrade Process

During the upgrade process you will be prompted to install the new Modules

Install zimbra-chat [Y]
Install zimbra-drive [Y]
Install zimbra-imapd [Y]
Install zimbra-network-modules-ng [Y]

IMAPD is a beta feature but the installer is set to install the packages as part of the default installation for upgrades and new installations. Because the module is independent from the remaining modules and needs to be enabled after installation, this will not effect your current production installation. If you like to exclude the module from your installation, you can enter N when selecting modules section of the installation process.

Install zimbra-imapd [Y] N

Because IMAPD is a beta module, it is not a supported feature and is recommended only to be enabled on non production systems.

If network modules are excluded during a new installation or upgrade, to install them at a later date, you will need to run the installer and select the packages. After installation is complete, please review Missing NG Modules After Installation

NG Features OverView

NG HSM Module: After a successful upgrade the new HSM will be enabled. No action needed

NG Mobile Module:

NOTE: If you are upgrading and/or migrating from an older version of Zimbra to Zimbra 8.8 Production Ready and you plan to enable the new mobile sync for a deployment currently using Zimbra's mobile sync feature, please use caution before enabling the new mobile sync as the token reset will cause all user devices to reload their account data.

With a successful upgrade, you will need to know the following:

  • Activation of NG mobile module needs to be performed on each mail store
  • All accounts on the mail store will be migrated to the new NG mobile module at the time of activation
  • The existing sync profiles will be used by the NG mobile module.
  • Users do not need to update the profile on the device(s)
  • Sync tokens will automatically be reset, which causes all data to automatically be reloaded on each device.
  • Legacy data will be removed before new data is synced. Users could see the data on the device disappear the reappear, but all data should be the same.
  • After device has been fully synced, users will be able to sync shared calendars, contacts and mail folders.
  • Zimbra Support recommends planning activation of NG mobile module during off hours to limit the confusion and user interruption that may occur do to re-syncing data.
  • For customers running multiple mail stores, Support recommends staggering activation of NG mobile modules to limit end user confusion, network traffic and IO issues.


NG Admin Module: With a successful upgrade, you will need to know the following:

  • Admin NG is not enabled by default during upgrades from a version earlier than 8.8, so it must be enabled manually before migrating to it.
  • Activation of NG Admin module needs to be performed after upgrade.
  • When activating NG Admin module all servers in the cluster will be effected.
  • Existing ACL’s rules will be removed from the system.
  • There is no option to restore legacy ACL’s.
  • Support recommend testing NG Admin Module on a test system to verify it meets your origination needs.


NG Backup Module: With a successful upgrade, you will need to know the following:

  • NG Backup Module will be installed on each Mail Store doing the upgrade or installation.
  • NG Backup Module will only backup the account on the mail store
  • NG Backup Module needs to be manually enabled
  • NG Backup Module will perform a full scan at initialization - we recommend during after hours to limit system performance
  • Legacy backup needs to disabled after completion of first scan

Zimbra Next Generation Modules

logo.png

Latest Version: 8.8

Zimbra Next Generation Modules Resources

Here you can find useful resources for your Zimbra NG Modules



Try Zimbra

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

Want to get involved?

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

Looking for a Video?

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

Jump to: navigation, search