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

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

始める前に

[17.0.0.3 and later]重要: WebSphere Liberty での Java™ SE 6 の使用に対するサポートは、2017 年 9 月に終了しました。Liberty カーネルは 17.0.0.3 で再コンパイルされました。17.0.0.3 以降、Java SE 6 を使用して Liberty カーネルを実行することはできなくなりました。サポート終了日より後に、旧リリースで Java SE 6 を使用し続けると、環境がセキュリティー・リスクにさらされる可能性があります。

Java SE 8 は、最新の機能とセキュリティー更新を備えているため、これが推奨 Java SDK となります。Java SE 8 をインストールする代わりに、サポートされている別の Java SDK バージョンをインストールできます。

Installation Manager のインストールおよび Liberty のインストールの準備 の説明に従い、Liberty をインストールするシステムを準備してください。

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

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

このタスクについて

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

手順

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

      マスター・パスワード・ファイルは、「このテキストはマスター・パスワードです (This text is the master password)」などのパスフレーズが含まれるテキスト・ファイルです。このファイルは、認証クレデンシャルを保護するために使用されます。

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

      ヒント: このファイルを保護するには、ご使用のオペレーティング・システムに合わせて、このファイルへのアクセスを制限するように許可を設定してください。
    2. imutilsc saveCredential コマンドを実行して、クレデンシャル・ストレージ・ファイルを作成します。
      For Windows platforms
      imutilsc.exe saveCredential 
        -secureStorageFile storage_file
        -userName user_ID -userPassword user_password
        -url repository_URL_or_path
      For AIX platformsFor HP UNIX platformsFor LINUX platformsFor Solaris platforms
      ./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. オファリング・リポジトリーが使用可能であることを確認してください。
    For Windows platforms
    imcl.exe listAvailablePackages -repositories repository_URL_or_path
    For AIX platformsFor HP UNIX platformsFor LINUX platformsFor Solaris platforms
    ./imcl listAvailablePackages -repositories repository_URL_or_path
    オファリングの 1 つ以上のレベルが表示されます。
  5. imcl コマンドを使用して、このオファリングをインストールします。
    For Windows platforms
    imcl.exe install com.ibm.websphere.liberty.ND_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
    For AIX platformsFor HP UNIX platformsFor LINUX platformsFor Solaris platforms
    ./imcl install com.ibm.websphere.liberty.ND_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
    ヒント:
    • New: Liberty をインストールする場合、 ご使用の Liberty 製品エディションに適用されるすべての Liberty フィーチャーもデフォルトでインストールされます。
      以下の例で示されるように、すべてのフィーチャーをインストールするより、 Liberty アドオンとフィーチャーのカスタム・セットを user.addon および user.feature プロパティーに指定することで、それらをインストールすることができます。フィーチャーの短い名前またはシンボリック名は、次のように 2 個のコンマで区切られることに注意してください。
      imcl.exe install com.ibm.websphere.liberty.ND,embeddablecontainer             
      -properties user.addon=extendedPackage-1.0,user.feature=portlet-2.0,,portletserving-2.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 Repository からアセットをインストールするには、インターネットへのアクセスが必要です。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 引数に、nonerecommended、または all を指定することもできます。
      • オファリング・バージョンが指定されていない場合、-installFixes オプションは、デフォルトの all に設定されます。
      • オファリング・バージョンが指定されている場合、-installFixes オプションは、デフォルトの none に設定されます。
    • 組み込み可能 EJB コンテナーおよび JPA クライアントをインストールするには、オファリング ID の後に、任意の embeddablecontainer フィーチャーをコンマで区切って指定します。
      注: 16.0.0.2 フィックスパック時点の組み込み可能 EJB コンテナーおよび JPA クライアントのフィーチャーについて削除通知が発行されたため、このフィーチャーは今後の削除対象です。詳しくは、削除通知を参照してください。

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

      組み込み可能 EJB コンテナーと共に JPA クライアントを使用すると、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 製品資料を参照してください。


トピックのタイプを示すアイコン タスク・トピック

ファイル名: twlp_ins_installation_dist_cl.html