管理解説書

backup setexp

目的

既存のダンプ・レベルに有効期限を設定します。

構文

backup setexp -dump <dump level name>⁺  [-expires <expiration date>⁺]
              [-localauth]  [-cell <cell name>]  [-help]
  
backup se -d <dump level name>⁺  [-e <expiration date>⁺]
          [-l]  [-c <cell name>]  [-h]

構文

backup setexp コマンドは、指定された各ダンプ・レベルに関連付けられている有効期限を設定したり、変更したりします。このダンプ・レベルは、ダンプ階層内に存在していなければなりません。

-expires 引き数を使用すると、各ダンプ・レベルに有効期限を設定することができます。バックアップ・システムは、以後ダンプ・レベルでダンプを作成すると、指定された値を使用して、ダンプの有効期限を導き出します。バックアップ・システムは、これを磁気テープのラベル (またはバックアップ・データ・ファイル) に記録します。バックアップ・システムは、磁気テープに含まれる任意のダンプの最新の有効期限まで、 backup labeltape コマンドを使用して磁気テープに再びラベルが付けられない限り、磁気テープの上書きを拒否します。ダンプ・レベルに有効期限がない場合、バックアップ・システムは、ダンプを作成してすぐに、作成されたダンプを有効期限切れとして処理します。

(バックアップ・システムは、ダンプの有効期限が来ると、ダンプ・レコードをバックアップ・データベースから自動的に除去することに注意してください。ただし、ダンプを含む磁気テープがリサイクルされるか、磁気テープに再度ラベルが付けられる場合に限ります。有効期限切れまたはすでに使用されていないダンプを除去するには、 backup deletedump コマンドを使用します。)

有効期限は、絶対値で定義することも、相対値で定義することもできます。

有効期限を絶対値で定義する場合には、ダンプが実行される時刻を月/日/年 (オプションで時、分) で指定することができます。有効期限がダンプ作成時刻より前になっている場合、バックアップ・バックアップは即時にダンプを有効期限切れとして処理します。
有効期限を相対値で定義する場合には、ダンプ作成日からの経過時間を年数、月数、日数 (またはこの 3 つの組み合わせ) で指定することができます。バックアップ・システムは、このレベルでダンプを作成すると、ダンプ操作の開始時間に相対的な時間を加えて、実際の有効期限を計算します。

このコマンドによってダンプ・レベルに設定されている有効期限を変更すると、新しい日付は、この変更後に作成されたダンプにのみ適用されます。既存のダンプの有効期限は、その作成時に設定された日付のまま変更されません。

オプション

-dump

-expires 引き数に指定された有効期限を設定する各ダンプ・レベルの全パス名を指定します。

-expires

絶対または相対有効期限を定義して、 -dump 引き数で指定された各ダンプ・レベルに関連付けます。絶対値で定義する場合には、次の形式で有効期限を定義します。

   [at] {NEVER | mm/dd/yyyy [hh:MM] }

この場合、任選択語 at の後には、文字列 NEVER (ダンプ・レベルで作成されたダンプの有効期限が切れないことを示す)、または必須部 (月は mm、日は dd、年は yyyy) を持つ日付値およびオプション部分 (時間は hh、分は MM) のいずれかが続きます。

hh:MM の部分は省略可能です。省略すると、デフォルトで 00:00 が使用されます。指定する場合には、24 時間形式で指定してください (たとえば、 8:30 p.m は 20:30)。年に指定できる値は、1970 から 2037 までです。 UNIX の標準表記では 2038 年 2 月までしか表現できないので、2037 より大きな値は無効になります。コマンド・インタープリターは、最大値から 1 を引いた値を自動的に割り当てます。

相対有効期限は、次の形式をしています。

   [in] [yearsy] [monthsm] [daysd]

この場合、任意選択語 in の後には、最低 1 つの年の数値 (最大で 9999) が続き、その後に、文字 y、月の数値 (最大で 12)、文字 m、または日の数値 (最大で 31)、文字 d が続きます。この 3 つのうち 2 つ以上を指定する場合には、上の順番どおり指定してください。ダンプの作成時刻に有効期限の相対値を加算した結果、 UNIX の時刻表現で可能な値を超えた場合には、バックアップ・システムは計算結果の日付を自動的に表現可能な最新日付に変更します。

注: コマンドの構文ステートメントは、二重引用符や他の区切り記号で囲む必要のない複数語の値を受け入れるため、その中にあるこの引き数には、正符号 (+) が付きます。このステートメントが複数日付を受け入れるからではありません。 -dump 引き数で指定された各ダンプ・レベルに関連付けられる日付 (任意選択で時刻) 定義は、 1 つだけ指定してください。

-localauth

ローカルの /usr/afs/etc/KeyFile ファイルのキーを使用して、サーバー・チケットを構成します。相互認証の間、 backup コマンド・インタープリターは、バックアップ・サーバー、ボリューム・サーバーおよび VL サーバーにこのチケットを提供します。このフラグは、-cell 引き数と一緒に使用してはなりません。詳細については、backup の解説ページを参照してください。

-cell

コマンドを実行するセルを指定します。この引き数は、 -localauth フラグと一緒に使用してはなりません。詳細については、backup の解説ページを参照してください。

-help

このコマンドのオンライン・ヘルプを出力します。これ以外の有効なオプションはすべて無視されます。

例

次の例は、ダンプ・レベル /1998/december に、有効期限を絶対値 (1999 年 12 月 31 日午後 10 時 00 分) で設定しています。

   % backup setexp -dump /1998/december -expires at 12/31/1999 22:00

次の例は、2 つのダンプ・レベル /monthly/week1 および /monthly/week2 に、有効期限を相対値 (7 日) で設定しています。

   % backup setexp -dump /monthly/week1 /monthly/week -expires 7d

必要となる特権

コマンドの発行者は、バックアップ・サーバーが実行されているすべてのマシン上の /usr/afs/etc/UserList ファイルにリストされていなければなりません。また、-localauth フラグを使用する場合は、ローカル・スーパーユーザー root としてサーバー・マシンにログオンする必要があります。

関連情報

[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]