16.2. 정확한 시간 프로토콜 장치 구성
PTP Operator는 NodePtpDevice.ptp.openshift.io
CRD(custom resource definition)를 OpenShift Container Platform에 추가합니다.
설치 시 PTP Operator는 각 노드에서 PTP(Precision Time Protocol) 가능 네트워크 장치를 클러스터에서 검색합니다. Operator는 호환되는 PTP 가능 네트워크 장치를 제공하는 각 노드에 대해 NodePtpDevice
CR(사용자 정의 리소스) 오브젝트를 생성하고 업데이트합니다.
기본 제공 PTP 기능이 있는 NIC(네트워크 인터페이스 컨트롤러) 하드웨어에는 장치별 구성이 필요한 경우가 있습니다. PtpConfig
CR(사용자 정의 리소스)에서 플러그인을 구성하여 PTP Operator에서 지원되는 하드웨어에 하드웨어별 NIC 기능을 사용할 수 있습니다. linuxptp-daemon
서비스는 plugin
스탠자에서 named 매개 변수를 사용하여 특정 하드웨어 구성에 따라 linuxptp
프로세스 ptp4l
및 phc2sys
를 시작합니다.
OpenShift Container Platform 4.17에서 Intel E810 NIC는 PtpConfig
플러그인에서 지원됩니다.
16.2.1. CLI를 사용하여 PTP Operator 설치
클러스터 관리자는 CLI를 사용하여 Operator를 설치할 수 있습니다.
사전 요구 사항
- PTP를 지원하는 하드웨어가 있는 노드로 베어 메탈 하드웨어에 설치된 클러스터
-
OpenShift CLI(
oc
)를 설치합니다. -
cluster-admin
권한이 있는 사용자로 로그인합니다.
프로세스
PTP Operator의 네임스페이스를 생성합니다.
다음 YAML을
ptp-namespace.yaml
파일에 저장합니다.apiVersion: v1 kind: Namespace metadata: name: openshift-ptp annotations: workload.openshift.io/allowed: management labels: name: openshift-ptp openshift.io/cluster-monitoring: "true"
Namespace
CR을 생성합니다.$ oc create -f ptp-namespace.yaml
PTP Operator에 대한 Operator 그룹을 생성합니다.
다음 YAML을
ptp-operatorgroup.yaml
파일에 저장합니다.apiVersion: operators.coreos.com/v1 kind: OperatorGroup metadata: name: ptp-operators namespace: openshift-ptp spec: targetNamespaces: - openshift-ptp
OperatorGroup
CR을 생성합니다.$ oc create -f ptp-operatorgroup.yaml
PTP Operator에 등록합니다.
다음 YAML을
ptp-sub.yaml
파일에 저장합니다.apiVersion: operators.coreos.com/v1alpha1 kind: Subscription metadata: name: ptp-operator-subscription namespace: openshift-ptp spec: channel: "stable" name: ptp-operator source: redhat-operators sourceNamespace: openshift-marketplace
Subscription
CR을 생성합니다.$ oc create -f ptp-sub.yaml
Operator가 설치되었는지 확인하려면 다음 명령을 입력합니다.
$ oc get csv -n openshift-ptp -o custom-columns=Name:.metadata.name,Phase:.status.phase
출력 예
Name Phase 4.17.0-202301261535 Succeeded
16.2.2. 웹 콘솔을 사용하여 PTP Operator 설치
클러스터 관리자는 웹 콘솔을 사용하여 PTP Operator를 설치할 수 있습니다.
이전 섹션에서 언급한 것처럼 네임스페이스 및 Operator group을 생성해야 합니다.
프로세스
OpenShift Container Platform 웹 콘솔을 사용하여 PTP Operator를 설치합니다.
-
OpenShift Container Platform 웹 콘솔에서 Operator
OperatorHub를 클릭합니다. - 사용 가능한 Operator 목록에서 PTP Operator를 선택한 다음 설치를 클릭합니다.
- Operator 설치 페이지의 클러스터의 특정 네임스페이스에서 openshift-ptp를 선택합니다. 그런 다음, 설치를 클릭합니다.
-
OpenShift Container Platform 웹 콘솔에서 Operator
선택 사항: PTP Operator가 설치되었는지 확인합니다.
-
Operator
설치된 Operator 페이지로 전환합니다. PTP Operator가 openshift-ptp 프로젝트에 InstallSucceeded 상태로 나열되어 있는지 확인합니다.
참고설치 중에 Operator는 실패 상태를 표시할 수 있습니다. 나중에 InstallSucceeded 메시지와 함께 설치에 성공하면 이 실패 메시지를 무시할 수 있습니다.
Operator가 설치된 것으로 나타나지 않으면 다음과 같이 추가 문제 해결을 수행합니다.
-
Operator
설치된 Operator 페이지로 이동하고 Operator 서브스크립션 및 설치 계획 탭의 상태에 장애나 오류가 있는지 검사합니다. -
Workloads
Pod 페이지로 이동하여 openshift-ptp
프로젝트에서 Pod 로그를 확인합니다.
-
Operator
-
Operator
16.2.3. 클러스터에서 PTP 가능 네트워크 장치 검색
클러스터에 존재하는 PTP 가능 네트워크 장치를 식별하여 구성할 수 있습니다.
전제 조건
- PTP Operator를 설치했습니다.
프로세스
클러스터에서 PTP 가능 네트워크 장치의 전체 목록을 반환하려면 다음 명령을 실행합니다.
$ oc get NodePtpDevice -n openshift-ptp -o yaml
출력 예
apiVersion: v1 items: - apiVersion: ptp.openshift.io/v1 kind: NodePtpDevice metadata: creationTimestamp: "2022-01-27T15:16:28Z" generation: 1 name: dev-worker-0 1 namespace: openshift-ptp resourceVersion: "6538103" uid: d42fc9ad-bcbf-4590-b6d8-b676c642781a spec: {} status: devices: 2 - name: eno1 - name: eno2 - name: eno3 - name: eno4 - name: enp5s0f0 - name: enp5s0f1 ...
16.2.4. linuxptp 서비스를 할 마스터 클록으로 구성
호스트 NIC를 구성하는 PtpConfig
CR(사용자 정의 리소스)을 생성하여 linuxptp
서비스(ptp4l
,phc2sys
,ts2phc
)를 마스터 클록(T-GM)으로 구성할 수 있습니다.
ts2phc
유틸리티를 사용하면 시스템 시계를 PTP 할 마스터 클록과 동기화하여 노드가 PTP 일반 클럭 및 경계 클록으로 정밀한 클럭을 스트리밍할 수 있습니다.
다음 예제 PtpConfig
CR을 기반으로 하여 Intel Westport Channel E810-XXVDA4T 네트워크 인터페이스의 linuxptp
서비스를 T-GM으로 구성합니다.
PTP 빠른 이벤트를 구성하려면 ptp4lOpts
,ptp4lConf
및 ptpClockThreshold
에 적절한 값을 설정합니다. ptpClockThreshold
는 이벤트가 활성화된 경우에만 사용됩니다. 자세한 내용은 " PTP 빠른 이벤트 알림 게시자 구성"을 참조하십시오.
사전 요구 사항
- 프로덕션 환경의 T-GM 클록의 경우 베어 메탈 클러스터 호스트에 Intel E810 Westport 채널 NIC를 설치합니다.
-
OpenShift CLI(
oc
)를 설치합니다. -
cluster-admin
권한이 있는 사용자로 로그인합니다. - PTP Operator를 설치합니다.
프로세스
PtpConfig
CR을 생성합니다. 예를 들면 다음과 같습니다.요구 사항에 따라 배포에 다음 T-GM 구성 중 하나를 사용하십시오. YAML을
grandmaster-clock-ptp-config.yaml
파일에 저장합니다.예 16.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 -w -N 8 -R 16 -s $iface_master -n 24 ptpSchedulingPolicy: SCHED_FIFO ptpSchedulingPriority: 10 ptpSettings: logReduce: "true" plugins: e810: enableDefaultConfig: false settings: LocalMaxHoldoverOffSet: 1500 LocalHoldoverTimeout: 14400 MaxInSpecOffset: 100 pins: $e810_pins # "$iface_master": # "U.FL2": "0 2" # "U.FL1": "0 1" # "SMA2": "0 2" # "SMA1": "0 1" ublxCmds: - args: #ubxtool -P 29.20 -z CFG-HW-ANT_CFG_VOLTCTRL,1 - "-P" - "29.20" - "-z" - "CFG-HW-ANT_CFG_VOLTCTRL,1" reportOutput: false - args: #ubxtool -P 29.20 -e GPS - "-P" - "29.20" - "-e" - "GPS" reportOutput: false - args: #ubxtool -P 29.20 -d Galileo - "-P" - "29.20" - "-d" - "Galileo" reportOutput: false - args: #ubxtool -P 29.20 -d GLONASS - "-P" - "29.20" - "-d" - "GLONASS" reportOutput: false - args: #ubxtool -P 29.20 -d BeiDou - "-P" - "29.20" - "-d" - "BeiDou" reportOutput: false - args: #ubxtool -P 29.20 -d SBAS - "-P" - "29.20" - "-d" - "SBAS" reportOutput: false - args: #ubxtool -P 29.20 -t -w 5 -v 1 -e SURVEYIN,600,50000 - "-P" - "29.20" - "-t" - "-w" - "5" - "-v" - "1" - "-e" - "SURVEYIN,600,50000" reportOutput: true - args: #ubxtool -P 29.20 -p MON-HW - "-P" - "29.20" - "-p" - "MON-HW" reportOutput: true - 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"
참고E810 Westport Channel NIC의 경우
ts2phc.nmea_serialport
값을/dev/gnss0
로 설정합니다.다음 명령을 실행하여 CR을 생성합니다.
$ oc create -f grandmaster-clock-ptp-config.yaml
검증
PtpConfig
프로필이 노드에 적용되었는지 확인합니다.다음 명령을 실행하여
openshift-ptp
네임스페이스에서 Pod 목록을 가져옵니다.$ oc get pods -n openshift-ptp -o wide
출력 예
NAME READY STATUS RESTARTS AGE IP NODE linuxptp-daemon-74m2g 3/3 Running 3 4d15h 10.16.230.7 compute-1.example.com ptp-operator-5f4f48d7c-x7zkf 1/1 Running 1 4d15h 10.128.1.145 compute-1.example.com
프로필이 올바른지 확인합니다.
PtpConfig
프로필에 지정한 노드에 해당하는linuxptp
데몬의 로그를 검사합니다. 다음 명령을 실행합니다.$ oc logs linuxptp-daemon-74m2g -n openshift-ptp -c linuxptp-daemon-container
출력 예
ts2phc[94980.334]: [ts2phc.0.config] nmea delay: 98690975 ns ts2phc[94980.334]: [ts2phc.0.config] ens3f0 extts index 0 at 1676577329.999999999 corr 0 src 1676577330.901342528 diff -1 ts2phc[94980.334]: [ts2phc.0.config] ens3f0 master offset -1 s2 freq -1 ts2phc[94980.441]: [ts2phc.0.config] nmea sentence: GNRMC,195453.00,A,4233.24427,N,07126.64420,W,0.008,,160223,,,A,V phc2sys[94980.450]: [ptp4l.0.config] CLOCK_REALTIME phc offset 943 s2 freq -89604 delay 504 phc2sys[94980.512]: [ptp4l.0.config] CLOCK_REALTIME phc offset 1000 s2 freq -89264 delay 474
16.2.5. linuxptp 서비스를 듀얼 E810 NIC의 할마스터 클록으로 구성
호스트 NIC를 구성하는 PtpConfig
CR(사용자 정의 리소스)을 생성하여 linuxptp
서비스(ptp4l
,phc2sys
,ts2phc
)를 이중 E810 NIC의 할마스터 클럭(T-GM)으로 구성할 수 있습니다.
다음 듀얼 E810 NIC의 경우 linuxptp
서비스를 T-GM으로 구성할 수 있습니다.
- Intel E810-XXVDA4T Westport 채널 NIC
- Intel E810-CQDA2T Logan Beach NIC
분산 RAN(D-RAN) 사용 사례의 경우 다음과 같이 듀얼 NIC에 대한 PTP를 구성할 수 있습니다.
- NIC 1은 글로벌 탐색 Satellite 시스템(GNSS) 시간 소스와 동기화됩니다.
-
NIC 2는 NIC가 제공하는 1PPS 타이밍 출력과 동기화됩니다. 이 구성은
PtpConfig
CR의 PTP 하드웨어 플러그인에서 제공합니다.
듀얼 NIC PTP T-GM 구성에서는 ptp4l
의 단일 인스턴스와 각 NIC에 대해 하나씩 두 개의 ts2phc
인스턴스를 보고하는 하나의 ts2phc
프로세스를 사용합니다. 호스트 시스템 클록은 GNSS 시간 소스에 연결된 NIC에서 동기화됩니다.
다음 예제 PtpConfig
CR을 기반으로 하여 이중 Intel E810 네트워크 인터페이스의 경우 linuxptp
서비스를 T-GM으로 구성합니다.
PTP 빠른 이벤트를 구성하려면 ptp4lOpts
,ptp4lConf
및 ptpClockThreshold
에 적절한 값을 설정합니다. ptpClockThreshold
는 이벤트가 활성화된 경우에만 사용됩니다. 자세한 내용은 " PTP 빠른 이벤트 알림 게시자 구성"을 참조하십시오.
사전 요구 사항
- 프로덕션 환경의 T-GM 클록의 경우 베어 메탈 클러스터 호스트에 두 개의 Intel E810 NIC를 설치합니다.
-
OpenShift CLI(
oc
)를 설치합니다. -
cluster-admin
권한이 있는 사용자로 로그인합니다. - PTP Operator를 설치합니다.
프로세스
PtpConfig
CR을 생성합니다. 예를 들면 다음과 같습니다.다음 YAML을
grandmaster-clock-ptp-config-dual-nics.yaml
파일에 저장합니다.예 16.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 -w -N 8 -R 16 -s $iface_nic1 -n 24 ptpSchedulingPolicy: SCHED_FIFO ptpSchedulingPriority: 10 ptpSettings: logReduce: "true" plugins: e810: enableDefaultConfig: false settings: LocalMaxHoldoverOffSet: 1500 LocalHoldoverTimeout: 14400 MaxInSpecOffset: 100 pins: $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"
참고ts2phc.nmea_serialport
의 값을/dev/gnss0
로 설정합니다.다음 명령을 실행하여 CR을 생성합니다.
$ oc create -f grandmaster-clock-ptp-config-dual-nics.yaml
검증
PtpConfig
프로필이 노드에 적용되었는지 확인합니다.다음 명령을 실행하여
openshift-ptp
네임스페이스에서 Pod 목록을 가져옵니다.$ oc get pods -n openshift-ptp -o wide
출력 예
NAME READY STATUS RESTARTS AGE IP NODE linuxptp-daemon-74m2g 3/3 Running 3 4d15h 10.16.230.7 compute-1.example.com ptp-operator-5f4f48d7c-x7zkf 1/1 Running 1 4d15h 10.128.1.145 compute-1.example.com
프로필이 올바른지 확인합니다.
PtpConfig
프로필에 지정한 노드에 해당하는linuxptp
데몬의 로그를 검사합니다. 다음 명령을 실행합니다.$ oc logs linuxptp-daemon-74m2g -n openshift-ptp -c linuxptp-daemon-container
출력 예
ts2phc[509863.660]: [ts2phc.0.config] nmea delay: 347527248 ns ts2phc[509863.660]: [ts2phc.0.config] ens2f0 extts index 0 at 1705516553.000000000 corr 0 src 1705516553.652499081 diff 0 ts2phc[509863.660]: [ts2phc.0.config] ens2f0 master offset 0 s2 freq -0 I0117 18:35:16.000146 1633226 stats.go:57] state updated for ts2phc =s2 I0117 18:35:16.000163 1633226 event.go:417] dpll State s2, gnss State s2, tsphc state s2, gm state s2, ts2phc[1705516516]:[ts2phc.0.config] ens2f0 nmea_status 1 offset 0 s2 GM[1705516516]:[ts2phc.0.config] ens2f0 T-GM-STATUS s2 ts2phc[509863.677]: [ts2phc.0.config] ens7f0 extts index 0 at 1705516553.000000010 corr -10 src 1705516553.652499081 diff 0 ts2phc[509863.677]: [ts2phc.0.config] ens7f0 master offset 0 s2 freq -0 I0117 18:35:16.016597 1633226 stats.go:57] state updated for ts2phc =s2 phc2sys[509863.719]: [ptp4l.0.config] CLOCK_REALTIME phc offset -6 s2 freq +15441 delay 510 phc2sys[509863.782]: [ptp4l.0.config] CLOCK_REALTIME phc offset -7 s2 freq +15438 delay 502
추가 리소스
16.2.5.1. Grandmaster 클럭 PtpConfig 구성 참조
다음 참조 정보는 linuxptp
서비스(ptp4l
,phc2sys
,ts2phc
)를 마스터 클록으로 구성하는 PtpConfig
CR(사용자 정의 리소스)의 구성 옵션을 설명합니다.
PtpConfig CR 필드 | 설명 |
---|---|
|
마스터 클록 작업에 대한 NIC를 구성하는
플러그인 메커니즘을 사용하면 PTP Operator가 자동화된 하드웨어 구성을 수행할 수 있습니다. Intel Westport Channel NIC 또는 Intel Logan Beach NIC의 경우 |
|
|
|
|
| 데이터를 삭제하기 전에 발신자로부터 전송(TX) 타임스탬프를 대기할 최대 시간(TX)을 지정합니다. |
| JBOD 경계 클럭 시간 지연 값을 지정합니다. 이 값은 네트워크 시간 장치 간에 전달되는 시간 값을 수정하는 데 사용됩니다. |
|
참고
여기에 나열된 네트워크 인터페이스가 grandmaster로 구성되어 있고 |
|
|
|
|
|
선택 사항: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
16.2.5.2. Grandmaster 클럭 클래스 동기화 상태 참조
다음 표는 PTP 할 마스터 클록 (T-GM) gm.ClockClass
상태를 설명합니다. 클럭 클래스는 PRTC(Basic Reference Time Clock) 또는 기타 타이밍 소스와 관련하여 정확성 및 안정성을 기반으로 T-GM 시계를 분류합니다.
홀드오버 사양은 PTP 클럭이 기본 시간 소스에서 업데이트를 수신하지 않고도 동기화를 유지할 수 있는 시간입니다.
클럭 클래스 상태 | 설명 |
---|---|
|
T-GM 클록은 |
|
T-GM 클록은 |
|
T-GM 시계는 |
|
T-GM 시계는 |
자세한 내용은 "상시/시간 추적 정보", ITU-T G.8275.1/Y.1369.1 권장 사항을 참조하십시오.
16.2.5.3. Intel E810 NIC 하드웨어 구성 참조
이 정보를 사용하여 Intel E810 하드웨어 플러그인을 사용하여 E810 네트워크 인터페이스를 PTP 마스터 클록으로 구성하는 방법을 파악합니다. 하드웨어 핀 구성은 네트워크 인터페이스가 시스템의 다른 구성 요소 및 장치와 상호 작용하는 방식을 결정합니다. Intel E810 NIC에는 외부 1PPS 신호를 위한 네 개의 커넥터가 있습니다: SMA1
,SMA2
,U.FL1
및 U.FL2
.
하드웨어 핀 | 권장 설정 | 설명 |
---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
SMA1
및 U.FL1
커넥터는 채널 1을 공유합니다. SMA2
및 U.FL2
커넥터는 채널 2를 공유합니다.
spec.profile.plugins.e810.ublxCmds
매개변수를 설정하여 PtpConfig
CR(사용자 정의 리소스)에서 GNSS 시계를 구성합니다. 이러한 ublxCmds
스탠자 각각 ubxtool
명령을 사용하여 호스트 NIC에 적용되는 구성에 해당합니다. 예를 들면 다음과 같습니다.
ublxCmds: - args: #ubxtool -P 29.20 -z CFG-HW-ANT_CFG_VOLTCTRL,1 - "-P" - "29.20" - "-z" - "CFG-HW-ANT_CFG_VOLTCTRL,1" reportOutput: false
다음 표에서는 동일한 ubxtool
명령을 설명합니다.
ubxtool 명령 | 설명 |
---|---|
|
Anchontion control을 사용할 수 있습니다. |
| Angon이 GPS 신호를 수신할 수 있도록 합니다. |
| Galileo GPS satellite에서 신호를 수신하도록 Angalileo GPS Satellite를 구성합니다. |
| GLONASS GPS Satellite에서 신호를 수신하지 못하게 합니다. |
| 마진이 BeiDou GPS Satellite에서 신호를 수신하지 못하도록 비활성화합니다. |
| SBAS GPS Satellite에서 신호를 수신하지 못하게 합니다. |
| 초기 위치 추정을 개선하도록 GNSS 수신기 설문 조사 프로세스를 구성합니다. 최적의 결과를 얻으려면 최대 24 시간이 걸릴 수 있습니다. |
| 하드웨어의 자동화된 단일 검사를 실행하고 NIC 상태 및 구성 설정에 대해 보고합니다. |
E810 플러그인은 다음 인터페이스를 구현합니다.
인터페이스 | 설명 |
---|---|
|
|
|
PTP 프로세스를 시작하고 |
|
|
E810 플러그인에는 다음과 같은 구조 및 변수가 있습니다.
struct | 설명 |
---|---|
| 부울 플래그 및 네트워크 장치 핀 맵을 포함하여 E810 플러그인의 옵션을 나타냅니다. |
|
부울 플래그와 명령 인수에 대한 문자열 슬라이스를 사용하여 |
| 플러그인 실행 중에 사용되는 플러그인별 데이터를 보유합니다. |
16.2.5.4. Dual E810 NIC 구성 참조
이 정보를 사용하여 Intel E810 하드웨어 플러그인을 사용하여 E810 네트워크 인터페이스를 PTP 할 마스터 클록(T-GM)으로 구성하는 방법을 파악합니다.
듀얼 NIC 클러스터 호스트를 구성하기 전에 1PPS faceplace 연결을 사용하여 두 NIC를 SMA1 케이블과 연결해야 합니다.
듀얼 NIC T-GM을 구성할 때 SMA1 연결 포트를 사용하여 NIC를 연결할 때 발생하는 1PPS 신호 지연을 보완해야 합니다. 케이블 길이, 주변 온도 및 구성 요소 및 제조 허용 오차와 같은 다양한 요인은 신호 지연에 영향을 미칠 수 있습니다. 지연을 보완하려면 신호 지연을 오프셋하는 데 사용하는 특정 값을 계산해야 합니다.
PtpConfig 필드 | 설명 |
---|---|
| PTP Operator E810 하드웨어 플러그인을 사용하여 E810 하드웨어 핀을 구성합니다.
|
|
|
|
|
16.2.6. PTP grandmaster 클록에 대한 동적 윤초 처리 구성
PTP Operator 컨테이너 이미지에는 릴리스 시 사용할 수 있는 최신 leap-seconds.list
파일이 포함되어 있습니다. PTP Operator는 GPS(Global positioning System) 발표를 사용하여 윤초 파일을 자동으로 업데이트하도록 구성할 수 있습니다.
윤초 정보는 openshift-ptp
네임스페이스에 leap-configmap
이라는 자동으로 생성된 ConfigMap
리소스에 저장됩니다. PTP Operator는 ts2phc
프로세스에서 액세스할 수 있는 linuxptp-daemon
Pod에 leap-configmap
리소스를 볼륨으로 마운트합니다.
GPS satellite에서 새 윤초 데이터를 브로드캐스트하는 경우 PTP Operator는 leap-configmap
리소스를 새 데이터로 업데이트합니다. ts2phc
프로세스는 변경 사항을 자동으로 선택합니다.
다음 절차는 참조로 제공됩니다. PTP Operator의 4.17 버전은 기본적으로 자동 윤초 관리를 활성화합니다.
사전 요구 사항
-
OpenShift CLI(
oc
)가 설치되어 있습니다. -
cluster-admin
권한이 있는 사용자로 로그인했습니다. - PTP Operator를 설치하고 클러스터에 PTP 할 마스터 클럭 (T-GM)을 구성했습니다.
프로세스
PtpConfig
CR의phc2sysOpts
섹션에서 자동 윤초 처리를 구성합니다. 다음 옵션을 설정합니다.phc2sysOpts: -r -u 0 -m -w -N 8 -R 16 -S 2 -s ens2f0 -n 24 1
- 1
ptp4l
이 자체 동기화 프로세스를 시작하기 전에 시스템 하드웨어 클록을 동기화할 때까지phc2sys
를 강제로 대기하도록 설정합니다.
참고이전에는 T-GM에서 과거 윤초를 고려하여
phc2sys
구성(-O -37
)에 오프셋 조정이 필요했습니다. 더 이상 필요하지 않습니다.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"
검증
구성된 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
출력 예
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
PTP Operator에서
leap-configmap
리소스가 성공적으로 생성되었으며 최신 버전의 leap-seconds.list 를 사용하여 최신 상태인지 확인합니다. 다음 명령을 실행합니다.$ oc -n openshift-ptp get configmap leap-configmap -o jsonpath='{.data.<node_name>}' 1
- 1
- PTP T-GM 시계를 자동 윤초 관리로 설치 및 구성한 노드로 <
node_name
>을 바꿉니다. 노드 이름에 특수 문자를 이스케이프합니다. 예: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
16.2.7. linuxptp 서비스를 경계 클록으로 구성
PtpConfig
CR(사용자 정의 리소스) 오브젝트를 생성하여 linuxptp
서비스(ptp4l
,phc2sys
)를 경계 클록으로 구성할 수 있습니다.
다음 예제 PtpConfig
CR을 기준으로 사용하여 linuxptp
서비스를 특정 하드웨어 및 환경의 경계 클록으로 구성합니다. 이 예제 CR에서는 PTP 빠른 이벤트를 구성하지 않습니다. PTP 빠른 이벤트를 구성하려면 ptp4lOpts
,ptp4lConf
및 ptpClockThreshold
에 적절한 값을 설정합니다. ptpClockThreshold
는 이벤트가 활성화된 경우에만 사용됩니다. 자세한 내용은 " PTP 빠른 이벤트 알림 게시자 구성"을 참조하십시오.
사전 요구 사항
-
OpenShift CLI(
oc
)를 설치합니다. -
cluster-admin
권한이 있는 사용자로 로그인합니다. - PTP Operator를 설치합니다.
프로세스
다음
PtpConfig
CR을 만든 다음 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"
표 16.8. 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 프로세스에 대한 스케줄링 정책. 기본값은 Cryo
stat_OTHER
입니다. FIFO 스케줄링을 지원하는 시스템에서 Cryostat_FIFO
를 사용합니다.ptpSchedulingPriority
ptpSchedulingPolicy
가 Cryostat_FIFO
로 설정된 경우ptp4l
및phc2sys
프로세스의 FIFO 우선 순위를 설정하는 데 사용되는 1-65의 정수 값입니다.ptpSchedulingPolicy
가 ptpSchedulingPolicy로 설정된 경우ptpSchedulingPriority
필드는 사용되지않습니다
.ptpClockThreshold
선택 사항:
ptpClockThreshold
가 없으면ptpClockThreshold
필드에 기본값이 사용됩니다.ptpClockThreshold
는 PTP 이벤트가 트리거되기 전에 PTP 마스터 클록의 연결이 해제된 후의 시간을 구성합니다.holdOverTimeout
은 PTP 마스터 클록의 연결이 끊어지면 PTP 클럭 이벤트 상태가 FreeRUN
으로 변경되기 전의 시간(초)입니다.maxOffsetThreshold
및minOffsetThreshold
설정은CLOCK_REALTIME
(phc2sys
) 또는 master 오프셋(ptp4l
)의 값과 비교하는 오프셋 값을 나노초로 구성합니다.ptp4l
또는phc2sys
오프셋 값이 이 범위를 벗어나는 경우 PTP 클럭 상태가 FreeRUN으로
설정됩니다. 오프셋 값이 이 범위 내에 있으면 PTP 클럭 상태가LOCKED
로 설정됩니다.권장
프로필
을 노드에 적용하는 방법에 대한 규칙을 정의하는 하나 이상의recommend
오브젝트 배열을 지정합니다..recommend.profile
profile 섹션에 정의된
.recommend.
오브젝트 이름을 지정합니다.profile
.recommend.priority
0
에서99
사이의 정수 값으로priority
를 지정합니다. 숫자가 클수록 우선순위가 낮으므로 우선순위99
는 우선순위10
보다 낮습니다.match
필드에 정의된 규칙에 따라 여러 프로필과 노드를 일치시킬 수 있는 경우 우선 순위가 높은 프로필이 해당 노드에 적용됩니다..recommend.match
nodeLabel
또는nodeName
값을 사용하여.recommend.match
규칙을 지정합니다..recommend.match.nodeLabel
oc get nodes --show-labels
명령을 사용하여 노드 오브젝트에서node.Labels
필드의키로
nodeLabel
을 설정합니다. 예:node-role.kubernetes.io/worker
..recommend.match.nodeName
oc get nodes
명령을 사용하여 노드 오브젝트의node.Name
필드 값으로nodeName
을 설정합니다. 예를 들면compute-1.example.com
입니다.다음 명령을 실행하여 CR을 생성합니다.
$ oc create -f boundary-clock-ptp-config.yaml
검증
PtpConfig
프로필이 노드에 적용되었는지 확인합니다.다음 명령을 실행하여
openshift-ptp
네임스페이스에서 Pod 목록을 가져옵니다.$ oc get pods -n openshift-ptp -o wide
출력 예
NAME READY STATUS RESTARTS AGE IP NODE linuxptp-daemon-4xkbb 1/1 Running 0 43m 10.1.196.24 compute-0.example.com linuxptp-daemon-tdspf 1/1 Running 0 43m 10.1.196.25 compute-1.example.com ptp-operator-657bbb64c8-2f8sj 1/1 Running 0 43m 10.129.0.61 control-plane-1.example.com
프로필이 올바른지 확인합니다.
PtpConfig
프로필에 지정한 노드에 해당하는linuxptp
데몬의 로그를 검사합니다. 다음 명령을 실행합니다.$ oc logs linuxptp-daemon-4xkbb -n openshift-ptp -c linuxptp-daemon-container
출력 예
I1115 09:41:17.117596 4143292 daemon.go:107] in applyNodePTPProfile I1115 09:41:17.117604 4143292 daemon.go:109] updating NodePTPProfile to: I1115 09:41:17.117607 4143292 daemon.go:110] ------------------------------------ I1115 09:41:17.117612 4143292 daemon.go:102] Profile Name: profile1 I1115 09:41:17.117616 4143292 daemon.go:102] Interface: I1115 09:41:17.117620 4143292 daemon.go:102] Ptp4lOpts: -2 I1115 09:41:17.117623 4143292 daemon.go:102] Phc2sysOpts: -a -r -n 24 I1115 09:41:17.117626 4143292 daemon.go:116] ------------------------------------
16.2.7.1. linuxptp 서비스를 듀얼 NIC 하드웨어의 경계 클럭으로 구성
각 NIC에 대해 PtpConfig
CR(사용자 정의 리소스) 오브젝트를 생성하여 linuxptp
서비스(ptp4l
,phc2sys
)를 듀얼 NIC 하드웨어의 경계 클록으로 구성할 수 있습니다.
듀얼 NIC 하드웨어를 사용하면 각 NIC가 다운스트림 클록에 대해 별도의 ptp4l
인스턴스를 사용하여 각 NIC를 동일한 업스트림 리더 클록에 연결할 수 있습니다.
사전 요구 사항
-
OpenShift CLI(
oc
)를 설치합니다. -
cluster-admin
권한이 있는 사용자로 로그인합니다. - PTP Operator를 설치합니다.
프로세스
각 CR의 기준으로 "linuxptp 서비스를 경계 클록으로 구성"의 참조 CR을 사용하여 각 NIC에 대해 하나씩 두 개의 개별
PtpConfig
CR을 생성합니다. 예를 들면 다음과 같습니다.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
boundary-clock-ptp-config-nic2.yaml
을 생성하여phc2sysOpts
필드를 완전히 제거하여 두 번째 NIC에 대한phc2sys
서비스를 비활성화합니다.apiVersion: ptp.openshift.io/v1 kind: PtpConfig metadata: name: boundary-clock-ptp-config-nic2 namespace: openshift-ptp spec: profile: - name: "profile2" ptp4lOpts: "-2 --summary_interval -4" ptp4lConf: | 1 [ens7f1] masterOnly 1 [ens7f0] masterOnly 0 ...
- 1
ptp4l
을 두 번째 NIC에서 경계 클록으로 시작하는 데 필요한 인터페이스를 지정합니다.
참고두 번째 NIC에서
phc2sys
서비스를 비활성화하려면 두 번째PtpConfig
CR에서phc2sys
필드를 완전히 제거해야 합니다.
다음 명령을 실행하여 듀얼 NIC
PtpConfig
CR을 생성합니다.첫 번째 NIC에 대해 PTP를 구성하는 CR을 생성합니다.
$ oc create -f boundary-clock-ptp-config-nic1.yaml
두 번째 NIC에 대해 PTP를 구성하는 CR을 생성합니다.
$ oc create -f boundary-clock-ptp-config-nic2.yaml
검증
PTP Operator가 두 NIC 모두에
PtpConfig
CR을 적용했는지 확인합니다. 듀얼 NIC 하드웨어가 설치된 노드에 해당하는linuxptp
데몬의 로그를 검사합니다. 예를 들어 다음 명령을 실행합니다.$ oc logs linuxptp-daemon-cvgr6 -n openshift-ptp -c linuxptp-daemon-container
출력 예
ptp4l[80828.335]: [ptp4l.1.config] master offset 5 s2 freq -5727 path delay 519 ptp4l[80828.343]: [ptp4l.0.config] master offset -5 s2 freq -10607 path delay 533 phc2sys[80828.390]: [ptp4l.0.config] CLOCK_REALTIME phc offset 1 s2 freq -87239 delay 539
16.2.7.2. 듀얼 NIC Intel E810 PTP 경계 클록의 고가용성 시스템 클럭으로 linuxptp 구성
이중 PTP 경계 클럭(T-BC)의 linuxptp
서비스 ptp4l
및 phc2sys
를 고가용성(HA) 시스템 클럭으로 구성할 수 있습니다.
고가용성 시스템 클록은 두 개의 경계 클럭으로 구성된 듀얼 NIC Intel E810 Salesm 채널 하드웨어의 여러 시간 소스를 사용합니다. 두 개의 경계 클럭 인스턴스가 HA 설정에 참여하며 각각 고유한 구성 프로필이 있습니다. 각 NIC에 대해 별도의 ptp4l
인스턴스를 사용하여 각 NIC를 동일한 업스트림 리더 클록에 연결합니다.
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로 클러스터 노드를 구성합니다.
프로세스
각 CR에 대한 참조로 "linuxptp 서비스를 경계 클록으로 구성"의 CR을 사용하여 각 NIC에 대해 하나씩 두 개의 개별
PtpConfig
CR을 생성합니다.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
다음 명령을 실행하여 NIC 1에 대해
PtpConfig
CR을 적용합니다.$ oc create -f ha-ptp-config-nic1.yaml
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: ""
다음 명령을 실행하여 NIC 2에 대해
PtpConfig
CR을 적용합니다.$ oc create -f ha-ptp-config-nic2.yaml
HA 시스템 시계를 구성하는
PtpConfig
CR을 생성합니다. 예를 들면 다음과 같습니다.ptp-config-for-ha.yaml
파일을 생성합니다. 두 NIC를 구성하는PtpConfig
CR에 설정된metadata.name
필드와 일치하도록haProfiles
를 설정합니다. 예: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"
- 1
ptp4lOpts
필드를 빈 문자열로 설정합니다. 비어 있지 않으면p4ptl
프로세스가 중요한 오류로 시작됩니다.
중요개별 NIC를 구성하는
PtpConfig
CR 전에 고가용성PtpConfig
CR을 적용하지 마십시오.다음 명령을 실행하여 HA
PtpConfig
CR을 적용합니다.$ oc create -f ptp-config-for-ha.yaml
검증
PTP Operator에서
PtpConfig
CR을 올바르게 적용했는지 확인합니다. 다음 단계를 수행합니다.다음 명령을 실행하여
openshift-ptp
네임스페이스에서 Pod 목록을 가져옵니다.$ oc get pods -n openshift-ptp -o wide
출력 예
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
참고linuxptp-daemon
Pod가 하나만 있어야 합니다.다음 명령을 실행하여 프로필이 올바른지 확인합니다.
PtpConfig
프로필에 지정한 노드에 해당하는linuxptp
데몬의 로그를 검사합니다.$ oc logs linuxptp-daemon-4xkrb -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: 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] ------------------------------------
16.2.8. linuxptp 서비스를 일반 클록으로 구성
PtpConfig
CR(사용자 정의 리소스) 오브젝트를 생성하여 linuxptp
서비스(ptp4l
,phc2sys
)를 일반 클록으로 구성할 수 있습니다.
다음 예제 PtpConfig
CR을 기반으로 linuxptp
서비스를 특정 하드웨어 및 환경의 일반 클록으로 구성합니다. 이 예제 CR에서는 PTP 빠른 이벤트를 구성하지 않습니다. PTP 빠른 이벤트를 구성하려면 ptp4lOpts
,ptp4lConf
및 ptpClockThreshold
에 적절한 값을 설정합니다. ptpClockThreshold
는 이벤트가 활성화된 경우에만 필요합니다. 자세한 내용은 " PTP 빠른 이벤트 알림 게시자 구성"을 참조하십시오.
사전 요구 사항
-
OpenShift CLI(
oc
)를 설치합니다. -
cluster-admin
권한이 있는 사용자로 로그인합니다. - PTP Operator를 설치합니다.
프로세스
다음
PtpConfig
CR을 생성한 다음 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"
표 16.9. PTP 일반 클럭 CR 구성 옵션 CR 필드 설명 name
PtpConfig
CR의 이름입니다.profile
하나 이상의
profile
오브젝트의 배열을 지정합니다. 각 프로필의 이름은 고유해야 합니다.interface
ptp4l
서비스에서 사용할 네트워크 인터페이스를 지정합니다(예:ens787f1
).ptp4lOpts
ptp4l
서비스에 대한 시스템 구성 옵션을 지정합니다(예:-
2)는 IEEE 802.3 네트워크 전송을 선택합니다. 옵션은 네트워크 인터페이스 이름과 서비스 구성 파일이 자동으로 추가되므로 네트워크 인터페이스 이름-i <interface>
및 서비스 구성 파일-f /etc/ptp4l.conf
를 포함하지 않아야 합니다. 이 인터페이스에서 PTP 빠른 이벤트를 사용하려면--summary_interval -4
를 추가합니다.phc2sysOpts
phc2sys
서비스에 대한 시스템 구성 옵션을 지정합니다. 이 필드가 비어 있으면 PTP Operator에서phc2sys
서비스를 시작하지 않습니다. Intel Columbiaville 800 시리즈 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
프로세스에 대한 스케줄링 정책. 기본값은 Cryostat_OTHER
입니다. FIFO 스케줄링을 지원하는 시스템에서 Cryostat_FIFO
를 사용합니다.ptpSchedulingPriority
ptpSchedulingPolicy
가 Cryostat_FIFO
로 설정된 경우ptp4l
및phc2sys
프로세스의 FIFO 우선 순위를 설정하는 데 사용되는 1-65의 정수 값입니다.ptpSchedulingPolicy
가 ptpSchedulingPolicy로 설정된 경우ptpSchedulingPriority
필드는 사용되지않습니다
.ptpClockThreshold
선택 사항:
ptpClockThreshold
가 없으면ptpClockThreshold
필드에 기본값이 사용됩니다.ptpClockThreshold
는 PTP 이벤트가 트리거되기 전에 PTP 마스터 클록의 연결이 해제된 후의 시간을 구성합니다.holdOverTimeout
은 PTP 마스터 클록의 연결이 끊어지면 PTP 클럭 이벤트 상태가 FreeRUN
으로 변경되기 전의 시간(초)입니다.maxOffsetThreshold
및minOffsetThreshold
설정은CLOCK_REALTIME
(phc2sys
) 또는 master 오프셋(ptp4l
)의 값과 비교하는 오프셋 값을 나노초로 구성합니다.ptp4l
또는phc2sys
오프셋 값이 이 범위를 벗어나는 경우 PTP 클럭 상태가 FreeRUN으로
설정됩니다. 오프셋 값이 이 범위 내에 있으면 PTP 클럭 상태가LOCKED
로 설정됩니다.권장
프로필
을 노드에 적용하는 방법에 대한 규칙을 정의하는 하나 이상의recommend
오브젝트 배열을 지정합니다..recommend.profile
profile 섹션에 정의된
.recommend.
오브젝트 이름을 지정합니다.profile
.recommend.priority
일반 클록의 경우
.recommend.priority
를0
으로 설정합니다..recommend.match
nodeLabel
또는nodeName
값을 사용하여.recommend.match
규칙을 지정합니다..recommend.match.nodeLabel
oc get nodes --show-labels
명령을 사용하여 노드 오브젝트에서node.Labels
필드의키로
nodeLabel
을 설정합니다. 예:node-role.kubernetes.io/worker
..recommend.match.nodeName
oc get nodes
명령을 사용하여 노드 오브젝트의node.Name
필드 값으로nodeName
을 설정합니다. 예를 들면compute-1.example.com
입니다.다음 명령을 실행하여
PtpConfig
CR을 생성합니다.$ oc create -f ordinary-clock-ptp-config.yaml
검증
PtpConfig
프로필이 노드에 적용되었는지 확인합니다.다음 명령을 실행하여
openshift-ptp
네임스페이스에서 Pod 목록을 가져옵니다.$ oc get pods -n openshift-ptp -o wide
출력 예
NAME READY STATUS RESTARTS AGE IP NODE linuxptp-daemon-4xkbb 1/1 Running 0 43m 10.1.196.24 compute-0.example.com linuxptp-daemon-tdspf 1/1 Running 0 43m 10.1.196.25 compute-1.example.com ptp-operator-657bbb64c8-2f8sj 1/1 Running 0 43m 10.129.0.61 control-plane-1.example.com
프로필이 올바른지 확인합니다.
PtpConfig
프로필에 지정한 노드에 해당하는linuxptp
데몬의 로그를 검사합니다. 다음 명령을 실행합니다.$ oc logs linuxptp-daemon-4xkbb -n openshift-ptp -c linuxptp-daemon-container
출력 예
I1115 09:41:17.117596 4143292 daemon.go:107] in applyNodePTPProfile I1115 09:41:17.117604 4143292 daemon.go:109] updating NodePTPProfile to: I1115 09:41:17.117607 4143292 daemon.go:110] ------------------------------------ I1115 09:41:17.117612 4143292 daemon.go:102] Profile Name: profile1 I1115 09:41:17.117616 4143292 daemon.go:102] Interface: ens787f1 I1115 09:41:17.117620 4143292 daemon.go:102] Ptp4lOpts: -2 -s I1115 09:41:17.117623 4143292 daemon.go:102] Phc2sysOpts: -a -r -n 24 I1115 09:41:17.117626 4143292 daemon.go:116] ------------------------------------
16.2.8.1. Intel Columbiaville E800 시리즈 NIC를 PTP 일반 클럭 참조
다음 표에서는 Intel Columbiaville E800 시리즈 NIC를 일반 클록으로 사용하기 위해 참조 PTP 구성에 대해 설명합니다. 클러스터에 적용하는 PtpConfig
CR(사용자 정의 리소스)을 변경합니다.
PTP 구성 | 권장 설정 |
---|---|
|
|
|
|
|
|
phc2sysOpts
의 경우-m
은 메시지를 stdout
에 출력합니다. linuxptp-daemon
DaemonSet
은 로그를 구문 분석하고 Prometheus 지표를 생성합니다.
추가 리소스
-
PTP 빠른 이벤트를 사용하여
linuxptp
서비스를 일반 클록으로 구성하는 전체 예제 CR은 linuxptp 서비스를 일반 클록으로 구성을 참조하십시오.
16.2.9. PTP 하드웨어에 대한 FIFO 우선순위 스케줄링 구성
대기 시간이 짧은 통신 또는 기타 배포 유형에서는 PTP 데몬 스레드는 나머지 인프라 구성 요소와 함께 제한된 CPU 풋프린트에서 실행됩니다. 기본적으로 PTP 스레드는 Cryostat _OTHER
정책으로 실행됩니다. 로드가 높은 상태에서 이러한 스레드는 오류가 없는 작업에 필요한 스케줄링 대기 시간을 얻지 못할 수 있습니다.
잠재적인 스케줄링 대기 시간 오류를 완화하기 위해 PTP Operator linuxptp
서비스를 구성하여 스레드가 a Cryostat _FIFO
정책으로 실행되도록 할 수 있습니다. PtpConfig
CR에 대해 Cryostat _FIFO
가 설정된 경우 ptp4l
및 phc2sys
는 PtpConfig
CR의 ptpSchedulingPriority
필드에 의해 설정된 우선순위를 가진 chrt
아래의 상위 컨테이너에서 실행됩니다.
ptpSchedulingPolicy
설정은 선택 사항이며 대기 시간 오류가 발생하는 경우에만 필요합니다.
프로세스
PtpConfig
CR 프로필을 편집합니다.$ oc edit PtpConfig -n openshift-ptp
ptpSchedulingPolicy
및ptpSchedulingPriority
필드를 변경합니다.apiVersion: ptp.openshift.io/v1 kind: PtpConfig metadata: name: <ptp_config_name> namespace: openshift-ptp ... spec: profile: - name: "profile1" ... ptpSchedulingPolicy: SCHED_FIFO 1 ptpSchedulingPriority: 10 2
-
저장하고 종료하여
PtpConfig
CR에 변경 사항을 적용합니다.
검증
linuxptp-daemon
Pod의 이름과PtpConfig
CR이 적용된 해당 노드를 가져옵니다.$ oc get pods -n openshift-ptp -o wide
출력 예
NAME READY STATUS RESTARTS AGE IP NODE linuxptp-daemon-gmv2n 3/3 Running 0 1d17h 10.1.196.24 compute-0.example.com linuxptp-daemon-lgm55 3/3 Running 0 1d17h 10.1.196.25 compute-1.example.com ptp-operator-3r4dcvf7f4-zndk7 1/1 Running 0 1d7h 10.129.0.61 control-plane-1.example.com
업데이트된
chrt
FIFO 우선 순위로ptp4l
프로세스가 실행 중인지 확인합니다.$ oc -n openshift-ptp logs linuxptp-daemon-lgm55 -c linuxptp-daemon-container|grep chrt
출력 예
I1216 19:24:57.091872 1600715 daemon.go:285] /bin/chrt -f 65 /usr/sbin/ptp4l -f /var/run/ptp4l.0.config -2 --summary_interval -4 -m
16.2.10. linuxptp 서비스에 대한 로그 필터링 구성
linuxptp
데몬은 디버깅을 위해 사용할 수 있는 로그를 생성합니다. 제한된 스토리지 용량을 제공하는 통신 또는 기타 배포 유형에서는 이러한 로그가 스토리지 요구에 추가할 수 있습니다.
수 로그 메시지를 줄이기 위해 마스터 오프셋
값을 보고하는 로그 메시지를 제외하도록 PtpConfig
CR(사용자 정의 리소스)을 구성할 수 있습니다. 마스터 오프셋
로그 메시지는 현재 노드의 클록과 나노초의 마스터 클록의 차이를 보고합니다.
사전 요구 사항
-
OpenShift CLI(
oc
)를 설치합니다. -
cluster-admin
권한이 있는 사용자로 로그인합니다. - PTP Operator를 설치합니다.
프로세스
PtpConfig
CR을 편집합니다.$ oc edit PtpConfig -n openshift-ptp
spec.profile
에서ptpSettings.logReduce
사양을 추가하고 값을true
로 설정합니다.apiVersion: ptp.openshift.io/v1 kind: PtpConfig metadata: name: <ptp_config_name> namespace: openshift-ptp ... spec: profile: - name: "profile1" ... ptpSettings: logReduce: "true"
참고디버깅을 위해 이 사양을
False
로 되돌리고 마스터 오프셋 메시지를 포함할 수 있습니다.-
저장하고 종료하여
PtpConfig
CR에 변경 사항을 적용합니다.
검증
linuxptp-daemon
Pod의 이름과PtpConfig
CR이 적용된 해당 노드를 가져옵니다.$ oc get pods -n openshift-ptp -o wide
출력 예
NAME READY STATUS RESTARTS AGE IP NODE linuxptp-daemon-gmv2n 3/3 Running 0 1d17h 10.1.196.24 compute-0.example.com linuxptp-daemon-lgm55 3/3 Running 0 1d17h 10.1.196.25 compute-1.example.com ptp-operator-3r4dcvf7f4-zndk7 1/1 Running 0 1d7h 10.129.0.61 control-plane-1.example.com
다음 명령을 실행하여 마스터 오프셋 메시지가 로그에서 제외되었는지 확인합니다.
$ oc -n openshift-ptp logs <linux_daemon_container> -c linuxptp-daemon-container | grep "master offset" 1
- 1
- <linux_daemon_container>는
linuxptp-daemon
Pod의 이름입니다(예:linuxptp-daemon-gmv2n
).
logReduce
사양을 구성할 때 이 명령은linuxptp
데몬의 로그에마스터 오프셋
의 인스턴스를 보고하지 않습니다.
16.2.11. 일반적인 PTP Operator 문제 해결
다음 단계를 수행하여 PTP Operator의 일반적인 문제를 해결합니다.
사전 요구 사항
-
OpenShift Container Platform CLI (
oc
)를 설치합니다. -
cluster-admin
권한이 있는 사용자로 로그인합니다. - PTP를 지원하는 호스트가 있는 베어 메탈 클러스터에 PTP Operator를 설치합니다.
프로세스
구성된 노드를 위해 Operator 및 Operand가 클러스터에 성공적으로 배포되었는지 확인합니다.
$ oc get pods -n openshift-ptp -o wide
출력 예
NAME READY STATUS RESTARTS AGE IP NODE linuxptp-daemon-lmvgn 3/3 Running 0 4d17h 10.1.196.24 compute-0.example.com linuxptp-daemon-qhfg7 3/3 Running 0 4d17h 10.1.196.25 compute-1.example.com ptp-operator-6b8dcbf7f4-zndk7 1/1 Running 0 5d7h 10.129.0.61 control-plane-1.example.com
참고PTP 빠른 이벤트 버스가 활성화되면 준비된
linuxptp-daemon
Pod 수는3/3
가 됩니다. PTP 빠른 이벤트 버스가 활성화되지 않으면2/2
가 표시됩니다.지원되는 하드웨어가 클러스터에 있는지 확인합니다.
$ oc -n openshift-ptp get nodeptpdevices.ptp.openshift.io
출력 예
NAME AGE control-plane-0.example.com 10d control-plane-1.example.com 10d compute-0.example.com 10d compute-1.example.com 10d compute-2.example.com 10d
노드에 사용 가능한 PTP 네트워크 인터페이스를 확인합니다.
$ oc -n openshift-ptp get nodeptpdevices.ptp.openshift.io <node_name> -o yaml
다음과 같습니다.
- <node_name>
쿼리할 노드를 지정합니다 (예:
compute-0.example.com
).출력 예
apiVersion: ptp.openshift.io/v1 kind: NodePtpDevice metadata: creationTimestamp: "2021-09-14T16:52:33Z" generation: 1 name: compute-0.example.com namespace: openshift-ptp resourceVersion: "177400" uid: 30413db0-4d8d-46da-9bef-737bacd548fd spec: {} status: devices: - name: eno1 - name: eno2 - name: eno3 - name: eno4 - name: enp5s0f0 - name: enp5s0f1
해당 노드의
linuxptp-daemon
Pod에 액세스하여 PTP 인터페이스가 기본 클록에 성공적으로 동기화되었는지 확인합니다.다음 명령을 실행하여
linuxptp-daemon
Pod의 이름과 문제를 해결하려는 해당 노드를 가져옵니다.$ oc get pods -n openshift-ptp -o wide
출력 예
NAME READY STATUS RESTARTS AGE IP NODE linuxptp-daemon-lmvgn 3/3 Running 0 4d17h 10.1.196.24 compute-0.example.com linuxptp-daemon-qhfg7 3/3 Running 0 4d17h 10.1.196.25 compute-1.example.com ptp-operator-6b8dcbf7f4-zndk7 1/1 Running 0 5d7h 10.129.0.61 control-plane-1.example.com
필수
linuxptp-daemon
컨테이너로의 원격 쉘:$ oc rsh -n openshift-ptp -c linuxptp-daemon-container <linux_daemon_container>
다음과 같습니다.
- <linux_daemon_container>
-
진단할 컨테이너입니다 (예:
linuxptp-daemon-lmvgn
).
linuxptp-daemon
컨테이너에 대한 원격 쉘 연결에서 PTP 관리 클라이언트(pmc
) 툴을 사용하여 네트워크 인터페이스를 진단합니다. 다음pmc
명령을 실행하여 PTP 장치의 동기화 상태를 확인합니다(예:ptp4l
).# pmc -u -f /var/run/ptp4l.0.config -b 0 'GET PORT_DATA_SET'
노드가 기본 클록에 성공적으로 동기화되었을 때의 출력 예
sending: GET PORT_DATA_SET 40a6b7.fffe.166ef0-1 seq 0 RESPONSE MANAGEMENT PORT_DATA_SET portIdentity 40a6b7.fffe.166ef0-1 portState SLAVE logMinDelayReqInterval -4 peerMeanPathDelay 0 logAnnounceInterval -3 announceReceiptTimeout 3 logSyncInterval -4 delayMechanism 1 logMinPdelayReqInterval -4 versionNumber 2
GNSS 소싱 할 마스터 클록의 경우 in-tree NIC 아이스크림 드라이버가 다음 명령을 실행하여 올바른지 확인합니다. 예를 들면 다음과 같습니다.
$ oc rsh -n openshift-ptp -c linuxptp-daemon-container linuxptp-daemon-74m2g ethtool -i ens7f0
출력 예
driver: ice version: 5.14.0-356.bz2232515.el9.x86_64 firmware-version: 4.20 0x8001778b 1.3346.0
GNSS 소싱된 마스터 클록의 경우
linuxptp-daemon
컨테이너가 GNSS radio에서 신호를 수신하고 있는지 확인합니다. 컨테이너가 GNSS 신호를 수신하지 않으면/dev/gnss0
파일이 채워지지 않습니다. 확인하려면 다음 명령을 실행합니다.$ oc rsh -n openshift-ptp -c linuxptp-daemon-container linuxptp-daemon-jnz6r cat /dev/gnss0
출력 예
$GNRMC,125223.00,A,4233.24463,N,07126.64561,W,0.000,,300823,,,A,V*0A $GNVTG,,T,,M,0.000,N,0.000,K,A*3D $GNGGA,125223.00,4233.24463,N,07126.64561,W,1,12,99.99,98.6,M,-33.1,M,,*7E $GNGSA,A,3,25,17,19,11,12,06,05,04,09,20,,,99.99,99.99,99.99,1*37 $GPGSV,3,1,10,04,12,039,41,05,31,222,46,06,50,064,48,09,28,064,42,1*62
16.2.12. Intel 800 시리즈 NIC에서 CGU의 DPLL 펌웨어 버전 가져오기
클러스터 노드에 디버그 쉘을 열고 NIC 하드웨어를 쿼리하여 Intel 800 시리즈 NIC에서 Clock Generation Unit (CGU)의 Clock Generation Unit (CGU)의 디지털 DPLL( phase-locked loop) 펌웨어 버전을 가져올 수 있습니다.
사전 요구 사항
-
OpenShift CLI(
oc
)가 설치되어 있습니다. -
cluster-admin
권한이 있는 사용자로 로그인했습니다. - 클러스터 호스트에 Intel 800 시리즈 NIC를 설치했습니다.
- PTP를 지원하는 호스트를 사용하여 베어 메탈 클러스터에 PTP Operator를 설치했습니다.
프로세스
다음 명령을 실행하여 디버그 Pod를 시작합니다.
$ oc debug node/<node_name>
다음과 같습니다.
- <node_name>
- Intel 800 시리즈 NIC를 설치한 노드입니다.
devlink
툴과 NIC가 설치된 버스 및 장치 이름을 사용하여 NIC의 CGU 펌웨어 버전을 확인합니다. 예를 들어 다음 명령을 실행합니다.sh-4.4# devlink dev info <bus_name>/<device_name> | grep cgu
다음과 같습니다.
- <bus_name>
-
NIC가 설치된 버스입니다. 예:
pci
. - <device_name>
-
NIC 장치 이름입니다. 예를 들면
0000:51:00.0
입니다.
출력 예
cgu.id 36 1 fw.cgu 8032.16973825.6021 2
참고펌웨어 버전에는 버전 번호의 각 부분에 대해 선행 nibble 및 3 옥텟이 있습니다. 바이너리의
16973825
번호는0001 0000 0011 0000 0000 0001
입니다. 바이너리 값을 사용하여 펌웨어 버전을 디코딩합니다. 예를 들면 다음과 같습니다.표 16.11. DPLL 펌웨어 버전 바이너리 부분 10진수 값 0001
1
0000 0011
3
0000 0000
0
0000 0001
1
16.2.13. PTP Operator 데이터 수집
oc adm must-gather
명령을 사용하여 PTP Operator와 관련된 기능 및 오브젝트를 포함하여 클러스터에 대한 정보를 수집할 수 있습니다.
사전 요구 사항
-
cluster-admin
역할의 사용자로 클러스터에 액세스할 수 있어야 합니다. -
OpenShift CLI(
oc
)가 설치되어 있습니다. - PTP Operator를 설치했습니다.
프로세스
must-gather
를 사용하여 PTP Operator 데이터를 수집하려면 PTP Operatormust-gather
이미지를 지정해야 합니다.$ oc adm must-gather --image=registry.redhat.io/openshift4/ptp-must-gather-rhel8:v4.17