This documentation is for a release that is no longer maintained
See documentation for the latest supported version 3 or the latest supported version 4.15.5. PTP 장치 구성
PTP Operator는 NodePtpDevice.ptp.openshift.io CRD(custom resource definition)를 OpenShift Container Platform에 추가합니다.
PTP Operator는 각 노드에서 PTP 가능 네트워크 장치를 클러스터에서 검색합니다. 호환 가능한 PTP 가능 네트워크 장치를 제공하는 각 노드에 대해 NodePtpDevice CR(사용자 정의 리소스) 오브젝트를 생성하고 업데이트합니다.
15.5.1. 클러스터에서 PTP 가능 네트워크 장치 검색 링크 복사링크가 클립보드에 복사되었습니다!
클러스터에서 PTP 가능 네트워크 장치의 전체 목록을 반환하려면 다음 명령을 실행합니다.
oc get NodePtpDevice -n openshift-ptp -o yaml
$ oc get NodePtpDevice -n openshift-ptp -o yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
15.5.2. linuxptp 서비스를 일반 클럭으로 구성 링크 복사링크가 클립보드에 복사되었습니다!
PtpConfig CR(사용자 정의 리소스) 오브젝트를 생성하여 linuxptp 서비스(ptp4l,phc2sys)를 일반 시계로 구성할 수 있습니다.
다음 예제 PtpConfig CR을 기반으로 linuxptp 서비스를 특정 하드웨어 및 환경에 대한 일반 클럭으로 구성합니다. 이 예제 CR에서는 ptp4lOpts,ptp4lConf 및 ptpClockThreshold 에 대한 적절한 값을 설정하여 PTP 빠른 이벤트를 구성합니다. ptpClockThreshold 는 이벤트가 활성화된 경우에만 사용됩니다.
사전 요구 사항
-
OpenShift CLI(
oc)를 설치합니다. -
cluster-admin권한이 있는 사용자로 로그인합니다. - PTP Operator를 설치합니다.
절차
다음
PtpConfigCR을 생성한 다음 YAML을ordinary-clock-ptp-config.yaml파일에 저장합니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
PtpConfigCR의 이름입니다.- 2
- 하나 이상의
profile오브젝트의 배열을 지정합니다. - 3
- 프로필 오브젝트의 고유 이름을 지정합니다.
- 4
ptp4l서비스에서 사용할 네트워크 인터페이스를 지정합니다(예:ens787f1).- 5
ptp4l서비스에 대한 시스템 구성 옵션을 지정합니다. 예를 들어-2는 IEEE 802.3 네트워크 전송을 선택합니다. 옵션은 네트워크 인터페이스 이름과 서비스 구성 파일이 자동으로 추가되므로 네트워크 인터페이스 이름-i <interface>및 서비스 구성 파일-f /etc/ptp4l.conf를 포함하지 않아야 합니다. 이 인터페이스에서 PTP 빠른 이벤트를 사용하려면--summary_interval -4를 추가합니다.- 6
phc2sys서비스에 대한 시스템 구성 옵션을 지정합니다. 이 필드가 비어 있으면 PTP Operator에서phc2sys서비스를 시작하지 않습니다. Intel Coumbiaville 800 시리즈 NIC의 경우phc2sysOpts옵션을-a -r -m -n 24 -N 8 -R 16으로 설정합니다.-m은stdout에 메시지를 출력합니다.linuxptp-daemonDaemonSet은 로그를 구문 분석하고 Prometheus 지표를 생성합니다.- 7
- 기본
/etc/ptp4l.conf파일을 대체할 구성이 포함된 문자열을 지정합니다. 기본 구성을 사용하려면 필드를 비워 둡니다. - 8
- Intel Coumbiaville 800 시리즈 NIC의 경우
tx_timestamp_timeout을50으로 설정합니다. - 9
- Intel Columbiaville 800 시리즈 NIC의 경우
boundary_clock_jbod를0으로 설정합니다. - 10
ptp4l및phc2sys프로세스에 대한 스케줄링 정책입니다. 기본값은-4.8_OTHER입니다. Havana 스케줄링을지원하는 시스템에서 Retain_VRF를 사용합니다.- 11
ptpSchedulingPolicy가ECDHE_FIFO로 설정된 경우우선 순위를 설정하는 데 사용되는 1-65의 정수 값입니다.ptp4l및phc2sys프로세스의 FIFOptpSchedulingPriority필드는ptpSchedulingPolicy가ECDHE_OTHER로 설정된 경우 사용되지 않습니다.- 12
- 선택 사항:
ptpClockThreshold가 없으면 기본값이ptpClockThreshold필드에 사용됩니다. 스탠자는 기본ptpClockThreshold값을 표시합니다.ptpClockThreshold값은 PTP 이벤트가 트리거되기 전에 PTP 마스터 클럭이 연결 해제된 후의 기간을 구성합니다.holdOverTimeout은 PTP 마스터 클럭의 연결이 끊어지면 PTP 클럭 이벤트 상태가FREERUN로 변경되기 전 시간(초)입니다.maxOffsetThreshold및minOffsetThreshold설정은CLOCK_REALTIME(phc2sys) 또는 마스터 오프셋(ptp4l)의 값과 비교되는 나노초에 오프셋 값을 구성합니다.ptp4l또는phc2sys오프셋 값이 이 범위를 벗어나는 경우 PTP 클럭 상태가FREERUN로 설정됩니다. 오프셋 값이 이 범위 내에 있으면 PTP 클럭 상태가LOCKED로 설정됩니다. - 13
프로필을 노드에 적용하는 방법에 대한 규칙을 정의하는 하나 이상의recommend오브젝트 배열을 지정합니다.- 14
profile섹션에 정의된profile오브젝트 이름을 지정합니다.- 15
- 일반 시계의 경우
priority를0으로 설정합니다. - 16
nodeLabel또는nodeName으로일치규칙을 지정합니다.- 17
oc get nodes --show-labels명령을 사용하여 노드 오브젝트에서node.Labels의키로nodeLabel을 지정합니다.- 18
oc get nodes명령을 사용하여 노드 오브젝트에서node.Name으로nodeName을 지정합니다.
다음 명령을 실행하여
PtpConfigCR을 생성합니다.oc create -f ordinary-clock-ptp-config.yaml
$ oc create -f ordinary-clock-ptp-config.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
PtpConfig프로필이 노드에 적용되었는지 확인합니다.다음 명령을 실행하여
openshift-ptp네임스페이스에서 Pod 목록을 가져옵니다.oc get pods -n openshift-ptp -o wide
$ oc get pods -n openshift-ptp -o wideCopy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
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
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.comCopy to Clipboard Copied! Toggle word wrap Toggle overflow 프로필이 올바른지 확인합니다.
PtpConfig프로필에 지정한 노드에 해당하는linuxptp데몬의 로그를 검사합니다. 다음 명령을 실행합니다.oc logs linuxptp-daemon-4xkbb -n openshift-ptp -c linuxptp-daemon-container
$ oc logs linuxptp-daemon-4xkbb -n openshift-ptp -c linuxptp-daemon-containerCopy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
15.5.3. linuxptp 서비스를 경계 시계로 구성 링크 복사링크가 클립보드에 복사되었습니다!
PtpConfig CR(사용자 정의 리소스) 오브젝트를 생성하여 linuxptp 서비스(ptp4l,phc2sys)를 경계 시계로 구성할 수 있습니다.
다음 예제 PtpConfig CR을 기반으로 linuxptp 서비스를 특정 하드웨어 및 환경에 대한 경계 클럭으로 구성합니다. 이 예제 CR은 또한 ptp4lOpts,ptp4lConf, ptpClockThreshold 에 적절한 값을 설정하여 PTP 빠른 이벤트를 구성합니다. ptpClockThreshold 는 이벤트가 활성화된 경우에만 사용됩니다.
사전 요구 사항
-
OpenShift CLI(
oc)를 설치합니다. -
cluster-admin권한이 있는 사용자로 로그인합니다. - PTP Operator를 설치합니다.
절차
다음
PtpConfigCR을 만든 다음 YAML을boundary-clock-ptp-config.yaml파일에 저장합니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
PtpConfigCR의 이름입니다.- 2
- 하나 이상의
profile오브젝트의 배열을 지정합니다. - 3
- 프로파일 오브젝트를 고유하게 식별하는 프로파일 오브젝트의 이름을 지정합니다.
- 4
ptp4l서비스에 대한 시스템 구성 옵션을 지정합니다. 옵션은 네트워크 인터페이스 이름과 서비스 구성 파일이 자동으로 추가되므로 네트워크 인터페이스 이름-i <interface>및 서비스 구성 파일-f /etc/ptp4l.conf를 포함하지 않아야 합니다.- 5
ptp4l을 경계 클록으로 시작하는 데 필요한 구성을 지정합니다. 예를 들어ens1f0은 그랜드 마스터 클록에서 동기화되고ens1f3은 연결된 장치를 동기화합니다.- 6
- 동기화 클럭을 수신하는 인터페이스입니다.
- 7
- 동기화 시계를 전송하는 인터페이스입니다.
- 8
- Intel Coumbiaville 800 시리즈 NIC의 경우
tx_timestamp_timeout을50으로 설정합니다. - 9
- Intel Columbiaville 800 시리즈 NIC의 경우
boundary_clock_jbod가0으로 설정되어 있는지 확인합니다. Intel Fortville X710 시리즈 NIC의 경우boundary_clock_jbod가1로 설정되어 있는지 확인합니다. - 10
phc2sys서비스에 대한 시스템 구성 옵션을 지정합니다. 이 필드가 비어 있으면 PTP Operator에서phc2sys서비스를 시작하지 않습니다.- 11
- ptp4l 및 phc2sys 프로세스에 대한 스케줄링 정책입니다. 기본값은-4.8
_OTHER입니다. Havana 스케줄링을지원하는 시스템에서 Retain_VRF를 사용합니다. - 12
ptpSchedulingPolicy가ECDHE_FIFO로 설정된 경우우선 순위를 설정하는 데 사용되는 1-65의 정수 값입니다.ptp4l및phc2sys프로세스의 FIFOptpSchedulingPriority필드는ptpSchedulingPolicy가ECDHE_OTHER로 설정된 경우 사용되지 않습니다.- 13
- 선택 사항:
ptpClockThreshold스탠자가 없으면ptpClockThreshold필드에 기본값이 사용됩니다. 스탠자는 기본ptpClockThreshold값을 표시합니다.ptpClockThreshold값은 PTP 이벤트가 트리거되기 전에 PTP 마스터 클럭이 연결 해제된 후의 기간을 구성합니다.holdOverTimeout은 PTP 마스터 클럭의 연결이 끊어지면 PTP 클럭 이벤트 상태가FREERUN로 변경되기 전 시간(초)입니다.maxOffsetThreshold및minOffsetThreshold설정은CLOCK_REALTIME(phc2sys) 또는 마스터 오프셋(ptp4l)의 값과 비교되는 나노초에 오프셋 값을 구성합니다.ptp4l또는phc2sys오프셋 값이 이 범위를 벗어나는 경우 PTP 클럭 상태가FREERUN로 설정됩니다. 오프셋 값이 이 범위 내에 있으면 PTP 클럭 상태가LOCKED로 설정됩니다. - 14
프로필을 노드에 적용하는 방법에 대한 규칙을 정의하는 하나 이상의recommend오브젝트 배열을 지정합니다.- 15
profile섹션에 정의된profile오브젝트 이름을 지정합니다.- 16
0에서99사이의 정수 값으로priority를 지정합니다. 숫자가 클수록 우선순위가 낮으므로 우선순위99는 우선순위10보다 낮습니다.match필드에 정의된 규칙에 따라 여러 프로필과 노드를 일치시킬 수 있는 경우 우선 순위가 높은 프로필이 해당 노드에 적용됩니다.- 17
nodeLabel또는nodeName으로일치규칙을 지정합니다.- 18
oc get nodes --show-labels명령을 사용하여 노드 오브젝트에서node.Labels의키로nodeLabel을 지정합니다. 예:node-role.kubernetes.io/worker.- 19
oc get nodes명령을 사용하여 노드 오브젝트에서node.Name으로nodeName을 지정합니다. 예:node-role.kubernetes.io/worker. 예:compute-0.example.com.
다음 명령을 실행하여 CR을 생성합니다.
oc create -f boundary-clock-ptp-config.yaml
$ oc create -f boundary-clock-ptp-config.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
PtpConfig프로필이 노드에 적용되었는지 확인합니다.다음 명령을 실행하여
openshift-ptp네임스페이스에서 Pod 목록을 가져옵니다.oc get pods -n openshift-ptp -o wide
$ oc get pods -n openshift-ptp -o wideCopy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
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
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.comCopy to Clipboard Copied! Toggle word wrap Toggle overflow 프로필이 올바른지 확인합니다.
PtpConfig프로필에 지정한 노드에 해당하는linuxptp데몬의 로그를 검사합니다. 다음 명령을 실행합니다.oc logs linuxptp-daemon-4xkbb -n openshift-ptp -c linuxptp-daemon-container
$ oc logs linuxptp-daemon-4xkbb -n openshift-ptp -c linuxptp-daemon-containerCopy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
15.5.4. 듀얼 NIC 하드웨어의 경계 시계로 linuxptp 서비스 구성 링크 복사링크가 클립보드에 복사되었습니다!
경계 시계로 구성된 이중 NIC가 있는 PTP(Precision Time Protocol) 하드웨어는 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.
Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.
각 NIC에 대한 PtpConfig CR(사용자 정의 리소스) 오브젝트를 생성하여 이중 NIC 하드웨어의 경계 시계로 linuxptp 서비스(ptp4l,phc2sys)를 구성할 수 있습니다.
듀얼 NIC 하드웨어를 사용하면 각 NIC가 다운스트림 클럭을 공급하는 별도의 ptp4l 인스턴스와 함께 각 NIC를 동일한 업스트림 리더 시계에 연결할 수 있습니다.
사전 요구 사항
-
OpenShift CLI(
oc)를 설치합니다. -
cluster-admin권한이 있는 사용자로 로그인합니다. - PTP Operator를 설치합니다.
절차
각 NIC에 대해 하나씩 두 개의 개별
PtpConfigCR을 생성하고 각 CR의 기반으로 "Linuxptp 서비스 구성"의 참조 CR을 사용합니다. 예를 들어 다음과 같습니다.phc2sysOpts의 값을 지정하여boundary-clock-ptp-config-nic1.yaml을 생성합니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow boundary-clock-ptp-config-nic2.yaml을 생성하고phc2syss필드를 완전히 제거하여 두 번째 NIC에 대해phc2sys서비스를 비활성화합니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 두 번째 NIC에서
ptp4l을 경계 시계로 시작하는 데 필요한 인터페이스를 지정합니다.
참고두 번째 NIC에서
phc2sysOpts필드를 두 번째PtpConfigCR에서 완전히 제거하여phc2sys서비스를 비활성화해야 합니다.
다음 명령을 실행하여 듀얼 NIC
PtpConfigCR을 생성합니다.첫 번째 NIC에 대해 PTP를 구성하는 CR을 생성합니다.
oc create -f boundary-clock-ptp-config-nic1.yaml
$ oc create -f boundary-clock-ptp-config-nic1.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 두 번째 NIC에 대해 PTP를 구성하는 CR을 생성합니다.
oc create -f boundary-clock-ptp-config-nic2.yaml
$ oc create -f boundary-clock-ptp-config-nic2.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
PTP Operator가 두 NIC에
PtpConfigCR을 적용했는지 확인합니다. 이중 NIC 하드웨어가 설치된 노드에 해당하는linuxptp데몬의 로그를 검사합니다. 예를 들어 다음 명령을 실행합니다.oc logs linuxptp-daemon-cvgr6 -n openshift-ptp -c linuxptp-daemon-container
$ oc logs linuxptp-daemon-cvgr6 -n openshift-ptp -c linuxptp-daemon-containerCopy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
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
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 539Copy to Clipboard Copied! Toggle word wrap Toggle overflow
15.5.5. Intel coumbiaville E800 시리즈 NIC as PTP 일반 클럭 참조 링크 복사링크가 클립보드에 복사되었습니다!
다음 표에서는 Intel coumbiaville E800 시리즈 NIC를 일반 시계로 사용하기 위해 참조 PTP 설정을 변경해야 하는 변경 사항을 설명합니다. 클러스터에 적용하는 PtpConfig CR(사용자 정의 리소스)을 변경합니다.
| PTP 구성 | 권장 설정 |
|---|---|
|
|
|
|
|
|
|
|
|
phc 2sysOpts의 경우-m 은 stdout 에 메시지를 출력합니다. linuxptp-daemon DaemonSet 은 로그를 구문 분석하고 Prometheus 지표를 생성합니다.
15.5.6. PTP 하드웨어에 대한 VRF 우선 순위 스케줄링 구성 링크 복사링크가 클립보드에 복사되었습니다!
대기 시간이 짧은 성능을 요구하는 통신 또는 기타 배포 구성에서 PTP 데몬 스레드는 나머지 인프라 구성 요소와 함께 제한된 CPU 풋프린트에서 실행됩니다. 기본적으로 PTP 스레드는 SCHED_OTHER 정책으로 실행됩니다. 높은 로드에서 이러한 스레드는 오류가 없는 작업에 필요한 스케줄링 대기 시간을 얻지 못할 수 있습니다.
잠재적인 스케줄링 대기 시간 오류가 발생하지 않도록 PTP Operator linuxptp 서비스를 구성하여 스레드를 schedule _ VRF 정책으로 실행할 수 있습니다. ppc _ VRF가 PtpConfig CR에 대해 설정된 경우 ptp4l 및 phc2sys 는 PtpConfig CR의 ptpSchedulingPriority 필드에 의해 설정된 우선 순위로 chrt 의 상위 컨테이너에서 실행됩니다.
ptpSchedulingPolicy 설정은 선택 사항이며 대기 시간 오류가 발생하는 경우에만 필요합니다.
절차
PtpConfigCR 프로필을 편집합니다.oc edit PtpConfig -n openshift-ptp
$ oc edit PtpConfig -n openshift-ptpCopy to Clipboard Copied! Toggle word wrap Toggle overflow ptpSchedulingPolicy및ptpSchedulingPriority필드를 변경합니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
저장 후 종료하여
PtpConfigCR에 변경 사항을 적용합니다.
검증
linuxptp-daemonPod의 이름과PtpConfigCR이 적용된 해당 노드를 가져옵니다.oc get pods -n openshift-ptp -o wide
$ oc get pods -n openshift-ptp -o wideCopy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
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
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.comCopy to Clipboard Copied! Toggle word wrap Toggle overflow 업데이트된
chrtfirst priority로ptp4l프로세스가 실행 중인지 확인합니다.oc -n openshift-ptp logs linuxptp-daemon-lgm55 -c linuxptp-daemon-container|grep chrt
$ oc -n openshift-ptp logs linuxptp-daemon-lgm55 -c linuxptp-daemon-container|grep chrtCopy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
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
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 -mCopy to Clipboard Copied! Toggle word wrap Toggle overflow