Use the qptool remove
command to remove places or PlaceTypes from the IBM® Lotus® Quickr™ server. You might want to remove a place or PlaceType that is no longer used or that hasn't been used for a long time.
To remove places or PlaceTypes, enter the following command from the server console:
load qptool remove arguments
The following table describes the arguments for the command.
|-?||Prints help on the command.|
|-now||Deletes places or PlaceTypes immediately. If you do not use this argument, places or PlaceTypes are only marked for removal. A place or PlaceType that is marked for removal is inaccessible from a browser but still exists in the file system. |
Note: Do not use this argument to remove a place in a cluster, as the deletion may not replicate.
|-cleanup||Deletes places or PlaceTypes that were previously marked for removal through the remove command or that were deleted through the Lotus Quickr user interface. The ServerTasksAt2 NOTES.INI setting includes qptool remove -cleanup, so that the command runs by default at 2 AM. |
Note that the -cleanup argument does not work on places that are in the database cache. Since QPTool -cleanup typically runs off-hours, places are not in the database cache when the command is run. If you run qptool remove -cleanup at other times, use the dbcache flush command to flush databases from the cache before using -cleanup. For more information on the database cache, see Domino Administrator Help.
|-a||Marks for removal or deletes all places on the server. This argument does not run on PlaceTypes.|
|-p place(s) ||Specifies a place or a space-separated list of places to mark for removal or to delete.|
|-pt PlaceTypes ||Specifies a PlaceType or a space-separated list of PlaceTypes to mark for removal or to delete.|
|-i inputfilename ||XML input file located in the server program directory that specifies places or PlaceTypes to mark for removal or to delete.|
|-o outputfilename ||XML output file that logs the results of the command. By default the command logs results to qptool.remove.xml in the server program directory.|
If you use Search Places on the server, do not use the -now argument to remove places. Instead use the remove command without the -now argument and mark the places for removal. After you mark the places for removal, run the Catalog and Domidx tasks on the Domain Catalog server. After the Domidx task has completed, use the remove command with the -cleanup argument to remove the places. Follow this removal procedure to ensure that information in documents from the deleted places is also removed from the search index.
The following table provides examples of using the remove command.
|Mark the place P1 for removal|
load qptool remove -p P1
|Mark all places on the server for removal|
load qptool remove -a
|Mark PlaceType PT1 for removal|
load qptool remove -pt PT1
|Mark places P1, P2, and P3 for removal|
load qptool remove -p P1 P2 P3
|Mark places for removal that are specified in the XML input file qptool.removeinput.xml|
load qptool remove -i qptool.removeinput.xml
|Mark the place P1 for removal and log output to the non-default XML file qptool.removeoutput.xml|
load qptool remove -p P1 -o qptool.removeoutput.xml
|Remove the place P1 immediately|
load qptool remove -p P1 -now
|Remove all PlaceTypes on the server immediately. Note that you cannot use the -a argument to remove all PlaceTypes.|
load qptool remove -pt PT1 PT2 PT3 PT4 PT5 -now
Parent topic: Managing places using My Places and qptool commands: qd85
Reactivating a place mistakenly removed using QPTool remove
If you remove a place using qptool remove
by mistake, (without the -now argument), you can reinstate the place. To do so, from Notes, edit the database titles of Main.nsf, Contacts1.nsf, and any PageLibraryxxx
.nsf files for the place and change them from [delete pending] to the name of the place. You must also use qptool register -p placename
to re-create the place document in the Place Catalog.
Completing the deletion of a place mistakenly deleted through the file system
If you mistakenly use a file system command to delete a place, rather than the qptool remove
command or the Lotus Quickr user interface, the place still has a Place document in the Place Catalog and is still listed in My Places, although users can't access the place. To remove these references to the place, from Notes, delete the place's document from the Place Catalog, and delete the place's mail-in database entry from the Domino Directory.