WebSphere Application Server - Express, Version 6.1   
             オペレーティング・システム: AIX , HP-UX, Linux, Solaris, Windows, Windows Vista

             目次と検索結果のパーソナライズ化

install コマンド

install コマンドは、製品、およびその製品内の大部分のコンポーネントを インストールします。製品をインストールする場合は、インストーラー・プログラムがコア・プロダクト・ファイルをインストールします。 プロファイルは、インストールする製品およびそのインストールの選択肢に応じて、作成されない、1 つ作成される、 または 2 つ作成される場合があります。 サイレント・パラメーターは、グラフィカル・ユーザー・インターフェースを表示せずに、 サイレント・モードでインストール・ウィザードを実行します。

目的

このトピックでは、install コマンドのコマンド行構文について説明します。 コマンド行から install コマンド・モジュールを開始して、製品をインストールします。

製品のインストールを始める前に

インストールに備えてオペレーティング・システムを準備します。 開始するには、タスクの概説: インストール の手順に従ってください。

コマンド・ファイルは、製品ディスクのコンポーネントのルート・ディレクトリーにあります。

タスク環境を単純化する過程で、WebSphere Application Server は、バージョン 6.1 製品パッケージの WebSphere ソフトウェア・コンポーネントに対して 共通のインストール・エンジンを適用しています。以下の install コマンドは、 製品パッケージ内の大部分のコンポーネントのインストール・プログラムを開始します。
  • [AIX] [HP-UX] [Linux] [Solaris] install
  • [Windows] install.exe

コマンドまたは代わりのコマンドが、 特定のオペレーティング・システム上のコンポーネントに対応していない場 合には、「N/A (該当なし)」が以下のテーブルに表示されます。 コマンドは、コンポーネントをオペレーティング・システムにインストールできない場合には対応していません。

表 1. . オペレーティング・システムによるコンポーネント・インストール・コマンド
オペレーティング・システム WebSphere Application Server Application Client IBM HTTP Server Web Server Plug-in Application Server Toolkit Update Installer (UPDI)
AIX install install install install 該当なし install
HP-UX install install install install 該当なし install
Linux install install install install install install
Solaris install install install install 該当なし install
Windows install install install install install install

パラメーターおよび構文

このセクションでは、 インストール・ウィザードを開始するコマンドについて説明します。
  • 以下のように、install コマンドを発行して、 インストール・ウィザードを開始し、グラフィカル・ユーザー・インターフェースを表示します。
    component_disc_directory/install
    
  • 以下のように install -silent コマンドを発行して、 グラフィカル・ユーザー・インターフェースなしの無音モードでインストール・ウィザードを開始します。
    component_disc_directory/install -options "response_file_name" -silent

プロファイルを作成して、新規インストールの実行、 フィーチャーの既存インストールへの追加、体験版 や Express 製品のアップグレード、 または既存の WebSphere Application Server - Express 製品の 構成を行うには、以下の install コマンド・オプションを使用します。

以下の表を使用して、 それぞれのオプションごとに有効な値を決定します。
表 2. インストール・コマンド・オプション値テーブル
オプション名 (-OPT) WebSphere Application Server - Express
デフォルト
allowNonRootSilentInstall "true | false" "false"
feature "noFeature | samplesSelected" "samplesSelected"
installLocation 任意の有効なディレクトリー・パス ルートおよび非ルート・インストーラーの app_server_root ディレクトリー
installType "installNew | addFeature | upgrade | createProfile" "installNew"
profileType "standAlone" | "none" "none"
silentInstallLicenseAcceptance "true | false" "false"
traceFormat ALL | text | XML コメント化
traceLevel OFF | SEVERE | WARNING | INFO | CONFIG | FINE | FINER | FINEST コメント化
PROF_adminUserName 任意の正当なユーザー ID。 "ADMIN_USER_NAME"
PROF_adminPassword 任意の正当なユーザー・パスワード。 "ADMIN_PASSWORD"
PROF_cellName 有効な文字を持つストリング コメント化
PROF_defaultPorts コメント化 | コメント化しない コメント化
PROF_enableAdminSecurity "true | false" "true"
PROF_hostName 任意の有効なホスト名。 コメント化
PROF_isDefault コメント化 | コメント化しない コメント化
PROF_nodeName 任意の有効で固有のノード名。 コメント化
PROF_omitAction 構成アクションの名前。 コメント化
PROF_portsFile 有効なポート・ファイルへの任意の有効なファイル・パス。 コメント化
PROF_profileName 任意の有効なプロファイル名ストリング。 コメント化
PROF_profilePath 有効なファイル・パス。 デフォルト値については、ディレクトリー規則 profile_root の説明を参照してください。 コメント化
PROF_serverName server1 などの任意のアプリケーション・サーバー名。 コメント化
PROF_startingPort 任意の有効なポート番号。 コメント化
PROF_validatePorts コメント化 | コメント化しない コメント化
PROF_webServerCheck "true | false" コメント化
PROF_webServerHostname Web サーバーがあるシステムの有効なホスト名。 コメント化
PROF_webServerInstallPath Web サーバーへの任意の有効なディレクトリー・パス。 コメント化
PROF_webServerName 有効な Web サーバーの有効な名前。 コメント化
PROF_webServerOS linux | windows | aix | hp | solaris | os390 | i5os コメント化
PROF_webServerPluginPath Web サーバー・プラグインへの任意の有効なディレクトリー・パス。 コメント化
PROF_webServerPort Web サーバーにアクセスする有効なポート。 コメント化
PROF_webServerType IHS | IIS | SUNJAVASYSTEM | DOMINO | APACHE | HTTPSERVER_ZOS コメント化
PROF_winserviceAccountType specified user | localsystem コメント化
PROF_winserviceCheck "true | false" コメント化
PROF_winserviceStartupType manual | automatic | disabled コメント化
PROF_winservicePassword 有効な specified user のパスワード コメント化
PROF_winserviceUserName 有効な specified user の名前 コメント化

それぞれのオプションについて詳しくは、以下の説明を参照してください。

オプションの説明

以下の情報を使用して、オプションの目的を理解し、 プロファイルを作成するために使用するオプションを決定してください。
allowNonRootSilentInstall
非ルート、または非管理者インストーラー ID で製品のインストール を許可するには、このオプションを「true」に変更します。 値「true」は、非ルート・ユーザーとしてのインストールに関連する制限を受け入れたことを示しています。 値が「false」の場合は、非ルート・ユーザーは製品をインストールできません。

詳しくは、非ルート・インストーラーの制限 を参照してください。

feature
「アプリケーション・サーバーのサンプル」フィーチャーの選択状態を変更します。
有効な値は以下のとおりです。
samplesSelected
インストール用にフィーチャーが選択されていることを示しています。
noFeature
インストール用にフィーチャーが選択されていないことを示しています。
installLocation

製品のインストール・ロケーションを変更します。 任意の有効なディレクトリーを指定します。

[Windows] スペースが入ったディレクトリー名を二重引用符で囲みます。

デフォルト値は、オペレーティング・システムごとに異なります。 非管理者または非ルート・インストーラー ID 用に、別のデフォルト・ロケーションが存在します。ディレクトリー規則 の、ルートおよび非ルート・インストーラー用の app_server_root ディレクトリーに関する説明を参照してください。

installType

installType オプションを変更して、インストールのタイプを制御します。 デフォルトは、WebSphere Application Server の新規コピーをインストールすることです。 それぞれのオペレーション・タイプごとに、install コマンドを別々に起動する必要があります。

有効な値には、次のものが含まれます。
installNew
このデフォルト値は、コア・プロダクト・ファイルの新規コピーをインストールします。
addFeature
incremental インストールで、既存のインストールにフィーチャーを追加します。

それぞれの WebSphere Application Server バージョン 6.1 製品には、フィーチャーが 1 つだけあります。

複数のフィーチャーを持つコンポーネントの場合には、それぞれの フィーチャーごとにオプションを設定してください。 フィーチャーがすでにインストール済みの場合には、フィーチャー・オプションを false に設定します。 新規フィーチャーをインストールするには、そのフィーチャーを true に設定します。

upgrade
試行エディションをライセンス交付を受けたバージョンにアップグレードします。 または、Express 製品を基本 WebSphere Application Server 製品にアップグレードします。
createProfile
既存のインストールでプロファイルを作成します。

installLocation オプションを既存のインストール・ルート・ディレクトリーに設定します。

作成中のプロファイルのタイプに適合するプロファイル・オプションを設定します。 プロファイル・オプションについては、本トピックの後のセクションにあるプロファイル・タイプで説明します。

profileType
作成するプロファイルのタイプを示します。
有効な値には、次のものが含まれます。
アプリケーション・サーバー
スタンドアロン・アプリケーション・サーバー・プロファイルを作成します。
なし
プロファイルを作成しません。
silentInstallLicenseAcceptance
無音応答ファイルの silentInstallLicenseAcceptance プロパティーを「true」に変更することによって、 mount point または disc_drive/WAS/lafiles ディレクトリーにある、プログラムに付随する IBM プログラムのご使用条件を確認したことに同意し、 これらの条件に同意します。

これらの条件に同意しない場合は、 値の変更、あるいはそのプログラムのダウンロード、インストール、コピー、アクセス、または使用を行わずに、 プログラムおよびライセンス証書を取得した団体にそれらを早急に返品して、支払った金額の返金を受けてください。

traceFormat
トレース・ファイル出力を制御します。
traceLevel
収集するトレース情報の量を制御します。
PROF_adminPassword
管理ユーザー ID のパスワードを選択します。

PROF_enableAdminSecurity オプションを true に設定してこのオプションを使用します。

PROF_adminUserName
管理ユーザー ID を選択します。

PROF_enableAdminSecurity オプションを true に設定してこのオプションを使用します。

重要: ユーザー名およびパスワードを書き込みます。 ユーザー名およびそのパスワードなしでは、管理コンソールにログオンできません。ID およびパスワードが判明しない限り、WebSphere Application Server は使用できません。
PROF_cellName
プロファイルに固有のセル名を指定します。

セル名は、WebSphere Application Server 環境内で固有になっている必要があります。

将来スタンドアロン Application Server の統合を計画することがある場合でも、デプロイメント・マネージャーのセル名ではない固有のセル名をプロファイルに指定します。

PROF_defaultPorts
デフォルトの WebSphere Application Server ポート設定を使用するには、オプションのコメントを外します。

このパラメーターは、PROF_portsFile オプション、または PROF_startingPort オプションと共に使用しないでください。

PROF_enableAdminSecurity
インストール・プロセス中に、管理セキュリティーを使用可能にするかどうかを選択します。

createProfile オプションを true に設定します。

installLocation オプションを既存のインストール・ルート・ディレクトリーに設定します。

profileType オプションを設定します。

プロファイルのタイプに、他の適切なプロファイル・オプション (PROF_ オプション) を設定します。

profileType="custom" または profileType="none" になっている場合には、このオプションを false に設定します。

有効な値は以下のとおりです。
true
管理セキュリティーが使用可能になります。 ユーザー名およびパスワードを指定する必要があります。
重要: ユーザー名およびパスワードを書き込みます。 ユーザー名およびそのパスワードなしでは、管理コンソールにログオンできません。ID およびパスワードが判明しない限り、WebSphere Application Server は使用できません。
false
管理セキュリティーが使用不可になります。
PROF_hostName
プロファイルが常駐するマシンのホスト名を指定します。

ホスト名は、ドメイン・ネーム・システム (DNS) 名 (short または long) または、このコンピューターの IP アドレスです。

PROF_isDefault
デフォルト・プロファイルを設定します。

デフォルト・プロファイルは、app_server_root/bin ディレクトリーから発行されるコマンドなどの、匿名プロファイルに対して発行されるコマンドのデフォルトのターゲットです。

他のプロファイルの bin ディレクトリーからコマンドを発行すると、 デフォルト・プロファイルではなく、他のプロファイルを指定するコマンド・ウィンドウが設定されます。 新規コマンド・ウィンドウが開き、匿名コマンドをデフォルト・プロファイル に再び設定します。

PROF_nodeName
プロファイルに固有のノード名を指定します。

WebSphere Application Server 環境では、ノード名が固有である必要があります。

PROF_omitAction
指定した構成アクションを省略します。
PROF_portsFile
望ましいポート値を含むプロパティー・ファイルにパスを指定します。

有効な値は、有効なファイル・パスのデフォルト WebSphere Application Server ポート設定です。

このパラメーターは、PROF_defaultPorts オプション、または PROF_startingPort オプションと共に使用しないでください。

PROF_profileName
プロファイル名を設定します。

プロファイルの名前を指定します。 プロファイル名は、この WebSphere Application Server インストール、 または一時的に属す場合があるセルで、固有になっている必要があります。

有効な値は、有効な文字を持つストリングです。

PROF_profilePath
profile_root ディレクトリーへの完全修飾ファイル・パスを指定します。

コマンド、構成ファイル、およびログ・ファイルなどの、 ランタイム・プロファイル環境を定義するファイルを組み込むには、有効なディレクトリーを指定します。

[Windows] ディレクトリーにスペースが含まれている場合には、二重引用符でパスを囲みます。

有効な値は、有効なディレクトリー・パスです。

PROF_serverName
スタンドアロン Application Server プロファイル、デプロイメント・マネージャー、 またはセル・プロファイルの一部になっているフェデレーテッド・アプリケーション・サーバーの、サーバー名を指定します。

それぞれのスタンドアロン Application Server プロファイル、 またはそれぞれのフェデレーテッド・アプリケーション・サーバー・プロファイルには、例えば、server1 という名前のサーバーを組み込むことができます。 サーバー名は、プロファイル内で固有になっている必要があります。 ただし、セルまたはインストール内で固有になっている必要はありません。

PROF_startingPort
プロファイル用のすべてのポートを生成するための開始ポート番号を指定します。 指定しない場合、プロファイルは serverindex.xml ファイルで指定されているデフォルト・ポートを使用します。

このパラメーターは、PROF_portsFile オプションと共に使用しないでください。

PROF_validatePorts
選択したポートに競合が存在していないということを検証するには、オプションのコメントを外します。
PROF_webServerCheck
Web サーバー定義を定義するかどうかを指定します。
PROF_webServerHostname
Web サーバーがあるシステムのホスト名を指定します。

PROF_webServerCheck オプションが必要です。

PROF_webServerInstallPath
Web サーバーのローカルまたはリモート・インストール・パスを指定します。

PROF_webServerCheck オプションが必要です。

PROF_webServerName
Web サーバーの名前を指定します。

PROF_webServerCheck オプションが必要です。

PROF_webServerOS
Web サーバーが稼働するシステムのオペレーティング・システムを指定します。

PROF_webServerCheck オプションが必要です。

PROF_webServerPluginPath
Web サーバーの Web サーバー・プラグインへのパスを指定します。

PROF_webServerCheck オプションが必要です。

PROF_webServerPort
ポート 80 などの、Web サーバーのアクセス・ポートを指定します。

PROF_webServerCheck オプションが必要です。

PROF_webServerType
Web サーバーのタイプを指定します。

PROF_webServerCheck オプションが必要です。

PROF_winserviceAccountType
作成するウィンドウ・サービスのタイプを指定します。

PROF_winserviceCheck オプションが必要です。

PROF_winserviceCheck
サーバー・プロセスを Windows サービスとして実行するかどうかを選択します。
PROF_winserviceStartupType
ウィンドウ・サービス用開始メソッドを指定します。

PROF_winserviceCheck オプションが必要です。

PROF_PROF_winservicePassword
ウィンドウ・サービスのパスワードを指定します。

PROF_winserviceCheck オプションが必要です。

PROF_PROF_winserviceUserName
ウィンドウ・サービスのユーザー名を指定します。

PROF_winserviceCheck オプションが必要です。

インストール・ウィザードのユーザー・インターフェースを使用して、WebSphere Application Server - Express をインストールします
install

インストール・ウィザードによるインストールについて詳しくは、製品および追加のソフトウェアのインストール を参照してください。

コマンド行から、WebSphere Application Server - Express をインストールします。
install -options /tmp/was/my_response_file.txt -silent
ユーザー・インターフェースなしでコマンド行から WebSphere Application Server - Express をインストールする
install -options /tmp/was/my_response_file.txt 
このコマンドは、 以下の特定の状態で製品をインストールします。
応答ファイル場所
/tmp/was/my_response_file.txt
ルート・インストール
-OPT allowNonRootSilentInstall="false"
フィーチャーのインストール
-OPT feature="samplesSelected"
インストール・ルート・ディレクトリー
-OPT installLocation="app_server_root"
製品の新規インストールのインストール
-OPT installType="installNew"
インストール中に作成されるプロファイルのタイプ
-OPT profileType="standAlone"
IBM 使用許諾契約書の受け入れ
-OPT silentInstallLicenseAcceptance="true"
セル名の指定
-OPT PROF_cellName="my_cell1"
スタンドアロン Application Server 用デフォルトのポートの使用
-OPT PROF_defaultPorts=
ホスト名の指定 (この場合は IP アドレス)
-OPT PROF_hostName="5.55.555.555"
プロファイルのファイル・パスの識別
-OPT PROF_profilePath="profile_root"
アプリケーション・サーバーの名前付け
-OPT PROF_serverName="my_server1"
インストーラー・プログラムによる非競合ポートの割り当て
-OPT PROF_validatePorts=
Web サーバー定義のインストール
-OPT PROF_webServerCheck="true"
Web サーバーおよびプラグインのロケーションの識別

-OPT PROF_webServerHostname="5.55.555.555"
-OPT PROF_webServerInstallPath="Web_server_root"
-OPT PROF_webServerName="my_ihs_web_server1"
-OPT PROF_webServerOS="linux"
-OPT PROF_webServerPluginPath="plugins_root"
-OPT PROF_webServerPort="80"
-OPT PROF_webServerType="IHS"

Content of /tmp/was/my_response_file.txt

-OPT allowNonRootSilentInstall="false"
-OPT feature="samplesSelected"
-OPT installLocation="app_server_root"
-OPT installType="installNew"
-OPT profileType="standAlone"
-OPT silentInstallLicenseAcceptance="true"
-OPT traceFormat=ALL
-OPT traceLevel=INFO
-OPT PROF_cellName="exp_cell1"
-OPT PROF_defaultPorts=            
-OPT PROF_hostName="5.55.555.555"  
-OPT PROF_isDefault=
-OPT PROF_nodeName="expnode1_node"
-OPT PROF_profileName="my_default"
-OPT PROF_profilePath="profile_root"
-OPT PROF_serverName="my_server1"
-OPT PROF_validatePorts=
-OPT PROF_webServerCheck="true"
-OPT PROF_webServerHostname="5.55.555.555"
-OPT PROF_webServerInstallPath="Web_server_root"
-OPT PROF_webServerName="my_ihs_web_server1"
-OPT PROF_webServerOS="linux"
-OPT PROF_webServerPluginPath="plugins_root"
-OPT PROF_webServerPort="80"
-OPT PROF_webServerType="IHS"

グラフィカル・ユーザー・インターフェースなしのサイレント・モードにおけるインストール・ウィザードの 使用について詳しくは、サイレント・インストール を参照してください。

ロギング

app_server_root/logs/install/log.txt ファイルを検査して、インストール中に、ファイル・システム・エラー、またはその他の異常なエラーがないことを検証します。 問題がある場合には、その問題を訂正し、製品を再インストールしてください。

WebSphere Application Server は、以下の戻りコードを使用して、インストール・オペレーションの結果を示します。
0
正常
1
失敗
2
部分的な成功
3
予約済み
4
使用を許諾されていない
5
PrereqCheck 失敗
6
アップグレードがサポートされていない

戻りコードは、以下のオペレーティング・システム上の以下のコンポーネントで使用されています。

表 3. 戻りコード適用度
オペレーティング・システム WebSphere Application Server Application Client IBM HTTP Server Web Server Plug-in Application Server Toolkit Update Installer (UPDI)
オペレーティング・システム (AIX、Linux など) はい はい はい はい はい はい

[Windows] ISMP は、制限によって Windows に終了コードを設定しません。 インストール・ログを確認して、成功または失敗を判別します。

Application Client の終了コードは、バージョン 6.0 の終了コードとは異なります。 すなわち、「1=success」および「0=failure」です。

部分的な成功は、インストールの一部は失敗したが、少なくともイ ンストールの一部は使用可能であることを示しています。 失敗はリカバリー可能です。 リカバリーが完了すると、インストールは完全に使用可能になります。 ログを確認して、失敗を正確に判別し、訂正アクションがある場合にはそのアクションを判別します。




関連タスク
製品および追加のソフトウェアのインストール
関連資料
vpd.properties ファイル
関連情報
オペレーティング・システムのレジストリー・キー
非ルート・インストーラーの制限
responsefile.express.txt
参照トピック    

ご利用条件 | フィードバック

最終更新: Jan 21, 2008 6:25:35 PM EST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.express.doc/info/exp/ae/rins_install.html