Fork 0
Old obsolete OpenBSC and OsmoSGSN HLR Management web Interface (OOHMI)
This repository has been archived on 2022-03-30. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Alton MacDonald 624ac1f766 improved setup.py 2014-08-12 17:04:23 +02:00
hlr_mgmt bug-fix: welcome message not being sent to customer whom return from roaming 2014-03-24 13:25:17 +01:00
.gitignore added unit tests and updated documentation 2013-10-31 13:46:57 +01:00
CHANGES.txt Initial osmocom release 2013-05-29 00:32:36 +02:00
COPYING.txt Initial osmocom release 2013-05-29 00:32:36 +02:00
MANIFEST.in Initial osmocom release 2013-05-29 00:32:36 +02:00
README.txt improved setup.py 2014-08-12 17:04:23 +02:00
development.ini Initial osmocom release 2013-05-29 00:32:36 +02:00
osmocom-oohmi added unit tests and updated documentation 2013-10-31 13:46:57 +01:00
production.ini Initial osmocom release 2013-05-29 00:32:36 +02:00
setup.cfg added unit tests and updated documentation 2013-10-31 13:46:57 +01:00
setup.py improved setup.py 2014-08-12 17:04:23 +02:00



1) View BSC and SGSN Statistics
	* View Channel and Data Usage
	* See running versions
2) Administer Subscribers
	* Authorize IMSIs dynamically
	* Authorize IMSIs based on IMEI identification
	* Name IMSI and IMEI for easily identification
3) Send SMS
	* Send SMS to individual subscribers
	* Broadcast SMS to attached subscribers (useful for notifying about system upgrade)
4) Administer BTS Settings
	* View BTS IP address for easy debugging access
	* Change physical channgel configuration for allocating Voice and Data channels as needed
5) Management Scripts
	* In case of failure, the backend services can be restarted from the web interface.
		Supported init.d scripts are:
			* LCR
			* Asterisk
			* GSGN
			* OpenBSC
			* OsmoSGSN
6) Additional Scripts
	* SubscriberMonitor: Welcome message to new or returning roaming subscribers
	* RegisterIMEI: script for individually authorizing subscribers.
		Its easier to have OpenBSC scan the network for the current IMEI-IMSI relationship and authorize a SIM card in a device than finding out the IMSI manually.
		User only enters IMEI and the script does the rest
	* both scripts are managed by hlr_mgmt module and can also be run individually from the command line

Installation & Configuration:

1) Customize the init file to suit your settings. Lines of particular interest are shown below:

		# OpenBSC Settings
		settings['provider'] = '<<Provider Name>>'
		settings['db'] = '/etc/openbsc/hlr.sqlite3'
		settings['bsc_ip'] = ""
		settings['sgsn_ip'] = ""
		settings['bsc_port'] = 4242
		settings['sgsn_port'] = 4245
	If you can produce custom SIM cards with your own MCC/MNC for use in your local network,
	you can add your Provider Details at the end of hlr_mgmt/mcc_mnc.csv following the format:

2) Install osmo-oohmi. This installation process resolves all the required dependencies and sets up its init scripts.

	sudo python setup.py install

3) Verify installation:

	python setup.py nosetests

	If the above command generates errors, try to fix these before running the software

4) Run the Server for the first time:
	/etc/init.d/osmocom-oohmi start
		the server can also be invoked manually as shown below
		cd /etc/openbsc/
		# pserve is a nice python daemonizing function, customize the execution of the hlr_mgmt module by changing runtime flags.
		pserve --help
		pserve production.ini start

5) Access the Web Interface