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

PDF

PTP Operator は PtpConfig.ptp.openshift.io カスタムリソース定義 (CRD) を OpenShift Container Platform に追加します。PtpConfig カスタムリソース (CR) オブジェクトを作成して、linuxptp サービス (ptp4l、phc2sys) を設定できます。

前提条件

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

手順

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

apiVersion: ptp.openshift.io/v1
kind: PtpConfig
metadata:
  name: boundary-clock-ptp-config 1
  namespace: openshift-ptp
spec:
  profile: 2
  - name: "profile1" 3
    interface: "" 4
    ptp4lOpts: "-2" 5
    ptp4lConf: | 6
      [ens1f0] 7
      masterOnly 0
      [ens1f3] 8
      masterOnly 1
      [global]
      #
      # Default Data Set
      #
      twoStepFlag                       1
      #slaveOnly                        1
      priority1                         128
      priority2                         128
      domainNumber                      24
      #utc_offset                       37
      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       10
      #was 1 (default !)
      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            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    UDPv4
      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 9
      #
      # Clock description
      #
      productDescription    ;;
      revisionData            ;;
      manufacturerIdentity  00:00:00
      userDescription         ;
      timeSource              0xA0
    phc2sysOpts: "-a -r" 10
    ptpSchedulingPolicy: SCHED_OTHER 11
    ptpSchedulingPriority: 10 12
  recommend: 13
  - profile: "profile1" 14
    priority: 10 15
    match: 16
    - nodeLabel: "node-role.kubernetes.io/worker" 17
      nodeName: "compute-0.example.com" 18

1: PtpConfig CR の名前。
2: 1 つ以上の profile オブジェクトの配列を指定します。
3: プロファイルオブジェクトを一意に識別するプロファイルオブジェクトの名前を指定します。
4: このフィールドは、境界クロックの場合は空のままにする必要があります。
5: ptp4l サービスのシステム設定オプション (例: -2) を指定します。ネットワークインターフェイス名とサービス設定ファイルが自動的に追加されるため、オプションには、ネットワークインターフェイス名 -i <interface> およびサービス設定ファイル -f /etc/ptp4l.conf を含めないでください。
6: ptp4l を境界クロックとして起動するために必要な設定を指定します。たとえば、ens1f0 はグランドマスタークロックから同期し、ens1f3 は接続されたデバイスを同期します。
7: 同期元のインターフェイス名。
8: インターフェイスに接続されたデバイスを同期するインターフェイス。
9: Intel Columbiaville 800 Series NIC の場合、boundary_clock_jbod が 0 に設定されていることを確認します。Intel Fortville X710 シリーズ NIC の場合、boundary_clock_jbod が 1 に設定されていることを確認します。
10: phc2sys サービスのシステム設定オプション (例: -a -r) を指定します。このフィールドが空の場合、PTP Operator は phc2sys サービスを開始しません。
11: ptp4l と phc2sys プロセスのスケジューリングポリシー。デフォルト値は SCHED_OTHER です。FIFO スケジューリングをサポートするシステムでは、SCHED_FIFO を使用してください。
12: ptp SchedulingPolicy が SCHED_FIFO に設定されている場合に、ptp4l および phc2sys プロセスの FIFO の優先度を設定するために使用される 1-65 の整数値。ptpSchedulingPriority フィールドは、ptpSchedulingPolicy が SCHED_OTHER に設定されている場合は使用されません。
13: profile がノードに適用される方法を定義する 1 つ以上の recommend オブジェクトの配列を指定します。
14: profile セクションに定義される profile オブジェクト名を指定します。
15: 0 から 99 までの整数値で priority を指定します。数値が大きいほど優先度が低くなるため、99 の優先度は 10 よりも低くなります。ノードが match フィールドで定義されるルールに基づいて複数のプロファイルに一致する場合、優先順位の高いプロファイルがそのノードに適用されます。
16: match ルールを、nodeLabel または nodeName で指定します。
17: oc get nodes --show-labels コマンドを使用して、ノードオブジェクトのnode.LabelsのkeyでnodeLabelを指定します。
18: oc get nodesコマンドを使用して、ノードオブジェクトのnode.NameでnodeNameを指定します。

以下のコマンドを実行して 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

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

$ 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
I1115 09:41:17.117626 4143292 daemon.go:116] ------------------------------------

関連情報

PTP ハードウェアでの FIFO 優先度スケジューリングの詳細については、PTP ハードウェアの FIFO 優先度スケジューリングの設定を参照してください。

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

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Red Hat legal and privacy links

Red Hat legal and privacy links