Agent-based Installer を使用したオンプレミスクラスターのインストール

1. 推奨される方法: install-config.yaml および agent-config.yaml

   agent-config.yaml.file のサンプル

   cat > agent-config.yaml << EOF
   apiVersion: v1alpha1
   kind: AgentConfig
   metadata:
     name: sno-cluster
   rendezvousIP: 192.168.111.80 1
   hosts:
     - hostname: master-0
       interfaces:
         - name: eno1
           macAddress: 00:ef:44:21:e6:a5 2
       networkConfig:
         interfaces:
           - name: eno1
             type: ethernet
             state: up
             mac-address: 00:ef:44:21:e6:a5
             ipv4:
               enabled: true
               address:
                 - ip: 192.168.111.80 3
                   prefix-length: 23 4
               dhcp: false
         dns-resolver:
           config:
             server:
               - 192.168.111.1 5
         routes:
           config:
             - destination: 0.0.0.0/0
               next-hop-address: 192.168.111.1 6
               next-hop-interface: eno1
               table-id: 254
   EOF

   1

   rendezvousIP フィールドに値が指定されていない場合、networkConfig フィールドで指定された静的 IP アドレスから 1 つのアドレスが選択されます。

   2

   設定を適用するホストを決定するために使用される、ホスト上のインターフェイスの MAC アドレス。

   3

   ターゲットのベアメタルホストの静的 IP アドレス。

   4

   ターゲットのベアメタルホストの静的 IP アドレスのサブネット接頭辞。

   5

   ターゲットのベアメタルホストの DNS サーバー。

   6

   ノードトラフィックのネクストホップアドレス。これは、指定されたインターフェイスに設定される IP アドレスと同じサブネットにある必要があります。

2. オプションの方法: GitOps ZTP マニフェスト

   GitOps ZTP カスタムリソースのオプションの方法は、6 つのカスタムリソースで構成されます。静的 IP は nmstateconfig.yaml で設定できます。

   apiVersion: agent-install.openshift.io/v1beta1
   kind: NMStateConfig
   metadata:
     name: master-0
     namespace: openshift-machine-api
     labels:
       cluster0-nmstate-label-name: cluster0-nmstate-label-value
   spec:
     config:
       interfaces:
         - name: eth0
           type: ethernet
           state: up
           mac-address: 52:54:01:aa:aa:a1
           ipv4:
             enabled: true
             address:
               - ip: 192.168.122.2 1
                 prefix-length: 23 2
             dhcp: false
       dns-resolver:
         config:
           server:
             - 192.168.122.1 3
       routes:
         config:
           - destination: 0.0.0.0/0
             next-hop-address: 192.168.122.1 4
             next-hop-interface: eth0
             table-id: 254
     interfaces:
       - name: eth0
         macAddress: 52:54:01:aa:aa:a1 5

   1

   ターゲットのベアメタルホストの静的 IP アドレス。

   2

   ターゲットのベアメタルホストの静的 IP アドレスのサブネット接頭辞。

   3

   ターゲットのベアメタルホストの DNS サーバー。

   4

   ノードトラフィックのネクストホップアドレス。これは、指定されたインターフェイスに設定される IP アドレスと同じサブネットにある必要があります。

   5

   設定を適用するホストを決定するために使用される、ホスト上のインターフェイスの MAC アドレス。

1. API ロードバランサー: プラットフォームと対話およびプラットフォームを設定するためのユーザー向けの共通のエンドポイントを提供します。以下の条件を設定します。

   • Layer 4 の負荷分散のみ。これは、Raw TCP、SSL パススルー、または SSL ブリッジモードと呼ばれます。SSL ブリッジモードを使用する場合は、API ルートの Server Name Indication (SNI) を有効にする必要があります。
   • ステートレス負荷分散アルゴリズム。オプションは、ロードバランサーの実装によって異なります。
   重要

   API ロードバランサーのセッションの永続性は設定しないでください。

   ロードバランサーのフロントとバックの両方で以下のポートを設定します。

   表1.5 API ロードバランサー

   ポート	バックエンドマシン (プールメンバー)	内部	外部	説明
   6443	コントロールプレーンAPI サーバーのヘルスチェックプローブの /readyz エンドポイントを設定する必要があります。	X	X	Kubernetes API サーバー
   22623	コントロールプレーン	X		マシン設定サーバー

   注記

   ロードバランサーは、API サーバーが /readyz エンドポイントをオフにしてからプールから API サーバーインスタンスを削除するまで最大 30 秒かかるように設定する必要があります。/readyz の後の時間枠内でエラーが返されたり、正常になったりする場合は、エンドポイントが削除または追加されているはずです。5 秒または 10 秒ごとにプローブし、2 つの正常な要求が正常な状態になり、3 つの要求が正常な状態になりません。これらは十分にテストされた値です。

2. Application Ingress ロードバランサー: クラスター外から送られるアプリケーショントラフィックの Ingress ポイントを提供します。Ingress ルーターの作業用の設定が OpenShift Container Platform クラスターに必要です。

   以下の条件を設定します。

   • Layer 4 の負荷分散のみ。これは、Raw TCP、SSL パススルー、または SSL ブリッジモードと呼ばれます。SSL ブリッジモードを使用する場合は、Ingress ルートの Server Name Indication (SNI) を有効にする必要があります。
   • 選択可能なオプションやプラットフォーム上でホストされるアプリケーションの種類に基づいて、接続ベースの永続化またはセッションベースの永続化が推奨されます。
   ヒント

   クライアントの実際の IP アドレスがアプリケーション Ingress ロードバランサーによって確認できる場合、ソースの IP ベースのセッション永続化を有効にすると、エンドツーエンドの TLS 暗号化を使用するアプリケーションのパフォーマンスを強化できます。

   ロードバランサーのフロントとバックの両方で以下のポートを設定します。

   表1.6 アプリケーション Ingress ロードバランサー

   ポート	バックエンドマシン (プールメンバー)	内部	外部	説明
   443	デフォルトで Ingress コントローラー Pod、コンピュート、またはワーカーを実行するマシン。	X	X	HTTPS トラフィック
   80	デフォルトで Ingress コントローラー Pod、コンピュート、またはワーカーを実行するマシン。	X	X	HTTP トラフィック

   注記

   ゼロ (0) コンピュートノードで 3 ノードクラスターをデプロイする場合、Ingress コントローラー Pod はコントロールプレーンノードで実行されます。3 ノードクラスターデプロイメントでは、HTTP および HTTPS トラフィックをコントロールプレーンノードにルーティングするようにアプリケーション Ingress ロードバランサーを設定する必要があります。

手順

1. oc-mirror プラグインを使用してリリースイメージをミラーリングした場合:

   1. 結果ディレクトリーにある imageContentSourcePolicy.yaml を開きます (例: oc-mirror-workspace/results-1682697932/)。
   2. yaml ファイルの repositoryDigestMirrors セクションのテキストをコピーします。

2. oc adm release mirror コマンドを使用してリリースイメージをミラーリングした場合:

   • コマンド出力の imageContentSources セクションのテキストをコピーします。
3. コピーしたテキストを install-config.yaml ファイルの imageContentSources フィールドに貼り付けます。

4. ミラーレジストリーに使用される証明書ファイルを yaml ファイルの additionalTrustBundle フィールドに追加します。

   重要

   この値は、ミラーレジストリーに使用した証明書ファイルの内容である必要があります。証明書ファイルは、既存の信頼できる認証局、またはミラーレジストリー用に生成した自己署名証明書のいずれかです。

   install-config.yaml ファイルの例

     additionalTrustBundle: |
       -----BEGIN CERTIFICATE-----
       ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ
       -----END CERTIFICATE-----

5. GitOps ZTP マニフェストを使用している場合： registries.conf および ca-bundle.crt ファイルを mirror パスに追加して、エージェント ISO イメージにミラー設定を追加します。

   注記

   oc adm release mirror コマンドまたは oc mirror プラグインの出力から registries.conf ファイルを作成できます。/etc/containers/registries.conf ファイルの形式が変更されました。現在のバージョンはバージョン 2 で、TOML 形式です。

   registries.conf ファイルの例

   [[registry]]
   location = "registry.ci.openshift.org/ocp/release" mirror-by-digest-only = true
   
   [[registry.mirror]] location = "virthost.ostest.test.metalkube.org:5000/localimages/local-release-image"
   
   [[registry]]
   location = "quay.io/openshift-release-dev/ocp-v4.0-art-dev" mirror-by-digest-only = true
   
   [[registry.mirror]] location = "virthost.ostest.test.metalkube.org:5000/localimages/local-release-image"

手順

1. ログイン認証情報を使用して OpenShift Container Platform Web コンソールにログインします。
2. データセンター に移動します。
3. Run Agent-based Installer locally をクリックします。
4. OpenShift インストーラー と コマンドラインインターフェイス のオペレーティングシステムとアーキテクチャーを選択します。
5. Download Installer をクリックして、インストールプログラムをダウンロードして展開します。
6. Download pull secret または Copy pull secret をクリックして、プルシークレットをダウンロードまたはコピーします。
7. Download command-line tools をクリックし、openshift-install バイナリーを PATH 上のディレクトリーに配置します。

手順

1. OpenShift CLI (oc) にログインします。

2. 次のコマンドを実行して、リリースペイロードを確認します。

   $ ./openshift-install version

   出力例

   ./openshift-install 4.17.0
   built from commit abc123def456
   release image quay.io/openshift-release-dev/ocp-release@sha256:123abc456def789ghi012jkl345mno678pqr901stu234vwx567yz0
   release architecture amd64

   multi ペイロードが含まれるリリースイメージを使用している場合、このコマンドの出力に表示される release architecture はデフォルトのアーキテクチャーです。

3. ペイロードのアーキテクチャーを確認するには、次のコマンドを実行します。

   $ oc adm release info <release_image> -o jsonpath="{ .metadata.metadata}" 1

   1

   <release_image> をリリースイメージに置き換えます。例: quay.io/openshift-release-dev/ocp-release@sha256:123abc456def789ghi012jkl345mno678pqr901stu234vwx567yz0。

   リリースイメージが multi ペイロードを使用する場合の出力例

   {"release.openshift.io architecture":"multi"}

   multi ペイロードが含まれるリリースイメージを使用している場合は、arm64、amd64、s390x、ppc64le などのさまざまなアーキテクチャーにクラスターをインストールできます。それ以外の場合、クラスターは openshift-install version コマンドの出力に表示される release architecture にのみインストールできます。

手順

1. 以下のコマンドを実行して nmstate の依存関係をインストールします。

   $ sudo dnf install /usr/bin/nmstatectl -y

2. PATH にあるディレクトリーに openshift-install バイナリーを配置します。

3. 次のコマンドを実行して、インストール設定を保存するディレクトリーを作成します。

   $ mkdir ~/<directory_name>

   注記

   これは、エージェントベースのインストールで推奨される方法です。GitOps ZTP マニフェストの使用はオプションです。

4. 次のコマンドを実行して、install-config.yaml ファイルを作成します。

   $ cat << EOF > ./<directory_name>/install-config.yaml
   apiVersion: v1
   baseDomain: test.example.com
   compute:
   - architecture: amd64 1
     hyperthreading: Enabled
     name: worker
     replicas: 0
   controlPlane:
     architecture: amd64
     hyperthreading: Enabled
     name: master
     replicas: 1
   metadata:
     name: sno-cluster 2
   networking:
     clusterNetwork:
     - cidr: 10.128.0.0/14
       hostPrefix: 23
     machineNetwork:
     - cidr: 192.168.0.0/16
     networkType: OVNKubernetes 3
     serviceNetwork:
     - 172.30.0.0/16
   platform: 4
     none: {}
   pullSecret: '<pull_secret>' 5
   sshKey: '<ssh_pub_key>' 6
   EOF

   1

   システムアーキテクチャーを指定します。有効な値は、amd64、arm64、ppc64le、および s390x です。

   multi ペイロードが含まれるリリースイメージを使用している場合は、arm64、amd64、s390x、ppc64le などのさまざまなアーキテクチャーにクラスターをインストールできます。それ以外の場合、クラスターは openshift-install version コマンドの出力に表示される release architecture にのみインストールできます。詳細は、「Agent-based Installer クラスターをインストールするためのサポート対象アーキテクチャーを確認する」を参照してください。

   2

   必須。クラスター名を指定します。

   3

   インストールするクラスターネットワークプラグイン。サポートされる値はデフォルト値の OVNKubernetes のみです。

   4

   プラットフォームを指定します。

   注記

   ベアメタルプラットフォームの場合、agent-config.yaml ファイル上での設定でオーバーライドされない限り、install-config.yaml ファイルのプラットフォームセクションでのホスト設定がデフォルトで使用されます。

   5

   プルシークレットを指定します。

   6

   SSH 公開鍵を指定します。

   注記

   プラットフォームを vSphere または baremetal に設定すると、クラスターノードの IP アドレスエンドポイントを次の 3 つの方法で設定できます。

   • IPv4
   • IPv6
   • IPv4 と IPv6 の並列 (デュアルスタック)

   IPv6 は、ベアメタルプラットフォームでのみサポートされます。

   デュアルスタックネットワーキングの例

   networking:
     clusterNetwork:
       - cidr: 172.21.0.0/16
         hostPrefix: 23
       - cidr: fd02::/48
         hostPrefix: 64
     machineNetwork:
       - cidr: 192.168.11.0/16
       - cidr: 2001:DB8::/32
     serviceNetwork:
       - 172.22.0.0/16
       - fd03::/112
     networkType: OVNKubernetes
   platform:
     baremetal:
       apiVIPs:
       - 192.168.11.3
       - 2001:DB8::4
       ingressVIPs:
       - 192.168.11.4
       - 2001:DB8::5

   注記

   非接続ミラーレジストリーを使用する場合は、作成済みのミラーレジストリー用の証明書ファイルを install-config.yaml ファイルの additionalTrustBundle フィールドに追加する必要があります。

5. 次のコマンドを実行して、agent-config.yaml ファイルを作成します。

   $ cat > agent-config.yaml << EOF
   apiVersion: v1beta1
   kind: AgentConfig
   metadata:
     name: sno-cluster
   rendezvousIP: 192.168.111.80 1
   hosts: 2
     - hostname: master-0 3
       interfaces:
         - name: eno1
           macAddress: 00:ef:44:21:e6:a5
       rootDeviceHints: 4
         deviceName: /dev/sdb
       networkConfig: 5
         interfaces:
           - name: eno1
             type: ethernet
             state: up
             mac-address: 00:ef:44:21:e6:a5
             ipv4:
               enabled: true
               address:
                 - ip: 192.168.111.80
                   prefix-length: 23
               dhcp: false
         dns-resolver:
           config:
             server:
               - 192.168.111.1
         routes:
           config:
             - destination: 0.0.0.0/0
               next-hop-address: 192.168.111.2
               next-hop-interface: eno1
               table-id: 254
   EOF

   1

   この IP アドレスは、ブートストラッププロセスを実行するノードや、assisted-service コンポーネントを実行するノードを判別するために使用されます。networkConfig パラメーターで少なくとも 1 つのホストの IP アドレスを指定しない場合は、ランデブー IP アドレスを指定する必要があります。このアドレスが指定されていない場合は、指定されたホストの networkConfig から 1 つの IP アドレスが選択されます。

   2

   オプション: ホスト設定。定義されたホストの数は、install-config.yaml ファイルで定義されたホストの総数 (compute.replicas および controlPlane.replicas パラメーターの値の合計) を超えてはなりません。

   3

   オプション: 動的ホスト設定プロトコル (DHCP) または逆引き DNS ルックアップから取得したホスト名をオーバーライドします。各ホストには、これらの方法のいずれかによって提供される一意のホスト名が必要です。

   4

   特定デバイスへの Red Hat Enterprise Linux CoreOS (RHCOS) イメージのプロビジョニングを有効にします。インストールプログラムは、検出順にデバイスを検査し、検出された値をヒントの値と比較します。ヒントの値と一致する最初に検出されたデバイスが使用されます。

   5

   オプション: ホストのネットワークインターフェイスを NMState 形式で設定します。

手順

1. 次のコマンドを実行して、ZTP クラスターマニフェストを生成します。

   $ openshift-install agent create cluster-manifests --dir <installation_directory>

   重要

   install-config.yaml ファイルと agent-config.yaml ファイルを作成した場合、それらのファイルは削除され、このコマンドで生成されたクラスターマニフェストに置き換えられます。

   install-config.yaml ファイルと agent-config.yaml ファイルに対して行われた設定は、openshift-install agent create cluster-manifests コマンドを実行すると ZTP クラスターマニフェストにインポートされます。

2. 次のコマンドを実行して、cluster-manifests ディレクトリーに移動します。

   $ cd <installation_directory>/cluster-manifests

3. cluster-manifests ディレクトリー内のマニフェストファイルを設定します。サンプルファイルの詳細は、「サンプル GitOps ZTP カスタムリソース」セクションを参照してください。

4. 非接続クラスター: ZTP マニフェストを生成する前に install-config.yaml ファイルでミラー設定を定義しなかった場合は、次の手順を実行します。

   1. 次のコマンドを実行して、mirror ディレクトリーに移動します。

      $ cd ../mirror

   2. mirror ディレクトリーにマニフェストファイルを設定します。

手順

1. 次のコマンドを実行して、ZTP クラスターマニフェストを生成します。

   $ openshift-install agent create cluster-manifests --dir <installation_directory>

   重要

   install-config.yaml ファイルと agent-config.yaml ファイルを作成した場合、それらのファイルは削除され、このコマンドで生成されたクラスターマニフェストに置き換えられます。

   install-config.yaml ファイルと agent-config.yaml ファイルに対して行われた設定は、openshift-install agent create cluster-manifests コマンドを実行すると ZTP クラスターマニフェストにインポートされます。

   注記

   すでに ZTP マニフェストを生成している場合は、この手順をスキップしてください。

2. 次のコマンドを実行して、cluster-manifests ディレクトリーに移動します。

   $ cd <installation_directory>/cluster-manifests

3. 次のセクションを agent-cluster-install.yaml ファイルに追加します。

   diskEncryption:
       enableOn: all 1
       mode: tang 2
       tangServers: "server1": "http://tang-server-1.example.com:7500" 3

   1

   ディスク暗号化を有効にするノードを指定します。有効な値は none、all、master、worker です。

   2

   使用するディスク暗号化モードを指定します。有効な値は tpmv2 および tang です。

   3

   オプション: Tang を使用している場合は、Tang サーバーを指定します。

手順

1. 以下のコマンドを実行して agent イメージを作成します。

   $ openshift-install --dir <install_directory> agent create image

   注記

   Red Hat Enterprise Linux CoreOS (RHCOS) はプライマリーディスクでのマルチパスをサポートするようになり、ハードウェア障害に対する対障害性が強化され、ホストの可用性を強化できるようになりました。マルチパス化は、デフォルトの /etc/multipath.conf 設定を使用して、agent ISO イメージでデフォルトで有効になっています。

2. ベアメタルマシンで、agent.x86_64.iso、agent.aarch64.iso、または agent.s390x.iso イメージを起動します。

手順

1. RHEL KVM マシンを起動します。

2. 仮想サーバーをデプロイするために、次のパラメーターを指定して virt-install コマンドを実行します。

   $ virt-install
       --name <vm_name> \
       --autostart \
       --memory=<memory> \
       --cpu host \
       --vcpus=<vcpus> \
       --cdrom <agent_iso_image> \ 1
       --disk pool=default,size=<disk_pool_size> \
       --network network:default,mac=<mac_address> \
       --graphics none \
       --noautoconsole \
       --os-variant rhel9.0 \
       --wait=-1

   1

   --cdrom パラメーターには、HTTP または HTTPS サーバー上の ISO イメージの場所を指定します。

手順

1. エージェントコンソールアプリケーションが、設定されたリリースイメージをレジストリーからプルできるかどうかを確認するまで待ちます。

2. エージェントコンソールアプリケーションが、インストーラーの接続チェックに合格したことを示している場合は、プロンプトがタイムアウトになるまで待って、インストールを続行します。

   注記

   接続チェックに合格した場合も、ネットワーク設定の表示または変更を選択できます。

   ただし、タイムアウトせずに、エージェントコンソールアプリケーションとやりとりすることを選択した場合は、TUI を手動で終了して、インストールを続行する必要があります。

3. エージェントコンソールアプリケーションのチェックが失敗した場合は、Release image URL プルチェックの横に赤いアイコンが表示されます。ホストのネットワーク設定を再設定するには、次の手順を使用します。

   1. TUI の Check Errors セクションを読みます。このセクションには、失敗したチェックに固有のエラーメッセージが表示されます。

      
   2. Configure network を選択して、NetworkManager TUI を起動します。
   3. Edit a connection を選択し、再設定する接続を選択します。
   4. 設定を編集し、OK を選択して、変更を保存します。
   5. Back を選択して、NetworkManager TUI のメイン画面に戻ります。
   6. Activate a Connection を選択します。
   7. 再設定されたネットワークを選択して、非アクティブ化します。
   8. 再設定されたネットワークを再度選択して、再アクティブ化します。
   9. Back を選択し、Quit を選択して、エージェントコンソールアプリケーションに戻ります。
   10. 新しいネットワーク設定を使用して、継続的なネットワークチェックが再開されるまで、5 秒間以上、待ちます。
   11. Release image URL プルチェックが成功し、URL の横に緑色のアイコンが表示された場合は、Quit を選択して、エージェントコンソールアプリケーションを終了し、インストールを続行します。

手順

1. オプション: ブートストラップホスト (ランデブーホスト) がいつ再起動するかを知るには、次のコマンドを実行します。

   $ ./openshift-install --dir <install_directory> agent wait-for bootstrap-complete \1
       --log-level=info 2

   1

   <install_directory> には、エージェント ISO が生成されたディレクトリーへのパスを指定します。

   2

   異なるインストールの詳細情報を表示するには、info ではなく、warn、debug、または error を指定します。

   出力例

   ...................................................................
   ...................................................................
   INFO Bootstrap configMap status is complete
   INFO cluster bootstrap is complete

   Kubernetes API サーバーでこれがコントロールプレーンマシンにブートストラップされていることを示すシグナルが出されるとコマンドは成功します。

2. 進行状況を追跡し、インストールが成功したことを確認するには、次のコマンドを実行します。

   $ openshift-install --dir <install_directory> agent wait-for install-complete 1

   1

   <install_directory> directory には、エージェント ISO が生成されたディレクトリーへのパスを指定します。

   出力例

   ...................................................................
   ...................................................................
   INFO Cluster is installed
   INFO Install complete!
   INFO To access the cluster as the system:admin user when using 'oc', run
   INFO     export KUBECONFIG=/home/core/installer/auth/kubeconfig
   INFO Access the OpenShift web-console here: https://console-openshift-console.apps.sno-cluster.test.example.com

1. サポート対象: インストール手順に ai.ip_cfg_override パラメーターが必要な場合。
2. 該当なし: ネットワークカードがハイパーバイザーで使用できない場合。
3. 不要: インストール手順で ai.ip_cfg_override パラメーターが必要ない場合。

手順

1. z/VM ゲストのパラメーターファイルを作成します。

   パラメーターファイルの例

   rd.neednet=1 \
   console=ttysclp0 \
   coreos.live.rootfs_url=<rootfs_url> \ 1
   ip=172.18.78.2::172.18.78.1:255.255.255.0:::none nameserver=172.18.78.1 \ 2
   zfcp.allow_lun_scan=0 \ 3
   ai.ip_cfg_override=1 \
   rd.znet=qeth,0.0.bdd0,0.0.bdd1,0.0.bdd2,layer2=1 \
   rd.dasd=0.0.4411 \ 4
   rd.zfcp=0.0.8001,0x50050763040051e3,0x4000406300000000 \ 5
   random.trust_cpu=on rd.luks.options=discard \
   ignition.firstboot ignition.platform.id=metal \
   console=tty1 console=ttyS1,115200n8 \
   coreos.inst.persistent-kargs="console=tty1 console=ttyS1,115200n8"

   1

   coreos.live.rootfs_url アーティファクトには、起動する kernel と initramfs に合った rootfs アーティファクトを指定します。HTTP プロトコルおよび HTTPS プロトコルのみがサポートされます。

   2

   ip= パラメーターには、DHCP を使用して自動的に IP アドレスを割り当てるか、「z/VM を使用したクラスターの IBM Z® および IBM® LinuxONE へのインストール」の説明に従って手動で割り当てます。

   3

   デフォルトは 1 です。OSA ネットワークアダプターを使用する場合は、このエントリーを省略してください。

   4

   DASD タイプのディスクにインストールする場合は、rd.dasd を使用して、Red Hat Enterprise Linux CoreOS (RHCOS) をインストールする DASD を指定します。FCP タイプのディスクの場合は、このエントリーを省略します。

   5

   FCP タイプのディスクにインストールする場合は、rd.zfcp=<adapter>,<wwpn>,<lun> を使用して、RHCOS がインストールされる FCP ディスクを指定します。DASD タイプのディスクの場合は、このエントリーを省略します。

   その他のパラメーターはすべて変更しません。

2. z/VM ゲスト仮想マシンの仮想リーダーに対して、kernel.img、generic.parm、および initrd.img ファイルの punch を実行します。

   詳細は、PUNCH (IBM ドキュメント) を参照してください。

   ヒント

   CP PUNCH コマンドを使用するか、Linux を使用している場合は vmur コマンドを使用して、2 つの z/VM ゲスト仮想マシン間でファイルを転送できます。

3. ブートストラップマシン上の会話型モニターシステム (CMS) にログインします。

4. 次のコマンドを実行して、リーダーからブートストラップマシンを IPL します。

   $ ipl c

   詳細は、IPL (IBM ドキュメント) を参照してください。

手順

1. RHEL KVM マシンを起動します。

2. 仮想サーバーをデプロイするために、次のパラメーターを指定して virt-install コマンドを実行します。

   $ virt-install \
      --name <vm_name> \
      --autostart \
      --ram=16384 \
      --cpu host \
      --vcpus=8 \
      --location <path_to_kernel_initrd_image>,kernel=kernel.img,initrd=initrd.img \1
      --disk <qcow_image_path> \
      --network network:macvtap ,mac=<mac_address> \
      --graphics none \
      --noautoconsole \
      --wait=-1 \
      --extra-args "rd.neednet=1 nameserver=<nameserver>" \
      --extra-args "ip=<IP>::<nameserver>::<hostname>:enc1:none" \
      --extra-args "coreos.live.rootfs_url=http://<http_server>:8080/agent.s390x-rootfs.img" \
      --extra-args "random.trust_cpu=on rd.luks.options=discard" \
      --extra-args "ignition.firstboot ignition.platform.id=metal" \
      --extra-args "console=tty1 console=ttyS1,115200n8" \
      --extra-args "coreos.inst.persistent-kargs=console=tty1 console=ttyS1,115200n8" \
      --osinfo detect=on,require=off

   1

   --location パラメーターには、HTTP または HTTPS サーバー上の kernel/initrd の場所を指定します。

手順

1. エージェントのブートパラメーターファイルを作成します。

   パラメーターファイルの例

   rd.neednet=1 cio_ignore=all,!condev \
   console=ttysclp0 \
   ignition.firstboot ignition.platform.id=metal
   coreos.live.rootfs_url=http://<http_server>/rhcos-<version>-live-rootfs.<architecture>.img \1
   coreos.inst.persistent-kargs=console=ttysclp0
   ip=<ip>::<gateway>:<netmask>:<hostname>::none nameserver=<dns> \2
   rd.znet=qeth,<network_adaptor_range>,layer2=1
   rd.<disk_type>=<adapter> \3
   zfcp.allow_lun_scan=0
   ai.ip_cfg_override=1 \//
   random.trust_cpu=on rd.luks.options=discard

   1

   coreos.live.rootfs_url アーティファクトには、起動する kernel と initramfs に合った rootfs アーティファクトを指定します。HTTP プロトコルおよび HTTPS プロトコルのみがサポートされます。

   2

   ip パラメーターは、z/VM を使用したクラスターの IBM Z および IBM IBM® LinuxONE へのインストール の説明に従って、IP アドレスを手動で割り当てます。

   3

   DASD タイプのディスクにインストールする場合は、rd.dasd を使用して、Red Hat Enterprise Linux CoreOS (RHCOS) をインストールする DASD を指定します。FCP タイプのディスクにインストールする場合は、rd.zfcp=<adapter>,<wwpn>,<lun> を使用して、RHCOS がインストールされる FCP ディスクを指定します。

   注記

   .ins および initrd.img.addrsize ファイルは、インストールプログラムからのブートアーティファクトの一部として s390x アーキテクチャー用に自動的に生成され、LPAR 環境でのブート時にのみ使用されます。

   LPAR ブートによるファイルシステムの例

   boot-artifacts
       ├─ agent.s390x-generic.ins
       ├─ agent.s390x-initrd.addrsize
       ├─ agent.s390x-rootfs.img
       └─ agent.s390x-kernel.img
       └─ agent.s390x-rootfs.img

2. initrd、kernel、generic.ins、および initrd.img.addrsize パラメーターファイルをファイルサーバーに転送します。詳細は、Booting Linux in LPAR mode (IBM ドキュメント) を参照してください。
3. マシンを起動します。
4. クラスター内の他のマシンすべてに対してこの手順を繰り返します。