|Index|SUSE Telco Cloud ドキュメント|Telco機能の設定|高精度時刻同期プロトコル (PTP)
適用項目 SUSE Telco Cloud 3.7

47 高精度時刻同期プロトコル (PTP)

47.1 概要

IEEE 1588標準で定義されている高精度時刻同期プロトコル (PTP) は、パケットネットワーク上で高精度の時刻を配信します。ネットワークインタフェース (NIC) がハードウェアでPTPパケットにタイムスタンプを付与すると、NTPが提供できる範囲をはるかに超えるサブマイクロ秒の精度に達します。通信事業者の環境において、PTPは5G無線アクセスネットワーク (RAN) の中核となる構成要素であり、無線ユニットが正しく送信を行うには厳密な位相と時刻の同期が必要です。SUSE Telco Cloudは、`linuxptp`パッケージを通じてPTPを実装しており、以下に説明する通信事業者向けプロファイルITU-T G.8275.1およびITU-T G.8275.2を対象としています。

PTPドメインは、少数のクロック役割で構成されます。

  • グランドマスター (GM): ドメインの主要な時刻源です。通常、GNSS受信機によって駆動されるプライマリリファレンスタイムクロック (PRTC) に同期し、下流のノードに時刻を送信します。GMの精度が、ドメイン全体の品質上限を決定します。

  • オーディナリークロック (OC): 単一のPTPポートを持つエンドノードです。通信事業者のデプロイメントでは、タイムレシーバーとして機能し、上流のグランドマスターまたはバウンダリークロックからローカルクロックを調整します。無線ワークロードを実行するコンピュートノードは、典型的なOCです。

  • バウンダリークロック (BC): 1つのポートで時刻を受信し (タイムレシーバー)、残りのポートで他のノードに向けて時刻を再生成する (タイムトランスミッター) マルチポートノードです。パス上にバウンダリークロックを挿入することで、各OCとリファレンス間のチェーンが短縮され、ネットワークでホップごとに蓄積される誤差が制限されます。

トポロジーを設計する際、オーディナリークロックとバウンダリークロックの区別が重要になります。

  • *オーディナリークロック (OC)*は、*単一*のPTPポートを持ち、ドメインの端に配置されます。 自身のクロックを制御するためにのみ時刻を消費し、他のノードに時刻を転送することはありません。

  • *バウンダリークロック (BC)*は、*複数*のPTPポートを持ちます。Time Receiverポートで時刻を消費し、Time Transmitterポートでそれを*再生成*することで、アップストリームのタイミングチェーンを終端し、ダウンストリームで新しいタイミングチェーンを開始します。この再生成により、長いノードチェーン全体で誤差が蓄積されるのを防ぎます。

以下のハードウェアおよびシグナリング要素がこれらの役割をサポートします。

  • PTP Hardware Clock (PHC):PTPが実際に同期を行う、NICに組み込まれたクロックです。オペレーティングシステムのクロックをPHCに合わせることは、専用のデーモンによって処理される別のステップです。

  • Synchronous Ethernet (SyncE):物理層の周波数同期です。PTPはパケット内で位相と時刻を伝送しますが、SyncEはイーサネット信号から直接安定した周波数を復元します。SyncEは*オプションの拡張機能*です。PTP単体でもすでに位相と時刻を提供しており、SyncEは、ノードがより強力な周波数安定性を必要とする場合や、PTP時刻ソースが一時的に失われた場合に備えてより長いホールドオーバーが必要な場合に追加されます。

  • Digital Phase-Locked Loop (DPLL):基準信号に同期し、それをフィルタリングして安定したクリーンなクロックを出力するハードウェアタイミングブロックです。これは、利用可能な入力からPHCを制御し、複数のNICを持つプラットフォームでは、異なるNICクロックを調整する役割を果たします。

各ノードにおいて、これらの機能は`linuxptp`デーモンによって実行されます。`ptp4l`はPTPプロトコルを実行してPHCを制御し、`phc2sys`はシステムクロックをPHCに合わせます。グランドマスターでは、`ts2phc`がさらにGNSS基準からPHCを制御します。それらの役割とインストールについては47.2項 「前提条件」で説明されています。

ハードウェアクロック自体は、LinuxカーネルのDPLLサブシステムとネットワークドライバによって処理されます。タイミング制御の度合い、およびマルチNICノード内でのタイミングの分散方法は、管理可能なDPLLがどこに配置されているかによって異なります。

  • NIC with an integrated DPLL:DPLLはNICに組み込まれており、Linux DPLLサブシステムを通じて構成されます。選択されたリファレンスにロックし、PHCを制御することで、周波数とホールドオーバーを完全に管理します。

  • 統合DPLLのないNIC:NICは構成可能なDPLLを備えておらず、`ptp4l`はPHCを直接制御します。サブシステムはロックステータスを(読み取り専用で)報告するにとどまり、高度な周波数処理は外部のタイミングソースに依存します。

  • 複数のNIC間で共有されるオンボードDPLL:DPLLは単一のNICに組み込まれているのではなく、NICの外部にあるプラットフォーム上に配置されています。これは、共通のリファレンスから複数のNICのPHCを制御して同期を維持するため、ノード内のすべてのNICが同じ時刻を共有します。この構成は、外部ケーブルに頼らずに内部でタイミングを配信するマルチNICプラットフォームで使用されます。

管理可能なDPLLを統合したNICを持つノード
図 47.1: 管理可能なDPLLを統合したNICを持つノード上のPTPソフトウェア
管理可能なDPLLを持たないNICを持つノード
図 47.2: 管理可能なDPLLを持たないNICを持つノード上のPTPソフトウェア
NIC間で共有されるオンボードDPLLを備えたノード
図 47.3: NIC間で共有されるオンボードDPLLを備えたノード上のPTPソフトウェア

通信事業者ネットワークは2つのITU-Tプロファイルを標準としており、これらは主に、使用されるトランスポートと、基盤となるネットワークのどれだけがPTP対応である必要があるかという点で異なります。

  • ITU-T G.8275.1(フルタイミングサポート):マルチキャストを使用してイーサネット(レイヤー2)上で直接実行されます。パス上のすべてのノードはPTPに対応し、<em>バウンダリークロック</em>として機能する必要があり、これにより最高の精度が得られます。特に明記されていない限り、このガイドのシナリオではこのプロファイルを使用します。

  • ITU-T G.8275.2(部分的なタイミングサポート):ユニキャストを使用してIP(レイヤー3)上で実行されます。 中間ノードはPTPをサポートする必要がないため、タイミングはタイミング非対応のネットワークセグメントを通過できますが、その代償として精度が低下します。

以下の図は、PTPのみの場合と、オプションの周波数拡張としてSyncEを追加した場合の時刻配信を示しています。どちらの場合も、グランドマスターはPRTC/GNSSソースからリファレンスを取得し、バウンダリクロックはエンドポイントに向けてタイミングを再生成します。

グランドマスターによるPTP専用配信
図 47.4: PTPのみによる時刻配信
グランドマスターによるPTPおよびSyncE配信
図 47.5: PTPおよびSyncEによる時刻と周波数の配信(オプションの拡張機能)

本ガイドでは、以下のシナリオについて説明します。各シナリオには、そのCluster API(CAPI)自動化へのリンクが含まれています。

注記
注記

シナリオ1a (47.3項 「シナリオ1a - オーディナリークロック(PTPのみ)」)のみが、ITU-T G.8275.1およびITU-T G.8275.2の両方の通信事業者固有のプロファイルの構成を示しています。残りのシナリオは、簡潔にするためITU-T G.8275.1のケースのみに焦点を当てています。展開は同一であり、2つのプロファイル間で変更されるのは`ptp4l`設定ファイルのみです。

47.2 前提条件

本ガイドでは通信事業者固有のプロファイルのみを扱うため、ハードウェアタイムスタンプおよびNIC内のPTPハードウェアクロック(PHC)が前提となります。通信事業者グレードのNICはハードウェアでPTPをサポートしています。特定のインターフェースの機能は、`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

hardware-transmit、hardware-receive、hardware-raw-clock`の機能と、0以上の`PTP Hardware Clock`インデックスを確認してください(-1`という値は、インターフェースにPHCがないことを意味します)。`eno16495np0`を、PTPに使用する予定のインターフェースに置き換えてください。

PTPは、linuxptp`パッケージによって提供されます。これには、`systemd`によって管理される長時間実行デーモンとして実行される3つのユーザスペースプログラム(`ptp4l、phc2sys、ts2phc)が含まれています(それぞれ専用のサービス:ptp4l.service、phc2sys.service、ts2phc.service)。これらは集合的にプロトコルを実行し、クロックを同期させ続けます。

  • ptp4l: PTPデーモン。これは、構成されたインターフェース上でIEEE 1588プロトコルを実行し、Best Master Clock Algorithm (BMCA) を適用して各ポートの役割を決定し、NICのPHCを調整します。単一の ptp4l インスタンスは複数のポートを管理でき、これによってノードがバウンダリクロックとして機能できるようになります。

  • phc2sys: 2つのクロックを同期させます。これは通常、システム(オペレーティングシステム)クロックを ptp4l が同期し続けるPHCに合わせるために使用され、システム時刻もPTPに従うようにします。

  • ts2phc: 「PHCへのタイムスタンプ」。これは、GNSS受信機によって配信されるPPSなどの外部時刻信号からPHCを調整します。これは、グランドマスターで使用され、同じノード内の複数のPHCを同期させるために使用されます。

ダウンストリームクラスターにPTPをインストールする推奨される方法は、Edge Image Builder (EIB) 定義ファイルの packageList に linuxptp パッケージを追加し、プロビジョニング中に自動的にデプロイされるようにすることです。パッケージのインストールに関する詳細については、EIB documentation (5.3.6項 「RPMパッケージの設定」) を参照してください。

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
注記
注記

linuxptp`パッケージは、デフォルトでは `ptp4l、phc2sys、または ts2phc を有効にしません。 設定ファイルをデプロイした後、マニフェストの systemd セクションを使用して、必要なノードデーモンを有効にします(以下のシナリオを参照してください)。

最後に、使用するPTPプロファイルによって、ノード間のネットワークスイッチをPTP対応デバイスとして構成する必要があるかどうかが決まります。

  • ITU-T G.8275.1 (full timing support): マルチキャストを使用してイーサネット(レイヤー2)上で直接実行されます。パス上のすべてのノードはPTP対応であり、バウンダリクロックとして機能する必要があります。これにより最高の精度が得られます。したがって、介在するスイッチはPTP用に構成する必要があります。特に明記されていない限り、このガイドのシナリオではこのプロファイルを使用します。

  • ITU-T G.8275.2 (partial timing support): ユニキャストを使用してIP(レイヤー3)上で実行されます。 中間ノードはPTPをサポートする必要がないため、タイミングはタイミング非対応のネットワーク セグメントを通過でき、スイッチにPTP設定は不要ですが、その代償として精度が低下します。

47.3 シナリオ1a - オーディナリークロック(PTPのみ)

説明

これは最も単純なPTPデプロイメントです。単一のクラスタノードがアップストリームソースから時刻を取得し、ローカルクロックを調整しますが、別のノードに時刻を転送することはありません。このノードは、タイムレシーバーの役割を持つ単一のPTPポートを備えたオーディナリークロック(OC)として動作します。

OCノードでは、使用するプロファイルに関係なく、タイミングはすべて`linuxptp`デーモンによって処理されます。ノードは単一のNICを使用し、`ptp4l`が直接PHCを調整するため、DPLL設定や`ts2phc`は不要です。

  • `ptp4l`は受信インターフェース上でPTPプロトコルを実行します。ベストマスタークロックアルゴリズム(BMCA)がアップストリームノードをマスターとして選択し、ローカルポートが`SLAVE`状態に遷移し、`ptp4l`がNICのPTPハードウェアクロック(PHC)を調整します。 `clientOnly 1`を設定すると、ノードはタイムレシーバーの役割に制限されるため、マスターとして選択されることはありません。

  • phc2sys`はシステムクロック(`CLOCK_REALTIME)を`ptp4l`が同期を維持するPHCに合わせるため、オペレーティングシステムの時刻もPTPに従います。

このシナリオはどちらかの通信事業者向けプロファイルで実装可能です。これらはトランスポート や介在するネットワークが提供すべき内容が異なり、以下に2つの独立したモデルとして文書化されています。

重要
重要

オーディナリークロックは、一度に1つのPTPプロファイルのみを実行します。これら2つのモデルは相互排他的です。特定のノードには、どちらか一方のみを設定してください。選択したプロファイルの設定ファイルのみを作成し、/etc/sysconfig/ptp4l`ではそのファイルのみを参照してください。/etc/ptp4l-G.8275.1.conf`と`/etc/ptp4l-G.8275.2.conf`の両方を作成しないでください。また、`OPTIONS=`行に両方のファイルを渡さないでください。

モデル1 — ITU-T G.8275.1(レイヤー2マルチキャスト)

G.8275.1はイーサネット上で直接実行され、そのメッセージを転送不可能なマルチキャストMAC `01:80:C2:00:00:0E`に送信します。標準的なブリッジはこれを転送しないため、パス上のすべてのデバイスがPTPを終端および再生成する必要があります。コンポーネントは以下の通りです。

  • Grandmaster (GM): PTPドメイン(G.8275.1の場合はドメイン 24)のアップストリームリファレンスで、通常はGNSS/PRTCソースにロックされています。

  • PTP-aware switch: Boundary Clockとして機能します。GMに向かうポートはTime Receiverであり、OCに向かうポートはTime Transmitterです。両方のポートでPTPを有効にする必要があります。

  • Ordinary Clock (OC): クラスターノードであり、単一のPTPポートで時刻を受信します。

シナリオ1a - G.8275.1を使用したオーディナリークロック(PTPのみ)
図 47.6: Ordinary Clock (OC) — G.8275.1 (レイヤー2マルチキャスト)

ノードを以下のように設定します。

  1. PTPに使用するインターフェースのPHCインデックス <N>(ここでは eno8403np1)を特定します。出力されたフィールド PTP Hardware Clock(Hardware timestamp provider index`と表示される場合もあります)の値は、/dev/ptp<N>`デバイスを示し、`ptp4l`がこれを調整し、`phc2sys`がソースとして読み取るものです。

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

    この例では、eno8403np1`のPHCは `/dev/ptp1 です。

  2. ptp4l`設定ファイル/etc/ptp4l-G.8275.1.conf`を作成します。インターフェースはセクション([eno8403np1])として宣言されるため、デーモンに`-i`フラグは不要です。

    例 47.1: オーディナリークロック設定 — 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]

    `ptp_dst_mac`の値はG.8275.1で固定されています。これは、PTPを単一のリンクに限定する転送不可能なマルチキャストアドレス`01:80:C2:00:00:0E`であり、これがパス上のすべてのデバイスがPTP対応でなければならない理由です。`uds_address`は、`phc2sys`がポート状態を追跡するために使用する管理ソケットを公開します。

  3. ptp4l`で/etc/sysconfig/ptp4l`がこのファイルを指すようにします。

    OPTIONS="-f /etc/ptp4l-G.8275.1.conf"
  4. /etc/sysconfig/phc2sys`で`phc2sys`を設定し、PTPインターフェース(/dev/ptp1`)のPHCからシステムクロックを制御します。--uds_address`と--domainNumber`の値は、`ptp4l`の設定と一致している必要があります。

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

    -s /dev/ptp1`はPHCをソースクロックとして選択し、-w`は`ptp4l`が同期するのを待ってからシステムクロックをステップし、`-m`はサーボステータスをログに出力します。

  5. 両方のサービスを有効にして開始します。

    # systemctl enable --now ptp4l phc2sys
  6. ptp4l`がアップストリームマスターにロックされていることを確認します。ポートは`SLAVE`に移行し、報告されたオフセット(`rms)は低く安定した値に収束します。

    # 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. phc2sys`がシステムクロックを制御していることを確認します。サーボ状態は`s0(ロック解除)から`s1`(初期ステップ)、そして`s2`(ロック)へと進み、オフセットはゼロ付近で安定します。

    # 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

    小さなオフセットを伴う安定した`s2`状態は、ノードがロックされ、システムクロックがPTPに従っていることを確認するものです。

モデル2 — ITU-T G.8275.2(レイヤー3ユニキャスト)

G.8275.2はユニキャストを使用してIP(レイヤー3)上で実行されます。OCはマスターのIPアドレスと直接メッセージを交換するため、介在するネットワークがPTP対応である必要はなく、PTP対応スイッチも不要です。コンポーネントは以下の通りです。

  • マスター(GMまたは境界クロック):G.8275.2ドメイン(ドメイン`44`)上でIP経由で到達可能なアップストリームマスターです。

  • IPネットワーク:標準的なルーティングまたはスイッチングネットワークです。PTP設定なしでユニキャストPTPパケットを転送します。

  • オーディナリークロック(OC):クラスターノードであり、単一のPTPポートからマスターへユニキャストリクエストを送信します。

シナリオ1a - G.8275.2を使用したオーディナリークロック(PTPのみ)
図 47.7: オーディナリークロック(OC) — G.8275.2(レイヤー3ユニキャスト)

ノードを以下のように設定します。

  1. モデル1(ethtool -T eno8403np1)と同様にPTPインターフェースのPHCを特定します。この例では、eno8403np1`のPHCは/dev/ptp1`です。

  2. ptp4l`設定ファイル/etc/ptp4l-G.8275.2.conf`を作成します。マスターには`ptp_dst_mac`経由のIPで到達するため、`unicast_master_table`は存在しません。 `$MASTER_IP_ADDRESS`をアップストリームマスターのIPアドレスに置き換えます。

    例 47.2: オーディナリークロック設定 — 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. `/etc/sysconfig/ptp4l`で`ptp4l`をこのファイルを指すように設定します。

    OPTIONS="-f /etc/ptp4l-G.8275.2.conf"
  4. G.8275.2ドメイン番号(44)を使用して`/etc/sysconfig/phc2sys`の`phc2sys`を設定します。ソースPHCと`--uds_address`は変更されません。

    OPTIONS="-s /dev/ptp1 -w -m --uds_address /var/run/ptp4l --domainNumber 44"
  5. 両方のサービスを有効にして開始します。

    # systemctl enable --now ptp4l phc2sys
  6. モデル1と同様に同期を確認します。ptp4l`はポートを`SLAVE(journalctl -u ptp4l)に移動し、phc2sys`は`s2(ロック)状態に達し、オフセットはゼロに近い(journalctl -u phc2sys)です。

CAPI自動化

自動プロビジョニングワークフローを使用してこのシナリオを展開するには、完全に自動化されたダイレクトネットワークプロビジョニング (55.1項 「高精度時刻同期プロトコル (PTP)」)で説明されている汎用Cluster APIテンプレートを使用し、そのプレースホルダーを以下に示すこのシナリオの値で上書きします。

表 47.1: モデル1 — ITU-T G.8275.1
Placeholder値

${PTP4L_CONF_PATH}

/etc/ptp4l-G.8275.1.conf

${PTP4L_CONF_CONTENTS}

上記のG.8275.1設定 (例47.1「オーディナリークロック設定 — 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

表 47.2: モデル2 — ITU-T G.8275.2
Placeholder値

${PTP4L_CONF_PATH}

/etc/ptp4l-G.8275.2.conf

${PTP4L_CONF_CONTENTS}

上記のG.8275.2設定 (例47.2「オーディナリークロック設定 — 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 シナリオ1b - オーディナリクロック (ハイブリッドモード:PTPおよびSyncE)

このシナリオはまだサポートされていません。将来のSUSE Telco Cloudリリースで含まれる予定です。

47.5 シナリオ2a - バウンダリクロック (PTPのみ)、マルチポートシングルNICを使用し、オーディナリクロックサーバーへの伝搬を含む

説明

このシナリオでは、ITU-T G.8275.1 (PTPのみ、レイヤー2) を介して、ダウンストリームのオーディナリクロック(OC) に向けてPTPを再生成するバウンダリクロック(BC)を用いてタイミングチェーンを拡張します。BCは単一のマルチポートNICを使用します。1つの`ptp4l`インスタンスが同じNIC上の複数のポートを管理するため、`ts2phc`もDPLLルーティングも必要ありません (マルチNICシナリオとは異なります)。

このシナリオには、以下のコンポーネントが含まれます。

  • グランドマスター (GM): PTPドメイン (ドメイン`24`) のリファレンスであり、通常はGNSS/PRTCソースにロックされています (ここで使用するテストベンチにはGNSSがないため、後述する`gm.ClockClass`の劣化が生じます)。アップストリームセグメントに時刻を送信します。

  • PTP対応スイッチ: タイミングパス上でバウンダリクロック (T-BC) として機能します。PTPを伝送するすべてのポートには`ptp enable`が設定されています。

  • バウンダリクロック (BCサーバー): 2つのPTPセグメントをブリッジする、単一NIC上のマルチポートノードです。その`eno8403np1`ポートはタイムレシーバー (SLAVE) として*アップストリーム*セグメントに向き、NICのPHCを制御します。eno8503np2 (および`eno8603np3`) はタイムトランスミッターとして*ダウンストリーム*セグメントに向き、PTPを再生成します。BCはアップストリームのタイミングチェーンを終端し、ダウンストリーム側で新しいタイミングチェーンを開始します。

  • オーディナリークロック(OCサーバー):*ダウンストリーム*セグメント上にあるシングルポートノード(ens6f0np0)であり、その唯一のPTPマスターはBCです。BCが再生成した時点からローカルクロックを調整します。

タイミングは、各ノードの`linuxptp`デーモンによって処理されます。

  • *BCサーバー*では、単一の`ptp4l`インスタンスがすべてのポートを管理します。BMCAは`eno8403np1`上でGMをマスターとして選択し、それが`SLAVE`に移行してPHCを調整します。`eno8503np2`と`eno8603np3`は`serverOnly 1`に強制されるため、タイムトランスミッターとしてのみ機能します。 すべてのポートが同じNIC PHCを共有しているため、受信した時刻は送信ポートですぐに利用可能です。ポートが複数構成されている場合はバウンダリクロックが自動的に暗示されるため、`clock_type`や`ts2phc`の設定は不要です。

  • *OCサーバー*では、`ptp4l`が`clientOnly 1`上の`ens6f0np0`で実行されるため、ポートは常にタイムレシーバーとしてのみ機能します。`phc2sys`はシステムクロックをPHCに合わせます。

  • OCサーバーにおいて、`clientOnly 1`はそれがマスターになることを決して許さないための保証となります。`localPriority`属性(G.8275.x BMCAにおいて、clockClass、clockAccuracy、variance、priority2が等しい場合のタイブレーカーとしてのみ使用され、値が小さい方が優先される)は、この順序付けを強化します。BCサーバーはデフォルトの`128`を維持し、OCサーバーは優先度の低い`250`を使用します。

BCは、GMと`eno8403np1`ポート間の*アップストリーム*セグメントと、`eno8503np2`ポートとOC間の*ダウンストリーム*セグメントという、2つの独立したPTPセグメントをブリッジします。これらは、例えばスイッチの異なるVLAN上や別々のネットワーク上で、分離された状態に保たれます。BCはダウンストリームセグメントにおける唯一のマスターであるため、OCはBCから同期し、GMから直接同期することはありません。

シナリオ1a (47.3項 「シナリオ1a - オーディナリークロック(PTPのみ)」)と同様に、このシナリオでは転送不可能なマルチキャストMAC`01:80:C2:00:00:0E`を使用します。標準的なブリッジはこれを転送しないため、すべてのPTP対応デバイスがPTPを終端および再生成します。タイミングパスのすべてのノードで同じアドレスを設定する必要があります。

図

シナリオ2a - バウンダリクロック(PTPのみ)、マルチポートシングルNIC、オーディナリークロックサーバーへの伝搬を含む
図 47.8: バウンダリクロック(PTPのみ)、シングルNIC、オーディナリークロックへの伝搬あり

設定

タイミングパス上のすべてのスイッチポート(GM、BC、OCに向かうポート)でPTPを有効にする必要があります。2つのクラスターノードは、次のように構成されます。

バウンダリクロック(BCサーバー)

  1. PTP NICのPHC (ethtool -T eno8403np1) を特定します。単一のNICでは、すべてのポートが同じPHCを共有します。この例では、`/dev/ptp1`です。

  2. /etc/ptp4l-G.8275.1.conf`を作成します。受信ポート[eno8403np1]にはロールフラグがないため、BMCAはそれをTime Receiverとして選択します。[eno8503np2]と[eno8603np3]`は、Time Transmitterとして機能するように`serverOnly 1`に設定されます。複数のポートを宣言すると、Boundary Clockであることを意味します。

    例 47.3: バウンダリクロックの設定
    # 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. ptp4l`で/etc/sysconfig/ptp4l`をこのファイルを指すように設定します。

    OPTIONS="-f /etc/ptp4l-G.8275.1.conf"
  4. オプションとして、共有NIC PHCをソースとして使用し、`/etc/sysconfig/phc2sys`内の`phc2sys`とシステムクロックを同期させます。

    OPTIONS="-s /dev/ptp1 -w -m --uds_address /var/run/ptp4l --domainNumber 24"
  5. サービスを有効にして開始し、eno8403np1`がGMにロックされていることを確認します。受信ポートは`SLAVE`に移行し、オフセット (`rms) は低い値に収束します。

    # 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 (OCサーバー)

  1. PTPインターフェースのPHC (ethtool -T ens6f0np0) を特定します。この例では、`/dev/ptp1`です。

  2. 単一ポートと`clientOnly 1`を持つ`/etc/ptp4l-G.8275.1.conf`を作成します。これにより、ノードは常にTime Receiverとしてのみ機能します。より高い`localPriority` (250) により、BMCAにおいてBCの下位に維持されます。

    例 47.4: 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. BCの場合と同様に`/etc/sysconfig/ptp4l`と`/etc/sysconfig/phc2sys`を設定し (`phc2sys`ソースは`ens6f0np0`のPHC)、サービスを有効にして開始します。

    # /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. ens6f0np0`がBCから再生成された時刻にロックされていることを確認します。ポートは`SLAVE`に移行し、オフセット (`rms) は安定します。

    # 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

    OCは、直近のマスターであるアップストリームの境界クロックから時刻を取得します。 ただし、selected best master clock`行はBoundary Clockの識別子ではなく、*Grandmaster*の識別子 (`d0460c.ffff.05c130、GM) を報告します。Boundary ClockはGrandmasterの識別子を変更せずに転送し、自身のポートを親としてアドバタイズするため、チェーンはGrandmasterまで追跡可能です。両方の識別子を明示的に確認するには、OCで親データセットを照会します (出力例):

    # 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

    2つの識別子は異なりますが、これはまさに境界クロック・デプロイメントが示すべきものです。

    • parentPortIdentity (000000.fffe.001101-2) — 直接のマスター:境界クロックの送信ポートであり、OCが実際に時刻を受信するクロックです。

    • grandmasterIdentity (d0460c.ffff.05c130) — タイミングツリーのルート:グランドマスターであり、境界クロックを介して変更されずに転送されます。

      gm.ClockClass、gm.ClockAccuracy、および`grandmasterPriority`の値は、BMCAによって使用されるグランドマスターのアドバタイズされた品質を示しています。もし2つの識別子が等しい場合、OCはパス上に境界クロックが存在せず、グランドマスターから直接同期することになります。

CAPI自動化

自動プロビジョニングワークフローを使用してこのシナリオを展開するには、各ノードで完全に自動化されたダイレクトネットワークプロビジョニング (55.1項 「高精度時刻同期プロトコル (PTP)」)に記載されている汎用Cluster APIテンプレートを使用し、そのプレースホルダーを以下の値で上書きしてください。

表 47.3: 境界クロック(BCサーバー)
Placeholder値

${PTP4L_CONF_PATH}

/etc/ptp4l-G.8275.1.conf

${PTP4L_CONF_CONTENTS}

上記の境界クロック設定 (例47.3「バウンダリクロックの設定」)から内容をコピーしてください。

${PTP4L_OPTIONS}

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

${PHC2SYS_OPTIONS}

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

表 47.4: Ordinary Clock(OCサーバー)
Placeholder値

${PTP4L_CONF_PATH}

/etc/ptp4l-G.8275.1.conf

${PTP4L_CONF_CONTENTS}

上記のOrdinary Clock設定 (例47.4「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 シナリオ2b - 境界クロック(ハイブリッドモード:PTPおよびSyncE)マルチポートシングルNIC構成(Ordinary Clockサーバーへの伝搬を含む)

このシナリオはまだサポートされていません。将来のSUSE Telco Cloudリリースで含まれる予定です。

47.7 シナリオ3a - 境界クロック(PTPのみ)マルチNIC構成(内部タイミングモジュール付き、DPLL GNR-Dベース)

説明

SUSE Telco Cloudは、最新のIntel Granite Rapids-Dベースの設計(GNR-D)を含む、さまざまなプラットフォームで高精度なタイミングをサポートしています。これらのサーバーには通常、組み込みの高速イーサネットコントローラーと、追加ポート用のイーサネットコントローラーを備えた1つ以上の追加カード(AIC)が含まれています。以前のプラットフォーム世代とは異なり、システム全体および異なるNIC間でタイミング信号を内部的にルーティングできる専用のDPLLも装備されており、すべてのNIC PHCを同期させるための外部ケーブル接続は不要になりました。 したがって、全体的な展開は簡素化されますが、起動時のDPLLや内部信号設定など、特定の手順とソフトウェアコンポーネントが必要になります。

このシナリオは、シナリオ2a (47.5項 「シナリオ2a - バウンダリクロック (PTPのみ)、マルチポートシングルNICを使用し、オーディナリクロックサーバーへの伝搬を含む」)を拡張したもので、ITU-T G.8275.1(PTPのみ、レイヤー2)に完全に準拠した、複数のNIC上に構築される境界クロック(BC)を対象としています。統合コントローラーの1つのポートがグランドマスターからPTPを受信し、追加カードがダウンストリームでPTPを再生成します。シングルNICの場合とは異なり、各NICは独自のPHCを備えています。オンボードのDPLLと`ts2phc`がそれらを調整し、PHCごとに1つの`ptp4l`インスタンスが実行されます。

重要
重要

この SUSE Telco Cloud リリースでは、このシナリオは「デフォルト」(つまり「PREEMPT_RT」ではない)カーネルフレーバーでのみサポートされています。 「RT」カーネルフレーバーのサポートは、今後のリリースで追加される予定です。

前提条件
  • _Intel 800シリーズネットワークデバイス_用の最新のカーネルドライバーを、 IntelのWebサイトからダウンロードしてインストールしてください。

  • 「ice_RPM_Files」を含むzipファイルを選択し、アーカイブを解凍して`ice-kmp-default-*sles16sp0.x86_64.rpm`をインストールしてください。このRPMには、例えば 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

    変更を永続的かつ有効にするために、サーバーを再起動してください。

注記
注記
  • 例を通してDell PowerEdge XR8720tシステムをリファレンスシステムとして使用しますが、カーネルインターフェイスとポート構成は、別のGNR-Dサーバーでは異なる場合があります。デバイス名は適宜調整してください。

  • Telcoデプロイメントが想定されており、以下のセクション全体でTelcoプロファイルG.8275.1が使用されます。

このシナリオには、以下のコンポーネントが含まれます。

  • Grandmaster (GM): アップストリームセグメント上の、PTPドメイン(ドメイン 24)のリファレンス。

  • PTP対応スイッチ: タイミングパス上でバウンダリクロック (T-BC) として機能します。PTPを伝送するすべてのポートには`ptp enable`が設定されています。アップストリームセグメントとダウンストリームセグメントは、スイッチの異なるVLAN上で分離されています(各セグメントに専用のVLANを使用)。

  • Boundary Clock (BC server): GNR-Dノード。その統合コントローラーは eno8403np1 上のGMからPTPを受信し、統合PHC (/dev/ptp1) を制御します。オンボードDPLLはそのタイミングをアドインカードに分配し、ts2phc はそれらのPHC (/dev/ptp2、/dev/ptp3) を /dev/ptp1 に同期させ続けます。各アドインカードはPTPをダウンストリーム側で再生成し(例えば eno16495np0 上で)、タイムトランスミッターとして機能します。

  • Ordinary Clock (OC server): ダウンストリームセグメント上のシングルポートノード (ens6f0np0) で、その唯一のPTPマスターはBCです。

BC server のタイミングは、PHCが物理的に分離されているため、連携して動作する複数の linuxptp デーモンによって処理されます。

  • 統合コントローラー (/dev/ptp1) 上の ptp4l インスタンスが eno8403np1 でPTPプロトコルを実行します。BMCAがGMをマスターとして選択し、ポートは`SLAVE`に移行し、ptp4l`が/dev/ptp1`を同期させます。

  • オンボードDPLLは、統合PHCがSDPピンを介してそれを駆動し、DPLLが今度はアドインカードのクロックを駆動するように配線されています。これは、以前のプラットフォームで使用されていた外部1PPSケーブル配線の内部的な代替手段です。

  • ts2phc`は、DPLLが分配する信号から、アドインカードのPHCを/dev/ptp1`に同期させ続けます。

  • アドインカードごとの個別の`ptp4l`インスタンス(/dev/ptp2、/dev/ptp3)が、そのポート上でPTPを再生成し、すべて`serverOnly 1`(タイムトランスミッター)に強制されます。

  • バウンダリクロックは、時刻に加えて、グランドマスターの補助属性(クロッククラス、精度など)を転送する必要があります。これは単一の`ptp4l`インスタンス内でのみ自動的に行われるため、統合インスタンスからアドインインスタンスへそれらの値を転送するために`pmc`が使用されます(ステップ5を参照)。pmc(PTP管理クライアント)は、管理ソケットを介して実行中の`ptp4l`インスタンスのランタイム状態を照会および更新する`linuxptp`ツールです。

注記
注記

統合コントローラーでは、そのポートのうち*1つ*のみがPHCを管理する管理ポートです。/sys/class/ptp/ptp1/device/net/`を調べてそれを見つけます(例: `eno8703np0)。これはDPLL信号の設定に使用されるポートであり、必ずしもPTP(eno8403np1)を伝送するポートではありません。

注記
注記

ここで説明する設定は完全に静的なものです。GMが利用できなくなった場合、ダウンストリームの同期はホストのホールドオーバー機能のみに依存します。別の時刻参照ソースへの自動切り替えは実行されません。

図

シナリオ3a - バウンダリクロック(PTPのみ)、内部タイミングモジュール(DPLL GNR-Dベース)を備えたマルチNIC
図 47.9: バウンダリクロック(PTPのみ)、オンボードDPLLを備えたマルチNIC GNR-Dノード、オーディナリークロックへの伝搬あり

設定

タイミングパス上のすべてのスイッチポートでPTPを有効にする必要があります。BCサーバーは、以下の順序で起動されます。各ランタイムステップは`systemd`ユニットにもマッピングされるため、設定が再起動後も保持され、Cluster API(GNR-D CAPI自動化 (55.1.2項 「GNR-DマルチNICシナリオ(DPLL)」)を参照)を使用して自動化できます。OCサーバーは、シナリオ2a (47.5項 「シナリオ2a - バウンダリクロック (PTPのみ)、マルチポートシングルNICを使用し、オーディナリクロックサーバーへの伝搬を含む」)とまったく同じように設定されます。

  1. PTPデバイスと統合コントローラーを特定します。

    1. PTPクロックと、それぞれがバインドされているPCIデバイスを一覧表示します。

      # 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. `lspci`を実行して各デバイスタイプを特定し、統合コントローラーとアドインカードを区別できるようにします。

      # 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

      このリファレンスサーバーには、_Intel E825-C_統合コントローラー(/dev/ptp1)と、2枚の_E830-CC_アドインカード(/dev/ptp2、/dev/ptp3)が搭載されています。

    3. PHCを管理する統合コントローラーの管理ポートを特定します。

      # ls /sys/class/ptp/ptp1/device/net/
      eno8703np0
      # ethtool -i eno8703np0
      driver: ice
      version: 2.4.5
      [...]
  2. 内部タイミング信号(DPLL)を設定します。

    統合PHCをDPLLに接続し、前述の管理ポート(eno8703np0)と正しい`ptpN`インデックスを使用して、DPLLがアドインカードに信号を供給できるようにします。

    例 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

    これらの設定は再起動時に失われるため、`ts2phc`および`ptp4l`の前に順序付けられたoneshot型の`systemd`ユニットから起動時にスクリプトを実行してください。

    # /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. アドインカードのPHCを`ts2phc`に合わせます。

    ts2phc(「PHCへのタイムスタンプ」)は、アドインカードのPHCを基準クロックに合わせます。ここでは、基準は統合NICのPHC(/dev/ptp1、GMによってその`ptp4l`インスタンスを通じてすでに調整済み)であり、コマンドラインで`-s /dev/ptp1`とともに渡されます。オンボードのDPLLは、その基準から導出された1PPSを各アドインカードの`SDP1`ピンに供給します。`ts2phc`はそれらの入力パルス(EXTTS)をタイムスタンプし、それに応じて各アドインPHCをステップさせるため、ノード内のすべてのPHCが最終的に同じ時間を共有することになります。

    注記
    注記

    アドインPHCの調整には、異なるレベルでの2つの補完的な設定が必要です。

    • ハードウェア: オンボードのDPLLが1PPSパルスを供給できるように、各アドインPHCの`SDP1`入力ピンを有効にする必要があります。これは、前のステップ(echo 1 1 > /sys/class/ptp/ptpN/pins/SDP1)のDPLLセットアップスクリプトで行われます。

    • ソフトウェア: ts2phc`に対して、その入力をタイムスタンプし、PHCをステップさせるよう指示する必要があります。これは、以下の構成(`ts2phc.channel、ts2phc.pin_index、ts2phc.extts_polarity)で行われます。

    ピンを有効にしないとパルスはPHCに到達せず、`ts2phc`構成を行わないとパルスは適用されません。両方が必要です。

    設定ファイルを作成します。

    例 47.6: /etc/ts2phc-cf-all.cfg — `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

    各アドインカードは、その最初のポート([eno16495np0]、[eno16595np0])にちなんで名付けられたセクションを通じて構成され、これにより調整対象のPHCが識別されます。パラメータは、DPLLパルスをそのカードにマッピングします。

    • ts2phc.pin_index`および`ts2phc.channel: DPLLが1PPSを供給するピンとチャネル(このセットアップでは`SDP1`、したがって`pin_index 1`)。

    • ts2phc.extts_polarity: タイムスタンプするパルスエッジ(rising)。

    • ts2phc.pulsewidth: 期待される入力パルス幅(ナノ秒単位、ここでは100 ms)。

      手動で`ts2phc -f /etc/ts2phc-cf-all.cfg -s /dev/ptp1 -m`を実行するか、または`systemd`に`/etc/sysconfig/ts2phc`を通じて管理させるようにしてください。

      # /etc/sysconfig/ts2phc
      OPTIONS="-f /etc/ts2phc-cf-all.cfg -s /dev/ptp1 -m"
  4. PHCごとに`ptp4l`インスタンスを1つ実行してください。

    統合コントローラーはBMCA駆動のインスタンス(レシーバー)を実行し、各アドインカードはすべてのポートが`serverOnly 1`に強制されたインスタンスを実行します。各インスタンスは、異なる制御ソケットと読み取り専用ソケットを使用する必要があります。3つの設定ファイルを作成してください:

    例 47.7: /etc/ptp4l-nac.conf — 統合コントローラー (/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]

    統合インスタンスは、GMからPTPを受信するポートである`eno8403np1`のみを宣言し、それに対して`serverOnly`や`clientOnly`を設定しません。役割の割り当てはBMCAに依存します。eno8403np1`でGMに到達可能な場合、BMCAはそれをタイムレシーバー(`SLAVE)として選択し、`/dev/ptp1`を制御します。統合コントローラーの他のポートは宣言されません。なぜなら、このノードではダウンストリームの再生成は統合コントローラーではなくアドインカードによって実行されるからです。対照的に、アドインカードは常にタイムトランスミッターである必要があるため、`serverOnly 1`を強制します。これらはPTPを受信して時刻を取得するのではなく、DPLLと`ts2phc`から時刻を取得するため、レシーバーとして選出されてはなりません。より厳密な制御が必要な場合は、インターフェースの下に`serverOnly`または`clientOnly`フラグを明示的に追加してください。

    G.8275.portDS.localPriority`および`G.8275.defaultDS.localPriority`の値(統合インスタンスでは`128、アドインカードでは`250`)は、G.8275.x BMCAのタイブレーカーとして機能します。これらは`clockClass`、clockAccuracy、分散、priority2`の後にのみ比較され、値が小さい方が優先されます。統合インスタンスでデフォルトの`128`を維持すると、アドインインスタンス(`250)よりも優先順位が高くなります。これにより、ノード内のタイムトランスミッター/タイムレシーバーの順序が決定論的に保たれ、`ptp4l`によって報告されるポート状態に反映されるように、BMCAがどのポートを選択するかが決まります。

    例 47.8: /etc/ptp4l-aic1.conf — アドインカード 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
    例 47.9: /etc/ptp4l-aic2.conf — アドインカード 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
    注記
    注記

    シナリオ 2a (47.5項 「シナリオ2a - バウンダリクロック (PTPのみ)、マルチポートシングルNICを使用し、オーディナリクロックサーバーへの伝搬を含む」)と同様に、タイミングパス上のすべてのノードは、ダウンストリームOCを含め、同じ転送不可のG.8275.1マルチキャストMAC `01:80:C2:00:00:0E`を使用します。

    テンプレート化された`systemd`ユニットで`/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

    3つのインスタンスを有効にして開始してください:

    # systemctl enable --now ptp4l@nac ptp4l@aic1 ptp4l@aic2
  5. グランドマスターのパラメータを`ptp4l`インスタンス間で転送してください。

    境界クロックは、時刻だけでなく、グランドマスターの補助パラメータ(クロッククラス、精度、UTCオフセットなど)も転送しなければなりません。これは*同じ*ptp4l`インスタンスのポート間で自動的に行われますが、異なるPHCを管理する個別のインスタンス間では行われません。値は、各インスタンスのUDSソケット(`SET GRANDMASTER_SETTINGS_NP)を介して、ランタイムで`pmc`を使って適用されます。

    重要
    重要

    pmc`で適用された値は実行中の`ptp4l`プロセス内にのみ保持されます。これらは*書き込まれず*、.conf`ファイルには保存されず、再起動しても保持され*ません*。`ptp4l`インスタンスが再起動されると、ファイルデフォルト値に戻るため、値を再度転送する必要があります。手動で一度実行するのではなく、転送を自動化してください(下記参照)。

    統合コントローラーがGMにロックされたら、グランドマスターの値をクエリします。以下のヘルパーは、クエリするインスタンスの設定ファイルを引数として受け取ります。

    例 47.10: get_pmc_values.sh — `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'

    次に、それらの値をアドインインスタンスに転送します。以下のスクリプトは、統合インスタンスから値を読み取り、各アドインインスタンスに適用します。「Input variables」セクションを編集して設定ファイル名と一致させ、システムがGMに同期されたら実行してください。

    例 47.11: 04-ptp-forward-GM.sh — グランドマスターの値をアドインインスタンスに転送する
    #!/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

    値は永続的ではないため、このスクリプトを`systemd`タイマーから実行し、定期的に、またインスタンスの再起動後に値が更新されるようにしてください。

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

    その効果は、BC上のアドイン`ptp4l`インスタンスにクエリを実行することで確認できます。転送前は、ノードはファイルデフォルト値をアドバタイズしますが、転送開始後は、グランドマスターの実際の値(その後、ダウンストリームのOCに伝播されます)をアドバタイズします。例えば、`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. オプションとして、統合PHCをソース(/etc/sysconfig/phc2sys)として使用し、`phc2sys`でPTPからシステムクロックを導出します。

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

CAPI自動化

自動プロビジョニングワークフローでこのシナリオをデプロイするには、完全に自動化されたダイレクトネットワークプロビジョニング — GNR-Dシナリオ (55.1.2項 「GNR-DマルチNICシナリオ(DPLL)」)で説明されているGNR-D固有のCluster APIテンプレートを使用してください。標準的なシナリオとは異なり、複数の`ptp4l`インスタンス、`ts2phc`サービス、DPLL起動時セットアップ、およびグランドマスター転送タイマーをデプロイするため、上記に記載された追加の設定ファイルと`systemd`ユニットが必要です。 そのプレースホルダーを以下の値で上書きしてください。

表 47.5: GNR-Dバウンダリクロック
Placeholder値

${GNRD_DPLL_SETUP_CONTENTS}

01-gnrd-startup-setup.sh (例47.5「01-gnrd-startup-setup.sh」)からコンテンツをコピーしてください。

${GNRD_FORWARD_GM_CONTENTS}

04-ptp-forward-GM.sh (例47.11「04-ptp-forward-GM.sh — グランドマスターの値をアドインインスタンスに転送する」)からコンテンツをコピーしてください。

${TS2PHC_CONF_CONTENTS}

/etc/ts2phc-cf-all.cfg (例47.6「/etc/ts2phc-cf-all.cfg — `ts2phc`設定ファイル」)からコンテンツをコピーしてください。

${TS2PHC_OPTIONS}

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

${PTP4L_NAC_CONTENTS}

/etc/ptp4l-nac.conf (例47.7「/etc/ptp4l-nac.conf — 統合コントローラー (/dev/ptp1)」)からコンテンツをコピーしてください。

${PTP4L_AIC1_CONTENTS}

/etc/ptp4l-aic1.conf (例47.8「/etc/ptp4l-aic1.conf — アドインカード 1 (/dev/ptp2)」)からコンテンツをコピーしてください。

${PTP4L_AIC2_CONTENTS}

/etc/ptp4l-aic2.conf (例47.9「/etc/ptp4l-aic2.conf — アドインカード 2 (/dev/ptp3)」)からコンテンツをコピーしてください。

47.8 シナリオ 3b - バウンダリクロック (ハイブリッドモード:PTP & SyncE) 内部タイミングモジュール付きマルチNIC (DPLL GNR-Dベース)

このシナリオはまだサポートされていません。将来のSUSE Telco Cloudリリースで含まれる予定です。