pespin submitted this change.

View Change

Approvals:
  jolly: Looks good to me, but someone else must approve
  Jenkins Builder: Verified
  osmith: Looks good to me, approved

sigtran: Document xUA Server Administrative State

Related: OS#7039
Change-Id: I771f05d2ef001f78cbd4d6fcd585535a841366ea
---
M common/chapters/cs7-config.adoc
M common/chapters/sigtran-osmocom.adoc
M common/chapters/sigtran.adoc
3 files changed, 10 insertions(+), 0 deletions(-)

diff --git a/common/chapters/cs7-config.adoc b/common/chapters/cs7-config.adoc
index afc30af..8d3dbe7 100644
--- a/common/chapters/cs7-config.adoc
+++ b/common/chapters/cs7-config.adoc
@@ -422,6 +422,7 @@
  listen m3ua 2905
   accept-asp-connections pre-configured
   local-ip 2.2.2.2
+  no shutdown
 
  # asp <name> <remote-port> <local-port|0> m3ua
  asp mybsc-0 2905 2905 m3ua
@@ -487,6 +488,7 @@
  listen m3ua 2905
   accept-asp-connections dynamic-permitted
   local-ip 2.2.2.2
+  no shutdown
 ----
 
 .osmo-msc.cfg
diff --git a/common/chapters/sigtran-osmocom.adoc b/common/chapters/sigtran-osmocom.adoc
index fa02694..9cd873c 100644
--- a/common/chapters/sigtran-osmocom.adoc
+++ b/common/chapters/sigtran-osmocom.adoc
@@ -306,10 +306,17 @@
 |Local IP|Local Port Number to which the server shall bind/listen
 |Local Port|Local IP Address to which the server shall bind/listen
 |Protocol|Protocol (M3UA, SUA, IPA) to be operated by this server
+|Administrative State|Whether the listener transport socket (TCP/SCTP) is listening for clients to connect to, or closed.
 |Accept Dynamic ASPs|Should we accept connections from ASPs that are not explicitly pre-configured with their source IP and port?
 |QoS Class|QoS Class the server will apply to incoming connections
 |====
 
+The user can change the administrative state of a given xUA Server at any time
+by means of the _[no] shutdown_ VTY commands. When in _shutdown_ state, the xUA
+Server has its listen socket closed so no clients can connect to it. This is
+useful to temporarily disable access to a xUA Server and hence new incoming
+connections to related ASPs. Shutting down a xUA Server does't release already
+established connections on related ASPs; it only affects new connections.
 
 === Osmocom SS7 Users
 
diff --git a/common/chapters/sigtran.adoc b/common/chapters/sigtran.adoc
index 115c3fc..b691436 100644
--- a/common/chapters/sigtran.adoc
+++ b/common/chapters/sigtran.adoc
@@ -477,6 +477,7 @@
   sctp-param init num-ostreams 250 <1>
   sctp-param init max-instreams 300 <2>
   ...
+  no shutdown
 ----
 <1> Announce to the server that up to 250 outbound SCTP streams (server to
 client) may be requested. This value is transmitted during SCTP INIT packet, and

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