Installation guide

PC-Duo Deployment Tool
76
Remove duplicate HostIDs
The RmHostID utility is available in the PC-Duo Utilities file.
The RmHostID utility runs on one computer and searches one or more computers for
Host installations that have a specified HostID. If a matching HostID is found, the HostID
is deleted and the Host Service restarted so that a new ID will be assigned. This utility
can be used to “clean up” Host installations with duplicate IDs on a LAN.
RmHostID command line syntax
RmHostID accepts command line flags that control its behavior:
 -p prompt for confirmation before deleting HostID
 -prompt same as „-p‟
 -? displays help text describing how to use RmHostID
RmHostID expects two arguments (in addition to any flags) on its command line. The first
argument specifies which HostIDs should be considered duplicates, and therefore should
be deleted. The second argument specifies which machine or remote computers should
be examined.
The HostID specification (first argument) can be one of:
 A specific GUID, in the form “{C8E645A4-AF10-46f7-838B-A75105C8AA13}”
 A star (“*”), signifying that all HostIDs found should be deleted
 An at sign (“@”) followed immediately by a filename. This causes the specified file to
be read, and each line should contain a single GUID.
The machine‟s specification (second argument) can be one of:
 If the machine specification is missing, the local machine is checked
 A specific machine name, as either a NetBIOS machine name or a DNS name
 A star (“*”), which instructs RmHostID to enumerate all remote computers on the
network
 An at sign (“@”) followed immediately by a filename. This causes the specified file to
be read, and each line should contain a single machine name (as either a NetBIOS
machine name or a DNS name).
Examples:
 RmHostId {078A9A01-6931-42A3-9371-EA00F1DC7D99} *
This example enumerates the remote computers on the network, and deletes the HostID
of any installations that match the specified ID.
 RmHostId {078A9A01-6931-42A3-9371-EA00F1DC7D99} MACHINE04
This example connects to the one machine named “Machine04”, and deletes the HostID
on that machine if and only if it matches the specified ID.
 RmHostId * MACHINE04
This example connects to the one machine “Machine04”, and deletes the HostID
unconditionally, because “*” was specified as the HostID pattern.