Zextras Powerstore and Third Party Storage solutions/pt

From ZeXtras Suite Wiki

Jump to: navigation, search
Língua: 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 Atenção!

Em construção

Informação geral sobre Zextras Powerstore e soluções de storage de terceiros

A partir da versão 2.10.0, Zextras Powerstore permite criar volumes Zimbra de qualquer tipo en múltiplas soluções de storage de terceiros.

"Antes da versão 2.10.0, unicamente os storages Amazon S3 e EMC eram oficialmente suportados e só podiam alojar volumes secundários".

Soluções de storage de terceiros com suporte oficial

As plataformas de armazenamento suportadas oficialmente por Zextras Powerstore são:

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

Além desses, é admitido um tipo de storage adicional, 'FileBlob' , o qual é o storage local predefinido por Zimbra.

Caché local

Essa função requer que seja utilizado un diretório local como caché de objetos, que deve contar com permissões de leitura e escrita por parte do usuário "zimbra".

Esse diretório deve criarse manualmente e seu path deve ingressarse na seção "Powerstore" do zimlet de administração de Zextras no Console de administração Zimbra antes de configurar qualquer volume remoto.

Warning.png Atenção!

Se for manipulado manualmente o diretório do caché, é possível que os elementos não possam ser recuperados, o que significa que os usuários receberão um erro "Não existe esse BLOB" quando tentarem acessar a qualquer elemento armazenado num volume alojado em store de terceiros.

Gerenciamento de volume via CLI

A partir da versão 2.10.0, o argumento storeType é obrigatório ao criar e atualizar um volume, está sempre na primeira posição e aceita qualquer valor correspondente às plataformas oficialmente compatíveis com o S3 mencionado acima. Os argumentos que seguem no comando agora dependem do storeType selecionado.

FileBlob (Local)

Comandos para gerenciamento de volumes FileBlob:

Adicionar novo volume

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

Apagar um volume

 zxsuite hsm doDeleteVolume name

Estabelecer um volume como current

 zxsuite hsm doUpdateVolume FileBlob name current_volume true

zxsuite hsm doCreateVolume FileBlob

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

LISTA DE PARÁMETROS

NOME                            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) == parámetro obrigatório, (O) == parámetro opcional

EXemplo de uso:

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

zxsuite hsm doUpdateVolume FileBlob

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

LISTA DE PARÁMETROS

NOME                            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) == parámetro obrigatório, (O) == parámetro opcional

S3 (Amazon e qualquer solução compatível não explícitamente suportada)

Comandos para administração de volumen S3:

Adicionar novo volume

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

Apagar um volume

 zxsuite hsm doDeleteVolume name

Estabelecer um volume como current

 zxsuite hsm doUpdateVolume S3 name current_volume true

zxsuite hsm doCreateVolume S3

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

LISTA DE PARÁMETROS

NOME                            TIPO                VALORES ESPERADOS
volume_name(M)                  String              Nome do Store Zimbra
volume_type(M)                  Multiple choice     primário|secundário
bucket_name(O)                  String              Bucket Amazon AWS
access_key(O)                   String              Nome de usuário do serviço
secret(O)                       String              Senha do serviço
server_prefix(O)                String              Prefixo para o id do server usado nas objects keys
bucket_configuration_id(O)      String              UUID para credenciais de serviço S3 já existentes
                                                    (zxsuite config global get attribute s3BucketConfigurations)
region(O)                       String              Região Amazon AWS
url(O)                          String              URL de serviço compatível com S3 API (ex: s3api.service.com)
prefix(O)                       String              Prefixo adicionado ao blobs keys
use_infrequent_access(O)        Boolean             true|false
infrequent_access_threshold(O)  String

(M) == parámetro obrigatório, (O) == parámetro opcional

Exemplo 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 compatível com S3:
    zxsuite hsm doCreateVolume S3 volumeName primary bucket_name bucket access_key accessKey secret secretKey url http://host/service

Uso da configuração do bucket existente:
    zxsuite hsm doCreateVolume S3 volumeName primary bucket_configuration_id 316813fb-d3ef-4775-b5c8-f7d236fc629c

zxsuite hsm doUpdateVolume S3

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

LISTA DE PARÁMETROS

NOME                            TIPO                VALORES ESPERADOS           DEFAULT
current_volume_name(M)          String
volume_name(O)                  String
volume_type(O)                  String              primário|secundário
server_prefix(O)                String              Prefixo para o ID do servidor usado em todas as chaves de objetos
bucket_configuration_id(O)      String              UUID para credenciais de serviço já existentes
                                                    (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) == parámetro obrigatório, (O) == parámetro opcional

Scality (storage de objetos compatível com S3)

Comandos para administração de volume Scality:

Adicionar novo volume

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

Apagar volume

 zxsuite hsm doDeleteVolume name

Estabelecer volume como current

 zxsuite hsm doUpdateVolume ScalityS3 name current_volume true

zxsuite hsm doCreateVolume ScalityS3

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

LISTA DE PARÁMETROS

NOME                            TIPO                VALORES ESPERADOS
volume_name(M)                  String
volume_type(M)                  Multiple choice     primário|secundário
bucket_name(O)                  String              Nome del Bucket
url(O)                          String              URL de serviço compatível com API S3(ex: s3api.service.com)
access_key(O)                   String              Nome de usuário do serviço
secret(O)                       String              Senha do serviço
server_prefix(O)                String              Prefixo para o ID do servidor usado em todas as chaves de objetos
bucket_configuration_id(O)      String              UUID para credenciais de serviço já existentes
                                                    (zxsuite config global get attribute s3BucketConfigurations)
prefix(O)                       String              Prefixo agregado às chaves dos blobs

(M) == parámetro obrigatório, (O) == parámetro opcional

Exemplo 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

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

LISTA DE PARÁMETROS

NOMBRE                          TIPO                VALORES ESPERADOS           DEFAULT
current_volume_name(M)          String
volume_name(O)                  String
volume_type(O)                  String              primary|secondary
server_prefix(O)                String              Prefixo para o ID do servidor usado em todas as chaves de objetos
bucket_configuration_id(O)      String              UUID para credenciais de serviço S3 já existentes
                                                    (zxsuite config global get attribute s3BucketConfigurations)
current_volume(O)               Boolean             true|false                  false

(M) == parámetro obrigatório, (O) == parámetro opcional

EMC (storage de objetos compatible con S3)

Comandos para administração de volúmenes Dell/EMC:

Adicionar um novo volume

 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

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

LISTA DE PARÁMETROS

NOME                            TIPO                VALORES ESPERADOS
volume_name(M)                  String
volume_type(M)                  Multiple choice     primário|secundário
bucket_name(O)                  String              Nome do Bucket
url(O)                          String              URL de serviço compatível com API S3 (ex: s3api.service.com)
access_key(O)                   String              Nome de usuário do serviço
secret(O)                       String              Senha do serviço
server_prefix(O)                String              Prefixo para o ID do servidor usado em todas as chaves de objetos
bucket_configuration_id(O)      String              UUID para credenciais de serviço S3 já existentes
                                                    (zxsuite config global get attribute s3BucketConfigurations)
prefix(O)                       String              Prefixo adicionado às chaves de blobs

(M) == parámetro obrigatório, (O) == parámetro opcional

Exemplo 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

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

LISTA DE PARÁMETROS

NOME                            TIPO                VALORES ESPERADOS           DEFAULT
current_volume_name(M)          String
volume_name(O)                  String
volume_type(O)                  String              primário|secundário
server_prefix(O)                String              Prefixo para o ID do servidor usado em todas as chaves de objetos
bucket_configuration_id(O)      String              UUID para credenciais de serviço S3 já existentes
                                                    (zxsuite config global get attribute s3BucketConfigurations)
current_volume(O)               Boolean             true|false                  false

(M) == parámetro obrigatório, (O) == parámetro opcional

OpenIO

Comandos para administração de volumes OpenIO:

Adicionar novo volume

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

Apagar volume

 zxsuite hsm doDeleteVolume name

Estabelecer um volume como "current".

 zxsuite hsm doUpdateVolume OpenIO name current_volume true

zxsuite hsm doCreateVolume OpenIO

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

LISTA DE PARÁMETROS

NOME                            TIPO                VALORES ESPERADOS
volume_name(M)                  String
volume_type(M)                  Multiple choice     primário|secundário
url(M)                          String
account(M)                      String
namespace(M)                    String
proxy_port(O)                   Integer
account_port(O)                 Integer

(M) == parámetro obrigatório, (O) == parámetro opcional

Exemplo de uso:

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

zxsuite hsmo doUpdateVolume OpenIO


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

LISTA DE PARÁMETROS

NOME                            TIPO                VALORES ESPERADOS           DEFAULT
current_volume_name(M)          String
volume_name(O)                  String
volume_type(O)                  String              primário|secundário
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) == parámetro obrigatório, (O) == parámetro opcional

Swift

Comandos para administração de volumes Swift:

Adicionar novo volume

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

Apagar volume

 zxsuite hsm doDeleteVolume name

Estabelecer volume como "current".

 zxsuite hsm doUpdateVolume Swift name current_volume true

zxsuite hsm doCreateVolume Swift

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

LISTA DE PARÁMETROS

NOME                        TIPO        VALORES ESPERADOS           DEFAULT
volume_name(O)              String
volume_type(O)              String      primário|secundário
url(O)                      String
username(O)                 String
password(O)                 String
maxDeleteObjectsCount(O)    Integer     Número de objetos em uma única solicitação de exclusão em massa
                                                                    500

(M) == parámetro obrigatório, (O) == parámetro opcional

Exemplo de uso:

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

zxsuite hsm doUpdateVolume Swift

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

LISTA DE PARÁMETROS

NOME                        TIPO        VALORES ESPERADOS           DEFAULT
current_volume_name(M)      String
volume_name(O)              String
volume_type(O)              String      primário|secundário
url(O)                      String
username(O)                 String
password(O)                 String
maxDeleteObjectsCount(O)    Integer     Número de objetos em uma única solicitação de exclusão em massa
                                                                    500
current_volume(O)           Boolean     true|false                  false

(M) == parámetro obrigatório, (O) == parámetro opcional

Cloudian (storage de objetos compatível com S3)

CLI para administração de volumes Cloudian:

Adicionar novo volume

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

Apagar volume

 zxsuite hsm doDeleteVolume name

Estabelecer volume como "current"

 zxsuite hsm doUpdateVolume Cloudian name current_volume true

zxsuite hsm doCreateVolume Cloudian

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

LISTA DE PARÁMETROS

NOME                            TIPO        VALORES ESPERADOS
volume_name(M)                  String
volume_type(M)                  Multiple choice     primário|secundário
bucket_name(O)                  String              Nome do Bucket
url(O)                          String              URL de serviço compatível com API S3 (ex: s3api.service.com)
access_key(O)                   String              Nome de usuário do serviço
secret(O)                       String              Senha do serviço
server_prefix(O)                String              Prefixo para o ID do servidor usado em todas as chaves de objetos
bucket_configuration_id(O)      String              UUID para credenciais de serviço S3 já existentes
                                                    (zxsuite config global get attribute s3BucketConfigurations)
prefix(O)                       String              Prefixo adicionado às chaves de blobs

(M) == parámetro obrigatório, (O) == parámetro opcional

Exemplo 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

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

LISTA DE PARÁMETROS

NOME                            TIPO                VALORES ESPERADOS           DEFAUL
current_volume_name(M)          String
volume_name(O)                  String
volume_type(O)                  String              primário|secundário
server_prefix(O)                String              Prefixo para o ID do servidor usado em todas as chaves de objetos
bucket_configuration_id(O)      String              UUID para credenciais de serviço S3 já existentes
                                                    (zxsuite config global get attribute s3BucketConfigurations)
current_volume(O)               Boolean             true|false                  false

(M) == parámetro obrigatório, (O) == parámetro opcional

Borrado de un volumen

zxsuite hsm doDeleteVolume


Sintaxe:
    zxsuite hsm doDeleteVolume {volume_name}

LISTA DE PARÁMETROS

NOME                            TIPO
volume_name(M)                  String

(M) == parámetro obrigatório, (O) == parámetro opcional

Exemplo de uso:

zxsuite hsm dodeletevolume hsm
Apaga o volume chamado hsm

Mover todos os dados desde um volume para outro

zxsuite hsm doVolumeToVolumeMove


Sintaxe:
    zxsuite hsm doVolumeToVolumeMove {source_volume_name} {destination_volume_name}

LISTA DE PARÁMETROS

NOME                            TIPO
source_volume_name(M)           String
destination_volume_name(M)      String

(M) == parámetro obrigatório, (O) == parámetro opcional

Exemplo de uso:

zxsuite hsm doVolumeToVolumeMove origenVolume destinoVolume
Desloca todo o conteúdo de origenVolume para destinoVolume
Personal tools