13.5. PTP 장치 구성
PTP Operator는 NodePtpDevice.ptp.openshift.io
CRD(custom resource definition)를 OpenShift Container Platform에 추가합니다.
설치 시 PTP Operator는 각 노드에서 PTP 지원 네트워크 장치를 클러스터에서 검색합니다. 호환되는 PTP 가능 네트워크 장치를 제공하는 각 노드에 대해 NodePtpDevice
CR(사용자 정의 리소스) 오브젝트를 생성하고 업데이트합니다.
13.5.1. 클러스터에서 PTP 지원 네트워크 장치 검색
클러스터에서 PTP 가능 네트워크 장치의 전체 목록을 반환하려면 다음 명령을 실행합니다.
$ oc get NodePtpDevice -n openshift-ptp -o yaml
출력 예
apiVersion: v1 items: - apiVersion: ptp.openshift.io/v1 kind: NodePtpDevice metadata: creationTimestamp: "2022-01-27T15:16:28Z" generation: 1 name: dev-worker-0 1 namespace: openshift-ptp resourceVersion: "6538103" uid: d42fc9ad-bcbf-4590-b6d8-b676c642781a spec: {} status: devices: 2 - name: eno1 - name: eno2 - name: eno3 - name: eno4 - name: enp5s0f0 - name: enp5s0f1 ...
13.5.2. linuxptp 서비스를 할 마스터 클록으로 구성
호스트 NIC를 구성하는 PtpConfig
CR(사용자 정의 리소스)을 생성하여 linuxptp
서비스(ptp4l
,phc2sys
,ts2phc
)를 master 클록으로 구성할 수 있습니다.
ts2phc
유틸리티를 사용하면 시스템 시계를 PTP 할 마스터 클록과 동기화하여 노드가 PTP 일반 클럭 및 경계 클록으로 정밀한 클럭을 스트리밍할 수 있습니다.
다음 예제 PtpConfig
CR을 기반으로 linuxptp
서비스를 특정 하드웨어 및 환경의 마스터 클록으로 구성합니다. 이 예제 CR에서는 PTP 빠른 이벤트를 구성하지 않습니다. PTP 빠른 이벤트를 구성하려면 ptp4lOpts
,ptp4lConf
, ptpClockThreshold
에 적절한 값을 설정합니다. ptpClockThreshold
는 이벤트가 활성화된 경우에만 사용됩니다. 자세한 내용은 " PTP 빠른 이벤트 알림 게시자 구성"을 참조하십시오.
사전 요구 사항
- 베어 메탈 클러스터 호스트에 Intel Westport Channel 네트워크 인터페이스를 설치합니다.
-
OpenShift CLI(
oc
)를 설치합니다. -
cluster-admin
권한이 있는 사용자로 로그인합니다. - PTP Operator를 설치합니다.
절차
PtpConfig
리소스를 생성합니다. 예를 들면 다음과 같습니다.다음 YAML을
grandmaster-clock-ptp-config.yaml
파일에 저장합니다.PTP grandmaster 클럭 구성의 예
apiVersion: ptp.openshift.io/v1 kind: PtpConfig metadata: name: grandmaster-clock namespace: openshift-ptp annotations: {} spec: profile: - name: grandmaster-clock # The interface name is hardware-specific interface: $interface ptp4lOpts: "-2" phc2sysOpts: "-a -r -r -n 24" ptpSchedulingPolicy: SCHED_FIFO ptpSchedulingPriority: 10 ptpSettings: logReduce: "true" ptp4lConf: | [global] # # Default Data Set # twoStepFlag 1 slaveOnly 0 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: grandmaster-clock priority: 4 match: - nodeLabel: "node-role.kubernetes.io/$mcp"
다음 명령을 실행하여 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
13.5.3. 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"
표 13.1. PTP 일반 클럭 CR 구성 옵션
사용자 정의 리소스 필드 설명 name
PtpConfig
CR의 이름입니다.profile
하나 이상의
profile
오브젝트의 배열을 지정합니다. 각 프로필은 고유하게 이름을 지정해야 합니다.인터페이스
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
프로세스에 대한 스케줄링 정책입니다. 기본값은 EgressIP_OTHER
입니다. FIFO 예약을 지원하는 시스템에서jq_FIFO
를 사용합니다.ptpSchedulingPriority
ptpSchedulingPolicy
가ECDHE_FIFO로 설정된 경우
우선 순위를 설정하는 데 사용되는 1-65의 정수 값입니다.ptp4l
및phc2sys
프로세스의 FIFOptpSchedulingPriority
필드는ptpSchedulingPolicy
가ECDHE_OTHER
로 설정된 경우 사용되지 않습니다.ptpClockThreshold
선택 사항:
ptpClockThreshold
가 없으면 기본값이ptpClockThreshold
필드에 사용됩니다.ptpClockThreshold
는 PTP 이벤트가 트리거되기 전에 PTP 마스터 시계가 연결이 끊긴 후의 기간을 구성합니다.holdOverTimeout
은 PTP 마스터 클럭이 연결 해제되면 PTP 클럭 이벤트 상태가 FreeRUN
로 변경되는 시간 값(초)입니다.maxOffsetThreshold
및minOffsetThreshold
설정은CLOCK_REALTIME
(phc2sys
) 또는 마스터 오프셋(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.nodeLabel
oc get nodes
명령을 사용하여 노드 오브젝트에서node.Name
의 값으로nodeName
을 업데이트합니다. 예:compute-0.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] ------------------------------------
추가 리소스
- PTP 하드웨어의 FIFO 우선 순위 스케줄링에 대한 자세한 내용은 PTP 하드웨어에 대한 FIFO 우선 순위 스케줄링 구성 을 참조하십시오.
- PTP 빠른 이벤트 구성에 대한 자세한 내용은 PTP 빠른 이벤트 알림 게시자 구성을 참조하십시오.
13.5.4. 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"
표 13.2. PTP 경계 클럭 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 프로세스에 대한 스케줄링 정책입니다. 기본값은 E
gressIP_OTHER
입니다. FIFO 예약을 지원하는 시스템에서jq_FIFO
를 사용합니다.ptpSchedulingPriority
ptpSchedulingPolicy
가ECDHE_FIFO로 설정된 경우
우선 순위를 설정하는 데 사용되는 1-65의 정수 값입니다.ptp4l
및phc2sys
프로세스의 FIFOptpSchedulingPriority
필드는ptpSchedulingPolicy
가ECDHE_OTHER
로 설정된 경우 사용되지 않습니다.ptpClockThreshold
선택 사항:
ptpClockThreshold
가 없으면 기본값이ptpClockThreshold
필드에 사용됩니다.ptpClockThreshold
는 PTP 이벤트가 트리거되기 전에 PTP 마스터 시계가 연결이 끊긴 후의 기간을 구성합니다.holdOverTimeout
은 PTP 마스터 클럭이 연결 해제되면 PTP 클럭 이벤트 상태가 FreeRUN
로 변경되는 시간 값(초)입니다.maxOffsetThreshold
및minOffsetThreshold
설정은CLOCK_REALTIME
(phc2sys
) 또는 마스터 오프셋(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.nodeLabel
oc get nodes
명령을 사용하여 노드 오브젝트에서node.Name
의 값으로nodeName
을 업데이트합니다. 예:compute-0.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] ------------------------------------
추가 리소스
- PTP 하드웨어의 FIFO 우선 순위 스케줄링에 대한 자세한 내용은 PTP 하드웨어에 대한 FIFO 우선 순위 스케줄링 구성 을 참조하십시오.
- PTP 빠른 이벤트 구성에 대한 자세한 내용은 PTP 빠른 이벤트 알림 게시자 구성을 참조하십시오.
13.5.5. Intel Columbiaville E800 시리즈 NIC as PTP 일반 클럭 참조
다음 표에서는 Intel Columbiaville E800 시리즈 NIC를 일반 시계로 사용하기 위해 참조 PTP 구성에 대한 변경 사항을 설명합니다. 클러스터에 적용하는 PtpConfig
CR(사용자 정의 리소스)을 변경합니다.
표 13.3. Intel Columbiaville NIC에 권장되는 PTP 설정
PTP 구성 | 권장 설정 |
---|---|
|
|
|
|
|
|
phc2sysOpts
의 경우-m
은 메시지를 stdout
에 인쇄합니다. linuxptp-daemon
DaemonSet
은 로그를 구문 분석하고 Prometheus 지표를 생성합니다.
추가 리소스
-
linuxptp
서비스를 PTP 빠른 이벤트가 있는 일반 클럭으로 구성하는 완전한 예제 CR은 Linuxptp 서비스 구성을 일반 클럭으로 참조하십시오.
13.5.6. PTP 하드웨어의 firstFO 우선 순위 스케줄링 구성
대기 시간이 짧아야 하는 기타 배포 구성의 경우 PTP 데몬 스레드는 인프라 구성 요소의 나머지 부분과 함께 제한된 CPU 풋프린트에서 실행됩니다. 기본적으로 PTP 스레드는 EgressIP _OTHER
정책을 사용하여 실행됩니다. 부하가 높은 경우 이러한 스레드는 오류가없는 작업에 필요한 스케줄링 대기 시간을 얻지 못할 수 있습니다.
잠재적인 스케줄링 대기 시간 오류에 대해 완화하기 위해 PTP Operator linuxptp
서비스를 구성하여 DomainMapping _FIFO
정책으로 스레드를 실행할 수 있도록 합니다. EgressIP _FIFO
가 PtpConfig
CR에 대해 설정된 경우 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
ptp4l
프로세스가 업데이트된chrt
FIFO 우선 순위로 실행되고 있는지 확인합니다.$ oc -n openshift-ptp logs linuxptp-daemon-lgm55 -c linuxptp-daemon-container|grep chrt
출력 예
I1216 19:24:57.091872 1600715 daemon.go:285] /bin/chrt -f 65 /usr/sbin/ptp4l -f /var/run/ptp4l.0.config -2 --summary_interval -4 -m