Language:
Format:

Language:
Format:

19.6. PTP デバイスの設定

PTP Operator は NodePtpDevice.ptp.openshift.io カスタムリソース定義 (CRD) を OpenShift Container Platform に追加します。

インストールが完了すると、PTP Operator はクラスターを検索して各ノードで PTP 対応のネットワークデバイスを検索します。これは、互換性のある PTP 対応のネットワークデバイスを提供する各ノードの NodePtpDevice カスタムリソース (CR) オブジェクトを作成し、更新します。

19.6.1. クラスター内の PTP 対応ネットワークデバイスの検出

クラスター内の PTP 対応ネットワークデバイスの一覧を返すには、以下のコマンドを実行します。

$ oc get NodePtpDevice -n openshift-ptp -o yaml

出力例

apiVersion: v1
items:
- apiVersion: ptp.openshift.io/v1
  kind: NodePtpDevice
  metadata:
    creationTimestamp: "2022-01-27T15:16:28Z"
    generation: 1
    name: dev-worker-0 1
    namespace: openshift-ptp
    resourceVersion: "6538103"
    uid: d42fc9ad-bcbf-4590-b6d8-b676c642781a
  spec: {}
  status:
    devices: 2
    - name: eno1
    - name: eno2
    - name: eno3
    - name: eno4
    - name: enp5s0f0
    - name: enp5s0f1
...

1: name パラメーターの値は、親ノードの名前と同じです。
2: デバイスコレクションには、PTP Operator がノードに対して検出した PTP 対応デバイスのリストが含まれています。

19.6.2. linuxptp サービスをグランドマスタークロックとして設定する

ホスト NIC を設定する PtpConfig カスタムリソース (CR) を作成することで、linuxptp サービス (ptp4l、phc2sys、ts2phc) をグランドマスタークロックとして設定できます。

ts2phc ユーティリティーを使用すると、システムクロックを PTP グランドマスタークロックと同期できるため、ノードは高精度クロック信号をダウンストリームの PTP 通常クロックおよび境界クロックにストリーミングできます。

注記

次の PtpConfig CR の例をベースとして使用して、linuxptp サービスを特定のハードウェアおよび環境のグランドマスタークロックとして設定します。この例の CR は PTP 高速イベントを設定しません。PTP 高速イベントを設定するには、ptp4lOpts、ptp4lConf、ptpClockThreshold に適切な値を設定します。ptpClockThreshold は、イベントが有効になっている場合にのみ使用されます。詳細は、「PTP 高速イベント通知パブリッシャーの設定」を参照してください。

前提条件

Intel Westport Channel ネットワークインターフェイスをベアメタルクラスターホストにインストールします。
OpenShift CLI (oc) がインストールされている。
cluster-admin 権限を持つユーザーとしてログインしている。
PTP Operator をインストールします。

手順

PtpConfig リソースを作成します。以下に例を示します。

次の YAML を grandmaster-clock-ptp-config.yaml ファイルに保存します。

推奨される PTP grandmaster クロック設定

apiVersion: ptp.openshift.io/v1
kind: PtpConfig
metadata:
  name: grandmaster
  namespace: openshift-ptp
spec:
  profile:
  - name: "grandmaster"
    ptp4lOpts: "-2 --summary_interval -4"
    phc2sysOpts: -r -u 0 -m -O -37 -N 8 -R 16 -s ens2f1 -n 24
    ptpSchedulingPolicy: SCHED_FIFO
    ptpSchedulingPriority: 10
    plugins:
      e810:
        enableDefaultConfig: true
    ts2phcOpts: " "
    ts2phcConf: |
      [nmea]
      ts2phc.master 1
      [global]
      use_syslog  0
      verbose 1
      logging_level 7
      ts2phc.pulsewidth 100000000
      #GNSS module - ls /dev/gnss* -al
      ts2phc.nmea_serialport /dev/gnss0
      leapfile  /usr/share/zoneinfo/leap-seconds.list
      [ens2f1]
      ts2phc.extts_polarity rising
      ts2phc.extts_correction 0
    ptp4lConf: |
      [ens2f1]
      masterOnly 1
      [ens2f2]
      masterOnly 1
      [ens2f3]
      masterOnly 1
      [ens2f4]
      masterOnly 1
      [global]
      #
      # Default Data Set
      #
      twoStepFlag 1
      priority1 128
      priority2 128
      domainNumber 24
      #utc_offset 37
      clockClass 6
      clockAccuracy 0x27
      offsetScaledLogVariance 0xFFFF
      free_running 0
      freq_est_interval 1
      dscp_event 0
      dscp_general 0
      dataset_comparison G.8275.x
      G.8275.defaultDS.localPriority 128
      #
      # Port Data Set
      #
      logAnnounceInterval -3
      logSyncInterval -4
      logMinDelayReqInterval -4
      logMinPdelayReqInterval 0
      announceReceiptTimeout 3
      syncReceiptTimeout 0
      delayAsymmetry 0
      fault_reset_interval 4
      neighborPropDelayThresh 20000000
      masterOnly 0
      G.8275.portDS.localPriority 128
      #
      # Run time options
      #
      assume_two_step 0
      logging_level 6
      path_trace_enabled 0
      follow_up_info 0
      hybrid_e2e 0
      inhibit_multicast_service 0
      net_sync_monitor 0
      tc_spanning_tree 0
      tx_timestamp_timeout 50
      unicast_listen 0
      unicast_master_table 0
      unicast_req_duration 3600
      use_syslog 1
      verbose 0
      summary_interval -4
      kernel_leap 1
      check_fup_sync 0
      #
      # Servo Options
      #
      pi_proportional_const 0.0
      pi_integral_const 0.0
      pi_proportional_scale 0.0
      pi_proportional_exponent -0.3
      pi_proportional_norm_max 0.7
      pi_integral_scale 0.0
      pi_integral_exponent 0.4
      pi_integral_norm_max 0.3
      step_threshold 0.0
      first_step_threshold 0.00002
      clock_servo pi
      sanity_freq_limit  200000000
      ntpshm_segment 0
      #
      # Transport options
      #
      transportSpecific 0x0
      ptp_dst_mac 01:1B:19:00:00:00
      p2p_dst_mac 01:80:C2:00:00:0E
      udp_ttl 1
      udp6_scope 0x0E
      uds_address /var/run/ptp4l
      #
      # Default interface options
      #
      clock_type BC
      network_transport L2
      delay_mechanism E2E
      time_stamping hardware
      tsproc_mode filter
      delay_filter moving_median
      delay_filter_length 10
      egressLatency 0
      ingressLatency 0
      boundary_clock_jbod 0
      #
      # Clock description
      #
      productDescription ;;
      revisionData ;;
      manufacturerIdentity 00:00:00
      userDescription ;
      timeSource 0x20
  recommend:
  - profile: "grandmaster"
    priority: 4
    match:
    - nodeLabel: "node-role.kubernetes.io/worker"

以下のコマンドを実行して CR を作成します。
```
$ oc create -f grandmaster-clock-ptp-config.yaml
```

検証

PtpConfig プロファイルがノードに適用されていることを確認します。

以下のコマンドを実行して、openshift-ptp namespace の Pod の一覧を取得します。

$ oc get pods -n openshift-ptp -o wide

出力例

NAME                          READY   STATUS    RESTARTS   AGE     IP             NODE
linuxptp-daemon-74m2g         3/3     Running   3          4d15h   10.16.230.7    compute-1.example.com
ptp-operator-5f4f48d7c-x7zkf  1/1     Running   1          4d15h   10.128.1.145   compute-1.example.com

プロファイルが正しいことを確認します。PtpConfig プロファイルで指定したノードに対応する linuxptp デーモンのログを検査します。以下のコマンドを実行します。

$ oc logs linuxptp-daemon-74m2g -n openshift-ptp -c linuxptp-daemon-container

出力例

ts2phc[94980.334]: [ts2phc.0.config] nmea delay: 98690975 ns
ts2phc[94980.334]: [ts2phc.0.config] ens3f0 extts index 0 at 1676577329.999999999 corr 0 src 1676577330.901342528 diff -1
ts2phc[94980.334]: [ts2phc.0.config] ens3f0 master offset         -1 s2 freq      -1
ts2phc[94980.441]: [ts2phc.0.config] nmea sentence: GNRMC,195453.00,A,4233.24427,N,07126.64420,W,0.008,,160223,,,A,V
phc2sys[94980.450]: [ptp4l.0.config] CLOCK_REALTIME phc offset       943 s2 freq  -89604 delay    504
phc2sys[94980.512]: [ptp4l.0.config] CLOCK_REALTIME phc offset      1000 s2 freq  -89264 delay    474

関連情報

PTP 高速イベント通知パブリッシャーの設定

19.6.2.1. grandmaster クロック PtpConfig 設定リファレンス

次の参考情報では、linuxptp サービス (ptp4l、phc2sys、ts2phc) を grandmaster クロックとして設定する PtpConfig カスタムリソース (CR) の設定オプションについて説明します。

表19.1 PTP Grandmaster クロックの PtpConfig 設定オプション

PtpConfig CR フィールド	説明
`plugins`	grandmaster クロック動作用に NIC を設定する `.exec.cmdline` オプションの配列を指定します。grandmaster クロック設定では、特定の PTP ピンを無効にする必要があります。プラグインメカニズムにより、PTP Operatro は自動ハードウェア設定を行うことができます。Intel Westport Channel NIC の場合、`enableDefaultConfig` が true の場合、PTP Operator はハードコーディングされたスクリプトを実行して、NIC に必要な設定を実行します。
`ptp4lOpts`	`ptp4l` サービスのシステム設定オプションを指定します。ネットワークインターフェイス名とサービス設定ファイルが自動的に追加されるため、オプションには、ネットワークインターフェイス名 `-i <interface>` およびサービス設定ファイル `-f /etc/ptp4l.conf` を含めないでください。
`ptp4lConf`	`ptp4l` を grandmaster クロックとして起動するために必要な設定を指定します。たとえば、`ens2f1` インターフェイスは、ダウンストリームに接続されたデバイスを同期します。grandmaster クロックの場合、`ClockClass を6` に設定し、`ClockAccuracy` を `0x27` に設定します。全地球測位 Satellite システム (GNSS) からタイミング信号を受信する場合は、`timeSource` を `0x20` に設定します。
`tx_timestamp_timeout`	データを破棄する前に、送信者からの送信 (TX) タイムスタンプを待機する最大時間を指定します。
`boundary_clock_jbod`	JBOD 境界クロック時間遅延値を指定します。この値は、ネットワーク時間デバイス間で受け渡される時間値を修正するために使用されます。
`phc2sysOpts`	`phc2sys` サービスのシステム設定オプションを指定します。このフィールドが空の場合、PTP Operator は `phc2sys` サービスを開始しません。注記ここにリストされているネットワークインターフェイスがグランドマスターとして設定されており、`ts2phcConf` および `ptp4lConf` フィールドで必要に応じて参照されていることを確認してください。
`ptpSchedulingPolicy`	`ptp4l` および `phc2sys` プロセスのスケジューリングポリシーを設定します。デフォルト値は `SCHED_OTHER` です。FIFO スケジューリングをサポートするシステムでは、`SCHED_FIFO` を使用してください。
`ptpSchedulingPriority`	`ptpSchedulingPolicy` が `SCHED_FIFO` に設定されている場合に、`ptp4l` および `phc2sys` プロセスの FIFO 優先順位を設定するには、1 ~ 65 の整数値を設定します。`ptpSchedulingPriority` フィールドは、`ptpSchedulingPolicy` が `SCHED_OTHER` に設定されている場合は使用されません。
`ptpClockThreshold`	オプション: `ptpClockThreshold`スタンザが存在しない場合には、`ptpClockThreshold`フィールドにデフォルト値が使用されます。スタンザはデフォルトの `ptpClockThreshold`値を示します。`ptpClockThreshold` 値は、PTP マスタークロックが切断されてから PTP イベントが発生するまでの時間を設定します。`holdOverTimeout` は、PTP マスタークロックが切断されたときに、PTP クロックイベントの状態が `FREERUN` に変わるまでの時間値 (秒単位) です。`maxOffsetThreshold` および `minOffsetThreshold` 設定は、`CLOCK_REALTIME` (`phc2sys`) またはマスターオフセット (`ptp4l`) の値と比較するナノ秒単位のオフセット値を設定します。`ptp4l` または `phc2sys` のオフセット値がこの範囲外の場合、PTP クロックの状態が `FREERUN` に設定されます。オフセット値がこの範囲内にある場合、PTP クロックの状態が `LOCKED` に設定されます。
`ts2phcConf`	`ts2phc` コマンドの設定を設定します。 `Leapfile` は、PTP Operator コンテナーイメージ内の現在のうるう秒定義ファイルへのデフォルトパスです。 `ts2phc.nmea_serialport` は、NMEA GPS クロックソースに接続されているシリアルポートデバイスです。設定すると、`/dev/gnss<id>` で GNSS 受信機にアクセスできるようになります。ホストに複数の GNSS 受信機がある場合は、次のいずれかのデバイスを列挙することで正しいデバイスを見つけることができます。 `/sys/class/net/<eth_port>/device/gnss/` `/sys/class/gnss/gnss<id>/device/`
`ts2phcOpts`	`ts2phc` コマンドのオプションを設定します。
`recommend`	`profile` がノードに適用される方法を定義する 1 つ以上の `recommend` オブジェクトの配列を指定します。
`.recommend.profile`	`profile` セクションで定義されている `.recommend.profile` オブジェクト名を指定します。
`.recommend.priority`	`0` から `99` までの整数値で `priority` を指定します。数値が大きいほど優先度が低くなるため、`99` の優先度は `10` よりも低くなります。ノードが `match` フィールドで定義されるルールに基づいて複数のプロファイルに一致する場合、優先順位の高いプロファイルがそのノードに適用されます。
`.recommend.match`	`.recommend.match` ルールを `nodeLabel` または `nodeName` に指定します。
`.recommend.match.nodeLabel`	`oc get Nodes --show-labels` コマンドを使用して、ノードオブジェクトの `node.Labels` の `キー` を使用して、`nodeLabel` を設定します。例: `node-role.kubernetes.io/worker`。
`.recommend.match.nodeName`	`oc get nodes` コマンドを使用して、`nodeName` にノードオブジェクトの `node.Name` の値を設定します。例: `compute-1.example.com`

19.6.3. linuxptp サービスを通常のクロックとして設定

Ptp Configカスタムリソース (CR) オブジェクトを作成して、 linuxptpサービス (ptp4l、phc2sys) を通常のクロックとして設定できます。

注記

次の例の PtpConfig CR を、特定のハードウェアおよび環境の通常クロックとして linuxptp サービスを設定する基礎として使用します。この例の CR は PTP 高速イベントを設定しません。PTP 高速イベントを設定するには、ptp4lOpts、ptp4lConf、ptpClockThreshold に適切な値を設定します。ptpClockThreshold は、イベントが有効な場合にのみ必要です。詳細は、「PTP 高速イベント通知パブリッシャーの設定」を参照してください。

前提条件

OpenShift CLI (oc) がインストールされている。
cluster-admin 権限を持つユーザーとしてログインしている。
PTP Operator をインストールします。

手順

以下の PtpConfig CR を作成してから、YAML を ordinary-clock-ptp-config.yaml ファイルに保存します。

推奨される PTP 通常クロック設定

apiVersion: ptp.openshift.io/v1
kind: PtpConfig
metadata:
  name: ordinary-clock-ptp-config
  namespace: openshift-ptp
  spec:
    profile:
      - name: ordinary-clock
        interface: "<interface_name>"
        phc2sysOpts: "-a -r -n 24"
        ptp4lOpts: "-2 -s"
        ptpSchedulingPolicy: SCHED_FIFO
        ptpSchedulingPriority: 10
        ptp4lConf: |
          [global]
          #
          # Default Data Set
          #
          twoStepFlag 1
          slaveOnly 1
          priority1 128
          priority2 128
          domainNumber 24
          clockClass 255
          clockAccuracy 0xFE
          offsetScaledLogVariance 0xFFFF
          free_running 0
          freq_est_interval 1
          dscp_event 0
          dscp_general 0
          dataset_comparison G.8275.x
          G.8275.defaultDS.localPriority 128
          #
          # Port Data Set
          #
          logAnnounceInterval -3
          logSyncInterval -4
          logMinDelayReqInterval -4
          logMinPdelayReqInterval -4
          announceReceiptTimeout 3
          syncReceiptTimeout 0
          delayAsymmetry 0
          fault_reset_interval 4
          neighborPropDelayThresh 20000000
          masterOnly 0
          G.8275.portDS.localPriority 128
          #
          # Run time options
          #
          assume_two_step 0
          logging_level 6
          path_trace_enabled 0
          follow_up_info 0
          hybrid_e2e 0
          inhibit_multicast_service 0
          net_sync_monitor 0
          tc_spanning_tree 0
          tx_timestamp_timeout 50
          unicast_listen 0
          unicast_master_table 0
          unicast_req_duration 3600
          use_syslog 1
          verbose 0
          summary_interval 0
          kernel_leap 1
          check_fup_sync 0
          #
          # Servo Options
          #
          pi_proportional_const 0.0
          pi_integral_const 0.0
          pi_proportional_scale 0.0
          pi_proportional_exponent -0.3
          pi_proportional_norm_max 0.7
          pi_integral_scale 0.0
          pi_integral_exponent 0.4
          pi_integral_norm_max 0.3
          step_threshold 2.0
          first_step_threshold 0.00002
          max_frequency 900000000
          clock_servo pi
          sanity_freq_limit 200000000
          ntpshm_segment 0
          #
          # Transport options
          #
          transportSpecific 0x0
          ptp_dst_mac 01:1B:19:00:00:00
          p2p_dst_mac 01:80:C2:00:00:0E
          udp_ttl 1
          udp6_scope 0x0E
          uds_address /var/run/ptp4l
          #
          # Default interface options
          #
          clock_type OC
          network_transport L2
          delay_mechanism E2E
          time_stamping hardware
          tsproc_mode filter
          delay_filter moving_median
          delay_filter_length 10
          egressLatency 0
          ingressLatency 0
          boundary_clock_jbod 0
          #
          # Clock description
          #
          productDescription ;;
          revisionData ;;
          manufacturerIdentity 00:00:00
          userDescription ;
          timeSource 0xA0
      recommend:
      - profile: ordinary-clock
        priority: 4
        match:
        - nodeLabel: "node-role.kubernetes.io/worker"
          nodeName: "<node_name>"

表19.2 PTP 通常クロック CR 設定のオプション

カスタムリソースフィールド	説明
`name`	`PtpConfig` CR の名前。
`profile`	1 つ以上の `profile` オブジェクトの配列を指定します。各プロファイルの名前は一意である必要があります。
`interface`	`ptp4l` サービスで使用するネットワークインターフェイスを指定します (例: `ens787f1`)。
`ptp4lOpts`	`ptp4l` サービスのシステム設定オプションを指定します。たとえば、`-2` で IEEE 802.3 ネットワークトランスポートを選択します。ネットワークインターフェイス名とサービス設定ファイルが自動的に追加されるため、オプションには、ネットワークインターフェイス名 `-i <interface>` およびサービス設定ファイル `-f /etc/ptp4l.conf` を含めないでください。このインターフェイスで PTP 高速イベントを使用するには、`--summary_interval -4` を追加します。
`phc2sysOpts`	`phc2sys` サービスのシステム設定オプションを指定します。このフィールドが空の場合、PTP Operator は `phc2sys` サービスを開始しません。Intel Columbiaville 800 Series NIC の場合、`phc2sysOpts` オプションを `-a -r -m -n 24 -N 8 -R 16` に設定します。`-m` はメッセージを `stdout` に出力します。`linuxptp-daemon` `DaemonSet` はログを解析し、Prometheus メトリックを生成します。
`ptp4lConf`	デフォルトの `/etc/ptp4l.conf` ファイルを置き換える設定が含まれる文字列を指定します。デフォルト設定を使用するには、フィールドを空のままにします。
`tx_timestamp_timeout`	Intel Columbiaville 800 Series NIC の場合、`tx_timestamp_timeout` を `50` に設定します。
`boundary_clock_jbod`	Intel Columbiaville 800 Series NIC の場合、`boundary_clock_jbod` を `0` に設定します。
`ptpSchedulingPolicy`	`ptp4l` と `phc2sys` プロセスのスケジューリングポリシー。デフォルト値は `SCHED_OTHER` です。FIFO スケジューリングをサポートするシステムでは、`SCHED_FIFO` を使用してください。
`ptpSchedulingPriority`	`ptp SchedulingPolicy` が `SCHED_FIFO` に設定されている場合に、`ptp4l` および `phc2sys` プロセスの FIFO の優先度を設定するために使用される 1-65 の整数値。`ptpSchedulingPriority` フィールドは、`ptpSchedulingPolicy` が `SCHED_OTHER` に設定されている場合は使用されません。
`ptpClockThreshold`	オプション: `ptpClockThreshold` が存在しない場合、`ptpClockThreshold` フィールドにはデフォルト値が使用されます。`ptpClockThreshold` は、PTP マスタークロックが切断されてから PTP イベントが発生するまでの時間を設定します。`holdOverTimeout` は、PTP マスタークロックが切断されたときに、PTP クロックイベントの状態が `FREERUN` に変わるまでの時間値 (秒単位) です。`maxOffsetThreshold` および `minOffsetThreshold` 設定は、`CLOCK_REALTIME` (`phc2sys`) またはマスターオフセット (`ptp4l`) の値と比較するナノ秒単位のオフセット値を設定します。`ptp4l` または `phc2sys` のオフセット値がこの範囲外の場合、PTP クロックの状態が `FREERUN` に設定されます。オフセット値がこの範囲内にある場合、PTP クロックの状態が `LOCKED` に設定されます。
`recommend`	`profile` がノードに適用される方法を定義する 1 つ以上の `recommend` オブジェクトの配列を指定します。
`.recommend.profile`	`profile` セクションで定義される `.recommend.profile` オブジェクト名を指定します。
`.recommend.priority`	通常クロックの `.recommend.priority` を `0` に設定します。
`.recommend.match`	`.recommend.match` ルールを `nodeLabel` または `nodeName` に指定します。
`.recommend.match.nodeLabel`	`oc get nodes --show-labels` コマンドを使用して、ノードオブジェクトの`node.Labels` の `key` を `nodeLabel` に指定します。例: `node-role.kubernetes.io/worker`。
`.recommend.match.nodeLabel`	`oc get nodes` コマンドを使用して、ノードオブジェクトの `nodeName` を `node.Name` の値に更新します。例: `compute-0.example.com`。

次のコマンドを実行して、 PtpConfig CR を作成します。
```
$ oc create -f ordinary-clock-ptp-config.yaml
```

検証

PtpConfig プロファイルがノードに適用されていることを確認します。

以下のコマンドを実行して、openshift-ptp namespace の Pod の一覧を取得します。

$ oc get pods -n openshift-ptp -o wide

出力例

NAME                            READY   STATUS    RESTARTS   AGE   IP               NODE
linuxptp-daemon-4xkbb           1/1     Running   0          43m   10.1.196.24      compute-0.example.com
linuxptp-daemon-tdspf           1/1     Running   0          43m   10.1.196.25      compute-1.example.com
ptp-operator-657bbb64c8-2f8sj   1/1     Running   0          43m   10.129.0.61      control-plane-1.example.com

$ oc logs linuxptp-daemon-4xkbb -n openshift-ptp -c linuxptp-daemon-container

出力例

I1115 09:41:17.117596 4143292 daemon.go:107] in applyNodePTPProfile
I1115 09:41:17.117604 4143292 daemon.go:109] updating NodePTPProfile to:
I1115 09:41:17.117607 4143292 daemon.go:110] ------------------------------------
I1115 09:41:17.117612 4143292 daemon.go:102] Profile Name: profile1
I1115 09:41:17.117616 4143292 daemon.go:102] Interface: ens787f1
I1115 09:41:17.117620 4143292 daemon.go:102] Ptp4lOpts: -2 -s
I1115 09:41:17.117623 4143292 daemon.go:102] Phc2sysOpts: -a -r -n 24
I1115 09:41:17.117626 4143292 daemon.go:116] ------------------------------------

関連情報

PTP ハードウェアでの FIFO 優先度スケジューリングの詳細については、PTP ハードウェアの FIFO 優先度スケジューリングの設定を参照してください。
PTP 高速イベントの設定の詳細は、PTP 高速イベント通知パブリッシャーの設定を参照してください。

19.6.4. linuxptp サービスを境界クロックとして設定

PtpConfig カスタムリソース (CR) オブジェクトを作成して、linuxptp サービス (ptp4l、phc2sys を設定できます。

注記

次の例の PtpConfig CR を、特定のハードウェアおよび環境の境界クロックとして linuxptp サービスを設定する基礎として使用します。この例の CR は PTP 高速イベントを設定しません。PTP 高速イベントを設定するには、ptp4lOpts、ptp4lConf、ptpClockThreshold に適切な値を設定します。ptpClockThreshold は、イベントが有効になっている場合にのみ使用されます。詳細は、「PTP 高速イベント通知パブリッシャーの設定」を参照してください。

前提条件

OpenShift CLI (oc) がインストールされている。
cluster-admin 権限を持つユーザーとしてログインしている。
PTP Operator をインストールします。

手順

以下の PtpConfig CR を作成してから、YAML を boundary-clock-ptp-config.yaml ファイルに保存します。

推奨される PTP 境界クロックの設定

---
apiVersion: ptp.openshift.io/v1
kind: PtpConfig
metadata:
  name: boundary-clock-ptp-config
  namespace: openshift-ptp
spec:
  profile:
  - name: boundary-clock
    phc2sysOpts: "-a -r -n 24"
    ptp4lOpts: "-2"
    ptpSchedulingPolicy: SCHED_FIFO
    ptpSchedulingPriority: 10
    ptp4lConf: |
      [<interface_1>]
      masterOnly 0
      [<interface_2>]
      masterOnly 1
      [<interface_3>]
      masterOnly 1
      [<interface_4>]
      masterOnly 1
      [global]
      #
      # Default Data Set
      #
      twoStepFlag 1
      slaveOnly 0
      priority1 128
      priority2 128
      domainNumber 24
      clockClass 248
      clockAccuracy 0xFE
      offsetScaledLogVariance 0xFFFF
      free_running 0
      freq_est_interval 1
      dscp_event 0
      dscp_general 0
      dataset_comparison G.8275.x
      G.8275.defaultDS.localPriority 128
      #
      # Port Data Set
      #
      logAnnounceInterval -3
      logSyncInterval -4
      logMinDelayReqInterval -4
      logMinPdelayReqInterval -4
      announceReceiptTimeout 3
      syncReceiptTimeout 0
      delayAsymmetry 0
      fault_reset_interval 4
      neighborPropDelayThresh 20000000
      masterOnly 0
      G.8275.portDS.localPriority 128
      #
      # Run time options
      #
      assume_two_step 0
      logging_level 6
      path_trace_enabled 0
      follow_up_info 0
      hybrid_e2e 0
      inhibit_multicast_service 0
      net_sync_monitor 0
      tc_spanning_tree 0
      tx_timestamp_timeout 50
      unicast_listen 0
      unicast_master_table 0
      unicast_req_duration 3600
      use_syslog 1
      verbose 0
      summary_interval 0
      kernel_leap 1
      check_fup_sync 0
      #
      # Servo Options
      #
      pi_proportional_const 0.0
      pi_integral_const 0.0
      pi_proportional_scale 0.0
      pi_proportional_exponent -0.3
      pi_proportional_norm_max 0.7
      pi_integral_scale 0.0
      pi_integral_exponent 0.4
      pi_integral_norm_max 0.3
      step_threshold 2.0
      first_step_threshold 0.00002
      max_frequency 900000000
      clock_servo pi
      sanity_freq_limit 200000000
      ntpshm_segment 0
      #
      # Transport options
      #
      transportSpecific 0x0
      ptp_dst_mac 01:1B:19:00:00:00
      p2p_dst_mac 01:80:C2:00:00:0E
      udp_ttl 1
      udp6_scope 0x0E
      uds_address /var/run/ptp4l
      #
      # Default interface options
      #
      clock_type BC
      network_transport L2
      delay_mechanism E2E
      time_stamping hardware
      tsproc_mode filter
      delay_filter moving_median
      delay_filter_length 10
      egressLatency 0
      ingressLatency 0
      boundary_clock_jbod 0
      #
      # Clock description
      #
      productDescription ;;
      revisionData ;;
      manufacturerIdentity 00:00:00
      userDescription ;
      timeSource 0xA0
  recommend:
  - profile: boundary-clock
    priority: 4
    match:
    - nodeLabel: node-role.kubernetes.io/master
      nodeName: <nodename>

表19.3 PTP 境界クロックの CR 設定オプション

カスタムリソースフィールド	説明
`name`	`PtpConfig` CR の名前。
`profile`	1 つ以上の `profile` オブジェクトの配列を指定します。
`name`	プロファイルオブジェクトを一意に識別するプロファイルオブジェクトの名前を指定します。
`ptp4lOpts`	`ptp4l` サービスのシステム設定オプションを指定します。ネットワークインターフェイス名とサービス設定ファイルが自動的に追加されるため、オプションには、ネットワークインターフェイス名 `-i <interface>` およびサービス設定ファイル `-f /etc/ptp4l.conf` を含めないでください。
`ptp4lConf`	`ptp4l` を境界クロックとして起動するために必要な設定を指定します。たとえば、`ens1f0` はグランドマスタークロックから同期し、`ens1f3` は接続されたデバイスを同期します。
`<interface_1>`	同期クロックを受信するインターフェイス。
`<interface_2>`	Synchronization クロックを送信するインターフェイス。
`tx_timestamp_timeout`	Intel Columbiaville 800 Series NIC の場合、`tx_timestamp_timeout` を `50` に設定します。
`boundary_clock_jbod`	Intel Columbiaville 800 Series NIC の場合、`boundary_clock_jbod` が `0` に設定されていることを確認します。Intel Fortville X710 シリーズ NIC の場合、`boundary_clock_jbod` が `1` に設定されていることを確認します。
`phc2sysOpts`	`phc2sys` サービスのシステム設定オプションを指定します。このフィールドが空の場合、PTP Operator は `phc2sys` サービスを開始しません。
`ptpSchedulingPolicy`	ptp4l と phc2sys プロセスのスケジューリングポリシー。デフォルト値は `SCHED_OTHER` です。FIFO スケジューリングをサポートするシステムでは、`SCHED_FIFO` を使用してください。
`ptpSchedulingPriority`	`ptp SchedulingPolicy` が `SCHED_FIFO` に設定されている場合に、`ptp4l` および `phc2sys` プロセスの FIFO の優先度を設定するために使用される 1-65 の整数値。`ptpSchedulingPriority` フィールドは、`ptpSchedulingPolicy` が `SCHED_OTHER` に設定されている場合は使用されません。
`ptpClockThreshold`	オプション: `ptpClockThreshold` が存在しない場合、`ptpClockThreshold` フィールドにはデフォルト値が使用されます。`ptpClockThreshold` は、PTP マスタークロックが切断されてから PTP イベントが発生するまでの時間を設定します。`holdOverTimeout` は、PTP マスタークロックが切断されたときに、PTP クロックイベントの状態が `FREERUN` に変わるまでの時間値 (秒単位) です。`maxOffsetThreshold` および `minOffsetThreshold` 設定は、`CLOCK_REALTIME` (`phc2sys`) またはマスターオフセット (`ptp4l`) の値と比較するナノ秒単位のオフセット値を設定します。`ptp4l` または `phc2sys` のオフセット値がこの範囲外の場合、PTP クロックの状態が `FREERUN` に設定されます。オフセット値がこの範囲内にある場合、PTP クロックの状態が `LOCKED` に設定されます。
`recommend`	`profile` がノードに適用される方法を定義する 1 つ以上の `recommend` オブジェクトの配列を指定します。
`.recommend.profile`	`profile` セクションで定義される `.recommend.profile` オブジェクト名を指定します。
`.recommend.priority`	`0` から `99` までの整数値で `priority` を指定します。数値が大きいほど優先度が低くなるため、`99` の優先度は `10` よりも低くなります。ノードが `match` フィールドで定義されるルールに基づいて複数のプロファイルに一致する場合、優先順位の高いプロファイルがそのノードに適用されます。
`.recommend.match`	`.recommend.match` ルールを `nodeLabel` または `nodeName` に指定します。
`.recommend.match.nodeLabel`	`oc get nodes --show-labels` コマンドを使用して、ノードオブジェクトの`node.Labels` の `key` を `nodeLabel` に指定します。例: `node-role.kubernetes.io/worker`。
`.recommend.match.nodeLabel`	`oc get nodes` コマンドを使用して、ノードオブジェクトの `nodeName` を `node.Name` の値に更新します。例: `compute-0.example.com`。

以下のコマンドを実行して CR を作成します。
```
$ oc create -f boundary-clock-ptp-config.yaml
```

検証

PtpConfig プロファイルがノードに適用されていることを確認します。

以下のコマンドを実行して、openshift-ptp namespace の Pod の一覧を取得します。

$ oc get pods -n openshift-ptp -o wide

出力例

NAME                            READY   STATUS    RESTARTS   AGE   IP               NODE
linuxptp-daemon-4xkbb           1/1     Running   0          43m   10.1.196.24      compute-0.example.com
linuxptp-daemon-tdspf           1/1     Running   0          43m   10.1.196.25      compute-1.example.com
ptp-operator-657bbb64c8-2f8sj   1/1     Running   0          43m   10.129.0.61      control-plane-1.example.com

$ oc logs linuxptp-daemon-4xkbb -n openshift-ptp -c linuxptp-daemon-container

出力例

I1115 09:41:17.117596 4143292 daemon.go:107] in applyNodePTPProfile
I1115 09:41:17.117604 4143292 daemon.go:109] updating NodePTPProfile to:
I1115 09:41:17.117607 4143292 daemon.go:110] ------------------------------------
I1115 09:41:17.117612 4143292 daemon.go:102] Profile Name: profile1
I1115 09:41:17.117616 4143292 daemon.go:102] Interface:
I1115 09:41:17.117620 4143292 daemon.go:102] Ptp4lOpts: -2
I1115 09:41:17.117623 4143292 daemon.go:102] Phc2sysOpts: -a -r -n 24
I1115 09:41:17.117626 4143292 daemon.go:116] ------------------------------------

関連情報

PTP ハードウェアでの FIFO 優先度スケジューリングの詳細については、PTP ハードウェアの FIFO 優先度スケジューリングの設定を参照してください。
PTP 高速イベントの設定の詳細は、PTP 高速イベント通知パブリッシャーの設定を参照してください。

19.6.5. linuxptp サービスをデュアル NIC ハードウェアの境界クロックとして設定

重要

デュアル NIC で境界クロックとして設定した PTP (Precision Time Protocol) ハードウェアは、テクノロジープレビュー機能としてのみ提供されています。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行いフィードバックを提供していただくことを目的としています。

Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲を参照してください。

NIC ごとに PtpConfig カスタムリソース (CR) オブジェクトを作成することにより、linuxptp サービス (ptp4l、phc2sys) をデュアル NIC ハードウェアの境界クロックとして設定できます。

デュアル NIC ハードウェアを使用すると、各 NIC を同じアップストリームリーダークロックに接続し、NIC ごとに個別の ptp4l インスタンスをダウンストリームクロックに供給することができます。

前提条件

OpenShift CLI (oc) がインストールされている。
cluster-admin 権限を持つユーザーとしてログインしている。
PTP Operator をインストールします。

手順

linuxptp サービスを境界クロックとして設定の参照 CR を各 CR の基礎として使用して、NIC ごとに 1 つずつ、2 つの個別の PtpConfigCR を作成します。以下に例を示します。
1. phc2sysOpts の値を指定して、boundary-clock-ptp-config-nic1.yaml を作成します。
```
apiVersion: ptp.openshift.io/v1
kind: PtpConfig
metadata:
  name: boundary-clock-ptp-config-nic1
  namespace: openshift-ptp
spec:
  profile:
  - name: "profile1"
    ptp4lOpts: "-2 --summary_interval -4"
    ptp4lConf: | 1
      [ens5f1]
      masterOnly 1
      [ens5f0]
      masterOnly 0
    ...
    phc2sysOpts: "-a -r -m -n 24 -N 8 -R 16" 2
```
  1
  ptp4l を境界クロックとして開始するために必要なインターフェイスを指定します。たとえば、ens5f0 はグランドマスタークロックから同期し、ens5f1 は接続された機器から同期します。
  2
  phc2sysOpts の値が必要です。-m はメッセージを stdout に出力します。linuxptp-daemon DaemonSet はログを解析し、Prometheus メトリックを生成します。
2. boundary-clock-ptp-config-nic2.yaml を作成し、phc2sysOpts フィールドを完全に削除して、2 番目の NIC の phc2sys サービスを無効にします。
```
apiVersion: ptp.openshift.io/v1
kind: PtpConfig
metadata:
  name: boundary-clock-ptp-config-nic2
  namespace: openshift-ptp
spec:
  profile:
  - name: "profile2"
    ptp4lOpts: "-2 --summary_interval -4"
    ptp4lConf: | 1
      [ens7f1]
      masterOnly 1
      [ens7f0]
      masterOnly 0
...
```
  1
  2 番目の NIC の境界クロックとして ptp4l を開始するために必要なインターフェイスを指定します。
  注記
  2 番目の NIC で phc2sys サービスを無効にするには、2 番目の PtpConfig CR から phc2sysOpts フィールドを完全に削除する必要があります。
次のコマンドを実行して、デュアル NIC PtpConfigCR を作成します。
1. 1 番目の NIC の PTP を設定する CR を作成します。
```
$ oc create -f boundary-clock-ptp-config-nic1.yaml
```
2. 2 番目の NIC の PTP を設定する CR を作成します。
```
$ oc create -f boundary-clock-ptp-config-nic2.yaml
```

検証

PTP Operator が両方の NIC に PtpConfigCR を適用していることを確認してください。デュアル NIC ハードウェアがインストールされているノードに対応する linuxptp デーモンのログを調べます。たとえば、以下のコマンドを実行します。

$ oc logs linuxptp-daemon-cvgr6 -n openshift-ptp -c linuxptp-daemon-container

出力例

ptp4l[80828.335]: [ptp4l.1.config] master offset          5 s2 freq   -5727 path delay       519
ptp4l[80828.343]: [ptp4l.0.config] master offset         -5 s2 freq  -10607 path delay       533
phc2sys[80828.390]: [ptp4l.0.config] CLOCK_REALTIME phc offset         1 s2 freq  -87239 delay    539

19.6.6. PTP 通常クロックの参照としての IntelColumbiavilleE800 シリーズ NIC

次の表に、Intel Columbiaville E800 シリーズ NIC を通常のクロックとして使用するために参照 PTP 設定に加える必要のある変更を示します。クラスターに適用する PtpConfig カスタムリソース (CR) に変更を加えます。

表19.4 Intel Columbiaville NIC の推奨 PTP 設定

PTP 設定	推奨設定
`phc2sysOpts`	`-a -r -m -n 24 -N 8 -R 16`
`tx_timestamp_timeout`	`50`
`boundary_clock_jbod`	`0`

注記

phc2sysOpts の場合、-m はメッセージを stdout に出力します。linuxptp-daemon DaemonSet はログを解析し、Prometheus メトリックを生成します。

関連情報

linuxptp サービスを PTP 高速イベントを使用して通常クロックとして設定する CR の完全な例については、Configuring linuxptp services as ordinary clock を参照してください。

19.6.7. PTP ハードウェアの FIFO 優先スケジューリングの設定

低遅延のパフォーマンスを確保する必要のある通信業者や他のデプロイメント設定では、PTP デーモンスレッドは、制約された CPU フットプリントで、残りのインフラストラクチャーのコンポーネントと一緒に、実行されます。デフォルトでは、PTP スレッドは SCHED_OTHER ポリシーで実行されます。負荷が高いと、エラーなしで運用する必要のある、これらのスレッドのスケジューリングでレイテンシーが発生する可能性があります。

スケジューリングのレイテンシーでエラーが発生する可能性を軽減するために、SCHED_FIFO ポリシーでスレッドを実行できるように、PTP Operator の linuxptp サービスを設定できます。Ptp ConfigCR に SCHED_FIFO が設定されている場合には、ptp4l と phc2sys は、Ptp ConfigCR の ptp Scheduling Priority フィールドで設定された優先順位で、chrt の下の親コンテナーで実行されます。

注記

ptp Scheduling Policy の設定はオプションで、レイテンシーエラーが発生している場合にのみ必要となります。

手順

Ptp Config CR プロファイルを編集します。
```
$ oc edit PtpConfig -n openshift-ptp
```
ptp Scheduling Policy と ptp Scheduling Priority フィールドを変更します。
```
apiVersion: ptp.openshift.io/v1
kind: PtpConfig
metadata:
  name: <ptp_config_name>
  namespace: openshift-ptp
...
spec:
  profile:
  - name: "profile1"
...
    ptpSchedulingPolicy: SCHED_FIFO 1
    ptpSchedulingPriority: 10 2
```
1
ptp4l と phc2sys プロセスのスケジューリングポリシー。FIFO スケジューリングをサポートするシステムでは、SCHED_FIFO を使用してください。
2
必須。ptp4l および phc2sys プロセスの FIFO 優先度の設定に使用する 1～65 の整数値を設定します。
保存して終了すると、Ptp ConfigCR に変更が適用されます。

検証

Ptp ConfigCR が適用された linuxptp-daemon Pod と対応するノードの名前を取得します。

$ oc get pods -n openshift-ptp -o wide

出力例

NAME                            READY   STATUS    RESTARTS   AGE     IP            NODE
linuxptp-daemon-gmv2n           3/3     Running   0          1d17h   10.1.196.24   compute-0.example.com
linuxptp-daemon-lgm55           3/3     Running   0          1d17h   10.1.196.25   compute-1.example.com
ptp-operator-3r4dcvf7f4-zndk7   1/1     Running   0          1d7h    10.129.0.61   control-plane-1.example.com

ptp4l プロセスが、更新された chrtFIFO 優先度で実行されていることを確認します。

$ oc -n openshift-ptp logs linuxptp-daemon-lgm55 -c linuxptp-daemon-container|grep chrt

出力例

I1216 19:24:57.091872 1600715 daemon.go:285] /bin/chrt -f 65 /usr/sbin/ptp4l -f /var/run/ptp4l.0.config -2  --summary_interval -4 -m

19.6.8. linuxptp サービスのログフィルタリングの設定

linuxptp デーモンは、デバッグに使用できるログを生成します。ストレージ容量が制限されている通信またはその他のデプロイメント設定では、これらのログはストレージ需要に追加できます。

ログメッセージの数を減らすために、PtpConfig カスタムリソース (CR) を設定して、master offset 値をレポートするログメッセージを除外できます。master offset ログメッセージは、現在のノードのクロックとマスタークロックの違いをナノ秒単位でレポートします。

前提条件

OpenShift CLI (oc) がインストールされている。
cluster-admin 権限を持つユーザーとしてログインしている。
PTP Operator をインストールします。

手順

PtpConfig CR を編集します。
```
$ oc edit PtpConfig -n openshift-ptp
```
spec.profile で、ptpSettings.logReduce 仕様を追加し、値を true に設定します。
```
apiVersion: ptp.openshift.io/v1
kind: PtpConfig
metadata:
  name: <ptp_config_name>
  namespace: openshift-ptp
...
spec:
  profile:
  - name: "profile1"
...
    ptpSettings:
      logReduce: "true"
```
注記
デバッグの目的で、この仕様を False に戻すと、マスターオフセットメッセージを含めることができます。
保存して終了すると、Ptp ConfigCR に変更が適用されます。

検証

Ptp ConfigCR が適用された linuxptp-daemon Pod と対応するノードの名前を取得します。

$ oc get pods -n openshift-ptp -o wide

出力例

NAME                            READY   STATUS    RESTARTS   AGE     IP            NODE
linuxptp-daemon-gmv2n           3/3     Running   0          1d17h   10.1.196.24   compute-0.example.com
linuxptp-daemon-lgm55           3/3     Running   0          1d17h   10.1.196.25   compute-1.example.com
ptp-operator-3r4dcvf7f4-zndk7   1/1     Running   0          1d7h    10.129.0.61   control-plane-1.example.com

次のコマンドを実行して、マスターオフセットメッセージがログから除外されていることを確認します。
```
$ oc -n openshift-ptp logs <linux_daemon_container> -c linuxptp-daemon-container | grep "master offset" 1
```
1
<linux_daemon_container> は linuxptp-daemon Pod の名前です (例: linuxptp-daemon-gmv2n)。
logReduce 仕様を設定する場合、このコマンドは linuxptp デーモンのログに master offset のインスタンスを報告しません。

Select Your Language

Infrastructure and Management

Cloud Computing

Storage

Runtimes

Integration and Automation

19.6. PTP デバイスの設定

19.6.1. クラスター内の PTP 対応ネットワークデバイスの検出

19.6.2. linuxptp サービスをグランドマスタークロックとして設定する

19.6.2.1. grandmaster クロック PtpConfig 設定リファレンス

19.6.3. linuxptp サービスを通常のクロックとして設定

19.6.4. linuxptp サービスを境界クロックとして設定

19.6.5. linuxptp サービスをデュアル NIC ハードウェアの境界クロックとして設定

19.6.6. PTP 通常クロックの参照としての IntelColumbiavilleE800 シリーズ NIC

19.6.7. PTP ハードウェアの FIFO 優先スケジューリングの設定

19.6.8. linuxptp サービスのログフィルタリングの設定

Language and Page Formatting Options

19.6. PTP デバイスの設定

19.6.1. クラスター内の PTP 対応ネットワークデバイスの検出

19.6.2. linuxptp サービスをグランドマスタークロックとして設定する

19.6.2.1. grandmaster クロック PtpConfig 設定リファレンス

19.6.3. linuxptp サービスを通常のクロックとして設定

19.6.4. linuxptp サービスを境界クロックとして設定

19.6.5. linuxptp サービスをデュアル NIC ハードウェアの境界クロックとして設定

19.6.6. PTP 通常クロックの参照としての IntelColumbiavilleE800 シリーズ NIC

19.6.7. PTP ハードウェアの FIFO 優先スケジューリングの設定

19.6.8. linuxptp サービスのログフィルタリングの設定