12.2. 単一ノードでの OpenShift のインストール

手順

1. 管理ホストでブラウザーを開き、Red Hat OpenShift Cluster Manager に移動します。
2. Create Cluster をクリックして新規クラスターを作成します。
3. Cluster name フィールドにクラスターの名前を入力します。

4. Base domain フィールドにベースドメインを入力します。以下に例を示します。

   example.com

   すべての DNS レコードはこのベースドメインのサブドメインである必要があり、クラスター名が含まれる必要があります。以下に例を示します。

   <cluster-name>.example.com

   注記

   クラスターのインストール後にベースドメインまたはクラスター名を変更することはできません。

5. Install single node OpenShift (SNO) を選択し、ウィザードの残りの手順を完了します。検出 ISO をダウンロードします。
6. 仮想メディアを使用してインストールするための検出 ISO URL を書き留めておきます。

手順

1. RHCOS 検出 ISO をターゲットホストにアタッチします。
2. サーバーの BIOS 設定で起動ドライブの順序を設定して、アタッチされた検出 ISO から起動し、サーバーを再起動します。
3. 管理ホストで、ブラウザーに戻ります。ホストが、検出されたホストのリストに表示されるまで待ちます。必要に応じて、Assisted Clusters ページを再読み込みし、クラスター名を選択します。
4. インストールウィザードの手順を完了します。使用可能なサブネットからのサブネットを含む、ネットワークの詳細を追加します。必要に応じて SSH 公開鍵を追加します。
5. インストールの進捗を監視します。クラスターイベントを確認します。インストールプロセスがサーバーのハードディスクへのオペレーティングシステムイメージの書き込みを完了すると、サーバーが再起動します。

6. 検出 ISO を削除し、インストールドライブから起動するようにサーバーをリセットします。

   サーバーが自動的に数回再起動し、コントロールプレーンがデプロイされます。

手順

1. OpenShift Container Platform バージョンを設定します。

   $ OCP_VERSION=<ocp_version> 1

   1

   <ocp_version> は、現在のバージョン (latest-4.16 など) に置き換えます。

2. ホストアーキテクチャーを設定します。

   $ ARCH=<architecture> 1

   1

   <architecture> をターゲットホストアーキテクチャー (aarch64 や x86_64 など) に置き換えます。

3. OpenShift Container Platform クライアント (oc) をダウンロードし、次のコマンドを入力して使用できるようにします。

   $ curl -k https://mirror.openshift.com/pub/openshift-v4/clients/ocp/$OCP_VERSION/openshift-client-linux.tar.gz -o oc.tar.gz

   $ tar zxf oc.tar.gz

   $ chmod +x oc

4. OpenShift Container Platform インストーラーをダウンロードし、以下のコマンドを入力して使用できるようにします。

   $ curl -k https://mirror.openshift.com/pub/openshift-v4/clients/ocp/$OCP_VERSION/openshift-install-linux.tar.gz -o openshift-install-linux.tar.gz

   $ tar zxvf openshift-install-linux.tar.gz

   $ chmod +x openshift-install

5. 次のコマンドを実行して、RHCOS ISO URL を取得します。

   $ ISO_URL=$(./openshift-install coreos print-stream-json | grep location | grep $ARCH | grep iso | cut -d\" -f4)

6. RHCOS ISO をダウンロードします。

   $ curl -L $ISO_URL -o rhcos-live.iso

7. install-config.yaml ファイルを作成します。

   apiVersion: v1
   baseDomain: <domain> 1
   compute:
   - name: worker
     replicas: 0 2
   controlPlane:
     name: master
     replicas: 1 3
   metadata:
     name: <name> 4
   networking: 5
     clusterNetwork:
     - cidr: 10.128.0.0/14
       hostPrefix: 23
     machineNetwork:
     - cidr: 10.0.0.0/16 6
     networkType: OVNKubernetes
     serviceNetwork:
     - 172.30.0.0/16
   platform:
     none: {}
   bootstrapInPlace:
     installationDisk: /dev/disk/by-id/<disk_id> 7
   pullSecret: '<pull_secret>' 8
   sshKey: |
     <ssh_key> 9

   1

   クラスタードメイン名を追加します。

   2

   compute レプリカを 0 に設定します。これにより、コントロールプレーンノードがスケジュール可能になります。

   3

   controlPlane レプリカを 1 に設定します。この設定は、以前の compute 設定と組み合わせて、クラスターが単一ノードで実行されるようにします。

   4

   メタデータ 名をクラスター名に設定します。

   5

   networking の詳細を設定します。OVN-Kubernetes は、単一ノードクラスターで許可されている唯一のネットワークプラグインタイプです。

   6

   単一ノードの OpenShift クラスターのサブネットと一致するように cidr 値を設定します。

   7

   インストールディスクドライブへのパスを設定します (例: /dev/disk/by-id/wwn-0x64cd98f04fde100024684cf3034da5c2)。

   8

   Red Hat OpenShift Cluster Manager からプルシークレット をコピーし、その内容をこの設定に追加します。

   9

   インストール後にクラスターにログインできるように、管理ホストから公開 SSH 鍵を追加します。

8. 以下のコマンドを実行して、OpenShift Container Platform アセットを生成します。

   $ mkdir ocp

   $ cp install-config.yaml ocp

   $ ./openshift-install --dir=ocp create single-node-ignition-config

9. 以下のコマンドを実行して、Ignition データを RHCOS ISO に埋め込みます。

   $ alias coreos-installer='podman run --privileged --pull always --rm \
           -v /dev:/dev -v /run/udev:/run/udev -v $PWD:/data \
           -w /data quay.io/coreos/coreos-installer:release'

   $ coreos-installer iso ignition embed -fi ocp/bootstrap-in-place-for-live-iso.ign rhcos-live.iso

手順

1. 変更した RHCOS インストール ISO をターゲットホストにアタッチします。
2. サーバーの BIOS 設定で起動ドライブの順序を設定して、アタッチされた検出 ISO から起動し、サーバーを再起動します。

3. 管理ホストで、次のコマンドを実行してインストールを監視します。

   $ ./openshift-install --dir=ocp wait-for install-complete

   コントロールプレーンのデプロイ中にサーバーが数回再起動します。

手順

1. 次のコマンドを実行して、OpenShift Container Platform のバージョンを設定します。

   $ OCP_VERSION=<ocp_version> 1

   1

   <ocp_version> を現在のバージョンに置き換えます。たとえば、latest-4.16 です。

2. 次のコマンドを実行して、ホストアーキテクチャーを設定します。

   $ ARCH=<architecture> 1

   1

   <architecture> をターゲットホストアーキテクチャー s390x に置き換えます。

3. OpenShift Container Platform クライアント (oc) をダウンロードし、次のコマンドを入力して使用できるようにします。

   $ curl -k https://mirror.openshift.com/pub/openshift-v4/${ARCH}/clients/ocp/${OCP_VERSION}/openshift-client-linux.tar.gz -o oc.tar.gz

   $ tar zxf oc.tar.gz

   $ chmod +x oc

4. OpenShift Container Platform インストーラーをダウンロードし、以下のコマンドを入力して使用できるようにします。

   $ curl -k https://mirror.openshift.com/pub/openshift-v4/${ARCH}/clients/ocp/${OCP_VERSION}/openshift-install-linux.tar.gz -o openshift-install-linux.tar.gz

   $ tar zxvf openshift-install-linux.tar.gz

   $ chmod +x openshift-install

5. install-config.yaml ファイルを作成します。

   apiVersion: v1
   baseDomain: <domain> 1
   compute:
   - name: worker
     replicas: 0 2
   controlPlane:
     name: master
     replicas: 1 3
   metadata:
     name: <name> 4
   networking: 5
     clusterNetwork:
     - cidr: 10.128.0.0/14
       hostPrefix: 23
     machineNetwork:
     - cidr: 10.0.0.0/16 6
     networkType: OVNKubernetes
     serviceNetwork:
     - 172.30.0.0/16
   platform:
     none: {}
   bootstrapInPlace:
     installationDisk: /dev/disk/by-id/<disk_id> 7
   pullSecret: '<pull_secret>' 8
   sshKey: |
     <ssh_key> 9

   1

   クラスタードメイン名を追加します。

   2

   compute レプリカを 0 に設定します。これにより、コントロールプレーンノードがスケジュール可能になります。

   3

   controlPlane レプリカを 1 に設定します。この設定は、以前の compute 設定と組み合わせて、クラスターが単一ノードで実行されるようにします。

   4

   メタデータ 名をクラスター名に設定します。

   5

   networking の詳細を設定します。OVN-Kubernetes は、単一ノードクラスターで許可されている唯一のネットワークプラグインタイプです。

   6

   単一ノードの OpenShift クラスターのサブネットと一致するように cidr 値を設定します。

   7

   インストールディスクドライブへのパスを設定します (例: /dev/disk/by-id/wwn-0x64cd98f04fde100024684cf3034da5c2)。

   8

   Red Hat OpenShift Cluster Manager からプルシークレット をコピーし、その内容をこの設定に追加します。

   9

   インストール後にクラスターにログインできるように、管理ホストから公開 SSH 鍵を追加します。

6. 以下のコマンドを実行して、OpenShift Container Platform アセットを生成します。

   $ mkdir ocp

   $ cp install-config.yaml ocp

   $ ./openshift-install --dir=ocp create single-node-ignition-config

7. Red Hat カスタマーポータルの 製品ダウンロード ページまたは RHCOS イメージミラー ページから、RHEL kernel、initramfs、および rootfs アーティファクトを取得します。

   重要

   RHCOS イメージは OpenShift Container Platform の各リリースごとに変更されない可能性があります。インストールする OpenShift Container Platform バージョンと等しいか、それ以下のバージョンの内で最も新しいバージョンのイメージをダウンロードする必要があります。この手順で説明されている適切な kernel、initramfs、および rootfs アーティファクトのみを使用します。

   ファイル名には、OpenShift Container Platform のバージョン番号が含まれます。以下の例のようになります。

   kernel

   rhcos-<version>-live-kernel-<architecture>

   initramfs

   rhcos-<version>-live-initramfs.<architecture>.img

   rootfs

   rhcos-<version>-live-rootfs.<architecture>.img

   注記

   rootfs イメージは FCP および DASD の場合と同じです。

8. 次のアーティファクトとファイルを HTTP または HTTPS サーバーに移動します。

   • ダウンロードされた RHEL ライブ kernel、initramfs、および rootfs アーティファクト
   • Ignition ファイル

9. 特定の仮想マシンのパラメーターファイルを作成します。

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

   cio_ignore=all,!condev rd.neednet=1 \
   console=ttysclp0 \
   ignition.firstboot ignition.platform.id=metal \
   ignition.config.url=http://<http_server>:8080/ignition/bootstrap-in-place-for-live-iso.ign \1
   coreos.live.rootfs_url=http://<http_server>/rhcos-<version>-live-rootfs.<architecture>.img \2
   ip=<ip>::<gateway>:<mask>:<hostname>::none nameserver=<dns> \3
   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
   zfcp.allow_lun_scan=0

   1

   ignition.config.url= パラメーターには、マシンロールの Ignition ファイルを指定します。HTTP プロトコルおよび HTTPS プロトコルのみがサポートされます。

   2

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

   3

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

   4

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

   5

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

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

10. 次のアーティファクト、ファイル、イメージを z/VM に転送します。たとえば、FTP を使用する場合は以下のようになります。

    • kernel と initramfs アーティファクト
    • パラメーターファイル

    • RHCOS イメージ

      FTP でファイルを転送し、仮想リーダーから起動する方法については、Z/VM 環境へのインストール を参照してください。

11. ブートストラップノードになる z/VM ゲスト仮想マシンの仮想リーダーに対してファイルの punch を実行します。
12. ブートストラップマシンで CMS にログインします。

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

    $ cp ipl c

14. 仮想マシンを最初に再起動した後、次のコマンドを直接続けて実行します。

    1. 最初の再起動後に DASD デバイスを起動するには、次のコマンドを実行します。

       $ cp i <devno> clear loadparm prompt

       ここでは、以下のようになります。

       <devno>

       ゲストから見えるブートデバイスのデバイス番号を指定します。

       $ cp vi vmsg 0 <kernel_parameters>

       ここでは、以下のようになります。

       <kernel_parameters>

       システム制御プログラムデータ (SCPDATA) として保存されるカーネルパラメーターのセットを指定します。Linux をブートするとき、これらのカーネルパラメーターは、ブート設定で使用される既存のカーネルパラメーターの末尾に連結されます。組み合わせたパラメーター文字列は 896 文字を超えてはなりません。

    2. 最初の再起動後に FCP デバイスを起動するには、次のコマンドを実行します。

       $ cp set loaddev portname <wwpn> lun <lun>

       ここでは、以下のようになります。

       <wwpn>

       ターゲットポートと <lun> 論理ユニットを 16 進数形式で指定します。

       $ cp set loaddev bootprog <n>

       ここでは、以下のようになります。

       <n>

       ブートするカーネルを指定します。

       $ cp set loaddev scpdata {APPEND|NEW} '<kernel_parameters>'

       ここでは、以下のようになります。

       <kernel_parameters>

       システム制御プログラムデータ (SCPDATA) として保存されるカーネルパラメーターのセットを指定します。Linux をブートするとき、これらのカーネルパラメーターは、ブート設定で使用される既存のカーネルパラメーターの末尾に連結されます。組み合わせたパラメーター文字列は 896 文字を超えてはなりません。

       <APPEND|NEW>

       オプション: カーネルパラメーターを既存の SCPDATA に追加するには、APPEND を指定します。これはデフォルトになります。NEW を指定して既存の SCPDATA を置き換えます。

       例

       $ cp set loaddev scpdata 'rd.zfcp=0.0.8001,0x500507630a0350a4,0x4000409D00000000
       ip=encbdd0:dhcp::02:00:00:02:34:02 rd.neednet=1'

       IPL およびブートプロセスを開始するには、次のコマンドを実行します。

       $ cp i <devno>

       ここでは、以下のようになります。

       <devno>

       ゲストから見えるブートデバイスのデバイス番号を指定します。

手順

1. 次のコマンドを実行して、OpenShift Container Platform のバージョンを設定します。

   $ OCP_VERSION=<ocp_version> 1

   1

   <ocp_version> を現在のバージョンに置き換えます。たとえば、latest-4.16 です。

2. 次のコマンドを実行して、ホストアーキテクチャーを設定します。

   $ ARCH=<architecture> 1

   1

   <architecture> をターゲットホストアーキテクチャー s390x に置き換えます。

3. OpenShift Container Platform クライアント (oc) をダウンロードし、次のコマンドを入力して使用できるようにします。

   $ curl -k https://mirror.openshift.com/pub/openshift-v4/${ARCH}/clients/ocp/${OCP_VERSION}/openshift-client-linux.tar.gz -o oc.tar.gz

   $ tar zxf oc.tar.gz

   $ chmod +x oc

4. OpenShift Container Platform インストーラーをダウンロードし、以下のコマンドを入力して使用できるようにします。

   $ curl -k https://mirror.openshift.com/pub/openshift-v4/${ARCH}/clients/ocp/${OCP_VERSION}/openshift-install-linux.tar.gz -o openshift-install-linux.tar.gz

   $ tar zxvf openshift-install-linux.tar.gz

   $ chmod +x openshift-install

5. install-config.yaml ファイルを作成します。

   apiVersion: v1
   baseDomain: <domain> 1
   compute:
   - name: worker
     replicas: 0 2
   controlPlane:
     name: master
     replicas: 1 3
   metadata:
     name: <name> 4
   networking: 5
     clusterNetwork:
     - cidr: 10.128.0.0/14
       hostPrefix: 23
     machineNetwork:
     - cidr: 10.0.0.0/16 6
     networkType: OVNKubernetes
     serviceNetwork:
     - 172.30.0.0/16
   platform:
     none: {}
   bootstrapInPlace:
     installationDisk: /dev/disk/by-id/<disk_id> 7
   pullSecret: '<pull_secret>' 8
   sshKey: |
     <ssh_key> 9

   1

   クラスタードメイン名を追加します。

   2

   compute レプリカを 0 に設定します。これにより、コントロールプレーンノードがスケジュール可能になります。

   3

   controlPlane レプリカを 1 に設定します。この設定は、以前の compute 設定と組み合わせて、クラスターが単一ノードで実行されるようにします。

   4

   メタデータ 名をクラスター名に設定します。

   5

   networking の詳細を設定します。OVN-Kubernetes は、単一ノードクラスターで許可されている唯一のネットワークプラグインタイプです。

   6

   単一ノードの OpenShift クラスターのサブネットと一致するように cidr 値を設定します。

   7

   インストールディスクドライブへのパスを設定します (例: /dev/disk/by-id/wwn-0x64cd98f04fde100024684cf3034da5c2)。

   8

   Red Hat OpenShift Cluster Manager からプルシークレット をコピーし、その内容をこの設定に追加します。

   9

   インストール後にクラスターにログインできるように、管理ホストから公開 SSH 鍵を追加します。

6. 以下のコマンドを実行して、OpenShift Container Platform アセットを生成します。

   $ mkdir ocp

   $ cp install-config.yaml ocp

   $ ./openshift-install --dir=ocp create single-node-ignition-config

7. Red Hat カスタマーポータルの 製品ダウンロード ページまたは RHCOS イメージミラー ページから、RHEL kernel、initramfs、および rootfs アーティファクトを取得します。

   重要

   RHCOS イメージは OpenShift Container Platform の各リリースごとに変更されない可能性があります。インストールする OpenShift Container Platform バージョンと等しいか、それ以下のバージョンの内で最も新しいバージョンのイメージをダウンロードする必要があります。この手順で説明されている適切な kernel、initramfs、および rootfs アーティファクトのみを使用します。

   ファイル名には、OpenShift Container Platform のバージョン番号が含まれます。以下の例のようになります。

   kernel

   rhcos-<version>-live-kernel-<architecture>

   initramfs

   rhcos-<version>-live-initramfs.<architecture>.img

   rootfs

   rhcos-<version>-live-rootfs.<architecture>.img

8. virt-install を起動する前に、次のファイルとアーティファクトを HTTP または HTTPS サーバーに移動します。

   • ダウンロードされた RHEL ライブ kernel、initramfs、および rootfs アーティファクト
   • Ignition ファイル

9. 次のコンポーネントを使用して、KVM ゲストノードを作成します。

   • RHEL の kernel および initramfs アーティファクト
   • Ignition ファイル
   • 新しいディスクイメージ
   • 調整された parm ライン引数

手順

1. 次のコマンドを実行して、OpenShift Container Platform のバージョンを設定します。

   $ OCP_VERSION=<ocp_version> 1

   1

   <ocp_version> を現在のバージョンに置き換えます。たとえば、latest-4.16 です。

2. 次のコマンドを実行して、ホストアーキテクチャーを設定します。

   $ ARCH=<architecture> 1

   1

   <architecture> をターゲットホストアーキテクチャー s390x に置き換えます。

3. OpenShift Container Platform クライアント (oc) をダウンロードし、次のコマンドを入力して使用できるようにします。

   $ curl -k https://mirror.openshift.com/pub/openshift-v4/${ARCH}/clients/ocp/${OCP_VERSION}/openshift-client-linux.tar.gz -o oc.tar.gz

   $ tar zxvf oc.tar.gz

   $ chmod +x oc

4. OpenShift Container Platform インストーラーをダウンロードし、以下のコマンドを入力して使用できるようにします。

   $ curl -k https://mirror.openshift.com/pub/openshift-v4/${ARCH}/clients/ocp/${OCP_VERSION}/openshift-install-linux.tar.gz -o openshift-install-linux.tar.gz

   $ tar zxvf openshift-install-linux.tar.gz

   $ chmod +x openshift-install

5. install-config.yaml ファイルを作成します。

   apiVersion: v1
   baseDomain: <domain> 1
   compute:
   - name: worker
     replicas: 0 2
   controlPlane:
     name: master
     replicas: 1 3
   metadata:
     name: <name> 4
   networking: 5
     clusterNetwork:
     - cidr: 10.128.0.0/14
       hostPrefix: 23
     machineNetwork:
     - cidr: 10.0.0.0/16 6
     networkType: OVNKubernetes
     serviceNetwork:
     - 172.30.0.0/16
   platform:
     none: {}
   pullSecret: '<pull_secret>' 7
   sshKey: |
     <ssh_key> 8

   1

   クラスタードメイン名を追加します。

   2

   compute レプリカを 0 に設定します。これにより、コントロールプレーンノードがスケジュール可能になります。

   3

   controlPlane レプリカを 1 に設定します。この設定は、以前の compute 設定と組み合わせて、クラスターが単一ノードで実行されるようにします。

   4

   メタデータ 名をクラスター名に設定します。

   5

   networking の詳細を設定します。OVN-Kubernetes は、単一ノードクラスターで許可されている唯一のネットワークプラグインタイプです。

   6

   単一ノードの OpenShift クラスターのサブネットと一致するように cidr 値を設定します。

   7

   Red Hat OpenShift Cluster Manager からプルシークレット をコピーし、その内容をこの設定に追加します。

   8

   インストール後にクラスターにログインできるように、管理ホストから公開 SSH 鍵を追加します。

6. 以下のコマンドを実行して、OpenShift Container Platform アセットを生成します。

   $ mkdir ocp

   $ cp install-config.yaml ocp

7. OpenShift Container Platform のインストールプログラムが含まれるディレクトリーに切り替え、クラスターの Kubernetes マニフェストを生成します。

   $ ./openshift-install create manifests --dir <installation_directory> 1

   1

   <installation_directory> については、作成した install-config.yaml ファイルが含まれるインストールディレクトリーを指定します。

8. <installation_directory>/manifests/cluster-scheduler-02-config.yml Kubernetes マニフェストファイルの mastersSchedulable パラメーターが true に設定されていることを確認します。

   1. <installation_directory>/manifests/cluster-scheduler-02-config.yml ファイルを開きます。

   2. mastersSchedulable パラメーターを見つけ、次の spec スタンザに示すとおり true に設定されていることを確認します。

      spec:
        mastersSchedulable: true
      status: {}

   3. ファイルを保存し、終了します。

9. インストールプログラムが含まれるディレクトリーから以下のコマンドを実行して、Ignition 設定ファイルを作成します。

   $ ./openshift-install create ignition-configs --dir <installation_directory> 1

   1

   <installation_directory> については、同じインストールディレクトリーを指定します。

10. Red Hat カスタマーポータルの 製品ダウンロード ページまたは RHCOS イメージミラー ページから、RHEL kernel、initramfs、および rootfs アーティファクトを取得します。

    重要

    RHCOS イメージは OpenShift Container Platform の各リリースごとに変更されない可能性があります。インストールする OpenShift Container Platform バージョンと等しいか、それ以下のバージョンの内で最も新しいバージョンのイメージをダウンロードする必要があります。この手順で説明されている適切な kernel、initramfs、および rootfs アーティファクトのみを使用します。

    ファイル名には、OpenShift Container Platform のバージョン番号が含まれます。以下の例のようになります。

    kernel

    rhcos-<version>-live-kernel-<architecture>

    initramfs

    rhcos-<version>-live-initramfs.<architecture>.img

    rootfs

    rhcos-<version>-live-rootfs.<architecture>.img

    注記

    rootfs イメージは FCP および DASD の場合と同じです。

11. 次のアーティファクトとファイルを HTTP または HTTPS サーバーに移動します。

    • ダウンロードされた RHEL ライブ kernel、initramfs、および rootfs アーティファクト
    • Ignition ファイル

12. LPAR 内のブートストラップのパラメーターファイルを作成します。

    ブートストラップマシンのパラメーターファイルの例

    cio_ignore=all,!condev rd.neednet=1 \
    console=ttysclp0 \
    coreos.inst.install_dev=/dev/<block_device> \1
    coreos.inst.ignition_url=http://<http_server>/bootstrap.ign \2
    coreos.live.rootfs_url=http://<http_server>/rhcos-<version>-live-rootfs.<architecture>.img \3
    ip=<ip>::<gateway>:<netmask>:<hostname>::none nameserver=<dns> \4
    rd.znet=qeth,0.0.1140,0.0.1141,0.0.1142,layer2=1,portno=0 \
    rd.dasd=0.0.4411 \5
    rd.zfcp=0.0.8001,0x50050763040051e3,0x4000406300000000 \6
    zfcp.allow_lun_scan=0

    1

    インストール先のシステム上のブロックデバイスを指定します。DASD タイプのディスクにインストールする場合は dasda を使用し、FCP タイプのディスクにインストールする場合は sda を使用します。

    2

    bootstrap.ign 設定ファイルの場所を指定します。HTTP プロトコルおよび HTTPS プロトコルのみがサポートされます。

    3

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

    4

    ip= パラメーターについては、「IBM Z® および IBM® LinuxONE 上の LPAR にクラスターをインストールする」に記載された説明に従い、手動で IP アドレスを割り当てます。

    5

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

    6

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

    必要に応じてさらにパラメーターを調整できます。

13. LPAR 内のコントロールプレーンのパラメーターファイルを作成します。

    コントロールプレーンマシンのパラメーターファイルの例

    cio_ignore=all,!condev rd.neednet=1 \
    console=ttysclp0 \
    coreos.inst.install_dev=/dev/<block_device> \
    coreos.inst.ignition_url=http://<http_server>/master.ign \1
    coreos.live.rootfs_url=http://<http_server>/rhcos-<version>-live-rootfs.<architecture>.img \
    ip=<ip>::<gateway>:<netmask>:<hostname>::none nameserver=<dns> \
    rd.znet=qeth,0.0.1140,0.0.1141,0.0.1142,layer2=1,portno=0 \
    rd.dasd=0.0.4411 \
    rd.zfcp=0.0.8001,0x50050763040051e3,0x4000406300000000 \
    zfcp.allow_lun_scan=0

    1

    master.ign 設定ファイルの場所を指定します。HTTP プロトコルおよび HTTPS プロトコルのみがサポートされます。

14. 次のアーティファクト、ファイル、イメージを LPAR に転送します。たとえば、FTP を使用する場合は以下のようになります。

    • kernel と initramfs アーティファクト
    • パラメーターファイル

    • RHCOS イメージ

      FTP でファイルを転送して起動する方法については、LPAR へのインストール を参照してください。

15. ブートストラップマシンを起動します。
16. コントロールプレーンマシンを起動します。

手順

1. 次のコマンドを使用して grub2 をインストールします。これは PowerVM の PXE を有効にするために必要です。

   grub2-mknetdir --net-directory=/var/lib/tftpboot

   /var/lib/tftpboot/boot/grub2/grub.cfg ファイルの例

   default=0
   fallback=1
   timeout=1
   if [ ${net_default_mac} == fa:b0:45:27:43:20 ]; then
   menuentry "CoreOS (BIOS)" {
      echo "Loading kernel"
      linux "/rhcos/kernel" ip=dhcp rd.neednet=1 ignition.platform.id=metal ignition.firstboot coreos.live.rootfs_url=http://192.168.10.5:8000/install/rootfs.img ignition.config.url=http://192.168.10.5:8000/ignition/sno.ign
      echo "Loading initrd"
      initrd  "/rhcos/initramfs.img"
   }
   fi

2. 次のコマンドを使用して、PXE のミラーリポジトリーから RHCOS イメージファイルをダウンロードします。

   1. 次のコマンドを入力して、RHCOS_URL 変数に次の 4.12 URL を割り当てます。

      $ export RHCOS_URL=https://mirror.openshift.com/pub/openshift-v4/ppc64le/dependencies/rhcos/4.12/latest/

   2. 次のコマンドを入力して、/var/lib/tftpboot/rhcos ディレクトリーに移動します。

      $ cd /var/lib/tftpboot/rhcos

   3. 次のコマンドを実行して、RHCOS_URL 変数に保存されている URL から指定された RHCOS カーネルファイルをダウンロードします。

      $ wget ${RHCOS_URL}/rhcos-live-kernel-ppc64le -o kernel

   4. 次のコマンドを入力して、RHCOS_URL 変数に保存されている URL から RHCOS initramfs ファイルをダウンロードします。

      $ wget ${RHCOS_URL}/rhcos-live-initramfs.ppc64le.img -o initramfs.img

   5. 次のコマンドを実行して、/var//var/www/html/install/ ディレクトリーに移動します。

      $ cd /var//var/www/html/install/

   6. 次のコマンドを入力して、RHCOS_URL 変数に保存されている URL から RHCOS root filesystem イメージファイルをダウンロードして保存します。

      $ wget ${RHCOS_URL}/rhcos-live-rootfs.ppc64le.img -o rootfs.img

3. 単一ノード OpenShift クラスターの ignition ファイルを作成するには、install-config.yaml ファイルを作成する必要があります。

   1. 次のコマンドを入力して、ファイルを保持する作業ディレクトリーを作成します。

      $ mkdir -p ~/sno-work

   2. 次のコマンドを入力して、~/sno-work ディレクトリーに移動します。

      $ cd ~/sno-work

   3. 次のサンプルファイルを使用して、必要な install-config.yaml を ~/sno-work ディレクトリーに作成できます。

      apiVersion: v1
      baseDomain: <domain> 1
      compute:
      - name: worker
        replicas: 0 2
      controlPlane:
        name: master
        replicas: 1 3
      metadata:
        name: <name> 4
      networking: 5
        clusterNetwork:
        - cidr: 10.128.0.0/14
          hostPrefix: 23
        machineNetwork:
        - cidr: 10.0.0.0/16 6
        networkType: OVNKubernetes
        serviceNetwork:
        - 172.30.0.0/16
      platform:
        none: {}
      bootstrapInPlace:
        installationDisk: /dev/disk/by-id/<disk_id> 7
      pullSecret: '<pull_secret>' 8
      sshKey: |
        <ssh_key> 9

      1

      クラスタードメイン名を追加します。

      2

      compute レプリカを 0 に設定します。これにより、コントロールプレーンノードがスケジュール可能になります。

      3

      controlPlane レプリカを 1 に設定します。この設定は、以前の compute 設定と組み合わせて、クラスターが単一ノードで実行されるようにします。

      4

      メタデータ 名をクラスター名に設定します。

      5

      networking の詳細を設定します。OVN-Kubernetes は、単一ノードクラスターで許可されている唯一のネットワークプラグインタイプです。

      6

      単一ノードの OpenShift クラスターのサブネットと一致するように cidr 値を設定します。

      7

      インストールディスクドライブへのパスを設定します (例: /dev/disk/by-id/wwn-0x64cd98f04fde100024684cf3034da5c2)。

      8

      Red Hat OpenShift Cluster Manager からプルシークレット をコピーし、その内容をこの設定に追加します。

      9

      インストール後にクラスターにログインできるように、管理ホストから公開 SSH 鍵を追加します。

4. openshift-install イメージをダウンロードして ignition ファイルを作成し、それを http ディレクトリーにコピーします。

   1. 次のコマンドを実行して、openshift-install-linux-4.12.0 .tar ファイルをダウンロードします。

      $ wget https://mirror.openshift.com/pub/openshift-v4/ppc64le/clients/ocp/4.12.0/openshift-install-linux-4.12.0.tar.gz

   2. 次のコマンドを入力して、openshift-install-linux-4.12.0.tar.gz アーカイブを展開します。

      $ tar xzvf openshift-install-linux-4.12.0.tar.gz

   3. 以下のコマンドを入力し、以下を実行します。

      $ ./openshift-install --dir=~/sno-work create create single-node-ignition-config

   4. 次のコマンドを入力して、Ignition ファイルを作成します。

      $ cp ~/sno-work/single-node-ignition-config.ign /var/www/html/ignition/sno.ign

   5. 次のコマンドを入力して、/var/www/html ディレクトリーの SELinux ファイルを復元します。

      $ restorecon -vR /var/www/html || true

      踏み台には必要なファイルがすべて含まれており、単一ノードの OpenShift をインストールするために適切に設定されています。

1. 次のコマンドを使用して、netboot で powerVM を起動します。

   $ lpar_netboot -i -D -f -t ent -m <sno_mac> -s auto -d auto -S <server_ip> -C <sno_ip> -G <gateway> <lpar_name> default_profile <cec_name>

   ここでは、以下のようになります。

   sno_mac

   シングルノード OpenShift クラスターの MAC アドレスを指定します。

   sno_ip

   単一ノード OpenShift クラスターの IP アドレスを指定します。

   server_ip

   踏み台 (PXE サーバー) の IP アドレスを指定します。

   gateway

   ネットワークのゲートウェイ IP を指定します。

   lpar_name

   HMC 内の単一ノード OpenShift lpar 名を指定します。

   cec_name

   sno_lpar が存在するシステム名を指定します。

2. 単一ノード OpenShift LPAR が PXE で起動した後、openshift-install コマンドを使用してインストールの進行状況を監視します。

   1. ブートストラップが完了したら、次のコマンドを実行します。

      ./openshift-install wait-for bootstrap-complete

   2. 正常に戻ったら、次のコマンドを実行します。

      ./openshift-install wait-for install-complete