Sistemi operativi Windows

Comandi dsmcutil: opzioni richieste ed esempi

Modifica in linea

Vengono fornite informazioni di riferimento per i comandi e gli esempi dsmcutil .

Il comando INSTall installa e configura i servizi client di backup - archivio.

INSTall Scheduler

Installa e configura il servizio scheduler IBM Storage Protect .

Queste sono le opzioni del comando INSTall richieste:

  • /name:nome_servizio
  • /password:password
  • /clusternode:Sì | No (obbligatorio se si esegue Microsoft Cluster Server (MSCS) o Veritas Cluster Server (VCS)).
  • /clustername:nome_cluster (obbligatorio se si esegue MSCS o VCS).
Limitazione: non specificare un nome cluster con più di 64 caratteri. Se si specificano più di 64 caratteri e si utilizza Veritas Storage Foundation con alta disponibilità o una configurazione Microsoft Cluster Server, potrebbe non essere possibile installare o avviare il servizio scheduler.

È possibile utilizzare anche l'opzione /clientdir:client_dir , il valore predefinito è la directory corrente.

I seguenti file devono esistere nella directory specificata da dir_client:

  • dsmcsvc.exe
  • dscenu.txt
  • dsm.opt
  • dsmntapi.dll
  • tsmutil1.dll
Nota: se il servizio è in fase di installazione su una stazione di lavoro remota, il percorso completo della directory client deve essere relativo alla stazione di lavoro di destinazione. I nomi UNC non sono consentiti per l'account di sistema locale. È possibile installare più servizi sulla stessa workstation.
Suggerimento: nei comandi forniti nei seguenti esempi, viene utilizzata l'ubicazione predefinita del programma di installazione client (c:\program files\tivoli\tsm\baclient). Se il client è stato installato in un'ubicazione diversa, sostituire il percorso predefinito con il proprio percorso di installazione personalizzato. Se il percorso contiene uno spazio, racchiuderlo tra virgolette doppie (ad esempio, "c:\program files\tivoli\tsm\baclient").
Attività
Installare un servizio scheduler denominato TSM Central Scheduler Service sulla workstation locale. Avviare il servizio automaticamente all'avvio del sistema. Tutti i file richiesti devono risiedere nella directory corrente e il file delle opzioni del client deve puntare al server IBM® Storage Protect dove il nodo ALPHA1 è definito con la password nodepw. Il server viene contattato per verificare che il nodo e la parola d'ordine specificati siano validi. Quando la password viene convalidata, viene generata (codificata) nell'archivio delle password:
Comando:
  dsmcutil install scheduler /name:"TSM Central Scheduler Service" 
  /node:ALPHA1 /password:nodepw /autostart:yes
Attività
Installare un servizio scheduler denominato TSM Central Scheduler Service sul PDC della stazione di lavoro remota. Avviare il servizio automaticamente all'avvio del sistema. I file del servizio scheduler richiesti e il file delle opzioni specificato devono risiedere sulla workstation remota nella directory c:\program files\tivoli\tsm\baclient . La password viene codificata nell'archivio delle password. Il server IBM Storage Protect non viene contattato per convalidare la password.
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
Attività
Installare un servizio scheduler denominato TSM Central Scheduler Service sul PDC della stazione di lavoro remota. Avviare il servizio automaticamente all'avvio del sistema. I file del servizio scheduler richiesti e il file delle opzioni specificato devono risiedere sulla workstation remota nella directory c:\program files\tivoli\tsm\baclient . La password viene codificata nell'archivio delle password. Per verificare la password, viene contattato il server Protect dell' IBM Storage, ospitato all'indirizzo TCP/IP e sulla porta specificati.
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
Attività
Installare TSM Central Scheduler Service su un nodo di un cluster MSCS (o VCS). Per group - a dalla workstation node-1, assicurarsi che node-1 sia attualmente proprietario di group - a , quindi immettere il comando riportato di seguito.
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

Installa e configura il servizio Client Acceptor. Le opzioni richieste sono:

  • /name:nome_servizio
  • /node:nome_nodo
  • /password:password
  • /httpport:porta_http

Altre opzioni valide sono:

  • /optfile:file_opzioni
  • /webports:Porte Web
Attività
Installare un Client Acceptor Service denominato TSM CAD. Il client acceptor utilizza un nodo denominato test per collegarsi al server IBM Storage Protezione . Utilizzare il file delle opzioni c:\program files\tivoli\tsm\baclient\dsm.opt per connettersi al server.
Comando:
  dsmcutil install cad /name:"TSM CAD" /node:test /password:test 
  /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt" /httpport:1582

INSTall Journal

Installa un servizio motore journal su tutti i client Windows. Viene creato un database journal che memorizza le informazioni che il client utilizza per determinare quali file sono idonei per il backup prima dell'avvio di un'operazione.

Se necessario, è possibile utilizzare l'opzione nojournal con il comando incremental per specificare che si desidera eseguire un backup incrementale completo tradizionale.

Il servizio del motore journal è denominato TSM Journal Service e utilizza il file di configurazione tsmjbbd.ini dalla directory di installazione del client di backup - archiviazione.

Nota: il servizio Journal è supportato in ambiente Microsoft Cluster Server. È possibile installare più servizi journal specificando nomi pipe univoci utilizzando l'impostazione di configurazione del journal JournalPipe e le opzioni client.

Non esistono opzioni valide per questo comando.

Attività
Installare il servizio del motore journal (TSM Journal Service).
Comando:
  dsmcutil install journal

INSTall REMOTEAgent

Installa e configura il servizio Remote Client Agent. Le opzioni richieste sono:

  • /name:nome_servizio
  • /node:nome_nodo
  • /password:password
  • /partnername:nome_servizio_partner

Altre opzioni valide sono:

  • /optfile:file_opzioni
Attività
Installare un servizio agent client remoto denominato TSM AGENT. L'agent client remoto utilizza un nodo denominato test per connettersi al server IBM Storage Protect . Il file delle opzioni c:\program files\tivoli\tsm\baclient\dsm.opt viene utilizzato per connettersi. Il servizio client acceptor partner è 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: per eseguire il client Web è necessario installare sia il servizio Remote Client Agent che il servizio Client Acceptor. Client Acceptor Service deve essere installato prima di Remote Client Agent Service. Utilizzare l'opzione /partnername: per specificare il nome del Client Acceptor Service partner.

REMove

Rimuovere un servizio client installato. L'opzione richiesta è /name:nome_servizio.

Attività
Rimuovere il servizio scheduler specificato dalla workstation locale.
Comando:
  dsmcutil remove /name:"TSM Central Scheduler Service"
Attività
Rimuovere il servizio del motore journal (TSM Journal Service) dalla workstation locale.
Comando:
  dsmcutil remove /name:"TSM Journal Service"

UPDate

Aggiorna i valori del registro del servizio Scheduler. L'opzione richiesta per questo comando è /name:nome_servizioe i valori di registro da aggiornare. Altre opzioni valide sono:

  • /clientdir:dir_client
  • /optfile::file_opzioni
  • /eventlogging:Sì | No
  • /node:nome_nodo
  • /autostart:Sì | No
  • /clusternode:Sì | No (richiesto se si esegue MSCS o VCS).
  • /clustername:cluster_name (richiesto se si esegue MSCS o VCS).
Attività
Aggiornare la directory del client e il file delle opzioni per il servizio scheduler specificato. Tutti i file del servizio client richiesti devono risiedere nella directory specificata.
Nota: le opzioni di comunicazione specificate con il comando dsmcutil hanno la precedenza su quelle specificate nel file delle opzioni client.
Comando:
  dsmcutil update /name:"TSM Central Scheduler Service" 
  /clientdir:"c:\program files\tivoli\tsm\baclient" 
  /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt"
Attività
Aggiornare il servizio di pianificazione specificato in modo che utilizzi il protocollo TCP/IP per connettersi al server IBM Storage Protect all'indirizzo IP specificato sulla porta indicata.
Comando:
  dsmcutil update /name:"TSM Central Scheduler Service" 
  /commserver:nt1.example.com /commport:1521 /commmethod:
  tcpip

UPDate CAD

Aggiorna i valori di registro del servizio Client Acceptor. L'opzione richiesta per questo comando è /name:nome_servizioe i valori di registro da aggiornare. Altre opzioni valide sono:

  • /node:nome_nodo
  • /password:password
  • /optfile:file_opzioni
  • /httpport:porta_http
  • /webports:Porte Web
  • /cadschedname:nome_scheduler
Attività
Aggiornare Client Acceptor Service per utilizzare la password del client e il file delle opzioni specificati. Tutti i file del servizio client richiesti devono risiedere nella directory specificata.
Comando:
  dsmcutil update cad /name:"TSM CAD" /password:test 
  /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt"

UPDate REMOTEAgent

Aggiorna i valori del registro Remote Client Agent Service. L'opzione richiesta per questo comando è /name:nome_servizioe i valori di registro da aggiornare. Altre opzioni valide sono:

  • /node:nome_nodo
  • /password:password
  • /optfile:file_opzioni
  • /partnername:nome_servizio_partner
Attività
Aggiornare un servizio agent client remoto denominato TSM AGENT. Il servizio agent client remoto utilizza un nodo denominato test per connettersi al server IBM Storage Protect . Il file delle opzioni c:\program files\tivoli\tsm\baclient\dsm.opt viene utilizzato per connettersi al server. Il servizio client acceptor partner è 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

Valori di registro del servizio Query Scheduler. Le opzioni richieste sono: /name:nome_servizio. Altre opzioni valide sono:

  • /machine:nome_macchina
  • /clientdir
  • /optfile
  • /eventlogging
  • /node
  • /commmethod
  • /commport
  • /commserver
  • /errorlog
  • /schedlog
Nota: non specificare un valore per le opzioni non richieste. Il client restituisce i valori di registro delle opzioni per il servizio scheduler specificato.
Attività
Interrogare le impostazioni di registro per il servizio scheduler specificato.
Comando:
  dsmcutil query /name:"TSM Central Scheduler Service"
Attività
Interrogare l'impostazione del registro di directory del client per il servizio scheduler specificato.
Comando:
  dsmcutil query /name:"TSM Central Scheduler Service"

Query CAD

Interroga i valori di registro del servizio Client Acceptor. L'opzione richiesta per questo comando è /name:nome_servizio. Altre opzioni valide sono:

  • /machine:nome_macchina
  • /node
  • /optfile
  • /httpport
  • /webports
  • /clientdir
  • /partnername
Nota: non specificare un valore per queste opzioni.
Attività
Interrogare le impostazioni di registro per il servizio Client Acceptor specificato.
Comando:
  dsmcutil query cad /name:"TSM CAD"

Query Journal

Eseguire una query del servizio motore journal, TSM Journal Service, su un sistema Windows. Non esistono opzioni valide per questo comando.

Attività
Eseguire una query del servizio del motore journal, TSM Journal Service.
Comando:
  dsmcutil query journal

Query REMOTEAgent

Interroga i valori del registro del servizio agent client remoto. L'opzione richiesta per questo comando è /name:nome_servizio. Altre opzioni valide sono:

  • /machine:nome_macchina
  • /node
  • /optfile
  • /partnername
  • /clientdir
Nota: non specificare un valore per queste opzioni.
Attività
Interrogare le impostazioni del registro per il servizio agent client remoto specificato.
Comando:
  dsmcutil query remoteagent /name:"TSM AGENT"

List

Elenca i Servizi client installati. Non sono presenti opzioni richieste.

Attività
Individuare ed elencare i servizi client di backup - archivio installati sulla workstation locale.
Comando:
  dsmcutil list
Attività
Elencare i servizi client di backup - archivio installati sul PDC della stazione di lavoro remota.
Comando:
  dsmcutil list /MACHINE:PDC

START

Utilizzare il comando Start per avviare un servizio client. Il comando Start richiede l'opzione /name:nome_servizio .

Attività
Avviare il servizio del motore journal, TSM Journal Service.
Comando:
  dsmcutil start /name:"TSM Journal Service"

STOP

Utilizzare il comando Stop per arrestare un servizio client. Il comando Stop richiede l'opzione /name:nome_servizio .

Attività
Arrestare il servizio del motore journal, TSM Journal Service.
Comando:
  dsmcutil stop /name:"TSM Journal Service"

UPDATEPW

Generare una password IBM Storage Protect codificata. Il comando UPDATEPW richiede /node:nome_nodo, /password:password, e /commserver:nome_server . Se l'opzione clusternode è impostata su YES, è richiesto anche il parametro /optfile: .

Facoltativamente, è possibile utilizzare le seguenti opzioni:

  • /validate:Sì | No
  • /clusternode:Sì | No (richiesto se si esegue MSCS o VCS).
  • /clustername:cluster_name (richiesto se si esegue MSCS o VCS).
  • /force:Sì | No
  • /optfile: (per operazioni non cluster)
  • /commmethod:
  • /commport:

La parola d'ordine viene convalidata con il server IBM Storage Protect se è specificato /validate:Yes . La password viene aggiornata sul server se si specifica /updateonserver:Yes. Se si specifica questa opzione, è necessario specificare la parola d'ordine corrente con l'opzione /oldpassword: .

Attività
Aggiornare la password codificata per il nodo specificato. Convalida e aggiorna la password sul server IBM Storage Protect specificato, che risiede sull'hostname e sulla porta TCP/IP specificati:
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

Consente l'accesso alla password del IBM Storage Protect client backup-archive e ai certificati del client SSL per gli utenti non amministratori.

A partire da IBM Storage Protect 8.1.2, viene applicato un controllo degli accessi più rigoroso per l'archiviazione delle password IBM Storage Protect sui sistemi operativi Windows. Per impostazione predefinita, solo l'amministratore, l'account SYSTEM o l'account LocalSystem hanno accesso all'archivio delle password e ai certificati dell' SSL.

È possibile utilizzare il addace comando per modificare l'elenco di controllo degli accessi e consentire ad altri utenti, come gli utenti non amministratori, o a processi quali i IBM Storage Protect processi del client Data Protection, di accedere all'archivio delle password e ai certificati di SSL.

Sono richieste le seguenti opzioni:
  • -entity:user | group
  • -object:ALL | NODENAME | path\TSM.* | path\spclient.*
Dove:
utente | gruppo
L'utente Windows o il gruppo di utenti a cui viene fornito l'accesso in lettura / scrittura all'archivio delle password.
ALL
Consente l'accesso a tutti i file di password e ai certificati SSL presenti nelle sottodirectory della C:\ProgramData\Tivoli\TSM\baclient directory.
NODENAME
Consente l'accesso a tutti i file di password e ai certificati SSL presenti nelle sottodirectory della C:\ProgramData\Tivoli\TSM\baclient\Nodes\nodename directory.
path\TSM.* | path\spclient.*
Per le password del cluster che possono esistere in una directory di risorse condivise, concede l'accesso ai file di password o ai file di certificati in una directory specifica per un nodo.
Per ulteriori informazioni sulle ubicazioni delle password protette in Windows, consultare Memoria password protetta.
Suggerimento: il dsmcutil deleteace comando revoca l'accesso ai file delle password e ai certificati di SSL.
Attività
Alpha1Dopo aver installato e configurato il client di backup-archive come amministratore, devi concedere a Susan, un utente senza privilegi di amministratore sul tuo sistema Windows, l'accesso ai file delle password e ai certificati di SSL sul nodo client.
Comando:
  dsmcutil addace -entity:Susan -object:Alpha1
Attività
Un utente non amministrativo di IBM Storage Protect for Databases: Data Protection for Microsoft SQL Server ha configurato le parole d'ordine IBM Storage Protect ma l'amministratore ha anche bisogno di accedere alle parole d'ordine. L'utente Data Protection for Microsoft SQL Server concede l'accesso ai file di password all'amministratore immettendo il seguente comando:
Comando:
  dsmcutil addace -entity:Administrator -object:all
Attività
Durante la configurazione di un cluster, l'amministratore di Windows deve concedere al nodo clusnode_A del cluster l'accesso ai certificati dell' SSL e del client.
Comando:
  dsmcutil addace -entity:Group_A 
  -object:C:\ProgramData\Tivoli\TSM\baclient\Nodes\clusnode_A\spclient.*
Se i certificati client non si trovano nell'ubicazione predefinita (C:\ProgramData\Tivoli\TSM\baclient\Nodes\clusnode_A\), si trovano nella stessa directory del file dsm.opt .

DELETEACE

Revoca l'accesso alla password del IBM Storage Protect client backup-archive e ai certificati client SSL per gli utenti non amministratori.

È possibile utilizzare il comando deleteace per modificare l'ACL (access control list) per rimuovere l'accesso all'archivio delle password e ai certificati client per gli utenti, ad esempio gli utenti non amministrativi o i processi come i processi del client IBM Storage Protect Data Protection.

Sono richieste le seguenti opzioni:
  • -entity:user | group
  • -object:ALL | NODENAME | path\TSM.* | path\spclient.*
Dove:
utente | gruppo
L'utente o il gruppo di utenti Windows per cui viene rimosso l'accesso all'archivio password e ai certificati client.
ALL
Rimuove l'accesso a tutti i file di password e ai certificati SSL presenti nelle sottodirectory della C:\ProgramData\Tivoli\TSM\baclient directory.
NODENAME
Rimuove l'accesso a tutti i file di password e ai certificati SSL presenti nelle sottodirectory della C:\ProgramData\Tivoli\TSM\baclient\Nodes\nodename directory.
path\TSM.* | path\spclient.*
Per le password del cluster che possono esistere su una directory di risorse condivise, rimuove l'accesso ai file di password o ai file di certificato in una directory specifica per un nodo.
Per ulteriori informazioni sulle ubicazioni delle password protette in Windows, consultare Memoria password protetta.
Suggerimento: il dsmcutil addace comando consente di accedere ai file delle password e ai certificati di SSL.
Attività
Alpha1Susan, un'utente senza privilegi amministrativi, ha lasciato l'azienda due giorni fa e l'amministratore deve revocare l'accesso ai file delle password e ai certificati di SSL sul nodo client.
Comando:
  dsmcutil deleteace -entity:Susan -object:Alpha1
Attività
Il nodo clusnode_Z del cluster viene rimosso dalla configurazione del cluster e non deve più accedere ai certificati client SSL. Immetti il seguente comando per rimuovere l'accesso per clusnode_Z.
Comando:
  dsmcutil deleteace -entity:Group_Z
  -object:C:\ProgramData\Tivoli\TSM\baclient\Nodes\clusnode_Z\spclient.*
Se i certificati client non si trovano nell'ubicazione predefinita (C:\ProgramData\Tivoli\TSM\baclient\Nodes\clusnode_Z\), si trovano nella stessa directory del file dsm.opt .