Windows オペレーティング・システム

dsmcutil コマンド: 必須指定のオプションおよび例

オンライン編集

dsmcutil コマンドおよび例の参照情報が提供されています。

INSTall コマンドはバックアップ/アーカイブ・サービスをインストールし、構成します。

INSTall Scheduler

IBM Storage Protect スケジューラー・サービスをインストールして構成します。

以下は必須の INSTall コマンド・オプションです。

  • /name:サービス名
  • /password:パスワード
  • /clusternode:Yes | No (Microsoft Cluster Server (MSCS) または Veritas Cluster Server (VCS) を実行している場合は必須)。
  • /clustername:cluster_name (MSCS または VCS を実行している場合は必須)。
制約事項: 64 文字を超えるクラスター名は指定しないでください。 64 文字を超える文字を指定し、Veritas Storage Foundation with High Availability または Microsoft Cluster Server 構成を使用している場合、スケジューラー・サービスをインストールまたは開始できない可能性があります。

/clientdir:client_dir オプションも使用でき、省略時は現行ディレクトリーです。

以下のファイルは、client_dir に指定されたディレクトリーに置かれている必要があります。

  • dsmcsvc.exe
  • dscenu.txt
  • dsm.opt
  • dsmntapi.dll
  • tsmutil1.dll
注: サービスがリモート・ワークステーションにインストールされる場合、完全修飾クライアント・ディレクトリー・パスは、ターゲット・ワークステーションからの相対パスでなければなりません。 UNC 名はローカル・システム・アカウントには許可されません。 同じワークステーションに複数のサービスをインストールできます。
ヒント: 以下の例で提供されているコマンドでは、クライアント・インストール・プログラムのデフォルトの場所 (c:\program files\tivoli\tsm\baclient) が使用されます。 別のロケーションにクライアントをインストールした場合は、デフォルトのパスをご使用のカスタム・インストール・パスで置き換えてください。 パスにスペースが含まれている場合は、パスを二重引用符で囲んでください (例: "c:\program files\tivoli\tsm\baclient")。
タスク
TSM Central Scheduler Service という名前のスケジューラー・サービスをローカル・ワークステーションにインストールします。 システムのブート時にサービスを自動的に開始します。 必要なファイルはすべてカレントディレクトリに存在し、クライアントオプションファイルは、ノード ALPHA1 がパスワード nodepw で定義されている IBM® Storage Protect サーバーを指す必要があります。 サーバーは、指定されたノードとパスワードが有効であることを 検査するために接続されます。 パスワードが検証されると、パスワード・ストアに生成 (暗号化) されます。
コマンド:
  dsmcutil install scheduler /name:"TSM Central Scheduler Service" 
  /node:ALPHA1 /password:nodepw /autostart:yes
タスク
TSM Central Scheduler Service という名前のスケジューラー・サービスをリモート・ワークステーション PDC にインストールします。 システムのブート時にサービスを自動的に開始します。 必要なスケジューラー・サービス・ファイルおよび指定されたオプション・ファイルは、リモート・ワークステーション上の c:\program files\tivoli\tsm\baclient ディレクトリーになければなりません。 パスワードはパスワード・ストアに暗号化されます。 パスワードを検証するために IBM Storage Protect サーバーに接続することはできません。
コマンド:
  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
タスク
TSM Central Scheduler Service という名前のスケジューラー・サービスをリモート・ワークステーション PDC にインストールします。 システムのブート時にサービスを自動的に開始します。 必要なスケジューラー・サービス・ファイルおよび指定されたオプション・ファイルは、リモート・ワークステーション上の c:\program files\tivoli\tsm\baclient ディレクトリーになければなりません。 パスワードはパスワード・ストアに暗号化されます。 指定された TCP/IP のホストとポートにある IBM Storage Protect サーバーに接続し、パスワードの有効性を確認します。
コマンド:
 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
タスク
MSCS (または VCS) クラスターの 1 つのノードに TSM Central Scheduler Service をインストールします。 ワークステーション node-1 の group-a に対して、node-1 が現在 group-a を所有していることを確認してから、次のコマンドを出します。
コマンド:
  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

クライアント・アクセプター・サービスのインストールおよび構成を行います。 必須オプションを以下に示します。

  • /name:サービス名
  • /node:node_name
  • /password:パスワード
  • /httpport:HTTP ポート

その他の有効なオプションは次のとおりです。

  • /optfile:オプション・ファイル
  • /webports:Web ポート
タスク
TSM CADというクライアント・アクセプター・サービスをインストールします。 クライアント・アクセプターは、 test というノードを使用して、 IBM Storage Protect サーバーに接続します。 オプション・ファイル c:\program files\tivoli\tsm\baclient\dsm.opt を使用して、サーバーに接続します。
コマンド:
  dsmcutil install cad /name:"TSM CAD" /node:test /password:test 
  /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt" /httpport:1582

INSTall Journal

すべての Windows クライアントにジャーナル・エンジン・サービスをインストールします。 操作の開始前にバックアップに適格なファイルを判別するために、クライアントが使用する情報を保管するジャーナル・データベース が 作成されます。

必要があれば、nojournal オプション を incremental コマンドに使用して、従来のフル増分バックアップを行いたいことを指定することができます。

ジャーナル・エンジン・サービスの名前は TSM Journal Service で、バックアップ/アーカイブ・クライアントのインストール・ディレクトリーにある構成ファイル tsmjbbd.ini を使用します。

注: ジャーナル・サービスは、Microsoft Cluster Server 環境でサポートされます。 JournalPipe ジャーナル構成設定とクライアント・オプションを使用して固有のパイプ名を指定することで、複数のジャーナル・サービスをインストールすることができます。

このコマンドには有効なオプションがありません。

タスク
ジャーナル・エンジン・サービス (TSM Journal Service) をインストールします。
コマンド:
  dsmcutil install journal

INSTall REMOTEAgent

リモート・クライアント・エージェント・サービスのインストールおよび構成を行います。 必須オプションを以下に示します。

  • /name:サービス名
  • /node:node_name
  • /password:パスワード
  • /partnername:パートナー・サービス名

その他の有効なオプションは次のとおりです。

  • /optfile:オプション・ファイル
タスク
TSM AGENTというリモート・クライアント・エージェント・サービスをインストールします。 リモート・クライアント・エージェントは、 test というノードを使用して、 IBM Storage Protect サーバーに接続します。 接続には、オプション・ファイル c:\program files\tivoli\tsm\baclient\dsm.opt が使用されます。 パートナー・クライアント・アクセプター・サービスは TSM CADです。
コマンド:
  dsmcutil install remoteagent /name:"TSM AGENT" /node:test 
  /password:test /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt" 
  /partnername:"TSM CAD"
注: Web クライアントを実行するには、リモート・クライアント・エージェント・サービスとクライアント・アクセプター・サービスの両方がインストールされている必要があります。 クライアント・アクセプター・サービスは、リモート・クライアント・エージェント・サービス の前に インストールする必要があります。 /partnername: オプションを 使用してパートナーのクライアント・アクセプター・サービスの名前を指定します。

REMove

インストール済みのクライアント・サービスを除去します。 必須オプションは /name:service_name です。

タスク
指定されたスケジューラー・サービスをローカル・ワークステーションから削除します。
コマンド:
  dsmcutil remove /name:"TSM Central Scheduler Service"
タスク
ジャーナル・エンジン・サービス (TSM Journal Service) をローカル・ワークステーションから除去します。
コマンド:
  dsmcutil remove /name:"TSM Journal Service"

UPDate

スケジューラー・サービスのレジストリーの値を更新します。 このコマンドの必須オプションは、/name:service_name および更新するレジストリー値です。 その他の有効なオプションは次のとおりです。

  • /clientdir:クライアント・ディレクトリー
  • /optfile:の場合:options_file
  • /eventlogging:はい | いいえ
  • /node:node_name
  • /autostart:はい | いいえ
  • /clusternode:Yes | No (MSCS または VCS を実行している場合は必須)。
  • /clustername:cluster_name (MSCS または VCS を実行している場合は必須)。
タスク
指定されたスケジューラー・サービスのクライアント・ディレクトリーと オプション・ファイルを更新します。 必要なクライアント・サービス・ファイルはすべて、指定されたディレクトリーにある必要があります。
注: ここで dsmcutil コマンドで指定された通信オプションは、クライアント・オプション・ファイルで指定された通信オプションよりも優先されます。
コマンド:
  dsmcutil update /name:"TSM Central Scheduler Service" 
  /clientdir:"c:\program files\tivoli\tsm\baclient" 
  /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt"
タスク
指定されたスケジューラ・サービスを更新し、 TCP/IP プロトコルを使用して、指定されたホスト名とポートで IBM Storage Protect サーバーに接続するように設定します。
コマンド:
  dsmcutil update /name:"TSM Central Scheduler Service" 
  /commserver:nt1.example.com /commport:1521 /commmethod:
  tcpip

UPDate CAD

クライアント・アクセプター・サービスのレジストリー値を更新します。 このコマンドの必須オプションは、/name:service_name および更新するレジストリー値です。 その他の有効なオプションは次のとおりです。

  • /node:node_name
  • /password:パスワード
  • /optfile:オプション・ファイル
  • /httpport:HTTP ポート
  • /webports:Web ポート
  • /cadschedname:スケジューラー名
タスク
クライアント・アクセプター・サービスを更新して、指定したクライアント・パスワードとオプション・ファイルを 使用します。 必要なクライアント・サービス・ファイルはすべて、指定されたディレクトリーにある必要があります。
コマンド:
  dsmcutil update cad /name:"TSM CAD" /password:test 
  /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt"

UPDate REMOTEAgent

リモート・クライアント・エージェント・サービスのレジストリー値を更新します。 このコマンドの必須オプションは、/name:service_name および更新するレジストリー値です。 その他の有効なオプションは次のとおりです。

  • /node:node_name
  • /password:パスワード
  • /optfile:オプション・ファイル
  • /partnername:パートナー・サービス名
タスク
TSM AGENTという名前のリモート・クライアント・エージェント・サービスを更新します。 リモート・クライアント・エージェント・サービスは、 test というノードを使用して、 IBM Storage Protect サーバーに接続します。 サーバーへの接続には、オプション・ファイル c:\program files\tivoli\tsm\baclient\dsm.opt が使用されます。 パートナー・クライアント・アクセプター・サービスは TSM CADです。
コマンド:
  dsmcutil update remoteagent /name:"TSM AGENT" /node:test 
  /password:test /optfile:"c:\program files\tivoli\tsm\baclient\dsm.opt" 
  /partnername:"TSM CAD"

Query Scheduler

スケジューラー・サービスのレジストリーの値を照会します。 必須オプションは /name:service_name です。 その他の有効なオプションは次のとおりです。

  • /machine:マシン名
  • /clientdir
  • /optfile
  • /eventlogging
  • /node
  • /commmethod
  • /commport
  • /commserver
  • /errorlog
  • /schedlog
注: 必須でないオプションには値を指定しないでください。 クライアントは、指定したスケジューラー・サービスのオプション・レジストリーの値を戻します。
タスク
指定したスケジューラー・サービスのレジストリー設定を照会します。
コマンド:
  dsmcutil query /name:"TSM Central Scheduler Service"
タスク
指定したスケジューラー・サービスの、クライアント・ディレクトリーのレジストリー設定を照会します。
コマンド:
  dsmcutil query /name:"TSM Central Scheduler Service"

Query CAD

クライアント・アクセプター・サービスのレジストリー値を照会します。 このコマンドの必須オプションは /name:service_name です。 その他の有効なオプションは次のとおりです。

  • /machine:マシン名
  • /node
  • /optfile
  • /httpport
  • /webports
  • /clientdir
  • /partnername
注: これらのオプションには値を指定しないでください。
タスク
指定したクライアント・アクセプター・サービスのレジストリー設定を照会します。
コマンド:
  dsmcutil query cad /name:"TSM CAD"

Query Journal

Windows システム上のジャーナル・エンジン・サービス TSM Journal Serviceを照会します。 このコマンドには有効なオプションがありません。

タスク
ジャーナル・エンジン・サービス TSM Journal Serviceを照会します。
コマンド:
  dsmcutil query journal

Query REMOTEAgent

リモート・クライアント・エージェント・サービスのレジストリー値を照会します。 このコマンドの必須オプションは /name:service_name です。 その他の有効なオプションは次のとおりです。

  • /machine:マシン名
  • /node
  • /optfile
  • /partnername
  • /clientdir
注: これらのオプションには値を指定しないでください。
タスク
指定されたリモート・クライアント・エージェント・サービスの レジストリー設定値を照会します。
コマンド:
  dsmcutil query remoteagent /name:"TSM AGENT"

List

インストール済みのクライアント・サービスをリストします。 必須オプションはありません。

タスク
ローカル・ワークステーション上にインストール済みバックアップ/アーカイブ・クライアント・サービスを探して、リストします。
コマンド:
  dsmcutil list
タスク
リモート・ワークステーション PDC 上にインストールされたバックアップ/アーカイブ・クライアント・サービスをリストします。
コマンド:
  dsmcutil list /MACHINE:PDC

START

Start コマンドは、クライアント・サービスの開始に使用します。 Start コマンドには /name:service_name オプションが必要です。

タスク
ジャーナル・エンジン・サービス TSM Journal Serviceを開始します。
コマンド:
  dsmcutil start /name:"TSM Journal Service"

STOP

Stop コマンドは、クライアント・サービスの停止に使用します。 Stop コマンドには /name:service_name オプションが必要です。

タスク
ジャーナル・エンジン・サービス TSM Journal Serviceを停止します。
コマンド:
  dsmcutil stop /name:"TSM Journal Service"

UPDATEPW

暗号化された IBM Storage Protect パスワードを生成します。 UPDATEPW コマンドには、/node:node_name、/password:password、および /commserver:server_name の各オプションが必要です。 clusternode オプションが YES に設定されている場合、/optfile: パラメーターも必要です。

次のオプションを任意で使用することができます。

  • /validate:はい | いいえ
  • /clusternode:Yes | No (MSCS または VCS を実行している場合は必須)。
  • /clustername:cluster_name (MSCS または VCS を実行している場合は必須)。
  • /force:はい | いいえ
  • /optfile: (非クラスター操作の場合)
  • /commmethod:
  • /commport:

/validate:Yes が指定されている場合、パスワードは IBM Storage Protect サーバーで検証されます。 /updateonserver:Yes が指定されていると、パスワードはサーバー上で更新されます。 このオプションを指定するときは、/oldpassword: オプションを付けて現行パスワードを指定する必要があります。

タスク
指定されたノードの暗号化されたパスワードを更新します。 指定されたホスト名「 TCP/IP 」およびポートにある、指定された IBM Storage Protect サーバーのパスワードを検証し、更新します：
コマンド:
  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

管理者以外のユーザーに対し、backup-archiveクライアントの IBM Storage Protect パスワードおよびクライアントの SSL 証明書へのアクセス権を付与します。

IBM Storage Protect8.1.2以降では、Windows オペレーティング・システム上のIBM Storage Protectパスワード・ストレージについて、より厳密なアクセス制御が実施されます。 デフォルトでは、Administrator、SYSTEM、または LocalSystem アカウントのみがパスワード・ストアおよび SSL 証明書へのアクセス権を持っています。

この addace コマンドを使用すると、アクセス制御リストを変更して、管理者以外のユーザーや、Data Protectionクライアントプロセス IBM Storage Protect などのプロセスが、パスワードストアや SSL 証明書にアクセスできるようにすることができます。

以下のオプションは必須です。
  • -entity:user | group
  • -object:ALL | NODENAME | path\TSM.* | path\spclient.*
ここで:
ユーザー | グループ
パスワード・ストアに対する読み取り/書き込み権限が付与されている Windows ユーザーまたはユーザー・グループ。
すべて
ディレクトリ C:\ProgramData\Tivoli\TSM\baclient のサブディレクトリにあるすべてのパスワードファイルおよび SSL 証明書へのアクセス権を付与します。
NODENAME
この C:\ProgramData\Tivoli\TSM\baclient\Nodes\nodename ディレクトリのサブディレクトリ内にあるすべてのパスワードファイルおよび SSL 証明書へのアクセス権を付与します。
path\TSM.* | path\spclient.*
共有リソース・ディレクトリーに存在することができるクラスター・パスワードに対して、ノードの特定のディレクトリー内のパスワード・ファイルまたは証明書ファイルへのアクセス権を付与します。
Windows 上のセキュア・パスワード・ロケーションについて詳しくは、 セキュア・パスワード・ストレージを参照してください。
ヒント： この dsmcutil deleteace コマンドを実行すると、パスワードファイルおよび SSL 証明書へのアクセス権が取り消されます。
タスク
Alpha1管理者としてバックアップ・アーカイブ・クライアントをインストールおよび設定した後、Windows システム上の非管理者ユーザーであるスーザンに、クライアント・ノード上のパスワード・ファイルおよび SSL 証明書へのアクセス権を付与する必要があります。
コマンド:
  dsmcutil addace -entity:Susan -object:Alpha1
タスク
IBM Storage Protect for Databases: Data Protection for Microsoft SQL Server の非管理ユーザーが IBM Storage Protect パスワードを構成しましたが、管理者もパスワードにアクセスする必要があります。 Data Protection for Microsoft SQL Serverユーザーは以下のコマンドを発行して、パスワード・ファイルへのアクセス権を管理者に付与します。
コマンド:
  dsmcutil addace -entity:Administrator -object:all
タスク
クラスタ構成を行う際、Windows 管理者は、クラスタノード clusnode_A がクライアントの SSL 証明書にアクセスできるようにする必要があります。
コマンド:
  dsmcutil addace -entity:Group_A 
  -object:C:\ProgramData\Tivoli\TSM\baclient\Nodes\clusnode_A\spclient.*
クライアント証明書がデフォルトの場所 (C:\ProgramData\Tivoli\TSM\baclient\Nodes\clusnode_A\) にない場合、それらの証明書は dsm.opt ファイルと同じディレクトリーにあります。

DELETEACE

管理者以外のユーザーに対する、backup-archiveクライアントの IBM Storage Protect パスワードおよびクライアントの SSL 証明書へのアクセス権を無効にします。

deleteace コマンドを使用してアクセス制御リストを変更し、ユーザー (非管理ユーザーなど) またはプロセス ( IBM Storage Protect Data Protection クライアント・プロセスなど) のパスワード・ストアおよびクライアント証明書へのアクセス権限を削除できます。

以下のオプションは必須です。
  • -entity:user | group
  • -object:ALL | NODENAME | path\TSM.* | path\spclient.*
ここで:
ユーザー | グループ
パスワード・ストアおよびクライアント証明書へのアクセスが削除される Windows ユーザーまたはユーザー・グループ。
すべて
ディレクトリ C:\ProgramData\Tivoli\TSM\baclient のサブディレクトリ内にあるすべてのパスワードファイルおよび SSL 証明書へのアクセス権を削除します。
NODENAME
ディレクトリ C:\ProgramData\Tivoli\TSM\baclient\Nodes\nodename のサブディレクトリ内にあるすべてのパスワードファイルおよび SSL 証明書へのアクセス権を削除します。
path\TSM.* | path\spclient.*
共有リソース・ディレクトリーに存在することができるクラスター・パスワードに対して、ノードの特定のディレクトリー内のパスワード・ファイルまたは証明書ファイルへのアクセス権を除去します。
Windows 上のセキュア・パスワード・ロケーションについて詳しくは、 セキュア・パスワード・ストレージを参照してください。
ヒント： この dsmcutil addace コマンドを使用すると、パスワードファイルや SSL の証明書にアクセスできます。
タスク
非管理ユーザーである Susan は 2 日前に退社したため、管理者は、クライアント・ノード Alpha1 上のパスワード・ファイルおよび SSL 証明書に対するアクセス権を取り消す必要があります。
コマンド:
  dsmcutil deleteace -entity:Susan -object:Alpha1
タスク
クラスター・ノード clusnode_Z は、クラスター構成から外されたため、クライアント SSL 証明書にアクセスする必要がなくなりました。 次のコマンドを発行して、clusnode_Z のアクセス権を除去します。
コマンド:
  dsmcutil deleteace -entity:Group_Z
  -object:C:\ProgramData\Tivoli\TSM\baclient\Nodes\clusnode_Z\spclient.*
クライアント証明書がデフォルトの場所 (C:\ProgramData\Tivoli\TSM\baclient\Nodes\clusnode_Z\) にない場合、それらの証明書は dsm.opt ファイルと同じディレクトリーにあります。