コマンド行を使用した分散オペレーティング・システムでの Liberty のインストール

Installation Manager コマンド行を使用して、すべての WebSphere® Application Server Liberty オファリングをインストールできます。

始めに

重要:

Java™ SE 25は、最新の機能とセキュリティアップデートを提供するため、推奨されるJava SDKです。 Java SE 25をインストールする代わりに、サポートされている別のJava SDKバージョンをインストールすることもできます。 Liberty は、 Open Liberty Web サイトの 「サポートされる Java リリース」 表の 「Java SE バージョン」 列にリストされているいずれかの Java SE バージョンで実行されます。 サポートされるJavaリリースの表には、各Java SEバージョンのサポート終了予定日も記載されています。

詳しくは、 削除通知を参照してください。

インストールメディアの入手とLiberty用 Installation Manager 」の説明に従って、 Libertyをインストールするシステムを準備します。

ローカル・ディレクトリー・ベースのリポジトリー、または Liberty Asset Repository Service のインスタンスから Liberty アセットをインストールする場合は、リポジトリーを構成します。 Liberty アセット・リポジトリーについて詳しくは、 Installation Manager を使用したアセットのインストールを参照してください。

重要: Liberty オファリングをインストールする前に、製品ファイルに含まれているご使用条件をお読みください。 このトピックの説明に従って、コマンドに -acceptLicense を指定してご使用条件に同意してください。

このタスクについて

Liberty 製品オファリング、Java SDK オファリング、およびその他の使用可能なソフトウェアを含むすべての製品オファリングは、同じ Installation Manager コマンドを使用してインストールされます。 別のオファリングをインストールする場合も、以下のステップに従いますが、ただし、そのオファリングの ID とオプション・フィーチャーをすべて、目的のオファリングの ID およびフィーチャーに置き換えてください。
新規: Libertyをインストールすると、ご使用の Liberty 製品エディションに適用されるすべての Liberty フィーチャーもデフォルトでインストールされます。 または、別のフィーチャー・セットをインストールすることも、フィーチャーをまったくインストールしないこともできます。 詳しくは、「 ヒント 」セクションを参照してください。

手順

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

      メイン・パスワード・ファイルは、 「このテキストはメイン・パスワードです」 などのパスフレーズを含むテキスト・ファイルです。 このファイルを使用して、認証資格情報を保護します。

      メイン・パスワード・ファイルを作成し、資格情報の作成時にそれを使用する場合は、常にそのメイン・パスワード・ファイルを指定してください。

      ヒント: このファイルを保護するには、ご使用のオペレーティング・システムに合わせてこのファイルへのアクセスを制限する許可を設定します。
    2. imutilsc saveCredential コマンドを実行して、資格情報保管ファイルを作成します。
      Windows プラットフォームの場合
      imutilsc.exe saveCredential 
  -secureStorageFile storage_file
  -userName user_ID -userPassword user_password
  -url repository_URL_or_path
      LINUX プラットフォームの場合Solaris プラットフォームの場合HP UNIX プラットフォームの場合AIX プラットフォームの場合
      ./imutilsc saveCredential 
  -secureStorageFile storage_file
  -userName user_ID -userPassword user_password
  -url repository_URL_or_path
      ヒント ： imutilsc コマンドが、資格情報ストレージファイルを作成する際に指定した URL を見つけられない場合は、リポジトリ URL の場所の最後に /repository.config を追加します。
  2. システムにログオンします。
  3. Installation Managerをインストールしたディレクトリーの eclipse/tools サブディレクトリーに移動します。
  4. オファリング・リポジトリーが使用可能であることを確認してください。
    Windows プラットフォームの場合
    imcl.exe listAvailablePackages -repositories repository_URL_or_path
    LINUX プラットフォームの場合Solaris プラットフォームの場合HP UNIX プラットフォームの場合AIX プラットフォームの場合
    ./imcl listAvailablePackages -repositories repository_URL_or_path
    オファリングの 1 つ以上のレベルが表示されます。
  5. imcl コマンドを使用して、オファリングをインストールします。
    Windows プラットフォームの場合
    imcl.exe install com.ibm.websphere.liberty.BASE_offering_version,optional_feature_ID
  -repositories repository_URL_or_path 
  -installationDirectory installation_directory 
  -sharedResourcesDirectory shared_directory
  -preferences preference_key=value
  -properties property_key=value
  -secureStorageFile storage_file -masterPasswordFile master_password_file
  -acceptLicense
    LINUX プラットフォームの場合Solaris プラットフォームの場合HP UNIX プラットフォームの場合AIX プラットフォームの場合
    ./imcl install com.ibm.websphere.liberty.BASE_offering_version,optional_feature_ID
  -repositories repository_URL_or_path 
  -installationDirectory installation_directory 
  -sharedResourcesDirectory shared_directory
  -preferences preference_key=value
  -properties property_key=value
  -secureStorageFile storage_file -masterPasswordFile master_password_file
  -acceptLicense
    ヒント:
    • Libertyをインストールすると、 Liberty 製品エディションに適用されるすべての Liberty フィーチャーもデフォルトでインストールされます。

      すべてのフィーチャーをインストールする代わりに、以下の例に示すように、 Liberty アドオンおよびフィーチャーのカスタム・セットを user.addon プロパティーおよび user.feature プロパティーに指定してインストールすることができます。 フィーチャーの短い名前またはシンボリック名は、次のように 2 個のコンマで区切られることに注意してください。

      imcl.exe install com.ibm.websphere.liberty.BASE,embeddablecontainer             
-properties user.addon=extendedPackage-1.0,user.feature=mphealth-4.0,,mpMetrics-4.0
-installationDirectory "C:\Program Files\IBM\WebSphere\Liberty" -acceptLicense
-repositories D:\IBM\LibertyRepo,https://your_onprem_asset_repo_url,D:\IBM\LocalAssetRepo,D:\IBM\LocalAssetRepo2.zip
-sharedResourcesDirectory D:\IBM\IMShared
-showProgress
      アセットのインストールは、インターネット・アクセスがあってもなくても、Liberty Asset Repository Service のインスタンスから、またはローカル・ディレクトリー・ベースのリポジトリーから行うことも可能です。 リポジトリー URL、ディレクトリー・パス、またはアーカイブ・ファイル・パスを -repositories パラメーターに追加してください。 リポジトリーは、指定された順序でアクセスされます。 これらのアセット・リポジトリーについて詳しくは、 Installation Manager を使用したアセットのインストールを参照してください。 IBM® WebSphere Liberty リポジトリからアセットをインストールするには、インターネットにアクセスできる必要があります。 Liberty Repository へのアクセスを有効にするには、-properties パラメーターで user.useLibertyRepository オプションを true に設定します。 Liberty Repository は、 インストール中にアクセスされるリポジトリーのうち最後のリポジトリーです。
      重要: Liberty アドオンまたはフィーチャーをインストールしない場合は、 -properties user.addon="" user.feature="" パラメーターを指定します。
      詳しくは、以下のトピックを参照してください。
    • 初めて Installation Manager を使用してパッケージをインストールする場合、共有リソース・ディレクトリーを指定できます。 共有リソース・ディレクトリーは、1 つ以上のパッケージ・グループが使用できるインストール成果物が置かれる場所です。 また、このディレクトリーは、インストールの操作中、製品のペイロードのステージング・エリアとしても使用されます。 デフォルトでは、このコンテンツは、ロールバックに使用できるようにキャッシュされます。 このインストールには、最も大きいドライブを使用してください。 すべてのパッケージをアンインストールし終わるまで、このディレクトリー・ロケーションは変更できません。
    • 間に下線を入れてオファリング ID に付加できる offering_version は、インストールするオファリングの特定のバージョンです (例: 16.0.2.20160503_0200)。
      • offering_version が指定されていない場合、そのオファリングの最新バージョンとそのバージョンのすべてのインテリム・フィックスがインストールされます。
      • offering_version が指定されている場合は、そのオファリングの指定されたバージョンがインストールされて、そのバージョンのインテリム・フィックスはインストールされません。
      オファリング・バージョンは、リポジトリーに対して次のコマンドを実行したとき、間に下線を入れてオファリング ID の末尾に付加されます。
      imcl listAvailablePackages -repositories repository_URL_or_path
    • どのインテリム・フィックスをオファリングとインストールしたいかを示すために、-installFixes 引数と共に none、recommended または all を指定できる。
      • オファリング・バージョンが指定されない場合、-installFixes オプションはデフォルトで all になる。
      • オファリング・バージョンが指定される場合、-installFixes オプションはデフォルトで none になる。
    • 組み込み可能 EJB コンテナーおよび JPA クライアントをインストールするには、オファリング ID の後に、任意の embeddablecontainer フィーチャーをコンマで区切って指定します。
      注: 16.0.0.2 フィックスパック以降、組み込み可能 EJB コンテナーおよび JPA クライアント・フィーチャーに対して削除通知が発行されたため、このフィーチャーは将来の削除に適格となります。 詳しくは、 削除の注意事項を参照してください。

      組み込み可能 EJB コンテナーは、スタンドアロンの Java Platform, Standard Edition (SE) 環境でエンタープライズ Bean を実行するために使用できる Java アーカイブ (JAR) ファイルです。 この組み込み可能コンテナーを使用して、アプリケーション・サーバーの外部でエンタープライズ Bean を実行できます。 組み込み可能 EJB コンテナーは EJB 3.1 仕様の一部で、エンタープライズ Bean のビジネス・ロジックの単体テストで主に使用されます。

      JPA クライアントは、組み込み可能 EJB コンテナーと一緒に使用して、Java SE 環境における Java Persistence API の機能を提供できます。

    • Installation Manager では、以前のバージョンのパッケージを保存して、後で問題が発生したときにロールバックできるようにします。 Installation Manager が以前のバージョンにパッケージをロールバックする際は、現行バージョンのファイルはアンインストールされて、以前のバージョンが再インストールされます。 ロールバック用にファイルを保存しない場合は、コマンドの指定で以下の設定を使用することにより ファイルが保存されないようにできます。
      -preference com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts=False
      これを以下のようにします。
      ヒント: ロールバック用にファイルをローカルに保存しないことを選択した場合でも、適切なオファリング・リポジトリーにアクセスすることで、以前にインストールしたレベルにロールバックすることができます。
    • Installation Manager は、オペレーティング・システムのアーキテクチャーに基づいて、インストール・パッケージのアーキテクチャーを自動的に選択します。 64 ビット・システムでは、オペレーティング・システムの以下の設定を 32 ビット・アーキテクチャーの値に設定することで、32 ビット・インストールを指定できます。
      -properties cic.selector.arch=x86

      cic.selector.arch のアーキテクチャ値のリストについては、 Installation Manager 製品ドキュメントの imcl コマンドのコマンドライン引数の表を参照してください。

    • 関連する使用許諾条件、注意事項、およびお知らせは、このオファリングのインストール・イメージまたはリポジトリーの lafiles または offering_name/lafiles サブディレクトリーにある使用許諾契約書のファイルで提供されています。
    • 重要なインストール後の指示が標準出力に書き込まれることがあります。

    imcl コマンドを使用してオファリングをインストールする方法の詳細については、 IBM Installation Manager 製品ドキュメントを参照してください。