Chat now with support
Chat with Support

NetVault 11.3 - リファレンス・ガイド

前書き はじめに コマンドライン・ユーティリティの使用
クライアント固有ユーティリティ デバイス固有ユーティリティ メディア固有ユーティリティ ジョブ固有ユーティリティ ログ固有ユーティリティ その他のユーティリティ
nvreportユーティリティの使用

nvsetmodify

説明

セットを修正します。

構文
nvsetmodify -setname <set name> -type <set type> -change <change description>
[-parameters <parameter file>] [-assign <assignment character>]
[-delimit <delimiter character>] [-version]
オプション
 
表76. nvsetmodify
オプション
説明

-setname

修正するセットの名前を指定します。

-type

セット・タイプを指定します。以下のいずれかを指定できます。

•
BS：バックアップ・セレクション・セット
•
BO：バックアップ・オプション・セット
•
RS：リストア・セレクション・セット

nvsetmodifyユーティリティは、以下のセット・タイプをサポートしていません。

•
S：スケジュール・セット
•
BT：バックアップ・ターゲット・セット
•
AB：バックアップ詳細設定セット
•
AR：リストア詳細設定セット

上記のセットを修正するには、以下の方法を使用します。

•
nvsetcreateユーティリティを使用して、同じ名前でセットを作成します。このユーティリティにより、既存のセットが上書きされます。
•
NetVault WebUIを使用してセットを修正します。

-change

変更内容を指定します。このオプションは、複数回使用できます。<change description>変数の書式は次のとおりです。

<item>[:<field>][:<old value>]=<new value>

<item>には、次のいずれかの値を設定できます。

<field>には、アイテム内の修正するフィールドを指定します。

<old value>には、選択したアイテムの古い設定を指定します。

<new value>には、選択したアイテムの新しい設定を指定します。

以下のアイテムを変更します。

•
tree：セレクション・ツリー内のアイテムを変更します。treeアイテムは、バックアップ・セレクション・セットとリストア・セレクション・セットにのみ適用されます。treeアイテムの場合、<field>変数には次のいずれかの値を設定できます。
– path：詳細は、「path」を参照してください。
– rename：詳細は、「rename」を参照してください。
– info：詳細は、「info」を参照してください。
– 含める<ノード名>または<ID>：詳細は、「<Node Name>または<ID>」を参照してください。

 
•
オプション：リストア・オプションを追加または修正します（プラグインでリストア・オプションが提供されている場合）。
このオプションを使用するには、設定するオプションの「タグID」が必要です。タグIDには、CLIが認識するバックアップ・オプション名か、NetVault Backupによってオプションに割り当てられている数値のいずれかを指定できます。これらの値はどちらも、nvsetmodify.cfgファイルの［プラグイン・オプション］セクションでグループ分けされています。
このオプションの指定時の形式は、以下のとおりです。
Options:<Tag ID>=True/False
•
Target：ターゲット・ツリー内のアイテムを変更します（リストア・セレクション・セットのみ）。
<field>変数を使用して、変更するタイプを指定します。指定可能な値は、有効なNetVault Backupクライアント名のみです。<new value>には、新しいターゲット・クライアントを指定します。
メモ： <new value>変数を指定しないと、<old value>で選択または省略されている値はすべて、コマンドの実行時に選択解除されているものと見なされます。

 

path

クライアント名、プラグイン名、またはセレクション・パス内の単一のノードを変更します。パスを変更するには、<old value>変数と<new value>変数を次のように設定する必要があります。

•
Client:
<old value> = 現在のNetVault Backupクライアントの名前
<new value> = 新規のNetVault Backupクライアントの名前クライアントがNetVault Backupサーバーに追加されていることを確認します。
•
プラグイン：
<old value> = 現在のNetVault Backupプラグインの名前
<new value> = 新規のNetVault Backupプラグインの名前。セットが定義されているNetVault Backupサーバーまたはクライアントに新規のプラグインがインストールされていることを確認します。
•
セレクション・パス：
<old value> = プラグインのルート・ノードから変更するノードまでのフル・パス。パス区切り文字には、クライアントOSによって、バックスラッシュ（\）文字（Windowsの場合）またはスラッシュ（/）文字（Linux/UNIXの場合）を使用します。
<new value> = 新規ノードの名前

 
例：
Plug-in for FileSystemのバックアップ・セレクション・セットには、Windowsの次のセレクション・パスが含まれます。
Fixed Drives\C:\work\t1\dump\a
このパス内のディレクトリ「t1」を「t2」に変更する場合は、2つの変数を次のように設定します。
<old value> = Fixed Drives\C:\work\t1
<new value> = t2
 
Linuxクライアントでは、Plug-in for FileSystemには事前定義のレベル3ノード（“Fixed Drives”や“Removable Drives”など）は含まれません。したがって、Linux/UNIXクライアント上の同様のセレクションには、次のノードが含まれます。
/work /t1/dump/a
このパス内のディレクトリ「t1」を「t2」に変更する場合は、2つの変数を次のように設定します。
<old value> =/work/t1
<new value> =t2

 

rename

リストア・セレクション・セットに対して、名前変更または移動コマンドの追加または変更を実行します。

•
名前変更または移動コマンドを追加するには、2つの変数を次のように設定します。
<old value> = 名前変更または移動ターゲットの現在の名前またはパス
<new value> = 名前変更または移動ターゲットの新規の名前またはパス
•
既存の名前変更または移動コマンドを変更するには、2つの変数を次のように設定します。
<old value> = 現在の名前変更/移動構文
<new value> = 新規の名前変更/移動構文

 

info

セレクション・ツリーのノードに結合されるプラグイン情報オブジェクトを変更します。このオプションを使用するには、2つの変数を次のように設定します。

<old value> = プラグインのrootノードからアプリケーション・アイテムまでのフル・パス。
<new value> = コロン（:）で区切られた、プラグイン情報オブジェクトの新規の値。変更しないフィールドがある場合は、新規の値として二重コロン（::）を指定します。

 

<Node Name>または<ID>

バックアップまたはリストア・ジョブにアイテムを含めます。CLIによって認識される「ノード名」またはNetVault Backupによってノードに割り当てられた数値「ID」のどちらかを指定します。どちらの値もnvsetmodify.cfgファイルの[Tree Nodes]セクションの下にまとめて記述されています。

このオプションを使用するには、2つの変数を次のように設定します。

<old value> = 現在のノードのノード名またはノードID。ターゲットNetVault Backupクライアントのセレクション・ツリーに指定したタイプのノードが複数含まれている場合は、ノードIDの代わりにノード名を指定します。
<new value> = 新規ルート・ノードのノード名またはノードID。

-parameters

パラメータ・ファイルからオプションを読み取ります。

パラメータ・ファイルは、任意のテキスト・エディタを使用して作成できます。1行に1つのオプションとその値を指定し、オプションの前の「-」は省略します。オプションと値を区切るには、スペースまたはタブを使用します。コメントを含めるには、その行の先頭に「#」文字を付けます。

例：

# nvsetmodify example file

setname BackSet1

type BS

このファイルは、次のように、-parametersオプションと併用できます。

./nvsetmodify -parameters example.txt

-assign

変更の説明で使用する代入演算子を指定します。デフォルトの代入演算子は「=」文字です。古い値または新しい値に「=」文字が含まれている場合、このオプションを指定する必要があります。

-delimit

変更の説明で区切り文字として使用する文字を指定します。デフォルトの区切り文字は「:」文字です。古い値または新しい値に「:」文字が含まれている場合、このオプションを指定する必要があります。

-version

マシンにインストールされているNetVault Backupディストリビューションのビルド日付を表示します。

例
•
以下のコマンドは、NetVault Backupクライアントを「Client-A」から「Client-B」に変更するように、バックアップ・セレクション・セット「BS-Set1」を変更します。
nvsetmodify -setname BS-Set1 -type BS -change Tree:path:Client-A=Client-B
•
以下のコマンドは、プラグインを「File System」から「Data Copy」に変更するように、バックアップ・セレクション・セット「BS-Set1」を修正します。
nvsetmodify -setname BS-Set1 -type BS -change "Tree:path:File System=Data Copy"
•
以下のコマンドは、セレクション・パス「Fixed Drives\C:\work\t1\dump\a」のディレクトリ「t1」を「t2」に変更するように、バックアップ・セレクション・セット「BS-Set1」を修正します。
nvsetmodify -setname BS-Set1 -type BS
-change "Tree@path@Fixed Drives\C:\work\t1=t2" -delimit @
この例では、パスにデフォルトの区切り文字である「:」が含まれているため、-delimitオプションを使用して「@」を区切り文字として設定しています。
•
以下のコマンドは、セレクション・パス「/work/t1/dump/a」のディレクトリ「t1」を「t2」に変更するように、バックアップ・セレクション・セット「BS-Set1」を修正します。
nvsetmodify -setname BS-Set1 -type BS -change "Tree:path:/work/t1=t2"
•
以下のコマンドは、セレクション・パス「Fixed Drives\C:\work\t1\dump\a」のドライブ・ノード「C:\」を「D:\」に変更するように、バックアップ・セレクション・セット「BS-Set1」を修正します。
nvsetmodify -setname BackupSetName -type BS
-change "Tree@path@Fixed Drives\C:\=D:\\"-delimit @
この例では、新規の値D:\にバックスラッシュを余分に1つ追加して、最初のバックスラッシュ文字をエスケープしています。このバックスラッシュを追加しないと、D:\”という文字シーケンスは、D:”と解釈されます。なぜなら、最初のバックスラッシュが引用符（"）のエスケープに使用されるからです。
•
以下のコマンドは、ネットワーク共有のパスを「\\Server1\a」から「\\Server2\b」に変更するように、バックアップ・セレクション・セット「BS-Set1」を修正します。
nvsetmodify -setname BackupSetName -type BS
-change "Tree@path@Network Shares\\\Server1\a\=\\Server2\b\\" -delimit @
•
以下のコマンドは、「Fixed Drives」ノードを「Removable Drives」に変更するように、バックアップ・セレクション・セット「BS-Set1」を修正します。
nvsetmodify -setname BackupSetName -type BS
-change "Tree:path:Fixed Drives=Removable Drives"
 
* 
メモ： Plug-in for FileSystem（Windowsのみ）、およびその他のいくつかのプラグイン（Plug-in for Consolidation、Plug-in for Data Copy、Plug-in for Databases、およびPlug-in for Raw Devices）には、事前定義のレベル3ノードが含まれます。これらのノードの正式名は、NetVault WebUIで取得できます。ユーザー・エラーを防ぐため、nvsetmodifyユーティリティでは、レベル3ノードに指定された新規の値が正しいかどうかをチェックします。これらのノードに間違った値を指定すると、エラー・メッセージが表示されます。レベル3より下位のノードについては、正しいかどうか、存在するかどうかのチェックは行われません。
•
以下の変更を行うように、（Plug-in for FileSystem用に作成された）リストア・セレクション・セット「RestoreSet1」を修正します。
•
ターゲット・クライアントを「WinClient1」から「WinClient2」に変更
•
ディレクトリ「C:\Mail」を「C:\MyMail」に移動
•
［最新ファイルを上書き］リストア・オプションを設定
nvsetmodify -setname RestoreSet1 -type RS
-change target:client:WinClient1=WinClient2
-change options:nvfs_opt_overnew=true -change @tree@path@c:\mail=c:\MyMail

nvtrigger

説明

Triggeredスケジュール・オプションを使用して定義および保存されているジョブをトリガします。

このユーティリティはbinディレクトリにあります。

構文
nvtrigger [-server <server name>] [-wait] [-verbose] [-killonexit] <trigger name>
オプション
 
表77. nvjobstart
オプション
説明

-servername

ジョブを管理するNetVault Backupサーバー名を指定します。

このオプションは、リモート・サーバーがジョブを管理する場合に必要になります。ジョブを管理するのがローカル・サーバーの場合は、このオプションを省略できます。サーバー名では、大文字と小文字を区別します。

-wait

タスクが完了するまで待機します。

-verbose

ジョブの開始および終了時に追加情報を表示します。

ジョブの開始時には、ジョブID、インスタンスID、ジョブ・タイトル、開始時刻などの詳細情報が表示されます。ジョブの終了時には、終了時刻が表示されます。

-killonexit

トリガ実行を終了してジョブを中止します。このオプションは、-waitオプションと共に使用する必要があります。

<trigger name>

トリガ名を指定します。次の例に示すとおり、ツールを呼び出す際に、このオプションを最後に指定する必要があります。

nvtrigger -server <server name> -wait -verbose -killonexit <triggername>

注意
•
nvtriggerユーティリティは、関連付けられているジョブが完了すると、次の終了コードとメッセージを返します。
•
0: バックアップの完了
•
1: バックアップが失敗した
•
2: バックアップが警告と共に完了
•
3: バックアップの中止
•
-waitオプションを指定しない場合、nvtrigger ユーティリティは複数のジョブをサポートできます。このオプションを指定した場合、このユーティリティを使用してトリガできるのは1つのジョブだけです。この制限は、-wait -killonexitオプションにも適用されます。したがって、複数のジョブ定義を含むポリシー・ジョブにこのオプションを使用することはできません。
•
-waitオプションをスクリプトで指定すると、トリガされたジョブの完了後にのみ、スクリプトに制御が戻ります。このオプションを指定しないと、トリガされたジョブが実行中であっても、スクリプトに即座に制御が戻ります。

ログ固有ユーティリティ

 
•
nvlogdump
•
nvlogpurge
•
nvreadlog

nvlogdump

説明

NetVault Backupログをテキスト・ファイルまたはバイナリ・ファイルにダンプします。

構文
nvlogdump [-jobid <Job ID>] [-filename <Dump File>] [-text]
[-starttime <Start Time>] [-endtime <End Time>]
オプション
 
表78. nvlogdump
オプション
説明

-jobid

ログのエクスポートの対象となるジョブIDを指定します。

-filename

ログのエクスポート先のファイルの名前を指定します。

選択したダンプ形式に応じて、<NetVault Backup home>\logs\dumps（Windows）または<NetVault Backup home>/logs/dumps（Linux）下にあるbinaryまたはtextディレクトリにダンプ・ファイルが作成されます。

-filenameオプションを省略すると、指定された形式でCLI_DUMP_<YYYYMMDD>_<HHMMSS>という名前のファイルが作成されます。バイナリ・ファイルには、.nlgという拡張子が使用されます。テキスト・ファイルには拡張子はありません。

-text

テキスト形式でログをエクスポートします。このオプションを省略すると、ログはバイナリ形式で出力されます。

-starttime

ログ・ダンプの開始点として使用される時刻を指定します。開始時刻の書式は、YYYYMMDDHHMMSSです。

-endtime

ログ・ダンプの終了点として使用される時刻を指定します。終了時刻の書式は、YYYYMMDDHHMMSSです。

注意

このユーティリティを正しく使用するには、少なくとも、jobidオプション、またはstarttimeオプションとendtimeオプションの組み合わせを指定する必要があります。jobid、starttime、endtimeの各オプションを組み合わせて指定することで、特定の期間内に生成された特定のジョブのログをダンプできます。

例
•
以下のコマンドは、ジョブID 50の2014年8月1日20時33分04秒からのログをバイナリ・ファイル「nvlogdmp.nlg」にダンプします。
nvlogdump -filename c:\temp\nvlogdmp -starttime 20140801203304 -jobid 50
Related Documents