Previous Topic: ca_devmgr - Comandos da biblioteca de fitasNext Topic: ca_devmgr - Comandos da nuvem


ca_devmgr - Comandos do FSD

Os seguintes comandos do FSD (File System Device - Dispositivo do sistema de arquivos) podem ser usados apenas para um FSD.

ca_devmgr [-cahost <host>] 
-format [<adapter #> <scsi ID> <lun> <tape name>] [<mm/dd/yyyy> <serial no.>]
-erase [<adapter #> <scsi ID> <lun>] [q|qz|qw|l]
-online [<adapter #> <scsi ID> <lun>]
-offline [<adapter #> <scsi ID> <lun>]
-purge <adapter #> <scsi ID> <lun> -sessions <session no.> [<session no.>] 
ou
-purge <adapter #> <scsi ID> <lun> -sessions <session range>
 <session range> pode ser <start session no.>-<end session no.> ou "all", que indica todas as sessões
-query <adapter #> <scsi ID> <lun> <-all|-copied|-uncopied|-purgable|-snaplocked|-failed> -sessions <session no.>[<-session no.>]
ou
-query <adapter #> <scsi ID> <lun> <-all|-copied|-uncopied|-purgable|-snaplocked|-failed> -sessions all
-regenerate [<adapter #> <scsi ID> <lun> <tape name>] [<tape ID> <mm/dd/yy[yy]>]
-createfsd <FSD Description> <FSD Name> <FSD Path>[<Domain Name> <User> <senha>]
-removefsd <FSD Path>
-setstaging <Group Name> [[-mstreams <Max Stream>] [-mthreshold <Max Threshold/Purge to Threshold <"xx/xx%"|"xx/xx">>] [-snaplock <Enable Snaplock <0|1>>] [-pausemig <Pause Migration <0|1>>] [-chunksize <Chunk Size>]]
-cleanstaging <Group Name>
-getstaging <Group Name>
-queryfsd <FSD Path> [-group]
-creatededupefsd <FSD Description><FSD Name><Data Path><Index Path>[<Domain Name> <User><Password>][-GrpName <Group Name>]
-removededupefsd <Group Name>
-configdedupefsd <Group Name> [-FSDDsp<FSD Description>][-FSDName <FSD Name>] [-DataPath <Data Path>] [-IndexPath <IndexPath>]
-setdedupegrpproperties <Group Name> [[-mstreams <Max Stream>][-mthreshold <Max Threshold <"xx%"|"xx">>[-pausemig <Pause Migration <0|1>>][-optimization <Allow Optimization <0|1>]]
-getdedupegrpproperties <Group Name>
-startreclaim
-format [<adapter #> <scsi ID> <lun> <nome da fita>] [<mm/dd/yyyy> <serial no.>]

Formata a fita em uma unidade.

Quando usado com a opção -force, formata a mídia especificada, independentemente de ela estar em um conjunto de salvamento ou em um conjunto temporário.

O número do adaptador, a ID SCSI, o LUN e o novo nome da fita são obrigatórios. A data e o número de série são opcionais.

-erase [<adapter #> <scsi ID> <lun>] [q|qz|qw|l]

Apaga a fita em uma unidade.

Quando usado com a opção -force, apaga todos os dados da mídia especificada, independentemente de ela estar em um conjunto de salvamento ou em um conjunto temporário.

As opções de número do adaptador, ID SCSI e LUN são obrigatórias.

As opções são:

Importante: O apagamento completo remove toda a mídia do início ao final da fita, e pode demorar muito para ser concluído.

-online [<adapter #> <scsi ID> <lun>]

Define o dispositivo especificado (FSD ou dispositivo de fita) para um status online. Quando definido como online, o dispositivo pode ser compartilhado entre vários servidores.

É necessário verificar se não há mais de um servidor definido para gravar dados de backup no mesmo dispositivo ao mesmo tempo. Se vários servidores acessarem o dispositivo ao mesmo tempo, poderá haver falha no backup e perda de dados.

Exemplo: se tiver um FSD/dispositivo de fita com número de adaptador, ID SCSI e LUN iguais a 0, 0 e 1, respectivamente, e desejar defini-lo para um status online, digite o seguinte comando:

ca_devmgr -online 0 0 1
-offline [<adapter #> <scsi ID> <lun>]

Define o dispositivo especificado (FSD ou dispositivo de fita) para um status offline. Quando definido como offline, nenhuma outra tarefa de backup pode ser enviada ao dispositivo.

Se uma tarefa de backup para o dispositivo já estiver em andamento, não será permitido alterar o status do dispositivo para offline até que a tarefa seja concluída. Para um FSD, isso impede que vários servidores acessem o dispositivo ao mesmo tempo acidentalmente. Se uma tarefa de backup tentar acessar o dispositivo definido como offline, ocorrerá a falha da tarefa.

Exemplo: se tiver um FSD/dispositivo de fita com número de adaptador, ID SCSI e LUN iguais a 0, 0 e 1, respectivamente, e desejar defini-lo para um status offline, digite o seguinte comando:

ca_devmgr -offline 0 0 1
-purge <adapter #> <scsi ID> <lun> -sessions <session no.> [<session no.>]
-purge <adapter #> <scsi ID> <lun> -sessions <session range>

Elimina a sessão ou o grupo de sessões especificado. Use esse comando para excluir os dados do FSD.

É possível especificar a eliminação de uma única sessão ou de várias sessões por um destes três métodos: por número de sessões (única ou grupo), por intervalo ou por todas.

-sessions <session no.> [<session no.>]
-sessions <session range>

Observação: <session range> pode ser <start session no.>-<end session no.> ou "all", que indica todas as sessões

Especifica o número da sessão (ou o grupo de números de sessões), o intervalo de números de sessões ou todos os números de sessões a serem eliminados.

  • Para especificar uma única sessão a ser eliminada, é necessário usar o seguinte formato de sintaxe:

    -sessions 1

  • Para especificar um grupo de sessões a serem eliminadas, é necessário fornecer uma lista de números de sessões separados por espaços usando o seguinte formato de sintaxe:

    -sessions 1 2 5 7 8

  • Para especificar um intervalo de sessões a serem eliminadas, é necessário fornecer o número da sessão inicial e o número da sessão final conectados por um traço usando o seguinte formato de sintaxe:

    -sessions 3-5

  • Para especificar todas as sessões a serem eliminadas, é necessário usar o seguinte formato de sintaxe:

    -sessions todas

-query <adapter #> <scsi ID> <lun> <-all|-copied|-uncopied|-purgable|-snaplocked|-failed> -sessions

Consulta as sessões especificadas. Use esse comando para consultar o servidor sobre as sessões de usuário ativas no momento. É possível solicitar informações de todas as sessões ativas ou apenas das sessões que correspondam ao tipo especificado.

O comando -query fornece uma descrição das seguintes informações:

O número do adaptador, a ID SCSI e o LUN são obrigatórios.

-copied

Exibe a lista de todas as sessões copiadas.

-uncopied

Exibe a lista de todas as sessões que não foram copiadas.

-purgable

Exibe a lista de todas as sessões que podem ser removidas.

-snaplocked

Exibe uma lista de todas as sessões com a proteção SnapLock ativada e o período de retenção de cada sessão.

-failed

Exibe a lista de todas as sessões com falha.

-sessions <list of space separated sessions | all>

Especifica o número da sessão, o grupo de números de sessões ou todos os números de sessões a serem consultados.

  • Para especificar uma única sessão a ser consultada, é necessário usar o seguinte formato de sintaxe:

    -sessions 1

  • Para especificar um grupo de sessões a serem consultadas, é necessário fornecer uma lista de números de sessões separados por espaços usando o seguinte formato de sintaxe:

    -sessions 1 2 3

  • Para especificar que todas as sessões sejam consultadas, é necessário usar o seguinte formato de sintaxe:

    -sessions todas

-regenerate [<adapter #> <scsi ID> <lun> <tape name>] [<tape ID> <mm/dd/yy[yy]>]

Usado com os dispositivos de sistema de arquivo, se o cabeçalho da fita for apagado acidentalmente. Permite gerar novamente ou reconstruir um cabeçalho de fita com um nome de fita especificado (<nome de fita>) para um dispositivo de sistema de arquivo. Após gerar um novo cabeçalho de fita, é possível mesclar todas as sessões do dispositivo do sistema de arquivos no banco de dados do Arcserve Backup, o que ativa o recurso de restaurações do tipo apontar e selecionar.

Se o nome da fita original (<tapename>) e sua ID de fita (<tapeID)>) forem conhecidos, é possível reutilizá-los, de modo que os registros da sessão no banco de dados do Arcserve Backup possam ser reconectados ao volume sem que seja necessário mesclar os registros novamente. (É possível verificar o registro da fita original no banco de dados do Arcserve Backup para obter o nome e a ID da fita.)

É possível usar o parâmetro <mm/dd/aaaa> para especificar uma data de validade diferente da fita, em relação à data padrão.

-createfsd

Especifica a criação de um FSD dinamicamente durante o tempo de execução, sem interromper o mecanismo de fitas. O Arcserve Backup verificará se o dispositivo a ser criado já está no sistema da lista de dispositivos e, se não estiver, o adiciona à lista de dispositivos.

Observação: para ca_devmgr, o comando -createfsd falhará se a GUI Configurar grupos do Arcserve Backup estiver aberta.

Descrição do FSD

Especifica a descrição do FSD que está sendo criado.

Nome do FSD

Especifica o nome da identidade do FSD que está sendo criado.

Caminho do FSD

Especifica o caminho físico do FSD que está sendo criado.

Nome do domínio

Especifica o domínio para acesso ao FSD remoto que está sendo criado.

Usuário

Especifica o nome do usuário para acessar o FSD remoto que está sendo criado.

Senha

Especifica a senha do usuário para acessar o FSD remoto que está sendo criado.

-removefsd <FSD Path>

Especifica a remoção de um FSD dinamicamente do Arcserve Backup durante o tempo de execução, sem interromper o mecanismo de fitas.

-setstaging <Group Name>

Especifica a configuração do grupo de FSD como um grupo de armazenamento temporário.

-mstreams <Max Stream>

Especifica a quantidade máxima de fluxos de dados simultâneos a serem enviados ao FSD em um grupo de armazenamento temporário.

As opções disponíveis são 1 ou 2 fluxos, e o valor padrão é 1 fluxo.

-mthreshold <Max Threshold/Purge to Threshold <"xx/xx%"|"xx/xx">>

Especifica o limite da capacidade máxima e o limite de eliminação do FSD.

Quando a quantidade de espaço usado no FSD for maior do que o limite máximo especificado, os dados (das sessões migradas mais antigas) começarão a ser eliminados do FSD. O limite de eliminação é o limite mínimo e permite especificar a quantidade de espaço usado em um FSD quando o Arcserve Backup para de eliminar.

Os limites máximo e de eliminação podem ser representados como um valor absoluto (em MB) ou uma porcentagem da capacidade do volume.

Por padrão, o valor de limite máximo é 80%.

Por padrão, o valor de limite de eliminação é 60%.

O exemplo a seguir define o valor de limite máximo em 80% e o valor do limite de eliminação em 60%:

ca_devmgr -setstaging group0 -mthreshold “80/60%”

Se você especificar apenas um valor de limite, ele representará automaticamente o limite máximo, e o limite de eliminação será desativado. (Não é possível definir o limite de eliminação como independente do limite máximo.)

O exemplo a seguir define o valor de limite máximo em 80% e desativa o valor do limite de eliminação:

ca_devmgr -setstaging group0 -mthreshold “80%”
Observações: 
  • O limite máximo especificado sempre deverá ser maior do que o limite de eliminação.
  • Se o valor de limite for definido como uma porcentagem, o limite máximo deverá ser inferior a 100% e o limite de eliminação deverá ser superior a 0%. (Se o valor de eliminação for 0%, a eliminação automática será desativada).
  • Se o valor de limite for definido como um valor absoluto, o limite máximo deverá ser superior a 1 MB. O valor de eliminação deverá ser superior a 0. (Se o valor for 0, a eliminação automática será desativada.)
-snaplock <Enable Snaplock <0|1>>

Especifica a ativação ou desativação da proteção de SnapLock. Ao fazer o backup de dados com a proteção de SnapLock, não é possível eliminar nem sobrescrever os dados do backup, até vencer o prazo de retenção especificado. Isso garante que os dados no FSD não possam ser excluídos por nenhum usuário.

0 = Desativado

1 = Ativado

Por padrão, o SnapLock está desativado.

-pausemig <Pause Migration <0|1>>

Especifica a pausa da migração de dados do FSD para a mídia de destino final. Essa opção permite continuar o backup para o FSD, mas pausa a migração do FSD para a mídia de destino final se essa mídia estiver programada para manutenção ou apresentar problemas de hardware.

0 = Desativado

1 = Ativado

Por padrão, a opção de pausa na migração de dados está desativada.

-chunksize <Chunk Size>

Especifica a quantidade máxima de dados (em KB) a serem gravados no dispositivo de armazenamento temporário por operação de gravação.

Por padrão, o tamanho do fragmento de armazenamento temporário é de 512 KB.

-cleanstaging <Group Name>

Especifica a limpeza (ou remoção) dos atributos do grupo de armazenamento temporário do FSD do servidor local/remoto.

-getstaging <Group Name>

Especifica a obtenção dos atributos do grupo de armazenamento temporário do servidor local/remoto.

-queryfsd <FSD Path> [-group]

Especifica a consulta do número do adaptador do FSD, da ID SCSI e do LUN, por padrão, ou a consulta do grupo de FSD pela opção "-group". Essa opção é usada, principalmente, para o script de automação.

-creatededupefsd <FSD Description><FSD Name><Data Path><Index Path> [<Domain Name> <User><Password>] [-GrpName <Group Name>]

Direciona o Arcserve Backup a criar um novo dispositivo de redução de redundância. É necessário fornecer a descrição do FSD, o nome do FSD, o caminho de dados e o caminho de índice. O nome do grupo é opcional; é possível especificar um nome de grupo válido, se desejado. Caso contrário, o novo dispositivo será adicionado a um grupo de redução de redundância padrão.

Descrição do FSD

Especifica uma descrição para o dispositivo de redução de redundância que está sendo criado.

Nome do FSD

Especifica o nome da identidade do dispositivo de redução de redundância que está sendo criado.

Caminho de dados

Especifica o caminho físico em que os dados de redução de redundância são armazenados.

Caminho de índice

Especifica o caminho físico em que o arquivo de índice e referência é armazenado. Esse caminho deve estar em um volume diferente do caminho de dados. Se por engano você fornecer o mesmo caminho que o caminho de dados, não será solicitado a especificar outro caminho.

Nome do domínio

Especifica o domínio para acesso ao dispositivo de redução de redundância remoto que está sendo criado.

Usuário

Especifica o nome do usuário para acessar o dispositivo de redução de redundância remoto que está sendo criado.

Senha

Especifica a senha do usuário para acessar o dispositivo de redução de redundância remoto que está sendo criado.

-GrpName

Cria um novo grupo de dispositivos de redução de redundância.

Nome do grupo

Especifica o nome do novo grupo de dispositivos de redução de redundância criado por -GrpName. Isso é opcional. Se você não especificar um nome do grupo, o Arcserve Backup atribuirá o dispositivo de redução de redundância ao novo grupo padrão.

-removededupefsd <Group Name>

Direciona o Arcserve Backup a remover o dispositivo de redução de redundância por nome do grupo.

<Group Name>

Especifica o nome do grupo que contém o dispositivo de redução de redundância a ser removido.

-configdedupefsd <Group Name> [-FSDDsp<FSD Description>][-FSDName <FSD Name>] [-DataPath <Data Path>] [-IndexPath <IndexPath>]

Direciona o Arcserve Backup a modificar um dispositivo de redução de redundância existente. É possível especificar novos valores para descrição do FSD, nome do FSD, caminho de dados e caminho do índice.

-FSDDsp <FSD Description>

Especifica uma nova descrição para o dispositivo de redução de redundância identificado no nome do grupo.

-FSDname <FSD Name>

Especifica um novo nome da identidade para o dispositivo de redução de redundância identificado no nome do grupo.

-DataPath <Data Path>

Especifica um novo caminho de dados que o dispositivo de redução de redundância, identificado no nome do grupo, usa para armazenar dados de redução de redundância.

-IndexPath <Index Path>

Especifica um novo caminho de índice que o dispositivo de redução de redundância, identificado no nome do grupo, usa para armazenar os arquivos de índice e referência associados ao processo de redução de redundância.

Observação: o caminho de dados e o caminho de índice podem ser alterados somente quando a mídia do dispositivo de redução de redundância for uma mídia vazia

-setdedupegrpproperties <Group Name> [[-mstreams <Max Stream>][-mthreshold <Max Threshold <"xx%"|"xx">>[-pausemig <Pause Migration <0|1>>][-optimization <Allow Optimization <0|1>>]]

Instrui o Arcserve Backup a definir propriedades do grupo de redução de redundância para o dispositivo identificado no <Group Name>.

-mstreams <Max Stream>

Especifica o número máximo de fluxos de dados simultâneos enviados ao dispositivo de redução de redundância.

O valor padrão é 1.

-mthreshold <Max Threshold <"xx%"|"xx">>

Especifica o limite da capacidade máxima do dispositivo de redução de redundância. O valor limite pode ser especificado como uma porcentagem da capacidade do dispositivo ou como um valor absoluto (em MB apenas).

O valor padrão é 80%.

-pausemig <Pause Migration <0|1>>

Especifica a pausa da migração de dados do dispositivo de redução de redundância para a mídia de destino final.

0 = Desativado

1 = Ativado

Por padrão, a opção de pausa na migração de dados está desativada.

-optimization <Allow Optimization <0|1>>

Ativa ou desativa a otimização nos processos de redução de redundância. Quando redundância dos dados é aplicada com a otimização ativada, somente os dados do cabeçalho do arquivo são examinados em relação a alterações, em vez do arquivo inteiro.

0 = Desativado

1 = Ativado

Por padrão, a otimização está desativada.

-getdedupegrpproperties <Group Name>

Direciona o Arcserve Backup a obter as propriedades definidas para o grupo especificado no <Group Name>.

-startreclaim

Eliminar as sessões que residem em dispositivos de redução de redundância de dados que satisfaçam as diretivas de eliminação. Esse argumento permite recuperar o espaço em disco no dispositivo imediatamente.

Mais informações:

ca_devmgr - Comando Gerenciador de dispositivos

ca_devmgr - Examples