Skip to main content

Configuration

The Scheduler API controls how OLAP and Distribution jobs are scheduled, triggered, and executed. Its behavior is defined through the settings in the appsettings.json file, located at:

  • C:\Program Files\Nectari\Nectari Server\Scheduler\appsettings.json
  • C:\Program Files\SEI\SEI Server\Scheduler\appsettings.json

These settings manage central point resolution, scheduler intervals, retry logic, external API calls, module activation, logging levels, and other runtime behaviors. The tables below describe each setting, its purpose, whether it supports hot reload, and the possible values it accepts.

Central Points

SettingPurposeReloadValues
AllowedHostsList of allowed host names. Use * to allow all.
CentralPoints.ProviderSource used to load Central Point definitions.Remote,
Local
CentralPoints.ApiHostNameWeb Server host name when CentralPoints.Provider is set to Remote.
Must match the server host.
CentralPoints.RemoteFetchIntervalInterval for synchronizing Central Points from the Configurator when CentralPoints.Provider is set to Remote.> 0
CentralPoints.LocalList[]Local Central Points when CentralPoints.Provider is set to Local.
CentralPoints.LocalList[].NameDisplay name for the local Central Point.
CentralPoints.LocalList[].PathLocal or UNC path to the Central Point.
CentralPoints.LocalList[].WebAppUrlWeb Server URL used for distribution.
CentralPoints.LocalList[].IsSageModeIndicates whether the Web Server uses Sage branding.true,
false

Distribution Scheduler

SettingPurposeReloadValues
DistributionScheduler.MisfireThresholdGrace period (ms) during which a missed trigger can still run.> 0
DistributionScheduler.IterationsIntervalInterval (s) between scheduler cycles.> 0
DistributionScheduler.MaxParallelizationMaximum number of parallel tasks the scheduler can run.> 0

External APIs

SettingPurposeReloadValues
ExternalApis.*.BaseUrlBase URL of the external API.
ExternalApis.*.ApiKeyAPI key used to authenticate with the external API.
ExternalApis.*.MedianFirstRetryDelayTemporarily deactivated
ExternalApis.*.RetryCountTemporarily deactivated
ExternalApis.*.CircuitBreakerDelayTemporarily deactivated
ExternalApis.*.TimeoutDelayMaximum request duration before timeout.> 0

OLAP Scheduler

SettingPurposeReloadValues
Quartz."quartz.jobStore.misfireThreshold"Grace period (ms) during which a missed OLAP trigger can still run.> 0

Module Scheduling

SettingPurposeReloadValues
Schedules.*.EnabledIndicates whether the module is active.true,
false
Schedules.*.SchedulerScheduler used for the module.Quartz,
Distribution
Schedules.*.NectariApiDefinitionWorker API definition associated with the module.NectariOlapWorker,
NectariDistributionWorker
Schedules.*.ManagerIterationsIntervalInterval (s) between initializer cycles.> 0
Schedules.*.
ManagerMaxInactiveIterationBeforeSleep
Maximum number of inactive cycles before the initializer enters sleep mode.> 0
Schedules.*.ManagerMaxParallelizationMaximum number of parallel tasks processed by the initializer.> 0

Logging (Serilog)

SettingPurposeReloadValues
Serilog.MinimumLevel.DefaultDefault logging level for the application.Verbose**,
Debug,
Information,
Warning,
Error
Serilog.MinimumLevel.Override.*Logging level overrides by namespace.Verbose**,
Debug,
Information,
Warning,
Error
Serilog.WriteToSerilog sinks that define where logs are written.
Serilog.EnrichSerilog enrichers that add contextual properties to logs.
Serilog.PropertiesStatic properties added to all log entries.

**No hot reload for the Verbose level