pespin has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-gsm-manuals/+/43759?usp=email )
Change subject: sigtran: Document xUA Server Administrative State ......................................................................
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