目的
既存のダンプ・レベルに有効期限を設定します。
構文
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 コマンドを使用します。)
有効期限は、絶対値で定義することも、相対値で定義することもできます。
このコマンドによってダンプ・レベルに設定されている有効期限を変更すると、新しい日付は、この変更後に作成されたダンプにのみ適用されます。既存のダンプの有効期限は、その作成時に設定された日付のまま変更されません。
オプション
[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 つだけ指定してください。 |
例
次の例は、ダンプ・レベル /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 としてサーバー・マシンにログオンする必要があります。
関連情報