Skip to content
Projects
Groups
Snippets
Help
Loading...
Sign in
Toggle navigation
W
White Rabbit Switch - Software
Project
Project
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
86
Issues
86
List
Board
Labels
Milestones
Merge Requests
4
Merge Requests
4
CI / CD
CI / CD
Pipelines
Schedules
Wiki
Wiki
image/svg+xml
Discourse
Discourse
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Commits
Issue Boards
Open sidebar
Projects
White Rabbit Switch - Software
Commits
5e482e8a
Commit
5e482e8a
authored
Feb 01, 2016
by
Grzegorz Daniluk
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
doc/wrs_failures: swap problems and snmp exports sections
parent
6ff70c97
Hide whitespace changes
Inline
Side-by-side
Showing
3 changed files
with
56 additions
and
27 deletions
+56
-27
fail.tex
doc/wrs_failures/fail.tex
+54
-1
intro.tex
doc/wrs_failures/intro.tex
+0
-24
wrs_failures.tex
doc/wrs_failures/wrs_failures.tex
+2
-2
No files found.
doc/wrs_failures/fail.tex
View file @
5e482e8a
This section tries to identify all the possible ways the White Rabbit Switch can
fail. The structure of each error description is the following:
\begin{itemize}
[leftmargin=0pt]
\item
[]
\underline
{
Status
}
: describes the implementation status of the WRS
diagnostics detecting the fault. Can be one of the following:
\begin{packed_items}
\item
DONE: all the SNMP objects are implemented and the problem is
reported by a switch
\item
TODO: not all of the SNMP objects are already implemented, the
problem is either reported only in some situations or not reported at
all
\item
\emph
{
for later
}
: the problem concerns functionality that is not yet
present in the stable release of the WR switch firmware i.e. it will
never happen with the current stable firmware release.
\end{packed_items}
\item
[]
\underline
{
Severity
}
: describes how critical is the fault. Currently
we distinguish two severity levels:
\begin{packed_items}
\item
WARNING - means that despite the fault the synchronization and
Ethernet switching functionality were not affected so the switch behaves
correctly in the WR network.
\item
ERROR - means that the fault is critical and most probably a WR
switch misbehaves in a WR network, possibly causing also problems to
other WR devices connected to this switch.
\end{packed_items}
\item
[]
\underline
{
Mode
}
: for timing failures, it describes which modes are
affected. Possible values are:
\begin{packed_items}
\item
\emph
{
Slave
}
- the WR Switch has at least one Slave port
synchronized to another WR device higher in the timing hierarchy (though
it may be also Master to other WR/PTP devices lower in the timing
hierarchy).
\item
\emph
{
Grand Master
}
- the WR Switch at the top of the
synchronization hierarchy. It is synchronized to an external clock (e.g.
GPS, Cesium) and provides timing to other WR/PTP devices.
\item
\emph
{
Free-Running Master
}
- the WR Switch at the top of the
synchronization hierarchy. It provides timing to other WR/PTP devices
but runs from a local oscillator (not synchronized to an external
clock).
\item
\emph
{
all
}
- any WR switch can be affected regardless the timing
mode.
\end{packed_items}
\item
[]
\underline
{
Description
}
: What the problem is about, how important it
is and what are the effects if it occurs.
\item
[]
\underline
{
SNMP objects
}
: Which SNMP objects should be monitored to
detect the failure. These may be objects from
\texttt
{
WR-SWITCH-MIB
}
or one
of the standard MIBs used by the
\emph
{
net-snmp
}
.
\item
[]
\underline
{
Notes
}
: Optional comment for the SNMP implementation. It
may describe the current implementation of ideas or how to implement it in
the future.
\end{itemize}
\subsection
{
Timing error
}
\subsection
{
Timing error
}
\label
{
sec:timing
_
fail
}
\label
{
sec:timing
_
fail
}
As a timing error we define the WR Switch not being able to provide its slave
As a timing error we define the WR Switch not being able to provide its slave
...
@@ -525,7 +578,7 @@ list of faults leading to a data error.
...
@@ -525,7 +578,7 @@ list of faults leading to a data error.
\subsubsection
{
\bf
Wrong configuration applied (e.g. wrong VLAN config)
}
\subsubsection
{
\bf
Wrong configuration applied (e.g. wrong VLAN config)
}
\begin{pck_descr}
\begin{pck_descr}
\item
[]
\underline
{
Status
}
: TODO
\emph
{
(to be done later)
}
\item
[]
\underline
{
Status
}
: TODO
\item
[]
\underline
{
Severity
}
: WARNING
\item
[]
\underline
{
Severity
}
: WARNING
\item
[]
\underline
{
Description
}
:
\\
\item
[]
\underline
{
Description
}
:
\\
The same problem as described in the timing fault
The same problem as described in the timing fault
...
...
doc/wrs_failures/intro.tex
View file @
5e482e8a
...
@@ -7,30 +7,6 @@ the problems.
...
@@ -7,30 +7,6 @@ the problems.
The document is organized in two parts. First one (section
\ref
{
sec:failures
}
)
The document is organized in two parts. First one (section
\ref
{
sec:failures
}
)
tries to list all the possible failures that may disturb synchronization and
tries to list all the possible failures that may disturb synchronization and
Ethernet switching. The structure of each failure description is the following:
Ethernet switching. The structure of each failure description is the following:
\begin{itemize}
[leftmargin=0pt]
\item
[]
\underline
{
Mode
}
: for timing failures, it says which modes are
affected. Possible values are:
\begin{itemize}
\item
\emph
{
Slave
}
- WR Switch has at least one Slave port synchronized to
another WR device higher in the timing hierarchy (though it may be also
Master to other WR/PTP devices lower in the timing hierarchy).
\item
\emph
{
Grand Master
}
- WR Switch at the top of the synchronization
hierarchy. It is synchronized to an external clock (e.g. GPSDO, Cesium)
and provides timing to other WR/PTP devices.
\item
\emph
{
Free-Running Master
}
- WR Switch at the top of the
synchronization hierarchy. It provides timing to other WR/PTP devices
but runs from a local oscillator (not synchronized to external atomic
clock).
\end{itemize}
\item
[]
\underline
{
Description
}
: What the problem is about, how important it
is and what bad may happen if it occurs.
\item
[]
\underline
{
SNMP objects
}
: Which SNMP objects should be monitored to
detect the failure. These may be objects from
\texttt
{
WR-SWITCH-MIB
}
or one
of the standard MIBs used by the
\emph
{
net-snmp
}
.
\item
[]
\underline
{
Notes
}
: Optional comment for SNMP implementation. It may describe current
implementation of ideas how to implement it in the future
\end{itemize}
Section
\ref
{
sec:snmp
_
exports
}
is a documentation for people integrating WR
Section
\ref
{
sec:snmp
_
exports
}
is a documentation for people integrating WR
switch into a control system, operators and WR experts. It describes all
switch into a control system, operators and WR experts. It describes all
...
...
doc/wrs_failures/wrs_failures.tex
View file @
5e482e8a
...
@@ -254,12 +254,12 @@
...
@@ -254,12 +254,12 @@
\newpage
\newpage
\input
{
intro.tex
}
\input
{
intro.tex
}
\newpage
\input
{
snmp
_
exports.tex
}
\newpage
\newpage
\section
{
Possible Errors
}
\section
{
Possible Errors
}
\label
{
sec:failures
}
\label
{
sec:failures
}
\input
{
fail.tex
}
\input
{
fail.tex
}
\newpage
\input
{
snmp
_
exports.tex
}
\appendix
\appendix
\newpage
\newpage
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment