Language:
Format:

19.2. 配置 PTP 设备

PTP Operator 将 NodePtpDevice.ptp.openshift.io 自定义资源定义（CRD）添加到 OpenShift Container Platform。

安装后，PTP Operator 会在每个节点中搜索具有 PTP 功能的网络设备。它为提供兼容 PTP 的网络设备的每个节点创建并更新 NodePtpDevice 自定义资源(CR)对象。

19.2.1. 使用 CLI 安装 PTP Operator

作为集群管理员，您可以使用 CLI 安装 Operator。

先决条件

在裸机中安装有支持 PTP 硬件的节点的集群。
安装 OpenShift CLI（oc）。
以具有 cluster-admin 特权的用户身份登录。

流程

为 PTP Operator 创建命名空间。

将以下 YAML 保存到 ptp-namespace.yaml 文件中：

apiVersion: v1
kind: Namespace
metadata:
  name: openshift-ptp
  annotations:
    workload.openshift.io/allowed: management
  labels:
    name: openshift-ptp
    openshift.io/cluster-monitoring: "true"

创建 Namespace CR：
```
$ oc create -f ptp-namespace.yaml
```

为 PTP Operator 创建 Operator 组。

在 ptp-operatorgroup.yaml 文件中保存以下 YAML：

apiVersion: operators.coreos.com/v1
kind: OperatorGroup
metadata:
  name: ptp-operators
  namespace: openshift-ptp
spec:
  targetNamespaces:
  - openshift-ptp

创建 OperatorGroup CR：
```
$ oc create -f ptp-operatorgroup.yaml
```

订阅 PTP Operator。

将以下 YAML 保存到 ptp-sub.yaml 文件中：

apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: ptp-operator-subscription
  namespace: openshift-ptp
spec:
  channel: "stable"
  name: ptp-operator
  source: redhat-operators
  sourceNamespace: openshift-marketplace

创建 Subscription CR：
```
$ oc create -f ptp-sub.yaml
```

要验证是否已安装 Operator，请输入以下命令：

$ oc get csv -n openshift-ptp -o custom-columns=Name:.metadata.name,Phase:.status.phase

输出示例

Name                         Phase
4.14.0-202301261535          Succeeded

19.2.2. 使用 Web 控制台安装 PTP Operator

作为集群管理员，您可以使用 Web 控制台安装 PTP Operator。

注意

如上一节所述，您必须创建命名空间和 operator 组。

流程

使用 OpenShift Container Platform Web 控制台安装 PTP Operator：
1. 在 OpenShift Container Platform Web 控制台中，点击 Operators → OperatorHub。
2. 从可用的 Operator 列表中选择 PTP Operator，然后点 Install。
3. 在 Install Operator 页面中，在 A specific namespace on the cluster 下选择 openshift-ptp。然后点击 Install。
可选：验证是否成功安装了 PTP Operator：
1. 切换到 Operators → Installed Operators 页面。
2. 确保 openshift-ptp 项目中列出的 PTP Operator 的 Status 为 InstallSucceeded。
  注意
  在安装过程中，Operator 可能会显示 Failed 状态。如果安装过程结束后有 InstallSucceeded 信息，您可以忽略这个 Failed 信息。
  如果 Operator 没有被成功安装，请按照以下步骤进行故障排除：
  - 进入 Operators → Installed Operators 页面，检查 Operator Subscriptions 和 Install Plans 选项卡中的 Status 项中是否有任何错误。
  - 进入 Workloads → Pods 页面，检查 openshift-ptp 项目中 pod 的日志。

19.2.3. 在集群中发现具有 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: devices 集合包含 PTP Operator 发现节点的 PTP 功能设备列表。

19.2.4. 在 PTP Operator 中使用特定于硬件的 NIC 功能

带有内置 PTP 功能的 NIC 硬件有时需要特定于设备的配置。您可以通过在 PtpConfig 自定义资源(CR)中配置插件，将特定于硬件的 NIC 功能用于 PTP Operator 支持的硬件。linuxptp-daemon 服务使用 plugin 小节中的指定参数根据特定的硬件配置启动 linuxptp 进程(ptp4l 和 phc2sys)。

重要

在 OpenShift Container Platform 4.14 中，通过 PtpConfig 插件支持 Intel E810 NIC。

19.2.5. 将 linuxptp 服务配置为 grandmaster 时钟

您可以通过创建一个配置主机 NIC 的 PtpConfig 自定义资源(CR)将 linuxptp 服务(ptp4l、phc2sys、ts2phc)配置为 grandmaster 时钟(T-GM)。

ts2phc 工具允许您将系统时钟与 PTP grandmaster 时钟同步，以便节点可以将精度时钟信号流传输到下游 PTP 普通时钟和边界时钟。

注意

使用 PtpConfig CR 示例，将 linuxptp 服务配置为 Intel Westport Channel E810-XXVDA4T 网络接口的 T-GM。

要配置 PTP 快速事件，请为 ptp4lOpts、ptp4lConf 和 ptpClockThreshold 设置适当的值。ptpClockThreshold 仅在启用事件时使用。如需更多信息，请参阅"配置 PTP 快速事件通知发布程序"。

先决条件

对于生产环境中的 T-GM 时钟，请在裸机集群主机上安装 Intel E810 Westport Channel NIC。
安装 OpenShift CLI (oc) 。
以具有 cluster-admin 特权的用户身份登录。
安装 PTP Operator。

流程

创建 PtpConfig CR。例如：

根据您的要求，为您的部署使用以下 T-GM 配置之一。将 YAML 保存到 grandmaster-clock-ptp-config.yaml 文件中：

例 19.1. 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 $iface_master -n 24
    ptpSchedulingPolicy: SCHED_FIFO
    ptpSchedulingPriority: 10
    ptpSettings:
      logReduce: "true"
    plugins:
      e810:
        enableDefaultConfig: false
        settings:
          LocalMaxHoldoverOffSet: 1500
          LocalHoldoverTimeout: 14400
          MaxInSpecOffset: 100
        pins: $e810_pins
        #  "$iface_master":
        #    "U.FL2": "0 2"
        #    "U.FL1": "0 1"
        #    "SMA2": "0 2"
        #    "SMA1": "0 1"
        ublxCmds:
          - args: #ubxtool -P 29.20 -z CFG-HW-ANT_CFG_VOLTCTRL,1
              - "-P"
              - "29.20"
              - "-z"
              - "CFG-HW-ANT_CFG_VOLTCTRL,1"
            reportOutput: false
          - args: #ubxtool -P 29.20 -e GPS
              - "-P"
              - "29.20"
              - "-e"
              - "GPS"
            reportOutput: false
          - args: #ubxtool -P 29.20 -d Galileo
              - "-P"
              - "29.20"
              - "-d"
              - "Galileo"
            reportOutput: false
          - args: #ubxtool -P 29.20 -d GLONASS
              - "-P"
              - "29.20"
              - "-d"
              - "GLONASS"
            reportOutput: false
          - args: #ubxtool -P 29.20 -d BeiDou
              - "-P"
              - "29.20"
              - "-d"
              - "BeiDou"
            reportOutput: false
          - args: #ubxtool -P 29.20 -d SBAS
              - "-P"
              - "29.20"
              - "-d"
              - "SBAS"
            reportOutput: false
          - args: #ubxtool -P 29.20 -t -w 5 -v 1 -e SURVEYIN,600,50000
              - "-P"
              - "29.20"
              - "-t"
              - "-w"
              - "5"
              - "-v"
              - "1"
              - "-e"
              - "SURVEYIN,600,50000"
            reportOutput: true
          - args: #ubxtool -P 29.20 -p MON-HW
              - "-P"
              - "29.20"
              - "-p"
              - "MON-HW"
            reportOutput: true
    ts2phcOpts: " "
    ts2phcConf: |
      [nmea]
      ts2phc.master 1
      [global]
      use_syslog  0
      verbose 1
      logging_level 7
      ts2phc.pulsewidth 100000000
      ts2phc.nmea_serialport $gnss_serialport
      leapfile  /usr/share/zoneinfo/leap-seconds.list
      [$iface_master]
      ts2phc.extts_polarity rising
      ts2phc.extts_correction 0
    ptp4lConf: |
      [$iface_master]
      masterOnly 1
      [$iface_master_1]
      masterOnly 1
      [$iface_master_2]
      masterOnly 1
      [$iface_master_3]
      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
      clock_class_threshold 7
      #
      # 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
      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/$mcp"

注意

PTP grandmaster 时钟配置示例仅用于测试目的，不适用于生产环境。

例 19.2. E810 NIC 的 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 $iface_master -n 24
    ptpSchedulingPolicy: SCHED_FIFO
    ptpSchedulingPriority: 10
    ptpSettings:
      logReduce: "true"
    plugins:
      e810:
        enableDefaultConfig: false
        settings:
          LocalMaxHoldoverOffSet: 1500
          LocalHoldoverTimeout: 14400
          MaxInSpecOffset: 100
        pins: $e810_pins
        #  "$iface_master":
        #    "U.FL2": "0 2"
        #    "U.FL1": "0 1"
        #    "SMA2": "0 2"
        #    "SMA1": "0 1"
        ublxCmds:
          - args: #ubxtool -P 29.20 -z CFG-HW-ANT_CFG_VOLTCTRL,1
              - "-P"
              - "29.20"
              - "-z"
              - "CFG-HW-ANT_CFG_VOLTCTRL,1"
            reportOutput: false
          - args: #ubxtool -P 29.20 -e GPS
              - "-P"
              - "29.20"
              - "-e"
              - "GPS"
            reportOutput: false
          - args: #ubxtool -P 29.20 -d Galileo
              - "-P"
              - "29.20"
              - "-d"
              - "Galileo"
            reportOutput: false
          - args: #ubxtool -P 29.20 -d GLONASS
              - "-P"
              - "29.20"
              - "-d"
              - "GLONASS"
            reportOutput: false
          - args: #ubxtool -P 29.20 -d BeiDou
              - "-P"
              - "29.20"
              - "-d"
              - "BeiDou"
            reportOutput: false
          - args: #ubxtool -P 29.20 -d SBAS
              - "-P"
              - "29.20"
              - "-d"
              - "SBAS"
            reportOutput: false
          - args: #ubxtool -P 29.20 -t -w 5 -v 1 -e SURVEYIN,600,50000
              - "-P"
              - "29.20"
              - "-t"
              - "-w"
              - "5"
              - "-v"
              - "1"
              - "-e"
              - "SURVEYIN,600,50000"
            reportOutput: true
          - args: #ubxtool -P 29.20 -p MON-HW
              - "-P"
              - "29.20"
              - "-p"
              - "MON-HW"
            reportOutput: true
    ts2phcOpts: " "
    ts2phcConf: |
      [nmea]
      ts2phc.master 1
      [global]
      use_syslog  0
      verbose 1
      logging_level 7
      ts2phc.pulsewidth 100000000
      ts2phc.nmea_serialport $gnss_serialport
      leapfile  /usr/share/zoneinfo/leap-seconds.list
      [$iface_master]
      ts2phc.extts_polarity rising
      ts2phc.extts_correction 0
    ptp4lConf: |
      [$iface_master]
      masterOnly 1
      [$iface_master_1]
      masterOnly 1
      [$iface_master_2]
      masterOnly 1
      [$iface_master_3]
      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
      clock_class_threshold 7
      #
      # 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
      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/$mcp"

注意

对于 E810 Westport Channel NIC，将 ts2phc.nmea_serialport 的值设置为 /dev/gnss0。

运行以下命令来创建 CR：

$ oc create -f grandmaster-clock-ptp-config.yaml

验证

检查 PtpConfig 配置集是否已应用到节点。

运行以下命令，获取 openshift-ptp 命名空间中的 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

19.2.6. 将 linuxptp 服务配置为双 E810 Westport Channel NIC 的 grandmaster 时钟

您可以通过创建一个 PtpConfig 自定义资源(CR)来为双 E810 Westport Channel NIC 将 linuxptp 服务(ptp4l、phc2sys、ts2phc)配置为 grandmaster 时钟(T-GM)。

对于分布式 RAN (D-RAN) 用例，您可以为双 NIC 配置 PTP，如下所示：

NIC 一个与全局导航 Satellite 系统(GNSS)时间源同步。
NIC 2 将同步到 NIC 提供的 1PPS 时间输出。此配置由 PtpConfig CR 中的 PTP 硬件插件提供。

双 NIC PTP T-GM 配置使用单个 ptp4l 实例，一个 ts2phc 进程报告两个 ts2phc 实例，每个 NIC 都有一个 ts2phc 实例。主机系统时钟与连接到 GNSS 时间源的 NIC 同步。

注意

使用 PtpConfig CR 示例，将 linuxptp 服务配置为双 Intel Westport Channel E810-XXVDA4T 网络接口的 T-GM。

先决条件

对于生产环境中的 T-GM 时钟，请在裸机集群主机上安装两个 Intel E810 Westport Channel NIC。
安装 OpenShift CLI (oc) 。
以具有 cluster-admin 特权的用户身份登录。
安装 PTP Operator。

流程

创建 PtpConfig CR。例如：

将以下 YAML 保存到 grandmaster-clock-ptp-config-dual-nics.yaml 文件中：

例 19.3. 用于双 E810 NIC 的 PTP grandmaster 时钟配置

apiVersion: ptp.openshift.io/v1
kind: PtpConfig
metadata:
  name: grandmaster
  namespace: openshift-ptp
  annotations:
    ran.openshift.io/ztp-deploy-wave: "10"
spec:
  profile:
  - name: "grandmaster"
    ptp4lOpts: "-2 --summary_interval -4"
    phc2sysOpts: -r -u 0 -m -O -37 -N 8 -R 16 -s $iface_nic1 -n 24
    ptpSchedulingPolicy: SCHED_FIFO
    ptpSchedulingPriority: 10
    ptpSettings:
      logReduce: "true"
    plugins:
      e810:
        enableDefaultConfig: false
        settings:
          LocalMaxHoldoverOffSet: 1500
          LocalHoldoverTimeout: 14400
          MaxInSpecOffset: 100
        pins:
         "$iface_nic1":
           "U.FL2": "0 2"
           "U.FL1": "0 1"
           "SMA2": "0 2"
           "SMA1": "2 1"
         "$iface_nic2":
           "U.FL2": "0 2"
           "U.FL1": "0 1"
           "SMA2": "0 2"
           "SMA1": "1 1"
        ublxCmds:
          - args: #ubxtool -P 29.20 -z CFG-HW-ANT_CFG_VOLTCTRL,1
              - "-P"
              - "29.20"
              - "-z"
              - "CFG-HW-ANT_CFG_VOLTCTRL,1"
            reportOutput: false
          - args: #ubxtool -P 29.20 -e GPS
              - "-P"
              - "29.20"
              - "-e"
              - "GPS"
            reportOutput: false
          - args: #ubxtool -P 29.20 -d Galileo
              - "-P"
              - "29.20"
              - "-d"
              - "Galileo"
            reportOutput: false
          - args: #ubxtool -P 29.20 -d GLONASS
              - "-P"
              - "29.20"
              - "-d"
              - "GLONASS"
            reportOutput: false
          - args: #ubxtool -P 29.20 -d BeiDou
              - "-P"
              - "29.20"
              - "-d"
              - "BeiDou"
            reportOutput: false
          - args: #ubxtool -P 29.20 -d SBAS
              - "-P"
              - "29.20"
              - "-d"
              - "SBAS"
            reportOutput: false
          - args: #ubxtool -P 29.20 -t -w 5 -v 1 -e SURVEYIN,600,50000
              - "-P"
              - "29.20"
              - "-t"
              - "-w"
              - "5"
              - "-v"
              - "1"
              - "-e"
              - "SURVEYIN,600,50000"
            reportOutput: true
          - args: #ubxtool -P 29.20 -p MON-HW
              - "-P"
              - "29.20"
              - "-p"
              - "MON-HW"
            reportOutput: true
    ts2phcOpts: " "
    ts2phcConf: |
      [nmea]
      ts2phc.master 1
      [global]
      use_syslog  0
      verbose 1
      logging_level 7
      ts2phc.pulsewidth 100000000
      #cat /dev/GNSS to find available serial port
      #example value of gnss_serialport is /dev/ttyGNSS_1700_0
      ts2phc.nmea_serialport $gnss_serialport
      leapfile  /usr/share/zoneinfo/leap-seconds.list
      [$iface_nic1]
      ts2phc.extts_polarity rising
      ts2phc.extts_correction 0
      [$iface_nic2]
      ts2phc.master 0
      ts2phc.extts_polarity rising
      #this is a measured value in nanoseconds to compensate for SMA cable delay
      ts2phc.extts_correction -10
    ptp4lConf: |
      [$iface_nic1]
      masterOnly 1
      [$iface_nic1_1]
      masterOnly 1
      [$iface_nic1_2]
      masterOnly 1
      [$iface_nic1_3]
      masterOnly 1
      [$iface_nic2]
      masterOnly 1
      [$iface_nic2_1]
      masterOnly 1
      [$iface_nic2_2]
      masterOnly 1
      [$iface_nic2_3]
      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
      clock_class_threshold 7
      #
      # 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
      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 1
      #
      # Clock description
      #
      productDescription ;;
      revisionData ;;
      manufacturerIdentity 00:00:00
      userDescription ;
      timeSource 0x20
  recommend:
  - profile: "grandmaster"
    priority: 4
    match:
    - nodeLabel: "node-role.kubernetes.io/$mcp"

注意

对于 E810 Westport Channel NIC，将 ts2phc.nmea_serialport 的值设置为 /dev/gnss0。

运行以下命令来创建 CR：

$ oc create -f grandmaster-clock-ptp-config-dual-nics.yaml

验证

检查 PtpConfig 配置集是否已应用到节点。

运行以下命令，获取 openshift-ptp 命名空间中的 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[509863.660]: [ts2phc.0.config] nmea delay: 347527248 ns
ts2phc[509863.660]: [ts2phc.0.config] ens2f0 extts index 0 at 1705516553.000000000 corr 0 src 1705516553.652499081 diff 0
ts2phc[509863.660]: [ts2phc.0.config] ens2f0 master offset          0 s2 freq      -0
I0117 18:35:16.000146 1633226 stats.go:57] state updated for ts2phc =s2
I0117 18:35:16.000163 1633226 event.go:417] dpll State s2, gnss State s2, tsphc state s2, gm state s2,
ts2phc[1705516516]:[ts2phc.0.config] ens2f0 nmea_status 1 offset 0 s2
GM[1705516516]:[ts2phc.0.config] ens2f0 T-GM-STATUS s2
ts2phc[509863.677]: [ts2phc.0.config] ens7f0 extts index 0 at 1705516553.000000010 corr -10 src 1705516553.652499081 diff 0
ts2phc[509863.677]: [ts2phc.0.config] ens7f0 master offset          0 s2 freq      -0
I0117 18:35:16.016597 1633226 stats.go:57] state updated for ts2phc =s2
phc2sys[509863.719]: [ptp4l.0.config] CLOCK_REALTIME phc offset        -6 s2 freq  +15441 delay    510
phc2sys[509863.782]: [ptp4l.0.config] CLOCK_REALTIME phc offset        -7 s2 freq  +15438 delay    502

其他资源

配置 PTP 快速事件通知发布程序

19.2.6.1. grandmaster clock PtpConfig 配置参考

以下参考信息描述了 PtpConfig 自定义资源(CR)的配置选项，将 linuxptp 服务(ptp4l、phc2sys、ts2phc)配置为 grandmaster 时钟。

表 19.1. PTP Grandmaster 时钟的 PtpConfig 配置选项

PtpConfig CR 字段	描述
`plugins`	指定一组 `.exec.cmdline` 选项来为 grandmaster 时钟操作配置 NIC。grandmaster 时钟配置需要禁用某些 PTP pin。插件机制允许 PTP Operator 进行自动硬件配置。对于 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`。将 `timeSource` 设置为 `0x20`，以便在从全局导航 Satellite 系统 (GNSS) 接收计时信号时。
`tx_timestamp_timeout`	指定丢弃数据前从发送方等待传输 (TX) 时间戳的最长时间。
`boundary_clock_jbod`	指定 JBOD 边界时钟时间延迟值。这个值用于更正网络时间设备之间传递的时间值。
`phc2sysOpts`	为 `phc2sys` 服务指定系统配置选项。如果此字段为空，PTP Operator 不会启动 `phc2sys` 服务。注意确保此处列出的网络接口配置为 grandmaster，并在 `ts2phcConf` 和 `ptp4lConf` 字段中根据需要引用。
`ptpSchedulingPolicy`	为 `ptp4l` 和 `phc2sys` 进程配置调度策略。默认值为 `SCHED_OTHER`。在支持 FIFO 调度的系统上使用 `SCHED_FIFO`。
`ptpSchedulingPriority`	当 `ptpSchedulingPolicy` 设置为 `SCHED_FIFO` 时，设置 1-65 的整数值来为 `ptp4l` 和 `phc2sys` 进程配置 FIFO 优先级。当 `ptpSchedulingPolicy` 设置为 `SCHED_OTHER` 时，不使用 `ptpSchedulingPriority` 字段。
`ptpClockThreshold`	可选。如果 `ptpClockThreshold` 小节不存在，则使用 `ptpClockThreshold` 字段的默认值。小节显示默认的 `ptpClockThreshold` 值。`ptpClockThreshold` 值配置 PTP master 时钟在触发 PTP 事件前的时长。`holdOverTimeout` 是在 PTP master clock 断开连接时，PTP 时钟事件状态更改为 `FREERUN` 前的时间值（以秒为单位）。`maxOffsetThreshold` 和 `minOffsetThreshold` 设置以纳秒为单位，它们与 `CLOCK_REALTIME` (`phc2sys`) 或 master 偏移 (`ptp4l`) 的值进行比较。当 `ptp4l` 或 `phc2sys` 偏移值超出这个范围时，PTP 时钟状态被设置为 `FREERUN`。当偏移值在这个范围内时，PTP 时钟状态被设置为 `LOCKED`。
`ts2phcConf`	设置 `ts2phc` 命令的配置。 `leapfile` 是 PTP Operator 容器镜像中当前 leap 秒定义文件的默认路径。 `ts2phc.nmea_serialport` 是连接到 NMEA GPS 时钟源的串行端口设备。配置后，GNSS 接收器可在 `/dev/gnss<id>` 上访问。如果主机有多个 GNSS 接收器，您可以通过枚举以下设备之一来查找正确的设备： `/sys/class/net/<eth_port>/device/gnss/` `/sys/class/gnss/gnss<id>/device/`
`ts2phcOpts`	为 `ts2phc` 命令设置选项。
`建议`	指定包括一个或多个 `recommend` 对象的数组，该数组定义了如何将`配置集`应用到节点的规则。
`.recommend.profile`	指定在 `profile` 部分中定义的 `.recommend.profile` 对象名称。
`.recommend.priority`	使用 `0` 到 `99` 之间的一个整数值指定 `priority`。大数值的优先级较低，因此优先级 `99` 低于优先级 `10`。如果节点可以根据 `match` 字段中定义的规则与多个配置集匹配，则优先级较高的配置集会应用到该节点。
`.recommend.match`	使用 `nodeLabel` 或 `nodeName` 值指定 `.recommend.match` 规则。
`.recommend.match.nodeLabel`	通过 `oc get nodes --show-labels` 命令，使用来自节点对象的 `node.Labels` 的 `key` 设置 `nodeLabel`。例如，`node-role.kubernetes.io/worker`。
`.recommend.match.nodeName`	使用 `oc get nodes` 命令，将 `nodeName` 设置为来自节点对象的 `node.Name` 值。例如，`compute-1.example.com`。

19.2.6.2. grandmaster 时钟类同步状态参考

下表描述了 PTP grandmaster 时钟(T-GM) gm.ClockClass 状态。时钟类状态根据其准确性和稳定性根据主要参考时间时钟(PRTC)或其他计时来源对 T-GM 时钟进行分类。

holdover 规格是 PTP 时钟可以维护同步的时间，而无需从主时间源接收更新。

表 19.2. T-GM 时钟类状态

时钟类状态	描述
`gm.ClockClass 6`	T-GM 时钟在 `LOCKED` 模式中连接到 PRTC。例如，PRTC 可以追溯到 GNSS 时间源。
`gm.ClockClass 7`	T-GM 时钟处于 `HOLDOVER` 模式，在既存的规格内。时钟源可能无法追溯到类别 1 频率源。
`gm.ClockClass 140`	T-GM 时钟处于 `HOLDOVER` 模式，但仍然可追溯到类别 1 频率源。
`gm.ClockClass 248`	T-GM 时钟处于 `FREERUN` 模式。

19.2.6.3. Intel Westport Channel E810 硬件配置参考

使用这些信息了解如何使用 Intel E810-XXVDA4T 硬件插件将 E810 网络接口配置为 PTP grandmaster 时钟。硬件固定配置决定了网络接口如何与系统中的其他组件和设备进行交互。E810-XXVDA4T NIC 有四个连接器用于外部 1PPS 信号：SMA1, SMA2, U.FL1, 和 U.FL2。

表 19.3. Intel E810 NIC 硬件连接器配置

硬件固定	推荐的设置	描述
`U.FL1`	`0 1`	禁用 `U.FL1` 连接器输入。`U.FL1` 连接器是仅用于输出的。
`U.FL2`	`0 2`	禁用 `U.FL2` 连接器输出。`U.FL2` 连接器是仅限输入的。
`SMA1`	`0 1`	禁用 `SMA1` 连接器输入。`SMA1` 连接器是双向的。
`SMA2`	`0 2`	禁用 `SMA2` 连接器输出。`SMA2` 连接器是双向的。

注意

SMA1 和 U.FL1 连接器共享通道。SMA2 和 U.FL2 连接器共享通道二。

设置 spec.profile.plugins.e810.ublxCmds 参数，以在 PtpConfig 自定义资源(CR) 中配置 GNSS 时钟。这些 ublxCmds 小节各自对应于使用 ubxtool 命令应用到主机 NIC 的配置。例如：

ublxCmds:
  - args: #ubxtool -P 29.20 -z CFG-HW-ANT_CFG_VOLTCTRL,1
      - "-P"
      - "29.20"
      - "-z"
      - "CFG-HW-ANT_CFG_VOLTCTRL,1"
    reportOutput: false

下表描述了等效的 ubxtool 命令：

表 19.4. Intel E810 ublxCmds 配置

ubxtool 命令	描述
`ubxtool -P 29.20 -z CFG-HW-ANT_CFG_VOLTCTRL,1`	启用 atenna voltage 控制。启用在 `UBX-MON-RF` 和 `UBX-INF-NOTICE` 日志消息中报告 antenna 状态。
`ubxtool -P 29.20 -e GPS`	启用 atenna 接收 GPS 信号。
`ubxtool -P 29.20 -d Galileo`	配置 atenna 以接收来自 Galileo GPS satellite 的信号。
`ubxtool -P 29.20 -d GLONASS`	禁用 atenna 从 GLONASS GPS satellite 接收信号。
`ubxtool -P 29.20 -d BeiDou`	禁用 atenna 从 BeiDou GPS satellite 接收信号。
`ubxtool -P 29.20 -d SBAS`	禁用 atenna 从 SBAS GPS satellite 接收信号。
`ubxtool -P 29.20 -t -w 5 -v 1 -e SURVEYIN,600,50000`	配置 GNSS 接收器调查进程，以提高其初始位置估算。这可能需要 24 小时才能获得最佳结果。
`ubxtool -P 29.20 -p MON-HW`	对硬件运行单个自动扫描，并报告 NIC 状态和配置设置。

E810 插件实现以下接口：

表 19.5. E810 插件接口

Interface	描述
`OnPTPConfigChangeE810`	每当您更新 `PtpConfig` CR 时运行。此函数解析插件选项，并根据配置数据将所需的配置应用到网络设备固定。
`AfterRunPTPCommandE810`	启动 PTP 进程并运行 `gpspipe` PTP 命令后运行。函数处理插件选项并运行 `ubxtool` 命令，将输出存储在特定于插件的数据中。
`PopulateHwConfigE810`	根据 `PtpConfig` CR 中特定于硬件的数据填充 `NodePtpDevice` CR。

E810 插件有以下 struct 和变量：

表 19.6. E810 插件结构和变量

Struct	描述
`E810Opts`	代表 E810 插件的选项，包括布尔值标志和网络设备固定映射。
`E810UblxCmds`	代表带有布尔值标志和命令参数字符串片段的 `ubxtool` 命令的配置。
`E810PluginData`	包含插件执行期间使用的特定于插件的数据。

19.2.6.4. 双 E810 Westport Channel NIC 配置参考

使用这些信息了解如何使用 Intel E810-XXVDA4T 硬件插件将 E810 网络接口配置为 PTP grandmaster 时钟(T-GM)。

在配置双 NIC 集群主机前，您必须使用 1PPS faceplace 连接将两个 NIC 与 SMA1 电缆连接。

当您配置双 NIC T-GM 时，您需要补偿使用 SMA1 连接端口连接 NIC 时发生的 1PPS 信号延迟。电缆长度、基线温度、组件和制造容错等各种因素可能会影响信号延迟。要满足延迟要求，您必须计算用于偏移信号延迟的特定值。

表 19.7. E810 双 NIC T-GM PtpConfig CR 参考

PtpConfig 字段	描述
`spec.profile.plugins.e810.pins`	使用 PTP Operator E810 硬件插件配置 E810 硬件固定。固定 `2 1` 为 NIC 1 上的 `SMA1` 启用 `1PPS OUT` 连接。固定 `1 1` 为 NIC 2 上的 `SMA1` 启用 `1PPS IN` 连接。
`spec.profile.ts2phcConf`	使用 `ts2phcConf` 字段为 NIC 1 和 NIC 2 配置参数。为 NIC 2 设置 `ts2phc.master 0`。这会配置来自 1PPS 输入的 NIC 2 的计时源，而不是 GNSS。为 NIC 2 配置 `ts2phc.extts_correction` 值，以补偿您所使用的特定 SMA 电缆和电缆长度的延迟。您配置的值取决于您的特定测量和 SMA1 电缆长度。
`spec.profile.ptp4lConf`	将 `boundary_clock_jbod` 的值设置为 1，以启用对多个 NIC 的支持。

19.2.7. 将 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，然后在 boundaries-clock-ptp-config.yaml 文件中保存 YAML。

PTP 边界时钟配置示例

apiVersion: ptp.openshift.io/v1
kind: PtpConfig
metadata:
  name: boundary-clock
  namespace: openshift-ptp
  annotations: {}
spec:
  profile:
    - name: boundary-clock
      ptp4lOpts: "-2"
      phc2sysOpts: "-a -r -n 24"
      ptpSchedulingPolicy: SCHED_FIFO
      ptpSchedulingPriority: 10
      ptpSettings:
        logReduce: "true"
      ptp4lConf: |
        # The interface name is hardware-specific
        [$iface_slave]
        masterOnly 0
        [$iface_master_1]
        masterOnly 1
        [$iface_master_2]
        masterOnly 1
        [$iface_master_3]
        masterOnly 1
        [global]
        #
        # Default Data Set
        #
        twoStepFlag 1
        slaveOnly 0
        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 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
        clock_class_threshold 135
        #
        # 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/$mcp"

表 19.8. PTP 边界时钟 CR 配置选项

CR 字段	描述
`name`	`PtpConfig` CR 的名称。
`配置集`	指定包括一个或多个 `profile` 的数组。
`name`	指定唯一标识配置集对象的配置集对象的名称。
`ptp4lOpts`	为 `ptp4l` 服务指定系统配置选项。该选项不应包含网络接口名称 `-i <interface>` 和服务配置文件 `-f /etc/ptp4l.conf`，因为网络接口名称和服务配置文件会被自动附加。
`ptp4lConf`	指定启动 `ptp4l` 作为边界时钟所需的配置。例如，`ens1f0` 同步来自 Pumaster 时钟，`ens1f3` 同步连接的设备。
`<interface_1>`	接收同步时钟的接口。
`<interface_2>`	发送同步时钟的接口。
`tx_timestamp_timeout`	对于 Intel Columbiaville 800 系列 NIC，将 `tx_timestamp_timeout` 设置为 `50`。
`boundary_clock_jbod`	对于 Intel Columbiaville 800 系列 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`	当 `ptpSchedulingPolicy` 设置为 `SCHED_FIFO` 时，用于为 `ptp4l` 和 `phc2sys` 进程设置 FIFO 优先级的整数值（1 到 65）。当 `ptpSchedulingPolicy` 设置为 `SCHED_OTHER` 时，不使用 `ptpSchedulingPriority` 字段。
`ptpClockThreshold`	可选。如果没有 `ptpClockThreshold`，用于 `ptpClockThreshold` 字段的默认值。`ptpClockThreshold` 配置在触发 PTP 时间前，PTP master 时钟已断开连接的时长。`holdOverTimeout` 是在 PTP master clock 断开连接时，PTP 时钟事件状态更改为 `FREERUN` 前的时间值（以秒为单位）。`maxOffsetThreshold` 和 `minOffsetThreshold` 设置以纳秒为单位，它们与 `CLOCK_REALTIME` (`phc2sys`) 或 master 偏移 (`ptp4l`) 的值进行比较。当 `ptp4l` 或 `phc2sys` 偏移值超出这个范围时，PTP 时钟状态被设置为 `FREERUN`。当偏移值在这个范围内时，PTP 时钟状态被设置为 `LOCKED`。
`建议`	指定包括一个或多个 `recommend` 对象的数组，该数组定义了如何将`配置集`应用到节点的规则。
`.recommend.profile`	指定在 `profile` 部分定义的 `.recommend.profile` 对象名称。
`.recommend.priority`	使用 `0` 到 `99` 之间的一个整数值指定 `priority`。大数值的优先级较低，因此优先级 `99` 低于优先级 `10`。如果节点可以根据 `match` 字段中定义的规则与多个配置集匹配，则优先级较高的配置集会应用到该节点。
`.recommend.match`	使用 `nodeLabel` 或 `nodeName` 值指定 `.recommend.match` 规则。
`.recommend.match.nodeLabel`	通过 `oc get nodes --show-labels` 命令，使用来自节点对象的 `node.Labels` 的 `key` 设置 `nodeLabel`。例如，`node-role.kubernetes.io/worker`。
`.recommend.match.nodeName`	使用 `oc get nodes` 命令，将 `nodeName` 设置为来自节点对象的 `node.Name` 值。例如，`compute-1.example.com`。

运行以下命令来创建 CR：

$ oc create -f boundary-clock-ptp-config.yaml

验证

检查 PtpConfig 配置集是否已应用到节点。

运行以下命令，获取 openshift-ptp 命名空间中的 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 -n 24
I1115 09:41:17.117626 4143292 daemon.go:116] ------------------------------------

其他资源

19.2.7.1. 将 linuxptp 服务配置为双 NIC 硬件边界时钟

重要

使用配置为边界时钟的双 NIC 的精确时间协议(PTP)硬件只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议（SLA）支持，且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能，并有机会在开发阶段提供反馈意见。

有关红帽技术预览功能支持范围的更多信息，请参阅技术预览功能支持范围。

您可以通过为每个 NIC 创建一个 PtpConfig 自定义资源(CR)对象，将 linuxptp 服务（ptp4l、phc2sys）配置为双 NIC 硬件的边界时钟。

双 NIC 硬件允许您将每个 NIC 连接到相同的上游领导时钟，并将每个 NIC 的 ptp4l 实例连接给下游时钟。

先决条件

安装 OpenShift CLI（oc）。
以具有 cluster-admin 特权的用户身份登录。
安装 PTP Operator。

流程

创建两个单独的 PtpConfig CR，每个 NIC 使用 "Configuring linuxptp 服务作为边界时钟"中的引用 CR，作为每个 CR 的基础。例如：
1. 创建 boundary-clock-ptp-config-nic1.yaml，为 phc2sysOpts 指定值：
```
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 从 grandmaster 时钟同步，ens5f1 同步连接的设备。
  2
  所需的 phc2sysOpts 值。-m 将消息输出到 stdout。linuxptp-daemon DaemonSet 解析日志并生成 Prometheus 指标。
2. 创建 boundary-clock-ptp-config-nic2.yaml，删除 phc2sysOpts 字段，以完全禁用第二个 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
  在第二个 NIC上指定所需的接口来启动 ptp4l 作为一个边境时钟。
  注意
  您必须从第二个 PtpConfig CR 中完全删除 phc2sysOpts 字段，以禁用第二个 NIC 上的 phc2sys 服务。
运行以下命令来创建双 NIC PtpConfig CR：
1. 创建 CR 来为第一个 NIC 配置 PTP：
```
$ oc create -f boundary-clock-ptp-config-nic1.yaml
```
2. 创建 CR 来为第二个 NIC 配置 PTP：
```
$ oc create -f boundary-clock-ptp-config-nic2.yaml
```

验证

检查 PTP Operator 是否为两个 NIC 应用了 PtpConfig CR。检查与安装了双 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.2.8. 将 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，然后在 ordinary-clock-ptp-config.yaml 文件中保存 YAML。

PTP 普通时钟配置示例

apiVersion: ptp.openshift.io/v1
kind: PtpConfig
metadata:
  name: ordinary-clock
  namespace: openshift-ptp
  annotations: {}
spec:
  profile:
    - name: ordinary-clock
      # The interface name is hardware-specific
      interface: $interface
      ptp4lOpts: "-2 -s"
      phc2sysOpts: "-a -r -n 24"
      ptpSchedulingPolicy: SCHED_FIFO
      ptpSchedulingPriority: 10
      ptpSettings:
        logReduce: "true"
      ptp4lConf: |
        [global]
        #
        # Default Data Set
        #
        twoStepFlag 1
        slaveOnly 1
        priority1 128
        priority2 128
        domainNumber 24
        #utc_offset 37
        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
        clock_class_threshold 7
        #
        # 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/$mcp"

表 19.9. PTP 普通时钟 CR 配置选项

CR 字段	描述
`name`	`PtpConfig` CR 的名称。
`配置集`	指定包括一个或多个 `profile` 的数组。每个配置集的名称都需要是唯一的。
`interface`	指定 `ptp4l` 服务要使用的网络接口，如 `ens787f1`。
`ptp4lOpts`	为 `ptp4l` 服务指定系统配置选项，例如 `-2` 来选择 IEEE 802.3 网络传输。该选项不应包含网络接口名称 `-i <interface>` 和服务配置文件 `-f /etc/ptp4l.conf`，因为网络接口名称和服务配置文件会被自动附加。附加 `--summary_interval -4` 来对此接口使用 PTP 快速事件。
`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 系列 NIC，将 `tx_timestamp_timeout` 设置为 `50`。
`boundary_clock_jbod`	对于 Intel Columbiaville 800 系列 NIC，将 `boundary_clock_jbod` 设置为 `0。`
`ptpSchedulingPolicy`	`ptp4l` 和 `phc2sys` 进程的调度策略。默认值为 `SCHED_OTHER`。在支持 FIFO 调度的系统上使用 `SCHED_FIFO`。
`ptpSchedulingPriority`	当 `ptpSchedulingPolicy` 设置为 `SCHED_FIFO` 时，用于为 `ptp4l` 和 `phc2sys` 进程设置 FIFO 优先级的整数值（1 到 65）。当 `ptpSchedulingPolicy` 设置为 `SCHED_OTHER` 时，不使用 `ptpSchedulingPriority` 字段。
`ptpClockThreshold`	可选。如果没有 `ptpClockThreshold`，用于 `ptpClockThreshold` 字段的默认值。`ptpClockThreshold` 配置在触发 PTP 时间前，PTP master 时钟已断开连接的时长。`holdOverTimeout` 是在 PTP master clock 断开连接时，PTP 时钟事件状态更改为 `FREERUN` 前的时间值（以秒为单位）。`maxOffsetThreshold` 和 `minOffsetThreshold` 设置以纳秒为单位，它们与 `CLOCK_REALTIME` (`phc2sys`) 或 master 偏移 (`ptp4l`) 的值进行比较。当 `ptp4l` 或 `phc2sys` 偏移值超出这个范围时，PTP 时钟状态被设置为 `FREERUN`。当偏移值在这个范围内时，PTP 时钟状态被设置为 `LOCKED`。
`建议`	指定包括一个或多个 `recommend` 对象的数组，该数组定义了如何将`配置集`应用到节点的规则。
`.recommend.profile`	指定在 `profile` 部分定义的 `.recommend.profile` 对象名称。
`.recommend.priority`	对于普通时钟，将 `.recommend.priority` 设置为 `0。`
`.recommend.match`	使用 `nodeLabel` 或 `nodeName` 值指定 `.recommend.match` 规则。
`.recommend.match.nodeLabel`	通过 `oc get nodes --show-labels` 命令，使用来自节点对象的 `node.Labels` 的 `key` 设置 `nodeLabel`。例如，`node-role.kubernetes.io/worker`。
`.recommend.match.nodeName`	使用 `oc get nodes` 命令，将 `nodeName` 设置为来自节点对象的 `node.Name` 值。例如，`compute-1.example.com`。

运行以下命令来创建 PtpConfig CR：

$ oc create -f ordinary-clock-ptp-config.yaml

验证

检查 PtpConfig 配置集是否已应用到节点。

运行以下命令，获取 openshift-ptp 命名空间中的 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: 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] ------------------------------------

其他资源

19.2.8.1. Intel Columbiaville E800 series NIC 作为 PTP 常规时钟参考

下表描述了您必须对引用 PTP 配置所做的更改，以使用 Intel Columbiaville E800 系列 NIC 作为普通时钟。在应用到集群的 PtpConfig 自定义资源(CR)中进行更改。

表 19.10. 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，请参阅将 linuxptp 服务配置为普通时钟。

19.2.9. 为 PTP 硬件配置 FIFO 优先级调度

在需要低延迟性能的电信或其他部署类型中，PTP 守护进程线程在受限的 CPU 占用空间以及剩余的基础架构组件一起运行。默认情况下，PTP 线程使用 SCHED_OTHER 策略运行。在高负载下，这些线程可能没有获得无错操作所需的调度延迟。

要缓解潜在的调度延迟错误，您可以将 PTP Operator linuxptp 服务配置为允许线程使用 SCHED_FIFO 策略运行。如果为 PtpConfig CR 设置了 SCHED_FIFO，则 ptp4l 和 phc2sys 将在 chrt 的父容器中运行，且由 PtpConfig CR 的 ptpSchedulingPriority 字段设置。

注意

设置 ptpSchedulingPolicy 是可选的，只有在遇到延迟错误时才需要。

流程

编辑 PtpConfig CR 配置集：
```
$ oc edit PtpConfig -n openshift-ptp
```
更改 ptpSchedulingPolicy 和 ptpSchedulingPriority 字段：
```
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
必需。设置整数值 1-65，用于为 ptp4l 和 phc2sys 进程配置 FIFO 优先级。
保存并退出，以将更改应用到 PtpConfig CR。

验证

获取 linuxptp-daemon pod 的名称以及应用 PtpConfig CR 的对应节点：

$ 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 进程是否使用更新的 chrt FIFO 运行：

$ 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.2.10. 为 linuxptp 服务配置日志过滤

linuxptp 守护进程生成可用于调试目的的日志。在具有有限存储容量的电信或其他部署类型中，这些日志可以添加到存储要求中。

要减少数量日志消息，您可以配置 PtpConfig 自定义资源 (CR) 来排除报告 master offset 值的日志消息。master offset 日志消息以纳秒为单位报告当前节点时钟和 master 时钟之间的区别。

先决条件

安装 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，使其包含 master 偏移消息。

保存并退出，以将更改应用到 PtpConfig CR。

验证

获取 linuxptp-daemon pod 的名称以及应用 PtpConfig CR 的对应节点：

$ 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

运行以下命令，验证 master 偏移信息是否不包括在日志中：
```
$ 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 实例。

19.2.11. 常见 PTP Operator 故障排除

通过执行以下步骤排除 PTP Operator 中的常见问题。

先决条件

安装 OpenShift Container Platform CLI（oc）。
以具有 cluster-admin 特权的用户身份登录。
使用支持 PTP 的主机在裸机集群中安装 PTP Operator。

流程

检查集群中为配置的节点成功部署了 Operator 和操作对象。

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

输出示例

NAME                            READY   STATUS    RESTARTS   AGE     IP            NODE
linuxptp-daemon-lmvgn           3/3     Running   0          4d17h   10.1.196.24   compute-0.example.com
linuxptp-daemon-qhfg7           3/3     Running   0          4d17h   10.1.196.25   compute-1.example.com
ptp-operator-6b8dcbf7f4-zndk7   1/1     Running   0          5d7h    10.129.0.61   control-plane-1.example.com

注意

当启用 PTP fast 事件总线时，就绪的 linuxptp-daemon pod 的数量是 3/3。如果没有启用 PTP fast 事件总线，则会显示 2/2。

检查集群中是否已找到支持的硬件。

$ oc -n openshift-ptp get nodeptpdevices.ptp.openshift.io

输出示例

NAME                                  AGE
control-plane-0.example.com           10d
control-plane-1.example.com           10d
compute-0.example.com                 10d
compute-1.example.com                 10d
compute-2.example.com                 10d

检查节点的可用 PTP 网络接口：

$ oc -n openshift-ptp get nodeptpdevices.ptp.openshift.io <node_name> -o yaml

其中：

<node_name>

指定您要查询的节点，例如 compute-0.example.com。

输出示例

apiVersion: ptp.openshift.io/v1
kind: NodePtpDevice
metadata:
  creationTimestamp: "2021-09-14T16:52:33Z"
  generation: 1
  name: compute-0.example.com
  namespace: openshift-ptp
  resourceVersion: "177400"
  uid: 30413db0-4d8d-46da-9bef-737bacd548fd
spec: {}
status:
  devices:
  - name: eno1
  - name: eno2
  - name: eno3
  - name: eno4
  - name: enp5s0f0
  - name: enp5s0f1

通过访问对应节点的 linuxptp-daemon pod，检查 PTP 接口是否已与主时钟成功同步。

运行以下命令来获取 linuxptp-daemon pod 的名称以及您要排除故障的对应节点：

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

输出示例

NAME                            READY   STATUS    RESTARTS   AGE     IP            NODE
linuxptp-daemon-lmvgn           3/3     Running   0          4d17h   10.1.196.24   compute-0.example.com
linuxptp-daemon-qhfg7           3/3     Running   0          4d17h   10.1.196.25   compute-1.example.com
ptp-operator-6b8dcbf7f4-zndk7   1/1     Running   0          5d7h    10.129.0.61   control-plane-1.example.com

在远程 shell 到所需的 linuxptp-daemon 容器：
```
$ oc rsh -n openshift-ptp -c linuxptp-daemon-container <linux_daemon_container>
```
其中：
<linux_daemon_container>
您要诊断的容器，如 linuxptp-daemon-lmvgn。

在与 linuxptp-daemon 容器的远程 shell 连接中，使用 PTP Management Client (pmc) 工具诊断网络接口。运行以下 pmc 命令，以检查 PTP 设备的同步状态，如 ptp4l。

# pmc -u -f /var/run/ptp4l.0.config -b 0 'GET PORT_DATA_SET'

当节点成功同步到主时钟时的输出示例

sending: GET PORT_DATA_SET
    40a6b7.fffe.166ef0-1 seq 0 RESPONSE MANAGEMENT PORT_DATA_SET
        portIdentity            40a6b7.fffe.166ef0-1
        portState               SLAVE
        logMinDelayReqInterval  -4
        peerMeanPathDelay       0
        logAnnounceInterval     -3
        announceReceiptTimeout  3
        logSyncInterval         -4
        delayMechanism          1
        logMinPdelayReqInterval -4
        versionNumber           2

对于 GNSS-sourced grandmaster 时钟，运行以下命令来验证 in-tree NIC ice 驱动程序是否正确，例如：

$ oc rsh -n openshift-ptp -c linuxptp-daemon-container linuxptp-daemon-74m2g ethtool -i ens7f0

输出示例

driver: ice
version: 5.14.0-356.bz2232515.el9.x86_64
firmware-version: 4.20 0x8001778b 1.3346.0

对于 GNSS-sourced grandmaster 时钟，请验证 linuxptp-daemon 容器是否从 GNSS antenna 接收信号。如果容器没有收到 GNSS 信号，则不会填充 /dev/gnss0 文件。要验证，请运行以下命令：

$ oc rsh -n openshift-ptp -c linuxptp-daemon-container linuxptp-daemon-jnz6r cat /dev/gnss0

输出示例

$GNRMC,125223.00,A,4233.24463,N,07126.64561,W,0.000,,300823,,,A,V*0A
$GNVTG,,T,,M,0.000,N,0.000,K,A*3D
$GNGGA,125223.00,4233.24463,N,07126.64561,W,1,12,99.99,98.6,M,-33.1,M,,*7E
$GNGSA,A,3,25,17,19,11,12,06,05,04,09,20,,,99.99,99.99,99.99,1*37
$GPGSV,3,1,10,04,12,039,41,05,31,222,46,06,50,064,48,09,28,064,42,1*62

19.2.12. 收集 PTP Operator 数据

您可以使用 oc adm must-gather 命令收集有关集群的信息，包括与 PTP Operator 关联的功能和对象。

先决条件

您可以使用具有 cluster-admin 角色的用户访问集群。
已安装 OpenShift CLI(oc)。
已安装 PTP Operator。

流程

要使用 must-gather 来收集 PTP Operator 数据，您必须指定 PTP Operator must-gather 镜像。
```
$ oc adm must-gather --image=registry.redhat.io/openshift4/ptp-must-gather-rhel8:v4.14
```

Select Your Language

19.2. 配置 PTP 设备

19.2.1. 使用 CLI 安装 PTP Operator

19.2.2. 使用 Web 控制台安装 PTP Operator

19.2.3. 在集群中发现具有 PTP 功能网络设备

19.2.4. 在 PTP Operator 中使用特定于硬件的 NIC 功能

19.2.5. 将 linuxptp 服务配置为 grandmaster 时钟

19.2.6. 将 linuxptp 服务配置为双 E810 Westport Channel NIC 的 grandmaster 时钟

19.2.6.1. grandmaster clock PtpConfig 配置参考

19.2.6.2. grandmaster 时钟类同步状态参考

19.2.6.3. Intel Westport Channel E810 硬件配置参考

19.2.6.4. 双 E810 Westport Channel NIC 配置参考

19.2.7. 将 linuxptp 服务配置为边界时钟

19.2.7.1. 将 linuxptp 服务配置为双 NIC 硬件边界时钟

19.2.8. 将 linuxptp 服务配置为常规时钟

19.2.8.1. Intel Columbiaville E800 series NIC 作为 PTP 常规时钟参考

19.2.9. 为 PTP 硬件配置 FIFO 优先级调度

19.2.10. 为 linuxptp 服务配置日志过滤

19.2.11. 常见 PTP Operator 故障排除

19.2.12. 收集 PTP Operator 数据

Quick Links

Help

Site Info

Related Sites

About

Red Hat legal and privacy links

Red Hat legal and privacy links

Language and Page Formatting Options

19.2. 配置 PTP 设备

19.2.1. 使用 CLI 安装 PTP Operator

19.2.2. 使用 Web 控制台安装 PTP Operator

19.2.3. 在集群中发现具有 PTP 功能网络设备

19.2.4. 在 PTP Operator 中使用特定于硬件的 NIC 功能

19.2.5. 将 linuxptp 服务配置为 grandmaster 时钟

19.2.6. 将 linuxptp 服务配置为双 E810 Westport Channel NIC 的 grandmaster 时钟

19.2.6.1. grandmaster clock PtpConfig 配置参考

19.2.6.2. grandmaster 时钟类同步状态参考

19.2.6.3. Intel Westport Channel E810 硬件配置参考

19.2.6.4. 双 E810 Westport Channel NIC 配置参考

19.2.7. 将 linuxptp 服务配置为边界时钟

19.2.7.1. 将 linuxptp 服务配置为双 NIC 硬件边界时钟

19.2.8. 将 linuxptp 服务配置为常规时钟

19.2.8.1. Intel Columbiaville E800 series NIC 作为 PTP 常规时钟参考

19.2.9. 为 PTP 硬件配置 FIFO 优先级调度

19.2.10. 为 linuxptp 服务配置日志过滤

19.2.11. 常见 PTP Operator 故障排除

19.2.12. 收集 PTP Operator 数据

Quick Links

Help

Site Info

Related Sites

Systems Status

About

Red Hat legal and privacy links

Red Hat legal and privacy links