Troubleshooting
Dealing with locked files
When idfilerep cannot replace a file because the file is locked by some process:
If there is no .busy extension version of that file, it leaves a copy with the .busy extension.
If the .busy version already exists, it leaves a copy with an .nnnn extension.
The timestamps on the files are usually reliable enough to determine which file is newest by checking the creation time.
For an administrator to restore the correct version of the file, the newest file has to be renamed with its original file extension (for example, exe or dll). The rest of the files should be removed to a backup location in case there was something important in any of them; they act as a tiny history for that file.
Tracing file propagation activity
You can find file "sync" activity (success/failure, per file) in the idmsuite.log. Look for entries logged by:
The
updinstutility.idfilerepon the receiving node (by default listening on port 2380). See theidfilerepentries in the secondary nodes’idmsuite.log;idfilerephandles placing those files in their correct locations.updproxyon proxy servers. Check its entries on the primary node's log. On the receiving end, see the proxy entries in the proxy log.Unlike
updinst, which replicates with parallel threads,updproxyupdates serially, one file at a time, so it can take much longer to update an application proxy than a node, especially the first time the proxy is added or whenupdproxyis forced to send all files.However,
updinstis used on the primary node for retrieving log files from both secondary nodes and application proxy servers.