cjsetup（J2EEサーバのセットアップとアンセットアップ）

〈このページの構成〉

形式
機能
引数
戻り値
注意事項

形式

セットアップの場合

cjsetup [<サーバ名称> [-compat <セットアップバージョン識別子>]]

アンセットアップの場合

cjsetup -d <サーバ名称>

ページの先頭へ

機能

指定したサーバ名称のJ2EEサーバの環境をセットアップします。

次のディレクトリにセットアップしたJ2EEサーバ用のデフォルトのユーザ定義を作成します。

Windowsの場合

<Application Serverのインストールディレクトリ>\CC\server\usrconf\ejb\<サーバ名称>\
UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/

なお，-dオプションを指定した場合，次に示すJ2EEサーバの環境（ディレクトリおよびファイル）を削除します。

ユーザ定義ファイルの格納用ディレクトリ以下
- Windowsの場合
  
  <Application Serverのインストールディレクトリ>\CC\server\usrconf\ejb\<サーバ名称>\
- UNIXの場合
  
  /opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/
一時作業用ディレクトリ以下
- Windowsの場合
  
  <Application Serverのインストールディレクトリ>\CC\server\repository\<サーバ名称>\
- UNIXの場合
  
  /opt/Cosminexus/CC/server/repository/<サーバ名称>/
作業用ディレクトリ以下（デフォルト）
- Windowsの場合
  
  <Application Serverのインストールディレクトリ>\CC\server\public\ejb\<サーバ名称>\
- UNIXの場合
  
  /opt/Cosminexus/CC/server/public/ejb/<サーバ名称>/
Webアプリケーションの格納用ディレクトリ以下（デフォルト）
- Windowsの場合
  
  <Application Serverのインストールディレクトリ>\CC\server\public\web\<サーバ名称>\
- UNIXの場合
  
  /opt/Cosminexus/CC/server/public/web/<サーバ名称>/

なお，作業用ディレクトリ，およびWebアプリケーションの格納用ディレクトリについては，ユーザ定義ファイル（usrconf.cfg）のejb.public.directoryキーにデフォルト値以外が指定されていた場合，そのディレクトリ以下も削除します。

ページの先頭へ

引数

<サーバ名称>

セットアップ，またはアンセットアップするJ2EEサーバのサーバ名称を指定します。

サーバ名称には，半角英数字（0〜9，A〜Z，a〜z），アンダースコア（_）またはハイフン（-）を使用できます。サーバ名称の先頭の文字は英数字でなければなりません。また，サーバ名称は，255文字以下，かつマニュアル「アプリケーションサーバシステム構築・運用ガイド」の「付録C.1　J2EEサーバの作業ディレクトリ」を参照して見積もった範囲内の長さで指定してください。

サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。ただし，アンセットアップ時は省略できません。また，ホスト名称にサーバ名称として使用できない文字が含まれている場合はエラーになります。

-compat <セットアップバージョン識別子>

指定したバージョンの互換モードに切り替えてJ2EEサーバを構築します。

-compatを指定しない場合，推奨モードでJ2EEサーバを構築します。

セットアップバージョン識別子にはV9を指定し，V9互換モードでJ2EEサーバを構築します。

セットアップバージョン識別子に何も指定しない場合，エラーメッセージKDJE40027-Iを出力し，コマンドオプションの書式エラーとなります。

セットアップバージョン識別子にV9以外の値を入力した場合，エラーメッセージKDJE40075-Eを出力し，エラーとなります。

-d

J2EEサーバの環境を削除する場合に指定します。サーバ名称は省略できません。

ページの先頭へ

戻り値

0：: 正常終了しました。
1：: 異常終了しました。

ページの先頭へ

注意事項

UNIXの場合，このコマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。
UNIXの場合にアンセットアップ（cjsetup -d <サーバ名称>）を実行すると，削除対象のディレクトリ，ファイルのアクセス権の設定および使用状態に関係なく，すべて削除します。
セットアップ済みのサーバ名称を指定して再セットアップする（cjsetup <サーバ名称>）と，エラーとなります。
アンセットアップを実行するときにコマンドの引数に指定するサーバ名称には，セットアップで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。ただし，Windowsの場合，サーバ名称の大文字・小文字は区別されません。すでに作成済みのサーバ名称と，大文字・小文字の区別以外は一致している文字列をcjsetupのサーバ名称として指定した場合，次のように動作します。
- セットアップの場合(cjsetup <サーバ名称>)
  
  セットアップに失敗します。
- アンセットアップの場合(cjsetup -d <サーバ名称>)
  
  すでに作成済みである，<サーバ名称>と大文字・小文字の区別以外は一致しているサーバが削除されます。
サーバ管理コマンド，J2EEサーバの開始または停止コマンドを実行する場合，これらのコマンドにサーバ名称を引数として指定するときは，このコマンドで作成したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。
起動中のJ2EEサーバに対して，アンセットアップ（cjsetup -d <サーバ名称>）を実行しないでください。
Windowsの場合，削除対象のファイルの属性が読み取り専用，または使用中のときに，アンセットアップ（cjsetup -d <サーバ名称>）を実行しないでください。
Component Container管理者を設定している場合，Management Serverのサーバ名と同じ名前でJ2EEサーバやバッチサーバをセットアップしないでください。

ページの先頭へ