Hitachi

Cosminexus V11 アプリケーションサーバ リファレンス コマンド編

cjrarupdate（リソースアダプタのバージョンアップ）

〈このページの構成〉

形式

リソースアダプタをバージョンアップする場合
cjrarupdate -type {dbconnector|rar} [-force] [-f <ファイルパス> ...]
            [-backupto <バックアップ格納先ディレクトリ>]
作業ディレクトリ環境を回復する場合
cjrarupdate -recoverfrom <バックアップRARディレクトリ>

ページの先頭へ

機能

リソースアダプタをバージョンアップする場合

Component Containerにインポート・デプロイされているリソースアダプタをバージョンアップします。

リソースアダプタの移行には，作業ディレクトリのディスク使用量の約2倍以上※の空き容量が必要です。また，アップグレードインストールの場合は，移行コマンドcjenvupdateによって移行処理が問題なく完了していることを確認してから，このコマンドを実行してください。

なお，<作業ディレクトリ>とは，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.public.directoryキーに指定したディレクトリです。

注※

移行するリソースアダプタ数やコマンド実行回数によって，必要なディスクの空き容量は変わります。移行に必要なディスク容量については，アプリケーションサーバの移行の手順で確認してください。アプリケーションサーバの移行については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「10.　旧バージョンのアプリケーションサーバからの移行（J2EEサーバモードの場合）」を参照してください。

作業ディレクトリ環境を回復する場合

Component Containerにインポート・デプロイされているリソースアダプタのバージョンアップに失敗した場合，作業ディレクトリ環境を回復します。

ページの先頭へ

引数

-type {dbconnector|rar}

バージョンアップするリソースアダプタの種類を指定します。

  • dbconnector

    DB Connectorの場合に指定します。

  • rar

    Component ContainerがサポートしているDB Connector以外のリソースアダプタの場合に指定します。

-force

強制的にバージョンアップします。この引数が指定された場合，リソースアダプタのバージョンにかかわらずリソースアダプタをバージョンアップします。

-f <ファイルパス>

  • 移行対象としてDB Connector以外のリソースアダプタを指定した場合（-type rarを指定した場合）

    旧バージョンの既存リソースアダプタと置き換えるリソースアダプタのファイルパスを指定します。ファイルパスは，複数回指定できますが，-fオプションは複数回指定できません。

    -fオプションにTP1インバウンドアダプタまたはFTPインバウンドアダプタ以外のConnector 1.5の仕様に準拠するリソースアダプタを指定した場合，メッセージKDJE42356-Eが出力されます。

  • 移行対象としてDB Connectorを指定した場合（-type dbconnectorを指定した場合）

    この引数は無視されます。

-backupto <バックアップ格納先ディレクトリ>

作業ディレクトリのバックアップの格納先を指定します。このオプションを省略した場合，<作業ディレクトリ>下にバックアップディレクトリが作成されます。

作業ディレクトリのあるディスクの容量に余裕がない場合，またはファイルシステムのパス長制限でバックアップが作成できない場合に，このオプションを指定してください。なお，このオプションでバックアップ格納先ディレクトリを指定する場合，次のことに注意してください。

  • 複数回このコマンドを実行する場合には，同一ディレクトリを指定してください。

  • 長いパス名を指定すると，バックアップ作成に失敗することがあります。その場合，失敗したバックアップを削除してから，短いパス名を指定して再度実行してください。

  • Component Containerのインストールディレクトリを含まないようにしてください。

-recoverfrom <バックアップRARディレクトリ>

回復元となる作業ディレクトリのバックアップRARのディレクトリを指定します。

ページの先頭へ

移行後の作業

移行が完了した場合，各J2EEサーバの作業ディレクトリ，または-backuptoオプションで指定したディレクトリの直下にバックアップ作業ディレクトリが作成され，作業ディレクトリには移行後の情報（ファイル），バックアップ作業ディレクトリには移行前の情報（ファイル）が保存されています。なお，作業ディレクトリが「・・・\<ディレクトリ名>\」または「・・・/<ディレクトリ名>/」の場合，バックアップ作業ディレクトリは，「・・・\<ディレクトリ名>\rarupdate_bk\」または「・・・/<ディレクトリ名>/rarupdate_bk/」※になります。移行後，リソースアダプタの開始，停止およびデータベースへの接続確認が終わり，移行前の作業ディレクトリの情報（ファイル）が不要な場合，バックアップ作業ディレクトリを削除してください。ただし，バックアップ作業ディレクトリは，別の場所に保存しておくことを推奨します。

注※

バックアップの対象ディレクトリは，リソースアダプタに関連するディレクトリです。

すでにバックアップ作業ディレクトリが存在している場合，「・・・\<ディレクトリ名>\rarupdate_bk\」または「・・・/<ディレクトリ名>/rarupdate_bk/」は，「・・・\<ディレクトリ名>\rarupdate_bk_?\」または「・・・/<ディレクトリ名>/rarupdate_bk_?」（?は，コマンド実行時のミリ秒までの日時）にリネームされます。

ページの先頭へ

バージョンタグの比較方法

移行するRARファイルによっては，バージョンタグを比較できないため，移行処理が正常に終了しないことがあります。次の手順でバージョンタグを比較してください。

  1. バージョン文字列を，RARファイルに含まれるra.xmlまたはJ2EEサーバにインポート，デプロイされたリソースアダプタのra.xmlの<version>タグから取得します。

  2. バージョン文字列が，次の形式で指定されている場合は，比較可能な形式に編集します。

    <連続した数字1>.<連続した数字2><数字以外から開始する文字列>

    比較可能な形式

    V1V2-R1R2-S1S2（またはV1V2-R1R2）
　
V1，V2，R1およびR2：0〜9の数値
S1：/
S2：A〜Z（英字大文字）

    編集手順は次のとおりです。

    • <連続した数字1>と<連続した数字2>の間に半角でハイフン(-)を追加します。

      <連続した数字1>-<連続した数字2><数字以外から開始する文字列>

    • <連続した数字1>が10未満の場合，先頭に0を付加します。

    • <連続した数字2>が10未満の場合，末尾に0を付加します。

    編集例

    1.0  → 01-00
1.1  → 01-10
1.12 → 01-12
2.0  → 02-00

バージョン文字列が，V1V2-R1R2[-S1S2]の形式で指定されている場合，次の順序でバージョンの大小比較をします。

なお，ra.xmlの<version>タグの値がサポート外の文字列を使用している場合，正しい比較ができません。次の対処が必要です。

ページの先頭へ

入力例

-fオプションに，ファイルパスを複数回指定する場合
cjrarupdate -type rar -f file1 file2 file3

ページの先頭へ

戻り値

0：

正常終了しました。

1：

異常終了しました。

ページの先頭へ

注意事項

ページの先頭へ

商品名称に関する表示

All Rights Reserved. Copyright (C) 2020, 2022, Hitachi, Ltd.