IBM Support

Reducing the size of TEM Server RegistrationList File

Technote (FAQ)


How do I reduce the size of the TEM Server's registrationlist.txt file?


The TEM Server keeps a historical log of TEM Clients reporting to the server in a file named 'registrationlist.txt' which can be found in the following location on the TEM Server:
c:\Program Files\BigFix Enterprise\BES Server\ClientRegisterData

If this file gets to be too large(>=50MB) it's possible to see high memory usage or slowdowns on the TEM Root Server.

You can reduce the size of the registrationlist.txt file by running the BESRegistrationListCleaner utility on the TEM Server. The utility will stop the TEM Root Server service, remove registration entries for computer which have not registered in 30 days and than start the TEM Root Server service. The tool will also need to connect to the database to update the database with information about computers that have been removed from the registration list.

For more help, and other commands you can run the command
BESregistrationlistcleaner -h

Which should look like this

BESregistrationlistcleaner -h


Utility for cleaning out a registration list on the TEM Server which has become too large. Only removes entries which are over 30 days old (by default). Connects to the BFEnterprise database to mark deleted computers for refresh if a deleted computer reports in again. May also be run on the TEM Relay.

Command Line Arguments
Optional Arguments:
-h : Displays this help message
-? : Displays this help message
-help : Displays help message for installing this tool as a service.
-f : Runs in silent mode.  No standard output and script runs automatically to completion.
-l : Sends standard out to logfile created in the directory of this application with name BESregistrationlistcleaner.log
       : Specify a folder to create logs in. Do not include a file name.
        : Used to specify a DSN to connect to the TEM Database with.  Defaults to bes_bfenterprise if not specified
         : Used to specify a username for SQL authentication to the database.
          : Used to specify a password for SQL authentication to the database.
           : Interval in days. Computers not registered in the interval are removed.
            : Specify a registration list, defaults to the registration list on the TEM Server.
-D : Do not attempt to connect or update the database. Running the tool on a TEM Relay will automatically cause the tool not to connect to the database.
-R : Create a report of the registration list including license gaps and IP Addresses reoccurring. The registrationlist will not be modified.
             : Specifies the number of IP Addresses to report on (see the -R flag).  Default is 10.
              : Removes all registrations from the given IP Address. Useful for clearing out large number of registration entries from a single host.

Sample calls:
BESregistrationlistcleaner -h
BESregistrationlistcleaner -l
BESregistrationlistcleaner -l -L "C:\Temp"
BESregistrationlistcleaner -d database_dsn -u database_user -p database_password-R -n 10
BESregistrationlistcleaner  -c


Historical Number


Document information

More support for: IBM BigFix family

Software version: 7.0, 7.1, 7.2, 8.0, 8.1, 8.2

Operating system(s): Platform Independent

Reference #: 1505729

Modified date: 10 February 2014