diff --git a/doc/source/admintasks/kubernetes/install-ptp-notifications.rst b/doc/source/admintasks/kubernetes/install-ptp-notifications.rst
index bea04ea8..8aa2b921 100644
--- a/doc/source/admintasks/kubernetes/install-ptp-notifications.rst
+++ b/doc/source/admintasks/kubernetes/install-ptp-notifications.rst
@@ -132,6 +132,7 @@ For example, follow the steps below: ptp4lServiceName: ptp4l-legacy phc2sysServiceName: phc2sys-legacy logging_level: INFO
+ ptp4lClockClassLockedList: "6,7,135"
device: holdover_seconds: 15 poll_freq_seconds: 2
@@ -139,6 +140,8 @@ For example, follow the steps below: ptp4lServiceName: True phc2sysServiceName: True ts2phcServiceName: True
+ ptp4lClockClassLockedList: "6,7,135"
+ phc2sysToleranceThreshold: 1000 log_level: INFO control_timeout: 2
device:
@@ -161,9 +164,10 @@ For example, follow the steps below: ptp4lServiceName: ptp4l-instancename phc2sysServiceName: phc2sys-instancename logging_level: INFO
- device:
- holdover_seconds: 15
- poll_freq_seconds: 2
+ ptp4lClockClassLockedList: "6,7,135"
+ device:
+ holdover_seconds: 15
+ poll_freq_seconds: 2
``ptptracking``
@@ -184,6 +188,19 @@ For example, follow the steps below: ``logging_level: INFO``
Set the logging level. DEBUG can be used for additional logs.
+ ``ptp4lClockClassLockedList``
+ Set the list of clock classes that will allow ptp-notification to report "Locked". The
+ clockClass for a monitored ptp4l instance is read via the 'pmc'; if the instance
+ clockClass matches once of the 'ptp4lClockClassLockedList' values, then
+ ptp-notification will report "Locked" for that instance.
+
+ The default values are "6,7,135", which means that ptp-notification will report locked
+ when reading a clockClass of 6, 7 or 135 from the configured ptp4l instance. These
+ values are recommended for nodes operating as a Boundary Clock (BC).
+
+ For nodes operating as a GM, it is recommended to set the value to "6", so that only
+ clockClass 6 is reported as locked.
+ ``holdover_seconds`` ``holdover_seconds`` configures how long each service will stay in
the HOLDOVER state before transitioning to FREERUN. The holdover value
@@ -209,6 +226,8 @@ For example, follow the steps below: phc2sysServiceName: True ts2phcServiceName: True log_level: INFO
+ ptp4lClockClassLockedList: "6,7,135"
+ phc2sysToleranceThreshold: 1000 control_timeout: 2 device: holdover_seconds: 15
@@ -240,6 +259,30 @@ For example, follow the steps below: ``log_level: INFO``
Set the logging level. DEBUG can be used for additional logs.
+ ``ptp4lClockClassLockedList``
+ Set the list of clock classes that will allow ptp-notification to report "LOCKED". The
+ clockClass for a monitored ptp4l instance is read via the 'pmc'; if the instance
+ clockClass matches once of the 'ptp4lClockClassLockedList' values, then
+ ptp-notification will report "LOCKED" for that instance.
+
+ The default values are "6,7,135", which means that ptp-notification will report locked
+ when reading a clockClass of 6, 7 or 135 from the configured ptp4l instance. These
+ values are recommended for nodes operating as a Boundary Clock (BC).
+
+ For nodes operating as a Grand Master (GM), it is recommended to set the value to "6",
+ so that only clockClass 6 is reported as locked.
+
+ ``phc2sysToleranceThreshold``
+ Default value: 1000
+
+ Set the skew threshold in nanoseconds at which ptp-notification will report that the
+ system clock is no longer considered "LOCKED".
+
+ The ptp-notification application compares the time of the system clock to the configured
+ source PHC; if the delta between the system clock and the PHC is greater than the
+ 'phc2sysToleranceThreshold', a notification will be generated that the system clock is
+ not locked.
+ ``control_timeout: 2`` control_timeout sets how frequently, in seconds the services are checked.
Value applies to all service types.
Brief Description /docs.starlingx .io/admintasks/ kubernetes/ install- ptp-notificatio ns.html
-----------------
Doc changes are required to align with the code changes introduced in https:/
Severity
--------
<Major: System/Feature is usable but degraded>
Diff with proposed changes in https:/ /docs.starlingx .io/admintasks/ kubernetes/ install- ptp-notificatio ns.html
diff --git a/doc/source/ admintasks/ kubernetes/ install- ptp-notificatio ns.rst b/doc/source/ admintasks/ kubernetes/ install- ptp-notificatio ns.rst admintasks/ kubernetes/ install- ptp-notificatio ns.rst admintasks/ kubernetes/ install- ptp-notificatio ns.rst
ptp4lServic eName: ptp4l-legacy
phc2sysServ iceName: phc2sys-legacy
logging_ level: INFO LockedList: "6,7,135"
holdover_ seconds: 15
poll_ freq_seconds: 2
ptp4lServic eName: True
phc2sysServ iceName: True
ts2phcServi ceName: True LockedList: "6,7,135" eThreshold: 1000
log_ level: INFO
control_ timeout: 2
ptp4lServiceNam e: ptp4l-instancename
phc2sysServiceN ame: phc2sys- instancename
logging_ level: INFO LockedList: "6,7,135"
index bea04ea8..8aa2b921 100644
--- a/doc/source/
+++ b/doc/source/
@@ -132,6 +132,7 @@ For example, follow the steps below:
+ ptp4lClockClass
device:
@@ -139,6 +140,8 @@ For example, follow the steps below:
+ ptp4lClockClass
+ phc2sysToleranc
device:
@@ -161,9 +164,10 @@ For example, follow the steps below:
- device:
- holdover_seconds: 15
- poll_freq_seconds: 2
+ ptp4lClockClass
+ device:
+ holdover_seconds: 15
+ poll_freq_seconds: 2
@@ -184,6 +188,19 @@ For example, follow the steps below:
``logging_ level: INFO``
Set the logging level. DEBUG can be used for additional logs.
+ ``ptp4lClockCla ssLockedList` ` sLockedList' values, then
``holdover_ seconds` `
`` holdover_ seconds` ` configures how long each service will stay in
phc2sysServiceN ame: True
ts2phcServiceNa me: True
log_level: INFO LockedList: "6,7,135" eThreshold: 1000
control_ timeout: 2
device:
holdover_ seconds: 15
``log_ level: INFO``
+ Set the list of clock classes that will allow ptp-notification to report "Locked". The
+ clockClass for a monitored ptp4l instance is read via the 'pmc'; if the instance
+ clockClass matches once of the 'ptp4lClockClas
+ ptp-notification will report "Locked" for that instance.
+
+ The default values are "6,7,135", which means that ptp-notification will report locked
+ when reading a clockClass of 6, 7 or 135 from the configured ptp4l instance. These
+ values are recommended for nodes operating as a Boundary Clock (BC).
+
+ For nodes operating as a GM, it is recommended to set the value to "6", so that only
+ clockClass 6 is reported as locked.
+
the HOLDOVER state before transitioning to FREERUN. The holdover value
@@ -209,6 +226,8 @@ For example, follow the steps below:
+ ptp4lClockClass
+ phc2sysToleranc
@@ -240,6 +259,30 @@ For example, follow the steps below:
Set the logging level. DEBUG can be used for additional logs.
+ ``ptp4lClockCla ssLockedList` ` sLockedList' values, then nceThreshold` ` ceThreshold' , a notification will be generated that the system clock is
``control_ timeout: 2``
control_ timeout sets how frequently, in seconds the services are checked.
+ Set the list of clock classes that will allow ptp-notification to report "LOCKED". The
+ clockClass for a monitored ptp4l instance is read via the 'pmc'; if the instance
+ clockClass matches once of the 'ptp4lClockClas
+ ptp-notification will report "LOCKED" for that instance.
+
+ The default values are "6,7,135", which means that ptp-notification will report locked
+ when reading a clockClass of 6, 7 or 135 from the configured ptp4l instance. These
+ values are recommended for nodes operating as a Boundary Clock (BC).
+
+ For nodes operating as a Grand Master (GM), it is recommended to set the value to "6",
+ so that only clockClass 6 is reported as locked.
+
+ ``phc2sysTolera
+ Default value: 1000
+
+ Set the skew threshold in nanoseconds at which ptp-notification will report that the
+ system clock is no longer considered "LOCKED".
+
+ The ptp-notification application compares the time of the system clock to the configured
+ source PHC; if the delta between the system clock and the PHC is greater than the
+ 'phc2sysToleran
+ not locked.
+
Value applies to all service types.