Skip to content
Projects
Groups
Snippets
Help
Loading...
Sign in
Toggle navigation
W
White Rabbit
Project
Project
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
5
Issues
5
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
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
Commits
8b4dc6e3
Commit
8b4dc6e3
authored
Nov 13, 2014
by
Grzegorz Daniluk
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
docs/specifications/management: adding first version of WRS failures and SNMP exports document
parent
48045180
Expand all
Show whitespace changes
Inline
Side-by-side
Showing
5 changed files
with
1375 additions
and
0 deletions
+1375
-0
Makefile
documents/specifications/management/wrs_failures/Makefile
+11
-0
fail.tex
documents/specifications/management/wrs_failures/fail.tex
+829
-0
intro.tex
documents/specifications/management/wrs_failures/intro.tex
+41
-0
snmp_exports.tex
...s/specifications/management/wrs_failures/snmp_exports.tex
+379
-0
wrs_failures.tex
...s/specifications/management/wrs_failures/wrs_failures.tex
+115
-0
No files found.
documents/specifications/management/wrs_failures/Makefile
0 → 100644
View file @
8b4dc6e3
all
:
wrs_failures.pdf
.PHONY
:
all clean
wrs_failures.pdf
:
wrs_failures.tex
pdflatex
-dPDFSETTINGS
=
/prepress
-dSubsetFonts
=
true
-dEmbedAllFonts
=
true
-dMaxSubsetPct
=
100
-dCompatibilityLevel
=
1.4
$^
pdflatex
-dPDFSETTINGS
=
/prepress
-dSubsetFonts
=
true
-dEmbedAllFonts
=
true
-dMaxSubsetPct
=
100
-dCompatibilityLevel
=
1.4
$^
clean
:
rm
-f
*
.eps
*
.pdf
*
.dat
*
.log
*
.out
*
.aux
*
.dvi
*
.ps
*
.toc
documents/specifications/management/wrs_failures/fail.tex
0 → 100644
View file @
8b4dc6e3
This diff is collapsed.
Click to expand it.
documents/specifications/management/wrs_failures/intro.tex
0 → 100644
View file @
8b4dc6e3
\section
{
Introduction
}
This document tries to list all possible ways the White Rabbit Switch can
brake. It is my brain dump and should be a starting point to improve SNMP
implementation and alarms (traps) generation. The document also tries to
describe what should be the operator's action for each failure. Whether it's
enough to reboot the switch or if it should be replaced with a new unit.
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
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 in case required SNMP objects are
not yet exported by our current implementation of the SNMP agent. It
describes some preliminary ideas what should be exported in the near future.
\end{itemize}
Section
\ref
{
sec:snmp
_
exports
}
is a documentation for people integrating WR
switch into a control system, operators and WR experts. It describes all
essential SNMP objects exported by the device divided into two groups:
\emph
{
Operator/basic objects
}
,
\emph
{
Expert objects
}
documents/specifications/management/wrs_failures/snmp_exports.tex
0 → 100644
View file @
8b4dc6e3
This diff is collapsed.
Click to expand it.
documents/specifications/management/wrs_failures/wrs_failures.tex
0 → 100644
View file @
8b4dc6e3
\def\us
{
\char
`
\_
}
\documentclass
[a4paper, 12pt]
{
article
}
%\documentclass{article}
\usepackage
{
fullpage
}
\usepackage
{
pgf
}
\usepackage
{
tikz
}
\usetikzlibrary
{
arrows,automata,shapes
}
\usepackage
{
multirow
}
\usepackage
{
color
}
\usepackage
[latin1]
{
inputenc
}
\usepackage
{
verbatim
}
\usepackage
{
amsmath
}
\usepackage
{
times,mathptmx
}
\usepackage
{
chngcntr
}
\usepackage
{
hyperref
}
\usepackage
{
enumitem
}
\usepackage
{
scrextend
}
%\usepackage[table]{xcolor}
\usepackage
{
listings
}
\definecolor
{
light-gray
}{
gray
}{
0.95
}
%\usepackage[firstpage]{draftwatermark}
\usepackage
{
listings
}
\usepackage
{
cancel
}
\graphicspath
{
{
../../../../figures/
}
}
\newenvironment
{
packed
_
enum
}{
\begin{itemize}
[leftmargin=0pt,topsep=-12pt]
\setlength
{
\itemsep
}{
1pt
}
\setlength
{
\parskip
}{
0pt
}
\setlength
{
\parsep
}{
0pt
}
}{
\end{itemize}
}
\newenvironment
{
packed
_
items
}{
\begin{itemize}
[topsep=-12pt]
\setlength
{
\itemsep
}{
1pt
}
\setlength
{
\parskip
}{
0pt
}
\setlength
{
\parsep
}{
0pt
}
}{
\end{itemize}
}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% creating subsubsubsection notation
% src: http://www.latex-community.org/forum/viewtopic.php?f=5&t=791
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\setcounter
{
secnumdepth
}{
6
}
\renewcommand\theparagraph
{
\Alph
{
paragraph
}}
\makeatletter
\renewcommand\paragraph
{
\@
startsection
{
paragraph
}{
4
}{
\z
@
}
%
{
-3.25ex
\@
plus -1ex
\@
minus -.2ex
}
%
{
0.0001pt
\@
plus .2ex
}
%
{
\normalfont\normalsize\bfseries
}}
\renewcommand\subparagraph
{
\@
startsection
{
subparagraph
}{
5
}{
\z
@
}
%
{
-3.25ex
\@
plus -1ex
\@
minus -.2ex
}
%
{
0.0001pt
\@
plus .2ex
}
%
{
\normalfont\normalsize\bfseries
}}
\counterwithin
{
paragraph
}{
subsubsection
}
\counterwithin
{
subparagraph
}{
paragraph
}
\makeatother
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\newcommand
{
\eqoffset
}
[1]
{
%
{
\ensuremath
{
%
{
\text
{
offset
}}_{
#1
}}
%
}
%
}
\newcommand
{
\eqdelay
}
[1]
{{
\text
{
delay
}}_{
#1
}}
\newcommand
{
\eqasymm
}{{
\text
{
asymmetry
}}}
\begin{document}
\title
{
X ways WR Switch can fail
\\
[0.5cm]
%\large {what to report, how to recover}}
\Large
{
the very first draft
}}
\author
{
Grzegorz Daniluk
\\
CERN BE-CO-HT
}
\maketitle
\thispagestyle
{
empty
}
\begin{figure}
[ht!]
\centering
\vspace
{
1.3cm
}
\includegraphics
[width=0.50\textwidth]
{
logo/WRlogo.pdf
}
\end{figure}
\newpage
\newpage
\newpage
\tableofcontents
\newpage
\input
{
intro.tex
}
\newpage
\section
{
Possible Errors
}
\label
{
sec:failures
}
\input
{
fail.tex
}
\newpage
\input
{
snmp
_
exports.tex
}
%\section{SNMP exports}
%\subsection{Operator/basic objects}
%\subsection{Expert objects}
%\newpage
%\bibliographystyle{unsrt}
%\bibliography{references}
\end{document}
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