第10章 MTV パフォーマンスに関する推奨事項

手順

1. openshift-mtv namespace の forklift-controller Pod が AIO バッファー値をサポートしていることを確認します。Pod 名の接頭辞は動的であるため、次のコマンドを実行して Pod 名を確認します。

   oc get pods -n openshift-mtv | grep forklift-controller | awk '{print $1}'

   Copy to Clipboard Toggle word wrap

   たとえば、Pod 名の接頭辞が "forklift-controller-667f57c8f8-qllnx" の場合、出力は次のようになります。

   forklift-controller-667f57c8f8-qllnx

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して、Pod の環境変数を確認します。

   oc get pod forklift-controller-667f57c8f8-qllnx -n openshift-mtv -o yaml

   Copy to Clipboard Toggle word wrap

3. 出力で次の行を確認します。

   ...
   \- name: VIRT\_V2V\_EXTRA\_ARGS
   \- name: VIRT\_V2V\_EXTRA\_CONF\_CONFIG\_MAP
   ...

   Copy to Clipboard Toggle word wrap

4. openshift-mtv namespace で、次の手順を実行して ForkliftController カスタムリソース (CR) を編集します。

   1. 次のコマンドを実行して、ForkliftController CR にアクセスし、編集します。

      oc edit forkliftcontroller -n openshift-mtv

      Copy to Clipboard Toggle word wrap

   2. ForkliftController CR の spec セクションに次の行を追加します。

      virt_v2v_extra_args: "--vddk-config /mnt/extra-v2v-conf/input.conf"
      virt_v2v_extra_conf_config_map: "perf"

      Copy to Clipboard Toggle word wrap

5. 次のコマンドを実行して、必要な config map perf を作成します。

   oc -n openshift-mtv create cm perf

   Copy to Clipboard Toggle word wrap

6. 目的のバッファー設定値を Base64 に変換します。たとえば、16/4 の場合は、次のコマンドを実行します。

   echo -e "VixDiskLib.nfcAio.Session.BufSizeIn64KB=16\nvixDiskLib.nfcAio.Session.BufCount=4" | base64

   Copy to Clipboard Toggle word wrap

   出力は次のようになります。

   Vml4RGlza0xpYi5uZmNBaW8uU2Vzc2lvbi5CdWZTaXplSW42NEtCPTE2CnZpeERpc2tMaWIubmZjQWlvLlNlc3Npb24uQnVmQ291bnQ9NAo=

   Copy to Clipboard Toggle word wrap

7. config map perf で、binaryData セクションに Base64 文字列を入力します。次に例を示します。

   apiVersion: v1
   kind: ConfigMap
   binaryData:
     input.conf: Vml4RGlza0xpYi5uZmNBaW8uU2Vzc2lvbi5CdWZTaXplSW42NEtCPTE2CnZpeERpc2tMaWIubmZjQWlvLlNlc3Npb24uQnVmQ291bnQ9NAo=
   metadata:
     name: perf
     namespace: openshift-mtv

   Copy to Clipboard Toggle word wrap
8. 新しい設定を適用するには、forklift-controller Pod を再起動します。
9. VIRT_V2V_EXTRA_ARGS 環境変数が更新された設定を反映していることを確認します。

10. 移行計画を実行し、移行 Pod のログを確認します。AIO バッファー設定、特に --vddk-config 値がパラメーターとして渡されていることを確認します。

    たとえば、次のコマンドを実行するとします。

    exec: /usr/bin/virt-v2v … --vddk-config /mnt/extra-v2v-conf/input.conf

    Copy to Clipboard Toggle word wrap

    debug_level = 4 の場合、ログには次のようなセクションが含まれます。

    Buffer size calc for 16 value:
    (16 * 64 * 1024 = 1048576)
    nbdkit: vddk[1]: debug: [NFC VERBOSE] NfcAio_OpenSession:
    Opening an AIO session.
    nbdkit: vddk[1]: debug: [NFC INFO] NfcAioInitSession:
    Disabling
    read-ahead buffer since the AIO buffer size of 1048576 is >=
    the read-ahead buffer size of 65536. Explicitly setting flag
    '`NFC_AIO_SESSION_NO_NET_READ_AHEAD`'
    nbdkit: vddk[1]: debug: [NFC VERBOSE] NfcAioInitSession: AIO Buffer Size is 1048576
    nbdkit: vddk[1]: debug: [NFC VERBOSE] NfcAioInitSession: AIO Buffer
    Count is 4

    Copy to Clipboard Toggle word wrap

11. 移行 Pod に正しい config map 値があることを確認します。これを行うには、移行 Pod にログインし、次のコマンドを実行します。

    cat /mnt/extra-v2v-conf/input.conf

    Copy to Clipboard Toggle word wrap

    出力例は次のとおりです。

    VixDiskLib.nfcAio.Session.BufSizeIn64KB=16
    vixDiskLib.nfcAio.Session.BufCount=4

    Copy to Clipboard Toggle word wrap

12. オプション: 次のコマンドを実行してデバッグログを有効にします。このコマンドは、高いログレベルを含む設定を Base64 に変換します。

    echo -e
    "`VixDiskLib.nfcAio.Session.BufSizeIn64KB=16\nVixDiskLib.nfcAio.Session.BufCount=4\nVixDiskLib.nfc.LogLevel=4`"
    | base64

    Copy to Clipboard Toggle word wrap
    注記

    高いログレベルを追加するとパフォーマンスが低下しますが、これはデバッグ目的のみに使用されます。

手順

1. openshift-mtv namespace で、次の手順を実行して ForkliftController カスタムリソース (CR) を編集します。

   1. 次のコマンドを実行して、ForkliftController CR にアクセスし、編集します。

      oc edit forkliftcontroller -n openshift-mtv

      Copy to Clipboard Toggle word wrap

   2. ForkliftController CR の spec セクションから次の行を削除します。

      virt_v2v_extra_args: "`–vddk-config /mnt/extra-v2v-conf/input.conf`"
      virt_v2v_extra_conf_config_map: "`perf`"

      Copy to Clipboard Toggle word wrap

2. perf という名前の config map を削除します。

   oc delete cm perf -n openshift-mtv

   Copy to Clipboard Toggle word wrap
3. オプション: 変更が有効になったことを確認するには、forklift-controller Pod を再起動します。