ここでは，システム環境をセットアップするときの注意事項について説明します。

• セットアップウィザードを実行できるユーザは次のとおりです。次に示すユーザ以外がセットアップウィザードを実行した場合，エラーとなります。
  
  • Windowsの場合
    Windows Server 2012，Windows Server 2008，Windows 8，Windows 7，またはWindows Vistaのときは，管理者特権のあるユーザがコマンドを実行できます。それ以外のWindowsのOSのときは，Administrator権限のあるユーザがコマンドを実行できます。
    
  • UNIXの場合
    root権限のあるユーザがコマンドを実行できます。
    
• コマンドを実行している間は，Ctrl+Cキーなどで外部から停止しないでください。
• セットアップ処理の途中でエラーが発生した場合は，セットアップ処理は停止され，セットアップ失敗の画面が表示されます。この場合，セットアップ中のシステムを削除してから再度セットアップを実行してください。セットアップ中のシステムを削除するには，セットアップウィザードでアンセットアップを実行します。アンセットアップについては「3.3.1　システム環境をアンセットアップする」を参照してください。
• セットアップウィザード操作時に，設定値の入力を求められている場合に何も入力しないでEnterキーを押すと，設定項目にデフォルト値が適用されます。なお，デフォルト値がない設定項目もあります。デフォルト値がない設定項目でEnterキーを押すとエラーとなり，再度設定値の入力が求められます。
• 設定値の入力を求められている場合に，設定できない値を入力してEnterキーを押すとエラーとなり，次の画面が表示されます。
  

  図2-1　設定できない値を入力した場合の画面

  

• 設定できる値が「0文字以上」の設定項目について設定値の入力を求められている場合に何も入力しないでEnterキーを押すと，空文字が適用されます。
  なお，一度値を設定した項目について値を再入力する場合は次の画面が表示されます。
  

  図2-2　設定できる値が「0文字以上」の設定項目について値を再入力する場合の画面

  

  この画面が表示された場合に何も入力しないでEnterキーを押すと，設定済みの値は適用されないで，空文字が適用されます。
  
• セットアップウィザードでは，セットアップウィザードを実行するホスト上にだけシステム環境をセットアップできます。ほかのホスト上にはシステム環境をセットアップできません。
• 標準セットアップでセットアップウィザードを実行すると，次の表に示すポート番号を使用したシステム環境がセットアップされます。
  

  表2-5　標準セットアップで使用するポート番号

  ポート番号	用途
  80	Webサーバのポート番号
  900	インプロセスのネーミングサービスのポート番号
  8007	ajp13のポート番号
  8080	管理用サーバのポート番号
  20295	運用管理エージェントのポート番号
  23152	RMIレジストリのポート番号
  28005	Management Server終了要求受信ポート番号
  28009	Management Server内部通信用ポート番号
  28080	Management Server接続HTTPポート番号

  これらのポート番号をすでに使用している場合は，標準セットアップでは構築できません。［セットアップ方法の選択］画面で「2」（カスタムセットアップ）を入力して，次の画面で重複しないポート番号を設定してください。
  
  • ［運用管理機能の設定］画面
  • ［システム環境の設定］画面
  なお，ポート番号以外を標準セットアップと同じ設定にする場合は，［運用管理ユーザの設定］画面，［J2EEサーバの起動ユーザの設定］画面（UNIXの場合）および［システム構成の選択］画面で「1」（デフォルト）を入力してセットアップしてください。
  
• セットアップに失敗した場合に［セットアップ失敗］画面でyを入力すると，障害に対処するための資料として，snapshotログが自動的に収集されます。
  snapshotログの格納先と収集内容を次に示します。
  snapshotログの格納先
  
  • <セットアップウィザードのログの出力先>/snapshot.zip
  snapshotログの収集内容
  
  • <Application Serverのインストールディレクトリ>/manager/config/snapshotlog.confで示す範囲
  • <セットアップウィザードのログの出力先>/setupwizard<ファイル面数>.log
  • <セットアップウィザードのログの出力先>/maintenance/setupwizard<ファイル面数>.log
  • <Application Serverのインストールディレクトリ>/manager/setup/config/
  • <Application Serverのインストールディレクトリ>/manager/setup/tmp/
  <セットアップウィザードのログの出力先>は，setup.cfgのsetup.log.dirで指定した出力先です。setup.cfgについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「10.20　setup.cfg（セットアップウィザード用設定ファイル）」を参照してください。
  
• セットアップウィザードで使用するファイルの一覧を次の表に示します。
  

  表2-6　セットアップウィザードで使用するファイルの一覧

  分類	ファイル名称	概要	出力先
  セットアップ情報リスト	setupwizardlist.txt	セットアップ処理完了（成功）後出力されます。 セットアップウィザードで構築した環境を確認するためのファイルです。	Windowsの場合 <Application Serverのインストールディレクトリ>\manager\setup\config UNIXの場合 /opt/Cosminexus/manager/setup/config
  セットアップ情報ファイル	setupwizard.dat	［セットアップ情報］画面で「セットアップ情報を保存する」を選択した場合に出力されます。 一括セットアップで使用できます。
  	setupwizard_success.dat	セットアップ処理完了（成功）後に自動的に出力されます。 一括セットアップまたはシステムの複製で使用できます。
  	setupwizard_failed.dat	セットアップ処理完了（失敗）後に自動的に出力されます。 一括セットアップで使用できます。 ただし，このファイルを使用して一括セットアップをする場合は，セットアップ処理失敗の原因を取り除く必要があります。
  ログファイル	setupwizard<ファイル面数>.log	セットアップウィザードのログが出力されます。 最大ファイルサイズ，最大ファイル面数などのログファイルの設定は，setup.cfg（セットアップウィザード用設定ファイル）で指定できます。	任意（setup.cfgのsetup.log.dirで指定した出力先）
  簡易構築定義ファイル	cmxsetupwz.xml	セットアップ処理完了（成功）後出力されます。 セットアップウィザードで構築した環境の定義内容を確認するためのファイルです。	Windowsの場合 <Application Serverのインストールディレクトリ>\manager\setup\config UNIXの場合 /opt/Cosminexus/manager/setup/config
  DB ConnectorのConnector属性ファイル	DBConnector_HiRDB_Type4_CP_cfg.xml または DBConnector_Oracle_CP_cfg.xml	セットアップ処理完了（成功）後出力されます。 セットアップウィザードで構築した環境で使用するDB Connectorの定義内容を確認するためのファイルです。
  セットアップウィザード用設定ファイル	setup.cfg	セットアップウィザードのログファイルの出力先，最大ファイルサイズ，最大ファイル面数などを指定するファイルです。