Zextras Powerstore and Third Party Storage solutions/es

From ZeXtras Suite Wiki

Jump to: navigation, search
Idioma: English  • español • português
ZxPowerStore logo box.png
Available since version: 1.3.0
Latest Version: 2.12.2
Released on: January 2nd, 2019
Compatibility List
Admin Guide
FAQ
Troubleshooting
ZspPowerstore logo box.png
Warning.png ¡Atención!

En construcción

Información general sobre Zextras Powerstore y soluciones de almacenamiento de terceros

A partir de la versión 2.10.0, Zextras Powerstore permite crear volúmenes de Zimbra de cualquier tipo en múltiples soluciones de almacenamiento de terceros.

"Antes de la versión 2.10.0, solo los almacenamientos de Amazon S3 y EMC eran oficialmente soportados y solo podían alojar volúmenes secundarios".

Soluciones de almacenamiento de terceros con soporte oficial

Las plataformas de almacenamiento soportadas oficialmente por Zextras Powerstore son:

  • Amazon S3
  • EMC
  • OpenIO
  • Swift
  • Scality S3
  • Cloudian

Además de aquellos, se admite un tipo de almacenamiento adicional, 'FileBlob' , que es el almacenamiento local predeterminado de Zimbra.

Caché local

Esta función requiere que se utilice un directorio local para ser usado como caché de objetos, que debe contar con permisos de lectura y escritura por el usuario "zimbra".

Dicho directorio debe crearse manualmente y su ruta debe ingresarse en la sección "Powerstore" del zimlet de administración de Zextras en la Consola de administración de Zimbra antes de configurar cualquier volumen remoto.

Warning.png ¡Atención!

Si se manipula manualmente el directorio del caché, es posible que los elementos no se puedan recuperar, lo que significa que los usuarios recibirán un error de "No existe ese BLOB" cuando intenten acceder a cualquier elemento almacenado en un volumen alojado en un almacenamiento de terceros.

Administración de volumen via CLI

A partir de la versión 2.10.0, el argumento storeType es obligatorio al crear y actualizar un volumen, siempre está en la primera posición y acepta cualquier valor correspondiente a las plataformas oficialmente compatibles con S3 mencionadas anteriormente. Los argumentos que siguen en el comando ahora dependen del storeType seleccionado.

FileBlob (Local)

Comandos para la gestión de volúmenes FileBlob:

Agregar un nuevo volumen

 zxsuite hsm doCreateVolume FileBlob name secondary /path/to/store

Borrar un volumen

 zxsuite hsm doDeleteVolume name

Establecer un volumen como curren

 zxsuite hsm doUpdateVolume FileBlob name current_volume true


zxsuite hsm doCreateVolume FileBlob

Sintaxis:
    zxsuite hsm doCreateVolume FileBlob {volume_name} {primary|secondary|index} {volume_path} [attr1 value1 [attr2 value2...]]

LISTA DE PARAMETROS

NOMBRE                          TIPO                VALORES ESPERADOS           DEFAULT
volume_name(M)                  String
volume_type(M)                  Multiple choice     primary|secondary|index
volume_path(M)                  Path
volume_compressed(O)            Boolean             true|false                  false
compression_threshold_bytes(O)  Long                                            4096

(M) == parametro obligatorio, (O) == parametro opcional

Ejemplo de uso:

zxsuite hsm doCreateVolume FileBlob volumeName secondary /path/to/store volume_compressed true compression_threshold_bytes 4096

zxsuite hsm doUpdateVolume FileBlob

Sintaxis:
    zxsuite hsm doUpdateVolume FileBlob {current_volume_name} [attr1 value1 [attr2 value2...]]

LISTA DE PARAMETROS

NOMBRE                          TIPO                VALORES ESPERADOS           DEFAULT
current_volume_name(M)          String
volume_type(O)                  String              primary|secondary|index
volume_name(O)                  String
volume_path(O)                  Path
current_volume(O)               Boolean             true|false                  false
volume_compressed(O)            String
compression_threshold(O)        String

(M) == parametro obligatorio, (O) == parametro opcional

S3 (Amazon y cualquier solución compatible no explícitamente soportada)

Comandos para administración de volumen S3:

Agregar un nuevo volumen

 zxsuite hsm doCreateVolume S3 name secondary bucket_name bucket access_key accessKey secret secretString region EU_WEST_1

Borrar un volume

 zxsuite hsm doDeleteVolume name

Establecer un volumen como current

 zxsuite hsm doUpdateVolume S3 name current_volume true

zxsuite hsm doCreateVolume S3

Sintaxis:
    zxsuite hsm doCreateVolume S3 {Name of the zimbra store} {primary|secondary} [attr1 value1 [attr2 value2...]]

LISTA DE PARAMETROS

NOMBRE                          TIPO                VALORES ESPERADOS
volume_name(M)                  String              Name of the zimbra store
volume_type(M)                  Multiple choice     primary|secondary
bucket_name(O)                  String              Amazon AWS bucket
access_key(O)                   String              Service username
secret(O)                       String              Service password
server_prefix(O)                String              Prefix to the server id used in all objects keys
bucket_configuration_id(O)      String              UUID for already existing S3 service credentials
                                                    (zxsuite config global get attribute s3BucketConfigurations)
region(O)                       String              Amazon AWS Region
url(O)                          String              S3 API compatible service url (ex: s3api.service.com)
prefix(O)                       String              Prefix added to blobs keys
use_infrequent_access(O)        Boolean             true|false
infrequent_access_threshold(O)  String

(M) == parametro obligatorio, (O) == parametro opcional

Ejemplo de uso:

Bucket S3 AWS:
    zxsuite hsm doCreateVolume S3 volumeName primary bucket_name bucket access_key accessKey secret secretKey prefix objectKeysPrefix region EU_WEST_1 user_infrequent_access TRUE infrequent_access_threshold 4096

Storage de objetos compatible con S3:
    zxsuite hsm doCreateVolume S3 volumeName primary bucket_name bucket access_key accessKey secret secretKey url http://host/service

Uso de la configuración del bucket existente:
    zxsuite hsm doCreateVolume S3 volumeName primary bucket_configuration_id 316813fb-d3ef-4775-b5c8-f7d236fc629c

zxsuite hsm doUpdateVolume S3

Sintaxis:
    zxsuite hsm doUpdateVolume S3 {current_volume_name} [attr1 value1 [attr2 value2...]]

LISTA DE PARAMETROS

NOMBRE                          TIPO                VALORES ESPERADOS           DEFAULT
current_volume_name(M)          String
volume_name(O)                  String
volume_type(O)                  String              primary|secondary
server_prefix(O)                String              Prefix to the server id used in all objects keys
bucket_configuration_id(O)      String              UUID for already existing service credentials
                                                    (zxsuite config global get attribute s3BucketConfigurations)
use_infrequent_access(O)        Boolean             true|false
infrequent_access_threshold(O)  String
current_volume(O)               Boolean             true|false                  false

(M) == parametro obligatorio, (O) == parametro opcional

Scality (storage de objetos compatible con S3)

Comandos para administración de volumen Scality:

Agregar un nuevo volumen

 zxsuite hsm doCreateVolume ScalityS3 name secondary bucket_name mybucket access_key accessKey1 secret verySecretKey1 url http://{IP_ADDRESS}:{PORT}

Borrar un volumen

 zxsuite hsm doDeleteVolume name

Establecer un volumen como current

 zxsuite hsm doUpdateVolume ScalityS3 name current_volume true

zxsuite hsm doCreateVolume ScalityS3

Sintaxis:
    zxsuite hsm doCreateVolume ScalityS3 {volume_name} {primary|secondary} [attr1 value1 [attr2 value2...]]

LISTA DE PARAMETROS

NOMBRE                          TIPO                VALORES ESPERADOS
volume_name(M)                  String
volume_type(M)                  Multiple choice     primary|secondary
bucket_name(O)                  String              Bucket name
url(O)                          String              S3 API compatible service url (ex: s3api.service.com)
access_key(O)                   String              Service username
secret(O)                       String              Service password
server_prefix(O)                String              Prefix to the server id used in all objects keys
bucket_configuration_id(O)      String              UUID for already existing service credentials
                                                    (zxsuite config global get attribute s3BucketConfigurations)
prefix(O)                       String              Prefix added to blobs keys

(M) == parametro obligatorio, (O) == parametro opcional

Ejemplo de uso:

zxsuite hsm doCreateVolume ScalityS3 volumeName primary bucket_name bucket url http://host/service access_key accessKey secret secretKet
zxsuite hsm doCreateVolume ScalityS3 volumeName primary bucket_configuration_id uuid

zxsuite hsm doUpdateVolume ScalityS3

Sintaxis:
    zxsuite hsm doUpdateVolume ScalityS3 {current_volume_name} [attr1 value1 [attr2 value2...]]

LISTA DE PARAMETROS

NOMBRE                          TIPO                VALORES ESPERADOS           DEFAULT
current_volume_name(M)          String
volume_name(O)                  String
volume_type(O)                  String              primary|secondary
server_prefix(O)                String              Prefix to the server id used in all objects keys
bucket_configuration_id(O)      String              UUID for already existing S3 service credentials
                                                    (zxsuite config global get attribute s3BucketConfigurations)
current_volume(O)               Boolean             true|false                  false

(M) == parametro obligatorio, (O) == parametro opcional

EMC (storage de objetos compatible con S3)

Comandos para administración de volúmenes Dell/EMC:

Agregar un nuevo volumen

 zxsuite hsm docreatevolume EMC name secondary bucket_name bucket access_key ACCESSKEY secret SECRET url https://url.of.storage

Borrar un volumen

 zxsuite hsm doDeleteVolume name

Establecer un volumen como "current"

 zxsuite hsm doUpdateVolume EMC name current_volume true

zxsuite hsm doCreateVolume EMC

Sintaxis:
    zxsuite hsm doCreateVolume EMC {volume_name} {primary|secondary} [attr1 value1 [attr2 value2...]]

LISTA DE PARAMETROS

NOMBRE                          TIPO                VALORES ESPERADOS
volume_name(M)                  String
volume_type(M)                  Multiple choice     primary|secondary
bucket_name(O)                  String              Bucket name
url(O)                          String              S3 API compatible service url (ex: s3api.service.com)
access_key(O)                   String              Service username
secret(O)                       String              Service password
server_prefix(O)                String              Prefix to the server id used in all objects keys
bucket_configuration_id(O)      String              UUID for already existing service credentials
                                                    (zxsuite config global get attribute s3BucketConfigurations)
prefix(O)                       String              Prefix added to blobs keys

(M) == parametro obligatorio, (O) == parametro opcional

Ejemplo de uso:

zxsuite hsm doCreateVolume EMC volumeName primary bucket_name bucket url http://host/service access_key accessKey secret secretKet
zxsuite hsm doCreateVolume EMC volumeName primary bucket_configuration_id uuid

zxsuite hsm doUpdateVolume EMC

Sintaxis:
    zxsuite hsm doUpdateVolume EMC {current_volume_name} [attr1 value1 [attr2 value2...]]

LISTA DE PARAMETROS

NOMBRE                          TIPO                VALORES ESPERADOS           DEFAULT
current_volume_name(M)          String
volume_name(O)                  String
volume_type(O)                  String              primary|secondary
server_prefix(O)                String              Prefix to the server id used in all objects keys
bucket_configuration_id(O)      String              UUID for already existing service credentials
                                                    (zxsuite config global get attribute s3BucketConfigurations)
current_volume(O)               Boolean             true|false                  false

(M) == parametro obligatorio, (O) == parametro opcional

OpenIO

Comandos para administración de volúmenes OpenIO:

Agregar un nuevo volumen

 zxsuite hsm doCreateVolume OpenIO name secondary http://{IP_ADDRESS} ZeXtras OPENIO

Borrar un volumen

 zxsuite hsm doDeleteVolume name

Establecer un volumen como "current".

 zxsuite hsm doUpdateVolume OpenIO name current_volume true

zxsuite hsm doCreateVolume OpenIO

Sintaxis:
    zxsuite hsm doCreateVolume OpenIO {volume_name} {primary|secondary} {url} {account} {namespace} [attr1 value1 [attr2 value2...]]

LISTA DE PARAMETROS

NOMBRE                          TIPO                VALORES ESPERADOS
volume_name(M)                  String
volume_type(M)                  Multiple choice     primary|secondary
url(M)                          String
account(M)                      String
namespace(M)                    String
proxy_port(O)                   Integer
account_port(O)                 Integer

(M) == parametro obligatorio, (O) == parametro opcional

Ejemplo de uso:

zxsuite hsm doCreateVolume OpenIO volumeName primary http://host/service accountName namespaceString proxy_port 6006 account_port 6009

zxsuite hsmo doUpdateVolume OpenIO


Sintaxis:
zxsuite hsm doUpdateVolume OpenIO {current_volume_name} [attr1 value1
[attr2 value2...]]

LISTA DE PARAMETROS

NOMBRE                          TIPO                VALORES ESPERADOS           DEFAULT
current_volume_name(M)          String
volume_name(O)                  String
volume_type(O)                  String              primary|secondary
url(O)                          String
account(O)                      String
namespace(O)                    String
proxy_port(O)                   Integer
account_port(O)                 Integer
current_volume(O)               Boolean             true|false                  false

(M) == parametro obligatorio, (O) == parametro opcional

Swift

Comandos para administración de volúemnes Swift:

Agregar un nuevo volumen

 zxsuite hsm doCreateVolume Swift name secondary http://{IP_ADDRESS}:8080/auth/v1.0/ user:username password maxDeleteObjectsCount 100

Borrar un volumen

 zxsuite hsm doDeleteVolume name

Establecer un volumen como "current".

 zxsuite hsm doUpdateVolume Swift name current_volume true

zxsuite hsm doCreateVolume Swift

Sintaxis:
    zxsuite hsm doCreateVolume Swift {volume_name} {primary|secondary} {url} {username} {password} [attr1 value1 [attr2 value2...]]

LISTA DE PARAMETROS

NOMBRE                      TIPO        VALORES ESPERADOS           DEFAULT
volume_name(O)              String
volume_type(O)              String      primary|secondary
url(O)                      String
username(O)                 String
password(O)                 String
maxDeleteObjectsCount(O)    Integer     Number of object in a single bulk delete request
                                                                    500

(M) == parametro obligatorio, (O) == parametro opcional

Ejemplo de uso:

zxsuite hsm doCreateVolume Swift volumeName primary http://host/service accountName password max_delete_objects_count 100

zxsuite hsm doUpdateVolume Swift

Sintaxis:
    zxsuite hsm doUpdateVolume Swift {current_volume_name} [attr1 value1 [attr2 value2...]]

LISTA DE PARAMETROS

NOMBRE                      TIPO        VALORES ESPERADOS           DEFAULT
current_volume_name(M)      String
volume_name(O)              String
volume_type(O)              String      primary|secondary
url(O)                      String
username(O)                 String
password(O)                 String
maxDeleteObjectsCount(O)    Integer     Number of object in a single bulk delete request
                                                                    500
current_volume(O)           Boolean     true|false                  false

(M) == parametro obligatorio, (O) == parametro opcional

Cloudian (storage de objetos compatible con S3)

CLI for Cloudian volume management:

Agregar un nuevo volumen

 zxsuite hsm doCreateVolume Cloudian name secondary bucket_name bucket access_key ACCESSKEY secret SECRET url https://url.of.storage

Borrar un volumen

 zxsuite hsm doDeleteVolume name

Establecer un volumen como "current"

 zxsuite hsm doUpdateVolume Cloudian name current_volume true

zxsuite hsm doCreateVolume Cloudian

Sintaxis:
    zxsuite hsm doCreateVolume Cloudian {volume_name} {primary|secondary} [attr1 value1 [attr2 value2...]]

LISTA DE PARAMETROS

NOMBRE                          TIPO        VALORES ESPERADOS
volume_name(M)                  String
volume_type(M)                  Multiple choice     primary|secondary
bucket_name(O)                  String              Bucket name
url(O)                          String              S3 API compatible service url (ex: s3api.service.com)
access_key(O)                   String              Service username
secret(O)                       String              Service password
server_prefix(O)                String              Prefix to the server id used in all objects keys
bucket_configuration_id(O)      String              UUID for already existing service credentials
                                                    (zxsuite config global get attribute s3BucketConfigurations)
prefix(O)                       String              Prefix added to blobs keys

(M) == parametro obligatorio, (O) == parametro opcional

Ejemplo de uso:

zxsuite hsm doCreateVolume Cloudian volumeName primary bucket_name bucket url http://host/service access_key accessKey secret secretKet
zxsuite hsm doCreateVolume Cloudian volumeName primary bucket_configuration_id uuid

zxsuite hsm doUpdateVolume Cloudian

Syntax:
    zxsuite hsm doUpdateVolume Cloudian {current_volume_name} [attr1 value1 [attr2 value2...]]

LISTA DE PARAMETROS

NOMBRE                          TIPO                VALORES ESPERADOS           DEFAUL
current_volume_name(M)          String
volume_name(O)                  String
volume_type(O)                  String              primary|secondary
server_prefix(O)                String              Prefix to the server id used in all objects keys
bucket_configuration_id(O)      String              UUID for already existing service credentials
                                                    (zxsuite config global get attribute s3BucketConfigurations)
current_volume(O)               Boolean             true|false                  false

(M) == parametro obligatorio, (O) == parametro opcional

Borrado de un volumen

zxsuite hsm doDeleteVolume


Sintaxis:
    zxsuite hsm doDeleteVolume {volume_name}

LISTA DE PARAMETROS

NOMBRE                          TIPO
volume_name(M)                  String

(M) == parametro obligatorio, (O) == parametro opcional

Ejemplo de uso:

zxsuite hsm dodeletevolume hsm
Borra el volumen llamado hsm

Mover todos los datos desde un volumen hacia otro

zxsuite hsm doVolumeToVolumeMove


Sintaxis:
    zxsuite hsm doVolumeToVolumeMove {source_volume_name} {destination_volume_name}

LISTA DE PARAMETROS

NOMBRE                          TIPO
source_volume_name(M)           String
destination_volume_name(M)      String

(M) == parametro obligatorio, (O) == parametro opcional

Ejemplo de uso

zxsuite hsm doVolumeToVolumeMove origenVolume destinoVolume
Mueve todo el contenido de origenVolume hacia destinoVolume
Personal tools