cdb.rsrc: コンポーネントの管理

cdb.rsrc コマンドでは、一般的なコンポーネント管理処理を行うことができます。

cdb.rsrc.ci

特定のコンポーネントとそのソースオブジェクトをチェックインするには、cdb.rsrc.ci コマンドを使用します。このコマンドは、必ず以下のシナリオで使用します。

• 閲覧可能コンポーネント (たとえば、file コンポーネントまたは Weblogic EJB コンポーネント) をチェックインする必要がある場合。

  閲覧不能コンポーネントをチェックインする必要がある場合は、cdb.c.ci コマンドを使用します。コマンドとコマンド引数については、「cdb.c.ci」を参照してください。

• 単純コンポーネントのソースオブジェクトをチェックインする必要がある場合。

• 閲覧可能な複合コンポーネントの参照先コンポーネントをチェックインする必要がある場合。

cdb.rsrc.ci コマンドの呼び出しは、「チェックインジョブ」と見なされるため、チェックインジョブを管理する CLI コマンドで管理できます。たとえば、どの cdb.rsrc.ci コマンドが実行中であるのかを確認する場合は、cdb.cj.la コマンドを実行し、現在のチェックインジョブをすべて一覧表示します。cdb.rsrc.ci から返される compCheckInID 値を cdb.cj.lo の引数に指定して、特定のチェックインジョブのステータス情報を得ることもできます。

cdb.rsrc.cib

このコマンドはチェックインをバッチ処理するコマンドです。バッチファイルに記載されているすべてのコンポーネントをチェックインします。

バッチファイルの概要

rsrc.cib は、チェックインするコンポーネントが 1 行に 1 つずつ記載されたバッチファイルを操作します。バッチファイルを利用すると、大量のコンポーネントを 1 回のコマンド実行でチェックインできます。

バッチファイル内の各行は、単一のコンポーネントとしてチェックインされる、ローカルマシン上の単一のコンポーネントに対応しています。各行は、いくつかのフィールドをパイプ (|) で区切った形式になっています。一部のフィールドはオプションで、省略可能です。オプションフィールドを省略する場合も、rsrc.cib が各フィールドを正しく識別できるように、次のフィールドとの間にパイプ (|) を挿入する必要があります。

バッチファイルにはコメントを挿入できます。先頭にシャープ (#) が付いている行がコメント行になります。

以下の表では、バッチファイルの行の構文について説明します。

以下の表に、バッチファイルの各行の 4 番目のフィールドで、コンポーネントのプラットフォームを指定するために使用できる名前を一覧表示します。

バッチファイル内の行の例

この例では、ローカルファイル home/etc/myfile を、構成ファイルではなくSolaris 7 プラットフォームのコンポーネントタイプファイルとして、「this is my file 」という説明とともに、コンポーネント名 mypath/mycomponentname でチェックインします。この場合、バッチファイルに次のような行を入力します。

/home/myfile|mypath/mycomponentname|file|NM:Solaris 7|this is my file

チェックインするファイルが構成ファイルである場合は、行末にブール値のフィールドを追加し、true を指定します。次に例を示します。

/home/myfile|mypath/mycomponentname|file|NM:Solaris 7|this is my file|true 

mycomponent の説明を省略する場合は、この行を次のように変更します (パイプ区切りが 2 つ並んでいる点に注目)。

/home/myfile|mypath/mycomponentname|file|NM:Solaris 7||true

コンポーネントをメジャーバージョン (「2.0」のようなバージョン番号。「1.7」などは不可) としてチェックインするには、メジャーバージョンチェックインのブール値のフィールドに true を追加します。

/home/myfile|mypath/mycomponentname|file|NM:Solaris 7||true |true

チェックイン後も古いコンポーネントを非表示にしない場合は、上の行を次のように変更します (最後のフィールドに false が追加されている点に注目)。

/home/myfile|mypath/mycomponentname|file|NM:Solaris 7||true |true|false

アクセス許可情報を格納するとき所有者情報やグループ情報を含めるかどうかを指定するオプションのブール値にも、これと同じ書式上の規則が適用されます。

バッチファイルの構文

Sun N1 Service Provisioning System ソフトウェアは、バッチファイルの構文解析時に、次の規則を適用します。

• パス名が入るフィールドでは、スラッシュ (通常のスラッシュとバックスラッシュの両方) は常に、ネイティブファイルシステム上で使用されている規則に従って変換されます。

• ファイルのクラスタを視覚的に区分するために、空行を使用できます。

• フィールドの先頭または末尾の空白文字は削除できません。

• バッチファイルでは、絶対パスと相対パスの両方を使用できます。デフォルトでは、相対パスの基準はバッチファイルの格納場所になります。-pwdrelative フラグを使ってこの設定を無効にした場合、相対パスの基準は現在の作業ディレクトリになります。

呼び出し

テキストファイルを使ったバッチチェックイン処理は、次の形式の cdb.src.cib コマンドで呼び出します (“cib” は「check in batch (バッチチェックイン)」の頭文字)。

cdb.rsrc.cib -batchfile [batchfile location] [-haltonerror true|false]
[-pwdrelative true|false]

cdb.rsrc.cib コマンドは、コンポーネントのチェックインの前に、ファイルの構文チェックを行います。続いて、チェックインする予定のローカルファイルがすべて揃っていることを確認します。このどちらかのプロセスでエラーを検出した場合、cdb.rsrc.cib はエラーを報告し、実行を停止します。このとき、ブール引数 --haltonerror の設定は考慮されません。

haltonerror 引数

コマンド行にオプションの -haltonerror 引数を指定して (デフォルトは false)、エラーが検出されたファイル以降のファイルのチェックインを停止するかどうかを指定することができます。このブール引数は、cdb.rsrc.cib が予備エラーチェック (前の節で説明済み) を実行したあとのエラーにしか適用されません。

pwdrelative 引数

コマンド行にオプションの -pwdrelative プロビジョン (デフォルトは false) を指定して、バッチファイル内の相対パスの基準を現在の作業ディレクトリにするか (pwdrelative = true)、バッチファイルの格納場所にするか (pwdrelative = false) を指定することができます。

バッチファイル処理

バッチファイル処理は、トランザクション処理ではありません。したがって、バッチファイル処理に失敗したり、処理が途中で停止したりしても、問題の発生以前に正しくチェックインされたコンポーネントは、チェックインされた状態を保持します。これらのコンポーネントのチェックインが取り消されることはありません。

同時に複数のバッチチェックイン処理を行なった場合、その調停は行われません。2 つのバッチチェックイン処理が、同時に実行を開始する同じコンポーネントセットをターゲットにしている場合、一方のバッチファイルの処理が完了するまでもう一方の処理を抑制することはできません。近似タイミングにより、両方のバッチファイルが交互に処理されます。

cdb.rsrc.co

このコマンドは、指定されたコンポーネントをチェックアウトし、リポジトリからローカルマシンへコピーを転送します。

cdb.rsrc.gd

このコマンドは、指定されたコンポーネントのリソース記述子を生成します。リソース記述子の詳細については、『Sun N1 Service Provisioning System 5.1 プランとコンポーネントの開発者ガイド』の「リソース記述子ファイルの概念」を参照してください。

cdb.rsrc.rci

このコマンドは、コンポーネントを再度チェックインします。チェックインジョブへの割り込みが発生した場合は、このコマンドを使って再度チェックインします。このとき、チェックインするコンポーネントのバージョン番号を人為的に大きくする必要はありません。

cdb.rsrc.showopts

このコマンドは、特定のコンポーネントタイプでサポートされるチェックインオプションを表示します。