Cosminexus アプリケーションサーバ V8 リファレンス コマンド編
cjrenameapp(アプリケーション名の変更)
形式
cjrenameapp [<サーバ名称>] [-nameserver <プロバイダURL>] [-test]
-name <アプリケーション名> -newname <変更後アプリケーション名>
機能
指定したJ2EEアプリケーションの名称を変更します。
アプリケーションの名前を変更することによって,アプリケーションの世代管理やバージョン管理を行うことができます。
なお,application.xmlを省略したアプリケーションの名前を変更した場合,application.xmlが作成されます。そのため,アプリケーション名を変更したJ2EEアプリケーションはapplication.xmlを含むアプリケーションになります。
引数
- <サーバ名称>
- 接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは,ホスト名称がサーバ名称として使用されます。
- -nameserver <プロバイダURL>
- CORBAネーミングサービスへのアクセスプロトコル,CORBAネーミングサービスが稼働しているホスト名,およびそれが使用しているポート番号を次に示す形式で指定します。
<プロトコル名称>::<ホスト名称>:<ポート番号>
- 指定内容の詳細については,「2.1(2) プロバイダURLについて」を参照してください。
- -test
- テストモードのアプリケーションに対してコマンドを実行する場合に指定します。このオプションを省略したときは,通常モードのアプリケーションに対してコマンドが実行されます。
- -name <アプリケーション名>
- 名称を変更するJ2EEアプリケーション名を指定します。
- -newname <変更後アプリケーション名>
- 変更後のJ2EEアプリケーション名を1文字以上で指定します。
- アプリケーション名には,英数字(0〜9,A〜Z,a〜z)またはアンダースコア(_)を使用できます。
入力例
cjrenameapp MyServer -name App1 -newname App2
戻り値
- 0:
- 正常終了しました。
- 1:
- 異常終了しました。
- 2:
- 排他エラーによってコマンドを実行できません。
- 3:
- タイムアウトが発生しました。
- 9:
- 管理者特権がないため,コマンドが実行できません(Windows Server 2008 x86,Windows Server 2008 x64,Windows Server 2008 R2,Windows 7またはWindows Vistaの場合)。
注意事項
- コマンドの引数にサーバ名称を指定する場合,コマンド名の直後にする必要があります。そのほかの引数は,サーバ名称より後ろ(サーバ名称を省略した場合はコマンド名の後ろ)にあれば順序は任意です。ただし,オプション名と値の順序の入れ替え(例:<アプリケーション名> -name)やオプション名と値を非対応にすること(例:-nameserver <アプリケーション名> -name <プロバイダURL>)はできません。
- コマンドの引数にサーバ名称を指定する場合,cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。
- このコマンドを実行する場合,名称変更の対象となるアプリケーションは停止している必要があります。
- アプリケーション名称を変更した場合,lookup名称も変更されるのでlookup名称を使用しているEJBクライアントやネーミング切り替え機能などでパスを通している場合は,修正が必要となります。
- テストモードと通常モードで,それぞれに一意のアプリケーション名称を登録できます。同一モードで同一アプリケーション名称が存在する場合は,エラーとなります。このとき,アプリケーション名の大文字・小文字は区別されません。
- 旧バージョンで作成されたアプリケーションについても,アプリケーション名を変更できます。
- <アプリケーション名>と<変更後アプリケーション名>に同じ名前を指定した場合,正常に処理されますが,アプリケーション名は変わりません。
- 指定したアプリケーション名が255文字より大きい場合はエラーとなります。
All Rights Reserved. Copyright (C) 2008, 2010, Hitachi, Ltd.