SMS over GSUP: implement vty config of SMSC routing

At the user-visible level (advanced settings menus on phones,
GSM 07.05 AT commands, SIM programming) each SMSC is identified
by a numeric address that looks like a phone number, originally
meant to be a Global Title.  OsmoMSC passes these SMSC addresses
through as-is to MO-forwardSM.req GSUP message - however, SMSCs
that connect to OsmoHLR via GSUP identify themselves by their
IPA names instead.  Hence we need a mapping mechanism in OsmoHLR
config.

To accommodate different styles of network design ranging from
strict recreation of classic GSM architecture to guest roaming
arrangements, a two-level configuration is implemented, modeled
after EUSE/USSD configuration: first one defines which SMSCs exist
as entities, identified only by their IPA names, and then one
defines which numeric SMSC address (in SM-RP-DA) should go to which
configured SMSC, with the additional possibility of a default route.

Related: OS#6135
Change-Id: I1624dcd9d22b4efca965ccdd1c74f0063a94a33c
9 files changed
tree: e9cf3416cb71b0f1fdf7e6f8e48fa776a623c7e9
  1. contrib/
  2. debian/
  3. doc/
  4. include/
  5. sql/
  6. src/
  7. tests/
  8. .gitignore
  9. .gitreview
  10. configure.ac
  11. COPYING
  12. git-version-gen
  13. libosmo-gsup-client.pc.in
  14. libosmo-mslookup.pc.in
  15. Makefile.am
  16. README.md
  17. TODO-RELEASE
README.md

osmo-hlr - Osmocom HLR Implementation

This repository contains a C-language implementation of a GSM Home Location Register (HLR). It is part of the Osmocom Open Source Mobile Communications project.

Warning: While the HLR logical functionality is implemented, OsmoHLR does not use the ETSI/3GPP TCAP/MAP protocol stack. Instead, a much simpler custom protocol (GSUP) is used. This means, OsmoHLR is of no use outside the context of an Osmocom core network. You can use it with OsmoMSC, OsmoSGSN etc. - but not with third party components.

Homepage

The official homepage of the project is https://osmocom.org/projects/osmo-hlr/wiki

GIT Repository

You can clone from the official osmo-hlr.git repository using

git clone https://gitea.osmocom.org/cellular-infrastructure/osmo-hlr

There is a web interface at https://gitea.osmocom.org/cellular-infrastructure/osmo-hlr

Documentation

User Manuals and VTY reference manuals are [optionally] built in PDF form as part of the build process.

Pre-rendered PDF version of the current "master" can be found at User Manual as well as the VTY reference manuals

Mailing List

Discussions related to osmo-hlr are happening on the openbsc@lists.osmocom.org mailing list, please see https://lists.osmocom.org/mailman/listinfo/openbsc for subscription options and the list archive.

Please observe the Osmocom Mailing List Rules when posting.

Contributing

Our coding standards are described at https://osmocom.org/projects/cellular-infrastructure/wiki/Coding_standards

We us a gerrit based patch submission/review process for managing contributions. Please see https://osmocom.org/projects/cellular-infrastructure/wiki/Gerrit for more details

The current patch queue for osmo-hlr can be seen at https://gerrit.osmocom.org/#/q/project:osmo-hlr+status:open