47 Precision Time Protocol #
47.1 Introdução #
O Precision Time Protocol (PTP), definido pelo padrão IEEE 1588, distribui tempo de alta precisão através de uma rede de pacotes. Quando as interfaces de rede (NICs) registram o carimbo de data/hora de pacotes PTP em hardware, ele atinge uma precisão de sub-microssegundos, muito além do que o NTP pode oferecer. Em ambientes de telecomunicações, o PTP é um bloco de construção central das redes de acesso via rádio (RAN) 5G, onde as unidades de rádio exigem alinhamento rigoroso de fase e tempo para transmitir corretamente. O SUSE Telco Cloud implementa PTP através do pacote linuxptp e tem como alvo os perfis de telecomunicações ITU-T G.8275.1 e ITU-T G.8275.2 descritos abaixo.
Um domínio PTP é construído a partir de um pequeno conjunto de funções de relógio:
Grandmaster (GM): a fonte primária de tempo para o domínio. Ele normalmente é sincronizado com um Primary Reference Time Clock (PRTC), geralmente controlado por um receptor GNSS, e transmite o tempo para os nós a jusante. A precisão do GM define o teto de qualidade para todo o domínio.
Ordinary Clock (OC): um nó final com uma única porta PTP. Em uma implantação de telecomunicações, ele atua como receptor de tempo, disciplinando seu relógio local a partir de um Grand Master ou Boundary Clock a montante. Um nó de computação executando uma carga de trabalho de rádio é um OC típico.
Boundary Clock (BC): um nó multiporta que recebe tempo em uma porta (receptor de tempo) e o regenera para outros nós em suas portas restantes (transmissor de tempo). A inserção de Boundary Clocks ao longo do caminho encurta o caminho entre cada OC e a referência, limitando o erro que a rede acumularia salto após salto.
A distinção entre um Ordinary Clock e um Boundary Clock é central ao projetar a topologia:
Um Ordinary Clock possui uma única porta PTP e fica na borda do domínio. Ele apenas consome tempo para disciplinar seu próprio relógio e nunca encaminha tempo para outros nós.
Um Boundary Clock possui múltiplas portas PTP. Ele consome tempo em sua porta de receptor de tempo e o regenera em suas portas de transmissor de tempo, encerrando a cadeia de temporização upstream e iniciando uma nova downstream. Essa regeneração é o que evita que erros se acumulem ao longo de uma longa cadeia de nós.
Os seguintes elementos de hardware e sinalização suportam essas funções:
Relógio de Hardware PTP (PHC): o relógio integrado à NIC que o PTP realmente sincroniza. Alinhar o relógio do sistema operacional ao PHC é uma etapa separada tratada por um daemon dedicado.
Ethernet Síncrona (SyncE): sincronização de frequência na camada física. O PTP transporta fase e tempo dentro de pacotes, enquanto o SyncE recupera uma frequência estável diretamente do sinal Ethernet. O SyncE é um aprimoramento opcional: O PTP por si só já fornece fase e tempo, e o SyncE é adicionado apenas quando um nó precisa de maior estabilidade de frequência e maior tempo de espera caso a fonte de tempo PTP seja perdida temporariamente.
Loop de Travamento de Fase Digital (DPLL): um bloco de temporização de hardware que trava em um sinal de referência e o filtra para gerar um relógio estável e limpo. É ele que disciplina o PHC a partir das entradas disponíveis e, em plataformas com mais de uma NIC, mantém os diferentes relógios das NICs alinhados.
Em cada nó, essas funções são realizadas pelos daemons linuxptp: ptp4l executa o protocolo PTP e disciplina o PHC, e phc2sys alinha o relógio do sistema ao PHC. Em um Grandmaster, ts2phc adicionalmente controla o PHC a partir da referência GNSS. Suas funções e instalação são abordadas em Seção 47.2, “Pré-requisitos”.
O relógio de hardware em si é gerenciado pelo subsistema DPLL do kernel Linux em conjunto com o driver de rede. O grau de controle de temporização, e como a temporização é distribuída dentro de um nó com múltiplas NICs, depende de onde o DPLL gerenciável está localizado:
NIC com um DPLL integrado: o DPLL está incorporado na NIC e é configurado através do subsistema DPLL do Linux. Ele seleciona e trava na referência escolhida e disciplina o PHC, oferecendo controle total da frequência e do holdover.
NIC sem um DPLL integrado: a NIC não expõe nenhum DPLL configurável.
ptp4ldisciplina o PHC diretamente, e o subsistema pode, no máximo, relatar o status de travamento (somente leitura); o manuseio avançado de frequência, então, depende de uma fonte de temporização externa.DPLL embarcado compartilhado entre várias NICs: o DPLL não está embutido em uma única NIC, mas reside na plataforma, externo às NICs. Ele disciplina e mantém os PHCs de várias NICs alinhados a partir de uma referência comum, para que cada NIC no nó compartilhe o mesmo tempo. Este arranjo é usado em plataformas multi-NIC que distribuem a temporização internamente em vez de depender de cabeamento externo.
As redes de telecomunicações padronizam dois perfis ITU-T, que diferem principalmente no transporte utilizado e em quanto da rede subjacente deve ser compatível com PTP:
ITU-T G.8275.1 (suporte total de temporização): roda diretamente sobre Ethernet (Camada 2) usando multicast. Cada nó ao longo do caminho deve ser compatível com PTP e atuar como um Boundary Clock, o que proporciona a maior precisão. A menos que indicado de outra forma, os cenários neste guia usam este perfil.
ITU-T G.8275.2 (suporte parcial de temporização): roda sobre IP (Camada 3) usando unicast. Nós intermediários não precisam suportar PTP, portanto a temporização pode cruzar segmentos de rede que não são compatíveis com temporização, ao custo de uma precisão menor.
As figuras a seguir mostram a distribuição de tempo apenas com PTP e com SyncE adicionado como um aprimoramento de frequência opcional. Em ambos os casos, o Grandmaster deriva sua referência de uma fonte PRTC/GNSS e o Boundary Clock regenera a temporização em direção aos endpoints.
Os cenários a seguir são abordados neste guia. Cada cenário inclui um link para sua automação de Cluster API (CAPI).
Cenário 1a - Ordinary Clock (apenas PTP) (Seção 47.3, “Cenário 1a - Ordinary Clock (apenas PTP)”)
Cenário 1b - Ordinary Clock (modo híbrido: PTP & SyncE) (Seção 47.4, “Cenário 1b - Relógio Comum (Modo híbrido: PTP & SyncE)”)
Cenário 2a - Boundary Clock (apenas PTP) com NIC única multiporta, incluindo propagação para servidor Ordinary Clock (Seção 47.5, “Cenário 2a - Relógio de Fronteira (apenas PTP) com NIC única multiporta, incluindo propagação para servidor de Relógio Comum”)
Cenário 2b - Boundary Clock (modo híbrido: PTP e SyncE) com NIC única multiporta, incluindo propagação para servidor Ordinary Clock (Seção 47.6, “Cenário 2b - Boundary Clock (modo híbrido: PTP e SyncE) com NIC única multiporta, incluindo propagação para o servidor Ordinary Clock”)
Cenário 3a - Boundary Clock (apenas PTP) Multi-NIC com módulo de temporização interno (baseado em DPLL GNR-D) (Seção 47.7, “Cenário 3a - Boundary Clock (apenas PTP) multi-NIC com módulo de temporização interno (DPLL baseado em GNR-D)”)
Cenário 3b - Boundary Clock (modo híbrido: PTP e SyncE) Multi-NIC com módulo de temporização interno (baseado em DPLL GNR-D) (Seção 47.8, “Cenário 3b - Boundary Clock (modo híbrido: PTP & SyncE) Multi-NIC com módulo de temporização interno (baseado em DPLL GNR-D)”)
Apenas o Cenário 1a (Seção 47.3, “Cenário 1a - Ordinary Clock (apenas PTP)”) mostra a configuração para ambos os perfis de telecomunicações, ITU-T G.8275.1 e ITU-T G.8275.2. Os cenários restantes focam apenas no caso ITU-T G.8275.1 por brevidade: a implantação é idêntica e apenas o arquivo de configuração ptp4l muda entre os dois perfis.
47.2 Pré-requisitos #
Este guia cobre apenas perfis específicos de telecomunicações, portanto, assume-se o uso de carimbo de data/hora por hardware e um relógio de hardware PTP (PHC) na NIC. Adaptadores de rede de nível de telecomunicações fornecem suporte a PTP em hardware; você pode confirmar os recursos de uma determinada interface com ethtool -T:
# ethtool -T eno16495np0
Time stamping parameters for eno16495np0:
Capabilities:
hardware-transmit
software-transmit
hardware-receive
software-receive
software-system-clock
hardware-raw-clock
PTP Hardware Clock: 0
Hardware Transmit Timestamp Modes:
off
on
Hardware Receive Filter Modes:
none
allVerifique os recursos hardware-transmit, hardware-receive e hardware-raw-clock e um índice PTP Hardware Clock de 0 ou superior (um valor de -1 significa que a interface não possui PHC). Substitua eno16495np0 pela interface que você pretende usar para PTP.
O PTP está incluído no pacote linuxptp. Ele disponibiliza três programas de espaço do usuário — ptp4l, phc2sys e ts2phc — que são executados como daemons de longa duração gerenciados pelo systemd (um serviço dedicado para cada: ptp4l.service, phc2sys.service e ts2phc.service). Coletivamente, eles executam o protocolo e mantêm os relógios sincronizados:
ptp4l: o daemon PTP. Ele executa o protocolo IEEE 1588 nas interfaces configuradas, aplica o Best Master Clock Algorithm (BMCA) para determinar a função de cada porta e disciplina o PHC da NIC. Uma única instância deptp4lpode gerenciar várias portas, o que permite que um nó atue como um Boundary Clock.phc2sys: sincroniza dois relógios. Ele é normalmente usado para alinhar o relógio do sistema (sistema operacional) ao PHC que optp4lmantém sincronizado, para que a hora do sistema também siga o PTP.ts2phc: "time stamp to PHC". Ele disciplina o PHC a partir de um sinal de tempo externo, como o PPS fornecido por um receptor GNSS. Ele é usado em um Grandmaster e para manter múltiplos PHCs alinhados dentro do mesmo nó.
A maneira recomendada de instalar o PTP em um cluster downstream é adicionar o pacote linuxptp ao packageList do arquivo de definição do Edge Image Builder (EIB), para que ele seja implantado automaticamente durante o provisionamento. Veja a documentação do EIB (Seção 5.3.6, “Configurando pacotes RPM”) para obter mais informações sobre a instalação de pacotes.
apiVersion: 1.3
image:
imageType: RAW
arch: x86_64
baseImage: SL-Micro.x86_64-6.2-Base-RT-GM.raw
outputImageName: eibimage-slmicrort-telco.raw
operatingSystem:
systemd:
enable:
- ptp4l
- phc2sys
packages:
packageList:
- linuxptp
sccRegistrationCode: $SCC_REGISTRATION_CODEO pacote linuxptp não habilita ptp4l, phc2sys ou ts2phc por padrão.
Após implantar os arquivos de configuração, use a seção systemd do manifesto para habilitar os daemons de nó necessários (veja os cenários abaixo).
Finalmente, o perfil PTP em uso determina se os switches de rede entre os nós devem ser configurados como dispositivos compatíveis com PTP:
ITU-T G.8275.1 (suporte total de temporização): é executado diretamente sobre Ethernet (Camada 2) usando multicast. Cada nó ao longo do caminho deve ser compatível com PTP e atuar como um Boundary Clock, o que proporciona a maior precisão; portanto, os switches intermediários devem ser configurados para PTP. A menos que indicado de outra forma, os cenários neste guia usam este perfil.
ITU-T G.8275.2 (suporte parcial de temporização): é executado sobre IP (Camada 3) usando unicast. Nós intermediários não precisam oferecer suporte ao PTP, portanto, o tempo pode atravessar segmentos de rede que não são sensíveis ao tempo e os switches não precisam de configuração de PTP, ao custo de menor precisão.
47.3 Cenário 1a - Ordinary Clock (apenas PTP) #
Explicação
Esta é a implantação de PTP mais simples: um único nó de cluster consome tempo de uma fonte upstream e disciplina seus relógios locais, sem nunca encaminhar o tempo para outro nó. O nó é executado como um Ordinary Clock (OC) com uma única porta PTP na função de Time Receiver.
No nó OC, o tempo é tratado inteiramente pelos daemons linuxptp, independentemente do perfil em uso. Nenhuma configuração de DPLL ou ts2phc é necessária, porque o nó usa uma única NIC e o ptp4l disciplina seu PHC diretamente:
O
ptp4lexecuta o protocolo PTP na interface de recepção. O Best Master Clock Algorithm (BMCA) seleciona o nó upstream como mestre, a porta local transita para o estadoSLAVEe optp4ldisciplina o PTP Hardware Clock (PHC) da NIC. DefinirclientOnly 1restringe o nó à função de Time Receiver, portanto, ele nunca pode ser selecionado como mestre.O
phc2sysalinha o relógio do sistema (CLOCK_REALTIME) ao PHC que optp4lmantém sincronizado, para que o horário do sistema operacional também siga o PTP.
O cenário pode ser implementado com qualquer um dos perfis de telecomunicações. Eles diferem no transporte e no que a rede interveniente deve fornecer, e estão documentados abaixo como dois modelos independentes:
Modelo 1 — ITU-T G.8275.1 (Seção 47.3, “Cenário 1a - Ordinary Clock (apenas PTP)”) (multicast de Camada 2): use-o quando cada salto entre o mestre e o OC for compatível com PTP. Ele oferece a maior precisão e é o padrão para implantações de telecomunicações.
Modelo 2 — ITU-T G.8275.2 (Seção 47.3, “Cenário 1a - Ordinary Clock (apenas PTP)”) (unicast de Camada 3): use-o quando o OC precisar alcançar o mestre através de uma rede que não é compatível com PTP, ao custo de menor precisão.
Um Ordinary Clock executa um único perfil PTP por vez. Os dois modelos são mutuamente exclusivos: configure apenas um deles em um determinado nó. Crie apenas o arquivo de configuração do perfil escolhido e referencie apenas esse arquivo em /etc/sysconfig/ptp4l. Não crie ambos /etc/ptp4l-G.8275.1.conf e /etc/ptp4l-G.8275.2.conf, e nunca passe ambos os arquivos para a linha OPTIONS=.
Modelo 1 — ITU-T G.8275.1 (multicast de Camada 2)
O G.8275.1 é executado diretamente sobre Ethernet e endereça suas mensagens ao MAC multicast não encaminhável 01:80:C2:00:00:0E, que bridges padrão não encaminham, portanto, cada dispositivo no caminho deve terminar e regenerar o PTP. Os componentes são:
Grandmaster (GM): a referência upstream para o domínio PTP (domínio
24para G.8275.1), tipicamente travada em uma fonte GNSS/PRTC.PTP-aware switch: atua como um Boundary Clock. Sua porta em direção ao GM é um Time Receiver e sua porta em direção ao OC é um Time Transmitter. Ambas as portas devem estar com o PTP habilitado.
Ordinary Clock (OC): o nó do cluster, recebendo tempo em sua única porta PTP.
Configure o nó da seguinte forma:
Identifique o índice PHC
<N>da interface usada para PTP (aquieno8403np1); o valor do campo impressoPTP Hardware Clock(que também pode aparecer comoHardware timestamp provider index) fornece o dispositivo/dev/ptp<N>que optp4ldisciplina e que ophc2syslê como sua fonte:# ethtool -T eno8403np1 Time stamping parameters for eno8403np1: Capabilities: hardware-transmit hardware-receive hardware-raw-clock PTP Hardware Clock: 1 ...Neste exemplo, o PHC de
eno8403np1é/dev/ptp1.Crie o
ptp4l`arquivo de configuração `/etc/ptp4l-G.8275.1.conf. A interface é declarada como uma seção ([eno8403np1]), portanto, o daemon não precisa da flag-i:Exemplo 47.1: Configuração de Relógio Comum — ITU-T G.8275.1 ## Telecom G.8275.1 — Ordinary Clock (Time Receiver) [global] domainNumber 24 priority2 255 dataset_comparison G.8275.x G.8275.portDS.localPriority 128 G.8275.defaultDS.localPriority 128 maxStepsRemoved 255 logAnnounceInterval -3 logSyncInterval -4 logMinDelayReqInterval -4 announceReceiptTimeout 3 clientOnly 1 ptp_dst_mac 01:80:C2:00:00:0E network_transport L2 summary_interval 3 message_tag "ptp4l" uds_address /var/run/ptp4l uds_ro_address /var/run/ptp4lro [eno8403np1]
O valor
ptp_dst_macé fixo para G.8275.1: é o endereço multicast não encaminhável01:80:C2:00:00:0Eque confina o PTP a um único link e é a razão pela qual cada dispositivo no caminho deve ser compatível com PTP. Ouds_addressexpõe um socket de gerenciamento que ophc2sysusa para acompanhar o estado da porta.Aponte
ptp4lpara este arquivo em/etc/sysconfig/ptp4l:OPTIONS="-f /etc/ptp4l-G.8275.1.conf"
Configure
phc2sysem/etc/sysconfig/phc2syspara disciplinar o relógio do sistema a partir do PHC da interface PTP (/dev/ptp1). Os valores--uds_addresse--domainNumberdevem corresponder à configuraçãoptp4l:OPTIONS="-s /dev/ptp1 -w -m --uds_address /var/run/ptp4l --domainNumber 24"
-s /dev/ptp1seleciona o PHC como o relógio de origem,-waguardaptp4lpara sincronizar antes de ajustar o relógio do sistema, e-mimprime o status do servo no log.Habilite e inicie ambos os serviços:
# systemctl enable --now ptp4l phc2sysVerifique se
ptp4ltravou no upstream master. A porta muda paraSLAVEe o offset relatado (rms) converge para um valor baixo e estável:# journalctl -u ptp4l -f ptp4l[...]: "ptp4l" port 1 (eno8403np1): UNCALIBRATED to SLAVE on MASTER_CLOCK_SELECTED ptp4l[...]: "ptp4l" rms 1502498567 max 8499416372 freq -3977 +/- 43609 delay 11 +/- 607 ptp4l[...]: "ptp4l" rms 40 max 99 freq +10129 +/- 30 delay 211 +/- 3 ptp4l[...]: "ptp4l" rms 7 max 15 freq +10125 +/- 13 delay 211 +/- 2 ptp4l[...]: "ptp4l" rms 6 max 16 freq +10118 +/- 12 delay 213 +/- 2Verifique se
phc2sysestá disciplinando o relógio do sistema. O estado do servo progride des0(desbloqueado) através des1(passo inicial) paras2(travado), e o offset estabiliza em torno de zero:# journalctl -u phc2sys -f phc2sys[...]: CLOCK_REALTIME phc offset 45583145631 s0 freq -1673 delay 0 phc2sys[...]: CLOCK_REALTIME phc offset 45583157513 s1 freq +10207 delay 0 phc2sys[...]: CLOCK_REALTIME phc offset 4 s2 freq +10211 delay 0 phc2sys[...]: CLOCK_REALTIME phc offset 13 s2 freq +10221 delay 0Um estado
s2estável com um pequeno offset confirma que o nó está travado e o relógio do sistema está seguindo o PTP.
Modelo 2 — ITU-T G.8275.2 (unicast de Camada 3)
O G.8275.2 é executado sobre IP (Camada 3) usando unicast: o OC troca mensagens diretamente com o endereço IP do master, portanto a rede interveniente não precisa ser compatível com PTP e nenhum switch habilitado para PTP é necessário. Os componentes são:
Master (GM ou Boundary Clock): o master upstream, acessível por IP no domínio G.8275.2 (domínio
44).Rede IP: uma rede roteada ou comutada padrão. Ela encaminha os pacotes PTP unicast sem qualquer configuração PTP.
Relógio Comum (OC): o nó do cluster, enviando solicitações unicast para o master a partir de sua única porta PTP.
Configure o nó da seguinte forma:
Identifique o PHC da interface PTP como no Modelo 1 (
ethtool -T eno8403np1); neste exemplo, o PHC deeno8403np1é/dev/ptp1.Crie o
ptp4l`arquivo de configuração `/etc/ptp4l-G.8275.2.conf. Não háptp_dst_mac, porque o master é alcançado por IP através daunicast_master_table. Substitua$MASTER_IP_ADDRESSpelo endereço IP do master upstream:Exemplo 47.2: Configuração do Relógio Comum — ITU-T G.8275.2 ## Telecom G.8275.2 — Ordinary Clock (Time Receiver) [global] domainNumber 44 priority2 255 dataset_comparison G.8275.x G.8275.portDS.localPriority 128 G.8275.defaultDS.localPriority 128 maxStepsRemoved 255 logAnnounceInterval 0 logSyncInterval -5 logMinDelayReqInterval -4 announceReceiptTimeout 2 clientOnly 1 network_transport UDPv4 hybrid_e2e 1 inhibit_multicast_service 1 unicast_listen 1 unicast_req_duration 60 message_tag "ptp4l" uds_address /var/run/ptp4l uds_ro_address /var/run/ptp4lro [unicast_master_table] table_id 1 logQueryInterval 2 UDPv4 $MASTER_IP_ADDRESS [eno8403np1] unicast_master_table 1
Aponte
ptp4lpara este arquivo em/etc/sysconfig/ptp4l:OPTIONS="-f /etc/ptp4l-G.8275.2.conf"
Configure
phc2sysem/etc/sysconfig/phc2syscom o número de domínio G.8275.2 (44); o PHC de origem e--uds_addresspermanecem inalterados:OPTIONS="-s /dev/ptp1 -w -m --uds_address /var/run/ptp4l --domainNumber 44"
Habilite e inicie ambos os serviços:
# systemctl enable --now ptp4l phc2sysVerifique a sincronização como no Modelo 1:
ptp4lmove a porta paraSLAVE(journalctl -u ptp4l) ephc2sysatinge o estados2(travado) com um deslocamento próximo de zero (journalctl -u phc2sys).
Automação CAPI
Para implantar este cenário usando o fluxo de trabalho de provisionamento automatizado, use o modelo genérico de Cluster API descrito em Provisionamento de rede direcionado totalmente automatizado (Seção 55.1, “Precision Time Protocol (PTP)”), substituindo seus placeholders pelos valores para este cenário mostrados abaixo.
| Placeholder | Valor |
|---|---|
|
|
| Copie o conteúdo de a configuração G.8275.1 acima (Exemplo 47.1, “Configuração de Relógio Comum — ITU-T G.8275.1”). |
|
|
|
|
| Placeholder | Valor |
|---|---|
|
|
| Copie o conteúdo de a configuração G.8275.2 acima (Exemplo 47.2, “Configuração do Relógio Comum — ITU-T G.8275.2”). |
|
|
|
|
47.4 Cenário 1b - Relógio Comum (Modo híbrido: PTP & SyncE) #
Este cenário ainda não é suportado; ele será incluído em uma versão futura do SUSE Telco Cloud.
47.5 Cenário 2a - Relógio de Fronteira (apenas PTP) com NIC única multiporta, incluindo propagação para servidor de Relógio Comum #
Explicação
Este cenário estende a cadeia de temporização com um Relógio de Fronteira (BC) que regenera o PTP em direção a um Relógio Comum (OC) downstream, inteiramente sobre ITU-T G.8275.1 (apenas PTP, Camada 2). O BC usa uma única NIC multiporta: uma instância de ptp4l gerencia várias portas na mesma NIC, portanto, nem ts2phc nem roteamento DPLL são necessários (ao contrário dos cenários de múltiplas NICs).
O cenário envolve os seguintes componentes:
Grandmaster (GM): a referência para o domínio PTP (domínio
24), normalmente travado em uma fonte GNSS/PRTC (a bancada de teste usada aqui não possui GNSS, daí ogm.ClockClassdegradado mostrado mais adiante). Ele envia o tempo no segmento upstream.Switch compatível com PTP: atua como um Relógio de Fronteira (T-BC) no caminho de temporização; cada porta que transporta PTP possui
ptp enable.Relógio de Fronteira (servidor BC): um nó multiporta em uma única NIC que faz a ponte entre dois segmentos PTP. Sua porta
eno8403np1está voltada para o segmento upstream como um Receptor de Tempo (SLAVE) e disciplina o PHC da NIC;eno8503np2(eeno8603np3) estão voltadas para o segmento downstream como Transmissores de Tempo que regeneram o PTP. O BC termina a cadeia de temporização upstream e inicia uma nova downstream.Relógio Comum (servidor OC): um nó de porta única (
ens6f0np0) no segmento downstream, onde seu único mestre PTP é o BC. Ele disciplina seus relógios locais a partir do tempo que o BC regenera.
A temporização é gerenciada pelos daemons linuxptp em cada nó:
No BC server, uma única instância
ptp4lgerencia todas as suas portas. O BMCA seleciona o GM como mestre emeno8403np1, que muda paraSLAVEe disciplina o PHC.eno8503np2eeno8603np3são forçados aserverOnly 1, portanto, eles atuam apenas como Transmissores de Tempo. Como todas as portas compartilham o mesmo PHC da NIC, o tempo recebido está diretamente disponível para as portas de transmissão; um Boundary Clock é implícito automaticamente quando mais de uma porta é configurada, portanto, nenhuma configuraçãoclock_typeouts2phcé necessária.No OC server,
ptp4lé executado comclientOnly 1emens6f0np0, portanto, a porta atua apenas como um Receptor de Tempo.phc2sysalinha o relógio do sistema ao PHC.No servidor OC,
clientOnly 1é o que garante que ele nunca se torne um mestre. O atributolocalPriority— usado pelo BMCA G.8275.x apenas como critério de desempate, quando clockClass, clockAccuracy, variance e priority2 são iguais, onde um valor menor é preferido — reforça essa ordenação: o servidor BC mantém o128padrão, enquanto o servidor OC usa o250de menor preferência.
O BC faz a ponte entre dois segmentos PTP separados: um segmento upstream entre o GM e sua porta eno8403np1, e um segmento downstream entre sua porta eno8503np2 e o OC. Eles são mantidos separados, por exemplo, em VLANs diferentes do switch ou em redes separadas. Como o BC é o único mestre no segmento downstream, o OC sincroniza a partir do BC e nunca diretamente do GM.
Como no Scenario 1a (Seção 47.3, “Cenário 1a - Ordinary Clock (apenas PTP)”), este cenário usa o MAC multicast não encaminhável 01:80:C2:00:00:0E; bridges padrão não o encaminham, portanto, cada dispositivo compatível com PTP termina e regenera o PTP. O mesmo endereço deve ser definido em cada nó do caminho de temporização.
Diagrama
Configuração
Cada porta de switch no caminho de temporização (em direção ao GM, ao BC e ao OC) deve estar com o PTP habilitado. Os dois nós do cluster são então configurados da seguinte forma.
Boundary Clock (servidor BC)
Identifique o PHC da NIC PTP (
ethtool -T eno8403np1); em uma única NIC, todas as portas compartilham o mesmo PHC. Neste exemplo, é/dev/ptp1.Crie
/etc/ptp4l-G.8275.1.conf. A porta receptora[eno8403np1]não tem flag de função, então o BMCA a seleciona como Time Receiver;[eno8503np2]e[eno8603np3]são definidos comoserverOnly 1para atuar como Time Transmitters. Declarar mais de uma porta implica um Boundary Clock:Exemplo 47.3: Configuração de Boundary Clock ## Telecom G.8275.1 — Boundary Clock (multi-port, single NIC) [global] domainNumber 24 priority2 255 dataset_comparison G.8275.x G.8275.portDS.localPriority 128 G.8275.defaultDS.localPriority 128 maxStepsRemoved 255 logAnnounceInterval -3 logSyncInterval -4 logMinDelayReqInterval -4 announceReceiptTimeout 3 ptp_dst_mac 01:80:C2:00:00:0E network_transport L2 summary_interval 3 message_tag "ptp4l" uds_address /var/run/ptp4l uds_ro_address /var/run/ptp4lro [eno8403np1] [eno8503np2] serverOnly 1 [eno8603np3] serverOnly 1
Aponte
ptp4lpara este arquivo em/etc/sysconfig/ptp4l:OPTIONS="-f /etc/ptp4l-G.8275.1.conf"
Opcionalmente, alinhe o relógio do sistema com
phc2sysem/etc/sysconfig/phc2sys, usando o PHC da NIC compartilhada como fonte:OPTIONS="-s /dev/ptp1 -w -m --uds_address /var/run/ptp4l --domainNumber 24"
Habilite e inicie os serviços e verifique se
eno8403np1está sincronizado com o GM. A porta receptora muda paraSLAVEe o offset (rms) converge para um valor baixo:# systemctl enable --now ptp4l phc2sys # journalctl -u ptp4l -f ptp4l[...]: "ptp4l" selected best master clock d0460c.ffff.05c130 ptp4l[...]: "ptp4l" port 1 (eno8403np1): UNCALIBRATED to SLAVE on MASTER_CLOCK_SELECTED ptp4l[...]: "ptp4l" rms 8 max 24 freq +10092 +/- 18 delay 211 +/- 2 ptp4l[...]: "ptp4l" rms 4 max 11 freq +10069 +/- 7 delay 210 +/- 2 ptp4l[...]: "ptp4l" rms 3 max 9 freq +10070 +/- 6 delay 213 +/- 3
Ordinary Clock (servidor OC)
Identifique o PHC da interface PTP (
ethtool -T ens6f0np0); neste exemplo, é/dev/ptp1.Crie
/etc/ptp4l-G.8275.1.confcom uma única porta eclientOnly 1, para que o nó atue apenas como Time Receiver. OlocalPrioritymais alto (250) o mantém abaixo do BC no BMCA :Exemplo 47.4: Configuração de Ordinary Clock: ## Telecom G.8275.1 — Ordinary Clock (Time Receiver) [global] domainNumber 24 priority2 255 dataset_comparison G.8275.x G.8275.portDS.localPriority 250 G.8275.defaultDS.localPriority 250 maxStepsRemoved 255 logAnnounceInterval -3 logSyncInterval -4 logMinDelayReqInterval -4 announceReceiptTimeout 3 clientOnly 1 ptp_dst_mac 01:80:C2:00:00:0E network_transport L2 summary_interval 3 message_tag "ptp4l" uds_address /var/run/ptp4l uds_ro_address /var/run/ptp4lro [ens6f0np0]
Configure
/etc/sysconfig/ptp4le/etc/sysconfig/phc2syscomo para o BC (a fontephc2sysé o PHC deens6f0np0), então habilite e inicie os serviços:# /etc/sysconfig/ptp4l OPTIONS="-f /etc/ptp4l-G.8275.1.conf" # /etc/sysconfig/phc2sys OPTIONS="-s /dev/ptp1 -w -m --uds_address /var/run/ptp4l --domainNumber 24"
Verifique se
ens6f0np0está sincronizado com o tempo regenerado do BC. A porta muda paraSLAVEe o offset (rms) estabiliza:# journalctl -u ptp4l -f ptp4l[...]: "ptp4l" selected best master clock d0460c.ffff.05c130 ptp4l[...]: "ptp4l" port 1 (ens6f0np0): UNCALIBRATED to SLAVE on MASTER_CLOCK_SELECTED ptp4l[...]: "ptp4l" rms 15 max 34 freq +11699 +/- 25 delay 468 +/- 5 ptp4l[...]: "ptp4l" rms 13 max 30 freq +11701 +/- 23 delay 468 +/- 4 ptp4l[...]: "ptp4l" rms 14 max 30 freq +11697 +/- 24 delay 467 +/- 4O OC obtém seu tempo do Boundary Clock upstream, que é seu mestre imediato. A linha
selected best master clock, no entanto, relata a identidade do Grandmaster (d0460c.ffff.05c130, o GM) e não a do Boundary Clock: um Boundary Clock encaminha a identidade do Grandmaster inalterada enquanto anuncia sua própria porta como o pai, para que a cadeia permaneça rastreável até o Grandmaster. Para ver ambas as identidades explicitamente, consulte o conjunto de dados pai no OC (exemplo de saída):# pmc -f /etc/ptp4l-G.8275.1.conf -u -b 0 'GET PARENT_DATA_SET' sending: GET PARENT_DATA_SET 507c6f.fffe.4ae178-0 seq 0 RESPONSE MANAGEMENT PARENT_DATA_SET parentPortIdentity 000000.fffe.001101-2 parentStats 0 observedParentOffsetScaledLogVariance 0xffff observedParentClockPhaseChangeRate 0x7fffffff grandmasterPriority1 128 gm.ClockClass 165 gm.ClockAccuracy 0xfe gm.OffsetScaledLogVariance 0xffff grandmasterPriority2 120 grandmasterIdentity d0460c.ffff.05c130As duas identidades diferem, o que é exatamente o que uma implantação de Boundary Clock deve mostrar:
parentPortIdentity(000000.fffe.001101-2) — o mestre imediato: a porta de transmissão do Boundary Clock, o clock do qual o OC realmente recebe o tempo.grandmasterIdentity(d0460c.ffff.05c130) — a raiz da árvore de temporização: o Grandmaster, encaminhado inalterado através do Boundary Clock.Os valores
gm.ClockClass,gm.ClockAccuracyegrandmasterPrioritycarregam a qualidade anunciada do Grandmaster usada pelo BMCA. Se as duas identidades fossem iguais, o OC estaria sincronizando diretamente de um Grandmaster, sem nenhum Boundary Clock no caminho.
Automação CAPI
Para implantar este cenário usando o fluxo de trabalho de provisionamento automatizado, use o modelo genérico de Cluster API descrito em Provisionamento de rede direcionado totalmente automatizado (Seção 55.1, “Precision Time Protocol (PTP)”) em cada nó, substituindo seus espaços reservados pelos valores abaixo.
| Placeholder | Valor |
|---|---|
|
|
| Copie o conteúdo de da configuração do Boundary Clock acima (Exemplo 47.3, “Configuração de Boundary Clock”). |
|
|
|
|
| Placeholder | Valor |
|---|---|
|
|
| Copie o conteúdo de da configuração do Ordinary Clock acima (Exemplo 47.4, “Configuração de Ordinary Clock:”). |
|
|
|
|
47.6 Cenário 2b - Boundary Clock (modo híbrido: PTP e SyncE) com NIC única multiporta, incluindo propagação para o servidor Ordinary Clock #
Este cenário ainda não é suportado; ele será incluído em uma versão futura do SUSE Telco Cloud.
47.7 Cenário 3a - Boundary Clock (apenas PTP) multi-NIC com módulo de temporização interno (DPLL baseado em GNR-D) #
Explicação
SUSE Telco Cloud suporta temporização precisa em uma variedade de plataformas, incluindo os projetos mais recentes baseados em Intel Granite Rapids-D (GNR-D). Esses servidores normalmente incluem um controlador Ethernet de alta velocidade integrado e uma ou mais placas adicionais (AICs) com um controlador Ethernet para portas extras. Ao contrário das gerações de plataforma anteriores, eles também são equipados com um DPLL dedicado que roteia os sinais de temporização através do sistema e das diferentes NICs internamente, não exigindo mais cabeamento externo para manter todos os PHCs das NICs sincronizados. A implantação geral é, portanto, simplificada, mas etapas e componentes de software específicos são necessários, como o DPLL no momento da inicialização e a configuração do sinal interno.
Este cenário estende o Cenário 2a (Seção 47.5, “Cenário 2a - Relógio de Fronteira (apenas PTP) com NIC única multiporta, incluindo propagação para servidor de Relógio Comum”) para um Boundary Clock (BC) construído em várias NICs, inteiramente sobre ITU-T G.8275.1 (apenas PTP, Camada 2). Uma porta do controlador integrado recebe PTP do Grandmaster e as placas adicionais regeneram o PTP downstream. Ao contrário do caso de NIC única, cada NIC tem seu próprio PHC; o DPLL integrado e ts2phc os mantêm alinhados, e uma instância de ptp4l é executada por PHC.
Nesta versão SUSE Telco Cloud, este cenário é suportado apenas para a variante de kernel "default" (ou seja, não "PREEMPT_RT"). O suporte para a variante de kernel "RT" será adicionado em uma versão futura.
Baixe e instale o driver de kernel mais recente para os Intel 800 Series Network Devices a partir do site da Intel.
Selecione o arquivo zip contendo os "ice_RPM_Files", descompacte o arquivo e instale o
ice-kmp-default-*sles16sp0.x86_64.rpm. Este RPM contém, por exemplo,ice-kmp-default-2.4.5_k6.12.0_160000.5-1.sles16sp0.x86_64.rpm:# transactional-update pkg install ice-kmp-default-2.4.5_k6.12.0_160000.5-1.sles16sp0.x86_64.rpmReinicie o servidor para tornar a alteração persistente e efetiva.
Um sistema Dell PowerEdge XR8720t é usado como sistema de referência nos exemplos; as interfaces de kernel e a configuração de porta podem ser diferentes em um servidor GNR-D diferente. Ajuste os nomes dos dispositivos de acordo.
Assume-se uma implantação de telco e o arquivo de controle de telco G.8275.1 é usado nas seções a seguir.
O cenário envolve os seguintes componentes:
Grandmaster (GM): a referência para o domínio PTP (domínio
24), no segmento upstream.Switch compatível com PTP: atua como um Relógio de Fronteira (T-BC) no caminho de temporização; cada porta que transporta PTP possui
ptp enable. Os segmentos upstream e downstream são mantidos separados em VLANs diferentes do switch (uma VLAN dedicada para cada segmento).Boundary Clock (BC server): o nó GNR-D. Seu controlador integrado recebe PTP do GM em
eno8403np1e disciplina o PHC integrado (/dev/ptp1). O DPLL integrado distribui esse tempo para as placas add-in ets2phcmantém seus PHCs (/dev/ptp2,/dev/ptp3) alinhados com/dev/ptp1. Cada placa add-in regenera o PTP downstream (por exemplo, emeno16495np0), atuando como um Transmissor de Tempo.Ordinary Clock (OC server): um nó de porta única (
ens6f0np0) no segmento downstream, cujo único mestre PTP é o BC.
O tempo no BC server é gerenciado por vários daemons linuxptp trabalhando juntos, porque os PHCs são fisicamente separados:
Uma instância de
ptp4lno controlador integrado (/dev/ptp1) executa o protocolo PTP emeno8403np1. O BMCA seleciona o GM como mestre, a porta muda paraSLAVEeptp4ldisciplina/dev/ptp1.O DPLL integrado é cabeado de modo que o PHC integrado o controle através dos pinos SDP, e o DPLL, por sua vez, controla os relógios das placas add-in. Este é o substituto interno para o cabeamento 1PPS externo usado em plataformas anteriores.
ts2phcmantém os PHCs das placas add-in alinhados a/dev/ptp1a partir do sinal que o DPLL distribui.Uma instância
ptp4lseparada por placa add-in (/dev/ptp2,/dev/ptp3) regenera o PTP em suas portas, todas forçadas paraserverOnly 1(Time Transmitters).Um Boundary Clock deve encaminhar os atributos auxiliares do Grandmaster (classe de relógio, precisão, etc.) além do tempo. Isso acontece automaticamente apenas dentro de uma única instância
ptp4l, portanto,pmcé usado para encaminhar esses valores da instância integrada para as instâncias add-in (veja o passo 5).pmc(cliente de gerenciamento PTP) é a ferramentalinuxptpque consulta e atualiza o estado de runtime de uma instânciaptp4lem execução através de seu socket de gerenciamento.
No controlador integrado, apenas uma de suas portas é a porta administrativa que gerencia o PHC. Inspecione /sys/class/ptp/ptp1/device/net/ para encontrá-la (por exemplo, eno8703np0); é a porta usada para configurar os sinais DPLL, e não é necessariamente a porta que transporta PTP (eno8403np1).
A configuração descrita aqui é completamente estática. Se o GM ficar indisponível, a sincronização downstream dependerá exclusivamente das capacidades de holdover do host; nenhuma alternância automática para uma fonte diferente de referência de tempo será realizada.
Diagrama
Configuração
Cada porta de switch no caminho de temporização deve estar com o PTP habilitado. O servidor BC é então iniciado na ordem abaixo. Cada etapa de tempo de execução também é mapeada para uma unidade systemd para que a configuração sobreviva a reinicializações e possa ser automatizada com a Cluster API (veja a automação CAPI do GNR-D (Seção 55.1.2, “Cenários multi-NIC GNR-D (DPLL)”)). O servidor OC é configurado exatamente como no Cenário 2a (Seção 47.5, “Cenário 2a - Relógio de Fronteira (apenas PTP) com NIC única multiporta, incluindo propagação para servidor de Relógio Comum”).
Identifique os dispositivos PTP e o controlador integrado.
Liste os relógios PTP e o dispositivo PCI ao qual cada um está vinculado:
# ls -l /sys/class/ptp/ lrwxrwxrwx 1 root root 0 ... ptp1 -> ../../devices/pci0000:12/0000:12:04.0/0000:13:00.0/ptp/ptp1 lrwxrwxrwx 1 root root 0 ... ptp2 -> ../../devices/pci0000:6b/0000:6b:02.0/0000:6c:00.0/ptp/ptp2 lrwxrwxrwx 1 root root 0 ... ptp3 -> ../../devices/pci0000:6b/0000:6b:06.0/0000:6e:00.0/ptp/ptp3Execute
lspcipara identificar cada tipo de dispositivo, permitindo distinguir entre o controlador integrado e as placas add-in:# lspci -s 0000:13:00.0 13:00.0 Ethernet controller: Intel Corporation Ethernet Connection E825-C for SFP (rev 04) # lspci -s 0000:6c:00.0 6c:00.0 Ethernet controller: Intel Corporation Ethernet Controller E830-CC for SFP # lspci -s 0000:6e:00.0 6e:00.0 Ethernet controller: Intel Corporation Ethernet Controller E830-CC for SFPEste servidor de referência possui um controlador integrado Intel E825-C (
/dev/ptp1) e duas placas add-in E830-CC (/dev/ptp2,/dev/ptp3).Identifique a porta administrativa do controlador integrado, que gerencia seu PHC:
# ls /sys/class/ptp/ptp1/device/net/ eno8703np0 # ethtool -i eno8703np0 driver: ice version: 2.4.5 [...]
Configure os sinais de temporização internos (DPLL).
Conecte o PHC integrado ao DPLL e deixe o DPLL alimentar as placas add-in, usando a porta administrativa encontrada acima (
eno8703np0) e os índicesptpNcorretos:Exemplo 47.5:01-gnrd-startup-setup.sh##!/bin/bash # The admin port that manages the PHC is under /sys/class/ptp/ptp1/device/net/ (e.g. eno8703np0). # Only one port of the integrated E825-C NIC exposes it. # Let the DPLL drive the Ethernet clock on the integrated controller echo 4 1 > /sys/class/net/eno8703np0/device/tspll_cfg # Feed the DPLL from the integrated PHC through the SDP pins: # SDP0 -> 1 pulse per second (1PPS, 1 Hz): enable the pin, then set a 1 s period echo 2 2 > /sys/class/ptp/ptp1/pins/SDP0 echo 2 0 0 1 0 > /sys/class/ptp/ptp1/period # SDP2 -> 1000 pulses per second (1kPPS, 1 kHz): enable the pin, then set a 1 ms period echo 2 1 > /sys/class/ptp/ptp1/pins/SDP2 echo 1 0 0 0 1000000 > /sys/class/ptp/ptp1/period # Propagate the pulses from the DPLL to the add-in cards (SDP1 on each add-in PHC) echo 1 1 > /sys/class/ptp/ptp2/pins/SDP1 echo 1 1 > /sys/class/ptp/ptp3/pins/SDP1Essas configurações são perdidas na reinicialização, portanto, execute o script na inicialização a partir de uma unidade
systemddo tipo oneshot, ordenada antes dets2phceptp4l:# /etc/systemd/system/gnrd-ptp-dpll-setup.service [Unit] Description=GNR-D PTP DPLL and internal signal setup Before=ts2phc.service ptp4l@nac.service ptp4l@aic1.service ptp4l@aic2.service [Service] Type=oneshot RemainAfterExit=yes ExecStart=/usr/local/bin/01-gnrd-startup-setup.sh [Install] WantedBy=multi-user.targetAlinhe os PHCs das placas add-in com
ts2phc.ts2phc("time stamp to PHC") alinha os PHCs das placas add-in a um relógio de referência. Aqui, a referência é o PHC da NIC integrada (/dev/ptp1, já disciplinado pelo GM através de sua instânciaptp4l), passado na linha de comando com-s /dev/ptp1. O DPLL integrado fornece o 1PPS derivado dessa referência para cada placa add-in em seu pinoSDP1;ts2phcregistra o carimbo de data/hora desses pulsos de entrada (EXTTS) e ajusta o PHC de cada placa add-in de acordo, para que todos os PHCs no nó acabem compartilhando o mesmo tempo.NotaO alinhamento dos PHCs das placas add-in requer duas configurações complementares, em níveis diferentes:
Hardware: o pino de entrada
SDP1de cada PHC da placa add-in deve ser habilitado para que o DPLL integrado entregue o pulso 1PPS a ele. Isso é feito no script de configuração do DPLL da etapa anterior (echo 1 1 > /sys/class/ptp/ptpN/pins/SDP1).Software: o
ts2phcdeve ser instruído a registrar o carimbo de data/hora dessa entrada e ajustar o PHC. É isso que a configuração abaixo faz (ts2phc.channel,ts2phc.pin_index,ts2phc.extts_polarity).
Sem habilitar o pino, o pulso nunca chega ao PHC; sem a configuração
ts2phc, o pulso nunca é aplicado a ele. Ambos são necessários.Crie seu arquivo de configuração:
Exemplo 47.6:/etc/ts2phc-cf-all.cfg— arquivo de configuraçãots2phc#[global] use_syslog 0 verbose 1 logging_level 7 ts2phc.pulsewidth 100000000 [eno16495np0] ts2phc.channel 1 ts2phc.extts_polarity rising ts2phc.pin_index 1 [eno16595np0] ts2phc.channel 1 ts2phc.extts_polarity rising ts2phc.pin_index 1
Cada placa add-in é configurada por meio de uma seção nomeada após sua primeira porta (
[eno16495np0],[eno16595np0]), que identifica o PHC a ser disciplinado. Os parâmetros mapeiam o pulso do DPLL para essa placa add-in:ts2phc.pin_indexets2phc.channel: o pino e o canal onde o DPLL entrega o 1PPS (SDP1nesta configuração, portantopin_index 1).ts2phc.extts_polarity: a borda do pulso a ser registrada (rising).ts2phc.pulsewidth: a largura de pulso de entrada esperada, em nanossegundos (100 ms aqui).Execute-o manualmente como
ts2phc -f /etc/ts2phc-cf-all.cfg -s /dev/ptp1 -m, ou deixesystemdgerenciá-lo através de/etc/sysconfig/ts2phc:# /etc/sysconfig/ts2phc OPTIONS="-f /etc/ts2phc-cf-all.cfg -s /dev/ptp1 -m"
Execute uma instância
ptp4lpor PHC.O controlador integrado executa uma instância orientada por BMCA (o receptor), e cada placa add-in executa uma instância com todas as portas forçadas para
serverOnly 1. Cada instância deve usar um socket de controle e um socket somente leitura diferentes. Crie os três arquivos de configuração:Exemplo 47.7:/etc/ptp4l-nac.conf— controlador integrado (/dev/ptp1) ## Telecom G.8275.1 — integrated controller (receiver) [global] domainNumber 24 priority2 255 dataset_comparison G.8275.x G.8275.portDS.localPriority 128 G.8275.defaultDS.localPriority 128 maxStepsRemoved 255 logAnnounceInterval -3 logSyncInterval -4 logMinDelayReqInterval -4 announceReceiptTimeout 3 ptp_dst_mac 01:80:C2:00:00:0E network_transport L2 summary_interval 3 message_tag "ptp4l-nac" uds_address /var/run/ptp4l-nac uds_ro_address /var/run/ptp4lro-nac [eno8403np1]
A instância integrada declara apenas
eno8403np1, a porta que recebe PTP do GM, e não defineserverOnlyouclientOnlynela: ela depende do BMCA para atribuir a função. Com um GM alcançável emeno8403np1, o BMCA o seleciona como o Receptor de Tempo (SLAVE) e disciplina/dev/ptp1. As outras portas do controlador integrado não são declaradas, porque neste nó a downstream regeneração é realizada pelas placas add-in em vez do controlador integrado. As placas add-in, em contraste, forçamserverOnly 1porque devem ser sempre Transmissores de Tempo — elas obtêm seu tempo do DPLL ets2phc, não recebendo PTP, portanto, nunca devem ser eleitas como receptores. Se for necessário um controle mais rigoroso, adicione a flagserverOnlyouclientOnlyexplicitamente sob a interface.Os valores de
G.8275.portDS.localPriorityeG.8275.defaultDS.localPriority(128na instância integrada,250nas placas add-in) atuam como um desempate BMCA G.8275.x: eles são comparados apenas apósclockClass,clockAccuracy, variância epriority2, e um valor menor é preferido. Manter o128padrão na instância integrada faz com que ela supere as instâncias add-in (250), o que mantém a ordenação Transmissor de Tempo/Receptor de Tempo dentro do nó determinística e direciona qual porta o BMCA elege, conforme refletido nos estados de porta relatados porptp4l.Exemplo 47.8:/etc/ptp4l-aic1.conf— placa add-in 1 (/dev/ptp2) ## Telecom G.8275.1 — add-in card (Time Transmitter) [global] domainNumber 24 priority2 255 dataset_comparison G.8275.x G.8275.portDS.localPriority 250 G.8275.defaultDS.localPriority 250 maxStepsRemoved 255 logAnnounceInterval -3 logSyncInterval -4 logMinDelayReqInterval -4 announceReceiptTimeout 3 ptp_dst_mac 01:80:C2:00:00:0E network_transport L2 summary_interval 3 message_tag "ptp4l-aic1" uds_address /var/run/ptp4l-aic1 uds_ro_address /var/run/ptp4lro-aic1 [eno16495np0] serverOnly 1
Exemplo 47.9:/etc/ptp4l-aic2.conf— placa add-in 2 (/dev/ptp3) ## Telecom G.8275.1 — add-in card (Time Transmitter) [global] domainNumber 24 priority2 255 dataset_comparison G.8275.x G.8275.portDS.localPriority 250 G.8275.defaultDS.localPriority 250 maxStepsRemoved 255 logAnnounceInterval -3 logSyncInterval -4 logMinDelayReqInterval -4 announceReceiptTimeout 3 ptp_dst_mac 01:80:C2:00:00:0E network_transport L2 summary_interval 3 message_tag "ptp4l-aic2" uds_address /var/run/ptp4l-aic2 uds_ro_address /var/run/ptp4lro-aic2 [eno16595np0] serverOnly 1
NotaComo no Cenário 2a (Seção 47.5, “Cenário 2a - Relógio de Fronteira (apenas PTP) com NIC única multiporta, incluindo propagação para servidor de Relógio Comum”), cada nó no caminho de temporização usa o mesmo MAC multicast G.8275.1 não encaminhável
01:80:C2:00:00:0E, incluindo o downstream OC.Gerencie as instâncias com uma unidade
systemdbaseada em template que lê/etc/ptp4l-<instance>.conf:# /etc/systemd/system/ptp4l@.service [Unit] Description=PTP Boundary Clock instance %i After=gnrd-ptp-dpll-setup.service Requires=gnrd-ptp-dpll-setup.service [Service] ExecStart=/usr/sbin/ptp4l -f /etc/ptp4l-%i.conf [Install] WantedBy=multi-user.targetHabilite e inicie as três instâncias:
# systemctl enable --now ptp4l@nac ptp4l@aic1 ptp4l@aic2Encaminhe os parâmetros do Grandmaster através das instâncias
ptp4l.Um Boundary Clock deve encaminhar não apenas o tempo, mas também os parâmetros auxiliares do Grandmaster (classe de clock, precisão, offset UTC, e assim por diante). Isso acontece automaticamente entre portas da mesma instância
ptp4l, mas não entre as instâncias separadas que gerenciam PHCs diferentes. Os valores são aplicados em tempo de execução compmcsobre o socket UDS de cada instância (SET GRANDMASTER_SETTINGS_NP).ImportanteOs valores aplicados com
pmcsão mantidos apenas no processoptp4lem execução; eles não são gravados no arquivo.confe não sobrevivem a uma reinicialização. Se uma instânciaptp4lfor reiniciada, ela reverte para os padrões do arquivo e os valores devem ser encaminhados novamente. Automatize o encaminhamento (veja abaixo) em vez de executá-lo manualmente uma vez.Assim que o controlador integrado estiver bloqueado no GM, consulte os valores do Grandmaster. O auxiliar abaixo usa o arquivo de configuração da instância a ser consultada como seu argumento:
Exemplo 47.10:get_pmc_values.sh— consultar os valores do Grandmaster de uma instânciaptp4l##!/bin/bash # Retrieve Grandmaster information via pmc for the given ptp4l config file set -euo pipefail echo "PARENT_DATA_SET (Grandmaster clock values):" pmc -f "$1" -u -b 0 'GET PARENT_DATA_SET' | grep gm echo "TIME_PROPERTIES_DATA_SET:" pmc -f "$1" -u -b 0 'GET TIME_PROPERTIES_DATA_SET'Em seguida, encaminhe esses valores para as instâncias add-in. O script a seguir lê os valores da instância integrada e os aplica a cada instância add-in. Edite a seção "Input variables" para corresponder aos nomes dos arquivos de configuração e execute-o assim que o sistema estiver sincronizado com um GM:
Exemplo 47.11:04-ptp-forward-GM.sh— encaminhar os valores do Grandmaster para as instâncias add-in ##!/bin/bash set -euo pipefail ################## Input variables ################## VERBOSE=1 CONFIG_FILE_NAC=/etc/ptp4l-nac.conf CONFIG_FILES_AICS=(/etc/ptp4l-aic1.conf /etc/ptp4l-aic2.conf) ##################################################### # Check the system is synchronized to a GM GM_PRESENT=$(pmc -f ${CONFIG_FILE_NAC} -u -b 0 'GET TIME_STATUS_NP' | awk '/gmPresent/ {print $2}') if [ -z "$GM_PRESENT" ]; then echo "Failed to get GM value from ptp4l instance for NAC, exiting..." exit 1 elif [ "${GM_PRESENT}" != "true" ]; then echo "No GM present, exiting..." exit 1 fi # Get the "upstream" Grandmaster values PDS_GM_VALUES=$(pmc -f ${CONFIG_FILE_NAC} -u -b 0 'GET PARENT_DATA_SET' | awk 'BEGIN {ORS=" "} /gm./ {print $2}') TPDS_GM_VALUES=$(pmc -f ${CONFIG_FILE_NAC} -u -b 0 'GET TIME_PROPERTIES_DATA_SET' | awk 'BEGIN {ORS=" "} NR>2 {print $2}') if [ -z "$PDS_GM_VALUES" ]; then echo "No PARENT_DATA_SET values retrieved, exiting ..." exit 2 elif [ -z "$TPDS_GM_VALUES" ]; then echo "No TIME_PROPERTIES_DATA_SET values retrieved, exiting ..." exit 2 fi # Unpack from PARENT_DATA_SET read CLOCK_CLASS CLOCK_ACCURACY VARIANCE <<< $PDS_GM_VALUES # Unpack from TIME_PROPERTIES_DATA_SET read UTC_OFFSET LEAP_61 LEAP_59 UTC_OFFSET_VALID PTP_TIMESCALE T_TRACEABLE F_TRACEABLE T_SOURCE <<< $TPDS_GM_VALUES if [ "$VERBOSE" -eq 1 ]; then echo "Read from PARENT_DATA_SET: clockClass=${CLOCK_CLASS} clockAccuracy=${CLOCK_ACCURACY} offsetScaledLogVariance=${VARIANCE}" echo "Read from TIME_PROPERTIES_DATA_SET: currentUtcOffset=${UTC_OFFSET} leap61=${LEAP_61} leap59=${LEAP_59}" \ "currentUtcOffsetValid=${UTC_OFFSET_VALID} ptpTimescale=${PTP_TIMESCALE} timeTraceable=${T_TRACEABLE}" \ "frequencyTraceable=${F_TRACEABLE} timeSource=${T_SOURCE}" fi # Forward these values to the "downstream" Time Receivers, updating the ptp4l instances for FILE in "${CONFIG_FILES_AICS[@]}"; do if [ "$VERBOSE" -eq 1 ]; then echo "Updating GRANDMASTER_SETTINGS_NP (${FILE})" fi pmc -f ${FILE} -u -b 0 'SET GRANDMASTER_SETTINGS_NP clockClass '${CLOCK_CLASS}' clockAccuracy '${CLOCK_ACCURACY}' offsetScaledLogVariance '${VARIANCE}' currentUtcOffset '${UTC_OFFSET}' leap61 '${LEAP_61}' leap59 '${LEAP_59}' currentUtcOffsetValid '${UTC_OFFSET_VALID}' ptpTimescale '${PTP_TIMESCALE}' timeTraceable '${T_TRACEABLE}' frequencyTraceable '${F_TRACEABLE}' timeSource '${T_SOURCE}'' &> /dev/null if [ $? -ne 0 ]; then echo "Failed to update ptp4l instance using config file \"${FILE}\", exiting ..." exit 1 fi doneComo os valores não são persistentes, execute este script a partir de um timer
systemdpara que sejam atualizados periodicamente e após qualquer reinicialização de instância:# /etc/systemd/system/ptp-forward-gm.service [Unit] Description=Forward Grandmaster parameters to the add-in ptp4l instances Wants=ptp4l@nac.service ptp4l@aic1.service ptp4l@aic2.service After=ptp4l@nac.service ptp4l@aic1.service ptp4l@aic2.service [Service] Type=oneshot SELinuxContext=system_u:system_r:unconfined_t:s0 ExecStart=/usr/local/bin/04-ptp-forward-GM.sh# /etc/systemd/system/ptp-forward-gm.timer [Unit] Description=Refresh forwarded Grandmaster parameters [Timer] OnBootSec=2min OnUnitActiveSec=5min [Install] WantedBy=timers.targetO efeito é visível ao consultar uma instância
ptp4ladd-in no BC: antes do encaminhamento, o nó anuncia seus padrões de arquivo; após o início do encaminhamento, ele anuncia os valores reais do Grandmaster (que então se propagam para o downstream OC). Por exemplo, alterações emgm.ClockClass:# ./get_pmc_values.sh /etc/ptp4l-aic1.conf # before forwarding gm.ClockClass 165 gm.ClockAccuracy 0xfe gm.OffsetScaledLogVariance 0xffff # ./get_pmc_values.sh /etc/ptp4l-aic1.conf # after forwarding gm.ClockClass 8 gm.ClockAccuracy 0xfe gm.OffsetScaledLogVariance 0xffffOpcionalmente, derive o clock do sistema do PTP com
phc2sys, usando o PHC integrado como fonte (/etc/sysconfig/phc2sys):OPTIONS="-f /etc/ptp4l-nac.conf -s /dev/ptp1 -c CLOCK_REALTIME -w"
Automação CAPI
Para implantar este cenário com o fluxo de trabalho de provisionamento automatizado, use o modelo de Cluster API específico para GNR-D descrito em Fully automated directed network provisioning — GNR-D scenarios (Seção 55.1.2, “Cenários multi-NIC GNR-D (DPLL)”). Diferente dos cenários padrão, ele implanta várias instâncias ptp4l, o serviço ts2phc, a configuração de boot do DPLL e o timer de encaminhamento do Grandmaster, portanto, requer os arquivos de configuração adicionais e unidades systemd listados acima.
Substitua seus placeholders pelos valores abaixo.
| Placeholder | Valor |
|---|---|
| Copie o conteúdo de 01-gnrd-startup-setup.sh (Exemplo 47.5, “ |
| Copie o conteúdo de 04-ptp-forward-GM.sh (Exemplo 47.11, “ |
| Copie o conteúdo de /etc/ts2phc-cf-all.cfg (Exemplo 47.6, “ |
|
|
| Copie o conteúdo de /etc/ptp4l-nac.conf (Exemplo 47.7, “ |
| Copie o conteúdo de /etc/ptp4l-aic1.conf (Exemplo 47.8, “ |
| Copie o conteúdo de /etc/ptp4l-aic2.conf (Exemplo 47.9, “ |
47.8 Cenário 3b - Boundary Clock (modo híbrido: PTP & SyncE) Multi-NIC com módulo de temporização interno (baseado em DPLL GNR-D) #
Este cenário ainda não é suportado; ele será incluído em uma versão futura do SUSE Telco Cloud.






