9
0
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 3042487de4 Added init script 2013-10-23 12:08:34 +02:00
hlr_mgmt fixed mailto typo 2013-06-05 15:00:28 +02:00
.gitignore Initial osmocom release 2013-05-29 00:32:36 +02: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 Added init script 2013-10-23 12:08:34 +02:00
development.ini Initial osmocom release 2013-05-29 00:32:36 +02:00
osmo-oohmi Added init script 2013-10-23 12:08:34 +02:00
production.ini Initial osmocom release 2013-05-29 00:32:36 +02:00
setup.cfg Initial osmocom release 2013-05-29 00:32:36 +02:00
setup.py Initial osmocom release 2013-05-29 00:32:36 +02:00

README.txt

Features:

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:

	hlr_mgmt/__init__.py
		# OpenBSC Settings
		settings['provider'] = '<<Provider Name>>'
		settings['db'] = '/etc/openbsc/hlr.sqlite3'
		settings['bsc_ip'] = "127.0.0.1"
		settings['sgsn_ip'] = "127.0.0.1"
		settings['bsc_port'] = 4242
		settings['sgsn_port'] = 4245
	
	OPTIONAL:
	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:
		MCC,MNC,Network,Operator,Status

2) Install the python dependencies

	sudo python setup.py install
	cp production.ini /etc/openbsc/production.ini

3) Run the Server:

	cd /etc/openbsc/
	pserve production.ini start

	OPTIONAL:
	pserve is a nice python daemonizing function, customize the execution of the hlr_mgmt module by changing runtime flags.

		pserver --help

4) Install init script

	sudo cp osmo-oohmi /etc/init.d/osmo-oohmi
	sudo update-rc.d osmo-oohmi defaults

5) Access the Web Interface

	http://localhost:8080/