Cosminexus アプリケーションサーバ V8 リファレンス コマンド編
cjimportres(リソースのインポート)
形式
- EJB-JARファイル,WARファイル,またはRARファイルの場合
cjimportres [<サーバ名称>] [-nameserver <プロバイダURL>]
-type {ejb|war|rar} -f <ファイルパス>
[-f <ファイルパス> ...]
- データソースの場合
cjimportres [<サーバ名称>] [-nameserver <プロバイダURL>]
-type datasource -resname <データソース表示名>
-c <データソース設定ファイルパス>
-f <JDBCドライバファイルパス>
[-f <JDBCドライバファイルパス> ...]
機能
リソース(EJB-JARファイル,WARファイル,データソースファイル,またはRARファイル)をインポートします。また,一度に複数のファイルのインポートもできます。
引数
- <サーバ名称>
- 接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは,ホスト名称がサーバ名称として使用されます。
- -nameserver <プロバイダURL>
- CORBAネーミングサービスへのアクセスプロトコル,CORBAネーミングサービスが稼働しているホスト名,およびそれが使用しているポート番号を次に示す形式で指定します。
<プロトコル名称>::<ホスト名称>:<ポート番号>
- 指定内容の詳細については,「2.1(2) プロバイダURLについて」を参照してください。
- -type {ejb|war|datasource|rar}
- インポートするファイルのファイル種別を指定します。
- ejb:EJB-JARファイル
- war:WARファイル
- datasource:JDBCドライバファイルおよびデータソース設定ファイル
- rar:RARファイル
- -resname <データソース表示名>
- インポートするデータソースに付与する名前を指定します。名前には英数字(0〜9,A〜Z,a〜z)またはアンダースコア(_)を使用できます。
- -c <データソース設定ファイルパス>
- 読み込み対象となるデータソース設定ファイルのパスを指定します。
- -f <ファイルパスまたはJDBCドライバファイルパス>
- 読み込み対象となるファイル(EJB-JARファイル,WARファイル,JDBCドライバ,またはRARファイル)のパスを指定します。
- JDBCドライバが複数のファイルで構成されている場合,-fオプションを複数回指定してください。
入力例
- EJB-JARファイルの場合
cjimportres MyServer -type ejb -f account.jar
- WARファイルの場合
cjimportres MyServer -type war -f account.war
- データソースファイルの場合
cjimportres MyServer -type datasource -resname JdbcDbpsv -c JdbcDbpsvConf.xml -f JdbcDbpsv.jar
- RARファイルの場合
cjimportres MyServer -type rar -f account.rar
戻り値
- 0:
- 正常終了しました。
- 1:
- 異常終了しました。
- 2:
- 排他エラーによってコマンドを実行できません。
- 3:
- タイムアウトが発生しました。
- 9:
- 管理者特権がないため,コマンドが実行できません(Windows Server 2008 x86,Windows Server 2008 x64,Windows Server 2008 R2,Windows 7またはWindows Vistaの場合)。
注意事項
- コマンドの引数にサーバ名称を指定する場合,コマンド名の直後にする必要があります。そのほかの引数は,サーバ名称より後ろ(サーバ名称を省略した場合はコマンド名の後ろ)にあれば順序は任意です。ただし,オプション名と値の順序の入れ替え(例:<データソース表示名> -resname)やオプション名と値を非対応にすること(例:-nameserver <データソース表示名> -resname <プロバイダURL>)はできません。
- DDファイルの<display-name>タグを設定していない場合,または<display-name>タグに空文字を設定している場合,リソースの表示名にファイル名が使用されます。なお,ファイル名に汎用文字,半角英数字以外の文字が含まれている場合,その文字はアンダースコア"_"に置き換えられます。
- Deployment Descriptorを省略した場合,リソースの表示名は次のように変換されます。
- EJB-JARファイル(EJB3.0以降)のときは,ファイル名から拡張子(.jar)を除いた文字列。ただし
- WARファイル(Servlet2.5以降)のときは,ファイル名から拡張子を除いた文字列。
なお,ピリオド(.)が最初にだけ現れるファイル名の場合,拡張子は除かれません。また,変換された表示名に半角英数文字(0〜9, A〜Z, a〜z),アンダースコア(_)以外の文字の文字がある場合,その文字はアンダースコア(_)に置き換えられます。
RARファイルの場合,DDファイルは省略できません。
- コマンドの引数にサーバ名称を指定する場合,cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。
- すでにインポートされているEJB-JARファイルと同じ表示名を持つEJB-JARファイルはインポートできません。
- すでにインポートされているWARファイルと同じ表示名を持つWARファイルはインポートできません。
- すでにインポートされているRARファイルと同じ表示名を持つRARファイルはインポートできません。
- すでにインポートされているデータソース,生成済みのメールと同じ表示名でデータソースをインポートできません。
- ネイティブライブラリを含むRARファイルはインポートできません。
- EJB-JARに表示名が指定されていない場合,EJB-JARファイルのファイル名(.jarを除く)をEJB-JARファイルの表示名として使用します。
RARファイルの場合も同様になります。
WARファイルの場合も同様にファイル名を表示名としますが,英数字,アンダースコア以外の文字はアンダースコアに置き換えます。置換対象文字が連続する場合は一つのアンダースコアにまとめられます。
- 一度に複数のファイルをインポートした場合,インポートできないファイルがあったときでも,すべてのファイルに対してインポートを試みます。
- Enterprise Bean(EJB-JAR)のインポート時には,EJB-JARファイルのDDに関して注意事項があります。Enterprise Bean(EJB-JAR)のインポートについては,マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」を参照してください。
- サーブレットとJSPのインポート時には,WARファイルのDDに関して注意事項があります。サーブレットとJSPのインポートについては,マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」を参照してください。
- リソースアダプタのインポート時には,RARファイルのDDに関して注意事項があります。リソースアダプタのインポートについては,マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」を参照してください。
- インポートするRARファイルの表示名またはデータソースの表示名が240文字より大きい場合はエラーとなります。
All Rights Reserved. Copyright (C) 2008, 2010, Hitachi, Ltd.