Cellular Network Infrastructure » cni-legacy » OpenBSC » OsmoNITB

h1. [[SimpleHLR]]

[[SimpleHLR]] is a web interface for [[OpenBSC]] written in PHP. It allows you to get a good overview and edit most parameters in your HLR database directly via your web browser. You can authorize new subscribers, set extensions, broadcast SMS messages and more.

[[SimpleHLR]] also comes with a set of functions for controlling [[OpenBSC]] from your own applications. You just need to include one PHP file in your project and you're ready to go.

h4. Installation

[[SimpleHLR]] requires a web server with PHP support. You also need to enable support for SQLite3 in PHP. This can be done by adding the line extension=sqlite3.so in your php.ini file.

"Download":https://stormhub.org/simplehlr/download/ and extract the files in your web root. Next, open the config.php file and edit the location of your HLR database file. Make sure your web server has permission to both read and write to the HLR database.

A PHP-script that works as a stand-alone daemon is also included. This daemon monitors the SMS messages to the subscriber with ID 1. This allows users to set their own extensions by texting 'set extension XXXXX' to this subscriber. It also allows administrators to update other subscribers extensions and [de]authorizing users. You do not need to run the daemon to have a working web interface.

h4. Screenshots

"See this link":https://stormhub.org/simplehlr/screenshots/

h4. Known issues

This is just a project I threw together during the extra time I had during christmas. There probably are some bugs, feel free to report them if you find any.

The biggest limitation is that [[OpenBSC]] locks the SQLite database. This causes the web interface to be unable to read data. As a quick fix, [[SimpleHLR]] retries accessing the database 30 times with some delay.

h4. Developers

Development is usually taking place in ##publicbsc (yes, two hashed) at the Freenode IRC network.