The use of "qptool register -install" should be limited in clustered/replicated environments

Lotus Quickr services for Domino Server uses the qptool register command in order to update the places and register them onto a given Domino server that is running Lotus Quickr. However, it should be noted that running the following variations of the command will cause the replica ID on the databases for the places it is run against to be changed:

load qptool register -p placename -install

or

load qptool register -a -install

In a clustered or otherwise replicated environment where there are already replicas or places on others members of the cluster or Domino servers, unregisterings a place (or places) on any one of the servers and then running the qptool register with the "-install" argument will cause the replica ID to be changed if the place folder's name was changed. In other words, the place folder was renamed for some reason and then the register -install command was issued. This will cause an update to the replica ID on each server where the folder name was altered and break replication of that places across the cluster mates.

It is recommended that the "-install" argument not be used with qptool register in such a scenario.

If the "-install" option is needed for some purpose, the following steps are recommended:

- unregister the place(s)
- stop replication
- delete the places off the other servers in the cluster/replication partners (leaving the original on the primary)
- run the qptool register -install command
- run replicamaker on the place(s)
- start replication

An alternative is the following:

- unregister the place(s)
- stop replication
- delete the places off the other servers on the cluster/replication mates(leaving the original on the primary)
- run the qptool register -install command
- start replication
- allow qptool replicamaker and domino replication to transfer the data.

NOTE: Through additional testing it was determined that this problem happens when a place is in a folder that does not already exist on the server in question. The act of running qptool unregister and qptool register on a place that already exists in a directory that already exists on a server will not change the replica ID.