Configuring the Place CatalogAdded by IBM on December 16, 2010 | Version 1 (Original)
|The Place Catalog is a database that collects information about IBM® Lotus® Quickr™ places and servers. A local Place Catalog is enabled by default on each Lotus Quickr server.
The Place Catalog is a database that collects information about IBM® Lotus® Quickr™ places and servers. A local Place Catalog is enabled by default on each Lotus Quickr server.
About this task
Perform the following steps to configure Place Catalog settings in the qpconfig.xml file.
If you have only one server in your environment, or if you have more than one server but each uses its own Place Catalog, these steps are unnecessary unless you want to customize the Place Catalog settings.
- Open the qpconfig.xml file in the Domino data directory or create the file it it does not exist already.
- Specify the following settings in the file, replacing the values shown below with ones required for your environment:
<place_catalog enabled="true" log_level="0">
See Table 1 for a description of the settings.
- Save the modified file.
- Enter the following command at the server console to restart the HTTP task:
Table 1. Place Catalog settings in the qpconfig.xml file
|Element or attribute||Description|
|The place_catalog section contains settings to enable the server to use a Place Catalog. Set the "enabled" attribute to "true" to tell the server to search for an existing Place Catalog.|
The default setting is enabled="true." To prevent the server from looking for a Place Catalog, change the enabled attribute to enabled="false" or remove the entire <place_catalog> section.
|log_level||You can log operations related to the Place Catalog in the Domino server console as follows:|
Level 1 - Logs all Catalog database open and close operations
Level 2 - Logs all server registration operations
Level 3 - Logs all place registration operations
Level 4 - Logs all member registration operations
Each level also includes the information in the levels below it.
|connection_pool size||For efficiency, the Lotus Quickr server creates a pool of connections to the Place Catalog that can be shared by the different requests the server receives.|
This number should reflect the number of simultaneous requests that could result in a query or update to the Place Catalog. These types of requests include creation of places, the addition of or changes to place membership, and administration requests made by qptoo1.
You may want to start with a number representing a third of the maximum HTTP threads. For example, if the server uses 90 threads, then set this value to 30.
|domino_server_name||Type the Domino hierarchical name of the Place Catalog server, for example, PlaceCatalog/Acme. If this server will use a Place Catalog on a different server, specify the name of that server.|
|nsf_filename||Specify the name of the Place Catalog database, for example, PlaceCatalog.nsf. If this server will use a Place Catalog on a different server, specify the database name of that Place Catalog on that server.|
What to do next
How the Place Catalog Works
The Place Catalog contains data on IBM Lotus Quickr servers, and the places, rooms, and members on those servers. Each server, place, and room has a separate entry in the Place Catalog. An entry is implemented as an IBM Lotus Notes® document.
Rebuilding the Place Catalog
In the event that the Place Catalog becomes corrupt or if the server names or have changed, a rebuild of the placecatalog.nsf database using the placecatalog.ntf template may be required. This also requires a re-register of all servers and places to populate the placecatalog.nsf database with the required documents. This procedure should be performed when there is no user activity on the server as this will affect the My Places and other features of Quickr Domino.
Parent topic: Configuring services for Lotus Domino