ss7db.gen File

When Steel-Belted Radius Carrier is running in standalone mode and is also running the SIM authentication module, it uses an LDAP directory to extend session information, and store SIM and CDR data records. You need to configure the ss7db.gen file to set up these storage parameters.

Warning

Earlier SBRC 7.2.x releases running in standalone mode and using the SIM module used a different method to store the CDR records. SBRC releases 7.2.4 and later use an LDAP directory to store these records. This directory is configured with the ss7db.gen file. CDR records from SBRC versions earlier than 7.2.4 will not be available after upgrading to 8.3.0.

Note

While configuring the ss7db.gen file for CDR accounting in the SBR cluster version, you need to set the dbclusterndb.so parameter under the [GenericPlugins] section of radius.ini to dbclusterndb.gen for getting NDB cookies in ss7db during SBR startup.

[Bootstrap] Section

The [Bootstrap] section (Table 173) of the ss7db.gen contains the following settings:

Table 173: ss7db.gen [Bootstrap] Syntax

Parameter	Function
LibraryName	Specifies the name of the executable binary. Default value is ss7db.
Enable	Specifies whether to enable or disable storage of CDR records in the LDAP directory. Set to 1 to enable storage in the external LDAP database. Set to 0 to disable storage in the external LDAP database. Default value is 0.

Parameter

Function

LibraryName

Specifies the name of the executable binary.

Default value is ss7db.

Enable

Specifies whether to enable or disable storage of CDR records in the LDAP directory.

Set to 1 to enable storage in the external LDAP database.
Set to 0 to disable storage in the external LDAP database.
Default value is 0.

[Settings] Section

If you intend to use your own external LDAP server, you can configure the following items in the [Settings] section (Table 174) of ss7db.gen.

Table 174: ss7db.gen [Settings] Syntax

Parameter	Function
ConfigLog	Specifies where LDAP configuration information is logged. Options are: None—Do not log LDAP configuration information. Log—Record LDAP configuration information in the Steel-Belted Radius Carrier log file. Console—Display configuration information about the console only. ConsoleAndLog (default)—Record LDAP configuration information in the Steel-Belted Radius Carrier log file and display configuration information about the Steel-Belted Radius Carrier console.
LDAPServerIPAddr	The IP address of the LDAP server. The default is 127.0.0.1. This parameter is reloaded every time that SBRC receives a SIGHUP (1) signal.
LDAPServerPort	The port number for the LDAP server. The default value is 389. This parameter is reloaded every time that SBRC receives a SIGHUP (1) signal.
LDAPUserName	The string for the name of the LDAP server user account. The default is cn=Manager, o=sbrsms, c=US. This parameter is reloaded every time that SBRC receives a SIGHUP (1) signal.
LDAPPassword	The LDAP server password. This password string must correspond to the credentials of the user account name in the previous field. The default is password. This parameter is reloaded every time that SBRC receives a SIGHUP (1) signal.
LDAPBaseDN	The specification for the directory tree where LDAP SMS files, including provisioned accounts, are stored. The default is o=sbrsms, c=US. This parameter is reloaded every time that SBRC receives a SIGHUP (1) signal.
LDAPVersion	The version of LDAP supported by ss7db. The version specified here must match the version number of the LDAP server. You can specify 2 or 3. The default is 2. This parameter is reloaded every time that SBRC receives a SIGHUP (1) signal.
LDAPServerTimeOutSec	If a connection to the LDAP server cannot be made within the specified number of seconds, the transaction with the server is cancelled. A value of 0 means no transaction timeout. The default is 0. This parameter is reloaded every time that SBRC receives a SIGHUP (1) signal.
LDAPMaxNumConnections	The maximum number of simultaneous connections with the LDAP server. The default is 300. This parameter is reloaded every time that SBRC receives a SIGHUP (1) signal.
StaleAccountCleanerSweepFrequencyMin	Specifies how often accounts that have exceeded their grace period are purged from the LDAP database. The default is 30 minutes. This parameter is reloaded every time that SBRC receives a SIGHUP (1) signal.
ExpiredAccountGracePeriodMin	Grace period, in minutes, within which an expired account may be re-billed, if the subscriber authenticates with the previously provided password during this period. The default is 5. This parameter is reloaded every time that SBRC receives a SIGHUP (1) signal.