View source for Zimbra NG Modules/Zimbra NG HSM/doMoveBlobs

<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_NG_Modules]]</li>
  <li>[[Zimbra_NG_HSM]]</li>
  <li class="active">Zimbra NG HSM - doMoveBlobs</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 HSM - doMoveBlobs</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">
                        <div class="row">

== The doMoveBlobs operation of Zimbra NG HSM ==
The doMoveBlobs is the heart of the Zimbra NG HSM Modules.

It's duty is to move items between the Current Primary Store and the Current Secondary Store according to the proper HSM policy.

The move is performed by a transactional algorythm, so should an error occour during one of the steps of the operation a rollback would take place and no change will be made to the data.

Once Zimbra NG HSM identifies the items to be moved, the following steps are performed:
* Create a copy of the Blob to the Current Secondary Store.
* Update the Zimbra Database in order to notify Zimbra of the new position of the item.
* Delete the original Blob from the Current Primary Store.
 
==== What will be moved ====
Basically, every item that complies to the specified HSM policy.

Example:

The following policy
<pre>
message,document:before:-20day
message:before:-10day has:attachment
</pre>
will move all emails and documents older than 20 days along with all emails older than 10 days and containing an attachment.

==== Policy order ====
All conditions for a policy are executed in the exact order they are specified. Zimbra NG HSM will loop on all items in the Current Primary Store and apply each separate condition before starting the next one.

This mean that the following policies
<pre>
message,document:before:-20day
message:before:-10day has:attachment
</pre>
 
<pre>
message:before:-10day has:attachment
message,document:before:-20day
</pre>

applied daily on a sample server that sends/receives a total of 1000 emails per day, 100 of which containing one or more attachments, will have the same final result while the execution time will probably be slightly higher (or much higer, depending on the number and size of the emails in the server).

This is because in the first policy the first condition (message,document:before:-20day) will loop on all items, move many of them to the Current Secondary Store, leaving less items for the second condition to loop on.

Viceversa, having the "message:before:-10day has:attachment" as the first condition will leave more items for the second condition to loop on.


This is just an example and does not apply to all cases, but gives an idea on the need to carefully plan your HSM policy.

== Executing the doMoveBlobs operation (a.k.a. Applying the HSM policy) ==
"Applying a policy" means running the "doMoveBlobs" operation in order to move items between the Primary and Secondary store according to the defined policy.

Zimbra NG HSM gives you 3 different options to do so:

* via the Zimbra NG Modules Administration Zimlet
* via the Zimbra NG Modules CLI
* through Scheduling

==== Apply the HSM Policy via the Zimbra NG Modules Administration Zimlet ====
In order to apply the HSM Policy via the Zimbra NG Modules Administration Zimlet:
* Log into the Zimbra Administration Console
* Click the "Zimbra NG HSM" entry on the Zimbra NG Modules Administration Zimlet
* Click the "Apply Policy" button

==== Apply the HSM Policy via the Zimbra NG Modules CLI ====
In order to apply the HSM Policy via the Zimbra NG Modules CLI, run the following command as the 'zimbra' user:
  zxsuite powerstore doMoveBlobs
 
==== Apply the HSM Policy through Scheduling ====
In order to schedule a daily execution of the "doMoveBlobs" operation:
* Log into the Zimbra Administration Console
* Click the "Zimbra NG HSM" entry on the Zimbra NG Modules Administration Zimlet
* Enable the scheduling by selecting the  "Enable Policy Application scheduling" button
* Select the hour to run the operation under "Policy Application scheduled for:"

== doMoveBlobs Stats and Info ==
Informations about disk space savings, operation performances and more are available by clicking the "Stats" button under the "Secondary Volumes" list in the Zimbra NG HSM tab of the Zimbra NG Modules Administration Zimlet.

                        </div>
                    </div>
                    <div class="col-md-9">
                        <div class="panel-footer">
                            <p><i class="fa fa-clock-o"></i> Aug 25, 2016 - [https://www.zimbra.com/email-server-software/ Know more »]</p>
                        </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 NG 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 NG Modules Resources</h3> 
        </div>
        <div class="panel-body">
            {{ZNGL}}
        </div>
    </div>
</div>
<div class="clearfix"></div>
<div class="col-md-12"><br></div>
{{FH}}