addvdiskcopy

Use o comando addvdiskcopy para incluir uma cópia em um volume existente, que altera um volume não espelhado para um volume espelhado. Em um sistema com uma topologia hyperswap, use o comando addvolumecopy para converter um volume existente em um volume HyperSwap incluindo uma cópia em um segundo site.

Nota: O primeiro diagrama de sintaxe mostra a inclusão de um volume de modo sequencial ou dividido. O segundo diagrama de sintaxe mostra a adição de um volume de modo de imagem.

6Sintaxe


>>- addvdiskcopy -- -mdiskgrp --+-mdisk_group_id_list---+------->
                                '-mdisk_group_name_list-'   

>--+------------------------------------------+----------------->
   '- -mirrorwritepriority --+- latency ----+-'   
                             '- redundancy -'     

>--+-----------------------+------------------------------------>
   '- -vtype --+-seq-----+-'   
               '-striped-'     

>--+-------------------------------+---------------------------->
   '- -mdisk --+-mdisk_id_list---+-'   
               '-mdisk_name_list-'     

>--+--------------------------------------------------------------------------------------------------+-->
   '- -rsize --+-disk_size-------------+--+--------------------------------------+--+---------------+-'   
               +-disk_size_percentage%-+  '- -warning -+-disk_size-------------+-'  '- -autoexpand -'     
               '-auto------------------'               '-disk_size_percentage%-'                          

>--+------------------------------------------------------------------------------------+-->
   '- -rsize (cont.) --+----------------------+--+---------------+--+-----------------+-'   
                       |              .-32--. |  '- -compressed -'  '- -deduplicated -'     
                       '- -grainsize -+-64--+-'                                             
                                      +-128-+                                               
                                      '-256-'                                               

>--+---------------+--+-----------------------+----------------->
   '- -createsync -'  '- -syncrate --syncrate-'   

>--+-----------------+--+------------------------+-------------->
   |          .-mb-. |  '- -easytier --+- on --+-'   
   '- -unit --+-b--+-'                 '- off -'     
              +-kb-+                                 
              +-gb-+                                 
              +-tb-+                                 
              '-pb-'                                 

>--+-vdisk_name-+----------------------------------------------><
   '-vdisk_id---'


>>- addvdiskcopy ----------------------------------------------->

>--+------------------------------------------+----------------->
   '- -mirrorwritepriority --+- latency ----+-'   
                             '- redundancy -'     

>-- -mdiskgrp --+-mdisk_group_id_list---+----------------------->
                '-mdisk_group_name_list-'   

>-- -vtype ----image---- -mdisk --+-mdisk_id_list---+----------->
                                  '-mdisk_name_list-'   

>--+--------------------------------------------------------------------------------------------------+-->
   '- -rsize --+-disk_size-------------+--+--------------------------------------+--+---------------+-'   
               +-disk_size_percentage%-+  '- -warning -+-disk_size-------------+-'  '- -autoexpand -'     
               '-auto------------------'               '-disk_size_percentage%-'                          

>--+---------------------------------------------------------------------------------------------------+-->
   '- -rsize (cont.) --+----------------------+--+---------------+--+-----------+--+-----------------+-'   
                       |              .-32--. |  '- -compressed -'  '- -import -'  '- -deduplicated -'     
                       '- -grainsize -+-64--+-'                                                            
                                      +-128-+                                                              
                                      '-256-'                                                              

>--+---------------+--+-----------------------+----------------->
   '- -createsync -'  '- -syncrate --syncrate-'   

>--+-----------------+-- -tier --+- tier0_flash -----+---------->
   |          .-mb-. |           +- tier1_flash -----+   
   '- -unit --+-b--+-'           +- tier_enterprise -+   
              +-kb-+             '- tier_nearline ---'   
              +-gb-+                                     
              +-tb-+                                     
              '-pb-'                                     

>--+------------------------+--+---------------+---------------->
   '- -easytier --+- on --+-'  '- -autodelete -'   
                  '- off -'                        

>--+-----------------+--+-vdisk_name-+-------------------------><
   '- -deduplicated -'  '-vdisk_id---'

Parâmetros

-mdiskgrp mdisk_group_id_list | mdisk_group_name_list

(Obrigatório) Especifica os conjuntos de armazenamento a serem usados para criar cópias para o volume. Você deve especificar um grupo para cada cópia sendo incluída.

Nota: Se o grupo MDisk é de um conjunto-filho, -vtype deve ser striped.

-mirrorwritepriority latency | redundancy

(Opcional) Especifica como configurar a prioridade do algoritmo de gravação de espelho.

Escolher latency significa que uma cópia que está lenta para responder a uma entrada/saída (E/S) se tornará dessincronizada e a E/S de gravação será concluída se a outra cópia gravar os dados com sucesso.
Escolher redundancy significa que uma cópia que está lenta para responder a uma E/S de gravação sincronizará a conclusão da E/S de gravação com a conclusão da E/S mais lenta, para manter a sincronização.

-vtype seq | striped | image

(Opcional) Especifica o tipo de virtualização da cópia: sequencial, dividido ou imagem. O tipo pode ser diferente dos tipos de virtualização para outras cópias no volume. O tipo de virtualização padrão é dividido. Se você especificar a opção -rsize auto ou a opção -import, também deverá especificar a opção -vtype image.

Nota: Não é possível criar uma cópia de modo de imagem ou sequencial a partir de um conjunto-filho ou de conjuntos de redução de dados.

-mdisk mdisk_id_list | mdisk_name_list

(Opcional) Especifica um ou mais discos gerenciados (MDisks). Para cópias nos modos de imagem e sequencial, você deve especificar um único MDisk que tenha extensões livres suficientes. Para as cópias de modo de imagem, o MDisk deve estar em modo não gerenciado. Para cópias no modo sequencial, o MDisk deve estar no modo gerenciado.

-syncrate syncrate

(Opcional) Especifica a taxa de sincronização da cópia. Um valor de zero impede a sincronização. Para obter os valores suportados para -syncrate e suas taxas correspondentes, consulte Tabela 2.

Se não especificado, o valor atual ficará inalterado.

-createsync

(Opcional) Suprime a sincronização da nova cópia de volume com a cópia primária. O uso desse parâmetro pode causar distorção de dados se a cópia primária falhar e deixar uma cópia secundária não sincronizada fornecer dados. O uso desse parâmetro pode causar perda de estabilidade de leitura em áreas não gravadas se a cópia primária falhar, dados forem lidos da cópia primária e dados diferentes forem lidos da cópia secundária.

Nota: Não é possível especificar -createsync para um volume que é de formatação rápida.

-rsize disk_size | disk_size_percentage% | auto

(Opcional) Faz a cópia thin-provisioned e especifica o tamanho real da cópia. Especifique o valor disk_size | disk_size_percentage usando um número inteiro ou um número inteiro seguido imediatamente pelo caractere de percentual (%). As unidades padrão para disk_size são megabytes (MB). Para especificar unidades diferentes, use o parâmetro -unit. A opção auto cria uma cópia de volume que usa todo o tamanho do MDisk; se você especificar a opção -rsize auto, deve-se também especificar a opção -vtype image.

-deduplicated

(Opcional) Inclui um volume deduplicado. Se você especificar -deduplicated, também deverá especificar -rsize, porque ele se aplica apenas a volumes thin-provisioned ou compactados.

Nota: A deduplicação de dados funciona apenas com conjuntos de armazenamentos de redução de dados. Será possível apenas criar volumes deduplicados e cópias de volume em um grupo de E/S se volumes não compactados ou cópias de volume existirem em conjuntos de armazenamentos regulares.

-compressed

(Opcional) Inclui exatamente uma cópia em um volume existente que já possui (apenas) uma cópia de um volume e ativa a compactação. Requer que o parâmetro -rsize também seja especificado.

Lembre-se:

Não é possível especificar esse parâmetro com o parâmetro -grainsize.
Ao especificar esse parâmetro com o parâmetro -import, será necessário especificar -rsize auto.

-warning disk_size | disk_size_percentage%

(Opcional) Requer que o parâmetro -rsize também seja especificado. Gera um aviso quando a capacidade do disco usada na cópia thin-provisioned excede pela primeira vez o limite especificado. É possível especificar um número inteiro disk_size, padronizado em megabytes (MB), a menos que o parâmetro -unit seja especificado; ou é possível especificar um disk_size%, que é uma porcentagem do tamanho do volume. Se -autoexpand estiver ativado, o valor padrão de -warning será 80% da capacidade do volume. Se -autoexpand não for ativado, o valor padrão para o aviso será 80% da capacidade real. Para desativar os avisos, especifique 0.

-autoexpand

(Opcional) Requer que o parâmetro -rsize também seja especificado. Especifica que as cópias thin-provisioned que expandem automaticamente suas capacidades reais alocando novas extensões de seu conjunto de armazenamentos. Se o parâmetro -autoexpand for especificado, o parâmetro -rsize especificará uma capacidade reservada pela cópia. Ela protege a cópia para não ficar off-line quando seu conjunto de armazenamentos fica sem espaço, permitindo que ele consuma este espaço reservado primeiro.

-grainsize 32 | 64 | 128 | 256

(Opcional) Requer que o parâmetro -rsize também seja especificado. Configura o tamanho de granularidade (KB) para uma cópia de volume thin-provisioned. O valor do tamanho da granularidade deve ser 32, 64, 128, ou 256 KB. O padrão é 256 KB.

-unit b | kb | mb | gb | tb | pb

(Opcional) Especifica as unidades de dados para os parâmetros -rsize e -warning.

-import

(Opcional) Importa um disco de modo de imagem que contém um volume thin-provisioned no sistema. Requer que os parâmetros -rsize e -vtype image também sejam especificados.

-tier tier0_flash | tier1_flash | tier_enterprise | tier_nearline

(Opcional) Especifica a camada do MDisk quando uma cópia de modo de imagem é incluída.

tier0_flash: Especifica uma unidade de disco rígido tier0_flash ou um disco gerenciado (MDisk) externo para o volume recém-descoberto ou externo.
tier1_flash: Especifica uma unidade de disco rígido tier1_flash (ou unidade flash) ou um MDisk externo para o volume recém-descoberto ou externo.
tier_enterprise: Especifica uma unidade de disco rígido tier_enterprise ou um MDisk externo para o volume recém-descoberto ou externo.
tier_nearline: Especifica uma unidade de disco rígido tier_nearline ou um MDisk externo para o volume recém-descoberto ou externo.

-easytier on | off

(Opcional) Determina se a função do IBM® Easy Tier pode mover extensões para este volume. Se uma cópia de volume for dividida e não estiver sendo migrada, consulte as configurações nesta tabela.

Tabela 1. Configurações do Easy Tier para o Conjunto de Armazenamento
Configuração do Easy Tier para o conjunto de armazenamento	Número de camadas no conjunto de armazenamento	Configuração do Easy Tier para a cópia do volume	Status do Easy Tier para a cópia do volume
Apagado	Um	Apagado	inativo (consulte a observação 1)
Off	Um	Aceso	inativo (consulte a observação 1)
Off	Dois	Apagado	inativo (consulte a observação 1)
Apagado	Dois	Aceso	inativo (consulte a observação 1)
Medida	Um	Apagado	medido (consulte a observação 2)
Medida	Um	Aceso	medido (consulte a observação 2)
Medida	Dois	Apagado	medido (consulte a observação 2)
Medida	Dois	Aceso	medido (consulte a observação 2)
Automático	Um	Off	medido (consulte a observação 2)
Automático	Um	Aceso	medido (consulte a observação 2)
Automático	Dois	Off	Balanceado (consulte a nota 3)
Automático	Dois	Aceso	ativo (consulte a observação 4)
Aceso	Um	Off	medido (consulte a observação 2)
Aceso	Um	Aceso	Balanceado (consulte a nota 3)
Aceso	Dois	Off	medido (consulte a observação 2)
Aceso	Dois	Aceso	ativo (consulte a observação 4)
Notas: Quando o status da cópia do volume for `inativo`, nenhuma função do IBM Easy Tier estará ativada para essa cópia do volume. Quando o status da cópia do volume for `medido`, a função do IBM Easy Tier coletará estatísticas de uso para o volume, mas o posicionamento automático de dados não estará ativo. Quando o status da cópia de volume for `balanceado`, a função do IBM Easy Tier ativará o balanceamento do conjunto baseado em desempenho para essa cópia de volume. Quando o status da cópia do volume for `ativo`, a função do IBM Easy Tier irá operar no modo de posicionamento automático de dados para esse volume.

Se a cópia de volume estiver no modo de imagem ou sequencial ou estiver sendo migrada, o status do IBM Easy Tier da cópia de volume será measured em vez de active.

A configuração padrão do Easy Tier para um conjunto de armazenamento é auto e a configuração padrão do Easy Tier para uma cópia de volume é on. Se a configuração estiver ativada, isso significa que as funções do Easy Tier, exceto o balanceamento de desempenho de conjunto, estão desativadas para conjuntos de armazenamentos com uma única camada e que o modo de posicionamento automático de dados está ativado para todas as cópias de volume dividido em um conjunto de armazenamentos com duas ou mais camadas.

-autodelete

(Opcional) Especifica que a cópia primária é excluída após a cópia secundária ser sincronizada.

jvdisk_name | vdisk_id

(Obrigatório) Especifica o volume ao qual incluir a cópia de volume, seja por ID ou por nome.

Descrição

O comando addvdiskcopy inclui uma cópia em um volume existente, que altera um volume não espelhado para um volume espelhado. Use o parâmetro mkdiskgrp para especificar os conjuntos de armazenamentos que fornecem armazenamento para a cópia; o comando lsmdiskgrp lista os conjuntos de armazenamentos disponíveis e a quantidade de armazenamento disponível em cada grupo.

O comando addvdiskcopy pode ser especificado com um volume do sistema de arquivos, mas deve ser usado com o mesmo conjunto de armazenamentos desse volume.

Lembre-se: Somente cópias compactadas têm permissão para serem incluídas nos volumes do sistema de arquivos.

O comando addvdiskcopy inclui uma cópia de volume diferente, como uma cópia criada de uma conversão descompactada para compactada ou de uma conversão compactada para descompactada.

Nota: Um volume não pode ter cópias de volume em diferentes conjuntos de armazenamentos se a captura instantânea de nuvem estiver ativada no volume.

Uma cópia de volume thin-provisioned ou compactado em um conjunto de armazenamentos de redução de dados não deve ser um volume de modo sequencial ou de imagem. Em alguns tipos de nós, é possível criar uma cópia do volume compactado em um conjunto de armazenamentos de redução de dados para um grupo de E/S. Uma cópia de volume compactado em um conjunto de redução de dados somente pode ser criada em um grupo de E/S com os tipos de nó V5030, V7000 ou SVC. É possível criar cópias de volume thin-provisioned em qualquer tipo de nó. Use o parâmetro -autoexpand para criar cópias de volume thin-provisioned ou compactado a partir de um conjunto de armazenamentos de redução de dados. Os volumes também podem ter cópias de volume totalmente alocado em conjuntos de armazenamentos de redução de dados.

Não é possível criar uma cópia de volume que seja um volume thin-provisioned ou compactado em um conjunto de armazenamentos de redução de dados e o modo de armazenamento em cache do volume seja none ou readonly. Deve-se especificar chvdisk para mudar o modo de armazenamento em cache do volume para readwrite.

Não é possível especificar -warning para uma cópia de volume thin-provisioned ou compactado em um conjunto de armazenamentos de redução de dados.

Para cópias de volume thin-provisioned e compactado em conjuntos de armazenamentos de redução de dados, o modo Easy Tier para o volume é obtido do conjunto de armazenamentos de redução de dados. O modo Easy Tier não pode ser configurado nestes tipos de volume.

Não é possível especificar -grainsize para cópias de volume thin-provisioned e compactado em conjuntos de armazenamentos de redução de dados. Este tipo de cópia de volume é criado com um tamanho de 8 KB.

As cópias de volume thin-provisioned ou compactado em conjuntos de redução de dados não podem ser criadas se o conjunto de armazenamentos de redução de dados estiver off-line e precisar de recuperação. Se a recuperação ainda estiver em andamento, deve-se aguardar até que a recuperação seja concluída e que o conjunto esteja no estado online.

Uma chave de criptografia não pode ser usada ao incluir um MDisk de modo de imagem. Para usar criptografia (quando o MDisk tiver uma chave de criptografia), o MDisk deve ser de criptografia automática.

Lembre-se: Não será possível incluir uma cópia de volume se o volume a ser copiado estiver sendo formatado.

Os tipos de virtualização são definidos da seguinte forma:

sequencial (seq): Esta política requer o parâmetro -mdisk com um único disco gerenciado como seu argumento. Esse MDisk deve estar no modo gerenciado.
Ele cria o volume usando extensões a partir do disco gerenciado fornecido (supondo que existam extensões livres no disco gerenciado).
dividido: A política striped é a política padrão. Se o parâmetro -vtype não for especificado, essa política será usada em seu formato padrão. Ou seja, todos os discos gerenciados no conjunto de armazenamentos são usados para criar o volume. A divisão está em um nível de extensão; uma extensão de cada disco gerenciado no grupo é usada. Por exemplo, um conjunto de armazenamento com 10 discos gerenciados usa uma extensão de cada disco gerenciado, em seguida, usa a 11ª extensão do primeiro disco gerenciado, e assim por diante.
Se o parâmetro -mdisk também for especificado, será possível fornecer uma lista de discos gerenciados a serem usados como conjunto de divisão. A lista pode incluir dois ou mais discos gerenciados do mesmo conjunto de armazenamentos. O mesmo algoritmo circular é usado na configuração em faixas. Entretanto, um único disco gerenciado pode ser especificado mais de uma vez na lista. Por exemplo, se -m 0:1:2:1 for inserido, as extensões serão dos seguintes discos gerenciados : 0, 1, 2, 1, 0, 1, 2 e assim por diante. Todos os MDisks que são especificados no parâmetro -mdisk devem estar no modo gerenciado.
imagem: Esta política permite que sejam criados volumes de modo de imagem quando um disco gerenciado já possuir dados nele, talvez a partir de um subsistema pré-virtualizado. Quando um volume de modo de imagem é criado, ele corresponde diretamente ao disco gerenciado (anteriormente não gerenciado) do qual ele foi criado, portanto, o endereço de bloco lógico (LBA) de volume x equivale ao LBA do disco gerenciado i. É possível usar esse comando para colocar um disco não virtualizado sob o controle do sistema. Após ele estar sob o controle do sistema, será possível migrar o volume a partir de um único disco gerenciado. Quando ele for migrado, o volume não será mais um volume de modo de imagem.
É possível incluir volumes de modo de imagem em um conjunto de armazenamentos já preenchido com outros tipos de volumes, como dividido ou sequencial.

Nota: Uma cópia do modo de imagem deve ter pelo menos o mesmo tamanho do volume para o qual ela está sendo incluída, mas qualquer capacidade além do tamanho do volume não deverá estar acessível.

O comando retorna o ID da cópia de volume recém-criada.

Crie a primeira cópia de volume compactada para um grupo de E/S para ativar a compactação. Não é possível criar ou mover uma cópia de volume compactada para um grupo de E/S que contiver (pelo menos) um nó que não suporta volumes compactados. Você deve usar outro grupo de E/S, mas observe que isso não afeta a movimentação para o grupo de E/S de recuperação.

Importante:

Se o volume (ou cópia de volume) for um destino de um mapeamento de FlashCopy com um volume de origem em um relacionamento active-active, o novo conjunto de armazenamentos deverá estar no mesmo site que o volume de origem.
Se esse comando for usado para um volume principal, um volume auxiliar ou um volume de mudança de um relacionamento active-active, a nova cópia deverá ser criada em um conjunto de armazenamentos do mesmo site que a cópia de volume existente.
Ao incluir uma cópia do modo de imagem, as informações do site para o MDisk que está sendo incluído devem ser bem definidas e corresponder às informações do site para quaisquer outros MDisks no conjunto de armazenamentos.

A taxa em que o volume copia a ressincronização após a perda de sincronização pode ser especificada usando o parâmetro -syncrate. Esta tabela fornece o relacionamento do valor syncrate para os dados copiados por segundo.

Nota: Essas configurações também afetam a taxa inicial de formatação.

Tabela 2. Relacionamento entre o valor `syncrate` e os dados copiados por segundo
Valor de atributo `syncrate` especificado pelo usuário	Dados copiados/s
1 a 10	128 KB
11 a 20	256 KB
21 a 30	512 KB
31 a 40	1 MB
41 a 50	2 MB
51 a 60	4 MB
61 a 70	8 MB
71 a 80	16 MB
81 a 90	32 MB
91 a 100	64 MB

Cenário 1

Se o grupo de E/S contiver:

Pelo menos um nó de 8 GB.
Pelo menos um volume thin-provisioning ou compactado em um conjunto de redução de dados.
Um tamanho de bitmap de FlashCopy para esse grupo de E/S configurado além de 1,5 GB.

O comando falhará devido a recursos insuficientes disponíveis.

Cenário 2

Quando um volume thin-provisioning ou compactado é criado em um conjunto de redução de dados, o conjunto deve ter capacidade suficiente para criar mais volumes que controlam as operações de remoção de mapeamento SCSI do host. Se essa capacidade não estiver disponível, o comando falhará.

Cenário 3

Os volumes não podem ser criados em um conjunto de redução de dados se os volumes thin-provisioning ou compactados off-line existem em um conjunto de redução de dados, seja devido ao thin provisioning (falta de espaço ou distorção) ou porque um componente sob thin provisioning está mantendo um volume no conjunto off-line.

Um exemplo de chamada

addvdiskcopy -mdiskgrp 0 -easytier off vdisk8

A saída resultante:

Cópia [1] do Vdisk [8] criada com sucesso

Um exemplo de chamada para especificar conjunto de armazenamento

addvdiskcopy -mdiskgrp 0 -vtype image -mdisk 13 -tier tier0_flash -easytier off vdisk9

A saída resultante:

Cópia [1] do Vdisk [9] criada com sucesso

Um exemplo de chamada para configurar uma prioridade de algoritmo de gravação de espelho

addvdiskcopy -mdiskgrp 0 -mirrorwritepriority latency vdisk9

A saída resultante:

Cópia [1] do Vdisk [9] criada com sucesso

Um exemplo de chamada para incluir uma cópia do volume compactado

addvdiskcopy -mdiskgrp 1 -rsize 10% -compressed vdisk2

A saída resultante:

Cópia [1] de Vdisk [2] criada com sucesso

Um exemplo de chamada para incluir uma cópia do volume compactado

addvdiskcopy -mdiskgrp 0 -vtype image -mdisk 13 -tier tier_nearline vdisk9

A saída resultante:

Cópia [1] do Vdisk [9] criada com sucesso

Um exemplo de chamada para incluir uma cópia de volume deduplicado

addvdiskcopy -mdiskgrp datareductionpool10 -rsize 0 -autoexpand -deduplicated deduplicatedvolume6

A saída resultante:

Vdisk [6] copy [1] successfully created