Use the qptool register
command to add place documents in the Place Catalog for places created prior to enabling the Place Catalog or for places added from another server, to adjust server-specific information for a place that has been moved from another server or renamed on the same server, or to restore a place that was previously archived.
For example, if the Place Catalog is down for any period of time, unregister all places and then use the register command to register the place again so that the Place Catalog contains up-to-date place information.
To register places, enter the following command at the server console:
load qptool register arguments
are arguments described in Table 1
Table 1. Arguments for the qptool register command for places
|-?||Prints help on the command.|
|-placecatalog||Registers specified place(s) or this server in the Place Catalog.|
|-server||Registers this server in the Place Catalog.|
Note: Requires use of the -placecatalog argument
|-install||Installs and resets server-specific information for places that have been:|
Note: Before you run qptool register -install -a, run qptool remove -cleanup to avoid creating partial entries in the Place Catalog associated with places marked for removal.
- Moved to this server from another server
- Renamed on this server
- Restored from archive .
|-a ||Registers all places.|
|-p place(s) ||Specifies a place or a space-separated list of places to register.|
|-pt place(s) ||Specifies a place type or a space-separated list of place types to register.|
|-pts ||Registers all place types.|
|-i inputfilename ||XML input file located in the server program directory that specifies the places to register.|
|-o outputfilename ||XML output file that logs the results of the command. By default the command logs results to qptool.register.xml in the server program directory.|
Table 2 provides examples of using the qptool register
command for places.
Table 2. Examples of registering places
|Register a place that has been moved from another server, renamed on the current server, or restored from archive|
load qptool register -p placename -install
|Register a place in the Place Catalog only|
load qptool register -p placename -placecatalog
|Register multiple places that have been moved from another server|
load qptool register -p place1 place2 place3 -install
|Register all places on the server in the Place Catalog after upgrading to the current release and enabling the Place Catalog|
load qptool register -a -placecatalog
|Register places specified in an input file|
load qptool register -i qptool.myinput.xml
|Register a place and log results in a non-default output file |
load qptool register -p placename -o qptool.myout.xml
Parent topic: Unregistering and reregistering places with the Place Catalog: qd85
Unregistering places: qd85