46 Precision Time Protocol #
O Precision Time Protocol (PTP) é um protocolo de rede desenvolvido pelo Institute of Electrical and Electronics Engineers (IEEE) para permitir a sincronização de tempo em sub-microssegundos em uma rede de computadores. Desde a sua criação e há algumas décadas, o PTP tem sido usado em muitas indústrias. Recentemente, ele tem visto uma adoção crescente nas redes de telecomunicações como um elemento vital para redes 5G. Embora seja um protocolo relativamente simples, sua configuração pode mudar significativamente dependendo da aplicação. Por esse motivo, vários perfis foram definidos e padronizados.
Nesta seção, apenas perfis específicos de telecomunicações serão abordados. Consequentemente, a capacidade de carimbo de data/hora e um relógio de hardware PTP (PHC) na NIC serão assumidos. Atualmente, todos os adaptadores de rede de nível de telecomunicações vêm com suporte a PTP em hardware, mas você pode verificar tais capacidades com o seguinte comando:
# ethtool -T p1p1
Time stamping parameters for p1p1:
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
allSubstitua p1p1 pelo nome da interface a ser usada para PTP.
As seções a seguir fornecerão orientações sobre como instalar e configurar o PTP especificamente no SUSE Telco Cloud, mas espera-se familiaridade com conceitos básicos de PTP. Para uma breve visão geral do PTP e da implementação incluída no SUSE Telco Cloud, consulte a documentação do SLES Precision Time Protocol.
46.1 Instalar componentes de software PTP #
No SUSE Telco Cloud, a implementação do PTP é fornecida pelo pacote linuxptp, que inclui dois componentes:
ptp4l: um daemon que controla o PHC na NIC e executa o protocolo PTPphc2sys: um daemon que mantém o relógio do sistema sincronizado com o PHC sincronizado por PTP na NIC
Ambos os daemons são necessários para que a sincronização do sistema funcione plenamente e devem ser configurados corretamente de acordo com sua configuração. Isso é abordado em Seção 46.2, “Configure o PTP para implantações de telecomunicações”.
A maneira mais fácil e melhor de integrar o PTP em seu cluster downstream é adicionar o pacote linuxptp em packageList no arquivo de definição do Edge Image Builder (EIB). Dessa forma, o software do plano de controle PTP será instalado automaticamente durante o provisionamento do cluster. 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.
Abaixo, encontre um exemplo de manifesto EIB com linuxptp:
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:
time:
timezone: America/New_York
kernelArgs:
- ignition.platform.id=openstack
systemd:
disable:
- rebootmgr
- transactional-update.timer
- transactional-update-cleanup.timer
- fstrim
- time-sync.target
enable:
- ptp4l
- phc2sys
users:
- username: root
encryptedPassword: $ROOT_PASSWORD
packages:
packageList:
- jq # Non Telco specific - category: testing/utils
- dpdk # TelCo Core-Network UserPlane (5G UPF) and RAN UserPlane (gNB: DU and CU-UP) - category: runtime
- dpdk-tools # TelCo Core-Network UserPlane (5G UPF) and RAN UserPlane (gNB: DU and CU-UP) - category: testing/utils
- libdpdk-25 # TelCo Core-Network UserPlane (5G UPF) and RAN UserPlane (gNB: DU and CU-UP) - category: runtime
- pf-bb-config # TelCo RAN (gNB: DU) - category: config.
- open-iscsi # Non Telco specific (required by SUSE Storage/Longhorn) - category: runtime
- tuned # Non Telco specific (linux tuning) - category: config.
- cpupower # Non Telco specific (linux tuning - CPU power related settings) - category: config.
- rt-tests # Non Telco specific (RT scheduler-latency testing) - category: testing/utils
- linuxptp # TelCo RAN; time sync (gNB: DU) - category: runtime
- synce4l # TelCo RAN; time sync (gNN: DU) - category: runtime
- pciutils # Non Telco specific (provides "lspci" command) - category: testing/utils
- numactl # Non Telco specific (provides "numatcl" command) - category: testing/utils
sccRegistrationCode: $SCC_REGISTRATION_CODEO pacote linuxptp incluído no SUSE Telco Cloud não habilita ptp4l e phc2sys por padrão. Se os arquivos de configuração específicos do sistema forem implantados no momento do provisionamento (veja Seção 46.3, “Integração com Cluster API”), eles deverão ser habilitados. Faça isso adicionando-os à seção systemd do manifesto, como no exemplo acima.
Siga o processo habitual para criar a imagem conforme descrito na Documentação do EIB (Seção 5.4, “Criando a imagem”) e use-a para implantar seu cluster. Se você é novo no EIB, comece pelo Capítulo 12, Edge Image Builder em vez disso.
46.2 Configure o PTP para implantações de telecomunicações #
Muitas aplicações de telecomunicações exigem sincronização rigorosa de fase e tempo com pouco desvio, o que resultou na definição de dois perfis orientados a telecomunicações: o ITU-T G.8275.1 e o ITU-T G.8275.2. Ambos possuem uma alta taxa de mensagens de sincronização e outras características distintas, como o uso de um algoritmo Best Master Clock (BMCA) alternativo. Tal comportamento exige configurações específicas no arquivo de configuração consumido pelo ptp4l, fornecido nas seções a seguir como referência.
Ambas as seções cobrem apenas o caso de um relógio comum na configuração de Receptor de Tempo.
Qualquer perfil desse tipo deve ser usado em uma infraestrutura PTP bem planejada.
Sua rede PTP específica pode exigir ajustes adicionais de configuração; certifique-se de revisar e adaptar os exemplos fornecidos, se necessário.
46.2.1 Perfil PTP ITU-T G.8275.1 #
O perfil G.8275.1 apresenta as seguintes características:
Executa diretamente sobre Ethernet e requer suporte total da rede (nós/switches adjacentes devem suportar PTP).
A configuração de domínio padrão é 24.
A comparação de conjuntos de dados é baseada no algoritmo G.8275.x e seus valores
localPriorityapóspriority2.
Copie o seguinte conteúdo para um arquivo chamado /etc/ptp4l-G.8275.1.conf:
# Telecom G.8275.1 example configuration [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 serverOnly 0 ptp_dst_mac 01:80:C2:00:00:0E network_transport L2
Uma vez que o arquivo tenha sido criado, ele deve ser referenciado em /etc/sysconfig/ptp4l para que o daemon inicie corretamente. Isso pode ser feito alterando a linha OPTIONS= para:
OPTIONS="-f /etc/ptp4l-G.8275.1.conf -i $IFNAME --message_tag ptp-8275.1"
Mais precisamente:
-frequer o nome do arquivo de configuração a ser usado, sendo/etc/ptp4l-G.8275.1.confo valor utilizado neste caso.O
-irequer o nome da interface a ser usada; substitua$IFNAMEpor um nome de interface real.O
--message_tagpermite identificar melhor a saída do ptp4l nos logs do sistema e é opcional.
Uma vez que as etapas acima estejam concluídas, o daemon ptp4l deve ser (re)iniciado:
# systemctl restart ptp4lVerifique o status da sincronização observando os logs com:
# journalctl -e -u ptp4l46.2.2 Arquivo de controle PTP ITU-T G.8275.2 #
O arquivo de controle G.8275.2 tem as seguintes especificidades:
Executa sobre IP e não requer suporte total da rede (nós/switches adjacentes podem não suportar PTP).
A configuração de domínio padrão é 44.
A comparação de conjuntos de dados é baseada no algoritmo G.8275.x e seus valores
localPriorityapóspriority2.
Copie o seguinte conteúdo para um arquivo chamado /etc/ptp4l-G.8275.2.conf:
# Telecom G.8275.2 example configuration [global] domainNumber 44 priority2 255 dataset_comparison G.8275.x G.8275.portDS.localPriority 128 G.8275.defaultDS.localPriority 128 maxStepsRemoved 255 logAnnounceInterval 0 serverOnly 0 hybrid_e2e 1 inhibit_multicast_service 1 unicast_listen 1 unicast_req_duration 60 logSyncInterval -5 logMinDelayReqInterval -4 announceReceiptTimeout 2 # # Customize the following for slave operation: # [unicast_master_table] table_id 1 logQueryInterval 2 UDPv4 $PEER_IP_ADDRESS [$IFNAME] unicast_master_table 1
Certifique-se de substituir os seguintes espaços reservados:
$PEER_IP_ADDRESS- o endereço IP do próximo nó PTP com o qual se comunicar, como o master ou boundary clock que fornecerá a sincronização.$IFNAME- informa aptp4lqual interface usar para PTP.
Uma vez que o arquivo tenha sido criado, ele deve ser referenciado, juntamente com o nome da interface a ser usada para PTP, em /etc/sysconfig/ptp4l para que o daemon inicie corretamente. Isso pode ser feito alterando a linha OPTIONS= para:
OPTIONS="-f /etc/ptp4l-G.8275.2.conf --message_tag ptp-8275.2"Mais precisamente:
O
-frequer o nome do arquivo de configuração a ser usado. Neste caso, é/etc/ptp4l-G.8275.2.conf.O
--message_tagpermite identificar melhor a saída do ptp4l nos logs do sistema e é opcional.
Uma vez que as etapas acima estejam concluídas, o daemon ptp4l deve ser (re)iniciado:
# systemctl restart ptp4lVerifique o status da sincronização observando os logs com:
# journalctl -e -u ptp4l46.2.3 Configuração PTP de um Boundary Clock #
As seções anteriores abordaram a configuração de um relógio comum, mas implantações de Telco podem exigir que o nó atue como um Boundary Clock. Em tal cenário, o tempo de referência deve ser propagado de um Grand Master para um ou mais Time Receivers downstream, o que requer uma NIC com duas ou mais portas. Neste caso, uma porta assumirá a função de Time Receiver, que está conduzindo as atualizações do PTP Hardware Clock (PHC) na NIC, enquanto as restantes funcionarão como Time Transmitters. Uma única instância de ptp4l é suficiente para uma única NIC multiporta, mas cada interface de kernel envolvida na distribuição de tempo deve ser fornecida, como parte de sua configuração. Por exemplo, atualize o arquivo /etc/sysconfig/ptp4l para incluir quatro portas, apenas substitua as variáveis pelos nomes reais das interfaces ou ajuste conforme necessário:
OPTIONS="-f /etc/ptp4l-G.8275.1.conf --message_tag ptp-8275.1 -i $IFNAME1 -i $IFNAME2 -i $IFNAME3 -i $IFNAME4"Não há necessidade de definir clock_type como BC, pois isso será automaticamente implícito se mais de uma porta for fornecida.
Uma vez feito, o daemon ptp4l pode ser (re)iniciado com:
# systemctl restart ptp4lSem qualquer configuração de porta específica, o ptp4l executará o BMCA para determinar através de qual porta o GM pode ser alcançado. Se uma configuração estática for preferida, anexe uma seção para cada porta com a função prescrita no arquivo de configuração. Por exemplo:
# Telecom G.8275.1 example configuration [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 [$IFNAME1] # Time Receiver by default [$IFNAME2] serverOnly 1 [$IFNAME3] serverOnly 1 [$IFNAME4] serverOnly 1
No entanto, certifique-se de determinar a conexão correta com o GM antes de iniciar o daemon.
46.2.4 Sincronização do relógio do sistema a partir do PTP #
É importante ter em mente que o PTP funciona sincronizando os relógios de hardware locais da NIC. Isso não alinha automaticamente o relógio do sistema com o GM, já que o relógio do sistema é derivado de um relógio de hardware diferente.
Para manter o relógio do sistema sincronizado com o PTP, o phc2sys deve ser executado. Recomenda-se que você conclua totalmente a configuração de ptp4l antes de passar para phc2sys. phc2sys não requer um arquivo de configuração por padrão e seus parâmetros de execução podem ser controlados exclusivamente através da variável OPTIONS= presente em /etc/sysconfig/ptp4l, de maneira semelhante a ptp4l:
OPTIONS="-s $IFNAME -w"
Onde $IFNAME é o nome da interface já configurada no ptp4l que será usada como fonte para o relógio do sistema. Isso é usado para identificar o PHC de origem.
No entanto, se um perfil PTP específico ou número de domínio for usado, pode ser necessário fornecer ao phc2sys um arquivo de configuração de acordo com aquele fornecido ao ptp4l. Na maioria dos casos, ele também pode ser reutilizado diretamente com o phc2sys:
OPTIONS="-f /etc/ptp4l-G.8275.1.conf -s $IFNAME -w"
46.3 Integração com Cluster API #
Sempre que um cluster é implantado por meio de um cluster de gerenciamento e provisionamento de rede direcionado, tanto o arquivo de configuração quanto as duas variáveis de configuração em /etc/sysconfig podem ser implantados no host no momento do provisionamento. Abaixo está um trecho de uma definição de cluster, com foco em um objeto RKE2ControlPlane modificado que implanta o mesmo arquivo de configuração G.8275.1 em todos os hosts:
apiVersion: controlplane.cluster.x-k8s.io/v1beta2
kind: RKE2ControlPlane
metadata:
name: single-node-cluster
namespace: default
spec:
infrastructureRef:
apiGroup: infrastructure.cluster.x-k8s.io
kind: Metal3MachineTemplate
name: single-node-cluster-controlplane
replicas: 1
version: ${RKE2_VERSION}
rolloutStrategy:
type: "RollingUpdate"
rollingUpdate:
maxSurge: 0
registrationMethod: "control-plane-endpoint"
serverConfig:
cni: canal
agentConfig:
format: ignition
cisProfile: cis
additionalUserData:
config: |
variant: fcos
version: 1.4.0
systemd:
units:
- name: rke2-preinstall.service
enabled: true
contents: |
[Unit]
Description=rke2-preinstall
Wants=network-online.target
Before=rke2-install.service
ConditionPathExists=!/run/cluster-api/bootstrap-success.complete
[Service]
Type=oneshot
User=root
ExecStartPre=/bin/sh -c "mount -L config-2 /mnt"
ExecStart=/bin/sh -c "sed -i \"s/BAREMETALHOST_UUID/$(jq -r .uuid /mnt/openstack/latest/meta_data.json)/\" /etc/rancher/rke2/config.yaml"
ExecStart=/bin/sh -c "echo \"node-name: $(jq -r .name /mnt/openstack/latest/meta_data.json)\" >> /etc/rancher/rke2/config.yaml"
ExecStart=/bin/sh -c "echo \"node-label:\" >> /etc/rancher/rke2/config.yaml"
ExecStart=/bin/sh -c "echo \" - metal3.io/uuid=$(jq -r .uuid /mnt/openstack/latest/meta_data.json)\" >> /etc/rancher/rke2/config.yaml"
ExecStartPost=/bin/sh -c "umount /mnt"
[Install]
WantedBy=multi-user.target
storage:
files:
- path: /etc/ptp4l-G.8275.1.conf
overwrite: true
contents:
inline: |
# Telecom G.8275.1 example configuration
[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
serverOnly 0
ptp_dst_mac 01:80:C2:00:00:0E
network_transport L2
mode: 0644
user:
name: root
group:
name: root
- path: /etc/sysconfig/ptp4l
overwrite: true
contents:
inline: |
## Path: Network/LinuxPTP
## Description: Precision Time Protocol (PTP): ptp4l settings
## Type: string
## Default: "-i eth0 -f /etc/ptp4l.conf"
## ServiceRestart: ptp4l
#
# Arguments when starting ptp4l(8).
#
OPTIONS="-f /etc/ptp4l-G.8275.1.conf -i $IFNAME --message_tag ptp-8275.1"
mode: 0644
user:
name: root
group:
name: root
- path: /etc/sysconfig/phc2sys
overwrite: true
contents:
inline: |
## Path: Network/LinuxPTP
## Description: Precision Time Protocol (PTP): phc2sys settings
## Type: string
## Default: "-s eth0 -w"
## ServiceRestart: phc2sys
#
# Arguments when starting phc2sys(8).
#
OPTIONS="-s $IFNAME -w"
mode: 0644
user:
name: root
group:
name: root
kubelet:
extraArgs:
- provider-id=metal3://BAREMETALHOST_UUID
nodeName: "localhost.localdomain"Além de outras variáveis, a definição acima deve ser completada com o nome da interface e com os outros objetos do Cluster API, conforme descrito em Parte VII, “Provisionamento de rede direcionado totalmente automatizado”.
Essa abordagem é conveniente apenas se o hardware no cluster for uniforme e a mesma configuração for necessária em todos os hosts, incluindo o nome da interface.
Abordagens alternativas são possíveis e serão abordadas em versões futuras.
Neste ponto, seus hosts devem ter uma pilha PTP funcionando e em execução e começarão a negociar sua função PTP.
46.4 PTP em plataformas Intel Granite Rapids-D #
O SUSE Telco Cloud suporta temporização precisa em uma variedade de plataformas diferentes, incluindo os projetos mais recentes baseados em Intel Granite Rapids-D (GNR-D). Esses novos servidores normalmente incluem um controlador Ethernet de alta velocidade integrado e uma ou mais placas adicionais 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 permite o roteamento dos sinais de temporização através do sistema e das diferentes NIC, e não requer mais cabeamento externo. 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.
Antes de seguir as etapas de configuração, 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\" e descompacte o arquivo, então instale o RPM ice-kmp-default-*sles16sp0.x86_64.rpm contido nele, por exemplo, o arquivo 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 será 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.
Assume-se uma implantação de Telco e o perfil Telco G.8275.1 é usado nas seções a seguir para PTP.
46.4.1 PTP Boundary Clock #
Esta seção descreve o processo de configuração de um Boundary Clock (BC) em um sistema GNR-D, onde uma porta na NIC integrada recebe os timestamps PTP de um GM e todas as portas restantes no sistema atuam como Transmissores de Tempo para outros nós da rede.
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.
Para habilitar o comportamento de BC, execute as seguintes etapas na mesma ordem toda vez que o sistema for inicializado:
Verifique se os dispositivos PTP esperados que controlam os PHCs estão presentes:
# ls -l /sys/class/ptp/ total 0 lrwxrwxrwx. 1 root root 0 Apr 27 20:21 ptp1 -> ../../devices/pci0000:12/0000:12:04.0/0000:13:00.0/ptp/ptp1 lrwxrwxrwx. 1 root root 0 Apr 27 20:21 ptp2 -> ../../devices/pci0000:6b/0000:6b:02.0/0000:6c:00.0/ptp/ptp2 lrwxrwxrwx. 1 root root 0 Apr 27 20:21 ptp3 -> ../../devices/pci0000:6b/0000:6b:06.0/0000:6e:00.0/ptp/ptp3NotaAjuste os comandos subsequentes de acordo com os nomes reais encontrados no sistema que está sendo configurado.
Identifique o controlador integrado, pois ele exigirá uma configuração específica:
A saída anterior deve indicar o dispositivo ao qual eles estão vinculados por meio do endereço PCI e você pode usar
lspcipara consultar o tipo de dispositivo:# 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 específico está equipado com um controlador integrado Intel E825-C e duas placas adicionais E830-CC.
Alternativamente, você pode encontrar mais informações sobre o controlador consultando a primeira porta de rede do controlador que expõe esse PHC:
# ls -l /sys/class/ptp/ptp0/device/net/ total 0 drwxr-xr-x. 5 root root 0 Apr 30 15:16 em5 # ethtool -i em5 driver: ice version: 2.4.5 firmware-version: 4.03 0x80007f91 1.3881.0 expansion-rom-version: bus-info: 0000:13:00.0 [...]Observe que
em5é a primeira porta do controlador Ethernet integrado neste sistema.Configure os sinais entre o PHC no controlador Ethernet integrado e o DPLL de temporização do sistema:
Deixe o DPLL controlar o clock Ethernet no controlador integrado:
# echo 4 1 > /sys/class/net/em5/device/tspll_cfgHabilite um pulso a cada início de segundo (Pulse Per Second, PPS) do PHC para o DPLL através do pino SDP2 (sinal de 1kHz):
# echo 2 1 > /sys/class/ptp/ptp1/pins/SDP2 # echo 1 0 0 0 1000000 > /sys/class/ptp/ptp1/periodOpcionalmente, o pino SPD0 (sinal de 1Hz) também pode ser habilitado:
# echo 2 2 > /sys/class/ptp/ptp1/pins/SDP0 # echo 2 0 0 1 0 > /sys/class/ptp/ptp1/periodHabilite o sinal de 1 PPS para ser propagado do DPLL do sistema de temporização para as placas adicionais:
# echo 1 1 > /sys/class/ptp/ptp2/pins/SDP1 # echo 1 1 > /sys/class/ptp/ptp3/pins/SDP1
Execute
ts2phcpara manter os PHCs das placas adicionais sincronizados com o mesmo timestamp do PHC/dev/ptp1:# ts2phc -f ts2phc-aic-all.cfg -s /dev/ptp1Consulte Seção 46.4.2.3, “Arquivo de configuração do
ts2phcpara placas adicionais” para o conteúdo dets2phc-aic-all.cfg.Execute uma instância do
ptp4lpara o controlador integrado (/dev/ptp1):# ptp4l -f ptp4l-G.8275.1-nac.confConsulte Seção 46.4.2.1, “Arquivo de configuração do
ptp4lpara o controlador integrado (/dev/ptp1)” para o conteúdo deptp4l-G.8275.1-nac.conf.Execute uma instância do
ptp4lpara cada placa adicional (/dev/ptp3e/ou/dev/ptp2):# ptp4l -f ptp4l-G.8275.1-aic1.conf # ptp4l -f ptp4l-G.8275.1-aic2.confConsulte Seção 46.4.2.2, “Arquivo de configuração do
ptp4lpara placas adicionais (/dev/ptp2ou/dev/ptp3)” para o conteúdo dos arquivos de configuração.NotaPara evitar conflitos e permitir a próxima etapa, cada uma dessas instâncias deve usar soquetes de controle e de somente leitura diferentes.
Sincronize os parâmetros de runtime PTP e os valores das instâncias do
ptp4ldas AICs com opmc:Espera-se que um BC encaminhe não apenas o horário de um GM ao qual está conectado, mas também parâmetros auxiliares, como sua classe de relógio e nível de precisão. Isso acontece automaticamente dentro de um grupo de interfaces gerenciadas pela mesma instância do
ptp4l, mas não entre instâncias diferentes doptp4l, lidando com PHCs e portas diferentes.Uma vez que o sistema esteja sincronizado com um GM, consulte a instância do
ptp4lno controlador integrado e defina os valores nas instâncias restantes doptp4lvia comandospmc. Por exemplo:# pmc -f /etc/ptp4l-G.8275.1-nac-bmca.conf -u -b 0 'GET PARENT_DATA_SET' | grep gm gm.ClockClass 8 gm.ClockAccuracy 0xfe gm.OffsetScaledLogVariance 0xffff # pmc -f /etc/ptp4l-G.8275.1-nac-bmca.conf -u -b 0 'GET TIME_PROPERTIES_DATA_SET' | grep -v PROPERTIES currentUtcOffset 37 leap61 0 leap59 0 currentUtcOffsetValid 0 ptpTimescale 1 timeTraceable 0 frequencyTraceable 0 timeSource 0xa0 pmc -f /etc/ptp4l-G.8275.1-aic1-static.conf -u -b 0 'SET GRANDMASTER_SETTINGS_NP clockClass 8 clockAccuracy 0xfe offsetScaledLogVariance 0xffff currentUtcOffset 37 leap61 0 leap59 0 currentUtcOffsetValid 0 ptpTimescale 1 timeTraceable 0 frequencyTraceable 0 timeSource 0xa0Consulte Seção 46.4.2.4, “Script de encaminhamento de parâmetros GM” para automatizar este processo e evitar etapas manuais.
Opcionalmente, execute o
phc2syspara derivar o horário do sistema a partir da sincronização PTP:# phc2sys -f /etc/ptp4l-G.8275.1-nac.conf -s /dev/ptp1 -c CLOCK_REALTIME -wO arquivo de entrada é o mesmo arquivo de configuração usado para o
ptp4le o controlador integrado. Consulte Seção 46.2.4, “Sincronização do relógio do sistema a partir do PTP” para permitir que o systemd gerencie sua execução.
46.4.2 Arquivos de configuração #
Esta seção fornece exemplos de arquivos de configuração e scripts que podem ser usados em conjunto com as etapas acima para configurar rapidamente um BC funcional no GNR-D. Os arquivos de configuração do ptp4l contêm todas as definições necessárias, sem a necessidade de sinalizadores de execução externos adicionais, e são todos baseados no perfil Telco G.8275.1. Mais detalhes são fornecidos para cada arquivo em suas respectivas seções.
46.4.2.1 Arquivo de configuração do ptp4l para o controlador integrado (/dev/ptp1) #
[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:1b:19:00:00:00 network_transport L2 summary_interval 3 message_tag "ptp4l-nac" uds_address /var/run/ptp4l-nac uds_ro_address /var/run/ptp4lro-nac [em1] [em2] [em3] [em4]
A configuração acima aproveita o BMCA para determinar a função da porta, assumindo que um GM esteja disponível através de uma delas. Se um controle mais rigoroso for necessário, adicione o sinalizador serverOnly sob cada definição de interface. Para mais detalhes, consulte Seção 46.2.3, “Configuração PTP de um Boundary Clock” ou a configuração das placas adicionais abaixo como exemplo.
Por uma questão de brevidade, apenas quatro interfaces estão listadas; você precisa ajustar de acordo com seus requisitos.
46.4.2.2 Arquivo de configuração do ptp4l para placas adicionais (/dev/ptp2 ou /dev/ptp3) #
# Telecom G.8275.1 example configuration [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:1b:19:00:00:00 network_transport L2 summary_interval 3 message_tag "ptp4l-iac1" uds_address /var/run/ptp4l-aic1 uds_ro_address /var/run/ptp4lro-aic1 [p1p1] serverOnly 1 [p1p2] serverOnly 1 [p1p3] serverOnly 1 [p1p4] serverOnly 1
Por uma questão de brevidade, apenas quatro interfaces estão listadas. Você precisa ajustar de acordo com seus requisitos. Todas as interfaces foram definidas estaticamente para a função TimeTransmitter.
46.4.2.3 Arquivo de configuração do ts2phc para placas adicionais #
[global] use_syslog 0 verbose 1 logging_level 7 ts2phc.pulsewidth 100000000 [p1p1] ts2phc.channel 1 ts2phc.extts_polarity rising ts2phc.pin_index 1 [p2p1] ts2phc.channel 1 ts2phc.extts_polarity rising ts2phc.pin_index 1
Esta configuração cobre a sincronização de duas placas adicionais (referenciadas por sua primeira porta, p1p1 e p2p1) via o SDP1 em cada controlador.
46.4.2.4 Script de encaminhamento de parâmetros GM #
O script abaixo pode ser aproveitado para encaminhar os valores e parâmetros do GM para Time Receivers em portas gerenciadas por instâncias ptp4l diferentes daquela onde o GM reside. Não se esqueça de editar a seção Input variables para ajustar os nomes dos arquivos e executá-lo assim que o sistema estiver sincronizado com um GM.
#!/bin/bash
set -euo pipefail
################## Variáveis de entrada ##################
VERBOSE=1
CONFIG_FILE_NAC=/etc/ptp4l-G.8275.1-nac-bmca.conf
CONFIG_FILES_AICS=(/etc/ptp4l-G.8275.1-aic1-static.conf /etc/ptp4l-G.8275.1-aic2-static.conf)
#####################################################
# Verifique se o sistema está sincronizado com um GM
GM_PRESENT=$(pmc -f ${CONFIG_FILE_NAC} -u -b 0 'GET TIME_STATUS_NP' | awk '/gmPresent/ {print $2}')
if [ \"${GM_PRESENT}\" != \"true\" ]; then
echo \"Nenhum GM presente, saindo...\"
exit 1
fi
# Obtenha os valores do Grand Master \"upstream\"
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 \"Nenhum valor de PARENT_DATA_SET recuperado\"
exit 2
elif [ -z \"$TPDS_GM_VALUES\" ]; then
echo \"Nenhum valor de TIME_PROPERTIES_DATA_SET recuperado\"
exit 2
fi
# Descompactar de PARENT_DATA_SET
read CLOCK_CLASS CLOCK_ACCURACY VARIANCE <<< $PDS_GM_VALUES
# Descompactar de 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 \"Lido de PARENT_DATA_SET: clockClass=${CLOCK_CLASS} clockAccuracy=${CLOCK_ACCURACY} offsetScaledLogVariance=${VARIANCE}\" +
echo \"Lido de 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
# Encaminhe esses valores para os receptores de tempo "downstream" atualizando as instâncias ptp4l
for FILE in \"${CONFIG_FILES_AICS[@]}\"; do +
if [ \"$VERBOSE\" -eq 1 ]; then +
echo \"Atualizando 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 \"Falha ao atualizar ${FILE}\" +
fi +
doneO script deve ser executado toda vez que o GM mudar.