|Index|SUSE Telco Cloud Documentação|Configuração de recursos de Telco|Precision Time Protocol
Aplica-se a SUSE Telco Cloud 3.7

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. ptp4l disciplina 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.

Nó cuja NIC integra um DPLL gerenciável
Figura 47.1: Software PTP em um nó cuja NIC integra um DPLL gerenciável
Nó cuja NIC não possui um DPLL gerenciável
Figura 47.2: Software PTP em um nó cuja NIC não possui um DPLL gerenciável
Nó com um DPLL embarcado compartilhado entre NICs
Figura 47.3: Software PTP em um nó com um DPLL embarcado compartilhado entre NICs

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.

Distribuição apenas de PTP com Grandmaster
Figura 47.4: Distribuição de tempo apenas com PTP
Distribuição de PTP e SyncE com Grandmaster
Figura 47.5: Distribuição de tempo e frequência com PTP e SyncE (aprimoramento opcional)

Os cenários a seguir são abordados neste guia. Cada cenário inclui um link para sua automação de Cluster API (CAPI).

Nota
Nota

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
        all

Verifique 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 de ptp4l pode 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 o ptp4l manté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_CODE
Nota
Nota

O 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 ptp4l executa 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 estado SLAVE e o ptp4l disciplina o PTP Hardware Clock (PHC) da NIC. Definir clientOnly 1 restringe o nó à função de Time Receiver, portanto, ele nunca pode ser selecionado como mestre.

  • O phc2sys alinha o relógio do sistema (CLOCK_REALTIME) ao PHC que o ptp4l manté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:

Importante
Importante

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 24 para 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.

Cenário 1a - Ordinary Clock (apenas PTP) com G.8275.1
Figura 47.6: Ordinary Clock (OC) — G.8275.1 (multicast de Camada 2)

Configure o nó da seguinte forma:

  1. Identifique o índice PHC <N> da interface usada para PTP (aqui eno8403np1); o valor do campo impresso PTP Hardware Clock (que também pode aparecer como Hardware timestamp provider index) fornece o dispositivo /dev/ptp<N> que o ptp4l disciplina e que o phc2sys lê 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.

  2. 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ável 01:80:C2:00:00:0E que confina o PTP a um único link e é a razão pela qual cada dispositivo no caminho deve ser compatível com PTP. O uds_address expõe um socket de gerenciamento que o phc2sys usa para acompanhar o estado da porta.

  3. Aponte ptp4l para este arquivo em /etc/sysconfig/ptp4l:

    OPTIONS="-f /etc/ptp4l-G.8275.1.conf"
  4. Configure phc2sys em /etc/sysconfig/phc2sys para disciplinar o relógio do sistema a partir do PHC da interface PTP (/dev/ptp1). Os valores --uds_address e --domainNumber devem corresponder à configuração ptp4l:

    OPTIONS="-s /dev/ptp1 -w -m --uds_address /var/run/ptp4l --domainNumber 24"

    -s /dev/ptp1 seleciona o PHC como o relógio de origem, -w aguarda ptp4l para sincronizar antes de ajustar o relógio do sistema, e -m imprime o status do servo no log.

  5. Habilite e inicie ambos os serviços:

    # systemctl enable --now ptp4l phc2sys
  6. Verifique se ptp4l travou no upstream master. A porta muda para SLAVE e 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 +/-   2
  7. Verifique se phc2sys está disciplinando o relógio do sistema. O estado do servo progride de s0 (desbloqueado) através de s1 (passo inicial) para s2 (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   0

    Um estado s2 está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.

Cenário 1a - Relógio Comum (apenas PTP) com G.8275.2
Figura 47.7: Relógio Comum (OC) — G.8275.2 (unicast de Camada 3)

Configure o nó da seguinte forma:

  1. Identifique o PHC da interface PTP como no Modelo 1 (ethtool -T eno8403np1); neste exemplo, o PHC de eno8403np1 é /dev/ptp1.

  2. 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 da unicast_master_table. Substitua $MASTER_IP_ADDRESS pelo 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
  3. Aponte ptp4l para este arquivo em /etc/sysconfig/ptp4l:

    OPTIONS="-f /etc/ptp4l-G.8275.2.conf"
  4. Configure phc2sys em /etc/sysconfig/phc2sys com o número de domínio G.8275.2 (44); o PHC de origem e --uds_address permanecem inalterados:

    OPTIONS="-s /dev/ptp1 -w -m --uds_address /var/run/ptp4l --domainNumber 44"
  5. Habilite e inicie ambos os serviços:

    # systemctl enable --now ptp4l phc2sys
  6. Verifique a sincronização como no Modelo 1: ptp4l move a porta para SLAVE (journalctl -u ptp4l) e phc2sys atinge o estado s2 (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.

Tabela 47.1: Modelo 1 — ITU-T G.8275.1
PlaceholderValor

${PTP4L_CONF_PATH}

/etc/ptp4l-G.8275.1.conf

${PTP4L_CONF_CONTENTS}

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”).

${PTP4L_OPTIONS}

-f /etc/ptp4l-G.8275.1.conf

${PHC2SYS_OPTIONS}

-s /dev/ptp1 -w -m --uds_address /var/run/ptp4l --domainNumber 24

Tabela 47.2: Modelo 2 — ITU-T G.8275.2
PlaceholderValor

${PTP4L_CONF_PATH}

/etc/ptp4l-G.8275.2.conf

${PTP4L_CONF_CONTENTS}

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”).

${PTP4L_OPTIONS}

-f /etc/ptp4l-G.8275.2.conf

${PHC2SYS_OPTIONS}

-s /dev/ptp1 -w -m --uds_address /var/run/ptp4l --domainNumber 44

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í o gm.ClockClass degradado 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 eno8403np1 está voltada para o segmento upstream como um Receptor de Tempo (SLAVE) e disciplina o PHC da NIC; eno8503np2 (e eno8603np3) 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 ptp4l gerencia todas as suas portas. O BMCA seleciona o GM como mestre em eno8403np1, que muda para SLAVE e disciplina o PHC. eno8503np2 e eno8603np3 são forçados a serverOnly 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ção clock_type ou ts2phc é necessária.

  • No OC server, ptp4l é executado com clientOnly 1 em ens6f0np0, portanto, a porta atua apenas como um Receptor de Tempo. phc2sys alinha o relógio do sistema ao PHC.

  • No servidor OC, clientOnly 1 é o que garante que ele nunca se torne um mestre. O atributo localPriority — 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 o 128 padrão, enquanto o servidor OC usa o 250 de 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

Scenario 2a - Boundary Clock (apenas PTP) com NIC única multiporta incluindo propagação para o servidor Ordinary Clock
Figura 47.8: O Boundary Clock (apenas PTP), NIC única, com propagação para um Ordinary Clock

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)

  1. Identifique o PHC da NIC PTP (ethtool -T eno8403np1); em uma única NIC, todas as portas compartilham o mesmo PHC. Neste exemplo, é /dev/ptp1.

  2. 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 como serverOnly 1 para 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
  3. Aponte ptp4l para este arquivo em /etc/sysconfig/ptp4l:

    OPTIONS="-f /etc/ptp4l-G.8275.1.conf"
  4. Opcionalmente, alinhe o relógio do sistema com phc2sys em /etc/sysconfig/phc2sys, usando o PHC da NIC compartilhada como fonte:

    OPTIONS="-s /dev/ptp1 -w -m --uds_address /var/run/ptp4l --domainNumber 24"
  5. Habilite e inicie os serviços e verifique se eno8403np1 está sincronizado com o GM. A porta receptora muda para SLAVE e 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)

  1. Identifique o PHC da interface PTP (ethtool -T ens6f0np0); neste exemplo, é /dev/ptp1.

  2. Crie /etc/ptp4l-G.8275.1.conf com uma única porta e clientOnly 1, para que o nó atue apenas como Time Receiver. O localPriority mais 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]
  3. Configure /etc/sysconfig/ptp4l e /etc/sysconfig/phc2sys como para o BC (a fonte phc2sys é o PHC de ens6f0np0), 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"
  4. Verifique se ens6f0np0 está sincronizado com o tempo regenerado do BC. A porta muda para SLAVE e 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 +/-   4

    O 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.05c130

    As 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.ClockAccuracy e grandmasterPriority carregam 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.

Tabela 47.3: Boundary Clock (servidor BC)
PlaceholderValor

${PTP4L_CONF_PATH}

/etc/ptp4l-G.8275.1.conf

${PTP4L_CONF_CONTENTS}

Copie o conteúdo de da configuração do Boundary Clock acima (Exemplo 47.3, “Configuração de Boundary Clock”).

${PTP4L_OPTIONS}

-f /etc/ptp4l-G.8275.1.conf

${PHC2SYS_OPTIONS}

-s /dev/ptp1 -w -m --uds_address /var/run/ptp4l --domainNumber 24

Tabela 47.4: Ordinary Clock (servidor OC)
PlaceholderValor

${PTP4L_CONF_PATH}

/etc/ptp4l-G.8275.1.conf

${PTP4L_CONF_CONTENTS}

Copie o conteúdo de da configuração do Ordinary Clock acima (Exemplo 47.4, “Configuração de Ordinary Clock:”).

${PTP4L_OPTIONS}

-f /etc/ptp4l-G.8275.1.conf

${PHC2SYS_OPTIONS}

-s /dev/ptp1 -w -m --uds_address /var/run/ptp4l --domainNumber 24

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.

Importante
Importante

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.

Pré-requisitos
  • 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.rpm

    Reinicie o servidor para tornar a alteração persistente e efetiva.

Nota
Nota
  • 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 eno8403np1 e disciplina o PHC integrado (/dev/ptp1). O DPLL integrado distribui esse tempo para as placas add-in e ts2phc mantém seus PHCs (/dev/ptp2, /dev/ptp3) alinhados com /dev/ptp1. Cada placa add-in regenera o PTP downstream (por exemplo, em eno16495np0), 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 ptp4l no controlador integrado (/dev/ptp1) executa o protocolo PTP em eno8403np1. O BMCA seleciona o GM como mestre, a porta muda para SLAVE e ptp4l disciplina /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.

  • ts2phc mantém os PHCs das placas add-in alinhados a /dev/ptp1 a partir do sinal que o DPLL distribui.

  • Uma instância ptp4l separada por placa add-in (/dev/ptp2, /dev/ptp3) regenera o PTP em suas portas, todas forçadas para serverOnly 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 ferramenta linuxptp que consulta e atualiza o estado de runtime de uma instância ptp4l em execução através de seu socket de gerenciamento.

Nota
Nota

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).

Nota
Nota

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

Cenário 3a - Boundary Clock (apenas PTP) multi-NIC com módulo de temporização interno (baseado em DPLL GNR-D)
Figura 47.9: Boundary Clock (apenas PTP), nó GNR-D multi-NIC com DPLL integrado, com propagação para um Ordinary Clock

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”).

  1. Identifique os dispositivos PTP e o controlador integrado.

    1. 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/ptp3
    2. Execute lspci para 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 SFP

      Este servidor de referência possui um controlador integrado Intel E825-C (/dev/ptp1) e duas placas add-in E830-CC (/dev/ptp2, /dev/ptp3).

    3. 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
      [...]
  2. 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 índices ptpN corretos:

    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/SDP1

    Essas configurações são perdidas na reinicialização, portanto, execute o script na inicialização a partir de uma unidade systemd do tipo oneshot, ordenada antes de ts2phc e ptp4l:

    # /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.target
  3. Alinhe 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ância ptp4l), 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 pino SDP1; ts2phc registra 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.

    Nota
    Nota

    O alinhamento dos PHCs das placas add-in requer duas configurações complementares, em níveis diferentes:

    • Hardware: o pino de entrada SDP1 de 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 ts2phc deve 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ção ts2phc
    [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_index e ts2phc.channel: o pino e o canal onde o DPLL entrega o 1PPS (SDP1 nesta configuração, portanto pin_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 deixe systemd gerenciá-lo através de /etc/sysconfig/ts2phc:

      # /etc/sysconfig/ts2phc
      OPTIONS="-f /etc/ts2phc-cf-all.cfg -s /dev/ptp1 -m"
  4. Execute uma instância ptp4l por 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 define serverOnly ou clientOnly nela: ela depende do BMCA para atribuir a função. Com um GM alcançável em eno8403np1, 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çam serverOnly 1 porque devem ser sempre Transmissores de Tempo — elas obtêm seu tempo do DPLL e ts2phc, não recebendo PTP, portanto, nunca devem ser eleitas como receptores. Se for necessário um controle mais rigoroso, adicione a flag serverOnly ou clientOnly explicitamente sob a interface.

    Os valores de G.8275.portDS.localPriority e G.8275.defaultDS.localPriority (128 na instância integrada, 250 nas placas add-in) atuam como um desempate BMCA G.8275.x: eles são comparados apenas após clockClass, clockAccuracy, variância e priority2, e um valor menor é preferido. Manter o 128 padrã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 por ptp4l.

    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
    Nota
    Nota

    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”), 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 systemd baseada 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.target

    Habilite e inicie as três instâncias:

    # systemctl enable --now ptp4l@nac ptp4l@aic1 ptp4l@aic2
  5. Encaminhe 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 com pmc sobre o socket UDS de cada instância (SET GRANDMASTER_SETTINGS_NP).

    Importante
    Importante

    Os valores aplicados com pmc são mantidos apenas no processo ptp4l em execução; eles não são gravados no arquivo .conf e não sobrevivem a uma reinicialização. Se uma instância ptp4l for 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ância ptp4l
    #!/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
    done

    Como os valores não são persistentes, execute este script a partir de um timer systemd para 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.target

    O efeito é visível ao consultar uma instância ptp4l add-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 em gm.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            0xffff
  6. Opcionalmente, 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.

Tabela 47.5: GNR-D Boundary Clock
PlaceholderValor

${GNRD_DPLL_SETUP_CONTENTS}

Copie o conteúdo de 01-gnrd-startup-setup.sh (Exemplo 47.5, “01-gnrd-startup-setup.sh”).

${GNRD_FORWARD_GM_CONTENTS}

Copie o conteúdo de 04-ptp-forward-GM.sh (Exemplo 47.11, “04-ptp-forward-GM.sh — encaminhar os valores do Grandmaster para as instâncias add-in”).

${TS2PHC_CONF_CONTENTS}

Copie o conteúdo de /etc/ts2phc-cf-all.cfg (Exemplo 47.6, “/etc/ts2phc-cf-all.cfg — arquivo de configuração ts2phc”).

${TS2PHC_OPTIONS}

-f /etc/ts2phc-cf-all.cfg -s /dev/ptp1 -m

${PTP4L_NAC_CONTENTS}

Copie o conteúdo de /etc/ptp4l-nac.conf (Exemplo 47.7, “/etc/ptp4l-nac.conf — controlador integrado (/dev/ptp1)”).

${PTP4L_AIC1_CONTENTS}

Copie o conteúdo de /etc/ptp4l-aic1.conf (Exemplo 47.8, “/etc/ptp4l-aic1.conf — placa add-in 1 (/dev/ptp2)”).

${PTP4L_AIC2_CONTENTS}

Copie o conteúdo de /etc/ptp4l-aic2.conf (Exemplo 47.9, “/etc/ptp4l-aic2.conf — placa add-in 2 (/dev/ptp3)”).

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.