46 Protocolo de tiempo de precisión #
El Protocolo de tiempo de precisión (PTP) es un protocolo de red desarrollado por el Instituto de Ingenieros Eléctricos y Electrónicos (IEEE) para permitir la sincronización horaria de submicrosegundos en una red informática. Desde su creación y desde hace ya un par de décadas, el PTP se ha utilizado en muchas industrias. Recientemente ha experimentado una creciente adopción en las redes de telecomunicaciones como un elemento vital para las redes 5G. Aunque es un protocolo relativamente sencillo, su configuración puede cambiar significativamente dependiendo de la aplicación. Por este motivo, se han definido y estandarizado múltiples perfiles.
En esta sección, solo se tratarán los perfiles específicos de telecomunicaciones. En consecuencia, se asumirá la capacidad de marcado de tiempo y un reloj de hardware PTP (PHC) en la NIC. Hoy en día, todos los adaptadores de red de grado de telecomunicaciones vienen con soporte PTP en hardware, pero podéis verificar dichas capacidades con el siguiente 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
allSustituid p1p1 por el nombre de la interfaz que se utilizará para PTP.
Las siguientes secciones proporcionarán orientación sobre cómo instalar y configurar PTP específicamente en SUSE Telco Cloud, pero se espera familiaridad con los conceptos básicos de PTP. Para obtener una breve descripción general de PTP y la implementación incluida en SUSE Telco Cloud, consulte la documentación del Protocolo de tiempo de precisión de SLES.
46.1 Instalad los componentes de software PTP #
En SUSE Telco Cloud, la implementación de PTP la proporciona el paquete linuxptp, que incluye dos componentes:
ptp4l: un daemon que controla el PHC en la NIC y ejecuta el protocolo PTPphc2sys: un daemon que mantiene el reloj del sistema sincronizado con el PHC sincronizado por PTP en la NIC
Ambos daemon son necesarios para que la sincronización del sistema funcione correctamente y deben configurarse correctamente según la configuración de su sistema. Esto se trata en Sección 46.2, “Configuración de PTP para despliegues de telecomunicaciones”.
La forma más fácil y mejor de integrar PTP en su clúster en sentido descendente es añadir el paquete linuxptp bajo packageList en el archivo de definición de Edge Image Builder (EIB). De esta forma, el software del plano de control PTP se instalará automáticamente durante el aprovisionamiento del clúster. Consulte la documentación de EIB (Sección 5.3.6, “Configuración de paquetes RPM”) para obtener más información sobre la instalación de paquetes.
A continuación, encontrará un manifiesto de EIB de muestra con 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_CODEEl paquete linuxptp incluido en SUSE Telco Cloud no habilita ptp4l y phc2sys por defecto. Si sus archivos de configuración específicos del sistema se despliegan en el momento del aprovisionamiento (véase Sección 46.3, “Integración de Cluster API”), deberían estar habilitados. Hágalo añadiéndolos a la sección systemd del manifiesto, como en el ejemplo anterior.
Siga el proceso habitual para construir la imagen tal y como se describe en la Documentación de EIB (Sección 5.4, “Compilación de la imagen”) y utilícela para desplegar su clúster. Si es nuevo en EIB, empiece por Capítulo 12, Edge Image Builder en su lugar.
46.2 Configuración de PTP para despliegues de telecomunicaciones #
Muchas aplicaciones de telecomunicaciones requieren una sincronización estricta de fase y tiempo con poca desviación, lo que dio lugar a la definición de dos perfiles orientados a telecomunicaciones: ITU-T G.8275.1 e ITU-T G.8275.2. Ambos tienen una alta tasa de mensajes de sincronización y otros rasgos distintivos, como el uso de un algoritmo de mejor reloj maestro (BMCA) alternativo. Dicho comportamiento exige ajustes específicos en el archivo de configuración consumido por ptp4l, proporcionados en las siguientes secciones como referencia.
Ambas secciones solo cubren el caso de un reloj ordinario en la configuración de receptor de tiempo.
Cualquier perfil de este tipo debe utilizarse en una infraestructura PTP bien planificada.
Su red PTP específica puede requerir ajustes adicionales de la configuración; asegúrese de revisar y adaptar los ejemplos proporcionados si es necesario.
46.2.1 Perfil PTP ITU-T G.8275.1 #
El perfil G.8275.1 tiene las siguientes especificaciones:
Se ejecuta directamente sobre Ethernet y requiere compatibilidad total con la red (los nodos/conmutadores adyacentes deben ser compatibles con PTP).
El ajuste de dominio predeterminado es 24.
La comparación de conjuntos de datos se basa en el algoritmo G.8275.x y sus valores
localPrioritydespués depriority2.
Copie el siguiente contenido en un archivo llamado /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
Una vez creado el archivo, debe hacerse referencia a él en /etc/sysconfig/ptp4l para que el demonio se inicie correctamente. Esto puede hacerse cambiando la línea OPTIONS= por:
OPTIONS="-f /etc/ptp4l-G.8275.1.conf -i $IFNAME --message_tag ptp-8275.1"
Más concretamente:
-frequiere el nombre de archivo de configuración que se va a utilizar;/etc/ptp4l-G.8275.1.confen este caso-irequiere el nombre de la interfaz que se va a utilizar, sustituya$IFNAMEpor un nombre de interfaz real.--message_tagpermite identificar mejor la salida de ptp4l en los registros del sistema y es opcional.
Una vez completados los pasos anteriores, el daemon ptp4l debe iniciarse (o reiniciarse):
# systemctl restart ptp4lCompruebe el estado de la sincronización observando los registros con:
# journalctl -e -u ptp4l46.2.2 Perfil PTP ITU-T G.8275.2 #
El perfil G.8275.2 tiene las siguientes especificaciones:
Se ejecuta sobre IP y no requiere compatibilidad total con la red (es posible que los nodos/conmutadores adyacentes no sean compatibles con PTP).
El ajuste de dominio predeterminado es 44.
La comparación de conjuntos de datos se basa en el algoritmo G.8275.x y sus valores
localPrioritydespués depriority2.
Copie el siguiente contenido en un archivo llamado /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
Asegúrese de sustituir los siguientes marcadores de posición:
$PEER_IP_ADDRESS- la dirección IP del siguiente nodo PTP con el que comunicarse, como el reloj maestro o de contorno que proporcionará la sincronización.$IFNAME- indica aptp4lqué interfaz utilizar para PTP.
Una vez creado el archivo, debe hacerse referencia a él, junto con el nombre de la interfaz que se utilizará para PTP, en /etc/sysconfig/ptp4l para que el demonio se inicie correctamente. Esto puede hacerse cambiando la línea OPTIONS= por:
OPTIONS="-f /etc/ptp4l-G.8275.2.conf --message_tag ptp-8275.2"Más concretamente:
-frequiere el nombre de archivo de configuración que se va a utilizar. En este caso, es/etc/ptp4l-G.8275.2.conf.--message_tagpermite identificar mejor la salida de ptp4l en los registros del sistema y es opcional.
Una vez completados los pasos anteriores, el daemon ptp4l debe iniciarse (o reiniciarse):
# systemctl restart ptp4lCompruebe el estado de la sincronización observando los registros con:
# journalctl -e -u ptp4l46.2.3 Configuración PTP de un Boundary Clock #
Las secciones anteriores trataban la configuración de un Ordinary Clock, pero los despliegues de telecomunicaciones pueden requerir que el nodo actúe como un Boundary Clock. En tal escenario, la hora de referencia debe propagarse desde un Grand Master a uno o más Time Receivers en sentido descendente, lo que requiere una NIC con dos o más puertos. En este caso, un puerto asumirá el rol de Time Receiver, es decir, controlará las actualizaciones del PTP Hardware Clock (PHC) en la NIC, mientras que los restantes funcionarán como Time Transmitters. Una única instancia de ptp4l es suficiente para una única NIC multipuerto, pero debe proporcionarse cada interfaz de núcleo de Linux implicada en la distribución de la hora, como parte de su configuración. Por ejemplo, actualice el archivo /etc/sysconfig/ptp4l para incluir cuatro puertos; simplemente sustituya las variables por los nombres reales de las interfaces o ajústelo según sea necesario:
OPTIONS="-f /etc/ptp4l-G.8275.1.conf --message_tag ptp-8275.1 -i $IFNAME1 -i $IFNAME2 -i $IFNAME3 -i $IFNAME4"No es necesario establecer clock_type en BC, ya que se sobreentenderá automáticamente si se proporciona más de un puerto.
Una vez hecho esto, el daemon ptp4l puede (re)iniciarse con:
# systemctl restart ptp4lSin una configuración de puerto específica, ptp4l ejecutará el BMCA para determinar a través de qué puerto se puede alcanzar el GM. Si se prefiere una configuración estática, añada una sección para cada puerto con el rol prescrito en el archivo de configuración. Por ejemplo:
# 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 obstante, asegúrese de determinar la conexión correcta con el GM antes de iniciar el daemon.
46.2.4 Sincronización del reloj del sistema desde PTP #
Es importante tener en cuenta que PTP funciona sincronizando los relojes de hardware locales de las NIC. Esto no alinea automáticamente el reloj del sistema con el GM, ya que el reloj del sistema se deriva de un reloj de hardware diferente.
Para mantener el reloj del sistema sincronizado con PTP, debe ejecutarse phc2sys. Se recomienda completar totalmente la configuración de ptp4l antes de pasar a phc2sys. phc2sys no requiere un archivo de configuración por defecto y sus parámetros de ejecución pueden controlarse únicamente a través de la variable OPTIONS= presente en /etc/sysconfig/ptp4l, de forma similar a ptp4l:
OPTIONS="-s $IFNAME -w"
Donde $IFNAME es el nombre de la interfaz ya configurada en ptp4l que se utilizará como fuente para el reloj del sistema. Esto se utiliza para identificar el PHC de origen.
Sin embargo, si se utiliza un perfil PTP o un número de dominio específico, es posible que phc2sys requiera que se le proporcione un archivo de configuración de acuerdo con el proporcionado a ptp4l. En la mayoría de los casos, también se puede reutilizar directamente con phc2sys:
OPTIONS="-f /etc/ptp4l-G.8275.1.conf -s $IFNAME -w"
46.3 Integración de Cluster API #
Siempre que un clúster se despliegue a través de un clúster de gestión y aprovisionamiento de red dirigido, tanto el archivo de configuración como las dos variables de configuración en /etc/sysconfig pueden desplegarse en el host en el momento del aprovisionamiento. A continuación se muestra un extracto de una definición de clúster, centrado en un objeto RKE2ControlPlane modificado que despliega el mismo archivo de configuración G.8275.1 en todos los 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"Además de otras variables, la definición anterior debe completarse con el nombre de la interfaz y con los demás objetos de Cluster API, tal como se describe en Parte VII, “Aprovisionamiento de red dirigido totalmente automatizado”.
Este enfoque solo es conveniente si el hardware del clúster es uniforme y se necesita la misma configuración en todos los hosts, incluido el nombre de la interfaz.
Existen enfoques alternativos que se tratarán en futuras versiones.
En este punto, sus hosts deberían tener una pila PTP operativa y en ejecución, y comenzarán a negociar su función PTP.
46.4 PTP en plataformas Intel Granite Rapids-D #
SUSE Telco Cloud admite una temporización precisa en una variedad de plataformas diferentes, incluidos los últimos diseños basados en Intel Granite Rapids-D (GNR-D). Estos nuevos servidores suelen incluir un controlador Ethernet de alta velocidad integrado y una o más tarjetas adicionales con un controlador Ethernet para puertos adicionales. A diferencia de las generaciones de plataformas anteriores, también están equipados con un DPLL dedicado que permite el enrutamiento de las señales de temporización a través del sistema y las diferentes NIC, y ya no requiere cableado externo. Por tanto, el despliegue general se simplifica, pero se requieren pasos y componentes de software específicos, como la configuración del DPLL y de la señal interna durante el arranque.
Antes de realizar los pasos de configuración, descargad e instalad el controlador de núcleo de Linux más reciente para los Intel 800 Series Network Devices desde el sitio web de Intel. Seleccionad el archivo zip que contiene los "ice_RPM_Files" y descomprimid el archivo, luego instalad el ice-kmp-default-*sles16sp0.x86_64.rpm RPM que contiene, por ejemplo, el archivo 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.rpmReiniciad el servidor para que el cambio sea persistente y efectivo.
Se utilizará un sistema Dell PowerEdge XR8720t como sistema de referencia a lo largo de los ejemplos; las interfaces del núcleo de Linux y la configuración de puertos podrían ser diferentes en otro servidor GNR-D.
Se asume un despliegue de telecomunicaciones y el perfil G.8275.1 utilizado a lo largo de las siguientes secciones para PTP.
46.4.1 Reloj de frontera PTP #
Esta sección describe el proceso de configuración de un Reloj de frontera (BC) en un sistema GNR-D, donde un puerto en la NIC integrada recibe las marcas de tiempo PTP de un GM y todos los puertos restantes en el sistema actúan como transmisores de tiempo hacia otros nodos de red.
La configuración descrita aquí es completamente estática. Si el GM deja de estar disponible, la sincronización en sentido descendente dependerá exclusivamente de las capacidades de mantenimiento de tiempo (holdover) del host; no se realizará ningún cambio automático a una fuente de referencia de tiempo diferente.
Para habilitar el comportamiento de BC, ejecutad los siguientes pasos en el mismo orden cada vez que se inicie el sistema:
Verificad que los dispositivos PTP esperados que controlan los PHC estén 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/ptp3NotaAjustad los comandos subsiguientes de acuerdo con los nombres reales encontrados en el sistema que se está configurando.
Identificad el controlador integrado, ya que requerirá una configuración específica:
La salida anterior debería indicar el dispositivo al que están vinculados a través de la dirección PCI y podéis utilizar
lspcipara buscar el 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 con un controlador integrado Intel E825-C y dos tarjetas complementarias E830-CC.
Alternativamente, podéis encontrar más información sobre el controlador buscando el primer puerto de red del controlador que expone ese 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 [...]Tened en cuenta que
em5es el primer puerto del controlador Ethernet integrado en este sistema.Configurad las señales entre el PHC en el controlador Ethernet integrado y el DPLL de temporización del sistema:
Dejad que el DPLL controle el reloj Ethernet en el controlador integrado:
# echo 4 1 > /sys/class/net/em5/device/tspll_cfgHabilitad un pulso cada inicio de segundo (Pulse Per Second, PPS) desde el PHC al DPLL a través del pin SDP2 (señal de 1 kHz):
# echo 2 1 > /sys/class/ptp/ptp1/pins/SDP2 # echo 1 0 0 0 1000000 > /sys/class/ptp/ptp1/periodOpcionalmente, el pin SPD0 (señal de 1 Hz) también puede habilitarse:
# echo 2 2 > /sys/class/ptp/ptp1/pins/SDP0 # echo 2 0 0 1 0 > /sys/class/ptp/ptp1/periodHabilitad la señal de 1 PPS para que se propague desde el DPLL del sistema de temporización a las tarjetas adicionales:
# echo 1 1 > /sys/class/ptp/ptp2/pins/SDP1 # echo 1 1 > /sys/class/ptp/ptp3/pins/SDP1
Ejecutad
ts2phcpara mantener los PHC de las tarjetas adicionales sincronizados con la misma marca de tiempo del PHC/dev/ptp1:# ts2phc -f ts2phc-aic-all.cfg -s /dev/ptp1Consultad Sección 46.4.2.3, “
ts2phcarchivo de configuración para tarjetas complementarias” para ver el contenido dets2phc-aic-all.cfg.Ejecutad una instancia de
ptp4lpara el controlador integrado (/dev/ptp1):# ptp4l -f ptp4l-G.8275.1-nac.confConsultad Sección 46.4.2.1, “Archivo de configuración de
ptp4lpara el controlador integrado (/dev/ptp1)” para ver el contenido deptp4l-G.8275.1-nac.conf.Ejecutad una instancia de
ptp4lpara cada tarjeta complementaria (/dev/ptp3y/o/dev/ptp2):# ptp4l -f ptp4l-G.8275.1-aic1.conf # ptp4l -f ptp4l-G.8275.1-aic2.confConsultad Sección 46.4.2.2, “
ptp4larchivo de configuración para tarjetas complementarias (/dev/ptp2o/dev/ptp3)” para conocer el contenido de los archivos de configuración.NotaPara evitar conflictos y permitir el siguiente paso, cada una de estas instancias debe utilizar sockets de control y de solo lectura diferentes.
Sincronizad los parámetros y valores de tiempo de ejecución PTP de las instancias de AICs
ptp4lconpmc:Se espera que un BC reenvíe no solo la hora de un GM al que está conectado, sino también parámetros auxiliares, como su clase de reloj y nivel de precisión. Esto ocurre automáticamente dentro de un grupo de interfaces gestionadas por la misma instancia de
ptp4l, pero no entre diferentes instancias deptp4l, que gestionan diferentes PHC y puertos.Una vez que el sistema esté sincronizado con un GM, consultad la instancia de
ptp4len el controlador integrado y estableced los valores en las instancias deptp4lrestantes mediante comandospmc. Por ejemplo:# 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 0xa0Consultad Sección 46.4.2.4, “Script de reenvío de parámetros GM” para automatizar este proceso y evitar pasos manuales.
Opcionalmente, ejecutad
phc2syspara obtener la hora del sistema a partir de la sincronización PTP:# phc2sys -f /etc/ptp4l-G.8275.1-nac.conf -s /dev/ptp1 -c CLOCK_REALTIME -wEl archivo de entrada es el mismo archivo de configuración utilizado para
ptp4ly el controlador integrado. Consultad Sección 46.2.4, “Sincronización del reloj del sistema desde PTP” para permitir que systemd gestione su ejecución.
46.4.2 Archivos de configuración #
Esta sección proporciona archivos de configuración y scripts de ejemplo que pueden utilizarse junto con los pasos anteriores para configurar rápidamente un BC funcional en GNR-D. Los archivos de configuración de ptp4l contienen todos los ajustes necesarios, sin necesidad de indicadores de ejecución externos adicionales, y se basan todos en el perfil de telecomunicaciones G.8275.1. Se proporcionan más detalles sobre cada archivo en sus respectivas secciones.
46.4.2.1 Archivo de configuración de ptp4l para el 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]
La configuración anterior aprovecha el BMCA para determinar el papel del puerto, asumiendo que hay un GM disponible a través de uno de ellos. Si se necesita un control más estricto, añadid el indicador serverOnly bajo cada definición de interfaz. Para obtener más detalles, consultad Sección 46.2.3, “Configuración PTP de un Boundary Clock” o la configuración de las tarjetas complementarias a continuación como ejemplo.
Por motivos de brevedad, solo se enumeran cuatro interfaces. Debéis ajustarlas según vuestros requisitos.
46.4.2.2 ptp4l archivo de configuración para tarjetas complementarias (/dev/ptp2 o /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 motivos de brevedad, solo se enumeran cuatro interfaces. Debéis realizar los ajustes según vuestros requisitos. Todas las interfaces se han configurado estáticamente con el rol TimeTransmitter.
46.4.2.3 ts2phc archivo de configuración para tarjetas complementarias #
[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 configuración cubre la sincronización de dos tarjetas complementarias (referenciadas por su primer puerto, p1p1 y p2p1) a través del SDP1 en cada controlador.
46.4.2.4 Script de reenvío de parámetros GM #
El script siguiente puede utilizarse para reenviar los valores y parámetros del GM a los Time Receivers en puertos gestionados por instancias de ptp4l distintas de aquella en la que reside el GM. No olvidéis editar la sección Input variables para ajustar los nombres de archivo y ejecutarlo una vez que el sistema esté sincronizado con un GM.
#!/bin/bash
set -euo pipefail
################## Variables 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)
#####################################################
# Comprobad que el sistema está sincronizado con un 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 \"No hay ningún GM presente, saliendo...\"
exit 1
fi
# Obtened los valores del Grand Master "sentido ascendente"
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 se han recuperado valores de PARENT_DATA_SET\"
exit 2
elif [ -z \"$TPDS_GM_VALUES\" ]; then
echo \"No se han recuperado valores de TIME_PROPERTIES_DATA_SET\"
exit 2
fi
# Desempaquetad de PARENT_DATA_SET
leer CLOCK_CLASS CLOCK_ACCURACY VARIANCE <<< $PDS_GM_VALUES
# Desempaquetad de TIME_PROPERTIES_DATA_SET
leer 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\n echo \"Leer de PARENT_DATA_SET: clockClass=${CLOCK_CLASS} clockAccuracy=${CLOCK_ACCURACY} offsetScaledLogVariance=${VARIANCE}\"\n echo \"Leer de TIME_PROPERTIES_DATA_SET: currentUtcOffset=${UTC_OFFSET} leap61=${LEAP_61} leap59=${LEAP_59}\" \\\n \"currentUtcOffsetValid=${UTC_OFFSET_VALID} ptpTimescale=${PTP_TIMESCALE} timeTraceable=${T_TRACEABLE}\" \\\n \"frequencyTraceable=${F_TRACEABLE} timeSource=${T_SOURCE}\"\nfi
# Reenviad estos valores a los receptores de tiempo "sentido descendente" actualizando las instancias de ptp4l
for FILE in \"${CONFIG_FILES_AICS[@]}\"; do\n if [ \"$VERBOSE\" -eq 1 ]; then\n echo \"Actualizando GRANDMASTER_SETTINGS_NP (${FILE})\"\n 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 "Falló al actualizar ${FILE}" +
fi +
doneEl script debe ejecutarse cada vez que cambie el GM.