|Index|SUSE Telco Cloud Documentación|Configuración de las funciones Telco|Protocolo de tiempo de precisión
Se aplica a SUSE Telco Cloud 3.7

47 Protocolo de tiempo de precisión

47.1 Introducción

El Protocolo de tiempo de precisión (PTP), definido por el estándar IEEE 1588, distribuye tiempo de alta precisión a través de una red de paquetes. Cuando las tarjetas de interfaz de red (NIC) marcan el tiempo de los paquetes PTP en el hardware, se alcanza una precisión de submicrosegundos, mucho más allá de lo que NTP puede ofrecer. En entornos de telecomunicaciones, PTP es un componente básico de las redes de acceso por radio (RAN) 5G, donde las unidades de radio requieren una alineación estricta de fase y tiempo para transmitir correctamente. SUSE Telco Cloud implementa PTP a través del paquete linuxptp y se dirige a los perfiles de telecomunicaciones ITU-T G.8275.1 e ITU-T G.8275.2 descritos a continuación.

Un dominio PTP se construye a partir de un pequeño conjunto de funciones de reloj:

  • Grandmaster (GM): la fuente principal de tiempo para el dominio. Normalmente está bloqueado a un reloj de referencia de tiempo primario (PRTC), generalmente controlado por un receptor GNSS, y transmite el tiempo hacia los nodos descendentes. La precisión del GM establece el límite de calidad para todo el dominio.

  • Ordinary Clock (OC): un nodo final con un único puerto PTP. En un despliegue de telecomunicaciones, actúa como receptor de tiempo, disciplinando su reloj local a partir de un Grandmaster o Boundary Clock en sentido ascendente. Un nodo de computación que ejecuta una carga de trabajo de radio es un OC típico.

  • Boundary Clock (BC): un nodo multipuerto que recibe tiempo en un puerto (receptor de tiempo) y lo regenera hacia otros nodos en sus puertos restantes (transmisor de tiempo). La inserción de Boundary Clocks a lo largo de la vía acorta la cadena entre cada OC y la referencia, limitando el error que la red acumularía de otro modo, salto tras salto.

La distinción entre un Ordinary Clock y un Boundary Clock es fundamental al diseñar la topología:

  • Un Ordinary Clock tiene un único puerto PTP y se sitúa en el edge del dominio. Solo consume tiempo para disciplinar su propio reloj y nunca reenvía el tiempo a otros nodos.

  • Un reloj de contorno tiene múltiples puertos PTP. Consume tiempo en su puerto de receptor de tiempo y lo regenera en sus puertos de transmisor de tiempo, terminando la cadena de temporización ascendente e iniciando una nueva cadena descendente. Esta regeneración es lo que evita que el error se acumule a lo largo de una larga cadena de nodos.

Los siguientes elementos de hardware y señalización soportan estas funciones:

  • Reloj de hardware PTP (PHC): el reloj integrado en la NIC que PTP sincroniza realmente. Alinear el reloj del sistema operativo con el PHC es un paso independiente gestionado por un daemon dedicado.

  • Ethernet síncrono (SyncE): sincronización de frecuencia de capa física. PTP transporta la fase y el tiempo dentro de los paquetes, mientras que SyncE recupera una frecuencia estable directamente de la señal Ethernet. SyncE es una mejora opcional: PTP por sí solo ya proporciona fase y tiempo, y SyncE se añade únicamente cuando un nodo necesita una mayor estabilidad de frecuencia y una retención más larga en caso de que la fuente de tiempo PTP se pierda temporalmente.

  • Bucle de enganche de fase digital (DPLL): un bloque de temporización de hardware que se engancha a una señal de referencia y la filtra para generar un reloj estable y limpio. Es lo que disciplina el PHC a partir de las entradas disponibles y, en plataformas con más de una NIC, mantiene alineados los diferentes relojes de las NIC.

En cada nodo, estas funciones son llevadas a cabo por los daemons linuxptp: ptp4l ejecuta el protocolo PTP y disciplina el PHC, y phc2sys alinea el reloj del sistema con el PHC. En un Grandmaster, ts2phc dirige además el PHC desde la referencia GNSS. Sus funciones e instalación se tratan en Sección 47.2, “Requisitos previos”.

El reloj de hardware en sí es gestionado por el subsistema DPLL del kernel de Linux junto con el controlador de red. El grado de control de la temporización, y cómo se distribuye la temporización dentro de un nodo con múltiples NIC, depende de dónde se sitúe el DPLL gestionable:

  • NIC con un DPLL integrado: el DPLL está integrado en la NIC y se configura a través del subsistema DPLL de Linux. Selecciona y se bloquea en la referencia elegida y disciplina el PHC, proporcionando un control total sobre la frecuencia y el holdover.

  • NIC sin un DPLL integrado: la NIC no expone ningún DPLL configurable. ptp4l disciplina el PHC directamente, y el subsistema puede, como mucho, informar del estado de bloqueo (solo lectura); el manejo avanzado de frecuencia depende entonces de una fuente de temporización externa.

  • DPLL integrado compartido entre varias NICs: el DPLL no está incrustado en una sola NIC, sino que se encuentra en la plataforma, externo a las NICs. Disciplina y mantiene los PHCs de varias NICs alineados a partir de una referencia común, por lo que cada NIC en el nodo comparte el mismo tiempo. Esta disposición se utiliza en plataformas multi-NIC que distribuyen la temporización internamente en lugar de depender de cableado externo.

Nodo cuya NIC integra un DPLL gestionable
Figura 47.1: Software PTP en un nodo cuya NIC integra un DPLL gestionable
Nodo cuya NIC no tiene un DPLL gestionable
Figura 47.2: Software PTP en un nodo cuya NIC no tiene un DPLL gestionable
Nodo con un DPLL integrado compartido entre NICs
Figura 47.3: Software PTP en un nodo con un DPLL integrado compartido entre NICs

Las redes de telecomunicaciones se estandarizan en dos perfiles ITU-T, que difieren principalmente en el transporte utilizado y en cuánto de la red subyacente debe ser compatible con PTP:

  • ITU-T G.8275.1 (soporte de temporización completo): se ejecuta directamente sobre Ethernet (Capa 2) utilizando multidifusión. Cada nodo a lo largo de la vía debe ser compatible con PTP y actuar como un Boundary Clock, lo que proporciona la mayor precisión. A menos que se indique lo contrario, los escenarios de esta guía utilizan este perfil.

  • ITU-T G.8275.2 (soporte de temporización parcial): se ejecuta sobre IP (Capa 3) utilizando unidifusión. No se requiere que los nodos intermedios soporten PTP, por lo que la temporización puede cruzar segmentos de red que no son compatibles con la temporización, a costa de una menor precisión.

Las siguientes figuras muestran la distribución del tiempo solo con PTP y con SyncE añadido como una mejora de frecuencia opcional. En ambos casos, el Grandmaster deriva su referencia de una fuente PRTC/GNSS y el Boundary Clock regenera la temporización hacia los puntos finales.

Distribución solo con PTP con Grandmaster
Figura 47.4: Distribución solo con PTP
Distribución de PTP y SyncE con Grandmaster
Figura 47.5: Distribución de tiempo y de frecuencia con PTP y SyncE (mejora opcional)

Los siguientes escenarios se tratan en esta guía. Cada escenario incluye un enlace a su automatización de Cluster API (CAPI).

Nota
Nota

Solo el Escenario 1a (Sección 47.3, “Escenario 1a - Reloj ordinario (solo PTP)”) muestra la configuración para ambos perfiles de telecomunicaciones, ITU-T G.8275.1 e ITU-T G.8275.2. Los escenarios restantes se centran únicamente en el caso ITU-T G.8275.1 por brevedad: la ampliación es idéntica y solo cambia el archivo de configuración ptp4l entre los dos perfiles.

47.2 Requisitos previos

Esta guía cubre únicamente perfiles específicos de telecomunicaciones, por lo que se asume el uso de marca de tiempo por hardware y de un reloj de hardware PTP (PHC) en la NIC. Los adaptadores de red de grado de telecomunicaciones proporcionan soporte PTP por hardware; puede confirmar las capacidades de una interfaz determinada con 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

Compruebe las capacidades hardware-transmit, hardware-receive y hardware-raw-clock y un índice PTP Hardware Clock de 0 o superior (un valor de -1 significa que la interfaz no tiene PHC). Sustituya eno16495np0 por la interfaz que pretenda utilizar para PTP.

PTP se proporciona mediante el paquete linuxptp. Incluye tres programas de espacio de usuario —ptp4l, phc2sys y ts2phc— que se ejecutan como daemons de larga duración gestionados por systemd (un servicio dedicado para cada uno: ptp4l.service, phc2sys.service y ts2phc.service). Colectivamente, ejecutan el protocolo y mantienen los relojes sincronizados:

  • ptp4l: el daemon PTP. Ejecuta el protocolo IEEE 1588 en las interfaces configuradas, aplica el algoritmo Best Master Clock Algorithm (BMCA) para determinar el papel de cada puerto y disciplina el PHC de la NIC. Una única instancia de ptp4l puede gestionar varios puertos, que es lo que permite que un nodo actúe como Boundary Clock.

  • phc2sys: sincroniza dos relojes. Se utiliza normalmente para alinear el reloj del sistema (sistema operativo) con el PHC que ptp4l mantiene sincronizado, de modo que la hora del sistema también siga a PTP.

  • ts2phc: "time stamp to PHC" (marca de tiempo a PHC). Disciplina el PHC a partir de una señal horaria externa, como el PPS suministrado por un receptor GNSS. Se utiliza en un Grandmaster y para mantener múltiples PHC alineados dentro del mismo nodo.

La forma recomendada de instalar PTP en un clúster de sentido descendente es añadir el paquete linuxptp a la packageList del archivo de definición de Edge Image Builder (EIB), para que se amplíe automáticamente durante el aprovisionamiento. 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.

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

El paquete linuxptp no habilita ptp4l, phc2sys o ts2phc de forma predeterminada. Tras desplegar el archivo de configuración, utilice la sección systemd del manifiesto para habilitar los daemons de nodo necesarios (consulte los escenarios a continuación).

Por último, el perfil PTP en uso determina si los conmutadores de red entre nodos deben configurarse como dispositivos compatibles con PTP:

  • ITU-T G.8275.1 (soporte de temporización completo): se ejecuta directamente sobre Ethernet (Capa 2) mediante multidifusión. Cada nodo a lo largo de la vía debe ser compatible con PTP y actuar como Boundary Clock, lo que proporciona la mayor precisión; por tanto, los conmutadores intermedios deben configurarse para PTP. A menos que se indique lo contrario, los escenarios de esta guía utilizan este perfil.

  • ITU-T G.8275.2 (soporte de temporización parcial): se ejecuta sobre IP (Capa 3) mediante unidifusión. Los nodos intermedios no necesitan ser compatibles con PTP, por lo que la sincronización puede atravesar segmentos de red que no sean compatibles con PTP, y los conmutadores no requieren configuración de PTP, a costa de una menor precisión.

47.3 Escenario 1a - Reloj ordinario (solo PTP)

Explicación

Esta es la ampliación de PTP más sencilla: un único nodo de clúster consume tiempo de una fuente de sentido ascendente y disciplina sus relojes locales, sin reenviar nunca el tiempo a otro nodo. El nodo funciona como un reloj ordinario (OC) con un único puerto PTP en el rol de receptor de tiempo.

En el nodo OC, la sincronización es gestionada completamente por los daemons linuxptp, independientemente del perfil en uso. No se requiere configuración de DPLL ni ts2phc, porque el nodo utiliza una única NIC y ptp4l disciplina su PHC directamente:

  • ptp4l ejecuta el protocolo PTP en la interfaz receptora. El algoritmo de mejor reloj maestro (BMCA) selecciona el nodo de sentido ascendente como maestro, el puerto local pasa al estado SLAVE y ptp4l disciplina el reloj de hardware PTP (PHC) de la NIC. Establecer clientOnly 1 restringe el nodo al rol de receptor de tiempo, por lo que nunca puede seleccionarse como maestro.

  • phc2sys alinea el reloj del sistema (CLOCK_REALTIME) con el PHC que ptp4l mantiene sincronizado, de modo que la hora del sistema operativo también sigue a PTP.

El escenario puede implementarse con cualquiera de los perfiles de telecomunicaciones. Difieren en el transporte y en lo que debe proporcionar la red intermedia, y se documentan a continuación como dos modelos independientes:

Importante
Importante

Un reloj ordinario ejecuta un único perfil PTP a la vez. Los dos modelos son mutuamente excluyentes: configure solo uno de ellos en un nodo determinado. Cree solo el archivo de configuración del perfil elegido y haga referencia únicamente a ese archivo en /etc/sysconfig/ptp4l. No cree /etc/ptp4l-G.8275.1.conf ni /etc/ptp4l-G.8275.2.conf, y nunca pase ambos archivos a la línea OPTIONS=.

Modelo 1 — ITU-T G.8275.1 (multidifusión de capa 2)

G.8275.1 se ejecuta directamente sobre Ethernet y dirige sus mensajes a la dirección MAC de multidifusión no reenviable 01:80:C2:00:00:0E, que los puentes estándar no reenvían, por lo que cada dispositivo en la vía debe terminar y regenerar PTP. Los componentes son:

  • Grandmaster (GM): la referencia de sentido ascendente para el dominio PTP (dominio 24 para G.8275.1), normalmente bloqueada a una fuente GNSS/PRTC.

  • PTP-aware switch: actúa como un Boundary Clock. Su puerto hacia el GM es un Time Receiver y su puerto hacia el OC es un Time Transmitter. Ambos puertos deben tener PTP habilitado.

  • Ordinary Clock (OC): el nodo del clúster, que recibe la hora en su único puerto PTP.

Escenario 1a - Ordinary Clock (solo PTP) con G.8275.1
Figura 47.6: Ordinary Clock (OC) — G.8275.1 (multidifusión de capa 2)

Configure el nodo de la siguiente manera:

  1. Identifique el índice PHC <N> de la interfaz utilizada para PTP (aquí eno8403np1); el valor del campo impreso PTP Hardware Clock (que también puede aparecer como Hardware timestamp provider index) proporciona el dispositivo /dev/ptp<N> que ptp4l disciplina y que phc2sys lee como su fuente:

    # ethtool -T eno8403np1
    Time stamping parameters for eno8403np1:
    Capabilities:
            hardware-transmit
            hardware-receive
            hardware-raw-clock
    PTP Hardware Clock: 1
    ...

    En este ejemplo, el PHC de eno8403np1 es /dev/ptp1.

  2. Cree el ptp4l`archivo de configuración `/etc/ptp4l-G.8275.1.conf. La interfaz se declara como una sección ([eno8403np1]), por lo que el daemon no necesita el indicador -i:

    Ejemplo 47.1: Configuración del reloj ordinario — 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]

    El valor ptp_dst_mac es fijo para G.8275.1: es la dirección de multidifusión no reenviable 01:80:C2:00:00:0E que limita PTP a un solo enlace y es la razón por la que cada dispositivo en la vía debe ser compatible con PTP. El uds_address expone un socket de gestión que phc2sys utiliza para seguir el estado del puerto.

  3. Apunte ptp4l a este archivo en /etc/sysconfig/ptp4l:

    OPTIONS="-f /etc/ptp4l-G.8275.1.conf"
  4. Configure phc2sys en /etc/sysconfig/phc2sys para disciplinar el reloj del sistema desde el PHC de la interfaz PTP (/dev/ptp1). Los valores --uds_address y --domainNumber deben coincidir con la configuración ptp4l:

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

    -s /dev/ptp1 selecciona el PHC como reloj de origen, -w espera a que ptp4l se sincronice antes de ajustar el reloj del sistema, y -m imprime el estado del servo en el registro.

  5. Habilitad e iniciad ambos servicios:

    # systemctl enable --now ptp4l phc2sys
  6. Verificad que ptp4l se ha bloqueado con el maestro en sentido ascendente. El puerto pasa a SLAVE y el desfase notificado (rms) converge a un valor bajo y estable:

    # 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. Verificad que phc2sys está disciplinando el reloj del sistema. El estado del servo progresa desde s0 (desbloqueado) a través de s1 (paso inicial) hasta s2 (bloqueado), y el desfase se estabiliza alrededor de cero:

    # 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

    Un estado s2 estable con un desfase pequeño confirma que el nodo está bloqueado y que el reloj del sistema sigue a PTP.

Modelo 2 — ITU-T G.8275.2 (Unidifusión de capa 3)

G.8275.2 se ejecuta sobre IP (capa 3) utilizando unidifusión: el OC intercambia mensajes directamente con la dirección IP del maestro, por lo que la red intermedia no necesita ser compatible con PTP y no se requiere ningún conmutador habilitado para PTP. Los componentes son:

  • Maestro (GM o reloj de contorno): el maestro en sentido ascendente, accesible por IP en el dominio G.8275.2 (dominio 44).

  • Red IP: una red estándar conmutada o enrutada. Reenvía los paquetes PTP de unidifusión sin ninguna configuración PTP.

  • Reloj ordinario (OC): el nodo del clúster, que envía solicitudes de unidifusión al maestro desde su único puerto PTP.

Escenario 1a - Reloj ordinario (solo PTP) con G.8275.2
Figura 47.7: Reloj ordinario (OC) — G.8275.2 (unidifusión de capa 3)

Configure el nodo de la siguiente manera:

  1. Identificad el PHC de la interfaz PTP como en el Modelo 1 (ethtool -T eno8403np1); en este ejemplo, el PHC de eno8403np1 es /dev/ptp1.

  2. Cree el ptp4l`archivo de configuración `/etc/ptp4l-G.8275.2.conf. No hay ptp_dst_mac, porque se llega al maestro por IP a través de unicast_master_table. Sustituid $MASTER_IP_ADDRESS por la dirección IP del maestro en sentido ascendente:

    Ejemplo 47.2: Configuración del reloj ordinario — 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. Apuntad ptp4l a este archivo en /etc/sysconfig/ptp4l:

    OPTIONS="-f /etc/ptp4l-G.8275.2.conf"
  4. Configure phc2sys en /etc/sysconfig/phc2sys con el número de dominio G.8275.2 (44); el PHC de origen y --uds_address permanecen sin cambios:

    OPTIONS="-s /dev/ptp1 -w -m --uds_address /var/run/ptp4l --domainNumber 44"
  5. Habilitad e iniciad ambos servicios:

    # systemctl enable --now ptp4l phc2sys
  6. Verificad la sincronización como en el Modelo 1: ptp4l mueve el puerto a SLAVE (journalctl -u ptp4l) y phc2sys alcanza el estado s2 (bloqueado) con un desfase cercano a cero (journalctl -u phc2sys).

Automatización CAPI

Para desplegar este escenario utilizando el flujo de trabajo de aprovisionamiento automatizado, utilizad la plantilla genérica de Cluster API descrita en Aprovisionamiento de red dirigido totalmente automatizado (Sección 55.1, “Protocolo de tiempo de precisión (PTP)”), sobrescribiendo sus marcadores de posición con los valores para este escenario que se muestran a continuación.

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

${PTP4L_CONF_PATH}

/etc/ptp4l-G.8275.1.conf

${PTP4L_CONF_CONTENTS}

Copie el contenido de la configuración G.8275.1 anterior (Ejemplo 47.1, “Configuración del reloj ordinario — 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

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

${PTP4L_CONF_PATH}

/etc/ptp4l-G.8275.2.conf

${PTP4L_CONF_CONTENTS}

Copie el contenido de la configuración G.8275.2 anterior (Ejemplo 47.2, “Configuración del reloj ordinario — 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 Escenario 1b - Reloj ordinario (modo híbrido: PTP y SyncE)

Este escenario aún no es compatible; se incluirá en una futura versión de SUSE Telco Cloud.

47.5 Escenario 2a - Reloj de contorno (solo PTP) con NIC única multipuerto, incluida la propagación al servidor de reloj ordinario

Explicación

Este escenario amplía la cadena de temporización con un Reloj de contorno (BC) que regenera PTP hacia un Reloj ordinario (OC) en sentido descendente, totalmente a través de ITU-T G.8275.1 (solo PTP, capa 2). El BC utiliza una única NIC multipuerto: una instancia de ptp4l gestiona varios puertos en la misma NIC, por lo que no se requiere ni ts2phc ni enrutamiento DPLL (a diferencia de los escenarios con múltiples NIC).

El escenario implica los siguientes componentes:

  • Grandmaster (GM): la referencia para el dominio PTP (dominio 24), normalmente bloqueado a una fuente GNSS/PRTC (el banco de pruebas utilizado aquí no tiene GNSS, de ahí el gm.ClockClass degradado que se muestra más adelante). Envía la hora en el segmento de sentido ascendente.

  • Switch compatible con PTP: actúa como un Reloj de contorno (T-BC) en la vía de temporización; cada puerto que transporta PTP tiene ptp enable.

  • Reloj de contorno (servidor BC): un nodo multipuerto en una única NIC que puentea dos segmentos PTP. Su puerto eno8403np1 se enfrenta al segmento sentido ascendente como receptor de tiempo (SLAVE) y disciplina el PHC de la NIC; eno8503np2 (y eno8603np3) se enfrentan al segmento sentido descendente como transmisores de tiempo que regeneran PTP. El BC termina la cadena de temporización de sentido ascendente e inicia una nueva de sentido descendente.

  • Ordinary Clock (servidor OC): un nodo de puerto único (ens6f0np0) en el segmento sentido descendente, donde su único maestro PTP es el BC. Disciplina sus relojes locales a partir del tiempo que regenera el BC.

La temporización es gestionada por los daemon linuxptp en cada nodo:

  • En el servidor BC, una única instancia ptp4l gestiona todos sus puertos. El BMCA selecciona al GM como maestro en eno8403np1, que pasa a SLAVE y disciplina el PHC. eno8503np2 y eno8603np3 se ven obligados a serverOnly 1, por lo que actúan solo como transmisores de tiempo. Debido a que todos los puertos comparten el mismo PHC de la NIC, el tiempo recibido está directamente disponible para los puertos de transmisión; un Boundary Clock se implica automáticamente cuando se configura más de un puerto, por lo que no se necesita ningún ajuste clock_type o ts2phc.

  • En el servidor OC, ptp4l se ejecuta con clientOnly 1 en ens6f0np0, por lo que el puerto solo actúa como receptor de tiempo. phc2sys alinea el reloj del sistema con el PHC.

  • En el servidor OC, clientOnly 1 es lo que garantiza que nunca se convierta en maestro. El atributo localPriority —utilizado por el BMCA G.8275.x solo como desempate, cuando clockClass, clockAccuracy, variance y priority2 son iguales, donde se prefiere un valor más bajo— refuerza este orden: el servidor BC mantiene el 128 predeterminado, mientras que el servidor OC utiliza el 250 de menor preferencia.

El BC puentea dos segmentos PTP separados: un segmento sentido ascendente entre el GM y su puerto eno8403np1, y un segmento sentido descendente entre su puerto eno8503np2 y el OC. Estos se mantienen separados, por ejemplo, en diferentes VLAN del switch o en redes independientes. Debido a que el BC es el único maestro en el segmento de sentido descendente, el OC se sincroniza desde el BC y nunca directamente desde el GM.

Como en el Escenario 1a (Sección 47.3, “Escenario 1a - Reloj ordinario (solo PTP)”), este escenario utiliza la dirección MAC de multidifusión no reenviable 01:80:C2:00:00:0E; los puentes estándar no la reenvían, por lo que cada dispositivo compatible con PTP termina y regenera PTP. La misma dirección debe configurarse en cada nodo de la ruta de temporización.

Diagrama

Escenario 2a - Boundary Clock (solo PTP) con NIC única multipuerto
Figura 47.8: Boundary Clock (solo PTP), NIC única, con propagación a un Reloj Ordinario

Configuración

Cada puerto de switch en la ruta de temporización (hacia el GM, el BC y el OC) debe tener PTP habilitado. Los dos nodos del clúster se configuran entonces de la siguiente manera.

Boundary Clock (servidor BC)

  1. Identificad el PHC de la NIC PTP (ethtool -T eno8403np1); en una sola NIC todos los puertos comparten el mismo PHC. En este ejemplo es /dev/ptp1.

  2. Cread /etc/ptp4l-G.8275.1.conf. El puerto receptor [eno8403np1] no tiene indicador de rol, por lo que el BMCA lo selecciona como receptor de tiempo (Time Receiver); [eno8503np2] y [eno8603np3] se establecen en serverOnly 1 para actuar como transmisores de tiempo (Time Transmitters). Declarar más de un puerto implica un Boundary Clock:

    Ejemplo 47.3: Configuración 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. Apunte ptp4l a este archivo en /etc/sysconfig/ptp4l:

    OPTIONS="-f /etc/ptp4l-G.8275.1.conf"
  4. Opcionalmente, alinead el reloj del sistema con phc2sys en /etc/sysconfig/phc2sys, utilizando el PHC de la NIC compartida como fuente:

    OPTIONS="-s /dev/ptp1 -w -m --uds_address /var/run/ptp4l --domainNumber 24"
  5. Habilitad e iniciad los servicios y verificad que eno8403np1 esté sincronizado con el GM. El puerto receptor pasa a SLAVE y el desfase (rms) converge a un valor bajo:

    # 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. Identificad el PHC de la interfaz PTP (ethtool -T ens6f0np0); en este ejemplo es /dev/ptp1.

  2. Cread /etc/ptp4l-G.8275.1.conf con un único puerto y clientOnly 1, de modo que el nodo solo actúe como receptor de tiempo. El localPriority más alto (250) lo mantiene por debajo del BC en el BMCA:

    Ejemplo 47.4: Configuración 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. Configurad /etc/sysconfig/ptp4l y /etc/sysconfig/phc2sys como para el BC (la fuente phc2sys es el PHC de ens6f0np0), luego habilitad e iniciad los servicios:

    # /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. Verificad que ens6f0np0 esté sincronizado con el tiempo regenerado desde el BC. El puerto pasa a SLAVE y el desfase (rms) se 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

    El OC toma su tiempo del Boundary Clock ascendente, que es su maestro inmediato. La línea selected best master clock, sin embargo, informa de la identidad del Grandmaster (d0460c.ffff.05c130, el GM) y no la del Boundary Clock: un Boundary Clock reenvía la identidad del Grandmaster sin cambios mientras anuncia su propio puerto como el padre, por lo que la cadena permanece rastreable hasta el Grandmaster. Para ver ambas identidades de forma explícita, consultad el conjunto de datos principal en el OC (ejemplo de salida):

    # 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

    Las dos identidades difieren, que es exactamente lo que debería mostrar una ampliación de Reloj de contorno:

    • parentPortIdentity (000000.fffe.001101-2) — el maestro inmediato: el puerto de transmisión del Reloj de contorno, el reloj del que el OC recibe realmente la hora.

    • grandmasterIdentity (d0460c.ffff.05c130) — la raíz del árbol de temporización: el Gran maestro, reenviado sin cambios a través del Reloj de contorno.

      Los valores gm.ClockClass, gm.ClockAccuracy y grandmasterPriority contienen la calidad anunciada del Gran maestro utilizada por el BMCA. Si las dos identidades fueran iguales, el OC se sincronizaría directamente desde un Gran maestro, sin ningún Reloj de contorno en la ruta.

Automatización CAPI

Para desplegar este escenario utilizando el flujo de trabajo de aprovisionamiento automatizado, utilizad la plantilla genérica de Cluster API descrita en Aprovisionamiento de red dirigido totalmente automatizado (Sección 55.1, “Protocolo de tiempo de precisión (PTP)”) en cada nodo, sobrescribiendo sus marcadores de posición con los valores siguientes.

Tabla 47.3: Reloj de contorno (servidor BC)
PlaceholderValor

${PTP4L_CONF_PATH}

/etc/ptp4l-G.8275.1.conf

${PTP4L_CONF_CONTENTS}

Copiad el contenido de la configuración del Reloj de contorno anterior (Ejemplo 47.3, “Configuración 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

Tabla 47.4: Reloj ordinario (servidor OC)
PlaceholderValor

${PTP4L_CONF_PATH}

/etc/ptp4l-G.8275.1.conf

${PTP4L_CONF_CONTENTS}

Copiad el contenido de la configuración del Reloj ordinario anterior (Ejemplo 47.4, “Configuración 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 Escenario 2b - Reloj de contorno (modo híbrido: PTP y SyncE) con NIC única multipuerto, incluida la propagación al servidor de Reloj ordinario. PTP y SyncE) con NIC única multipuerto, incluida la propagación al servidor de Reloj ordinario

Este escenario aún no es compatible; se incluirá en una futura versión de SUSE Telco Cloud.

47.7 Escenario 3a - Reloj de contorno (solo PTP) con varias NIC y módulo de temporización interno (DPLL basado en GNR-D)

Explicación

SUSE Telco Cloud admite una temporización precisa en una variedad de plataformas, incluidos los últimos diseños basados en Intel Granite Rapids-D (GNR-D). Estos servidores suelen incluir un controlador Ethernet de alta velocidad integrado y una o más tarjetas adicionales (AIC) 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 enruta las señales de temporización a través del sistema y las diferentes NIC internamente, por lo que ya no requiere cableado externo para mantener sincronizados todos los PHC de las NIC. Por tanto, la ampliación 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.

Este escenario amplía el Escenario 2a (Sección 47.5, “Escenario 2a - Reloj de contorno (solo PTP) con NIC única multipuerto, incluida la propagación al servidor de reloj ordinario”) a un Reloj de contorno (BC) construido sobre varias NIC, completamente basado en ITU‑T G.8275.1 (solo PTP, capa 2). Un puerto del controlador integrado recibe PTP del Gran maestro y las tarjetas adicionales regeneran PTP en sentido descendente. A diferencia del caso de una sola NIC, cada NIC tiene su propio PHC; el DPLL integrado y ts2phc los mantienen alineados, y se ejecuta una instancia de ptp4l por cada PHC.

Importante
Importante

En esta versión SUSE Telco Cloud, este escenario solo es compatible con la variante de núcleo de Linux «default» (es decir, no «PREEMPT_RT»). La compatibilidad con la variante de núcleo de Linux «RT» se añadirá en una versión posterior.

Requisitos previos
  • 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», descomprimid el archivo e instalad el ice-kmp-default-*sles16sp0.x86_64.rpm. Este RPM contiene, por ejemplo, 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

    Reiniciad el servidor para que el cambio sea persistente y efectivo.

Nota
Nota
  • Se utiliza 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. Ajustad los nombres de los dispositivos en consecuencia.

  • Se asume una ampliación de telecomunicaciones y el perfil de telecomunicaciones G.8275.1 se utiliza a lo largo de las siguientes secciones.

El escenario implica los siguientes componentes:

  • Grandmaster (GM): la referencia para el dominio PTP (dominio 24), en el sentido ascendente.

  • Switch compatible con PTP: actúa como un Reloj de contorno (T-BC) en la vía de temporización; cada puerto que transporta PTP tiene ptp enable. Los segmentos en sentido ascendente y en sentido descendente se mantienen separados en diferentes VLAN del conmutador (una VLAN dedicada para cada segmento).

  • Boundary Clock (BC server): el nodo GNR-D. Su controlador integrado recibe PTP del GM en eno8403np1 y disciplina el PHC integrado (/dev/ptp1). El DPLL integrado distribuye esa temporización a las tarjetas adicionales y ts2phc mantiene sus PHC (/dev/ptp2, /dev/ptp3) alineados con /dev/ptp1. Cada tarjeta adicional regenera PTP en el sentido descendente (por ejemplo, en eno16495np0), actuando como un transmisor de tiempo (Time Transmitter).

  • Ordinary Clock (OC server): un nodo de puerto único (ens6f0np0) en el segmento descendente, cuyo único maestro PTP es el BC.

La temporización en el BC server es gestionada por varios daemons linuxptp que trabajan conjuntamente, debido a que los PHC están físicamente separados:

  • Una instancia de ptp4l en el controlador integrado (/dev/ptp1) ejecuta el protocolo PTP en eno8403np1. El BMCA selecciona el GM como maestro, el puerto pasa a SLAVE y ptp4l disciplina /dev/ptp1.

  • El DPLL integrado está cableado de modo que el PHC integrado lo controla a través de los pines SDP, y el DPLL a su vez controla los relojes de las tarjetas adicionales. Este es el reemplazo interno para el cableado 1PPS externo utilizado en plataformas anteriores.

  • ts2phc mantiene los PHC de las tarjetas adicionales alineados con /dev/ptp1 a partir de la señal que distribuye el DPLL.

  • Una instancia ptp4l separada por tarjeta adicional (/dev/ptp2, /dev/ptp3) regenera PTP en sus puertos, todos forzados a serverOnly 1 (Time Transmitters).

  • Un Boundary Clock debe reenviar los atributos auxiliares del Grandmaster (clase de reloj, precisión, etc.) además de la hora. Esto ocurre automáticamente solo dentro de una única instancia ptp4l, por lo que se utiliza pmc para reenviar esos valores desde la instancia integrada a las instancias complementarias (véase el paso 5). pmc (cliente de gestión PTP) es la herramienta linuxptp que consulta y actualiza el estado de tiempo de ejecución de una instancia ptp4l en funcionamiento a través de su socket de gestión.

Nota
Nota

En el controlador integrado, solo uno de sus puertos es el puerto administrativo que gestiona el PHC. Inspeccionad /sys/class/ptp/ptp1/device/net/ para encontrarlo (por ejemplo, eno8703np0); es el puerto utilizado para configurar las señales DPLL, y no es necesariamente el puerto que transporta PTP (eno8403np1).

Nota
Nota

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.

Diagrama

Escenario 3a - Boundary Clock (solo PTP) de múltiples NIC con módulo de temporización interno (basado en DPLL GNR-D)
Figura 47.9: Boundary Clock (solo PTP), nodo GNR-D de múltiples NIC con DPLL integrado, con propagación a un Ordinary Clock

Configuración

Cada puerto de switch en la vía de temporización debe tener PTP habilitado. El servidor BC se inicia entonces en el orden que se indica a continuación. Cada paso de tiempo de ejecución también se asigna a una unidad systemd para que la configuración sobreviva a los reinicios y pueda automatizarse con la API de clúster (véase la automatización CAPI de GNR-D (Sección 55.1.2, “Escenarios multi-NIC GNR-D (DPLL)”)). El servidor OC se configura exactamente igual que en el Escenario 2a (Sección 47.5, “Escenario 2a - Reloj de contorno (solo PTP) con NIC única multipuerto, incluida la propagación al servidor de reloj ordinario”).

  1. Identificad los dispositivos PTP y el controlador integrado.

    1. Listad los relojes PTP y el dispositivo PCI al que está vinculado cada uno:

      # 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. Ejecutad lspci para identificar cada tipo de dispositivo, lo que os permitirá distinguir entre el controlador integrado y las tarjetas adicionales:

      # 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 referencia tiene un controlador integrado Intel E825-C (/dev/ptp1) y dos tarjetas adicionales E830-CC (/dev/ptp2, /dev/ptp3).

    3. Identificad el puerto administrativo del controlador integrado, que gestiona su PHC:

      # ls /sys/class/ptp/ptp1/device/net/
      eno8703np0
      # ethtool -i eno8703np0
      driver: ice
      version: 2.4.5
      [...]
  2. Configurad las señales de temporización internas (DPLL).

    Conectad el PHC integrado a la DPLL y dejad que la DPLL alimente las tarjetas adicionales, utilizando el puerto administrativo que se encuentra arriba (eno8703np0) y los índices ptpN correctos.

    Ejemplo 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

    Estos ajustes se pierden al reiniciar, por lo que ejecutad el script en el arranque desde una unidad systemd de tipo oneshot, ordenada antes de ts2phc y 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. Alinead los PHC de las tarjetas adicionales con ts2phc.

    ts2phc («marca de tiempo a PHC») alinea los PHC de las tarjetas adicionales con un reloj de referencia. Aquí, la referencia es el PHC de la NIC integrada (/dev/ptp1, ya disciplinado por el GM a través de su instancia ptp4l), pasado en la línea de comandos con -s /dev/ptp1. La DPLL integrada entrega el 1PPS derivado de esa referencia a cada tarjeta adicional en su pin SDP1; ts2phc registra las marcas de tiempo de esos pulsos de entrada (EXTTS) y ajusta cada PHC adicional en consecuencia, de modo que todos los PHC del nodo terminan compartiendo la misma hora.

    Nota
    Nota

    La alineación de los PHC adicionales requiere dos ajustes complementarios, a diferentes niveles.

    • Hardware: el pin de entrada SDP1 de cada PHC adicional debe estar habilitado para que la DPLL integrada le entregue el pulso 1PPS. Esto se realiza en el script de configuración de la DPLL del paso anterior (echo 1 1 > /sys/class/ptp/ptpN/pins/SDP1).

    • Software: se debe indicar a ts2phc que registre la marca de tiempo de esa entrada y ajuste el PHC. Esto es lo que hace la configuración siguiente (ts2phc.channel, ts2phc.pin_index, ts2phc.extts_polarity).

    Sin habilitar el pin, el pulso nunca llega al PHC; sin la configuración ts2phc, el pulso nunca se le aplica. Ambos son necesarios.

    Cread el archivo de configuración:

    Ejemplo 47.6: /etc/ts2phc-cf-all.cfg — Archivo de configuración de 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 tarjeta adicional se configura a través de una sección nombrada según su primer puerto ([eno16495np0], [eno16595np0]), que identifica el PHC que se debe disciplinar. Los parámetros asignan el pulso de la DPLL a esa tarjeta:

    • ts2phc.pin_index y ts2phc.channel: el pin y el canal donde la DPLL entrega el 1PPS (SDP1 en esta configuración, por tanto pin_index 1).

    • ts2phc.extts_polarity: el flanco del pulso que se debe registrar (rising).

    • ts2phc.pulsewidth: la anchura de pulso de entrada esperada, en nanosegundos (100 ms en este caso).

      Ejecutadlo manualmente como ts2phc -f /etc/ts2phc-cf-all.cfg -s /dev/ptp1 -m, o dejad que systemd lo gestione a través de /etc/sysconfig/ts2phc:

      # /etc/sysconfig/ts2phc
      OPTIONS="-f /etc/ts2phc-cf-all.cfg -s /dev/ptp1 -m"
  4. Ejecutad una instancia ptp4l por PHC.

    El controlador integrado ejecuta una instancia impulsada por BMCA (el receptor), y cada tarjeta adicional ejecuta una instancia con todos los puertos forzados a serverOnly 1. Cada instancia debe utilizar un socket de control y de solo lectura diferente. Cread los tres archivos de configuración:

    Ejemplo 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]

    La instancia integrada declara solo eno8403np1, el puerto que recibe PTP del GM, y no establece ningún serverOnly o clientOnly en él: depende del BMCA para asignar el rol. Con un GM alcanzable en eno8403np1, el BMCA lo selecciona como receptor de tiempo (SLAVE) y disciplina /dev/ptp1. Los otros puertos del controlador integrado no se declaran, porque en este nodo la regeneración descendente la realizan las tarjetas adicionales en lugar del controlador integrado. Las tarjetas adicionales, por el contrario, fuerzan serverOnly 1 porque deben ser siempre transmisores de tiempo: toman su tiempo del DPLL y de ts2phc, no mediante la recepción de PTP, por lo que nunca deben ser elegidas como receptoras. Si se necesita un control más estricto, añadid explícitamente el parámetro serverOnly o clientOnly bajo la interfaz.

    Los valores de G.8275.portDS.localPriority y G.8275.defaultDS.localPriority (128 en la instancia integrada, 250 en las tarjetas complementarias) actúan como un desempate BMCA G.8275.x: solo se comparan después de clockClass, clockAccuracy, la varianza y priority2, y se prefiere un valor más bajo. Mantener el 128 predeterminado en la instancia integrada hace que supere a las instancias complementarias (250), lo que mantiene determinista el orden de transmisor de tiempo/receptor de tiempo dentro del nodo y determina qué puerto elige el BMCA, tal como se refleja en los estados de puerto notificados por ptp4l.

    Ejemplo 47.8: /etc/ptp4l-aic1.conf — tarjeta complementaria 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
    Ejemplo 47.9: /etc/ptp4l-aic2.conf — tarjeta complementaria 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 en Escenario 2a (Sección 47.5, “Escenario 2a - Reloj de contorno (solo PTP) con NIC única multipuerto, incluida la propagación al servidor de reloj ordinario”), cada nodo en la vía de temporización utiliza la misma dirección MAC de multidifusión G.8275.1 no reenviable 01:80:C2:00:00:0E, incluido el OC en sentido descendente.

    Gestione las instancias con una unidad systemd basada en plantilla que lea /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 las tres instancias:

    # systemctl enable --now ptp4l@nac ptp4l@aic1 ptp4l@aic2
  5. Reenvíe los parámetros del Grandmaster a través de las instancias ptp4l.

    Un Boundary Clock debe reenviar no solo la hora, sino también los parámetros adicionales del Grandmaster (clase de reloj, precisión, desfase UTC, etcétera). Esto sucede automáticamente entre puertos de la misma instancia ptp4l, pero no entre las instancias separadas que gestionan diferentes PHCs. Los valores se aplican en tiempo de ejecución con pmc sobre el socket UDS de cada instancia (SET GRANDMASTER_SETTINGS_NP).

    Importante
    Importante

    Los valores aplicados con pmc se mantienen únicamente en el proceso ptp4l en ejecución; no se escriben en el archivo .conf y no sobreviven a un reinicio. Si se reinicia una instancia ptp4l, vuelve a los valores por defecto del archivo y los valores deben reenviarse nuevamente. Automatice el reenvío (véase más abajo) en lugar de ejecutarlo una vez manualmente.

    Una vez que el controlador integrado esté bloqueado al GM, consulte los valores del Grandmaster. El asistente a continuación recibe como argumento el archivo de configuración de la instancia a consultar:

    Ejemplo 47.10: get_pmc_values.sh — consulte los valores del Grandmaster de una instancia 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'

    A continuación, reenvíe esos valores a las instancias complementarias. El siguiente guion lee los valores de la instancia integrada y los aplica a cada instancia complementaria. Edite la sección «Variables de entrada» para que coincida con los nombres de archivo de configuración y ejecútelo una vez que el sistema esté sincronizado con un GM:

    Ejemplo 47.11: 04-ptp-forward-GM.sh — reenvíe los valores del Grandmaster a las instancias complementarias
    #!/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

    Dado que los valores no son persistentes, ejecute este guion desde un agente temporizador systemd para que se actualicen periódicamente y después de cualquier reinicio de la instancia:

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

    El efecto es visible consultando una instancia complementaria ptp4l en el BC: antes del reenvío, el nodo anuncia sus valores predeterminados de archivo; después de que comienza el reenvío, anuncia los valores reales del Grandmaster (que luego se propagan al OC en sentido descendente). Por ejemplo, cambios en 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 el reloj del sistema desde PTP con phc2sys, utilizando el PHC integrado como fuente (/etc/sysconfig/phc2sys):

    OPTIONS="-f /etc/ptp4l-nac.conf -s /dev/ptp1 -c CLOCK_REALTIME -w"

Automatización CAPI

Para desplegar este escenario con el flujo de trabajo de aprovisionamiento automatizado, utilice la plantilla de Cluster API específica para GNR-D descrita en Aprovisionamiento de red dirigida totalmente automatizado — escenarios GNR-D (Sección 55.1.2, “Escenarios multi-NIC GNR-D (DPLL)”). A diferencia de los escenarios estándar, despliega varias instancias de ptp4l, el servicio ts2phc, la configuración de arranque del DPLL y el agente temporizador de reenvío del Grandmaster, por lo que requiere los archivos de configuración adicionales y las unidades systemd enumeradas anteriormente. Sobrescriba sus marcadores de posición con los valores siguientes.

Tabla 47.5: Reloj de frontera GNR-D
PlaceholderValor

${GNRD_DPLL_SETUP_CONTENTS}

Copie el contenido de 01-gnrd-startup-setup.sh (Ejemplo 47.5, “01-gnrd-startup-setup.sh”).

${GNRD_FORWARD_GM_CONTENTS}

Copie el contenido de 04-ptp-forward-GM.sh (Ejemplo 47.11, “04-ptp-forward-GM.sh — reenvíe los valores del Grandmaster a las instancias complementarias”).

${TS2PHC_CONF_CONTENTS}

Copie el contenido de /etc/ts2phc-cf-all.cfg (Ejemplo 47.6, “/etc/ts2phc-cf-all.cfg — Archivo de configuración de ts2phc”).

${TS2PHC_OPTIONS}

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

${PTP4L_NAC_CONTENTS}

Copie el contenido de /etc/ptp4l-nac.conf (Ejemplo 47.7, “/etc/ptp4l-nac.conf — controlador integrado (/dev/ptp1)”).

${PTP4L_AIC1_CONTENTS}

Copie el contenido de /etc/ptp4l-aic1.conf (Ejemplo 47.8, “/etc/ptp4l-aic1.conf — tarjeta complementaria 1 (/dev/ptp2)”).

${PTP4L_AIC2_CONTENTS}

Copie el contenido de /etc/ptp4l-aic2.conf (Ejemplo 47.9, “/etc/ptp4l-aic2.conf — tarjeta complementaria 2 (/dev/ptp3)”).

47.8 Escenario 3b - Reloj de frontera (modo híbrido: PTP y SyncE) Multi-NIC con módulo de temporización interno (basado en DPLL GNR-D)

Este escenario aún no es compatible; se incluirá en una futura versión de SUSE Telco Cloud.