Primary and Secondary Core Drivers#

One core driver is designated as the primary core driver. Other core drivers are known as secondary core drivers. The primary core driver serves the Web interface and provides environmental information during the installation process for other core drivers. Only the primary core driver listens for events from eDirectory and performs Trawls.

Typically the first driver becomes the "Primary" Core Driver. All others are "Secondary".

The Primary Core Driver will take all the events from eDirectory and place them in the "Census".

Then when the platform agent connects to (any of the core Drivers) the driver will then find the events from the "Census" that are for that particular platform agent.

How Many Platforms per Driver?#

No definitive answer from us. But if you consider the how you configured your Fan Out Driver Platform Receiver Run Modes you will quickly get the idea that you probbly will have issues if there are 5,000 platforms hitting one core driver in persistent mode.

If you are on Unix be sure to see Fan-Out Driver And File Descriptors

The rule of thumb is that one "Core Driver" can handle 500 platforms.

Configuring the Platform Agent#

Each platform agent will only use only ONE core driver (regardless if it is primary or secondary) at a time. However, the platform agent can have more than one core driver defined for load balance/failover.


The AUTHENTICATION statement specifies the network address and port of one core driver used for Authentication Services. In order to use Authentication Services, you must have at least one AUTHENTICATION statement in your configuration file. A maximum of 100 AUTHENTICATION statements can be coded.


AUTHENTICATION Address [PORT PortNumber] [PREF PrefGroup]
  • Address specifies - the DNS name or IP address of a core driver used for Authentication Services.
  • PortNumber - specifies the TCP port number that is to be used to communicate with this core driver. PORT is optional. PortNumber defaults to 3451.
  • PrefGroup - specifies the Preference Group Number that determines the way a core driver is selected. It is optional, and the default is for all core drivers listed to be in Preference Group
If you specify a port number other than the default (3451), you must also use the Web interface to specify the same port number for the core driver configuration object.

Core drivers and Preference Group#

Core Drivers within a Preference Group are selected equally for load balancing. Core drivers with the lowest Preference Group Number are always tried first, followed by the core drivers with the next Preference Group Number, and so on, until a core driver can be contacted. Preference Group Number must be coded as a positive integer.


AUTHENTICATION cdriver1.digitalairlines.com
AUTHENTICATION cdriver2.digitalairlines.com
AUTHENTICATION cdriver5.digitalairlines.com PORT 5009 PREF 2

Fan Out Driver And File Descriptors#