Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation  Back up to About Overview 
  
[+] Expand All
[-] Collapse All

update.ini File

The update.ini initialization file controls what information is updated when Steel-Belted Radius Carrier receives a SIGHUP (1) or SIGUSR2 (17) signal, which is sent by means of the signal command.

When Steel-Belted Radius Carrier receives a SIGHUP (1) or SIGUSR2 (17) signal, it performs the tasks specified in the [HUP] and [USR2] sections of the update.ini file. You can perform tasks selectively by modifying update.ini to toggle specific settings; for example, you can issue a SIGHUP (1) signal to initiate one set of tasks, and then modify update.ini and issue another SIGHUP (1) signal to initiate a different set of tasks.

The update.ini file installed with Steel-Belted Radius Carrier causes Steel-Belted Radius Carrier to re-read all settings when it receives a SIGHUP (1) signal and to clear its statistics when it receives a SIGUSR2 (17) signal.

[HUP] and [USR2] Sections

The [HUP] section of update.ini specifies what tasks Steel-Belted Radius Carrier performs when it receives a SIGHUP (1) signal. The [USR2] section of update.ini specifies what tasks Steel-Belted Radius Carrier performs when it receives a SIGUSR2 (17) signal.

Example

[HUP]
UpdateLogAndTraceLevel = 1
UpdateLogfilePermissions = 1
UpdateProxy = 1
UpdateDHCPPools = 1
Update3GPP = 1
UpdateWiMAX = 1
UpdateAutoStop = 1
UpdateValuePools = 1
UpdatePlugins = 1
UpdateThreadsAndFloods = 1
UpdateStatusPeriodAndInfo = 1
UpdateSessionTable = 1
UpdateIPPools = 1
UpdateEap = 1
UpdateAdminAccess = 1
UpdateStatLog = 1
ResetStats = 0
UpdateAccounting = 1
UpdateEnhancedRateStats = 1

Table 37 lists the settings that may be present in the [HUP] or [USR2] section of update.ini.

Table 37: update.ini Syntax

Parameter

Function

ResetStats

  • If set to 0, do not reset Steel-Belted Radius Carrier statistics to 0 when a SIGHUP (1) or SIGUSR2 (17) signal is received.
  • If set to 1, reset Steel-Belted Radius Carrier statistics to 0 when a SIGHUP (1) or SIGUSR2 (17) signal is received.

Default value is 0 in the [HUP] section.
Default value is 1 in the [USR2] section.

Update3GPP

  • If set to 0, do not update 3GPP settings from 3gpp.ini when a SIGHUP (1) or SIGUSR2 (17) signal is received.
  • If set to 1, update 3GPP settings from 3gpp.ini when a SIGHUP (1) or SIGUSR2 (17) signal is received.

Default value is 1 in the [HUP] section.
Default value is 0 in the [USR2] section.

UpdateThreadsAndFloods

  • If set to 0, threads and floods status report counters are not cleared when a SIGHUP (1) or SIGUSR2 (17) signal is received.
  • If set to 1, threads and floods status report counters are cleared when a SIGHUP (1) or SIGUSR2 (17) signal is received.

Default value is 1 in the [HUP] section.
Default value is 0 in the [USR2] section.

UpdateStatusPeriodAndInfo

Reinitializes the (huppable) values in the [Status] section of the radius.ini file.

  • If set to 0, status report period and enable/disable for auth/acct/proxy thread floods are not read.
  • If set to 1, status report period and enable/disable for auth/acct/proxy thread floods are read.

Default value is 1 in the [HUP] section.
Default value is 0 in the [USR2] section.

UpdateWiMAX

  • If set to 0, do not update WiMAX settings from the wimax.ini when a SIGHUP (1) or SIGUSR2 (17) signal is received.
  • If set to 1, update WiMAX settings from wimax.ini when a SIGHUP (1) or USR2 signal is received.

Default value is 1 in the [HUP] section.
Default value is 0 in the [USR2] section.

UpdateAdminAccess

  • If set to 0, do not update administrator access settings when a SIGHUP (1) or SIGUSR2 (17) signal is received.
  • If set to 1, update administrator access settings when a SIGHUP (1) or SIGUSR2 (17) signal is received.

Default value is 1 in the [HUP] section.
Default value is 0 in the [USR2] section.

UpdateAutoStop

  • If set to 0, do not update the Proxy AutoStop settings (by re-reading the AcctAutoStopEnable setting in radius.ini) when a SIGHUP (1) or SIGUSR2 (17) signal is received.
  • If set to 1, update the Proxy AutoStop settings (by re-reading the AcctAutoStopEnable setting in radius.ini) when a SIGHUP (1) or SIGUSR2 (17) signal is received.

Default value is 1 in the [HUP] section.
Default value is 0 in the [USR2] section.

UpdateDHCPPools

  • If set to 0, do not update DHCP pool settings specified in dhcp.ini when a SIGHUP (1) or SIGUSR2 (17) signal is received.
  • If set to 1, update DHCP pool settings specified in dhcp.ini when a SIGHUP (1) or SIGUSR2 (17) signal is received.

Default value is 1 in the [HUP] section.
Default value is 0 in the [USR2] section.

UpdateEAP

  • If set to 0, do not update EAP settings specified in eap.ini when a SIGHUP (1) or SIGUSR2 (17) signal is received.
  • If set to 1, update EAP settings specified in eap.ini when a SIGHUP (1) or SIGUSR2 (17) signal is received.

Default value is 1 in the [HUP] section.
Default value is 0 in the [USR2] section.

UpdateIPPools

  • If set to 0, do not update IP pool information when a SIGHUP (1) or SIGUSR2 (17) signal is received.
  • If set to 1, update IP pool information when a SIGHUP (1) or SIGUSR2 (17) signal is received.

Default value is 1 in the [HUP] section.
Default value is 0 in the [USR2] section.

UpdateLogAndTraceLevel

  • If set to 0, do not update log and trace levels specified in radius.ini when a SIGHUP (1) or SIGUSR2 (17) signal is received.
  • If set to 1, update log and trace levels specified in radius.ini when a SIGHUP (1) or SIGUSR2 (17) signal is received.

Default value is 1 in the [HUP] section.
Default value is 0 in the [USR2] section.

UpdateLogfilePermissions

  • If set to 0, do not update logfile permissions specified in the logfile configuration files when a SIGHUP (1) or SIGUSR2 (17) signal is received.
  • If set to 1, update logfile permissions specified in the logfile configuration files when a SIGHUP (1) or SIGUSR2 (17) signal is received.

Default value is 1 in the [HUP] section.
Default value is 0 in the [USR2] section.

UpdatePlugins

  • If set to 0, do not update plug-ins that support dynamic re-reading of configuration settings when a SIGHUP (1) or SIGUSR2 (17) signal is received.
  • If set to 1, update plug-ins that support dynamic re-reading of configuration settings when a SIGHUP (1) or SIGUSR2 (17) signal is received.

Default value is 1 in the [HUP] section.
Default value is 0 in the [USR2] section.

Note: The TLS, TTLS, and PEAP plug-ins currently support dynamic configuration updates.

UpdateProxy

  • If set to 0, do not update realm configuration when a SIGHUP (1) or SIGUSR2 (17) signal is received.
  • If set to 1, update realm configuration (by re-reading proxy.ini, *.pro, and *.dir files) when a SIGHUP (1) or SIGUSR2 (17) signal is received.

Default value is 1 in the [HUP] section.
Default value is 0 in the [USR2] section.

UpdateSessionTable

  • If set to 0, do not update current session table information when a SIGHUP (1) or SIGUSR2 (17) signal is received.
  • If set to 1, updates current session table when a SIGHUP (1) or SIGUSR2 (17) signal is received.

Default value is 1 in the [HUP] section.
Default value is 0 in the [USR2] section.

UpdateValuePools

  • If set to 0, do not update attribute value pool settings (in *.rr files when a SIGHUP (1) or SIGUSR2 (17) signal is received.
  • If set to 1, update attribute value pool settings (in *.rr files when a SIGHUP (1) or SIGUSR2 (17) signal is received.

Default value is 1 in the [HUP] section.
Default value is 0 in the [USR2] section.

UpdateStatLog

  • If set to 0, do not update configuration in the statlog.ini file when a SIGHUP (1) or SIGUSR2 (17) signal is received.
  • If set to 1, reads statlog.ini file and the configuration is updated when a SIGHUP (1) or SIGUSR2 (17) signal is received.

    Default value is 1 in the [HUP] section.

    Default value is 0 in the [USR2] section.

UpdateAccounting

If set to 0, do not update Accounting settings from the account.ini file when a SIGHUP (1) or SIGUSR2 (17) signal is received.

If set to 1, update Accounting settings from the account.ini file when a SIGHUP (1) or SIGUSR2 (17) signal is received.

Default value is 1 in the [HUP] section.

Default value is 0 in the [USR2] section.

UpdateEnhancedRateStats

If set to 0, do not update enhanced rate statistics settings from the radius.ini file when a SIGHUP (1) or SIGUSR2 (17) signal is received.

If set to 1, update enhanced rate statistics settings from the radius.ini file when a SIGHUP (1) or SIGUSR2 (17) signal is received.

Default value is 1 in the [HUP] section.

Default value is 0 in the [USR2] section.

Modified: 2018-01-11