Equisys technical notes

Technical guidance, explanations and fixes for our products

HOWTO: Manually adding domain users to Zetafax Network Users list



ID: ZTN1945

This Zetafax technical note applies to:

  • Zetafax Server, all versions


This technote describes the process of manually adding users in an Active Directory domain to the Network Users list in Zetafax. This may be used in circumstances where the organisation has a large number of users in Active Directory, and the delay on opening the Zetafax Configuration Program is deemed too lengthy. This is due to the refresh of network users that takes place when launching the configuration program.

More information

In order to bypass the network users scan, please refer to technote ZTN1449, which launches Zetafax Configuration in non-MMC mode.

Please follow the steps below to add additional users to the network users list:

  1. Once the network users scan has been run at least once, there will be a file named primary.tmp in the < ZFAX> \System\Z-DB folder (where < ZFAX> is the path to the Zetafax Server installation). Open this file in notepad.
  2. Scroll to the bottom of the file and insert the following lines for each user:

  3. [USER]

    Name: < domain username>

    Fullname: < domain user display name>

    SID: < SID of the domain user>

    Where < domain username> is the username to be added, < domain user display name> is the display name associated with that user, and < SID of the domain user> is the unique security descriptor for that user (see below for instructions on how to retrieve the SID of a user).

    To obtain the SID of a user, open a command line window and type in the following command:

    wmic useraccount where(name=”< domain username> ”) get name,sid

    Where < domain username> is the username that the SID is required for. On running this command, the SID will be displayed.

                An example of a completed entry is shown below:


    Name: ssmith

    Fullname: Sam Smith

    SID: S-1-5-21-797987098-3947110149-137802999-3948

  4. Save the file once all additional users have been entered. On launching Zetafax Configuration, the new users will be listed.


ZTN1449 - PRB: Zetafax configuration console launches slowly in domain with large number of users

Last updated: 15th May 2013 (NT/MW)

Equisys Logo, Document Management and Expense Management for Business Central

Replaced by script