Sistemas Operacionais Windows

Comandos Dsmcutil: Opções Necessárias e Exemplos

Editar on-line

Informações de referência para os comandos dsmcutil e exemplos são fornecidos.

O comando INSTall instala e configura serviços do cliente de backup e archive.

INSTall Scheduler

Instala e configura o IBM Storage Protect Scheduler Service.

Estas são as opções necessárias do comando INSTall:

  • /name:nome_do_serviço
  • /password:senha
  • /clusternode:Sim | Não (necessário se rodando o Microsoft Cluster Server (MSCS) ou Veritas Cluster Server (VCS)).
  • /clustername:cluster_name (necessário, se estiver executando MSCS ou VCS).
Restrição: Não especifique um clusternome de mais de 64 caracteres. Se você especificar mais de 64 caracteres e estiver usando a Veritas Storage Foundation com Alta Disponibilidade ou uma configuração do Microsoft Cluster Server, você pode não ser capaz de instalar ou iniciar o serviço de planejador.

A opção /clientdir:client_dir também pode ser usada, o padrão é o diretório atual.

Os arquivos a seguir devem existir no diretório especificado por client_dir:

  • dsmcsvc.exe
  • dscenu.txt
  • dsm.opt
  • dsmntapi.dll
  • tsmutil1.dll
Nota: Se o serviço estiver sendo instalado em uma estação de trabalho remota, o caminho do diretório do cliente completo deverá ser relativo à estação de trabalho de destino. Nomes UNC não são permitidos para a conta do sistema local. Vários serviços podem ser instalados na mesma estação de trabalho.
Dica: Nos comandos que são fornecidos nos exemplos a seguir, é utilizado o local padrão do programa de instalação do cliente (c:\program files\tivoli\tsm\baclient). Se o cliente foi instalado em um local diferente, substitua o caminho padrão pelo caminho de instalação customizado. Se o caminho contém um espaço, enfecte o caminho em aspas duplas (por exemplo, "c:\program files\tivoli\tsm\baclient").
Tarefa
Instale um serviço de planejador que é nomeado TSM Central Scheduler Service na estação de trabalho local. Iniciar o serviço automaticamente na inicialização do sistema. Todos os arquivos necessários devem residir no diretório atual e o arquivo de opções do cliente deve apontar para o servidor IBM® Storage Protect, no qual o nó ALPHA1 é definido com a senha nodepw. O servidor é contactado para verificar se o nó e a senha especificados são válidos. Quando a senha é validada ela é gerada (criptografada) na loja de senhas:
Comando:
  dsmcutil install scheduler /name:"TSM Central Scheduler Service" 
  /node:ALPHA1 /password:nodepw /autostart:yes
Tarefa
Instale um serviço de planejador denominado TSM Central Scheduler Service no PDC da estação de trabalho remota. Iniciar o serviço automaticamente na inicialização do sistema. Os arquivos necessários do serviço do planejador e o arquivo de opções especificados devem residir na estação de trabalho remota no diretório c:\program files\tivoli\tsm\baclient. A senha é criptografada na loja de senhas. O servidor IBM Storage Protect não é contatado para validar a senha.
Comando:
  dsmcutil install scheduler /name:"TSM Central Scheduler Service" 
  /machine:PDC /clientdir:"c:\program files\tivoli\tsm\baclient" 
  /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt"
  /node:PDC /validate:no /autostart:yes /password:nodepassword
Tarefa
Instale um serviço de planejador denominado TSM Central Scheduler Service no PDC da estação de trabalho remota. Iniciar o serviço automaticamente na inicialização do sistema. Os arquivos necessários do serviço do planejador e o arquivo de opções especificados devem residir na estação de trabalho remota no diretório c:\program files\tivoli\tsm\baclient. A senha é criptografada na loja de senhas. O servidor do IBM Storage Protect, localizado no host TCP/IP e na porta especificados, é contatado para validar a senha.
Comando:
 dsmcutil install scheduler /name:"TSM Central Scheduler Service"
  /machine:PDC /clientdir:"c:\program files\tivoli\tsm\baclient" 
  /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt"
  /node:PDC /autostart:yes /password:nodepassword
  /commmethod:tcpip /commserver:alpha1.example.com
  /commport:1521
Tarefa
Instale o TSM Central Scheduler Service em um nó de um cluster MSCS (ou VCS). Para group-a da estação de trabalho node-1, assegure-se de que node-1 possua atualmente group-a e, em seguida, emita o comando a seguir.
Comando:
  dsmcutil install scheduler /name:"TSM Central Scheduler Service:
  group-a" /clientdir:"c:\program files\tivoli\tsm\baclient" 
  /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt"
  /node:mscs-cluster-group-a /password:n
  /validate:no /autostart:yes /startnow:yes
  /clusternode:yes /clustername:mscs-cluster

INSTall CAD

Instala e configura o Serviço de Client Acceptor. As opções exigidas são:

  • /name:nome_do_serviço
  • /node:nome_do_nó
  • /password:senha
  • /httpport:http_port

Outras opções válidas são:

  • /optfile:arquivo_de_opções
  • /webports:portas_da_web
Tarefa
Instale um Service Acetor Service chamado TSM CAD. O client acceptor usa um nó chamado teste para se conectar ao servidor IBM Storage Protect Use o arquivo de opções c:\program files\tivoli\tsm\baclient\dsm.opt para conexão ao servidor.
Comando:
  dsmcutil install cad /name:"TSM CAD" /node:test /password:test 
  /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt" /httpport:1582

INSTall Journal

Instala um serviço de motor de jornalão em todos os clientes Windows. É criado um banco de dados do diário que armazena informações usadas pelo cliente para determinar quais arquivos são elegíveis para backup antes que uma operação seja iniciada.

Se necessário, você pode utilizar a opção nojournal com o comando incremental para especificar que deseja executar um backup incremental completo tradicional.

O serviço de motor de jornaleira é denominado TSM Journal Service e usa o arquivo de configuração tsmjbbd.ini do diretório de instalação do cliente de backup-archive.

Nota: O Journal Service é suportado em um ambiente do Microsoft Cluster Server. Múltiplos serviços de diário podem ser instalados especificando nomes de canal exclusivos utilizando a definição de configuração de diário JournalPipe e as opções do cliente.

Não há opções válidas para este comando.

Tarefa
Instalar o serviço de motor de diário (TSM Journal Service).
Comando:
  dsmcutil install journal

INSTall REMOTEAgent

Instala e configura um Serviço Remote Client Agent. As opções exigidas são:

  • /name:nome_do_serviço
  • /node:nome_do_nó
  • /password:senha
  • /partnername:nome_do_serviço_do_parceiro

Outras opções válidas são:

  • /optfile:arquivo_de_opções
Tarefa
Instale um Serviço de Agente de Cliente Remoto chamado TSM AGENT. O agente do cliente remoto usa um nó chamado test para conectar ao servidor IBM Storage Protect . O arquivo de opções c:\program files\tivoli\tsm\baclient\dsm.opt é usado para se conectar. O serviço de aceitador do cliente parceiro é TSM CAD.
Comando:
  dsmcutil install remoteagent /name:"TSM AGENT" /node:test 
  /password:test /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt" 
  /partnername:"TSM CAD"
Nota: Tanto o Serviço de Agente de Cliente Remoto quanto o Client Acceptor Service devem ser instalados para executar o cliente web. O Serviço Client Acceptor deve ser instalado antes do Serviço Remote Client Agent. Use a opção /partnername: para especificar o nome do parceiro Client Acceptor Service.

REMove

Remove um Serviço de Cliente instalado. A opção necessária é /name:service_name.

Tarefa
Remover o serviço do planejador especificado da estação de trabalho local.
Comando:
  dsmcutil remove /name:"TSM Central Scheduler Service"
Tarefa
Remover o serviço de motor de jornaleira (TSM Journal Service) da estação de trabalho local.
Comando:
  dsmcutil remove /name:"TSM Journal Service"

UPDate

Atualiza os valores no registro do Serviço do Planejador. A opção necessária para esse comando é /name:service_name e os valores de registros a serem atualizados. Outras opções válidas são:

  • /clientdir:diretório_do_cliente
  • /optfile::options_file
  • /eventlogging:Sim | Não
  • /node:nome_do_nó
  • /autostart:Sim | Não
  • /clusternode:Yes | No (necessário, se estiver executando MSCS ou VCS).
  • /clustername:cluster_name (necessário, se estiver executando MSCS ou VCS).
Tarefa
Atualizar o diretório do cliente e o arquivo de opções para o planejador de serviço especificado. Todos os arquivos exigidos do serviço do cliente devem se localizar no diretório especificado.
Nota: As opções de comunicação especificadas com o comando dsmcutil aqui têm precedência sobre aquelas especificadas no arquivo de opções do cliente.
Comando:
  dsmcutil update /name:"TSM Central Scheduler Service" 
  /clientdir:"c:\program files\tivoli\tsm\baclient" 
  /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt"
Tarefa
Atualize o serviço de agendamento especificado para usar o protocolo TCP/IP para se conectar ao servidor IBM Storage Protect no nome de host especificado e na porta especificada.
Comando:
  dsmcutil update /name:"TSM Central Scheduler Service" 
  /commserver:nt1.example.com /commport:1521 /commmethod:
  tcpip

UPDate CAD

Atualiza os valores no registro do Serviço Client Acceptor. A opção necessária para esse comando é /name:service_name e os valores de registros a serem atualizados. Outras opções válidas são:

  • /node:nome_do_nó
  • /password:senha
  • /optfile:arquivo_de_opções
  • /httpport:http_port
  • /webports:portas_da_web
  • /cadschedname:nome_tabela
Tarefa
Atualizar o Serviço Client Acceptor para utilizar a senha e o arquivo de opções do cliente especificado. Todos os arquivos exigidos do serviço do cliente devem se localizar no diretório especificado.
Comando:
  dsmcutil update cad /name:"TSM CAD" /password:test 
  /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt"

UPDate REMOTEAgent

Atualiza os valores no registro do Serviço Remote Client Agent. A opção necessária para esse comando é /name:service_name e os valores de registros a serem atualizados. Outras opções válidas são:

  • /node:nome_do_nó
  • /password:senha
  • /optfile:arquivo_de_opções
  • /partnername:nome_do_serviço_do_parceiro
Tarefa
Atualize um Serviço de Agente de Cliente Remoto chamado TSM AGENT. O serviço do agente cliente remoto usa um nó chamado teste para se conectar ao servidor IBM Storage Protect . O arquivo de opções c:\program files\tivoli\tsm\baclient\dsm.opt é usado para se conectar ao servidor. O serviço de aceitador do cliente parceiro é TSM CAD.
Comando:
  dsmcutil update remoteagent /name:"TSM AGENT" /node:test 
  /password:test /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt" 
  /partnername:"TSM CAD"

Query Scheduler

Consultar os valores no registro do Planejador de Serviço. As opções necessárias são: /name:service_name. Outras opções válidas são:

  • /machine:nome_da_máquina
  • /clientdir
  • /optfile
  • /eventlogging
  • /node
  • /commmethod
  • /commport
  • /commserver
  • /errorlog
  • /schedlog
Nota: Não especifique um valor para as opções não necessárias. O cliente retorna valores de registro de opções para o serviço do planejador especificado.
Tarefa
Consultar definições no registro para o planejador de serviço especificado.
Comando:
  dsmcutil query /name:"TSM Central Scheduler Service"
Tarefa
Consultar a definição no registro de diretório do cliente para o planejador de serviço especificado.
Comando:
  dsmcutil query /name:"TSM Central Scheduler Service"

Query CAD

Consulta os valores no registro do Serviço Client Acceptor. A opção necessária para este comando é /name:service_name. Outras opções válidas são:

  • /machine:nome_da_máquina
  • /node
  • /optfile
  • /httpport
  • /webports
  • /clientdir
  • /partnername
Nota: Não especifique um valor para essas opções.
Tarefa
Consultar as definições no registro para o Serviço Client Acceptor especificado.
Comando:
  dsmcutil query cad /name:"TSM CAD"

Query Journal

Consultar o serviço de mecanismo de jornalística, TSM Journal Service, em um sistema Windows. Não há opções válidas para este comando.

Tarefa
Consultar o serviço de motor de jornaleira, TSM Journal Service.
Comando:
  dsmcutil query journal

Query REMOTEAgent

Consulta os valores no registro do Serviço Remote Client Agent. A opção necessária para este comando é /name:service_name. Outras opções válidas são:

  • /machine:nome_da_máquina
  • /node
  • /optfile
  • /partnername
  • /clientdir
Nota: Não especifique um valor para essas opções.
Tarefa
Consultar definições no registro para o Serviço Remote Client Agent especificado.
Comando:
  dsmcutil query remoteagent /name:"TSM AGENT"

List

Lista os Serviços de Cliente instalados. Não há opções exigidas.

Tarefa
Localizar e listar os serviços do cliente de backup e archive instalados na estação de trabalho local.
Comando:
  dsmcutil list
Tarefa
Listar os serviços do cliente de backup e archive instalados no PDC da estação de trabalho remota.
Comando:
  dsmcutil list /MACHINE:PDC

START

Use o comando Start para iniciar um serviço de cliente. O comando Start requer a opção /name:service_name.

Tarefa
Iniciar o serviço de motor de jornaleira, TSM Journal Service.
Comando:
  dsmcutil start /name:"TSM Journal Service"

STOP

Use o comando Stop para parar um serviço de cliente. O comando Stop requer a opção /name:service_name.

Tarefa
Pare o serviço de motor de jornaleira, TSM Journal Service.
Comando:
  dsmcutil stop /name:"TSM Journal Service"

UPDATEPW

Gere uma senha criptografada do IBM Storage Protect O comando UPDATEPW requer as opções /node:node_name, /password:password e /commserver:server_name. Se a opção clusternode for configurada para YES, o parâmetro /optfile: também será necessário.

Opcionalmente, você pode usar as seguintes opções:

  • /validate:Sim | Não
  • /clusternode:Yes | No (necessário, se estiver executando MSCS ou VCS).
  • /clustername:cluster_name (necessário, se estiver executando MSCS ou VCS).
  • /force:Sim | Não
  • /optfile: (para operações não em cluster)
  • /commmethod:
  • /commport:

A senha será validada com o servidor IBM Storage Protect , se /validate:Yes for especificado A senha é atualizada no servidor, se você especificar /updateonserver:Yes. Se você especificar essa opção, deverá especificar a senha atual com a opção /oldpassword:.

Tarefa
Atualize a senha criptografada para o nó especificado. Valide e atualize a senha no servidor IBM Storage Protect especificado, que reside no nome de host TCP/IP e na porta indicados:
Comando:
  dsmcutil updatepw /node:alpha1 /commMethod:tcpip
  /commServer:alpha1.example.com /commPort:1500
  /password:newpw /oldpassword:oldpw /updateonserver:yes
  /validate:yes /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt"

ADDACE

Concede acesso à senha do cliente do IBM Storage Protect backup-archive e aos certificados de SSL do cliente para usuários que não sejam administradores.

A partir do IBM Storage Protect 8.1.2, o controle de acesso mais rigoroso é aplicado ao armazenamento de senhas do IBM Storage Protect em sistemas operacionais Windows. Por padrão, somente a conta do Administrador, SYSTEM ou LocalSystem tem acesso ao armazém de senhas e aos certificados SSL.

Você pode usar o addace comando para modificar a lista de controle de acesso a fim de permitir que usuários adicionais, como usuários não administrativos, ou processos, como os IBM Storage Protect processos do cliente de Proteção de Dados, acessem o armazenamento de senhas e os certificados d SSL.

As seguintes opções são exigidas:
  • -entity:user | group
  • -object:ALL | NODENAME | path\TSM.* | path\spclient.*
Em que:
usuário | grupo
O usuário ou grupo de usuários do Windows que é dado acesso de leitura / gravação à loja de senhas.
ALL
Permite o acesso a todos os arquivos de senhas e certificados d SSL es nos subdiretórios do diretório C:\ProgramData\Tivoli\TSM\baclient .
NODENAME
Conceda acesso a todos os arquivos de senha e certificados d SSL s encontrados nos subdiretórios do diretório C:\ProgramData\Tivoli\TSM\baclient\Nodes\nodename .
path\TSM.* | path\spclient.*
Para senhas de cluster que podem existir em um diretório de recurso compartilhado, concede acesso aos arquivos de senha ou arquivos de certificado em um diretório específico para um nó.
Para obter mais informações sobre os locais de senha segura no Windows, consulte Armazenamento de senha segura.
Dica: O dsmcutil deleteace comando revoga o acesso aos arquivos de senha e aos certificados do SSL.
Tarefa
Alpha1Depois de instalar e configurar o cliente de backup e arquivamento como administrador, você precisa conceder à Susan, uma usuária sem privilégios de administrador no seu sistema Windows, acesso aos arquivos de senha e aos certificados d SSL no nó do cliente.
Comando:
  dsmcutil addace -entity:Susan -object:Alpha1
Tarefa
Um usuário não administrativo do IBM Storage Protect for Databases: Data Protection for Microsoft SQL Server configurou as senhas IBM Storage Protect , mas o administrador também precisa acessar as senhas. O usuário Data Protection for Microsoft SQL Server concede acesso aos arquivos de senha para o administrador emitindo o comando a seguir:
Comando:
  dsmcutil addace -entity:Administrator -object:all
Tarefa
Durante a configuração de um cluster, o administrador do Windows precisa conceder ao nó clusnode_A do cluster acesso aos certificados do cliente SSL.
Comando:
  dsmcutil addace -entity:Group_A 
  -object:C:\ProgramData\Tivoli\TSM\baclient\Nodes\clusnode_A\spclient.*
Se os certificados do cliente não estiverem no local padrão (C:\ProgramData\Tivoli\TSM\baclient\Nodes\clusnode_A\), eles estão localizados no mesmo diretório que o arquivo dsm.opt .

DELETEACE

Revoga o acesso à senha do cliente do IBM Storage Protect arquivo de backup e aos certificados de SSL o do cliente para usuários que não sejam administradores.

É possível usar o comando deleteace para modificar a lista de controle de acesso para remover o acesso ao armazenamento de senhas e aos certificados de clientes para usuários, como usuários não administrativos ou processos como os processos do cliente do IBM Storage Protect Data Protection.

As seguintes opções são exigidas:
  • -entity:user | group
  • -object:ALL | NODENAME | path\TSM.* | path\spclient.*
Em que:
usuário | grupo
O usuário ou grupo de usuários do Windows para o qual o acesso à loja de senhas e certificados clientes é removido.
ALL
Remove o acesso a todos os arquivos de senhas e certificados do SSL nos subdiretórios do diretório C:\ProgramData\Tivoli\TSM\baclient .
NODENAME
Remove o acesso a todos os arquivos de senhas e certificados do SSL encontrados nos subdiretórios do C:\ProgramData\Tivoli\TSM\baclient\Nodes\nodename diretório.
path\TSM.* | path\spclient.*
Para senhas de cluster que podem existir em um diretório de recurso compartilhado, remove o acesso aos arquivos de senha ou arquivos de certificado em um diretório específico para um nó.
Para obter mais informações sobre os locais de senha segura no Windows, consulte Armazenamento de senha segura.
Dica: O dsmcutil addace comando concede acesso a arquivos de senhas e certificados do SSL.
Tarefa
Susan, um usuário não administrativo, deixou a empresa há dois dias e o administrador deve revogar acesso aos arquivos de senha e aos certificados SSL no nó cliente Alpha1.
Comando:
  dsmcutil deleteace -entity:Susan -object:Alpha1
Tarefa
O nó do cluster clusnode_Z é movido da configuração do cluster e não precisa mais de acesso aos certificados SSL do cliente. Emita o comando a seguir para remover o acesso para clusnode_Z.
Comando:
  dsmcutil deleteace -entity:Group_Z
  -object:C:\ProgramData\Tivoli\TSM\baclient\Nodes\clusnode_Z\spclient.*
Se os certificados do cliente não estiverem no local padrão (C:\ProgramData\Tivoli\TSM\baclient\Nodes\clusnode_Z\), eles estão localizados no mesmo diretório que o arquivo dsm.opt .