コマンド行を使用した製品オファリングのインストール

Installation Managerimcl install コマンドを使用して、任意の製品オファリングをインストールできます。

1. システムにログオンします。

   IBM i システムにログインする際は、*ALLOBJ および *SECADM の特別権限を持つユーザープロファイルを使用していることを確認してください。

2. 製品バイナリー用に別個のディレクトリー・ロケーションを選択します。 Installation Manager のこのインスタンスから初めてインストールする場合は、共有データ・ロケーションも選択します。
3. コマンド行を開始します。

   CLコマンドラインで、Qshellコマンドシェルを起動する STRQSH コマンドを実行します。

4. 選択したディレクトリーに製品をインストールするために必要な権限を持っていることを確認します。
5. PATH環境変数をシステムのデフォルト値に設定します。
   

   export PATH=/usr/bin:.:/QOpenSys/usr/bin

6. Installation Manager をインストールしたディレクトリ内の サブ eclipse/tools ディレクトリに移動してください。
7. 製品リポジトリーが使用可能であることを確認してください。

   listAvailablePackages コマンドは、オファリングの 1 つ以上のレベルをリストします。

   

   imcl.exe listAvailablePackages -repositories source_repository

   

   ./imcl listAvailablePackages -repositories source_repository

8. オプション: リポジトリにユーザー名とパスワードが必要な場合、このリポジトリにアクセスするためのマスターパスワードファイルと認証情報ストレージファイルを作成します。
   1. オプション: マスターパスワードファイルを作成します。

      マスターパスワードファイルは、テキストファイルであり、次のようなパスフレーズを含みます： このテキストはマスターパスワードです。 このファイルを使用して、認証資格情報を保護します。

      マスター・パスワード・ファイルを作成し、それを資格情報の作成時に使用した場合は、常にマスター・パスワード・ファイルを指定する必要があります。

      ヒント: このファイルを保護するには、お使いのオペレーティングシステムに応じて、このファイルへのアクセスを制限する権限を設定してください。
   2. コマンド imutilsc saveCredential を実行して認証情報ストレージファイルを作成します。
      

      imutilsc.exe saveCredential 
        -secureStorageFile storage_file
        -userName user_ID -userPassword user_password
        -url source_repository 

      

      ./imutilsc saveCredential 
        -secureStorageFile storage_file
        -userName user_ID -userPassword user_password
        -url source_repository 

      ヒント: imutilsc コマンドは、資格情報保存ファイルを作成するときに指定された URL を見つけることができません。 /repository.config リポジトリ URL 場所の末尾に。

   詳細については、 IBM のドキュメント（ Installation Manager ） を参照してください。

9. 製品オファリングをインストールするには、コマンドを実行 imcl してください。

   imcl コマンドのフォーマットとオプションは、以下の例に示されています。

   重要: IBM SDK Java Technology Edition は製品に組み込まれなくなったため、製品提供IDと IBM Java SDK提供IDの両方を指定する必要があります。Java SDKなしでは製品提供com.ibm.java.jdk.v8をインストールできません。

   

   imcl.exe install offering_ID_offering_version,optional_feature_ID com.ibm.java.jdk.v8
     -repositories source_repository 
     -installationDirectory installation_directory 
     -sharedResourcesDirectory shared_directory
     -accessRights access_mode
     -preferences preference_key=value
     -properties property_key=value
     -secureStorageFile storage_file -masterPasswordFile master_password_file
     -acceptLicense
   

   

   ./imcl install offering_ID_offering_version,optional_feature_ID com.ibm.java.jdk.v8
     -repositories source_repository 
     -installationDirectory installation_directory 
     -sharedResourcesDirectory shared_directory
     -accessRights access_mode
     -preferences preference_key=value
     -properties property_key=value
     -secureStorageFile storage_file -masterPasswordFile master_password_file
     -acceptLicense
   

   

   重要：IBM i 上のすべてのアプリケーションは、オペレーティングシステムに同梱されているJava SDKを使用します。したがって、 IBM SDK、Java Technology Editionは、 IBM i 上のいかなる製品提供とも併せてインストールすることはできません。

   ./imcl install offering_ID_offering_version,optional_feature_ID
     -repositories source_repository 
     -installationDirectory installation_directory 
     -sharedResourcesDirectory shared_directory
     -accessRights access_mode
     -preferences preference_key=value
     -properties property_key=value
     -secureStorageFile storage_file -masterPasswordFile master_password_file
     -acceptLicense
   

   1. オファリングおよびオプション・フィーチャーをインストールします。

      一部のオファリングでは、インストールするオプション・フィーチャーのコンマ区切りリストを追加できます。 オプション・フィーチャーを指定しないと、デフォルトのフィーチャー・セットがインストールされます。 必要なフィーチャーのみをインストールするには、フィーチャーのリストを明示的に指定します。

      以下の表に、オファリング ID、各オファリングのオプション・フィーチャー、およびデフォルト・フィーチャーを示します。

      表 1. オファリング ID とオプション・フィーチャー

      オファリング ID	オプション・フィーチャー ID	デフォルト・フィーチャー
      WebSphere Application Server Network Deployment com.ibm.websphere.ND.v90	core.feature: WebSphere Application Server 以下のオプションのサブフィーチャーを指定するには、このフィーチャーの指定が必要です。 thinclient: スタンドアロンのシン・クライアントおよびリソース・アダプター embeddablecontainer: 組み込み可能 EJB コンテナー ejbdeploy: EJB 3.0 より前のモジュール用の EJBDeploy ツール 注：Installation Manager を使用して、後から追加または削除するために関数を変更、更新、 core.featureまたはロールバックすることはできません。 追加または削除できるのは、サブフィーチャーのみです。	core.feature thinclient embeddablecontainer ejbdeploy
      WebSphere Application Server 用アプリケーションクライアント com.ibm.websphere.APPCLIENT.v90	samples: サンプル standalonethinclient.resourceadapter.runtime: スタンドアロン Thin Client ランタイム standalonethinclient.resourceadapter.samples: スタンドアロン Thin Client サンプル embeddablecontainer: 組み込み可能 EJB コンテナー	embeddablecontainer
      DMZ Secure Proxy Server for IBM WebSphere Application Server com.ibm.websphere.NDDMZ.v90	core.featureDMZ Secure ProxyIBM 向けサーバー WebSphere Application Server 以下のオプションのサブフィーチャーを指定するには、このフィーチャーの指定が必要です。 thinclient: スタンドアロンのシン・クライアントおよびリソース・アダプター	デフォルト・フィーチャーはありません
      Web Server Plug-in com.ibm.websphere.PLG.v90	オプション・フィーチャーはありません	該当なし
      WebSphere Customization Toolbox com.ibm.websphere.WCT.v90	zpmt: プロファイル管理ツール (z/OS のみ) zmmt: z/OS マイグレーション管理ツール pct: Web サーバー・プラグイン構成ツール	すべてのオプション・フィーチャーがデフォルトでインストールされます

   2. オファリングのバージョンを指定します。

      offering_version (これは、オプションで、間に下線を入れてオファリング ID に付加できます) は、インストールするオファリングの特定のバージョンです (例: 9.0.0.x_0200)。

      • offering_version が指定されていない場合、そのオファリングの最新バージョンとそのバージョンのすべてのインテリム・フィックスがインストールされます。
      • offering_version が指定されている場合は、そのオファリングの指定されたバージョンがインストールされて、そのバージョンのインテリム・フィックスはインストールされません。

      オファリング・バージョンは、リポジトリーに対して次のコマンドを実行したとき、間に下線を入れてオファリング ID の末尾に付加されます。

      imcl listAvailablePackages -repositories source_repository

   3. user_data_root を設定します。
      ベストプラクティス: 初期インストール時には、 user_data_root を指定してください。指定しない場合、 user_data_root のデフォルト値は. となります /QIBM/UserData/WebSphere/AppServer/V9/ND。

      user_data_root を指定するには、 `user_data_root` プロパティ was.install.os400.profile.location にファイルパスを指定してコマンド imcl を実行します。 例: -properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/AppServer/V9/ND。

   4. インテリム・フィックスをインストールします。

      オファリングと一緒にどのインテリム・フィックスをインストールするかを指示するには、-installFixes 引数を使用して none、recommended、または all を指定します。

      • オファリング・バージョンが指定されない場合、-installFixes オプションはデフォルトで all になる。
      • オファリング・バージョンが指定される場合、-installFixes オプションはデフォルトで none になる。
   5. アクセス権限を指定します。

      Installation Manager をインストールするモードを既に指定している場合は、-accessRights パラメーターは必要ありません。

   6. ロールバック用に複数バージョンのパッケージを保存するかどうかを選択します。

      Installation Manager では、以前のバージョンのパッケージを保存して、後で問題が発生したときにロールバックできるようにします。 Installation Manager が以前のバージョンにパッケージをロールバックする際は、現行バージョンのファイルがアンインストールされて、以前のバージョンが再インストールされます。

      ロールバック用にファイルを保存しない場合は、コマンドの指定で以下の設定を使用することにより ファイルが保存されないようにできます。

      -preference com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts=False

      ヒント: このオプションでロールバック用にファイルをローカルに保存しないことを選択した場合でも、適切な製品リポジトリにアクセスすることで、以前にインストールされた任意のレベルにロールバックできます。

      Installation Manager の設定に関する詳細は、 IBM のドキュメント（ Installation Manager ）を参照してください。

例

以下の例は、Windowsオペレーティングシステムに WebSphere Application Server の最新バージョンをインストールする方法を示しています：

imcl install com.ibm.websphere.ND.v90 com.ibm.java.jdk.8
 -installationDirectory "C:\Program Files\IBM\WebSphere\AppServer"
 -sharedResourcesDirectory "C:\Program Files\IBM\IMShared" 
 -repositories C:\IBM\REP\WSAS9ENT 
 -acceptLicense 
 -showProgress 
 -log installv9.xml
 -preferences com.ibm.cic.common.core.preferences.keepFetchedFiles=false,com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts=false

以下の例は、 IBM i オペレーティングシステムに WebSphere Application Server の最新バージョンをインストールする方法を示しています：

./imcl install com.ibm.websphere.ND.v90
  -repositories https://downloads.mycorp.com:8080/WAS_90_repository
  -installationDirectory /QIBM/ProdData/WebSphere/AppServer/V9/ND
  -properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/AppServer/V9/ND
  -sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
  -secureStorageFile $HOME/WASFiles/temp/credential.store
  -acceptLicense