pespin has uploaded this change for review.

View Change

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, 11 insertions(+), 0 deletions(-)

git pull ssh://gerrit.osmocom.org:29418/osmo-gsm-manuals refs/changes/59/43759/1

diff --git a/common/chapters/cs7-config.adoc b/common/chapters/cs7-config.adoc
index 6f212b2..8e66db5 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 32d03cf..247cb3d 100644
--- a/common/chapters/sigtran-osmocom.adoc
+++ b/common/chapters/sigtran-osmocom.adoc
@@ -298,6 +298,13 @@
 long as they all run on a different combination of IP address and
 port.
 
+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.
+
 .Major Attributes of an Osmocom SS7 xUA Server
 [options="header",cols="25%,75%"]
 |====
@@ -305,6 +312,7 @@
 |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?
 |====
 
diff --git a/common/chapters/sigtran.adoc b/common/chapters/sigtran.adoc
index c8e9b99..47c5ddd 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.