Feature #2584

Have "osmo-network-check" to verify "Network In The Box" setup

Added by laforge about 1 year ago. Updated 17 days ago.

Target version:
Start date:
Due date:
% Done:


Spec Reference:


While looking at Osmocom_Network_In_The_Box it occurred to me that it might be useful to have some kind of script/program that helps people to validate their configuration. Things that could be checked automatically are:
  • static configuration
    • if all the intended processes are running (using "ps" output)
    • if the telnet of all processes is reachable
    • if any expected TCP/UDP/SCTP ports (like OML/RSL/AoIP/...) are reachable
  • runtime checks (mostly via CTRL, add interface where needed)
    • does OsmoBSC report a BTS connected?
    • does OsmoBSC think its SIGTRAN/AoIP link to STP is up?
    • does OsmoSTP think that its links to BSC and MSC are up?
    • does OsmoMSC think that its link to the STP is up?
    • does OsmoMSC see any BSC connected (BSSAP RESET)?
    • does OsmoMSC have a connection to OsmoHLR via GSUP?
    • does OsmoHLR see a connection from OsmoMSC?

All of the above (and possibly even more) should be possible fully automatic and a short summary could be printed to the screen, like one line for each check with a green OK or red ERROR. Any ERROR message should contain a URL to an error-specific wiki page where we can compile a list of possible causes or other help on what could possibly be the cause of such error.

The script/tool should (at least initially) make the assumption that (BSC, MSC, STP, HLR) and possibly (SGSN, GGSN) runs on the same system, and match 1:1 the wiki page for a basic setup.

This is just my initial idea, I'm sure it can be further extended.

Related issues

Related to Cellular Network Infrastructure - Feature #2618: write Osmocom Network In The Box wiki pageClosed2017-11-07


#1 Updated by ipse about 1 year ago

That's brilliant!
Multiple configurations can be supported via command line or autodetected - e.g. if there is a BTS connected, but it's not seen in `ps`, it's running remotely.

#2 Updated by neels 12 months ago

would be a fun side task for me

#3 Updated by laforge 12 months ago

  • Assignee changed from sysmocom to neels

ok, please get started on it

#4 Updated by neels 12 months ago

  • Related to Feature #2618: write Osmocom Network In The Box wiki page added

#5 Updated by neels 11 months ago

laforge wrote:

ok, please get started on it

(sounds like it should be started soon, but Priority says otherwise)

#6 Updated by laforge 11 months ago

On Mon, Nov 27, 2017 at 02:54:53PM +0000, neels [REDMINE] wrote:

laforge wrote:

ok, please get started on it

(sounds like it should be started soon, but Priority says otherwise)

correct. The comment was not written at the time the priorities were set, so there
was a race condition.

#7 Updated by laforge 17 days ago

  • Priority changed from Normal to Low

Also available in: Atom PDF

Add picture from clipboard (Maximum size: 48.8 MB)