5.5. IBM Z エージェントの手動追加

手順

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

   
   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 \

   4

   
   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 LinuxONE へのインストール の説明に従って、IP アドレスを手動で割り当てます。

   3

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

   4

   Open Systems Adapter (OSA) または HiperSockets を使用する場合は、このパラメーターを指定します。

2. 次の Python スクリプトを実行して、.ins ファイルと initrd.img.addrsize ファイルを生成します。

   .ins ファイルは、インストールデータを含む特別なファイルであり、FTP サーバー上にあります。このファイルには、HMC システムからアクセスできます。このファイルには、ディスクまたは FTP サーバー上にあるインストールデータの場所のマッピング、データがコピーされるメモリーの場所などの詳細が含まれています。

   注記

   .ins および initrd.img.addrsize ファイルは、ブートアーティファクトの一部としてインストーラーから自動的に生成されません。これらのファイルは、手動で生成する必要があります。

   1. 次のスクリプトを generate-files.py などのファイルに保存します。

      generate-files.py という名前の Python ファイルの例

      # The following commands retrieve the size of the `kernel` and `initrd`:
      KERNEL_IMG_PATH='./kernel.img'
      INITRD_IMG_PATH='./initrd.img'
      CMDLINE_PATH='./generic.prm'
      kernel_size=(stat -c%s KERNEL_IMG_PATH)
      initrd_size=(stat -c%s INITRD_IMG_PATH)
      # The following command rounds the `kernel` size up to the next megabytes (MB) boundary.
      # This value is the starting address of `initrd.img`.
      offset=(( (kernel_size + 1048575) / 1048576 * 1048576 ))
      INITRD_IMG_NAME=(echo INITRD_IMG_PATH | rev | cut -d '/' -f 1 | rev)
      # The following commands create the kernel binary patch file that contains the `initrd` address and size:
      KERNEL_OFFSET=0x00000000
      KERNEL_CMDLINE_OFFSET=0x00010480
      INITRD_ADDR_SIZE_OFFSET=0x00010408
      OFFSET_HEX=(printf '0x%08x\n' offset)
      # The following command converts the address and size to binary format:
      printf "(printf '%016x\n' $initrd_size)" | xxd -r -p > temp_size.bin
      # The following command concatenates the address and size binaries:
      cat temp_address.bin temp_size.bin > "$INITRD_IMG_NAME.addrsize"
      # The following command deletes temporary files:
      rm -rf temp_address.bin temp_size.bin
      # The following commands create the `.ins` file.
      # The file is based on the paths of the `kernel.img`, `initrd.img`, `initrd.img.addrsize`, and `cmdline` files and the memory locations where the data is to be copied.
      KERNEL_IMG_PATH KERNEL_OFFSET
      INITRD_IMG_PATH OFFSET_HEX
      INITRD_IMG_NAME.addrsize INITRD_ADDR_SIZE_OFFSET
      CMDLINE_PATH KERNEL_CMDLINE_OFFSET

   2. 次のコマンドを実行してスクリプトを実行します。

      $ python3 <file_name>.py

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