Difference between revisions of "Zimbra Next Generation Modules/First Steps with the Zimbra NG Modules"

(Created page with "<div class="col-md-12"><br></div> <div class="col-md-12"><br></div> <ol class="breadcrumb"> <li>Zimbra Wiki</li> <li>Zimbra_Next_Generation_Modules</li>...")
 
Line 16: Line 16:
 
                     <div class="panel-body">
 
                     <div class="panel-body">
 
                         <div class="row">
 
                         <div class="row">
{{WIP}}
+
This guides contains all information needed in order to switch to the new Zimbra Network NG modules from their legacy counterparts after upgrading to Zimbra 8.8.
  
This guides contains all information needed in order to switch to the new Zimbra Network NG modules from their legacy counterparts after upgrading to Zimbra 8.8.
+
''It's strongly suggested to take a look ad the specific introductory page of each module before switching, to learn and understand the differences between each NG module and its Legacy counterpart:''
  
''It's strongly suggested to take a look ad the specific introductory guide of each module before switching, to learn and understand the differences between each NG module and its Legacy counterpart:''
+
      <ul>
 +
                                <li>[[Zimbra_Next_Generation_Modules/Zimbra_NG_Backup|'''Zimbra NG Backup''']]: Features a cutting-edge, real-time engine that backs up every single item and event on your Zimbra server with split-second precision. Avoids data loss by using atomic and ever-consistent algorithms, while still saving disk space thanks to an intelligent de-duplication and compression system.</li>
 +
                                <li>[[Zimbra_Next_Generation_Modules/Zimbra_NG_Admin|'''Zimbra NG Admin''']]: Global Admin can grant Delegated Admin rights to users on your server using a simplified administrator user interface.  With minimal effort, you can grant user management tasks, such as setting quotas, user limits and modifying COS variables for your domain(s).</li>
 +
                                <li>[[Zimbra_Next_Generation_Modules/Zimbra_NG_HSM|'''Zimbra NG HSM''']]: Manage multiple volumes and HSM policies through the Zimbra Collaboration Next Generation HSM Module. With an integrated user interface into your Zimbra Administration Console, the HSM Module gives you the tools to organize and manage your storage effectively.</li>
 +
                                <li>[[Zimbra_Next_Generation_Modules/Zimbra_NG_Mobile|'''Zimbra NG Mobile''']]: With the advance integration, now your users can sync their primary and shared folders to their mobile devices while administrators have an advanced interface to manage policies and devices.
 +
                                </li>
 +
                            </ul>
  
* [[An_Introduction_to_Backup_NG | An introduction to Backup NG]]
+
<!-- * [[An_Introduction_to_Backup_NG | An introduction to Backup NG]] -->
* [[An_Introduction_to_Mobile_NG | An introduction to Mobile NG]]
+
<!-- * [[An_Introduction_to_Mobile_NG | An introduction to Mobile NG]] -->
* [[An_Introduction_to_HSM_NG | An introduction to HSM NG]]
+
<!-- * [[An_Introduction_to_HSM_NG | An introduction to HSM NG]] -->
* [[An_Introduction_to_Admin_NG | An introduction to Admin NG]]
+
<!-- * [[An_Introduction_to_Admin_NG | An introduction to Admin NG]] -->
 
-----
 
-----
  
Line 52: Line 58:
  
 
== Usage Guide ==
 
== Usage Guide ==
A complete user guide for the Backup NG Module is available in the ''"Backup Next Generation (NG)"'' section of the [https://zimbra.github.io/adminguide/ Zimbra Administrator's Guide] for your Zimbra version.
+
A complete user guide for the Backup NG Module is available in the [https://zimbra.github.io/adminguide/latest/index.html#backup-ng-guide ''"Backup Next Generation (NG)"'' section of the Administrator's Guide] for your Zimbra version.
 
-----
 
-----
  
Line 59: Line 65:
  
 
==What happens after the switch==
 
==What happens after the switch==
After switching to Mobile NG, all existing syncstates will be invalidated, and all connected devices will automatically re-synchronize all of their data through the new engine. The switch is completely transparent to end users, and no user interaction will be prompted or required.
+
After switching to Mobile NG, all existing syncstates will be invalidated, and all connected devices will automatically re-synchronize all of their data through the new engine.
 +
 
 +
'''WARNING: Since the switch will force all connected devices to re-synchonise all of their data, make sure to alert your users beforehand to make sure that they have wifi coverage or enough traffic on their mobile data plans.'''
 +
 
 +
'''Furthermore, the switch might lead to an abrupt increase in the number of connections to the server, and consequently its load, due to the resynchronisation of all devices.'''
 +
 
 +
The switch is completely transparent to end users, and no user interaction should be prompted or required, but being the Exchange ActiveSync protocol mostly client-driven different behaviours might be experienced, such as:
 +
 
 +
* Device not synchronising until user's action (e.g. opening the email client).
 +
* Device requiring a restart.
 +
* Device not synchronising until the user re-enter its username and password in the account's settings.
  
'''Since the switch will force all connected devices to re-synchonize all of their data, make sure to alert your users beforehand to make sure that they have wifi coverage or enough traffic on their mobile data plans.'''
+
''Albeit sporadic, such behaviours and the load impact on the system should be taken into account when planning to switch to Mobile NG.''
  
 
==Mobile NG Initialization==
 
==Mobile NG Initialization==
Line 71: Line 87:
  
 
== Usage Guide ==
 
== Usage Guide ==
A complete user guide for the Mobile NG Module is available in the ''"Mobile NG"'' section of the [https://zimbra.github.io/adminguide/ Zimbra Administrator's Guide] for your Zimbra version.
+
A complete user guide for the Mobile NG Module is available  [https://zimbra.github.io/adminguide/latest/index.html#mobile-ng-guide in the ''"Mobile NG"'' section of the Zimbra Administrator's Guide] for your Zimbra version.
 
-----
 
-----
  
Line 80: Line 96:
  
 
== Usage Guide ==
 
== Usage Guide ==
A complete user guide for the HSM NG Module is available in the ''"HSM NG"'' section of the  [https://zimbra.github.io/adminguide/ Zimbra Administrator's Guide] for your Zimbra version.
+
A complete user guide for the HSM NG Module is available in the [https://zimbra.github.io/adminguide/latest/index.html#hsm-ng-guide ''"HSM NG"'' section of the Zimbra Administrator's Guide] for your Zimbra version.
 
-----
 
-----
  
Line 86: Line 102:
 
Switching to the new Admin NG module is a simple process that will migrate any relevant ACL information to the module’s own configuration manager, clearing existing ACLs and ACEs from the system.
 
Switching to the new Admin NG module is a simple process that will migrate any relevant ACL information to the module’s own configuration manager, clearing existing ACLs and ACEs from the system.
  
'''The Admin NG module is significantly different than the old Delegated Administration engine. Please make sure to read the product’s documentation and to only migrate to Admin NG if its feature set meets your needs.'''
+
'''Admin NG is significantly different than the old Delegated Administration engine. Please carefully read the product's documentation thoroughly and only migrate to Admin NG if its feature set meets your needs.'''
  
 
==Admin Migration is a ONE WAY ONLY process==
 
==Admin Migration is a ONE WAY ONLY process==
Admin Migration is a one way only process. Once Admin NG is initialized it’s not possible to go back to the old engine, so if you have customized or complex ACLs/ACEs consider whether switching or not carefully.
+
'''Switching to Admin NG will remove all existing ACLs and ACEs from the server. This new module is extremely different from its legacy counterpart, so after the migration will not be able to recreate the very same admin roles and settings'''
 +
 +
'''''This is a one way only process.'''''
 +
 
 +
'''Once Admin NG is initialized it's not possible to go back to the old engine, so if you have customized or complex ACLs/ACEs carefully consider whether or not to switch.'''
  
 
==Admin NG Initialization==
 
==Admin NG Initialization==
To initialize the Admin NG module on Zimbra 8.7.6 to 8.8.3:
+
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.
 +
 
 +
To enable Admin NG run the following command as the "zimbra" user on any mailbox server:
 +
<pre>zmprov mcf zimbraNetworkAdminNGEnable TRUE</pre>
 +
 
 +
To initialize the Admin NG module on Zimbra 8.7.6 to 8.8.4:
 
* Access the Zimbra Administration Console.
 
* Access the Zimbra Administration Console.
 
* Enter the "Network Modules NG" section on the left menu.
 
* Enter the "Network Modules NG" section on the left menu.
Line 98: Line 123:
 
* Click on the "Migrate" button.
 
* Click on the "Migrate" button.
  
To initialize the Admin NG module on Zimbra 8.8.4 and higher:
+
 
 +
To initialize the Admin NG module on Zimbra 8.8.5 and higher:
 
*TBA
 
*TBA
  
 
== Usage Guide ==
 
== Usage Guide ==
A complete user guide for the Admin NG Module is available in the ''"Admin NG"'' section of the  [https://zimbra.github.io/adminguide/ Zimbra Administrator's Guide] for your Zimbra version.
+
A complete user guide for the Admin NG Module is available in the [https://zimbra.github.io/adminguide/latest/index.html#admin-ng-guide  ''"Admin NG"'' section of the Zimbra Administrator's Guide] for your Zimbra version.
  
 
                         </div>
 
                         </div>

Revision as of 07:59, 24 October 2017




First Steps with the Zimbra NG Modules

This guides contains all information needed in order to switch to the new Zimbra Network NG modules from their legacy counterparts after upgrading to Zimbra 8.8.

It's strongly suggested to take a look ad the specific introductory page of each module before switching, to learn and understand the differences between each NG module and its Legacy counterpart:

  • Zimbra NG Backup: Features a cutting-edge, real-time engine that backs up every single item and event on your Zimbra server with split-second precision. Avoids data loss by using atomic and ever-consistent algorithms, while still saving disk space thanks to an intelligent de-duplication and compression system.
  • Zimbra NG Admin: Global Admin can grant Delegated Admin rights to users on your server using a simplified administrator user interface. With minimal effort, you can grant user management tasks, such as setting quotas, user limits and modifying COS variables for your domain(s).
  • Zimbra NG HSM: Manage multiple volumes and HSM policies through the Zimbra Collaboration Next Generation HSM Module. With an integrated user interface into your Zimbra Administration Console, the HSM Module gives you the tools to organize and manage your storage effectively.
  • Zimbra NG Mobile: With the advance integration, now your users can sync their primary and shared folders to their mobile devices while administrators have an advanced interface to manage policies and devices.

Switching to Backup NG

Switching to the new Backup NG is a simple process that will initialize the new backup system on a dedicated path. Until the initialization is completed, the old backup engine will be active. Old backup files will not be removed and the old backup and restore tools are still available via the usual CLI commands.

Backup Path Limitations

In order to hold Backup NG data, a storage must comply to the following:

  • The storage must have a mountpoint on the system.
  • The "zimbra" user must of course have r/w permission on the path.
  • The data must be stored on a case-sensitive filesystem.

Other than this, there are no hard limitations.

Backup NG Initialization

Before initializing the Backup NG module, make sure you have enough space on the storage you wish to store the backup in. The average size of the backup is 50-70% of the nominal total quota of all mailboxes.

To initialize the Backup NG module:

  • Access the Zimbra Administration Console.
  • Enter the "Network Modules NG" section on the left menu.
  • Enter the "Backup" section.
  • Set the "Backup Path" to whatever directory you wish to store your backup into.
  • Click on the "Initialize" button

Usage Guide

A complete user guide for the Backup NG Module is available in the "Backup Next Generation (NG)" section of the Administrator's Guide for your Zimbra version.


Switching to Mobile NG

Switching to the new Mobile NG is a simple process that will activate the new mobile handlers, deactivate the old ones and switch the synchronization control over to Mobile NG from the legacy Zimbra Mobile. Until the initialization is completed, the old mobile engine will be active.

What happens after the switch

After switching to Mobile NG, all existing syncstates will be invalidated, and all connected devices will automatically re-synchronize all of their data through the new engine.

WARNING: Since the switch will force all connected devices to re-synchonise all of their data, make sure to alert your users beforehand to make sure that they have wifi coverage or enough traffic on their mobile data plans.

Furthermore, the switch might lead to an abrupt increase in the number of connections to the server, and consequently its load, due to the resynchronisation of all devices.

The switch is completely transparent to end users, and no user interaction should be prompted or required, but being the Exchange ActiveSync protocol mostly client-driven different behaviours might be experienced, such as:

  • Device not synchronising until user's action (e.g. opening the email client).
  • Device requiring a restart.
  • Device not synchronising until the user re-enter its username and password in the account's settings.

Albeit sporadic, such behaviours and the load impact on the system should be taken into account when planning to switch to Mobile NG.

Mobile NG Initialization

To initialize the Mobile NG module:

  • Access the Zimbra Administration Console.
  • Enter the "Network Modules NG" section on the left menu.
  • Enter the "Mobile" section.
  • Click on the "Activate" button.

Usage Guide

A complete user guide for the Mobile NG Module is available in the "Mobile NG" section of the Zimbra Administrator's Guide for your Zimbra version.


Switching to HSM NG

The HSM NG module will become active as soon as the upgrade to Zimbra 8.8 is completed, and does not require any interaction.

Any old HSM policy, volume and volume configuration will be maintained.

Usage Guide

A complete user guide for the HSM NG Module is available in the "HSM NG" section of the Zimbra Administrator's Guide for your Zimbra version.


Switching to Admin NG

Switching to the new Admin NG module is a simple process that will migrate any relevant ACL information to the module’s own configuration manager, clearing existing ACLs and ACEs from the system.

Admin NG is significantly different than the old Delegated Administration engine. Please carefully read the product's documentation thoroughly and only migrate to Admin NG if its feature set meets your needs.

Admin Migration is a ONE WAY ONLY process

Switching to Admin NG will remove all existing ACLs and ACEs from the server. This new module is extremely different from its legacy counterpart, so after the migration will not be able to recreate the very same admin roles and settings

This is a one way only process.

Once Admin NG is initialized it's not possible to go back to the old engine, so if you have customized or complex ACLs/ACEs carefully consider whether or not to switch.

Admin NG Initialization

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.

To enable Admin NG run the following command as the "zimbra" user on any mailbox server:

zmprov mcf zimbraNetworkAdminNGEnable TRUE

To initialize the Admin NG module on Zimbra 8.7.6 to 8.8.4:

  • Access the Zimbra Administration Console.
  • Enter the "Network Modules NG" section on the left menu.
  • Enter the "Admin" section.
  • Click on the "Migrate" button.


To initialize the Admin NG module on Zimbra 8.8.5 and higher:

  • TBA

Usage Guide

A complete user guide for the Admin NG Module is available in the "Admin NG" section of the Zimbra Administrator's Guide for your Zimbra version.


Zimbra NG Modules

zimbra-logo-color.png

Latest Version: 8.8

Zimbra NG 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