diff options
authorNeels Hofmeyr <>2017-12-07 17:32:07 +0100
committerHarald Welte <>2017-12-07 22:32:14 +0000
commitfd14387de56220daf180b60e3ce6033eabcb51d2 (patch)
parent596c49fc3955c14dd4b719b527c8e32313fb406d (diff)
OsmoHLR: update section 'Bootstrap the Database'
1 files changed, 6 insertions, 16 deletions
diff --git a/OsmoHLR/chapters/running.adoc b/OsmoHLR/chapters/running.adoc
index 09388c0..44b66f2 100644
--- a/OsmoHLR/chapters/running.adoc
+++ b/OsmoHLR/chapters/running.adoc
@@ -41,23 +41,13 @@ arguments:
=== Bootstrap the Database
-Before first launching OsmoHLR, you need to create a database, which can be
-done with these commands:
+If no database exists yet, OsmoHLR will automatically create and bootstrap a
+database file with empty tables. If no `-l` command-line option is provided,
+this database file will be created in the current working directory.
-mkdir -p /var/lib/osmocom
-sqlite3 /var/lib/osmocom/hlr.db < /usr/share/doc/osmo-hlr/hlr.sql
-Depending on your installation choices, you will probably find `hlr.sql` in one
-of these locations:
-- `/usr/share/doc/osmo-hlr/hlr.sql`
-- `/usr/local/share/doc/osmo-hlr/hlr.sql`
-- in `osmo-hlr.git`'s source tree at `sql/hlr.sql`
-NOTE: At the time of writing, OsmoHLR does not create an initial empty database
-automatically, like OsmoNITB did. This behavior may be added in the future.
+Alternatively, you may use the `osmo-hlr-db-tool`, which is installed along
+with `osmo-hlr`, to bootstrap an empty database, or to migrate subscriber data
+from an old 'OsmoNITB' database. See `osmo-hlr-db-tool --help`.
=== Multiple instances