Systèmes d'exploitation Windows

Commandes Dsmcutil : options requises et exemples

Editer en ligne

Des informations de référence pour les commandes dsmcutil et des exemples sont fournis.

La commande INSTall installe et configure les services du client de sauvegarde-archivage.

INSTall Scheduler

Installe et configure le service du planificateur IBM Storage Protect .

Les options de commande INSTall présentées ci-après sont les options requises :

  • /name:nom_service
  • /password:mot de passe
  • /clusternode:Oui | Non (obligatoire si vous exécutez Microsoft Cluster Server (MSCS) ou Veritas Cluster Server (VCS)).
  • /clustername:nom_cluster (requis si MSCS ou VCS est exécuté).
Restriction: n'indiquez pas un nom de cluster de plus de 64 caractères. Si vous spécifiez plus de 64 caractères et que vous utilisez Veritas Storage Foundation avec la haute disponibilité ou une configuration Microsoft Cluster Server, il se peut que vous ne puissiez pas installer ou démarrer le service du planificateur.

Vous pouvez également utiliser l'option /clientdir:répertoire_client. La valeur par défaut est le répertoire en cours.

Les fichiers suivants doivent se trouver dans le répertoire indiqué pour répertoire_client :

  • dsmcsvc.exe
  • dscenu.txt
  • dsm.opt
  • dsmntapi.dll
  • tsmutil1.dll
Remarque: Si le service est installé sur un poste de travail distant, le chemin d'accès complet au répertoire client doit être relatif au poste de travail cible. Les noms universels ne sont pas autorisés pour le compte de système local. Vous pouvez installer plusieurs services sur le même poste de travail.
Astuce: Dans les commandes fournies dans les exemples suivants, l'emplacement par défaut du programme d'installation du client (c:\program files\tivoli\tsm\baclient) est utilisé. Si vous avez installé le client à un autre emplacement, remplacez le chemin par défaut par votre chemin d'installation personnalisé. Si le nom du chemin contient un espace, placez-le entre guillemets (par exemple, "c:\program files\tivoli\tsm\baclient").
Tâche
Installez un service de planificateur nommé TSM Central Scheduler Service sur le poste de travail local. Lancez le service automatiquement au démarrage du système. Tous les fichiers requis doivent se trouver dans le répertoire actuel et le fichier d'options du client doit pointer vers le serveur IBM® Storage Protect où le nœud ALPHA1 est défini avec le mot de passe nodepw. Le serveur est contacté pour vérifier que le mot de passe et le poste indiqués sont corrects. Lorsque le mot de passe est validé, il est généré (chiffré) dans le fichier de stockage des mots de passe:
Commande :
  dsmcutil install scheduler /name:"TSM Central Scheduler Service" 
  /node:ALPHA1 /password:nodepw /autostart:yes
Tâche
Installez un service de planificateur nommé TSM Central Scheduler Service sur le poste de travail distant PDC. Lancez le service automatiquement au démarrage du système. Les fichiers requis du service du planificateur et les fichiers d'options indiqués doivent résider dans le répertoire c:\program files\tivoli\tsm\baclient du poste de travail distant. Le mot de passe est chiffré dans le fichier de stockage des mots de passe. Le serveur IBM Storage Protect n'est pas contacté pour valider le mot de passe.
Commande :
  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
Tâche
Installez un service de planificateur nommé TSM Central Scheduler Service sur le poste de travail distant PDC. Lancez le service automatiquement au démarrage du système. Les fichiers requis du service du planificateur et les fichiers d'options indiqués doivent résider dans le répertoire c:\program files\tivoli\tsm\baclient du poste de travail distant. Le mot de passe est chiffré dans le fichier de stockage des mots de passe. Le serveur Protect de l' IBM Storage, hébergé sur l'hôte et le port TCP/IP indiqués, est contacté afin de valider le mot de passe.
Commande :
 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
Tâche
Installez TSM Central Scheduler Service sur un noeud d'un cluster MSCS (ou VCS). Pour group-a situé sur le poste de travail node-1, vérifiez que node-1 est actuellement propriétaire de group-a, puis exécutez la commande suivante :
Commande :
  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

Installe et configure le service Client Acceptor. Les options requises sont les suivantes :

  • /name:nom_service
  • /node:nom_poste
  • /password:mot de passe
  • /httpport:port_http

Les autres options valides sont les suivantes :

  • /optfile:fichier_options
  • /webports:ports_Web
Tâche
Installez un service Client Acceptor appelé TSM CAD. L'accepteur client utilise un poste appelé test pour se connecter au serveur IBM Storage Protect . Utilisez le fichier d'options c:\program files\tivoli\tsm\baclient\dsm.opt pour vous connecter au serveur.
Commande :
  dsmcutil install cad /name:"TSM CAD" /node:test /password:test 
  /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt" /httpport:1582

INSTall Journal

Installe un service de moteur de journalisation sur tous les clients Windows. Une base de données de journalisation est créée pour stocker des informations qui permettent au client d'identifier les fichiers susceptibles d'être sauvegardés avant l'exécution d'une opération.

Si nécessaire, vous pouvez utiliser l'option nojournal avec la commande incremental pour indiquer que vous souhaitez exécuter une sauvegarde incrémentielle complète classique.

Le service du moteur de journalisation est nommé TSM Journal Service et utilise le fichier de configuration tsmjbbd.ini du répertoire d'installation du client de sauvegarde-archivage.

Remarque: Le service de journal est pris en charge dans un environnement Microsoft Cluster Server. Il est possible d'installer plusieurs services de journalisation en indiquant des noms de canaux distincts à l'aide du paramètre de configuration JournalPipe et des options client.

Il n'existe aucune option valide pour cette commande.

Tâche
Installez le service de moteur de journal (TSM Journal Service).
Commande :
  dsmcutil install journal

INSTall REMOTEAgent

Installe et configure un service Agent client distant. Les options requises sont les suivantes :

  • /name:nom_service
  • /node:nom_poste
  • /password:mot de passe
  • /partnername:nom_service_partenaire

Les autres options valides sont les suivantes :

  • /optfile:fichier_options
Tâche
Installez un service d'agent de client distant appelé TSM AGENT. L'agent client distant utilise un poste appelé test pour se connecter au serveur IBM Storage Protect . Utilisez le fichier d'options c:\program files\tivoli\tsm\baclient\dsm.opt pour établir une connexion. Le service d'accepteur client partenaire est TSM CAD.
Commande :
  dsmcutil install remoteagent /name:"TSM AGENT" /node:test 
  /password:test /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt" 
  /partnername:"TSM CAD"
Remarque: Le service d'agent client distant et le service d'accepteur client doivent être installés pour exécuter le client Web. Le service d'accepteur client doit être installé avant le service d'agent client distant. Utilisez l'option /partnername: pour indiquer le nom du service d'accepteur client partenaire.

REMove

Supprime un service client installé. L'option obligatoire est /name:nom_service.

Tâche
Supprimez du poste de travail local le service du planificateur indiqué.
Commande :
  dsmcutil remove /name:"TSM Central Scheduler Service"
Tâche
Supprimez le service du moteur de journalisation (TSM Journal Service) du poste de travail local.
Commande :
  dsmcutil remove /name:"TSM Journal Service"

UPDate

Met à jour les valeurs de registre du service du planificateur. L'option obligatoire pour cette commande est /name:nom_service. Vous devez également indiquer les valeurs de registre à mettre à jour. Les autres options valides sont les suivantes :

  • /clientdir:rép_client
  • /optfile::fichier_options
  • /eventlogging:Oui | Non
  • /node:nom_poste
  • /autostart:Oui | Non
  • /clusternode:Yes | No (obligatoire si MSCS ou VCS est en cours d'exécution).
  • /clustername:nom_cluster (obligatoire si MSCS ou VCS est en cours d'exécution).
Tâche
Mettez à jour les fichiers d'options et le répertoire du client pour le service du planificateur indiqué. Tous les fichiers du service client requis doivent résider dans le répertoire indiqué.
Remarque: Les options de communication spécifiées à l'aide de la commande dsmcutil sont prioritaires sur celles spécifiées dans le fichier d'options client.
Commande :
  dsmcutil update /name:"TSM Central Scheduler Service" 
  /clientdir:"c:\program files\tivoli\tsm\baclient" 
  /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt"
Tâche
Mettez à jour le service de planification indiqué afin qu'il utilise le protocole TCP/IP pour se connecter au serveur IBM Storage Protect, sous le nom d'hôte et sur le port spécifiés.
Commande :
  dsmcutil update /name:"TSM Central Scheduler Service" 
  /commserver:nt1.example.com /commport:1521 /commmethod:
  tcpip

UPDate CAD

Met à jour les valeurs de registre du service Client Acceptor. L'option obligatoire pour cette commande est /name:nom_service. Vous devez également indiquer les valeurs de registre à mettre à jour. Les autres options valides sont les suivantes :

  • /node:nom_poste
  • /password:mot de passe
  • /optfile:fichier_options
  • /httpport:port_http
  • /webports:ports_Web
  • /cadschedname:nom_planificateur
Tâche
Mettez à jour le service Client Acceptor pour pouvoir utiliser le fichier d'options et le mot de passe indiqués du client. Tous les fichiers du service client requis doivent résider dans le répertoire indiqué.
Commande :
  dsmcutil update cad /name:"TSM CAD" /password:test 
  /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt"

UPDate REMOTEAgent

Met à jour les valeurs de registre du service Agent client distant. L'option obligatoire pour cette commande est /name:nom_service. Vous devez également indiquer les valeurs de registre à mettre à jour. Les autres options valides sont les suivantes :

  • /node:nom_poste
  • /password:mot de passe
  • /optfile:fichier_options
  • /partnername:nom_service_partenaire
Tâche
Mettez à jour un service d'agent de client distant appelé TSM AGENT. Le service d'agent client distant utilise un poste appelé test pour se connecter au serveur IBM Storage Protect . Le fichier d'options c:\program files\tivoli\tsm\baclient\dsm.opt est utilisé pour la connexion au serveur. Le service d'accepteur client partenaire est TSM CAD.
Commande :
  dsmcutil update remoteagent /name:"TSM AGENT" /node:test 
  /password:test /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt" 
  /partnername:"TSM CAD"

Query Scheduler

Recherchez les valeurs de registre du service du planificateur. Les options obligatoires sont /name:nom_service. Les autres options valides sont les suivantes :

  • /machine:nom_machine
  • /clientdir
  • /optfile
  • /eventlogging
  • /node
  • /commmethod
  • /commport
  • /commserver
  • /errorlog
  • /schedlog
Remarque: n'indiquez pas de valeur pour les options non obligatoires. Le client renvoie les valeurs de registre des options pour le service du planificateur indiqué.
Tâche
Recherchez les paramètres de registre pour le service du planificateur que vous avez indiqué.
Commande :
  dsmcutil query /name:"TSM Central Scheduler Service"
Tâche
Recherchez les paramètres de registre du répertoire client pour le service du planificateur que vous avez indiqué.
Commande :
  dsmcutil query /name:"TSM Central Scheduler Service"

Query CAD

Recherche les valeurs de registre du service Client Acceptor. L'option obligatoire pour cette commande est /name:nom_service. Les autres options valides sont les suivantes :

  • /machine:nom_machine
  • /node
  • /optfile
  • /httpport
  • /webports
  • /clientdir
  • /partnername
Remarque: n'indiquez pas de valeur pour ces options.
Tâche
Recherchez les paramètres de registre pour le service Client Acceptor que vous avez indiqué.
Commande :
  dsmcutil query cad /name:"TSM CAD"

Query Journal

Interrogez le service du moteur de journalisation, TSM Journal Service, sur un système Windows. Il n'existe aucune option valide pour cette commande.

Tâche
Interrogez le service du moteur de journalisation, TSM Journal Service.
Commande :
  dsmcutil query journal

Query REMOTEAgent

Recherche les valeurs de registre du service Agent client distant. L'option obligatoire pour cette commande est /name:nom_service. Les autres options valides sont les suivantes :

  • /machine:nom_machine
  • /node
  • /optfile
  • /partnername
  • /clientdir
Remarque: n'indiquez pas de valeur pour ces options.
Tâche
Recherchez les paramètres de registre pour le service Agent client distant indiqué.
Commande :
  dsmcutil query remoteagent /name:"TSM AGENT"

List

Répertorie les services client installés. Aucune option n'est requise.

Tâche
Sur le poste de travail local, recherchez et répertoriez les services du client de sauvegarde-archivage installés.
Commande :
  dsmcutil list
Tâche
Sur le poste de travail distant PDC, répertoriez les services du client de sauvegarde-archivage installés.
Commande :
  dsmcutil list /MACHINE:PDC

START

Utilisez la commande Start pour démarrer un service client. La commande Start requiert l'option /name:nom_service.

Tâche
Démarrez le service du moteur de journalisation, TSM Journal Service.
Commande :
  dsmcutil start /name:"TSM Journal Service"

STOP

Utilisez la commande Stop pour arrêter un service client. La commande Stop requiert l'option /name:nom_service.

Tâche
Arrêtez le service du moteur de journalisation, TSM Journal Service.
Commande :
  dsmcutil stop /name:"TSM Journal Service"

UPDATEPW

Générez un mot de passe IBM Storage Protect chiffré. La commande UPDATEPW requiert les options /node:nom_poste, /password:mot_de_passe et /commserver:nom_serveur. Si l'option clusternode est définie sur YES, le paramètre /optfile: est également requis.

Vous pouvez éventuellement utiliser les options suivantes :

  • /validate:Oui | Non
  • /clusternode:Yes | No (obligatoire si MSCS ou VCS est en cours d'exécution).
  • /clustername:nom_cluster (obligatoire si MSCS ou VCS est en cours d'exécution).
  • /force:Oui | Non
  • /optfile: (pour les opérations qui ne concernent pas un cluster)
  • /commmethod:
  • /commport:

Le mot de passe est validé avec le serveur IBM Storage Protect si /validate:Yes est spécifié. Le mot de passe est mis à jour sur le serveur si vous indiquez l'option /updateonserver:Yes. Si vous spécifiez cette option, vous devez spécifier le mot de passe en cours avec l'option /oldpassword: .

Tâche
Mettez à jour le mot de passe chiffré pour le poste indiqué. Valider et mettre à jour le mot de passe sur le serveur IBM Storage Protect indiqué, hébergé sur l'hôte TCP/IP et le port spécifiés :
Commande :
  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

Permet aux utilisateurs non administrateurs d'accéder au mot IBM Storage Protect de passe du client « backup-archive » et aux certificats de l' SSL.

A partir de IBM Storage Protect 8.1.2, un contrôle d'accès plus strict est appliqué pour le stockage des mots de passe IBM Storage Protect sur les systèmes d'exploitation Windows. Par défaut, seul le compte Administrateur, SYSTEME ou Système local dispose d'un accès au fichier de stockage des mots de passe et aux certificats SSL.

Vous pouvez utiliser la addace commande pour modifier la liste de contrôle d'accès afin d'autoriser d'autres utilisateurs, tels que des utilisateurs non administrateurs, ou des processus, tels que les IBM Storage Protect processus du client Data Protection, à accéder au magasin de mots de passe et aux certificats d' SSL.

Les options suivantes sont requises :
  • -entity:user | group
  • -object:ALL | NODENAME | path\TSM.* | path\spclient.*
où :
utilisateur | groupe
Utilisateur ou groupe d'utilisateurs Windows disposant d'un accès en lecture / écriture au fichier de stockage des mots de passe.
ALL
Accorde l'accès à tous les fichiers de mot de passe et certificats SSL dans les sous-répertoires du répertoire C:\ProgramData\Tivoli\TSM\baclient.
Valeur d'option
Permet d'accéder à tous les fichiers de mots de passe et certificats d' SSL s qui se trouvent dans les sous-répertoires du C:\ProgramData\Tivoli\TSM\baclient\Nodes\nodename répertoire.
path\TSM.* | path\spclient.*
Pour les mots de passe de cluster qui peuvent se trouver dans un répertoire de ressource partagée, accorde l'accès aux fichiers de mot de passe ou de certificat dans le répertoire spécifique d'un poste.
Pour plus d'informations sur les emplacements de mot de passe sécurisé sous Windows, voir Stockage de mot de passe sécurisé.
Astuce : la dsmcutil deleteace commande révoque l'accès aux fichiers de mots de passe et aux certificats SSL.
Tâche
Alpha1Une fois que vous avez installé et configuré le client de sauvegarde et d'archivage en tant qu'administrateur, vous devez accorder à Susan, une utilisatrice sans droits d'administrateur sur votre système Windows, l'accès aux fichiers de mots de passe et aux certificats d' SSL sur le nœud client.
Commande :
  dsmcutil addace -entity:Susan -object:Alpha1
Tâche
Un utilisateur non administrateur de IBM Storage Protect for Databases: Data Protection for Microsoft SQL Server a configuré les mots de passe IBM Storage Protect , mais l'administrateur a également besoin d'accéder aux mots de passe. L'utilisateur Data Protection for Microsoft SQL Server accorde l'accès aux fichiers de mots de passe à l'administrateur en exécutant la commande suivante:
Commande :
  dsmcutil addace -entity:Administrator -object:all
Tâche
Lors de la configuration d'un cluster, l'administrateur Windows doit autoriser le nœud clusnode_A du cluster à accéder aux certificats d' SSL des clients.
Commande :
  dsmcutil addace -entity:Group_A 
  -object:C:\ProgramData\Tivoli\TSM\baclient\Nodes\clusnode_A\spclient.*
Si les certificats client ne se trouvent pas à l'emplacement par défaut (C:\ProgramData\Tivoli\TSM\baclient\Nodes\clusnode_A\), ils sont situés dans le même répertoire que le fichier dsm.opt.

DELETEACE

Révocation de l'accès au mot IBM Storage Protect de passe du client « backup-archive » et aux certificats de l' SSL -client pour les utilisateurs non administrateurs.

Vous pouvez utiliser la commande deleteace pour modifier la liste de contrôle d'accès afin de supprimer l'accès au fichier de stockage des mots de passe et aux certificats client pour les utilisateurs, tels que les utilisateurs non administrateurs ou les processus tels que les processus client IBM Storage Protect Data Protection.

Les options suivantes sont requises :
  • -entity:user | group
  • -object:ALL | NODENAME | path\TSM.* | path\spclient.*
où :
utilisateur | groupe
Utilisateur ou groupe d'utilisateurs Windows pour lequel l'accès au fichier de stockage des mots de passe et aux certificats client est supprimé.
ALL
Supprime l'accès à tous les fichiers de mot de passe et certificats SSL dans les sous-répertoires du répertoire C:\ProgramData\Tivoli\TSM\baclient.
Valeur d'option
Supprime l'accès à tous les fichiers de mots de passe et certificats d' SSL s se trouvant dans les sous-répertoires du C:\ProgramData\Tivoli\TSM\baclient\Nodes\nodename répertoire.
path\TSM.* | path\spclient.*
Pour les mots de passe de cluster qui peuvent se trouver dans un répertoire de ressource partagée, supprime l'accès aux fichiers de mot de passe ou de certificat dans le répertoire spécifique d'un poste.
Pour plus d'informations sur les emplacements de mot de passe sécurisé sous Windows, voir Stockage de mot de passe sécurisé.
Astuce : la dsmcutil addace commande permet d'accéder aux fichiers de mots de passe et aux certificats de l' SSL.
Tâche
Susan, une utilisatrice non-administratrice, a quitté l'entreprise il y a deux jours et l'administrateur doit révoquer son accès aux fichiers de mot de passe et certificats SSL sur le poste client Alpha1.
Commande :
  dsmcutil deleteace -entity:Susan -object:Alpha1
Tâche
Le poste de cluster clusnode_Z est retiré de la configuration du cluster et n'a plus besoin d'accéder aux certificats SSL du client. Exécutez la commande suivante pour supprimer l'accès de clusnode_Z.
Commande :
  dsmcutil deleteace -entity:Group_Z
  -object:C:\ProgramData\Tivoli\TSM\baclient\Nodes\clusnode_Z\spclient.*
Si les certificats client ne se trouvent pas à l'emplacement par défaut (C:\ProgramData\Tivoli\TSM\baclient\Nodes\clusnode_Z\), ils sont situés dans le même répertoire que le fichier dsm.opt.