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

PTP Operator 将 PtpConfig.ptp.openshift.io 自定义资源定义 (CRD) 添加至 OpenShift Container Platform。您可以通过创建 PtpConfig 自定义资源 (CR) 对象来配置 linuxptp 服务（ptp4l、phc2sys）。

先决条件

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

流程

创建以下 PtpConfig CR，然后在 boundaries-clock-ptp-config.yaml 文件中保存 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: 指定包括一个或多个 profile 的数组。
3: 指定唯一标识配置集对象的配置集对象的名称。
4: 对于边界时钟，此字段应保持为空。
5: 为 ptp4l 服务指定系统配置选项，例如 -2。该选项不应包含网络接口名称 -i <interface> 和服务配置文件 -f /etc/ptp4l.conf，因为网络接口名称和服务配置文件会被自动附加。
6: 指定启动 ptp4l 作为边界时钟所需的配置。例如，ens1f0 同步来自 Pumaster 时钟，ens1f3 同步连接的设备。
7: 要从中同步的接口名称。
8: 用于同步连接到接口的设备的接口。
9: 对于 Intel Columbiaville 800 系列 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: 当 ptpSchedulingPolicy 设置为 SCHED_FIFO 时，用于为 ptp4l 和 phc2sys 进程设置 FIFO 优先级的整数值（1 到 65）。当 ptpSchedulingPolicy 设置为 SCHED_OTHER 时，不使用 ptpSchedulingPriority 字段。
13: 指定包括一个或多个 recommend 对象的数组，该数组定义了如何将配置集应用到节点的规则。
14: 指定 profile 部分中定义的 profile 对象名称。
15: 使用 0 到 99 之间的一个整数值指定 priority。大数值的优先级较低，因此优先级 99 低于优先级 10。如果节点可以根据 match 字段中定义的规则与多个配置集匹配，则优先级较高的配置集会应用到该节点。
16: 使用 nodeLabel 或 nodeName 指定 match 规则。
17: 指定 nodeLabel，它带有来自节点对象的 node.Labels 的 key（可以通过运行 oc get nodes --show-labels 命令找出这些信息）。
18: 指定 nodeName，它带有来自节点对象的 node.Name（可以通过运行 oc get nodes 命令找到这些信息）。

运行以下命令来创建 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
I1115 09:41:17.117626 4143292 daemon.go:116] ------------------------------------

其他资源

如需有关 PTP 硬件上的 FIFO 优先级调度的更多信息，请参阅为 PTP 硬件配置 FIFO 优先级调度。

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

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Red Hat legal and privacy links

Red Hat legal and privacy links