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

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

始める前に

[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 バージョンを使用できます。

この手順を使用する前に、インストールの準備をします。詳しくは、『IBM i でのインストールのためのオペレーティング・システムの準備』を参照してください。

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

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

製品のインストール先となるシステムに IBM Installation Manager バージョン 1.8.5 以降 がまだインストールされていない場合は、以下の手順でインストールします。

  1. IBM Installation Manager をダウンロードします。
    Installation Manager インストール・ファイルへのアクセスには、基本的な 3 つのオプションがあります。
    • IBM Installation Manager のダウンロード Web サイトから、最新バージョンの Installation Manager をダウンロードする。
    • メディア上の製品リポジトリーから Installation Manager をインストールする。
    • パスポート・アドバンテージのサイトからファイルをダウンロードして、ローカル・インストールを行う。

      Passport Advantage® ID とパスワードをお持ちで、ライセンス交付を受けたお客様は、Passport Advantage サイトから必要な製品リポジトリーをダウンロードできます。

  2. Installation Manager のバイナリー、ランタイム・データ (エージェント・データ)、および共有データのロケーションとして 3 つの異なるロケーションを選択します。
  3. Installation Manager コマンド行を使用して Installation Manager をインストールします。
    1. *ALLOBJ および *SECADM 特殊権限のあるユーザー・プロファイルを使用して、IBM i システムにサインオンします。
    2. CL コマンド行で STRQSH コマンドを 実行して、Qshell コマンド・シェルを開始します。
    3. umask が 022 に設定されていることを確認します。
      umask 設定を確認するには、以下のコマンドを実行します。
      umask
      umask 設定を 022 に設定するには、以下のコマンドを実行します。
      umask 022
    4. Installation Manager のインストール・ファイルが含まれているロケーションに移動して、以下のコマンドを実行します。
      installc -acceptLicense -log log_file_path_and_name
      注:
      • Installation Manager のインストールについて詳しくは、IBM Installation Manager 製品資料を参照してください。
      • Installation Manager のインストールには、installc コマンドのみを使用します。

このタスクについて

Liberty 製品オファリングおよびその他の使用可能なソフトウェアを含め、すべての製品オファリングを、同一の 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. *ALLOBJ および *SECADM 特殊権限のあるユーザー・プロファイルを使用して、IBM i システムにサインオンします。
  3. CL コマンド行で STRQSH コマンドを 実行して、Qshell コマンド・シェルを開始します。
  4. umask が 022 に設定されていることを確認します。
    umask 設定を確認するには、以下のコマンドを実行します。
    umask
    umask 設定を 022 に設定するには、以下のコマンドを実行します。
    umask 022
  5. Installation Manager をインストールしたディレクトリーの eclipse/tools サブディレクトリーに移動します。
  6. imcl コマンドを使用して、この製品をインストールします。
    ./imcl install com.ibm.websphere.liberty.CORE.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 install com.ibm.websphere.liberty.CORE.ND,embeddablecontainer             
      -properties user.addon=extendedPackage-1.0,user.feature=portlet-2.0,,portletserving-2.0
      -installationDirectory /QIBM/ProdData/WebSphere/Liberty/LibertyCore -acceptLicense
      -repositories /QIBM/LibertyProductRepo,https://your_onprem_asset_repo_url,/QIBM/LocalAssetRepo,/QIBM/LocalAssetRepo2.zip
      -sharedResourcesDirectory /QIBM/UserData/InstallationManager/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="" パラメーターを指定します。
    • 関連する使用許諾条件、注意事項、およびお知らせは、このオファリングのインストール・イメージまたはリポジトリーの lafiles または offering_name/lafiles サブディレクトリーにある使用許諾契約書のファイルで提供されています。
    • 初めて 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 フィーチャーを指定します。
      imcl install com.ibm.websphere.liberty.CORE.ND,embeddablecontainer

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

      組み込み可能 EJB コンテナーと共に JPA クライアントを使用すると、Java SE 環境で Java Persistence API 機能を使用できるようになります。

    • 初期インストールの場合、 user_data_root を指定することが推奨されます。指定しないと、 user_data_root のデフォルト値である /QIBM/UserData/WebSphere/Liberty/EDITION が使用されます。user_data_root を指定するには、was.install.os400.profile.location プロパティーを使用します。
    • プログラムが重要なポストインストール指示を標準出力に書き込むことがあります。

    imcl コマンドを使用して製品をインストールする方法について詳しくは、IBM Installation Manager 製品資料を参照してください。

以下に imcl コマンドを使用して WebSphere Application Server Liberty Core をインストールする場合の例を示します。
./imcl install com.ibm.websphere.liberty.CORE.ND
  -repositories https://downloads.mycorp.com:8080/WAS_Liberty_repository
  -installationDirectory /QIBM/ProdData/WebSphere/Liberty/LibertyCore
  -properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/Liberty/LibertyCore
  -sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
  -secureStorageFile $HOME/WASFiles/temp/credential.store -masterPasswordFile $HOME/WASFiles/IM/master_password_file.txt
  -acceptLicense

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

ファイル名: twlp_ins_installation_is_cl.html