Change in osmo-bsc[master]: doc: Improve ACC ramp 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/.

laforge gerrit-no-reply at lists.osmocom.org
Thu Aug 19 14:50:02 UTC 2021


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

Change subject: doc: Improve ACC ramp documentation
......................................................................

doc: Improve ACC ramp documentation

Commit below added support for ACC ramping based on channel load, but
documentation was not updated with it.

Fixes: 1e5e7004dc7987b23f5791366efdf374675e346b
Change-Id: I8701386b35ccdebfc843fd00535091648e52f739
---
M doc/manuals/chapters/bts.adoc
1 file changed, 24 insertions(+), 10 deletions(-)

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



diff --git a/doc/manuals/chapters/bts.adoc b/doc/manuals/chapters/bts.adoc
index 1a693f9..4662c1a 100644
--- a/doc/manuals/chapters/bts.adoc
+++ b/doc/manuals/chapters/bts.adoc
@@ -470,23 +470,35 @@
 <2> Rotate the generated permanent list subsets every 20 seconds in a fair fashion
 
 Furthermore, cells with large number of subscribers and limited overlapping
-coverage may become overwhelmed with traffic after the cell starts brodacasting.
+coverage may become overwhelmed with traffic after the cell starts broadcasting.
 This is especially true in areas with little to no reception from other
 networks. To manage the load, OsmoBSC has an option to further restrict the
 rotating ACC subset during startup and slowly increment it over time and taking
-current load into account.
+current channel load into account.
+The channel load will always be checked, even after the start up procedure, at
+an interval specified by the `access-control-class-ramping-step-interval` VTY
+command. It will either keep, increase or decrease the size of the current
+rotating ACC subset based on certain thresholds configured by
+the `access-control-class-ramping-chan-load` VTY command.
+As a result, if ACC ramping is enabled (`access-control-class-ramping`), the
+number of concurrent allowed ACCs will start with *1* and will fluctuate over
+time based on channel load in the interval *[1, `access-control-rotate`]*. This
+means at any time there will be at least *1* allowed ACC which, together with
+ACC rotation, will prevent from subscriber being unable to use the network.
 
 .Example: Ramp up access to the BTS after startup
 ----
 network
  bts 0
   access-control-class-ramping <1>
-  access-control-class-ramping-step-interval 30 <2>
-  access-control-class-ramping-step-size 1 <3>
+  access-control-class-ramping-step-size 1 <2>
+  access-control-class-ramping-step-interval 30 <3>
+  access-control-class-ramping-chan-load 71 89 <4>
 ----
 <1> Turn on access-control-class ramping
-<2> Enable more ACCs every 30 seconds
-<3> At each step enable one more ACC
+<2> At each step enable one more ACC
+<3> Check whether to allow more/less ACCs every 30 seconds
+<4> The rotate subset size is increased if channel load is < 71%, and decreased if channel load is > 89%.
 
 
 Here a full example of all the mechanisms combined can be found:
@@ -503,14 +515,16 @@
   access-control-class-rotate-quantum 20 <3>
   access-control-class-ramping <4>
   access-control-class-ramping-step-size 1 <5>
-  access-control-class-ramping-step-interval dynamic <6>
+  access-control-class-ramping-step-interval 30 <6>
+  access-control-class-ramping-chan-load 71 89 <7>
 ----
 <1> ACCs 5-9 are administratively barred, ie they will never be used until somebody manually enables them in VTY config
 <2> Allow access through temporary subsets of len=3 from ACC set 0-4: (0,1,2) -> (1,2,3) -> (2,3,4) -> (3,4,0), etc.
 <3> Each subset iteration will happen every 20 seconds
-<4> During startup since ramping is enabled, it will further restrict the rotate subset size parameter (len=3)
-<5> The rotate subset size parameter will be increased one ACC slot at a time: len=0 -> len=1 -> len=2 -> len=3
-<6> The time until the subset size is further increased will be calculated based on current channel load
+<4> Ramping is enabled: during startup it will further restrict the rotate subset size parameter (start at len=1, end at len=3)
+<5> The rotate subset size parameter will be increased or decreased one ACC slot at a time: len=1 -> len=2 -> len=3
+<6> Check to further increase or decrease the rotate subset size based on current channel load is triggered every 30 seconds
+<7> The rotate subset size is increased if channel load is < 71%, and decreased if channel load is > 89%.
 
 === Configuring FACCH/SACCH repetition
 

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

Gerrit-Project: osmo-bsc
Gerrit-Branch: master
Gerrit-Change-Id: I8701386b35ccdebfc843fd00535091648e52f739
Gerrit-Change-Number: 25087
Gerrit-PatchSet: 4
Gerrit-Owner: pespin <pespin at sysmocom.de>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: dexter <pmaier at sysmocom.de>
Gerrit-Reviewer: laforge <laforge at osmocom.org>
Gerrit-Reviewer: osmith <osmith at sysmocom.de>
Gerrit-MessageType: merged
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osmocom.org/pipermail/gerrit-log/attachments/20210819/5daadce4/attachment.htm>


More information about the gerrit-log mailing list