pimsm.tex

xorp源码hg

\>\>switch-to-spt-threshold \{\\
\>\>\>/* approx. 1K bytes/s (10Kbps) threshold */\\
\>\>\>disable: false\\
\>\>\>interval: 100\\
\>\>\>bytes: 102400\\
\>\>\}\\
\\
{\rm continued overleaf....}
\end{tabbing}
\end{alltt}
\end{minipage}
}
\newpage
\vspace{0.1in}
\noindent\framebox[\textwidth][l]{\scriptsize
\begin{minipage}{4.5in}
\begin{alltt}
\begin{tabbing}
xx\=xx\=xx\=xx\=xx\=\kill
\>\>traceoptions \{\\
\>\>\>flag all \{\\
\>\>\>\>disable: false\\
\>\>\>\}\\
\>\>\}\\
\>\}\\
\}
\\
\\
protocols \{\\
\>pimsm6 \{\\
\>\>disable: false\\
\>\>interface dc0 \{\\
\>\>\>vif dc0 \{\\
\>\>\>\>disable: false\\
\>\>\>\>/* enable-ip-router-alert-option-check: false */\\
\>\>\>\>/* dr-priority: 1 */\\
\>\>\>\>/* hello-period: 30 */\\
\>\>\>\>/* alternative-subnet 40:40:40:40::/64 */\\
\>\>\>\}\\
\>\>\}\\
\>\>interface register\_vif \{\\
\>\>\>vif register\_vif \{\\
\>\>\>\>/* Note: this vif should be always enabled */\\
\>\>\>\>disable: false\\
\>\>\>\}\\
\>\>\}\\
\\
\>\>static-rps \{\\
\>\>\>rp 50:50:50:50:50:50:50:50 \{\\
\>\>\>\>group-prefix ff00::/8 \{\\
\>\>\>\>\>/* rp-priority: 192 */\\
\>\>\>\>\>/* hash-mask-len: 126 */\\
\>\>\>\>\}\\
\>\>\>\}\\
\>\>\}\\
\\
\>\>bootstrap \{\\
\>\>\>disable: false\\
\>\>\>cand-bsr \{\\
\>\>\>\>scope-zone ff00::/8 \{\\
\>\>\>\>\>/* is-scope-zone: false */\\
\>\>\>\>\>cand-bsr-by-vif-name: "dc0"\\
\>\>\>\>\>/* cand-bsr-by-vif-addr: 10:10:10:10:10:10:10:10 */\\
\>\>\>\>\>/* bsr-priority: 1 */\\
\>\>\>\>\>/* hash-mask-len: 126 */\\
\>\>\>\>\}\\
\>\>\>\}\\
\\
\>\>\>cand-rp \{\\
\>\>\>\>group-prefix ff00::/8 \{\\
\>\>\>\>\>/* is-scope-zone: false */\\
\>\>\>\>\>cand-rp-by-vif-name: "dc0"\\
\>\>\>\>\>/* cand-rp-by-vif-addr: 10:10:10:10:10:10:10:10 */\\
\>\>\>\>\>/* rp-priority: 192 */\\
\>\>\>\>\>/* rp-holdtime: 150 */\\
\>\>\>\>\}\\
\>\>\>\}\\
\>\>\}\\
\\
\>\>switch-to-spt-threshold \{\\
\>\>\>/* approx. 1K bytes/s (10Kbps) threshold */\\
\>\>\>disable: false\\
\>\>\>interval: 100\\
\>\>\>bytes: 102400\\
\>\>\}\\
\\
\>\>traceoptions \{\\
\>\>\>flag all \{\\
\>\>\>\>disable: false\\
\>\>\>\}\\
\>\>\}\\
\>\}\\
\}
\end{tabbing}
\end{alltt}
\end{minipage}
}
\vspace{0.1in}

\section{Monitoring PIM-SM}

All operational commands for monitoring PIM-SM for IPv4 begin with
{\tt show pim}. This section describes those commands in details. All
operational commands for monitoring PIM-SM for IPv6 are similar except that
they begin with {\tt show pim6}.

\subsection{Monitoring PIM-SM Bootstrap Information}

The {\stt show pim bootstrap} command can be used to display
information about PIM bootstrap routers:

\vspace{0.1in}
\noindent\framebox[\textwidth][l]{\scriptsize
\begin{minipage}{6in}
\begin{alltt}
\begin{tabbing}
xxxxxxxxxxxxxxx\=xx\=xx\=xxxxxxxxxxxxxxxxxx\=xx\=xx\=xxxxxxxxxxxx\=xxxxx\=xxx\=xxxxxxx\=\kill
user@hostname> \textbf{show pim bootstrap}\\
Active zones:\\
BSR             \>Pri\>\>LocalAddress    \>Pri\>\>State           \>Timeout\>\>SZTimeout\\
10.4.0.1        \>\>1\>10.2.0.2          \>\>1\>Candidate          \>\>75
  \>\>-1\\
Expiring zones:\\
BSR             \>Pri\>\>LocalAddress    \>Pri\>\>State           \>Timeout\>\>SZTimeout\\
Configured zones:\\
BSR             \>Pri\>\>LocalAddress    \>Pri\>\>State           \>Timeout\>\>SZTimeout\\
10.2.0.2        \>\>1\>10.2.0.2          \>\>1\>Init               \>\>-1        \>\>-1
\end{tabbing}
\end{alltt}
\end{minipage}
}
\vspace{0.1in}

The bootstrap information is separated in three sections:
\begin{itemize}

  \item {\tt Active zones:} This section contains the bootstrap zones that are
  currently in use.

  \item {\tt Expiring zones:} If new bootstrap information is received and it
  replaces the old bootstrap information, the old information is deleted.
  However, if some of the old bootstrap information was not replaced,
  that information is moved to the {\tt Expiring zones} section until
  it times out.

  \item {\tt Configured zones:} This section contains the bootstrap zones that
  are configured on the router.

\end{itemize}

The fields for each entry (in order of appearance) are:
\begin{itemize}

  \item {\tt BSR:} The address of the Bootstrap router for the zone.

  \item {\tt Pri:} The priority of the Bootstrap router.

  \item {\tt LocalAddress:} The local Candidate-BSR address for the zone
  (if the router is configured as a Candidate-BSR).

  \item {\tt Pri:} The local Candidate-BSR priority for the zone
  (if the router is configured as a Candidate-BSR).

  \item {\tt State:} The state of the per-scope-zone state machine.
  In the above example, the router is configured as a Candidate-BSR, 
  but it is not the elected BSR, hence its state is {\tt Candidate}.

  \item {\tt Timeout:} The number of seconds until the BSR times-out.
  If it is -1, it will never timeout.

  \item {\tt SZTimeout:} The number of seconds until the scoped zone
  times-out. If it is -1, it will never timeout.

\end{itemize}

The {\stt show pim bootstrap rps} command can be used to display
information about Candidate RP information received by the Bootstrap
mechanism:

\vspace{0.1in}
\noindent\framebox[\textwidth][l]{\scriptsize
\begin{minipage}{6in}
\begin{alltt}
\begin{tabbing}
xxxxxxxxxxxxxxxx\=xxxx\=xxxx\=x\=xxx\=xxxxxxxxxxxx\=xxxxxxxxxxx\=xxxxxxxxxxxxxx\=\kill
user@hostname> \textbf{show pim bootstrap rps}\\
Active RPs:\\
RP              \>Pri \>Timeout \>\>\>GroupPrefix        \>BSR             \>CandRpAdvTimeout\\
10.4.0.1        \>192     \>\>148 \>\>224.0.0.0/4        \>10.4.0.1
    \>\>-1\\
10.2.0.2        \>192     \>\>148 \>\>224.0.0.0/4        \>10.4.0.1                  \>\>-1\\
Expiring RPs:\\
RP              \>Pri \>Timeout \>\>\>GroupPrefix        \>BSR             \>CandRpAdvTimeout\\
Configured RPs:\\
RP              \>Pri \>Timeout \>\>\>GroupPrefix        \>BSR             \>CandRpAdvTimeout\\
10.2.0.2        \>192      \>\>\>-1 \>224.0.0.0/4        \>10.2.0.2                      \>\>58
\end{tabbing}
\end{alltt}
\end{minipage}
}
\vspace{0.1in}

The Candidate RPs information is separated in three sections:
\begin{itemize}

  \item {\tt Active RPs:} This section contains the Candidate RPs that are
  currently in use.

  \item {\tt Expiring RPs:} If new bootstrap information is received and it
  replaces the old bootstrap information, the old information is deleted.
  However, if some of the old bootstrap information was not replaced,
  the Candidate RPs contained in that information are moved to the {\tt
  Expiring RPs} section until they time-out.

  \item {\tt Configured RPs:} This section contains the Candidate RP
  information that is configured on the router.
\end{itemize}

The fields for each entry (in order of appearance) are:
\begin{itemize}
  \item {\tt RP:} The address of the Candidate RP for the entry.

  \item {\tt Pri:} The priority of the Candidate RP.

  \item {\tt Timeout:} The number of seconds until the Candidate RP times-out.
  If it is -1, it will never timeout.

  \item {\tt GroupPrefix:} The multicast group prefix address the Candidate RP
  is advertising.

  \item {\tt BSR:} The address of the BSR that advertised this Candidate RP.

  \item {\tt CandRpAdvTimeout:} The number of seconds until the Candidate RP
  is advertised to the BSR. This applies only for the Candidate-RPs
  configured in this router.
  If it is -1, the Candidate RP is not advertised to the BSR.

\end{itemize}

\subsection{Monitoring PIM-SM Interface Information}

The {\stt show pim interface} command can be used to display
information about PIM network interfaces:

\vspace{0.1in}
\noindent\framebox[\textwidth][l]{\scriptsize
\begin{minipage}{6in}
\begin{alltt}
\begin{tabbing}
xxxxxxxxxxxxx\=xxxxxxxxx\=xxxxxxx\=xx\=xxxxxxxxx\=xxxxxxx\=xx\=xxxxxxxxxxxxxxx\=xxxxxxxx\=\kill
user@hostname> \textbf{show pim interface}\\
Interface    \>State    \>Mode   \>V \>PIMstate \>Priority \>\>DRaddr          \>Neighbors\\
dc1          \>UP       \>Sparse \>2 \>NotDR           \>\>1 \>10.3.0.2                \>\>1\\
dc2          \>UP       \>Sparse \>2 \>DR              \>\>1 \>10.2.0.2                \>\>0\\
register\_vif \>UP       \>Sparse \>2 \>DR              \>\>1 \>10.3.0.1                \>\>0
\end{tabbing}
\end{alltt}
\end{minipage}
}
\vspace{0.1in}

The fields for each entry (in order of appearance) are:
\begin{itemize}

  \item {\tt Interface:} The name of the interface.

  \item {\tt State:} The state of the interface. E.g. {\tt UP}, {\tt DOWN},
  {\tt DISABLED}, etc.

  \item {\tt Mode:} The PIM mode of the interface. E.g. {\tt Sparse} means
  PIM-SM.

  \item {\tt V:} The protocol version.

  \item {\tt PIMstate:} The protocol state on that interface. E.g., {\tt DR}
  means the router is the Designated Router on that interface.

  \item {\tt Priority:} The configured Designated Router priority on that
  interface.

  \item {\tt DRaddr:} The address of the elected Designated Router on the
  subnet connected to that interface.

  \item {\tt Neighbors:} The number of PIM neighbor routers on that interface.

\end{itemize}

The {\stt show pim interface address} command can be used to display
address information about PIM network interfaces:

\vspace{0.1in}
\noindent\framebox[\textwidth][l]{\scriptsize
\begin{minipage}{6in}
\begin{alltt}
\begin{tabbing}
xxxxxxxxxxxxx\=xxxxxxxxxxxxxxxx\=xxxxxxxxxxxxxxxx\=\kill
user@hostname> \textbf{show pim interface address}\\
Interface    \>PrimaryAddr     \>DomainWideAddr  \>SecondaryAddr  \\
dc1          \>10.3.0.1        \>10.3.0.1                       \\
dc2          \>10.2.0.2        \>10.2.0.2                       \\
register\_vif\>10.3.0.1        \>10.3.0.1                       \\
\end{tabbing}
\end{alltt}
\end{minipage}
}
\vspace{0.1in}

The fields for each entry (in order of appearance) are:
\begin{itemize}

  \item {\tt Interface:} The name of the interface.

  \item {\tt PrimaryAddr:} The primary address on the interface.

  \item {\tt DomainWideAddr:} The domain-wide address on the interface.

  \item {\tt SecondaryAddr:} The first secondary address on the interface
  (if any). If there is more than one secondary address on the interface,
  they are printed one per new line (in the same column).

\end{itemize}

\newpage
\subsection{Monitoring PIM-SM Multicast Routing State Information}

The {\stt show pim join} command can be used to display
information about PIM multicast routing state:

\vspace{0.1in}
\noindent\framebox[\textwidth][l]{\scriptsize
\begin{minipage}{6in}
\begin{alltt}
\begin{tabbing}
xxxx\=xxxxxxxxxxxx\=xxxxxxxxxxxxxxx\=x\=xxxxxxxxxxxxxx\=\kill
user@hostname> \textbf{show pim join}\\
Group           \>\>Source          \>\>RP              \>Flags\\
224.0.1.20      \>\>0.0.0.0         \>\>10.2.0.2        \>WC   \\
    \>Upstream interface (RP):   \>\>register\_vif\\
    \>Upstream MRIB next hop (RP): UNKNOWN\\
    \>Upstream RPF'(*,G):        \>\>UNKNOWN\\
    \>Upstream state:            \>\>Joined \\
    \>Join timer:                \>\>21\\
    \>Local receiver include WC: \>\>.O.\\
    \>Joins RP:                  \>\>...\\
    \>Joins WC:                  \>\>...\\
    \>Join state:                \>\>...\\
    \>Prune state:               \>\>...\\
    \>Prune pending state:       \>\>...\\
    \>I am assert winner state:  \>\>...\\
    \>I am assert loser state:   \>\>...\\