Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

7.2. PTP 장치 구성

PTP Operator는 NodePtpDevice.ptp.openshift.io CRD(custom resource definition)를 OpenShift Container Platform에 추가합니다.

PTP 운영자가 설치되면 각 노드에서 PTP(Precision Time Protocol) 지원 네트워크 장치를 클러스터에서 검색합니다. Operator는 호환 가능한 PTP 장치를 제공하는 각 노드에 대해 NodePtpDevice CR(사용자 정의 리소스)을 생성하고 업데이트합니다.

PTP 기능이 내장된 네트워크 인터페이스 컨트롤러(NIC) 하드웨어에는 때때로 장치별 구성이 필요합니다. PtpConfig 사용자 정의 리소스(CR)에서 플러그인을 구성하여 PTP 운영자를 통해 지원되는 하드웨어에 대한 하드웨어별 NIC 기능을 사용할 수 있습니다. linuxptp-daemon 서비스는 플러그인 스탠자에 지정된 매개변수를 사용하여 특정 하드웨어 구성에 따라 linuxptp 프로세스, ptp4l 및 phc2sys를 시작합니다.

중요

OpenShift Container Platform 4.19에서는 Intel E810 NIC가 PtpConfig 플러그인을 통해 지원됩니다.

7.2.1. CLI를 사용하여 PTP Operator 설치
링크 복사

클러스터 관리자는 CLI를 사용하여 Operator를 설치할 수 있습니다.

사전 요구 사항

  • PTP를 지원하는 하드웨어가 있는 노드로 베어 메탈 하드웨어에 설치된 클러스터
  • OpenShift CLI(oc)를 설치합니다.
  • cluster-admin 권한이 있는 사용자로 로그인합니다.

프로세스

  1. PTP 운영자에 대한 네임스페이스를 만듭니다.

    1. 다음 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"
      Copy to Clipboard Toggle word wrap

    2. Namespace CR을 생성합니다. 

      $ oc create -f ptp-namespace.yaml
      Copy to Clipboard Toggle word wrap

  2. PTP 운영자에 대한 운영자 그룹을 만듭니다.

    1. 다음 YAML을 ptp-operatorgroup.yaml 파일에 저장합니다. 

      apiVersion: operators.coreos.com/v1
kind: OperatorGroup
metadata:
  name: ptp-operators
  namespace: openshift-ptp
spec:
  targetNamespaces:
  - openshift-ptp
      Copy to Clipboard Toggle word wrap

    2. OperatorGroup CR을 생성합니다. 

      $ oc create -f ptp-operatorgroup.yaml
      Copy to Clipboard Toggle word wrap

  3. PTP Operator에 등록합니다.

    1. 다음 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
      Copy to Clipboard Toggle word wrap

    2. Subscription CR을 생성합니다. 

      $ oc create -f ptp-sub.yaml
      Copy to Clipboard Toggle word wrap

  4. Operator가 설치되었는지 확인하려면 다음 명령을 입력합니다. 

    $ oc get csv -n openshift-ptp -o custom-columns=Name:.metadata.name,Phase:.status.phase
    Copy to Clipboard Toggle word wrap

    출력 예

    Name                         Phase
4.19.0-202301261535          Succeeded
    Copy to Clipboard Toggle word wrap

7.2.2. 웹 콘솔을 사용하여 PTP Operator 설치
링크 복사

클러스터 관리자는 웹 콘솔을 사용하여 PTP Operator를 설치할 수 있습니다.

참고

이전 섹션에서 언급한 것처럼 네임스페이스 및 Operator group을 생성해야 합니다.

프로세스

  1. OpenShift Container Platform 웹 콘솔을 사용하여 PTP Operator를 설치합니다.

    1. OpenShift Container Platform 웹 콘솔에서 Operator OperatorHub를 클릭합니다.
    2. 사용 가능한 Operator 목록에서 PTP Operator를 선택한 다음 설치를 클릭합니다.
    3. Operator 설치 페이지의 클러스터의 특정 네임스페이스에서 openshift-ptp를 선택합니다. 그런 다음, 설치를 클릭합니다.

  2. 선택 사항: PTP Operator가 설치되었는지 확인합니다.

    1. Operator 설치된 Operator 페이지로 전환합니다.

    2. PTP Operator가 openshift-ptp 프로젝트에 InstallSucceeded 상태로 나열되어 있는지 확인합니다.

      참고

      설치 중에 Operator는 실패 상태를 표시할 수 있습니다. 나중에 InstallSucceeded 메시지와 함께 설치에 성공하면 이 실패 메시지를 무시할 수 있습니다.

      Operator가 설치된 것으로 나타나지 않으면 다음과 같이 추가 문제 해결을 수행합니다.

      • Operator 설치된 Operator 페이지로 이동하고 Operator 서브스크립션 및 설치 계획 탭의 상태에 장애나 오류가 있는지 검사합니다.
      • Workloads Pod 페이지로 이동하여 openshift-ptp 프로젝트에서 Pod 로그를 확인합니다.

7.2.3. 클러스터에서 PTP 지원 네트워크 장치 검색
링크 복사

클러스터에 있는 PTP 지원 네트워크 장치를 식별하여 구성할 수 있습니다.

전제 조건

  • PTP Operator를 설치했습니다.

프로세스

  • 클러스터에서 PTP 가능 네트워크 장치의 전체 목록을 반환하려면 다음 명령을 실행합니다. 

    $ oc get NodePtpDevice -n openshift-ptp -o yaml
    Copy to Clipboard Toggle word wrap

    출력 예

    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
...
    Copy to Clipboard Toggle word wrap

    1
    name 매개변수의 값은 노드 이름과 같습니다.
    2
    장치 컬렉션에는 PTP 운영자가 노드에 대해 검색한 PTP 지원 장치 목록이 포함되어 있습니다.

7.2.4. linuxptp 서비스를 그랜드마스터 시계로 구성
링크 복사

PtpConfig 사용자 정의 리소스(CR)를 생성하여 호스트 NIC를 구성함으로써 linuxptp 서비스( ptp4l , phc2sys , ts2phc )를 그랜드마스터 클럭(T-GM)으로 구성할 수 있습니다.

ts2phc 유틸리티를 사용하면 시스템 클록을 PTP 그랜드마스터 클록과 동기화하여 노드가 다운스트림 PTP 일반 클록 및 경계 클록으로 정밀 클록 신호를 스트리밍할 수 있습니다.

참고

다음 예제 PtpConfig CR을 기반으로 Intel Westport Channel E810-XXVDA4T 네트워크 인터페이스에 대한 T-GM으로 linuxptp 서비스를 구성합니다.

PTP 빠른 이벤트를 구성하려면 ptp4lOpts , ptp4lConf 및 ptpClockThreshold 에 적절한 값을 설정합니다. ptpClockThreshold는 이벤트가 활성화된 경우에만 사용됩니다. 자세한 내용은 "PTP 빠른 이벤트 알림 게시자 구성"을 참조하세요.

사전 요구 사항

  • 프로덕션 환경에서 T-GM 클록을 사용하려면 베어 메탈 클러스터 호스트에 Intel E810 Westport 채널 NIC를 설치합니다.
  • OpenShift CLI(oc)를 설치합니다.
  • cluster-admin 권한이 있는 사용자로 로그인합니다.
  • PTP Operator를 설치합니다.

프로세스

  1. PtpConfig CR을 생성합니다. 예를 들면 다음과 같습니다.

    1. 요구 사항에 따라 배포에 다음 T-GM 구성 중 하나를 사용하세요. grandmaster-clock-ptp-config.yaml 파일에 YAML을 저장합니다.

      예 7.1. E810 NIC용 PTP 그랜드마스터 클럭 구성

      apiVersion: ptp.openshift.io/v1
kind: PtpConfig
metadata:
  name: grandmaster
  namespace: openshift-ptp
  annotations: {}
spec:
  profile:
    - name: "grandmaster"
      ptp4lOpts: "-2 --summary_interval -4"
      phc2sysOpts: -r -u 0 -m -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: 1500
          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
            - args: #ubxtool -P 29.20 -p CFG-MSG,1,38,248
                - "-P"
                - "29.20"
                - "-p"
                - "CFG-MSG,1,38,248"
              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
        [$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"
      Copy to Clipboard Toggle word wrap
      참고

      E810 Westport 채널 NIC의 경우 ts2phc.nmea_serialport 값을 /dev/gnss0 으로 설정합니다.

    2. 다음 명령을 실행하여 CR을 생성합니다. 

      $ oc create -f grandmaster-clock-ptp-config.yaml
      Copy to Clipboard Toggle word wrap

검증

  1. PtpConfig 프로필이 노드에 적용되었는지 확인합니다.

    1. 다음 명령을 실행하여 openshift-ptp 네임스페이스에서 Pod 목록을 가져옵니다. 

      $ oc get pods -n openshift-ptp -o wide
      Copy to Clipboard Toggle word wrap

      출력 예

      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
      Copy to Clipboard Toggle word wrap

    2. 프로필이 올바른지 확인합니다. PtpConfig 프로필에 지정한 노드에 해당하는 linuxptp 데몬의 로그를 검사합니다. 다음 명령을 실행합니다. 

      $ oc logs linuxptp-daemon-74m2g -n openshift-ptp -c linuxptp-daemon-container
      Copy to Clipboard Toggle word wrap

      출력 예

      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
      Copy to Clipboard Toggle word wrap

PtpConfig 사용자 정의 리소스(CR)를 생성하여 NIC를 구성함으로써 linuxptp 서비스( ptp4l , phc2sys , ts2phc )를 2개의 E810 NIC에 대한 그랜드마스터 클록(T-GM)으로 구성할 수 있습니다.

다음 E810 NIC에 대해 linuxptp 서비스를 T-GM으로 구성할 수 있습니다.

  • 인텔 E810-XXVDA4T 웨스트포트 채널 NIC
  • 인텔 E810-CQDA2T 로건 비치 NIC

분산 RAN(D-RAN) 사용 사례의 경우 다음과 같이 2개의 NIC에 대해 PTP를 구성할 수 있습니다.

  • NIC 1은 GNSS(전역 항법 위성 시스템) 시간 소스와 동기화됩니다.
  • NIC 2는 NIC 1에서 제공하는 1PPS 타이밍 출력과 동기화됩니다. 이 구성은 PtpConfig CR의 PTP 하드웨어 플러그인을 통해 제공됩니다.

2카드 PTP T-GM 구성은 ptp4l 인스턴스 하나와 ts2phc 인스턴스 하나를 사용합니다. ptp4l 및 ts2phc 프로그램은 각각 NIC당 하나씩, 두 개의 PTP 하드웨어 클록(PHC)에서 작동하도록 구성되어 있습니다. 호스트 시스템 시계는 GNSS 시간 소스에 연결된 NIC에서 동기화됩니다.

참고

다음 예제 PtpConfig CR을 기반으로 듀얼 Intel E810 네트워크 인터페이스에 대한 T-GM으로 linuxptp 서비스를 구성합니다.

PTP 빠른 이벤트를 구성하려면 ptp4lOpts , ptp4lConf 및 ptpClockThreshold 에 적절한 값을 설정합니다. ptpClockThreshold는 이벤트가 활성화된 경우에만 사용됩니다. 자세한 내용은 "PTP 빠른 이벤트 알림 게시자 구성"을 참조하세요.

사전 요구 사항

  • 프로덕션 환경에서 T-GM 클록을 사용하려면 베어 메탈 클러스터 호스트에 Intel E810 NIC 두 개를 설치합니다.
  • OpenShift CLI(oc)를 설치합니다.
  • cluster-admin 권한이 있는 사용자로 로그인합니다.
  • PTP Operator를 설치합니다.

프로세스

  1. PtpConfig CR을 생성합니다. 예를 들면 다음과 같습니다.

    1. 다음 YAML을 grandmaster-clock-ptp-config-dual-nics.yaml 파일에 저장합니다.

      예 7.2. 듀얼 E810 NIC를 위한 PTP 그랜드마스터 클럭 구성

      # In this example two cards $iface_nic1 and $iface_nic2 are connected via
# SMA1 ports by a cable and $iface_nic2 receives 1PPS signals from $iface_nic1
apiVersion: ptp.openshift.io/v1
kind: PtpConfig
metadata:
  name: grandmaster
  namespace: openshift-ptp
  annotations: {}
spec:
  profile:
    - name: "grandmaster"
      ptp4lOpts: "-2 --summary_interval -4"
      phc2sysOpts: -r -u 0 -m -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: 1500
          pins: $e810_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
            - args: #ubxtool -P 29.20 -p CFG-MSG,1,38,248
                - "-P"
                - "29.20"
                - "-p"
                - "CFG-MSG,1,38,248"
              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
        [$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"
      Copy to Clipboard Toggle word wrap
      참고

      ts2phc.nmea_serialport 의 값을 /dev/gnss0 으로 설정합니다.

    2. 다음 명령을 실행하여 CR을 생성합니다. 

      $ oc create -f grandmaster-clock-ptp-config-dual-nics.yaml
      Copy to Clipboard Toggle word wrap

검증

  1. PtpConfig 프로필이 노드에 적용되었는지 확인합니다.

    1. 다음 명령을 실행하여 openshift-ptp 네임스페이스에서 Pod 목록을 가져옵니다. 

      $ oc get pods -n openshift-ptp -o wide
      Copy to Clipboard Toggle word wrap

      출력 예

      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
      Copy to Clipboard Toggle word wrap

    2. 프로필이 올바른지 확인합니다. PtpConfig 프로필에 지정한 노드에 해당하는 linuxptp 데몬의 로그를 검사합니다. 다음 명령을 실행합니다. 

      $ oc logs linuxptp-daemon-74m2g -n openshift-ptp -c linuxptp-daemon-container
      Copy to Clipboard Toggle word wrap

      출력 예

      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
      Copy to Clipboard Toggle word wrap

PtpConfig 사용자 정의 리소스(CR)를 생성하여 NIC를 구성함으로써 linuxptp 서비스( ptp4l , phc2sys , ts2phc )를 3개의 E810 NIC에 대한 그랜드마스터 클록(T-GM)으로 구성할 수 있습니다.

다음 E810 NIC에 대해 3개의 NIC를 사용하여 linuxptp 서비스를 T-GM으로 구성할 수 있습니다.

  • 인텔 E810-XXVDA4T 웨스트포트 채널 NIC
  • 인텔 E810-CQDA2T 로건 비치 NIC

분산 RAN(D-RAN) 사용 사례의 경우 다음과 같이 3개의 NIC에 대해 PTP를 구성할 수 있습니다.

  • NIC 1은 GNSS(Global Navigation Satellite System)와 동기화됩니다.
  • NIC 2와 3은 1PPS 페이스플레이트 연결을 통해 NIC 1과 동기화됩니다.

다음 예제 PtpConfig CR을 기반으로 linuxptp 서비스를 3카드 Intel E810 T-GM으로 구성합니다.

사전 요구 사항

  • 프로덕션 환경에서 T-GM 클록을 사용하려면 베어 메탈 클러스터 호스트에 Intel E810 NIC 3개를 설치합니다.
  • OpenShift CLI(oc)를 설치합니다.
  • cluster-admin 권한이 있는 사용자로 로그인합니다.
  • PTP Operator를 설치합니다.

프로세스

  1. PtpConfig CR을 생성합니다. 예를 들면 다음과 같습니다.

    1. 다음 YAML을 three-nic-grandmaster-clock-ptp-config.yaml 파일에 저장합니다.

      예 7.3. 3개의 E810 NIC에 대한 PTP 그랜드마스터 클럭 구성

      # In this example, the three cards are connected via SMA cables:
# - $iface_timeTx1 has the GNSS signal input
# - $iface_timeTx2 SMA1 is connected to $iface_timeTx1 SMA1
# - $iface_timeTx3 SMA1 is connected to $iface_timeTx1 SMA2
apiVersion: ptp.openshift.io/v1
kind: PtpConfig
metadata:
  name: gm-3card
  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 -N 8 -R 16 -s $iface_timeTx1 -n 24
    ptpSchedulingPolicy: SCHED_FIFO
    ptpSchedulingPriority: 10
    ptpSettings:
      logReduce: "true"
    plugins:
      e810:
        enableDefaultConfig: false
        settings:
          LocalHoldoverTimeout: 14400
          LocalMaxHoldoverOffSet: 1500
          MaxInSpecOffset: 1500
        pins:
          # Syntax guide:
          # - The 1st number in each pair must be one of:
          #    0 - Disabled
          #    1 - RX
          #    2 - TX
          # - The 2nd number in each pair must match the channel number
          $iface_timeTx1:
            SMA1: 2 1
            SMA2: 2 2
            U.FL1: 0 1
            U.FL2: 0 2
          $iface_timeTx2:
            SMA1: 1 1
            SMA2: 0 2
            U.FL1: 0 1
            U.FL2: 0 2
          $iface_timeTx3:
            SMA1: 1 1
            SMA2: 0 2
            U.FL1: 0 1
            U.FL2: 0 2
        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
          - args: #ubxtool -P 29.20 -p CFG-MSG,1,38,248
              - "-P"
              - "29.20"
              - "-p"
              - "CFG-MSG,1,38,248"
            reportOutput: true
    ts2phcOpts: " "
    ts2phcConf: |
      [nmea]
      ts2phc.master 1
      [global]
      use_syslog  0
      verbose 1
      logging_level 7
      ts2phc.pulsewidth 100000000
      #example value of nmea_serialport is /dev/gnss0
      ts2phc.nmea_serialport (?<gnss_serialport>[/\w\s/]+)
      leapfile /usr/share/zoneinfo/leap-seconds.list
      [$iface_timeTx1]
      ts2phc.extts_polarity rising
      ts2phc.extts_correction 0
      [$iface_timeTx2]
      ts2phc.master 0
      ts2phc.extts_polarity rising
      #this is a measured value in nanoseconds to compensate for SMA cable delay
      ts2phc.extts_correction -10
      [$iface_timeTx3]
      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_timeTx1]
      masterOnly 1
      [$iface_timeTx1_1]
      masterOnly 1
      [$iface_timeTx1_2]
      masterOnly 1
      [$iface_timeTx1_3]
      masterOnly 1
      [$iface_timeTx2]
      masterOnly 1
      [$iface_timeTx2_1]
      masterOnly 1
      [$iface_timeTx2_2]
      masterOnly 1
      [$iface_timeTx2_3]
      masterOnly 1
      [$iface_timeTx3]
      masterOnly 1
      [$iface_timeTx3_1]
      masterOnly 1
      [$iface_timeTx3_2]
      masterOnly 1
      [$iface_timeTx3_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
    ptpClockThreshold:
      holdOverTimeout: 5
      maxOffsetThreshold: 1500
      minOffsetThreshold: -1500
  recommend:
  - profile: grandmaster
    priority: 4
    match:
    - nodeLabel: node-role.kubernetes.io/$mcp
      Copy to Clipboard Toggle word wrap
      참고

      ts2phc.nmea_serialport 의 값을 /dev/gnss0 으로 설정합니다.

    2. 다음 명령을 실행하여 CR을 생성합니다. 

      $ oc create -f three-nic-grandmaster-clock-ptp-config.yaml
      Copy to Clipboard Toggle word wrap

검증

  1. PtpConfig 프로필이 노드에 적용되었는지 확인합니다.

    1. 다음 명령을 실행하여 openshift-ptp 네임스페이스에서 Pod 목록을 가져옵니다. 

      $ oc get pods -n openshift-ptp -o wide
      Copy to Clipboard Toggle word wrap

      출력 예

      NAME                          READY   STATUS    RESTARTS   AGE     IP             NODE
linuxptp-daemon-74m3q         3/3     Running   3          4d15h   10.16.230.7    compute-1.example.com
ptp-operator-5f4f48d7c-x6zkn  1/1     Running   1          4d15h   10.128.1.145   compute-1.example.com
      Copy to Clipboard Toggle word wrap

    2. 프로필이 올바른지 확인합니다. 다음 명령을 실행하고 PtpConfig 프로필에서 지정한 노드에 해당하는 linuxptp 데몬의 로그를 조사합니다. 

      $ oc logs linuxptp-daemon-74m3q -n openshift-ptp -c linuxptp-daemon-container
      Copy to Clipboard Toggle word wrap

      출력 예

      ts2phc[2527.586]: [ts2phc.0.config:7] adding tstamp 1742826342.000000000 to clock /dev/ptp11
      1 
      
ts2phc[2527.586]: [ts2phc.0.config:7] adding tstamp 1742826342.000000000 to clock /dev/ptp7
      2 
      
ts2phc[2527.586]: [ts2phc.0.config:7] adding tstamp 1742826342.000000000 to clock /dev/ptp14
      3 
      
ts2phc[2527.586]: [ts2phc.0.config:7] nmea delay: 56308811 ns
ts2phc[2527.586]: [ts2phc.0.config:6] /dev/ptp14 offset          0 s2 freq      +0
      4 
      
ts2phc[2527.587]: [ts2phc.0.config:6] /dev/ptp7 offset          0 s2 freq      +0
      5 
      
ts2phc[2527.587]: [ts2phc.0.config:6] /dev/ptp11 offset          0 s2 freq      -0
      6 
      
I0324 14:25:05.000439  106907 stats.go:61] state updated for ts2phc =s2
I0324 14:25:05.000504  106907 event.go:419] dpll State s2, gnss State s2, tsphc state s2, gm state s2,
I0324 14:25:05.000906  106907 stats.go:61] state updated for ts2phc =s2
I0324 14:25:05.001059  106907 stats.go:61] state updated for ts2phc =s2
ts2phc[1742826305]:[ts2phc.0.config] ens4f0 nmea_status 1 offset 0 s2
GM[1742826305]:[ts2phc.0.config] ens4f0 T-GM-STATUS s2
      7
      Copy to Clipboard Toggle word wrap

      1 2 3
      ts2phc가 PTP 하드웨어 시계를 업데이트하고 있습니다.
      4 5 6
      PTP 장치와 참조 클럭 사이의 추정 PTP 장치 오프셋은 0나노초입니다. PTP 장치는 리더 클록과 동기화됩니다.
      7
      T-GM은 잠금 상태입니다(s2).

7.2.5. 그랜드마스터 클럭 PtpConfig 구성 참조
링크 복사

다음 참조 정보는 linuxptp 서비스( ptp4l , phc2sys , ts2phc )를 그랜드마스터 클럭으로 구성하는 PtpConfig 사용자 정의 리소스(CR)에 대한 구성 옵션을 설명합니다.

Expand
표 7.1. PTP Grandmaster 클럭을 위한 PtpConfig 구성 옵션
PtpConfig CR 필드설명

plugins

그랜드마스터 클럭 작업을 위해 NIC를 구성하는 .exec.cmdline 옵션 배열을 지정합니다. 그랜드마스터 클록 구성에는 특정 PTP 핀을 비활성화해야 합니다.

플러그인 메커니즘을 사용하면 PTP 운영자가 하드웨어를 자동으로 구성할 수 있습니다. Intel Westport Channel NIC 또는 Intel Logan Beach NIC의 경우 enableDefaultConfig 필드가 true 로 설정되면 PTP 운영자는 하드코딩된 스크립트를 실행하여 NIC에 필요한 구성을 수행합니다.

ptp4lOpts

ptp4l 서비스에 대한 시스템 구성 옵션을 지정합니다. 옵션은 네트워크 인터페이스 이름과 서비스 구성 파일이 자동으로 추가되므로 네트워크 인터페이스 이름 -i <interface> 및 서비스 구성 파일 -f /etc/ptp4l.conf를 포함하지 않아야 합니다.

ptp4lConf

ptp4l을 그랜드마스터 클록으로 시작하는 데 필요한 구성을 지정합니다. 예를 들어, ens2f1 인터페이스는 다운스트림 연결 장치를 동기화합니다. 그랜드마스터 클록의 경우 clockClass를 6 으로 설정하고 clockAccuracy를 0x27 로 설정합니다. 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 사이의 정수 값을 설정합니다. ptpSchedulingPolicy가 SCHED_OTHER 로 설정된 경우 ptpSchedulingPriority 필드는 사용되지 않습니다.

ptpClockThreshold

선택 사항: ptpClockThreshold 스탠자가 없으면 ptpClockThreshold 필드에 기본값이 사용됩니다. Stanza는 기본 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 클럭 소스에 연결된 직렬 포트 장치입니다. 구성된 경우 GNSS 수신기는 /dev/gnss<id> 에서 접근할 수 있습니다. 호스트에 여러 개의 GNSS 수신기가 있는 경우 다음 장치 중 하나를 열거하여 올바른 장치를 찾을 수 있습니다.

  • /sys/class/net/<eth_port>/device/gnss/
  • /sys/class/gnss/gnss<id>/device/

ts2phcOpts

ts2phc 명령에 대한 옵션을 설정합니다.

recommend[]

profile이 노드에 적용되는 방법에 대한 규칙을 정의하는 하나 이상의 recommend 오브젝트 배열을 지정합니다.

.recommend.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 필드의 키로 nodeLabel을 설정합니다. 예를 들어, node-role.kubernetes.io/worker .

.recommend.match.nodeName

oc get nodes 명령을 사용하여 노드 객체의 node.Name 필드 값으로 nodeName을 설정합니다. 예를 들어, compute-1.example.com .

7.2.5.1. 그랜드마스터 클록 클래스 동기화 상태 참조
링크 복사

다음 표는 PTP 그랜드마스터 클록(T-GM) gm.ClockClass 상태를 설명합니다. 클록 클래스 상태는 PRTC(주 기준 시간 클록) 또는 기타 타이밍 소스와 관련된 정확도와 안정성을 기준으로 T-GM 클록을 분류합니다.

홀드오버 사양은 PTP 클록이 기본 시간 소스로부터 업데이트를 받지 않고도 동기화를 유지할 수 있는 시간의 양입니다.

Expand
표 7.2. T-GM 시계 클래스 상태
클록 클래스 상태설명

gm.ClockClass 6

T-GM 클록은 LOCKED 모드의 PRTC에 연결됩니다. 예를 들어, PRTC는 GNSS 시간 소스로 추적 가능합니다.

gm.ClockClass 7

T-GM 시계는 HOLDOVER 모드이며, HOLDOVER 사양 내에 있습니다. 클록 소스를 1등급 주파수 소스로 추적할 수 없을 수도 있습니다.

gm.ClockClass 248

T-GM 시계가 FREERUN 모드입니다.

자세한 내용은 "위상/시간 추적 정보", ITU-T G.8275.1/Y.1369.1 권장 사항을 참조하세요.

7.2.5.2. Intel E810 NIC 하드웨어 구성 참조
링크 복사

이 정보를 사용하면 Intel E810 하드웨어 플러그인을 사용하여 E810 네트워크 인터페이스를 PTP 그랜드마스터 클록으로 구성하는 방법을 알아볼 수 있습니다. 하드웨어 핀 구성은 네트워크 인터페이스가 시스템의 다른 구성 요소 및 장치와 상호 작용하는 방식을 결정합니다. Intel E810 NIC에는 외부 1PPS 신호를 위한 4개의 커넥터가 있습니다: SMA1 , SMA2 , U.FL1 , U.FL2 .

Expand
표 7.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 커넥터는 양방향입니다.

다음 예와 같이 spec.profile.plugins.e810.pins 매개변수를 사용하여 Intel E810 NIC의 핀 구성을 설정할 수 있습니다. 

pins:
      <interface_name>:
        <connector_name>: <function> <channel_number>
Copy to Clipboard Toggle word wrap

다음과 같습니다.

<함수> : 핀의 역할을 지정합니다. 다음 값은 핀 역할과 연관되어 있습니다.

  • 비활성화됨
  • 1 : Rx (수신 타임스탬프)
  • 2 : Tx (전송 타임스탬프)

<채널 번호> : 물리적 커넥터와 연결된 번호입니다. 다음 채널 번호는 물리적 커넥터와 연결되어 있습니다.

  • 1 : SMA1 또는 U.FL1
  • 2 : SMA2 또는 U.FL2

예:

  • 0 1 : SMA1 또는 U.FL1 에 매핑된 핀을 비활성화합니다.
  • 1 2 : SMA2 또는 U.FL2 에 Rx 기능을 할당합니다.
참고

SMA1 과 U.FL1 커넥터는 채널 1을 공유합니다. SMA2 와 U.FL2 커넥터는 채널 2를 공유합니다.

PtpConfig 사용자 정의 리소스(CR)에서 GNSS 시계를 구성하려면 spec.profile.plugins.e810.ublxCmds 매개변수를 설정합니다.

중요

T-GM GPS 안테나 케이블 신호 지연을 보상하기 위해 오프셋 값을 구성해야 합니다. 최적의 T-GM 안테나 오프셋 값을 구성하려면 GNSS 안테나 케이블 신호 지연을 정확하게 측정하세요. Red Hat은 이 측정을 지원하거나 필요한 지연 오프셋에 대한 값을 제공할 수 없습니다.

이러한 각 ublxCmds 스탠자는 ubxtool 명령을 사용하여 호스트 NIC에 적용되는 구성에 해당합니다. 예를 들면 다음과 같습니다. 

ublxCmds:
  - args:
      - "-P"
      - "29.20"
      - "-z"
      - "CFG-HW-ANT_CFG_VOLTCTRL,1"
      - "-z"
      - "CFG-TP-ANT_CABLEDELAY,<antenna_delay_offset>"
1 

    reportOutput: false
Copy to Clipboard Toggle word wrap
1
나노초 단위로 측정된 T-GM 안테나 지연 오프셋입니다. 필요한 지연 오프셋 값을 얻으려면 외부 테스트 장비를 사용하여 케이블 지연을 측정해야 합니다.

다음 표에서는 동등한 ubxtool 명령을 설명합니다.

Expand
표 7.4. Intel E810 ublxCmds 구성
ubxtool 명령어설명

ubxtool -P 29.20 -z CFG-HW-ANT_CFG_VOLTCTRL,1 -z CFG-TP-ANT_CABLEDELAY,<antenna_delay_offset>

안테나 전압 제어를 활성화하고, UBX-MON-RF 및 UBX-INF-NOTICE 로그 메시지에서 안테나 상태를 보고하고, GPS 안테나 케이블 신호 지연을 오프셋하는 <antenna_delay_offset> 값을 나노초 단위로 설정합니다.

ubxtool -P 29.20 -e GPS

안테나가 GPS 신호를 수신할 수 있도록 합니다.

ubxtool -P 29.20 -d 갈릴레오

갈릴레오 GPS 위성으로부터 신호를 수신하도록 안테나를 구성합니다.

ubxtool -P 29.20 -d 글로나스

GLONASS GPS 위성에서 신호를 수신하는 안테나를 비활성화합니다.

ubxtool -P 29.20 -d BeiDou

BeiDou GPS 위성에서 신호를 수신하는 안테나를 비활성화합니다.

ubxtool -P 29.20 -d SBAS

SBAS GPS 위성에서 신호를 수신하는 안테나를 비활성화합니다.

ubxtool -P 29.20 -t -w 5 -v 1 -e SURVEYIN,600,50000

GNSS 수신기 조사 프로세스를 구성하여 초기 위치 추정치를 개선합니다. 최적의 결과를 얻으려면 최대 24시간이 걸릴 수 있습니다.

ubxtool -P 29.20 -p 월-하드웨어

하드웨어에 대한 단일 자동 스캔을 실행하고 NIC 상태 및 구성 설정에 대해 보고합니다.

7.2.5.3. 듀얼 E810 NIC 구성 참조
링크 복사

이 정보를 사용하면 Intel E810 하드웨어 플러그인을 사용하여 E810 네트워크 인터페이스 쌍을 PTP 그랜드마스터 클록(T-GM)으로 구성하는 방법을 알아볼 수 있습니다.

듀얼 NIC 클러스터 호스트를 구성하기 전에 1PPS 페이스플레이스 연결을 사용하여 두 개의 NIC를 SMA1 케이블로 연결해야 합니다.

듀얼 NIC T-GM을 구성하는 경우 SMA1 연결 포트를 사용하여 NIC를 연결할 때 발생하는 1PPS 신호 지연을 보상해야 합니다. 케이블 길이, 주변 온도, 구성 요소 및 제조 허용 오차와 같은 다양한 요소가 신호 지연에 영향을 미칠 수 있습니다. 지연을 보상하려면 신호 지연을 오프셋하는 데 사용하는 특정 값을 계산해야 합니다.

Expand
표 7.5. 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을 설정합니다. 이는 GNSS가 아닌 1PPS 입력에서 NIC 2의 타이밍 소스를 구성합니다. 사용하는 특정 SMA 케이블과 케이블 길이로 인해 발생하는 지연을 보상하기 위해 NIC 2에 대한 ts2phc.extts_correction 값을 구성합니다. 구성하는 값은 구체적인 측정값과 SMA1 케이블 길이에 따라 달라집니다.

spec.profile.ptp4lConf

여러 NIC에 대한 지원을 활성화하려면 boundary_clock_jbod 값을 1로 설정합니다.

spec.profile.plugins.e810.pins 목록의 각 값은 <function> <channel_number> 형식을 따릅니다.

다음과 같습니다.

<함수> : 핀 역할을 지정합니다. 다음 값은 핀 역할과 연관되어 있습니다.

  • 비활성화됨
  • 1 : 수신(Rx) – 1PPS IN용
  • 2 : 전송(Tx) – 1PPS OUT용

<channel_number> : 물리적 커넥터와 연결된 번호입니다. 다음 채널 번호는 물리적 커넥터와 연결되어 있습니다.

  • 1 : SMA1 또는 U.FL1
  • 2 : SMA2 또는 U.FL2

예:

  • 2 1 : SMA1 에서 1PPS OUT (Tx)을 활성화합니다.
  • 1 1 : SMA1 에서 1PPS IN (Rx)을 활성화합니다.

PTP 운영자는 이러한 값을 Intel E810 하드웨어 플러그인에 전달하고 이를 각 NIC의 sysfs 핀 구성 인터페이스에 기록합니다.

7.2.5.4. 3카드 E810 NIC 구성 참조
링크 복사

이 정보를 사용하여 3개의 E810 NIC를 PTP 그랜드마스터 클록(T-GM)으로 구성하는 방법을 알아보세요.

3카드 클러스터 호스트를 구성하기 전에 1PPS 페이스플레이트 연결을 사용하여 3개의 NIC를 연결해야 합니다. 기본 NIC 1PPS_out 출력은 다른 2개의 NIC에 전원을 공급합니다.

3카드 T-GM을 구성할 경우 SMA1 연결 포트를 사용하여 NIC를 연결할 때 발생하는 1PPS 신호 지연을 보상해야 합니다. 케이블 길이, 주변 온도, 구성 요소 및 제조 허용 오차와 같은 다양한 요소가 신호 지연에 영향을 미칠 수 있습니다. 지연을 보상하려면 신호 지연을 오프셋하는 데 사용하는 특정 값을 계산해야 합니다.

Expand
표 7.6. 3카드 E810 T-GM PtpConfig CR 참조
PtpConfig 필드설명

spec.profile.plugins.e810.pins

PTP Operator E810 하드웨어 플러그인을 사용하여 E810 하드웨어 핀을 구성합니다.

  • $iface_timeTx1.SMA1은 NIC 1의 SMA1 에 대한 1PPS OUT 연결을 활성화합니다.
  • $iface_timeTx1.SMA2는 NIC 1의 SMA2 에 대한 1PPS OUT 연결을 활성화합니다.
  • $iface_timeTx2.SMA1 과 $iface_timeTx3.SMA1은 NIC 2와 NIC 3의 SMA1 에 대한 1PPS IN 연결을 활성화합니다.
  • $iface_timeTx2.SMA2 및 $iface_timeTx3.SMA2는 NIC 2와 NIC 3에서 SMA2 연결을 비활성화합니다.

spec.profile.ts2phcConf

ts2phcConf 필드를 사용하여 NIC에 대한 매개변수를 구성합니다. NIC 2와 NIC 3에 대해 ts2phc.master 0을 설정합니다. 이는 GNSS가 아닌 1PPS 입력에서 NIC 2와 NIC 3의 타이밍 소스를 구성합니다. 사용하는 특정 SMA 케이블과 케이블 길이로 인해 발생하는 지연을 보상하기 위해 NIC 2와 NIC 3에 대한 ts2phc.extts_correction 값을 구성합니다. 구성하는 값은 구체적인 측정값과 SMA1 케이블 길이에 따라 달라집니다.

spec.profile.ptp4lConf

여러 NIC에 대한 지원을 활성화하려면 boundary_clock_jbod 값을 1로 설정합니다.

7.2.6. GNSS를 소스로 사용하는 그랜드마스터 시계의 홀드오버
링크 복사

홀드오버를 사용하면 GNSS(전역 항법 위성 시스템) 소스를 사용할 수 없을 때 그랜드마스터(T-GM) 클록이 동기화 성능을 유지할 수 있습니다. 이 기간 동안 T-GM 클록은 내부 발진기와 홀드오버 매개변수를 사용하여 타이밍 혼란을 줄입니다.

PTPConfig 사용자 정의 리소스(CR)에서 다음 홀드오버 매개변수를 구성하여 홀드오버 동작을 정의할 수 있습니다.

MaxInSpecOffset
허용되는 최대 오프셋을 나노초 단위로 지정합니다. T-GM 클록이 MaxInSpecOffset 값을 초과하면 FREERUN 상태(클록 클래스 상태 gm.ClockClass 248 )로 전환됩니다.
LocalHoldoverTimeout
T-GM 클록이 FREERUN 상태로 전환되기 전에 홀드오버 상태를 유지하는 최대 기간(초)을 지정합니다.
LocalMaxHoldoverOffSet
홀드오버 상태 동안 T-GM 클록이 도달할 수 있는 최대 오프셋을 나노초 단위로 지정합니다.

MaxInSpecOffset 값이 LocalMaxHoldoverOffset 값보다 작고 T-GM 클록이 최대 오프셋 값을 초과하는 경우, T-GM 클록은 홀드오버 상태에서 FREERUN 상태로 전환됩니다.

중요

LocalMaxHoldoverOffSet 값이 MaxInSpecOffset 값보다 작으면 클록이 최대 오프셋에 도달하기 전에 홀드오버 타임아웃이 발생합니다. 이 문제를 해결하려면 MaxInSpecOffset 필드와 LocalMaxHoldoverOffset 필드를 같은 값으로 설정합니다.

클록 클래스 상태에 대한 자세한 내용은 "그랜드마스터 클록 클래스 동기화 상태 참조" 문서를 참조하세요.

T-GM 클록은 홀드오버 매개변수 LocalMaxHoldoverOffSet 및 LocalHoldoverTimeout 을 사용하여 기울기를 계산합니다. 기울기는 위상 오프셋이 시간에 따라 변하는 비율입니다. 오프셋은 초당 나노초 단위로 측정되며, 설정된 값은 주어진 기간 동안 오프셋이 얼마나 증가하는지를 나타냅니다.

T-GM 시계는 기울기 값을 사용하여 시간 편차를 예측하고 보상하므로 홀드오버 동안 타이밍 중단이 줄어듭니다. T-GM 시계는 다음 공식을 사용하여 기울기를 계산합니다.

  • Slope = localMaxHoldoverOffSet / localHoldoverTimeout

    예를 들어, LocalHoldOverTimeout 매개변수가 60초로 설정되고 LocalMaxHoldoverOffset 매개변수가 3000나노초로 설정된 경우 기울기는 다음과 같이 계산됩니다.

    기울기 = 3000나노초 / 60초 = 초당 50나노초

    T-GM 시계는 60초 만에 최대 오프셋에 도달합니다.

참고

위상 오프셋은 피코초에서 나노초로 변환됩니다. 결과적으로 홀드오버 동안 계산된 위상 오프셋은 나노초 단위로 표현되고, 결과 기울기는 초당 나노초 단위로 표현됩니다.

다음 그림은 GNSS를 소스로 하는 T-GM 시계의 홀드오버 동작을 보여줍니다.

그림 7.5. GNSS를 소스로 하는 T-GM 시계의 홀드오버

GNSS를 소스로 하는 T-GM 시계의 홀드오버
View larger image
GNSS를 소스로 하는 T-GM 시계의 홀드오버

20 GNSS 신호가 손실되어 T-GM 시계가 HOLDOVER 모드로 전환됩니다. T-GM 시계는 내부 시계를 사용하여 시간 정확도를 유지합니다.

20 GNSS 신호가 복구되고 T-GM 시계가 다시 LOCKED 모드로 들어갑니다. GNSS 신호가 복구되면 T-GM 클록은 동기화 체인의 모든 종속 구성 요소(예: ts2phc 오프셋, 디지털 위상 잠금 루프(DPLL) 위상 오프셋, GNSS 오프셋)가 안정적인 LOCKED 모드에 도달한 후에만 LOCKED 모드로 다시 들어갑니다.

20 GNSS 신호가 다시 손실되고 T-GM 시계는 다시 HOLDOVER 모드로 들어갑니다. 시간 오차가 증가하기 시작합니다.

20 추적성이 장기간 손실되어 시간 오류가 MaxInSpecOffset 임계값을 초과했습니다.

20 GNSS 신호가 복구되고 T-GM 시계가 동기화를 재개합니다. 시간 오차가 감소하기 시작합니다.

20 시간 오차는 감소하여 MaxInSpecOffset 임계값 내로 떨어집니다.

7.2.7. PTP 그랜드마스터 클록에 대한 동적 윤초 처리 구성
링크 복사

PTP Operator 컨테이너 이미지에는 출시 당시 사용 가능한 최신 leap-seconds.list 파일이 포함되어 있습니다. GPS(Global Positioning System) 알림을 사용하여 PTP 운영자가 윤초 파일을 자동으로 업데이트하도록 구성할 수 있습니다.

윤초 정보는 openshift-ptp 네임스페이스의 leap-configmap 이라는 자동 생성된 ConfigMap 리소스에 저장됩니다. PTP 운영자는 ts2phc 프로세스가 접근할 수 있는 linuxptp-daemon 포드의 볼륨으로 leap-configmap 리소스를 마운트합니다.

GPS 위성이 새로운 윤초 데이터를 방송하면 PTP 운영자는 새로운 데이터로 leap-configmap 리소스를 업데이트합니다. ts2phc 프로세스는 변경 사항을 자동으로 적용합니다.

참고

다음 절차는 참고용으로 제공됩니다. PTP Operator의 4.19 버전은 기본적으로 자동 윤초 관리를 활성화합니다.

사전 요구 사항

  • OpenShift CLI(oc)가 설치되어 있습니다.
  • cluster-admin 권한이 있는 사용자로 로그인했습니다.
  • 클러스터에 PTP 운영자를 설치하고 PTP 그랜드마스터 클록(T-GM)을 구성했습니다.

프로세스

  1. PtpConfig CR의 phc2sysOpts 섹션에서 자동 윤초 처리를 구성합니다. 다음 옵션을 설정하세요. 

    phc2sysOpts: -r -u 0 -m -N 8 -R 16 -S 2 -s ens2f0 -n 24
    1
    Copy to Clipboard Toggle word wrap
    참고

    이전에는 T-GM에서 과거 윤초를 고려하기 위해 phc2sys 구성( -O -37 )에서 오프셋 조정이 필요했습니다. 더 이상 필요하지 않습니다.

  2. PtpConfig CR의 spec.profile.plugins.e810.ublxCmds 섹션에서 GPS 수신기가 NAV-TIMELS 메시지를 주기적으로 보고할 수 있도록 Intel e810 NIC를 구성합니다. 예를 들면 다음과 같습니다. 

    - args: #ubxtool -P 29.20 -p CFG-MSG,1,38,248
    - "-P"
    - "29.20"
    - "-p"
    - "CFG-MSG,1,38,248"
    Copy to Clipboard Toggle word wrap

검증

  1. 구성된 T-GM이 연결된 GPS로부터 NAV-TIMELS 메시지를 수신하고 있는지 확인합니다. 다음 명령을 실행합니다. 

    $ oc -n openshift-ptp -c linuxptp-daemon-container exec -it $(oc -n openshift-ptp get pods -o name | grep daemon) -- ubxtool -t -p NAV-TIMELS -P 29.20
    Copy to Clipboard Toggle word wrap

    출력 예

    1722509534.4417
UBX-NAV-STATUS:
  iTOW 384752000 gpsFix 5 flags 0xdd fixStat 0x0 flags2 0x8
  ttff 18261, msss 1367642864

1722509534.4419
UBX-NAV-TIMELS:
  iTOW 384752000 version 0 reserved2 0 0 0 srcOfCurrLs 2
  currLs 18 srcOfLsChange 2 lsChange 0 timeToLsEvent 70376866
  dateOfLsGpsWn 2441 dateOfLsGpsDn 7 reserved2 0 0 0
  valid x3

1722509534.4421
UBX-NAV-CLOCK:
  iTOW 384752000 clkB 784281 clkD 435 tAcc 3 fAcc 215

1722509535.4477
UBX-NAV-STATUS:
  iTOW 384753000 gpsFix 5 flags 0xdd fixStat 0x0 flags2 0x8
  ttff 18261, msss 1367643864

1722509535.4479
UBX-NAV-CLOCK:
  iTOW 384753000 clkB 784716 clkD 435 tAcc 3 fAcc 218
    Copy to Clipboard Toggle word wrap

  2. PTP 운영자가 leap-configmap 리소스를 성공적으로 생성했고 최신 버전의 leap-seconds.list 로 업데이트되었는지 확인합니다. 다음 명령을 실행합니다. 

    $ oc -n openshift-ptp get configmap leap-configmap -o jsonpath='{.data.<node_name>}'
    1
    Copy to Clipboard Toggle word wrap
    1 1
    <노드_이름>을 자동 윤초 관리 기능이 있는 PTP T-GM 시계를 설치하고 구성한 노드로 바꾸세요. 노드 이름에 특수문자를 이스케이프합니다. 예를 들어, node-1\.example\.com .

    출력 예

    # Do not edit
# This file is generated automatically by linuxptp-daemon
#$  3913697179
#@  4291747200
2272060800     10    # 1 Jan 1972
2287785600     11    # 1 Jul 1972
2303683200     12    # 1 Jan 1973
2335219200     13    # 1 Jan 1974
2366755200     14    # 1 Jan 1975
2398291200     15    # 1 Jan 1976
2429913600     16    # 1 Jan 1977
2461449600     17    # 1 Jan 1978
2492985600     18    # 1 Jan 1979
2524521600     19    # 1 Jan 1980
2571782400     20    # 1 Jul 1981
2603318400     21    # 1 Jul 1982
2634854400     22    # 1 Jul 1983
2698012800     23    # 1 Jul 1985
2776982400     24    # 1 Jan 1988
2840140800     25    # 1 Jan 1990
2871676800     26    # 1 Jan 1991
2918937600     27    # 1 Jul 1992
2950473600     28    # 1 Jul 1993
2982009600     29    # 1 Jul 1994
3029443200     30    # 1 Jan 1996
3076704000     31    # 1 Jul 1997
3124137600     32    # 1 Jan 1999
3345062400     33    # 1 Jan 2006
3439756800     34    # 1 Jan 2009
3550089600     35    # 1 Jul 2012
3644697600     36    # 1 Jul 2015
3692217600     37    # 1 Jan 2017

#h  e65754d4 8f39962b aa854a61 661ef546 d2af0bfa
    Copy to Clipboard Toggle word wrap

7.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를 설치합니다.

프로세스

  1. 다음 PtpConfig CR을 만든 다음 YAML을 boundary-clock-ptp-config.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"
    Copy to Clipboard Toggle word wrap

    Expand
    표 7.7. PTP 경계 클록 CR 구성 옵션
    CR 필드설명

    name

    PtpConfig CR의 이름입니다.

    profile

    하나 이상의 profile 오브젝트의 배열을 지정합니다.

    name

    프로파일 오브젝트를 고유하게 식별하는 프로파일 오브젝트의 이름을 지정합니다.

    ptp4lOpts

    ptp4l 서비스에 대한 시스템 구성 옵션을 지정합니다. 옵션은 네트워크 인터페이스 이름과 서비스 구성 파일이 자동으로 추가되므로 네트워크 인터페이스 이름 -i <interface> 및 서비스 구성 파일 -f /etc/ptp4l.conf를 포함하지 않아야 합니다.

    ptp4lConf

    ptp4l을 경계 클록으로 시작하는 데 필요한 구성을 지정합니다. 예를 들어 ens1f0 은 그랜드 마스터 클록에서 동기화되고 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 이벤트가 트리거되기까지 걸리는 시간을 구성합니다. holdOverTimeout은 PTP 마스터 클록이 연결 해제될 때 PTP 클록 이벤트 상태가 FREERUN 으로 변경되기 전의 시간 값(초)입니다. maxOffsetThreshold 및 minOffsetThreshold 설정은 CLOCK_REALTIME ( phc2sys ) 또는 마스터 오프셋( ptp4l ) 값과 비교하는 나노초 단위의 오프셋 값을 구성합니다. ptp4l 또는 phc2sys 오프셋 값이 이 범위를 벗어나면 PTP 클록 상태가 FREERUN 으로 설정됩니다. 오프셋 값이 이 범위 내에 있으면 PTP 클록 상태가 LOCKED 로 설정됩니다.

    recommend[]

    profile이 노드에 적용되는 방법에 대한 규칙을 정의하는 하나 이상의 recommend 오브젝트 배열을 지정합니다.

    .recommend.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 필드의 키로 nodeLabel을 설정합니다. 예를 들어, node-role.kubernetes.io/worker .

    .recommend.match.nodeName

    oc get nodes 명령을 사용하여 노드 객체의 node.Name 필드 값으로 nodeName을 설정합니다. 예를 들어, compute-1.example.com .

  2. 다음 명령을 실행하여 CR을 생성합니다. 

    $ oc create -f boundary-clock-ptp-config.yaml
    Copy to Clipboard Toggle word wrap

검증

  1. PtpConfig 프로필이 노드에 적용되었는지 확인합니다.

    1. 다음 명령을 실행하여 openshift-ptp 네임스페이스에서 Pod 목록을 가져옵니다. 

      $ oc get pods -n openshift-ptp -o wide
      Copy to Clipboard Toggle word wrap

      출력 예

      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
      Copy to Clipboard Toggle word wrap

    2. 프로필이 올바른지 확인합니다. PtpConfig 프로필에 지정한 노드에 해당하는 linuxptp 데몬의 로그를 검사합니다. 다음 명령을 실행합니다. 

      $ oc logs linuxptp-daemon-4xkbb -n openshift-ptp -c linuxptp-daemon-container
      Copy to Clipboard Toggle word wrap

      출력 예

      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] ------------------------------------
      Copy to Clipboard Toggle word wrap

7.2.8.1. 듀얼 NIC 하드웨어에 대한 경계 클록으로 linuxptp 서비스 구성
링크 복사

각 NIC에 대한 PtpConfig 사용자 정의 리소스(CR) 객체를 생성하여 linuxptp 서비스( ptp4l , phc2sys )를 듀얼 NIC 하드웨어의 경계 클록으로 구성할 수 있습니다.

듀얼 NIC 하드웨어를 사용하면 각 NIC를 동일한 업스트림 리더 클록에 연결할 수 있으며, 각 NIC에 대해 별도의 ptp4l 인스턴스를 통해 다운스트림 클록을 공급할 수 있습니다.

사전 요구 사항

  • OpenShift CLI(oc)를 설치합니다.
  • cluster-admin 권한이 있는 사용자로 로그인합니다.
  • PTP Operator를 설치합니다.

프로세스

  1. "경계 클록으로 linuxptp 서비스 구성"의 참조 CR을 각 CR의 기준으로 사용하여 각 NIC에 대해 하나씩 두 개의 별도 PtpConfig CR을 만듭니다. 예를 들면 다음과 같습니다.

    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
      Copy to Clipboard Toggle word wrap
      1
      ptp4l을 경계 클록으로 시작하는 데 필요한 인터페이스를 지정합니다. 예를 들어, ens5f0은 그랜드마스터 클럭과 동기화하고, ens5f1은 연결된 장치와 동기화합니다.
      2
      필수 phc2sysOpts 값. -m은 stdout 에 메시지를 출력합니다. linuxptp-daemon DaemonSet은 로그를 구문 분석하고 Prometheus 메트릭을 생성합니다.

    2. 두 번째 NIC에 대한 phc2sys 서비스를 비활성화하려면 boundary-clock-ptp-config-nic2.yaml을 만들고 phc2sysOpts 필드를 완전히 제거합니다. 

      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
...
      Copy to Clipboard Toggle word wrap
      1
      두 번째 NIC에서 경계 클록으로 ptp4l을 시작하는 데 필요한 인터페이스를 지정합니다.
      참고

      두 번째 NIC에서 phc2sys 서비스를 비활성화하려면 두 번째 PtpConfig CR에서 phc2sysOpts 필드를 완전히 제거해야 합니다.

  2. 다음 명령을 실행하여 듀얼 NIC PtpConfig CR을 만듭니다.

    1. 첫 번째 NIC에 대한 PTP를 구성하는 CR을 만듭니다. 

      $ oc create -f boundary-clock-ptp-config-nic1.yaml
      Copy to Clipboard Toggle word wrap

    2. 두 번째 NIC에 대한 PTP를 구성하는 CR을 만듭니다. 

      $ oc create -f boundary-clock-ptp-config-nic2.yaml
      Copy to Clipboard Toggle word wrap

검증

  • PTP 운영자가 두 NIC 모두에 PtpConfig CR을 적용했는지 확인하세요. 듀얼 NIC 하드웨어가 설치된 노드에 해당하는 linuxptp 데몬의 로그를 조사합니다. 예를 들어 다음 명령을 실행합니다. 

    $ oc logs linuxptp-daemon-cvgr6 -n openshift-ptp -c linuxptp-daemon-container
    Copy to Clipboard Toggle word wrap

    출력 예

    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
    Copy to Clipboard Toggle word wrap

이중 PTP 경계 클럭(T-BC)의 linuxptp 서비스 ptp4l 및 phc2sys 를 고가용성(HA) 시스템 클럭으로 구성할 수 있습니다.

고가용성 시스템 클록은 두 개의 경계 클록으로 구성된 듀얼 NIC Intel E810 Salem 채널 하드웨어의 여러 시간 소스를 사용합니다. 두 개의 경계 클록 인스턴스가 HA 설정에 참여하며, 각각 고유한 구성 프로필을 갖습니다. 각 NIC를 다운스트림 클럭에 공급하는 각 NIC에 대한 별도의 ptp4l 인스턴스를 사용하여 동일한 업스트림 리더 클럭에 연결합니다.

NIC를 T-BC로 구성하는 두 개의 PtpConfig 사용자 정의 리소스(CR) 개체와 두 NIC 간의 고가용성을 구성하는 세 번째 PtpConfig CR을 만듭니다.

중요

HA를 구성하는 PtpConfig CR에서 phc2SysOpts 옵션을 한 번 설정합니다. 두 NIC를 구성하는 PtpConfig CR에서 phc2sysOpts 필드를 빈 문자열로 설정합니다. 이렇게 하면 두 프로필에 대해 개별 phc2sys 프로세스가 설정되는 것을 방지할 수 있습니다.

세 번째 PtpConfig CR은 고가용성 시스템 클록 서비스를 구성합니다. CR은 ptp4l 프로세스가 실행되지 않도록 ptp4lOpts 필드를 빈 문자열로 설정합니다. CR은 spec.profile.ptpSettings.haProfiles 키 아래에 ptp4l 구성에 대한 프로필을 추가하고 해당 프로필의 커널 소켓 경로를 phc2sys 서비스에 전달합니다. ptp4l 오류가 발생하면 phc2sys 서비스는 백업 ptp4l 구성으로 전환합니다. 기본 프로필이 다시 활성화되면 phc2sys 서비스는 원래 상태로 돌아갑니다.

중요

HA를 구성하는 데 사용하는 세 개의 PtpConfig CR 모두에 대해 spec.recommend.priority를 동일한 값으로 설정했는지 확인하세요.

사전 요구 사항

  • OpenShift CLI(oc)를 설치합니다.
  • cluster-admin 권한이 있는 사용자로 로그인합니다.
  • PTP Operator를 설치합니다.
  • Intel E810 Salem 채널 듀얼 NIC를 사용하여 클러스터 노드를 구성합니다.

프로세스

  1. "듀얼 NIC 하드웨어에 대한 경계 클록으로 linuxptp 서비스 구성"의 CR을 각 CR에 대한 참조로 사용하여 각 NIC에 대해 하나씩 두 개의 별도 PtpConfig CR을 만듭니다.

    1. phc2sysOpts 필드에 빈 문자열을 지정하여 ha-ptp-config-nic1.yaml 파일을 만듭니다. 예를 들면 다음과 같습니다. 

      apiVersion: ptp.openshift.io/v1
kind: PtpConfig
metadata:
  name: ha-ptp-config-nic1
  namespace: openshift-ptp
spec:
  profile:
  - name: "ha-ptp-config-profile1"
    ptp4lOpts: "-2 --summary_interval -4"
    ptp4lConf: |
      1 
      
      [ens5f1]
      masterOnly 1
      [ens5f0]
      masterOnly 0
    #...
    phc2sysOpts: ""
      2
      Copy to Clipboard Toggle word wrap
      1
      ptp4l을 경계 클록으로 시작하는 데 필요한 인터페이스를 지정합니다. 예를 들어, ens5f0은 그랜드마스터 클럭과 동기화하고, ens5f1은 연결된 장치와 동기화합니다.
      2
      phc2sysOpts를 빈 문자열로 설정합니다. 이러한 값은 고가용성을 구성하는 PtpConfig CR의 spec.profile.ptpSettings.haProfiles 필드에서 채워집니다.

    2. 다음 명령을 실행하여 NIC 1에 PtpConfig CR을 적용합니다. 

      $ oc create -f ha-ptp-config-nic1.yaml
      Copy to Clipboard Toggle word wrap

    3. phc2sysOpts 필드에 빈 문자열을 지정하여 ha-ptp-config-nic2.yaml 파일을 만듭니다. 예를 들면 다음과 같습니다. 

      apiVersion: ptp.openshift.io/v1
kind: PtpConfig
metadata:
  name: ha-ptp-config-nic2
  namespace: openshift-ptp
spec:
  profile:
  - name: "ha-ptp-config-profile2"
    ptp4lOpts: "-2 --summary_interval -4"
    ptp4lConf: |
      [ens7f1]
      masterOnly 1
      [ens7f0]
      masterOnly 0
    #...
    phc2sysOpts: ""
      Copy to Clipboard Toggle word wrap

    4. 다음 명령을 실행하여 NIC 2에 PtpConfig CR을 적용합니다. 

      $ oc create -f ha-ptp-config-nic2.yaml
      Copy to Clipboard Toggle word wrap

  2. HA 시스템 클록을 구성하는 PtpConfig CR을 만듭니다. 예를 들면 다음과 같습니다.

    1. ptp-config-for-ha.yaml 파일을 만듭니다. PtpConfig CR에 설정된 metadata.name 필드와 일치하도록 haProfiles를 설정합니다. 이 필드는 두 NIC를 구성합니다. 예: haProfiles: ha-ptp-config-nic1,ha-ptp-config-nic2 

      apiVersion: ptp.openshift.io/v1
kind: PtpConfig
metadata:
  name: boundary-ha
  namespace: openshift-ptp
  annotations: {}
spec:
  profile:
    - name: "boundary-ha"
      ptp4lOpts: ""
      1 
      
      phc2sysOpts: "-a -r -n 24"
      ptpSchedulingPolicy: SCHED_FIFO
      ptpSchedulingPriority: 10
      ptpSettings:
        logReduce: "true"
        haProfiles: "$profile1,$profile2"
  recommend:
    - profile: "boundary-ha"
      priority: 4
      match:
        - nodeLabel: "node-role.kubernetes.io/$mcp"
      Copy to Clipboard Toggle word wrap
      1
      ptp4lOpts 필드를 빈 문자열로 설정합니다. 비어 있지 않으면 p4ptl 프로세스가 심각한 오류로 시작됩니다.
    중요

    개별 NIC를 구성하는 PtpConfig CR 앞에 고가용성 PtpConfig CR을 적용하지 마세요.

    1. 다음 명령을 실행하여 HA PtpConfig CR을 적용합니다. 

      $ oc create -f ptp-config-for-ha.yaml
      Copy to Clipboard Toggle word wrap

검증

  • PTP 운영자가 PtpConfig CR을 올바르게 적용했는지 확인하세요. 다음 단계를 수행하세요.

    1. 다음 명령을 실행하여 openshift-ptp 네임스페이스에서 Pod 목록을 가져옵니다. 

      $ oc get pods -n openshift-ptp -o wide
      Copy to Clipboard Toggle word wrap

      출력 예

      NAME                            READY   STATUS    RESTARTS   AGE   IP               NODE
linuxptp-daemon-4xkrb           1/1     Running   0          43m   10.1.196.24      compute-0.example.com
ptp-operator-657bbq64c8-2f8sj   1/1     Running   0          43m   10.129.0.61      control-plane-1.example.com
      Copy to Clipboard Toggle word wrap

      참고

      linuxptp-daemon 포드는 하나만 있어야 합니다.

    2. 다음 명령을 실행하여 프로필이 올바른지 확인하세요. PtpConfig 프로필에 지정한 노드에 해당하는 linuxptp 데몬의 로그를 검사합니다. 

      $ oc logs linuxptp-daemon-4xkrb -n openshift-ptp -c linuxptp-daemon-container
      Copy to Clipboard Toggle word wrap

      출력 예

      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: ha-ptp-config-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] ------------------------------------
      Copy to Clipboard Toggle word wrap

7.2.9. linuxptp 서비스를 일반 클록으로 구성
링크 복사

PtpConfig 사용자 정의 리소스(CR) 객체를 생성하여 linuxptp 서비스( ptp4l , phc2sys )를 일반 시계로 구성할 수 있습니다.

참고

다음 예제 PtpConfig CR을 기반으로 특정 하드웨어 및 환경에 맞는 일반 시계로 linuxptp 서비스를 구성하세요. 이 예제 CR은 PTP 빠른 이벤트를 구성하지 않습니다. PTP 빠른 이벤트를 구성하려면 ptp4lOpts , ptp4lConf 및 ptpClockThreshold 에 적절한 값을 설정합니다. ptpClockThreshold 는 이벤트가 활성화된 경우에만 필요합니다. 자세한 내용은 "PTP 빠른 이벤트 알림 게시자 구성"을 참조하세요.

사전 요구 사항

  • OpenShift CLI(oc)를 설치합니다.
  • cluster-admin 권한이 있는 사용자로 로그인합니다.
  • PTP Operator를 설치합니다.

프로세스

  1. 다음 PtpConfig CR을 생성한 다음 YAML을 ordinary-clock-ptp-config.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"
    Copy to Clipboard Toggle word wrap

    Expand
    표 7.8. PTP 일반 클록 CR 구성 옵션
    CR 필드설명

    name

    PtpConfig CR의 이름입니다.

    profile

    하나 이상의 profile 오브젝트의 배열을 지정합니다. 각 프로필의 이름은 고유해야 합니다.

    interface

    ptp4l 서비스에서 사용할 네트워크 인터페이스를 지정합니다(예: ens787f1 ).

    ptp4lOpts

    예를 들어 IEEE 802.3 네트워크 전송을 선택하려면 -2를 지정하는 등 ptp4l 서비스에 대한 시스템 구성 옵션을 지정합니다. 옵션은 네트워크 인터페이스 이름과 서비스 구성 파일이 자동으로 추가되므로 네트워크 인터페이스 이름 -i <interface> 및 서비스 구성 파일 -f /etc/ptp4l.conf를 포함하지 않아야 합니다. 이 인터페이스에서 PTP 빠른 이벤트를 사용하려면 --summary_interval -4를 추가합니다.

    phc2sysOpts

    phc2sys 서비스에 대한 시스템 구성 옵션을 지정합니다. 이 필드가 비어 있으면 PTP Operator에서 phc2sys 서비스를 시작하지 않습니다. Intel Columbiaville 800 시리즈 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 이벤트가 트리거되기까지 걸리는 시간을 구성합니다. holdOverTimeout은 PTP 마스터 클록이 연결 해제될 때 PTP 클록 이벤트 상태가 FREERUN 으로 변경되기 전의 시간 값(초)입니다. maxOffsetThreshold 및 minOffsetThreshold 설정은 CLOCK_REALTIME ( phc2sys ) 또는 마스터 오프셋( ptp4l ) 값과 비교하는 나노초 단위의 오프셋 값을 구성합니다. ptp4l 또는 phc2sys 오프셋 값이 이 범위를 벗어나면 PTP 클록 상태가 FREERUN 으로 설정됩니다. 오프셋 값이 이 범위 내에 있으면 PTP 클록 상태가 LOCKED 로 설정됩니다.

    recommend[]

    profile이 노드에 적용되는 방법에 대한 규칙을 정의하는 하나 이상의 recommend 오브젝트 배열을 지정합니다.

    .recommend.profile

    프로필 섹션에 정의된 .recommend.profile 개체 이름을 지정합니다.

    .recommend.priority

    일반 시계의 경우 .recommend.priority를 0 으로 설정합니다.

    .recommend.match

    nodeLabel 또는 nodeName 값으로 .recommend.match 규칙을 지정합니다.

    .recommend.match.nodeLabel

    oc get nodes --show-labels 명령을 사용하여 노드 객체의 node.Labels 필드의 키로 nodeLabel을 설정합니다. 예를 들어, node-role.kubernetes.io/worker .

    .recommend.match.nodeName

    oc get nodes 명령을 사용하여 노드 객체의 node.Name 필드 값으로 nodeName을 설정합니다. 예를 들어, compute-1.example.com .

  2. 다음 명령을 실행하여 PtpConfig CR을 만듭니다. 

    $ oc create -f ordinary-clock-ptp-config.yaml
    Copy to Clipboard Toggle word wrap

검증

  1. PtpConfig 프로필이 노드에 적용되었는지 확인합니다.

    1. 다음 명령을 실행하여 openshift-ptp 네임스페이스에서 Pod 목록을 가져옵니다. 

      $ oc get pods -n openshift-ptp -o wide
      Copy to Clipboard Toggle word wrap

      출력 예

      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
      Copy to Clipboard Toggle word wrap

    2. 프로필이 올바른지 확인합니다. PtpConfig 프로필에 지정한 노드에 해당하는 linuxptp 데몬의 로그를 검사합니다. 다음 명령을 실행합니다. 

      $ oc logs linuxptp-daemon-4xkbb -n openshift-ptp -c linuxptp-daemon-container
      Copy to Clipboard Toggle word wrap

      출력 예

      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] ------------------------------------
      Copy to Clipboard Toggle word wrap

7.2.9.1. PTP 일반 클록 참조로 Intel Columbiaville E800 시리즈 NIC 사용
링크 복사

다음 표에서는 Intel Columbiaville E800 시리즈 NIC를 일반 클록으로 사용하기 위해 참조 PTP 구성에 해야 하는 변경 사항을 설명합니다. 클러스터에 적용하는 PtpConfig 사용자 정의 리소스(CR)에서 변경 작업을 수행합니다.

Expand
표 7.9. 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 메트릭을 생성합니다.

7.2.9.2. 듀얼 포트 NIC 중복성을 갖춘 일반 시계로 linuxptp 서비스 구성
링크 복사

PtpConfig 사용자 정의 리소스(CR) 객체를 생성하여 linuxptp 서비스( ptp4l , phc2sys )를 듀얼 포트 NIC 중복성을 갖춘 일반 클록으로 구성할 수 있습니다. 일반 클럭을 위한 듀얼 포트 NIC 구성에서 한 포트에 장애가 발생하면 대기 포트가 이를 대신하여 PTP 타이밍 동기화를 유지합니다.

중요

듀얼 포트 NIC 중복성을 갖춘 일반 시계로 linuxptp 서비스를 구성하는 것은 기술 미리 보기 기능에 불과합니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

사전 요구 사항

  • OpenShift CLI(oc)를 설치합니다.
  • cluster-admin 권한이 있는 사용자로 로그인합니다.
  • PTP Operator를 설치합니다.
  • 노드는 듀얼 포트 NIC가 있는 x86_64 아키텍처를 사용합니다.

프로세스

  1. 다음 PtpConfig CR을 만든 다음 YAML을 oc-dual-port-ptp-config.yaml 파일에 저장합니다.

    PTP 일반 클록 듀얼 포트 구성 예

    apiVersion: ptp.openshift.io/v1
kind: PtpConfig
metadata:
  name: ordinary-clock-1
  namespace: openshift-ptp
spec:
  profile:
  - name: oc-dual-port
    phc2sysOpts: -a -r -n 24 -N 8 -R 16 -u 0
    1 
    
    ptp4lConf: |-
    2 
    
      [ens3f2]
      masterOnly 0
      [ens3f3]
      masterOnly 0

      [global]
      #
      # Default Data Set
      #
      slaveOnly 1
    3 
    
#...
    Copy to Clipboard Toggle word wrap

    1
    ptp4l 서비스에 대한 시스템 구성 옵션을 지정합니다.
    2
    ptp4l 서비스에 대한 인터페이스 구성을 지정합니다. 이 예에서 ens3f2 및 ens3f3 인터페이스에 대해 masterOnly를 0으로 설정하면 ens3 인터페이스의 두 포트 모두 리더 또는 팔로워 클록으로 실행될 수 있습니다. 이 구성은 slaveOnly 1 사양과 결합하여 한 포트가 활성 일반 클록으로 작동하고 다른 포트가 Listening 포트 상태에서 대기 일반 클록으로 작동하도록 보장합니다.
    3
    ptp4l을 일반 시계로만 실행되도록 구성합니다.

  2. 다음 명령을 실행하여 PtpConfig CR을 만듭니다. 

    $ oc create -f oc-dual-port-ptp-config.yaml
    Copy to Clipboard Toggle word wrap

검증

  1. PtpConfig 프로필이 노드에 적용되었는지 확인합니다.

    1. 다음 명령을 실행하여 openshift-ptp 네임스페이스에서 Pod 목록을 가져옵니다. 

      $ oc get pods -n openshift-ptp -o wide
      Copy to Clipboard Toggle word wrap

      출력 예

      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
      Copy to Clipboard Toggle word wrap

    2. 프로필이 올바른지 확인합니다. PtpConfig 프로필에 지정한 노드에 해당하는 linuxptp 데몬의 로그를 검사합니다. 다음 명령을 실행합니다. 

      $ oc logs linuxptp-daemon-4xkbb -n openshift-ptp -c linuxptp-daemon-container
      Copy to Clipboard Toggle word wrap

      출력 예

      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: oc-dual-port
I1115 09:41:17.117616 4143292 daemon.go:102] Interface: ens787f1
I1115 09:41:17.117620 4143292 daemon.go:102] Ptp4lOpts: -2 --summary_interval -4
I1115 09:41:17.117623 4143292 daemon.go:102] Phc2sysOpts: -a -r -n 24 -N 8 -R 16 -u 0
I1115 09:41:17.117626 4143292 daemon.go:116] ------------------------------------
      Copy to Clipboard Toggle word wrap

7.2.10. PTP 하드웨어에 대한 FIFO 우선 순위 스케줄링 구성
링크 복사

낮은 지연 시간이 필요한 통신사나 기타 배포 유형에서 PTP 데몬 스레드는 나머지 인프라 구성 요소와 함께 제한된 CPU 공간에서 실행됩니다. 기본적으로 PTP 스레드는 SCHED_OTHER 정책에 따라 실행됩니다. 높은 부하가 걸리면 이러한 스레드는 오류 없는 작업에 필요한 스케줄링 지연 시간을 얻지 못할 수 있습니다.

잠재적인 스케줄링 지연 오류를 완화하기 위해 PTP Operator linuxptp 서비스를 구성하여 스레드가 SCHED_FIFO 정책으로 실행되도록 할 수 있습니다. PtpConfig CR에 대해 SCHED_FIFO가 설정된 경우 ptp4l 과 phc2sys 는 PtpConfig CR의 ptpSchedulingPriority 필드에 의해 설정된 우선 순위로 chrt 아래의 부모 컨테이너에서 실행됩니다.

참고

ptpSchedulingPolicy 설정은 선택 사항이며, 지연 오류가 발생하는 경우에만 필요합니다.

프로세스

  1. PtpConfig CR 프로필을 편집하세요. 

    $ oc edit PtpConfig -n openshift-ptp
    Copy to Clipboard Toggle word wrap

  2. 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
    Copy to Clipboard Toggle word wrap
    1
    ptp4l 및 phc2sys 프로세스에 대한 스케줄링 정책. FIFO 스케줄링을 지원하는 시스템에서 SCHED_FIFO를 사용하세요.
    2
    필수 항목입니다. ptp4l 및 phc2sys 프로세스에 대한 FIFO 우선 순위를 구성하는 데 사용되는 정수 값 1~65를 설정합니다.
  3. 저장하고 종료하여 PtpConfig CR에 변경 사항을 적용합니다.

검증

  1. PtpConfig CR이 적용된 linuxptp-daemon 포드와 해당 노드의 이름을 가져옵니다. 

    $ oc get pods -n openshift-ptp -o wide
    Copy to Clipboard Toggle word wrap

    출력 예

    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
    Copy to Clipboard Toggle word wrap

  2. ptp4l 프로세스가 업데이트된 chrt FIFO 우선 순위로 실행 중인지 확인하세요. 

    $ oc -n openshift-ptp logs linuxptp-daemon-lgm55 -c linuxptp-daemon-container|grep chrt
    Copy to Clipboard Toggle word wrap

    출력 예

    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
    Copy to Clipboard Toggle word wrap

7.2.11. linuxptp 서비스에 대한 로그 필터링 구성
링크 복사

linuxptp 데몬은 디버깅 목적으로 사용할 수 있는 로그를 생성합니다. 저장 용량이 제한된 통신사나 기타 배포 유형의 경우, 이러한 로그는 저장 수요를 증가시킬 수 있습니다.

로그 메시지 수를 줄이려면 PtpConfig 사용자 정의 리소스(CR)를 구성하여 마스터 오프셋 값을 보고하는 로그 메시지를 제외할 수 있습니다. 마스터 오프셋 로그 메시지는 현재 노드의 클록과 마스터 클록의 차이를 나노초 단위로 보고합니다.

사전 요구 사항

  • OpenShift CLI(oc)를 설치합니다.
  • cluster-admin 권한이 있는 사용자로 로그인합니다.
  • PTP Operator를 설치합니다.

프로세스

  1. PtpConfig CR을 편집하세요: 

    $ oc edit PtpConfig -n openshift-ptp
    Copy to Clipboard Toggle word wrap

  2. 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"
    Copy to Clipboard Toggle word wrap
    참고

    디버깅 목적으로 이 사양을 False 로 되돌려 마스터 오프셋 메시지를 포함할 수 있습니다.

  3. 저장하고 종료하여 PtpConfig CR에 변경 사항을 적용합니다.

검증

  1. PtpConfig CR이 적용된 linuxptp-daemon 포드와 해당 노드의 이름을 가져옵니다. 

    $ oc get pods -n openshift-ptp -o wide
    Copy to Clipboard Toggle word wrap

    출력 예

    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
    Copy to Clipboard Toggle word wrap

  2. 다음 명령을 실행하여 마스터 오프셋 메시지가 로그에서 제외되었는지 확인하세요. 

    $ oc -n openshift-ptp logs <linux_daemon_container> -c linuxptp-daemon-container | grep "master offset"
    1
    Copy to Clipboard Toggle word wrap
    1
    <linux_daemon_container>는 linuxptp-daemon pod의 이름입니다(예: linuxptp-daemon-gmv2n) .

    logReduce 사양을 구성할 때 이 명령은 linuxptp 데몬의 로그에서 마스터 오프셋 의 인스턴스를 보고하지 않습니다.

7.2.12. 일반적인 PTP Operator 문제 해결
링크 복사

다음 단계를 수행하여 PTP Operator의 일반적인 문제를 해결합니다.

사전 요구 사항

  • OpenShift Container Platform CLI (oc)를 설치합니다.
  • cluster-admin 권한이 있는 사용자로 로그인합니다.
  • PTP를 지원하는 호스트가 있는 베어 메탈 클러스터에 PTP Operator를 설치합니다.

프로세스

  1. 구성된 노드를 위해 Operator 및 Operand가 클러스터에 성공적으로 배포되었는지 확인합니다. 

    $ oc get pods -n openshift-ptp -o wide
    Copy to Clipboard Toggle word wrap

    출력 예

    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
    Copy to Clipboard Toggle word wrap

    참고

    PTP 빠른 이벤트 버스가 활성화되면 준비된 linuxptp-daemon Pod 수는 3/3가 됩니다. PTP 빠른 이벤트 버스가 활성화되지 않으면 2/2가 표시됩니다.

  2. 지원되는 하드웨어가 클러스터에 있는지 확인합니다. 

    $ oc -n openshift-ptp get nodeptpdevices.ptp.openshift.io
    Copy to Clipboard Toggle word wrap

    출력 예

    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
    Copy to Clipboard Toggle word wrap

  3. 노드에 사용 가능한 PTP 네트워크 인터페이스를 확인합니다. 

    $ oc -n openshift-ptp get nodeptpdevices.ptp.openshift.io <node_name> -o yaml
    Copy to Clipboard Toggle word wrap

    다음과 같습니다.

    <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
    Copy to Clipboard Toggle word wrap

  4. 해당 노드의 linuxptp-daemon Pod에 액세스하여 PTP 인터페이스가 기본 클록에 성공적으로 동기화되었는지 확인합니다.

    1. 다음 명령을 실행하여 linuxptp-daemon Pod의 이름과 문제를 해결하려는 해당 노드를 가져옵니다. 

      $ oc get pods -n openshift-ptp -o wide
      Copy to Clipboard Toggle word wrap

      출력 예

      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
      Copy to Clipboard Toggle word wrap

    2. 필수 linuxptp-daemon 컨테이너로의 원격 쉘: 

      $ oc rsh -n openshift-ptp -c linuxptp-daemon-container <linux_daemon_container>
      Copy to Clipboard Toggle word wrap

      다음과 같습니다.

      <linux_daemon_container>
      진단할 컨테이너입니다 (예: linuxptp-daemon-lmvgn).

    3. linuxptp-daemon 컨테이너에 대한 원격 쉘 연결에서 PTP 관리 클라이언트(pmc) 툴을 사용하여 네트워크 인터페이스를 진단합니다. 다음 pmc 명령을 실행하여 PTP 장치의 동기화 상태를 확인합니다(예: ptp4l ). 

      # pmc -u -f /var/run/ptp4l.0.config -b 0 'GET PORT_DATA_SET'
      Copy to Clipboard Toggle word wrap

      노드가 기본 클록에 성공적으로 동기화되었을 때의 출력 예

      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
      Copy to Clipboard Toggle word wrap

  5. GNSS 소스 그랜드마스터 클록의 경우 다음 명령을 실행하여 트리 내 NIC ice 드라이버가 올바른지 확인합니다. 예: 

    $ oc rsh -n openshift-ptp -c linuxptp-daemon-container linuxptp-daemon-74m2g ethtool -i ens7f0
    Copy to Clipboard Toggle word wrap

    출력 예

    driver: ice
version: 5.14.0-356.bz2232515.el9.x86_64
firmware-version: 4.20 0x8001778b 1.3346.0
    Copy to Clipboard Toggle word wrap

  6. GNSS 소스 그랜드마스터 시계의 경우, linuxptp-daemon 컨테이너가 GNSS 안테나로부터 신호를 수신하고 있는지 확인하세요. 컨테이너가 GNSS 신호를 수신하지 못하면 /dev/gnss0 파일이 채워지지 않습니다. 확인하려면 다음 명령을 실행하세요. 

    $ oc rsh -n openshift-ptp -c linuxptp-daemon-container linuxptp-daemon-jnz6r cat /dev/gnss0
    Copy to Clipboard Toggle word wrap

    출력 예

    $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
    Copy to Clipboard Toggle word wrap

7.2.13. Intel 800 시리즈 NIC의 CGU에 대한 DPLL 펌웨어 버전 가져오기
링크 복사

Intel 800 시리즈 NIC의 CGU(클럭 생성 장치)에 대한 DPLL(디지털 위상 잠금 루프) 펌웨어 버전을 얻으려면 클러스터 노드에 디버그 셸을 열고 NIC 하드웨어를 쿼리하면 됩니다.

사전 요구 사항

  • OpenShift CLI(oc)가 설치되어 있습니다.
  • cluster-admin 권한이 있는 사용자로 로그인했습니다.
  • 클러스터 호스트에 Intel 800 시리즈 NIC를 설치했습니다.
  • PTP를 지원하는 호스트가 있는 베어 메탈 클러스터에 PTP 운영자를 설치했습니다.

프로세스

  1. 다음 명령을 실행하여 디버그 포드를 시작합니다. 

    $ oc debug node/<node_name>
    Copy to Clipboard Toggle word wrap

    다음과 같습니다.

    <node_name>
    Intel 800 시리즈 NIC를 설치한 노드입니다.

  2. devlink 도구와 NIC가 설치된 버스 및 장치 이름을 사용하여 NIC의 CGU 펌웨어 버전을 확인합니다. 예를 들어 다음 명령을 실행합니다. 

    sh-4.4# devlink dev info <bus_name>/<device_name> | grep cgu
    Copy to Clipboard Toggle word wrap

    다음과 같습니다.

    <bus_name>
    NIC가 설치되는 버스입니다. 예를 들어, pci .
    <device_name>
    NIC 장치 이름입니다. 예: 10.0.0.0/16

    출력 예

    cgu.id 36
    1 
    
fw.cgu 8032.16973825.6021
    2
    Copy to Clipboard Toggle word wrap

    1
    CGU 하드웨어 개정 번호
    2
    CGU에서 실행 중인 DPLL 펌웨어 버전은 6201 이고, DPLL 모델은 8032 입니다. 문자열 16973825 는 DPLL 펌웨어 버전( 1.3.0.1 )의 바이너리 버전을 축약해서 표현한 것입니다.
    참고

    펌웨어 버전은 버전 번호의 각 부분에 대해 선행 니블과 3옥텟으로 구성됩니다. 숫자 16973825를 이진수로 나타내면 0001 0000 0011 0000 0000 0000 0001 입니다. 이진값을 사용하여 펌웨어 버전을 디코딩합니다. 예를 들면 다음과 같습니다.

    Expand
    표 7.10. DPLL 펌웨어 버전
    이진 부분10진수 값

    0001

    1

    0000 0011

    3

    0000 0000

    0

    0000 0001

    1

7.2.14. PTP 운영자 데이터 수집
링크 복사

oc adm must-gather 명령을 사용하면 PTP Operator와 관련된 기능 및 객체를 포함하여 클러스터에 대한 정보를 수집할 수 있습니다.

사전 요구 사항

  • cluster-admin 역할의 사용자로 클러스터에 액세스할 수 있어야 합니다.
  • OpenShift CLI(oc)가 설치되어 있습니다.
  • PTP 운영자를 설치했습니다.

프로세스

  • must-gather 로 PTP 운영자 데이터를 수집하려면 PTP 운영자 must-gather 이미지를 지정해야 합니다. 

    $ oc adm must-gather --image=registry.redhat.io/openshift4/ptp-must-gather-rhel9:v4.19
    Copy to Clipboard Toggle word wrap
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat