<p>pespin has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.osmocom.org/c/osmo-bsc/+/25087">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">doc: Improve ACC ramp documentation<br><br>Commit below added support for ACC ramping based on channel load, but<br>documentation was not updated with it.<br><br>Fixes: 1e5e7004dc7987b23f5791366efdf374675e346b<br>Change-Id: I8701386b35ccdebfc843fd00535091648e52f739<br>---<br>M doc/manuals/chapters/bts.adoc<br>1 file changed, 24 insertions(+), 10 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://gerrit.osmocom.org:29418/osmo-bsc refs/changes/87/25087/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/doc/manuals/chapters/bts.adoc b/doc/manuals/chapters/bts.adoc</span><br><span>index 1a693f9..ab4e493 100644</span><br><span>--- a/doc/manuals/chapters/bts.adoc</span><br><span>+++ b/doc/manuals/chapters/bts.adoc</span><br><span>@@ -470,23 +470,35 @@</span><br><span> <2> Rotate the generated permanent list subsets every 20 seconds in a fair fashion</span><br><span> </span><br><span> Furthermore, cells with large number of subscribers and limited overlapping</span><br><span style="color: hsl(0, 100%, 40%);">-coverage may become overwhelmed with traffic after the cell starts brodacasting.</span><br><span style="color: hsl(120, 100%, 40%);">+coverage may become overwhelmed with traffic after the cell starts broadcasting.</span><br><span> This is especially true in areas with little to no reception from other</span><br><span> networks. To manage the load, OsmoBSC has an option to further restrict the</span><br><span> rotating ACC subset during startup and slowly increment it over time and taking</span><br><span style="color: hsl(0, 100%, 40%);">-current load into account.</span><br><span style="color: hsl(120, 100%, 40%);">+current channel load into account.</span><br><span style="color: hsl(120, 100%, 40%);">+The channel load will actually be checked always, even after start up procedure,</span><br><span style="color: hsl(120, 100%, 40%);">+at an interval specified by `access-control-class-ramping-step-interval` VTY</span><br><span style="color: hsl(120, 100%, 40%);">+command, and will either keep, increase or decrease the size of the current</span><br><span style="color: hsl(120, 100%, 40%);">+rotating ACC subset based on certain thresholds configured by</span><br><span style="color: hsl(120, 100%, 40%);">+`access-control-class-ramping-chan-load` VTY command.</span><br><span style="color: hsl(120, 100%, 40%);">+As a result, if ACC ramping is enabled (`access-control-class-ramping`), the</span><br><span style="color: hsl(120, 100%, 40%);">+number of concurrent allowed ACCs will start with *1* and will fluctuate over</span><br><span style="color: hsl(120, 100%, 40%);">+time based on channel load in the interval *[1, `access-control-rotate`]*. This</span><br><span style="color: hsl(120, 100%, 40%);">+means at any time there will be at least *1* allowed ACC which, together with</span><br><span style="color: hsl(120, 100%, 40%);">+ACC rotation, will prevent from subscriber being unable to use the network.</span><br><span> </span><br><span> .Example: Ramp up access to the BTS after startup</span><br><span> ----</span><br><span> network</span><br><span>  bts 0</span><br><span>   access-control-class-ramping <1></span><br><span style="color: hsl(0, 100%, 40%);">-  access-control-class-ramping-step-interval 30 <2></span><br><span style="color: hsl(0, 100%, 40%);">-  access-control-class-ramping-step-size 1 <3></span><br><span style="color: hsl(120, 100%, 40%);">+  access-control-class-ramping-step-size 1 <2></span><br><span style="color: hsl(120, 100%, 40%);">+  access-control-class-ramping-step-interval 30 <3></span><br><span style="color: hsl(120, 100%, 40%);">+  access-control-class-ramping-chan-load 71 89 <7></span><br><span> ----</span><br><span> <1> Turn on access-control-class ramping</span><br><span style="color: hsl(0, 100%, 40%);">-<2> Enable more ACCs every 30 seconds</span><br><span style="color: hsl(0, 100%, 40%);">-<3> At each step enable one more ACC</span><br><span style="color: hsl(120, 100%, 40%);">+<2> At each step enable one more ACC</span><br><span style="color: hsl(120, 100%, 40%);">+<3> Check whether to allow more/less ACCs every 30 seconds</span><br><span style="color: hsl(120, 100%, 40%);">+<4> The rotate subset size is increased if channel load is < 71%, and decreased if channel load is > 89%.</span><br><span> </span><br><span> </span><br><span> Here a full example of all the mechanisms combined can be found:</span><br><span>@@ -503,14 +515,16 @@</span><br><span>   access-control-class-rotate-quantum 20 <3></span><br><span>   access-control-class-ramping <4></span><br><span>   access-control-class-ramping-step-size 1 <5></span><br><span style="color: hsl(0, 100%, 40%);">-  access-control-class-ramping-step-interval dynamic <6></span><br><span style="color: hsl(120, 100%, 40%);">+  access-control-class-ramping-step-interval 30 <6></span><br><span style="color: hsl(120, 100%, 40%);">+  access-control-class-ramping-chan-load 71 89 <7></span><br><span> ----</span><br><span> <1> ACCs 5-9 are administratively barred, ie they will never be used until somebody manually enables them in VTY config</span><br><span> <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.</span><br><span> <3> Each subset iteration will happen every 20 seconds</span><br><span style="color: hsl(0, 100%, 40%);">-<4> During startup since ramping is enabled, it will further restrict the rotate subset size parameter (len=3)</span><br><span style="color: hsl(0, 100%, 40%);">-<5> The rotate subset size parameter will be increased one ACC slot at a time: len=0 -> len=1 -> len=2 -> len=3</span><br><span style="color: hsl(0, 100%, 40%);">-<6> The time until the subset size is further increased will be calculated based on current channel load</span><br><span style="color: hsl(120, 100%, 40%);">+<4> Ramping is enabled: during startup it will further restrict the rotate subset size parameter (start at len=1, end at len=3)</span><br><span style="color: hsl(120, 100%, 40%);">+<5> The rotate subset size parameter will be increased or decreased one ACC slot at a time: len=1 -> len=2 -> len=3</span><br><span style="color: hsl(120, 100%, 40%);">+<6> The time until the subset size is further increased or decreased based on current channel load check (in seconds)</span><br><span style="color: hsl(120, 100%, 40%);">+<7> The rotate subset size is increased if channel load is < 71%, and decreased if channel load is > 89%.</span><br><span> </span><br><span> === Configuring FACCH/SACCH repetition</span><br><span> </span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/c/osmo-bsc/+/25087">change 25087</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.osmocom.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://gerrit.osmocom.org/c/osmo-bsc/+/25087"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: osmo-bsc </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-Change-Id: I8701386b35ccdebfc843fd00535091648e52f739 </div>
<div style="display:none"> Gerrit-Change-Number: 25087 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: pespin <pespin@sysmocom.de> </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>