|
|
Line 1: |
Line 1: |
| <div class="col-md-12"><br></div>
| | #REDIRECT [[Zimbra_NG_Modules/Zimbra_NG_HSM/Volume_Management]] |
| <div class="col-md-12"><br></div>
| |
| <ol class="breadcrumb">
| |
| <li>[[Main Page|Zimbra Wiki]]</li>
| |
| <li>[[Zimbra_Next_Generation_Modules]]</li>
| |
| <li>[[Zimbra_NG_HSM]]</li>
| |
| <li class="active">Zimbra NG HSM - Volume Management</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 - Volume Management</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 HSM - Volume Management</h5>
| |
| <div class="row">
| |
| == Zimbra Volumes ==
| |
| A Volume is the physical representation of the notion of [[Zimbra_Next_Generation_Modules/Zimbra_NG_HSM/Hierarchical_Storage_Management#Stores.2C_Volumes_and_Policies|Store]], a distinct entity (path) on a filesystem with all the associated properties.
| |
| | |
| ==== Volume Properties ====
| |
| All Zimbra Volumes are defined by the following properties:
| |
| | |
| * Name: a unique identifier for the volume
| |
| * Path: the path where the data is going to be saved. ''The Zimbra user must have r/w permissions on this path''.
| |
| * Compression: Enable or Disable the file compression for the volume.
| |
| * Compression Threshold: the minimum file size that will trigger the compression. 'Files under this size will never be compressed even if the compression is enabled.'
| |
| * "Current": A "Current" volume is a volume where data will be written upon arrival (Primary Current) or HSM Policy Application (Secondary Current)
| |
| | |
| == Volume Management with Zimbra NG HSM ==
| |
| === Creating a new volume ===
| |
| ==== From the Zimbra Next Generation Modules Administration Zimlet====
| |
| From the Zimbra NG HSM tab of the Zimbra Next Generation Modules Administration Zimlet:
| |
| | |
| * Click the appropriate "Add" in the "Volumes Managment" section according to the type of volume you want to create.
| |
| * Enter the new volume's name.
| |
| * Enter a path for the new volume.
| |
| * Check the "Enable Compression" button if you wish to activate data compression on the new volume.
| |
| * Select the Compression Thereshold.
| |
| * Press "OK" to create the new volume. Should the operation fail, a Notification containing any related errors will be generated
| |
| | |
| ==== From the Zimbra Next Generation Modules CLI====
| |
| To create a new volume through the Zimbra Next Generation Modules CLI, the "doCreateVolume" command is available:
| |
| <pre><nowiki>
| |
| Syntax:
| |
| zxsuite powerstore doCreateVolume {primary|secondary|index} {volume_name} {volume_path} [attr1 value1 [attr2 value2...]]
| |
| | |
| PARAMETER LIST
| |
| | |
| NAME TYPE EXPECTED VALUES DEFAULT
| |
| volume_type(M) Multiple choice primary|secondary|index
| |
| volume_name(M) String
| |
| volume_path(M) Path
| |
| volume_compressed(O) Boolean true|false false
| |
| compression_threshold_bytes(O) Long 4096
| |
| | |
| (M) == mandatory parameter, (O) == optional parameter
| |
| | |
| Usage example:
| |
| | |
| zxsuite powerstore docreatevolume secondary "volume B" "/opt/zimbra/store_B/" volume_compressed true compression_threshold_bytes 4096
| |
| Creates a new secondary volume named "volume B" in /opt/zimbra/store_B/, with compression and compression threshold to 4096 bytes
| |
| </nowiki></pre>
| |
| | |
| === Editing a volume ===
| |
| ==== From the Zimbra Next Generation Modules Administration Zimlet====
| |
| Simply select an existing volume and press the appropriate "Edit" button.
| |
| | |
| ==== From the Zimbra Next Generation Modules CLI====
| |
| To edit a volume through the Zimbra Next Generation Modules CLI, the "doUpdateVolume" command is available:
| |
| <pre><nowiki>
| |
| Syntax:
| |
| zxsuite powerstore doCreateVolume {primary|secondary|index} {volume_name} {volume_path} [attr1 value1 [attr2 value2...]]
| |
| | |
| PARAMETER LIST
| |
| | |
| NAME TYPE EXPECTED VALUES DEFAULT
| |
| volume_type(M) Multiple choice primary|secondary|index
| |
| volume_name(M) String
| |
| volume_path(M) Path
| |
| volume_compressed(O) Boolean true|false false
| |
| compression_threshold_bytes(O) Long 4096
| |
| | |
| (M) == mandatory parameter, (O) == optional parameter
| |
| | |
| Usage example:
| |
| | |
| zxsuite powerstore docreatevolume secondary "volume B" "/opt/zimbra/store_B/" volume_compressed true compression_threshold_bytes 4096
| |
| Creates a new secondary volume named "volume B" in /opt/zimbra/store_B/, with compression and compression threshold to 4096 bytes
| |
| zimbra@test:~$ zxsuite powerstore doUpdateVolume
| |
| | |
| command doUpdateVolume requires more parameters
| |
| | |
| Syntax:
| |
| zxsuite powerstore doUpdateVolume {volume_id} [attr1 value1 [attr2 value2...]]
| |
| | |
| PARAMETER LIST
| |
| | |
| NAME TYPE EXPECTED VALUES DEFAULT
| |
| volume_id(M) Integer
| |
| volume_type(O) String inherited_value
| |
| volume_name(O) String inherited_value
| |
| volume_path(O) Path inherited_value
| |
| current_volume(O) Boolean true|false false
| |
| volume_compressed(O) Boolean true|false false
| |
| compression_threshold(O) Long 4096
| |
| | |
| (M) == mandatory parameter, (O) == optional parameter
| |
| | |
| Usage example:
| |
| | |
| zxsuite powerstore doupdatevolume 3 secondary "example volume" "/opt/zimbra/store_example/"
| |
| Sets name of volume 3 to "example volume", make it secondary, and set its path to /opt/zimbra/store_example/
| |
| | |
| </nowiki></pre>
| |
| | |
| === Deleting a volume ===
| |
| ==== From the Zimbra Next Generation Modules Administration Zimlet====
| |
| Select and existing volume and press the appropriate "Delete" button. Remember that only '''empty''' volumes can be deleted.
| |
| | |
| ==== From the Zimbra Next Generation Modules CLI====
| |
| To delete a volume through the Zimbra Next Generation Modules CLI, the "doDeleteVolume" command is available:
| |
| <pre><nowiki>
| |
| Syntax:
| |
| zxsuite powerstore doUpdateVolume {volume_id} [attr1 value1 [attr2 value2...]]
| |
| | |
| PARAMETER LIST
| |
| | |
| NAME TYPE EXPECTED VALUES DEFAULT
| |
| volume_id(M) Integer
| |
| volume_type(O) String inherited_value
| |
| volume_name(O) String inherited_value
| |
| volume_path(O) Path inherited_value
| |
| current_volume(O) Boolean true|false false
| |
| volume_compressed(O) Boolean true|false false
| |
| compression_threshold(O) Long 4096
| |
| | |
| (M) == mandatory parameter, (O) == optional parameter
| |
| | |
| Usage example:
| |
| | |
| zxsuite powerstore doupdatevolume 3 secondary "example volume" "/opt/zimbra/store_example/"
| |
| Sets name of volume 3 to "example volume", make it secondary, and set its path to /opt/zimbra/store_example/
| |
| zimbra@simone:~$ zxsuite powerstore doDeleteVolume
| |
| | |
| command doDeleteVolume requires more parameters
| |
| | |
| Syntax:
| |
| zxsuite powerstore doDeleteVolume {volume_id}
| |
| | |
| PARAMETER LIST
| |
| | |
| NAME TYPE
| |
| volume_id(M) Integer
| |
| | |
| (M) == mandatory parameter, (O) == optional parameter
| |
| | |
| Usage example:
| |
| | |
| zxsuite powerstore dodeletevolume 3
| |
| Deletes volume with id 3
| |
| </nowiki></pre>
| |
| </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 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}}
| |