IBM Support

After a Tivoli Endpoint Manager Server move - class NotASignedMessage error or IlegalFileName error

Technote (troubleshooting)


Moving or Migrating Tivoli Endpoint Manager servers from one system to another, the move included moving from a 32 bit OS to a 64 bit OS and/or a drive letter change C:\ to D:\


Server Migration or Server move, the GatherState.xml file has the old server's path or drive configuration



Resolving the problem

The GatherState.xml file is located in the following path (example)

C:\Program Files (x86)\BigFix Enterprise\BES Server\Mirror Server\Inbox\GatherState.xml

The GatherState.xml file contains the path or drive of the old server's location, creating the class NotASignedMessage error.

For example, either the path or the drive letter changed between the two servers.
The TEM installation was on the C drive and had been moved to the D drive or the Program Files path was moved to Program Files(x86).

Changing the GatherState.xml file to change all "CommittedLocation" attributes
that point into the C drive to the D drive or Program Files to Program Files(x86)

1) First stop the BES Root Server service
2) Then change the GatherState.xml file
3) Then start the BES Root Server service

The server will read the GatherState.xml file once when it starts up,
and then write it out when it exits, so it will overwrite any modifications
that you make while the server is running.

NOTE: If the process is not completed in the steps listed, the data will be overwritten again with the old paths.

Document information

More support for: IBM BigFix family

Software version: All Versions

Operating system(s): Windows 2003 server, Windows 2008 server

Reference #: 1606460

Modified date: 18 February 2015

Translate this page: