pespin submitted this change.

View Change

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(-)

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>

To view, visit change 43760. To unsubscribe, or for help writing mail filters, visit settings.