Change in osmo-bsc[master]: doc/mgwpool: update documentation

This is merely a historical archive of years 2008-2021, before the migration to mailman3.

A maintained and still updated list archive can be found at https://lists.osmocom.org/hyperkitty/list/gerrit-log@lists.osmocom.org/.

dexter gerrit-no-reply at lists.osmocom.org
Wed Sep 15 10:04:47 UTC 2021


dexter has submitted this change. ( https://gerrit.osmocom.org/c/osmo-bsc/+/25448 )

Change subject: doc/mgwpool: update documentation
......................................................................

doc/mgwpool: update documentation

The mgw-pool now allows to set a decription for each MGW /MGCP client
instance. Update the documentation so that it reflects the current
state.

Change-Id: I3026e027bba1a9a12ceca64e96df993b5957cb1d
Related: SYS#5091
---
M doc/manuals/chapters/mgwpool.adoc
1 file changed, 23 insertions(+), 14 deletions(-)

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



diff --git a/doc/manuals/chapters/mgwpool.adoc b/doc/manuals/chapters/mgwpool.adoc
index 7d9e9a6..2221925 100644
--- a/doc/manuals/chapters/mgwpool.adoc
+++ b/doc/manuals/chapters/mgwpool.adoc
@@ -47,12 +47,14 @@
 Example configuration with two MGCP-Client instances in a pool:
 ----
  mgw 0
+  description media-gw-0 <2>
   mgw remote-ip 127.0.0.1
   mgw remote-port 2432
   mgw local-ip 127.0.0.1
   mgw local-port 2431
   mgw endpoint-domain mgw0 <1>
  mgw 1
+  description media-gw-1 <2>
   mgw remote-ip 127.0.0.1
   mgw remote-port 2430
   mgw local-ip 127.0.0.1
@@ -65,6 +67,10 @@
 endpoint names in the log. It should also be noted that the domain name must
 match the configuration of the related OsmoMGW instance.
 
+<2> It is also possible to assign a descriptive name to each MGW instance. The
+MGCP client specific log lines will then use this name as logging context. If
+no description is set, the domain name will be used.
+
 === MGW pool management
 
 While it was not possible to change the MGCP-Client configuration under the
@@ -80,11 +86,11 @@
 ----
 OsmoBSC> show mgw-pool
 % MGW-Pool:
-%  MGW 0
+%  MGW 0:media-gw-0
 %   mgcp-client:   connected
 %   service:       unblocked
 %   ongoing calls: 1
-%  MGW 1
+%  MGW 1:media-gw-1
 %   mgcp-client:   connected
 %   service:       unblocked
 %   ongoing calls: 0
@@ -116,20 +122,23 @@
 
 ----
 % MGW-Pool:
-%  MGW 0
+%  MGW 0:media-gw-0
 %   mgcp-client:   connected
 %   service:       unblocked
 %   ongoing calls: 2
-%  MGW 1
+%  MGW 1:media-gw-1
 %   mgcp-client:   connected
 %   service:       unblocked
 %   ongoing calls: 3
-%  MGW 2
+%  MGW 2:mgw <1>
 %   mgcp-client:   disconnected
 %   service:       unblocked
 %   ongoing calls: 0
 ----
 
+<1> In this example a description is not set yet, so the domain name ("mgw")
+is displayed.
+
 ==== Reconnecting an MGW / MGCP-Client
 
 It may become necessary to reconnect an MGCP-Client. This is the case when the
@@ -149,15 +158,15 @@
 ----
 OsmoBSC# show mgw-pool
 % MGW-Pool:
-%  MGW 0
+%  MGW 0:media-gw-0
 %   mgcp-client:   connected
 %   service:       unblocked
 %   ongoing calls: 2
-%  MGW 1
+%  MGW 1:media-gw-1
 %   mgcp-client:   connected
 %   service:       unblocked
 %   ongoing calls: 3
-%  MGW 2
+%  MGW 2:mgw
 %   mgcp-client:   connected
 %   service:       unblocked
 %   ongoing calls: 0
@@ -191,15 +200,15 @@
 OsmoBSC# mgw 2 block
 OsmoBSC# show mgw-pool
 % MGW-Pool:
-%  MGW 0
+%  MGW 0:media-gw-0
 %   mgcp-client:   connected
 %   service:       unblocked
 %   ongoing calls: 11
-%  MGW 1
+%  MGW 1:media-gw-1
 %   mgcp-client:   connected
 %   service:       unblocked
 %   ongoing calls: 12
-%  MGW 2
+%  MGW 2:mgw
 %   mgcp-client:   connected
 %   service:       blocked
 %   ongoing calls: 10
@@ -211,15 +220,15 @@
 ----
 OsmoBSC# show mgw-pool
 % MGW-Pool:
-%  MGW 0
+%  MGW 0:media-gw-0
 %   mgcp-client:   connected
 %   service:       unblocked
 %   ongoing calls: 15
-%  MGW 1
+%  MGW 1:media-gw-1
 %   mgcp-client:   connected
 %   service:       unblocked
 %   ongoing calls: 14
-%  MGW 2
+%  MGW 2:mgw
 %   mgcp-client:   connected
 %   service:       blocked
 %   ongoing calls: 0

-- 
To view, visit https://gerrit.osmocom.org/c/osmo-bsc/+/25448
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings

Gerrit-Project: osmo-bsc
Gerrit-Branch: master
Gerrit-Change-Id: I3026e027bba1a9a12ceca64e96df993b5957cb1d
Gerrit-Change-Number: 25448
Gerrit-PatchSet: 2
Gerrit-Owner: dexter <pmaier at sysmocom.de>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: dexter <pmaier at sysmocom.de>
Gerrit-Reviewer: osmith <osmith at sysmocom.de>
Gerrit-Reviewer: pespin <pespin at sysmocom.de>
Gerrit-MessageType: merged
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osmocom.org/pipermail/gerrit-log/attachments/20210915/43bc4c47/attachment.htm>


More information about the gerrit-log mailing list