chdev

用途

chdevコマンドは、構成済のテープ・ドライブまたはテープ・ライブラリの属性を変更する場合に使用します。テープ・デバイスを構成する場合は、mkdevコマンドを使用します。

関連項目:

関連コマンドについては、「デバイス用コマンド」を参照してください。

前提条件

chdevコマンドを使用するには、管理ドメインの構成の変更（modify administrative domain's configuration）権を備えている必要があります。

構文1

テープ・ドライブを再構成する場合は、次の構文を使用します。

chdev::=

chdev [ --attach/-a aspec[,aspec]... ]
[ --addattach/-A aspec[,aspec]... ] [ --rmattach/-R aspec[,aspec]... ]
[ --inservice/-o | --notinservice/-O ] [ --wwn/-W wwn ]
[ --library/-l devicename ] [ --dte/-d dte ]
[ --ejection/-j etype ]
[ --minwriteablevolumes/-m n ]
[ --blockingfactor/-f bf ] [ --maxblockingfactor/-F maxbf ]
[ --automount/-m { yes | no }  ] [ --erate/-e erate ]
[ --current/-T se-spec ] [ --uselist/-u se-range ]
[ --usage/-U duration ] [ --queryfreq/-q queryfrequency ]
[ --serial/-N serial-number ] [ --updateserialnumber/-S ]
[ --model/-L model-name ]
devicename...

構文2

テープ・ライブラリを再構成する場合は、次の構文を使用します。

chdev::=

chdev [ --attach/-a aspec[,aspec]... ]
[ --addattach/-A aspec[,aspec]... ][ --class/-x vtl ]
[ --rmattach/-R aspec[,aspec]... ]
[ --inservice/-o | --notinservice/-O ][ --wwn/-W wwn ]
[ --autoclean/-C { yes | no } ][ --cleanemptiest/-E { yes | no } ]
[ --cleaninterval/-i { duration | off } ]
[ --barcodereader/-B { yes | no | default } ]
[ --barcodesrequired/-b { yes | no } ] [ --unloadrequired/-Q { yes | no } ]
[ --serial/-N serial-number ] [ --model/-L model-name ]
devicename...

意味1および2

次のオプションは、テープ・ドライブまたはテープ・ライブラリを再構成する場合に使用できます。ここに記載されていないオプションについては、「mkdev」を参照してください。

--addattach/-A aspec

テープ・ドライブまたはテープ・ライブラリのデバイスの添付ファイルを追加します。aspecプレースホルダの詳細は、「aspec」を参照してください。

--class/-x vtl

VTLとしてライブラリ・クラスを指定します。

--rmattach/-R aspec

テープ・ドライブまたはテープ・ライブラリのデバイスの添付ファイルを削除します。aspecプレースホルダの詳細は、「aspec」を参照してください。

--uselist/-u se-range

このデバイスが使用できる記憶域要素の範囲を指定します。このオプションが適用されるのは、テープ・ライブラリに搭載されているテープ・ドライブのみです。

デフォルトでは、テープ・ライブラリ内のすべてのテープ・ドライブからテープ・ライブラリ内のすべてのテープにアクセスすることが可能になります。バックアップを同時実行する複数のテープ・ドライブを搭載するライブラリでは、複数のテープの使用をパーティション化する必要があります。

たとえば、記憶域要素の前半にある各テープを1番目のテープ・ドライブで使用し、後半にある各テープを2番目のテープ・ドライブで使用する場合です。あるいは、単一のテープ・ドライブ上で様々なタイプのバックアップ用にいろいろな使用リストを設定する場合です。

テープ・デバイスのuselist値に対する変更は、chdevコマンドを入力したときに実行されるジョブでは認識されません。たとえば、ジョブが使用可能なボリューム不足のため保留されている場合に、chdev --uselistコマンドで記憶域要素を追加することによってジョブを再開することはできません。chdev操作は成功しますが、ジョブは保留されたままです。chdevの変更を有効にするには、ジョブを取り消して再起動する必要があります。

se-rangeプレースホルダの詳細は、「se-range」を参照してください。

--usage/-U duration

テープ・ドライブが最後にクリーンアップされてから使用されてきた期間を指定します。durationプレースホルダの詳細は、「duration」を参照してください。

特定の間隔のクリーンアップ・サイクルをリクエストする場合は、mkdevコマンドを使用します。構成済の間隔を初期化し、最後のクリーンアップ以降のテープ・ドライブの使用状況を反映するには、chdevに--usageオプションを指定します。

--ejection/-j etype

テープを取り出す方法を指定します。値は、automatic、ondemandまたはmanualです。

--minwriteablevolumes/-m n

Oracle Secure Backupが初期のボリューム・ローテーションを開始するまでの、書込み可能なボリュームの最小数に対するしきい値を指定します。

--serial/-N serial-number

テープ・デバイスのシリアル番号を指定します。

明示的にシリアル番号をmkdevコマンドで入力した場合、Oracle Secure Backupはこのシリアル番号をデバイス・オブジェクトに保存します。シリアル番号の引数をNULL（''）に指定した場合、Oracle Secure Backupはデバイスを開いて、デバイスからシリアル番号を読み取ってデバイス・オブジェクトにこの番号を保存します。

checkserialnumbersポリシーが有効である場合、テープ・ライブラリ内の故障したテープ・ドライブを交換するときなど、テープ・デバイスのハードウェアを変更したときには必ず、chdev --serialコマンドとともにシリアル番号を入力する必要があります。デバイス・オブジェクトが作成されたときにシリアル番号が入力されていない場合でも、番号を入力する必要があります。

関連項目:

「checkserialnumbers」

--updateserialnumber/-S

引数がNULLの--serialと意味的に同等です。Oracle Secure Backupはデバイスを開いて、デバイスからシリアル番号を読み取ってデバイス・オブジェクトにこのシリアル番号を保存します。

devicename

再構成するテープ・ライブラリまたはテープ・ドライブの名前を指定します。テープ・デバイス名の命名規則については、「devicename」を参照してください。

構文3

ACSLSテープ・ライブラリに内包されるテープ・ドライブの構成を変更する場合は、次の構文を使用します。

chdev::=

chdev [ --attach/-a aspec ] [ --inservice/-o | --notinservice/-O ]
[ --wwn/-W wwn ] [ --library/-l devicename ]
[ --lsm/s lsm_id ] [ --panel/p panel_id ] [ --drive/r drive_id ]
[ --blockingfactor/-f bf ] [ --maxblockingfactor/-F maxbf ]
[ --erate/-e erate ] [ --queryfreq/-q queryfrequency ]
devicename...

意味3

ACSLSテープ・ライブラリに内包されるテープ・ドライブの構成を変更する場合は、次の意味を使用します。ここに記載されていないオプションについては、「意味1および2」を参照してください。

--lsm/-s lsm_id: このオプションは、ACSLSライブラリに内包されるテープ・ドライブに対してのみ使用します。このテープ・ドライブが存在するACSライブラリ・ストレージ・モジュールのIDを定義します。
--panel-p panel_id: このオプションは、ACSLSライブラリに内包されるテープ・ドライブに対してのみ使用します。このテープ・ドライブが存在するパネルのIDを定義します。
--drive -r drive_id: このオプションは、ACSLSライブラリに内包されるテープ・ドライブに対してのみ使用します。このテープ・ドライブが存在するドライブのIDを定義します。

構文4

ACSLSテープ・ライブラリを再構成する場合は、次の構文を使用します。

chdev::=

chdev [ --attach/-a aspec ] [ --inservice/-o | --notinservice/-O ]
[ --userid/-n acs-userid ] [ --acsid/-g acs_id ] [ --port/-P port_num ]
[ --ejection/-j etype ] [ --minwritablevolumes/-V minvols ]
library_devicename...

意味4

ACSLSテープ・ライブラリを再構成する場合は、次の意味を使用します。ここに記載されていないオプションについては、「意味1および2」を参照してください。

--attach/-a aspec ...: ACSLSテープ・ライブラリに対するOracle Secure Backupメディア・サーバーおよびACSLSサーバーを指定します。aspecの書式は、mediaservhostname:acslshostです。
--userid/-n acs_userid: ACSLSアクセス制御ユーザー名を指定します。この値はオプションです。指定した場合、ACSLSサーバーとのやりとりにはすべてこのアクセス名が前に付きます。
--acsid/-g acs_id: 制御するACSLSテープ・ライブラリのASC ID値を指定します。
--port/-P port_num: ACSLSサーバー・ソフトウェアのリスニング・ポートを指定します。通常、この値は0か、または指定しません。このオプションを指定する必要があるのは、ACSLSサーバーがファイアウォールの内側にある場合のみです。

構文5

シンボリック名をACSLSテープ・ライブラリ内のACSカートリッジ・アクセス・ポート（CAP）と関連付ける場合は、次の構文を使用します。

chdev::=

chdev [ --library/-L devicename ]
[ --lsm/s lsm_id ] [ --capid/-c cap_id ]
capname

意味5

シンボリック名をACSLSテープ・ライブラリ内のACSカートリッジ・アクセス・ポート（CAP）と関連付ける場合は、次の意味を使用します。

--library/-L devicename: CAPが存在するテープ・ライブラリの名前を指定します。省略した場合は、library変数が使用されます。library変数が見つからない場合や指定されていない場合は、エラー・メッセージが表示されます。
--capid/-c cap_id: 選択されたテープ・ライブラリ内のCAPのハードウェアの場所を指定します。
--lsm/-s lsm_id: 選択されたテープ・ライブラリ内のCAPのACSライブラリ・ストレージ・モジュールを指定します。
capname: 作成されるOracle Secure Backup CAPオブジェクトの名前。

例

例2-18 テープ・ドライブの再構成

この例では、ライブラリlib1のテープ・ドライブtape1を再構成します。このchdevコマンドには次が指定されています。

このテープ・ドライブがサービス中であること。
エラー率は16であること（デフォルトは8）。
ブロッキング・ファクタは256である（すなわち、サイズが128KBのブロックが書き込まれる）こと。
テープは自動マウントできること。

コマンドラインはページに収まるようにあらかじめ折り返されています。

ob> lsdev --long tape1
tape1:
    Device type:            tape (virtual)
    Model:                  [none]
    Serial number:          [none]
    In service:             yes
    Library:                lib1
    DTE:                    1
    Automount:              yes
    Error rate:             8
    Query frequency:        [undetermined]
    Debug mode:             no
    Blocking factor:        (default)
    Max blocking factor:    (default)
    Current tape:           4
    Use list:               all
    Drive usage:            33 seconds
    Cleaning required:      no
    UUID:                   42e073da-5a39-1028-92bf-000cf1d9be50
    Attachment 1:
        Host:               brhost3
        Raw device:         /dev/tape1
ob> chdev --type tape --erate 16 --blockingfactor 256
--maxblockingfactor 256 tape1

例2-19 テープ・ライブラリの再構成

この例では、テープ・ライブラリlib1を再構成しています。このchdevコマンドには次が指定されています。

このテープ・ドライブがサービス中であること
バーコード・リーダーはないこと。
自動クリーンアップ・サイクルの間隔は30時間であること
obtoolでは、クリーンアップにクリーニング・テープ全体を使用すること。

コマンドラインはページに収まるようにあらかじめ折り返されています。

ob> lsdev --long --nohierarchy lib1
lib1:
    Device type:            library
    Model:                  [none]
    Serial number:          [none]
    In service:             yes
    Debug mode:             no
    Barcode reader:         default (hardware-selected)
    Barcodes required:      no
    Auto clean:             no
    Clean interval:         (not set)
    Clean using emptiest:   no
    UUID:                   f088f234-8d46-1027-90e1-000cf1d9be50
    Attachment 1:
        Host:               brhost3
        Raw device:         /dev/lib1
ob> chdev --type library --inservice --barcodereader no --barcodesrequired no
--autoclean yes --cleanemptiest no --cleaninterval 30hours lib1
ob> lsdev --long --nohierarchy lib1
lib1:
    Device type:            library
    Model:                  [none]
    Serial number:          [none]
    In service:             yes
    Debug mode:             no
    Barcode reader:         no
    Barcodes required:      no
    Auto clean:             yes
    Clean interval:         30hours
    Clean using emptiest:   yes
    UUID:                   f088f234-8d46-1027-90e1-000cf1d9be50
    Attachment 1:
        Host:               brhost3
        Raw device:         /dev/lib1