https://projects.osmocom.org/https://projects.osmocom.org/favicon.ico?16647414092016-08-01T12:30:29ZOpen Source Mobile CommunicationsCellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=20012016-08-01T12:30:29Zlaforge
<ul><li><strong>Priority</strong> changed from <i>Normal</i> to <i>High</i></li></ul> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=20332016-08-09T15:01:07Zlaforge
<ul></ul><p>for example, we have the following partial redundant info:</p>
<ul>
<li><a class="external" href="https://osmocom.org/projects/cellular-infrastructure/wiki/SDR_OsmoTRX_network_from_scratch">https://osmocom.org/projects/cellular-infrastructure/wiki/SDR_OsmoTRX_network_from_scratch</a></li>
<li><a class="external" href="https://osmocom.org/projects/cellular-infrastructure/wiki/OpenBSC_LCR_Ubuntu1204">https://osmocom.org/projects/cellular-infrastructure/wiki/OpenBSC_LCR_Ubuntu1204</a></li>
<li><a class="external" href="https://osmocom.org/projects/cellular-infrastructure/wiki/OpenBSC_GPRS">https://osmocom.org/projects/cellular-infrastructure/wiki/OpenBSC_GPRS</a></li>
<li><a class="external" href="https://osmocom.org/projects/cellular-infrastructure/wiki/Ettus_USRP_B2xx_family">https://osmocom.org/projects/cellular-infrastructure/wiki/Ettus_USRP_B2xx_family</a></li>
<li><a class="external" href="https://osmocom.org/projects/osmonitb/wiki/OsmoNITB_LCR">https://osmocom.org/projects/osmonitb/wiki/OsmoNITB_LCR</a>
<ul>
<li>only keep lcr related part</li>
</ul>
</li>
<li><a class="external" href="https://osmocom.org/projects/cellular-infrastructure/wiki/OpenBSC_with_Asterisk">https://osmocom.org/projects/cellular-infrastructure/wiki/OpenBSC_with_Asterisk</a>
<ul>
<li>only keep asterisk related part, probably builds on LCR part above</li>
<li>mention that this is obsolete and osmo-sip-connector should be used (BOLD NOTICE)</li>
</ul>
</li>
<li><a class="external" href="https://osmocom.org/projects/openbsc/wiki/Building_OpenBSC">https://osmocom.org/projects/openbsc/wiki/Building_OpenBSC</a>
<ul>
<li>always refer to nightly debian packages as better alternative for non-developers</li>
</ul>
</li>
<li>manuals from manuals.git</li>
</ul>
Let's split in:
<ul>
<li>one page about installing the software (from nightly debian feed, alternatively compilation from source)</li>
<li>configuration, possibly containing references to the manual whenever appropriate</li>
</ul> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=20572016-08-17T15:57:30Zlaforge
<ul><li><strong>Assignee</strong> deleted (<del><i>127</i></del>)</li></ul> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=21892016-10-11T09:11:00Zlaforge
<ul><li><strong>Assignee</strong> set to <i>dexter</i></li></ul> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=22262016-10-12T15:36:55Zdexter
<ul></ul><p>Before starting wildly editing the Wiki I wanted to share my thoughts:</p>
<p>I look at <a class="external" href="http://osmocom.org/projects/cellular-infrastructure/wiki">http://osmocom.org/projects/cellular-infrastructure/wiki</a> I find a short reference page for each product, I also find a link to the manuals there. Why not having another two sections "Installation" for the normal users and "Build instructions" for developers? To me this would be much more logic. The disadvantage would be that the build instructions spread over multiple page. If I need GPRS for example, I have to get the build/install instructions from three different pages. However, this can be compensated by having howtos in the getting started sections that refer to the product pages:</p>
<p>e.g.: <br />Getting started<br />- UnderstandingOpenBSC....<br />- NightlyBuilds....<br />- How to run osmo-nitb with GPRS</p>
<p>Wiki page:<br />How to run osmo-nitb with GPRS</p>
<p>- Please install: OsmoNITB, OsmoSGSN, OpenGGSN<br />- Configure this and that ...<br />- Run ...</p>
<p>We also should have a howto for the most minimal setup so that someone who is new to the project can get some immediate success. This also gives the opportunity to refer to it. It would be like a tutorial, where we start with basics and end up with a fully functional core network with Voip-Dialout and GPRS.</p>
<p>Then there is this second overview page, I believe this is the original old one from the Trac: <a class="external" href="http://osmocom.org/projects/openbsc/wiki">http://osmocom.org/projects/openbsc/wiki</a> I think this is very confusing. Its not clear which directory is the right one. I think we should merge the two and have only one directory. The directory should also be complete in the sense that it also lists the sub-pages, so we can keep the overview and everything would be accessible with one click.</p> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=23692016-11-09T09:29:40Zlaforge
<ul><li><strong>Assignee</strong> changed from <i>dexter</i> to <i>neels</i></li></ul><p>Hi neels,</p>
<p>please take ownership of this ticket and involve wirelesss in the actaul excecution. WE need one set of conscise (and possibly modular?) guides (common parts, bts specific parts). As in my original issue description, building code from source should rather be the exception and described at one location in the wiki, for those people that really want to get to that point.</p>
<p>All reference information should rather be referred to the manuals. The manuals must also be linked at frequent and obvious locations, so people actually find and use them.</p> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=24252016-11-09T16:17:41Zneelsnhofmeyr@sysmocom.de
<ul></ul><p>ack</p> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=24522016-11-13T14:18:09Zneelsnhofmeyr@sysmocom.de
<ul></ul><p><a class="external" href="https://osmocom.org/projects/cellular-infrastructure/wiki/NightlyBuilds">https://osmocom.org/projects/cellular-infrastructure/wiki/NightlyBuilds</a></p> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=24532016-11-13T14:41:00Zneelsnhofmeyr@sysmocom.de
<ul></ul><p>Looking at the Cellular Infrastructure wiki and the various pages, I agree with dexter<br />that a comprehensive rearranging of the wiki structure would be a good idea.</p>
<p>While I can probably incorporate some help from wirelesss here and there, I guess<br />the bulk of this work will remain on my desk, since deep understanding of the<br />components + bigger picture would benefit the end result.</p>
<p>Since I'm also starting on the VLR/HLR task, the question of prioritization remains.<br />I could dedicate a day per month to wiki improvements, for example.</p> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=24952016-11-24T16:34:43Zneelsnhofmeyr@sysmocom.de
<ul><li><strong>% Done</strong> changed from <i>0</i> to <i>30</i></li></ul><p>I've started by adding section <a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/Build_from_Source">Build from Source</a> to generally describe the build process.<br />Still todo: remove duplications of this information in the mentioned older wiki pages,<br />retaining only the specific details for those contexts.</p> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=25142016-11-30T14:55:31Zneelsnhofmeyr@sysmocom.de
<ul><li><strong>Assignee</strong> changed from <i>neels</i> to <i>wirelesss</i></li></ul><p>Todo:</p>
<ul>
<li>For each of above links, remove any information that is already in <a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/Build_from_source">Build from source</a>.</li>
<li>Move information that is also useful elsewhere to <a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/Build_from_source">Build from source</a>.<br /> Keep only that information that is only useful for that wiki page.</li>
<li>Only list <strong>which</strong> projects need to be built, and link to <a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/Build_from_source">Build from source</a>.</li>
<li>For any special settings/issues with a given project, expand the "Details and troubleshooting" <br /> section in <a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/Build_from_source">Build from source</a>.</li>
<li>Possibly add more examples to the bottom of <a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/Build_from_source">Build from source</a>, if that makes sense.</li>
</ul> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=25172016-12-01T18:04:29Zwirelesss
<ul><li><strong>Status</strong> changed from <i>New</i> to <i>In Progress</i></li><li><strong>% Done</strong> changed from <i>30</i> to <i>40</i></li></ul><p>Cleaning of the redundant information from links above is started.</p> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=25242016-12-02T14:11:42Zwirelesss
<ul><li><strong>% Done</strong> changed from <i>40</i> to <i>50</i></li></ul> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=25722016-12-08T11:39:58Zneelsnhofmeyr@sysmocom.de
<ul></ul><p>wirelesss, please update this ticket. Name those pages that are complete.</p> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=25732016-12-08T13:24:13Zwirelesss
<ul></ul><p>Following pages has been completed for review :</p>
<p><a class="external" href="https://osmocom.org/projects/cellular-infrastructure/wiki/SDR_OsmoTRX_network_from_scratch">https://osmocom.org/projects/cellular-infrastructure/wiki/SDR_OsmoTRX_network_from_scratch</a></p>
<p><a class="external" href="https://osmocom.org/projects/cellular-infrastructure/wiki/OpenBSC_LCR_Ubuntu1204">https://osmocom.org/projects/cellular-infrastructure/wiki/OpenBSC_LCR_Ubuntu1204</a></p>
<p><a class="external" href="https://osmocom.org/projects/cellular-infrastructure/wiki/OpenBSC_GPRS">https://osmocom.org/projects/cellular-infrastructure/wiki/OpenBSC_GPRS</a></p>
<p><a class="external" href="https://osmocom.org/projects/cellular-infrastructure/wiki/OpenBSC_with_Asterisk">https://osmocom.org/projects/cellular-infrastructure/wiki/OpenBSC_with_Asterisk</a></p> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=25742016-12-08T14:42:37Zneelsnhofmeyr@sysmocom.de
<ul></ul><p>Take a look at the redmine documentation about the format of links<br />(click the small blue question mark when editing a page)</p>
<pre>
links within redmine, same Project: [[SDR OsmoTRX network from scratch]]
links within redmine, across Projects: [[OsmoTRX:]]
Link to a subsection: [[Build from source#Example-completely-build-openbsc|Example: completely build openbsc]]
external links: http://jenkins.osmocom.org
</pre>
<p>links within redmine, same Project: <a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/SDR_OsmoTRX_network_from_scratch">SDR OsmoTRX network from scratch</a><br />links within redmine, across Projects: <a class="wiki-page" href="https://projects.osmocom.org/projects/osmotrx/wiki">OsmoTRX</a><br />Link to a subsection: <a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/Build_from_source#Example-completely-build-openbsc">Example: completely build openbsc</a><br />external links: <a class="external" href="http://jenkins.osmocom.org">http://jenkins.osmocom.org</a></p>
<a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/SDR_OsmoTRX_network_from_scratch">SDR OsmoTRX network from scratch</a>:
<ul>
<li>Fix at least the links you added/edited.</li>
<li>if you like, also fix the other links that are broken all over that wiki page, shown in red.<br /> They are broken because the migration from trac to redmine composed inaccurate links.</li>
</ul>
In <a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/OpenBSC_LCR_Ubuntu1204">OpenBSC LCR Ubuntu1204</a>:
<ul>
<li>fix link formats</li>
<li>(there was no need to edit the instructions for misdn.git software)</li>
<li>you write only "download following sources as described in <a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/Build_from_source">Build_from_source</a>",<br /> it should say "install", or even "download, build and install".</li>
<li>Where you link to the "build openbsc" example directly: you are instructing the reader<br /> to build openbsc <em>again</em>? Above it already linked to <a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/Build_from_source">Build from source</a>?</li>
</ul>
<p><a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/OpenBSC_GPRS">OpenBSC GPRS</a>: good</p>
<a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/OpenBSC_with_Asterisk">OpenBSC with Asterisk</a>:
<ul>
<li>again fix the link formats</li>
<li>I took the liberty to shorten a sentence.</li>
</ul> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=25752016-12-08T14:46:12Zneelsnhofmeyr@sysmocom.de
<ul></ul><p>In <a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/OpenBSC_with_Asterisk">OpenBSC with Asterisk</a>, I also fixed the order: openbsc depends on libosmocore and libosmo-abis, so it should be on the bottom.<br />Make sure the order reflects dependency in the other wiki pages as well.</p> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=25762016-12-08T15:05:12Zneelsnhofmeyr@sysmocom.de
<ul></ul><p>I also edited <a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/Build_from_source#Build-debian-packages">the Debian Packages section</a> to be more general</p> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=25772016-12-08T16:02:57Zwirelesss
<ul></ul><p>Broken links have been fixed.</p>
<p>Unable to use short format of link: <a class="external" href="https://osmocom.org/projects/osmonitb/wiki/OsmoNITB_LCR">https://osmocom.org/projects/osmonitb/wiki/OsmoNITB_LCR</a> in <a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/OpenBSC_with_Asterisk">OpenBSC with Asterisk</a></p>
<p>and <a class="external" href="https://osmocom.org/projects/openbsc/wiki/Multi-BTS_with_handover">https://osmocom.org/projects/openbsc/wiki/Multi-BTS_with_handover</a> in <a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/SDR_OsmoTRX_network_from_scratch">SDR OsmoTRX network from scratch</a></p>
<p>Redundant information related to building openbsc has been removed.</p> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=25792016-12-08T18:25:21Zwirelesss
<ul></ul>Short format of wiki links found and used in pages:
<ul>
<li><a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/OpenBSC_with_Asterisk">OpenBSC with Asterisk</a></li>
</ul>
<ul>
<li><a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/SDR_OsmoTRX_network_from_scratch">SDR OsmoTRX network from scratch</a></li>
</ul> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=25832016-12-08T19:18:43Zneelsnhofmeyr@sysmocom.de
<ul></ul><p><a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/SDR_OsmoTRX_network_from_scratch">SDR OsmoTRX network from scratch</a> says "Refer to page OsmoTRX for build instructions." <br />but osmo-trx has no build instructions! Rather, also add 'osmo-trx' to the list of projects<br />for <a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/Build_from_source">Build from source</a>.</p> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=25912016-12-09T11:20:10Zwirelesss
<ul></ul><p>osmo-trx project is added to the list of project for <a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/Build_from_source">Build from source</a> in <a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/SDR_OsmoTRX_network_from_scratch">SDR OsmoTRX network from scratch</a>.</p>
<p>Pages listed below has been completed for review :</p>
<p><a class="wiki-page" href="https://projects.osmocom.org/projects/cellular-infrastructure/wiki/Ettus_USRP_B2xx_family">Ettus USRP B2xx family</a></p>
<p><a class="wiki-page" href="https://projects.osmocom.org/projects/osmonitb/wiki/OsmoNITB_LCR">OsmoNITB LCR</a></p>
<p><a class="wiki-page" href="https://projects.osmocom.org/projects/openbsc/wiki/Building_OpenBSC">Building OpenBSC</a></p> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=31112017-02-23T20:19:04Zlaforge
<ul><li><strong>Assignee</strong> changed from <i>wirelesss</i> to <i>neels</i></li></ul> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=31462017-02-28T02:20:41Zneelsnhofmeyr@sysmocom.de
<ul><li><strong>Status</strong> changed from <i>In Progress</i> to <i>Stalled</i></li></ul><p>will need to have a look at what still needs to be done.</p> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=39602017-05-15T13:53:10Zneelsnhofmeyr@sysmocom.de
<ul></ul><p>my attention is firmly on other topics; but it might be good to wrap this up at some point not too distant in the future...</p> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=56342017-10-09T14:42:50Zneelsnhofmeyr@sysmocom.de
<ul></ul><p>With the openbsc.git split up and addition of M3UA, it increasingly feels like we should completely overhaul our wiki structure,<br />to clarify the different styles of Osmocom network that are now available.</p>
<p>dexter mentioned the idea of starting off with a brand new main page, and building "a new wiki" from there.<br />We could do this in a separate location first and later move the new page into place.</p>
<p>We should also link to it from the redmine project descriptions, so that users are led into the wiki section in more obvious terms.</p> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=60962017-11-07T12:51:24Zneelsnhofmeyr@sysmocom.de
<ul><li><strong>Related to</strong> <i><a class="issue tracker-2 status-5 priority-4 priority-high2 closed" href="/issues/2618">Feature #2618</a>: write Osmocom Network In The Box wiki page</i> added</li></ul> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=85412018-03-27T13:40:40Zlaforge
<ul><li><strong>Assignee</strong> changed from <i>neels</i> to <i>daniel</i></li></ul> Cellular Network Infrastructure - Support #1719: review different 'getting started' guides in the wiki and unify/update themhttps://projects.osmocom.org/issues/1719?journal_id=182612020-05-12T11:58:37Zlaforge
<ul><li><strong>Status</strong> changed from <i>Stalled</i> to <i>Resolved</i></li></ul>