pespin has submitted this change. ( https://gerrit.osmocom.org/c/osmo-gsm-manuals/+/43760?usp=email )
Change subject: sigtran: Document ASP administrative state ......................................................................
sigtran: Document ASP administrative state
Related: OS#6752 Change-Id: I355f382857b62a42b4752689d27a34c668c7e996 --- M common/chapters/cs7-config.adoc M common/chapters/sigtran-osmocom.adoc M common/chapters/sigtran.adoc 3 files changed, 31 insertions(+), 0 deletions(-)
Approvals: Jenkins Builder: Verified osmith: Looks good to me, but someone else must approve pespin: Looks good to me, approved
diff --git a/common/chapters/cs7-config.adoc b/common/chapters/cs7-config.adoc index 8d3dbe7..6d5b86e 100644 --- a/common/chapters/cs7-config.adoc +++ b/common/chapters/cs7-config.adoc @@ -52,6 +52,7 @@ remote-ip 127.0.0.1 role asp transport-role client + no shutdown as as-clnt-OsmoMSC-A-Iu m3ua asp asp-clnt-OsmoMSC-A-Iu routing-key 2 0.23.1 @@ -89,6 +90,7 @@ local-ip 10.9.8.7 role asp transport-role client + no shutdown ----
Be aware that such an `asp` needs to be linked to an `as`, see <<as_and_asp>>. @@ -240,6 +242,7 @@ remote-ip 127.0.0.1 role asp transport-role client + no shutdown as my-as m3ua asp my-asp ---- @@ -257,6 +260,7 @@ remote-ip 127.0.0.1 role asp transport-role client + no shutdown as my-as m3ua routing-key 2 0.23.1 ---- @@ -269,6 +273,7 @@ remote-ip 127.0.0.1 role asp transport-role client + no shutdown as my-as m3ua asp my-asp routing-key 2 0.23.1 @@ -403,6 +408,7 @@ remote-ip 2.2.2.2 local-ip 1.1.1.1 transport-role client + no shutdown as mybsc0 m3ua asp mybsc0-0 routing-key 1 1.1.1 @@ -428,6 +434,7 @@ asp mybsc-0 2905 2905 m3ua remote-ip 1.1.1.1 local-ip 2.2.2.2 + no shutdown as mybsc m3ua asp bsc-0 routing-key 1 1.1.1 @@ -435,6 +442,7 @@ asp mymsc-0 2905 2905 m3ua remote-ip 3.3.3.3 local-ip 2.2.2.2 + no shutdown as mymsc m3ua asp mymsc-0 routing-key 3 3.3.3 @@ -453,6 +461,7 @@ remote-ip 2.2.2.2 local-ip 3.3.3.3 transport-role client + no shutdown as mymsc0 m3ua asp mymsc0-0 routing-key 3 3.3.3 @@ -470,6 +479,7 @@ remote-ip 2.2.2.2 local-ip 1.1.1.1 transport-role client + no shutdown as mybsc0 m3ua asp mybsc0-0
@@ -500,6 +510,7 @@ remote-ip 2.2.2.2 local-ip 3.3.3.3 transport-role client + no shutdown as mymsc0 m3ua asp mymsc0-0 ---- diff --git a/common/chapters/sigtran-osmocom.adoc b/common/chapters/sigtran-osmocom.adoc index 9cd873c..154f5a8 100644 --- a/common/chapters/sigtran-osmocom.adoc +++ b/common/chapters/sigtran-osmocom.adoc @@ -386,9 +386,25 @@ |Remote Port|Port Number of the remote end of the connection |Remote IP|IP Address of the remote end of the connection |State|ASP State (Down, Inactive, Active) +|Administrative State|ASP Administrative State ([no] shutdown, [no] block) |QoS Class|QoS Class to apply to this connection |====
+The user can change the administrative state of a given ASP at any time by means +of VTY commands (defaults are _no shutdown_ and _no block_): + +* _[no] shutdown_: When an ASP is set to the _shutdown_ administrative state, +its transport layer socket is closed and new ones are forbidden until the +administrative state is switched back again. If the ASP transport role is +_client_, no further reconnects will be attempeted. If the ASP transport is +_server_, new incoming connections matching the ASP will be rejected at socket +accept time. + +* _[no] block_: When an ASP is set to the _block_ administrative state, its +transport layer socket is manintained, but the ASP is moved to _Inactive_ state, +and further ACTIVATE attempts are rejected until the administrative state is +switched back again. + === Osmocom SS7 Routes
An Osmocom SS7 Route holds information to route traffic with a matching diff --git a/common/chapters/sigtran.adoc b/common/chapters/sigtran.adoc index b691436..b66dd7c 100644 --- a/common/chapters/sigtran.adoc +++ b/common/chapters/sigtran.adoc @@ -390,6 +390,7 @@ remote-ip 10.11.12.13 remote-ip 16.17.18.19 primary <1> ... + no shutdown ---- <1> Use 16.17.18.19 as primary address for the SCTP association. User data will be in general transmitted over this path. @@ -414,6 +415,7 @@ local-ip 10.11.12.13 local-ip 16.17.18.19 primary <1> ... + no shutdown ---- <1> Announce 16.17.18.19 to the peer as the primary address to be used when transmitting user data to us. @@ -459,6 +461,7 @@ sctp-param init max-attempts 3 <3> sctp-param init timeout 10000 <4> ... + no shutdown ---- <1> The number of streams from the server to the client. This value is transmitted during SCTP INIT ACK packet. @@ -473,6 +476,7 @@ cs7 instance 0 asp my-asp 2905 0 m3ua transport-role server + no shutdown listen m3ua 2905 sctp-param init num-ostreams 250 <1> sctp-param init max-instreams 300 <2>