Configuring cross-place searchingAdded by IBM on December 16, 2010 | Version 1 (Original)
|Configure cross-place searching to enable external place members to use the advanced search feature to search multiple places.
Configure cross-place searching to enable external place members to use the advanced search feature to search multiple places.
About this task
A manager of a place enables or disables advanced search within a place. IBM® Lotus® Quickr™ provides two types of advanced search features, one of which enables users to search across multiple places. Cross-place searching requires you to configure Domino® Domain Search and a Domain Catalog server, a server that has a Domain Catalog and that builds a domain index. The Lotus Quickr server running on the Domain Catalog server handles all cross-place search requests.
For more information on advanced search and cross-place searching, see the Help. For more information on Domino Domain Search, see Domino Administrator Help.
Note the following points about cross-placing searching:
- Cross-place searching respects all access permissions on content, and so users must retain a single identity to be able to search across places. To search across places, authenticated users must be registered in a user directory. Local users can search only within a place.
- If room access is controlled by a local group, even if the user has access through the local group, cross-place searches won't be able to find the document from the room. Restrict room access using groups from an external user directory.
- If you use more than two Lotus Quickr servers, including the Domain Catalog server, you must configure multi-server session-based authentication (single sign-on).
- To remove places when cross-place searching is in use, use qptool remove , which marks the places for deletion, rather than the qptool remove -now, which deletes them immediately. This way, the nightly qptool remove -cleanup command deletes the places after information in the search index is cleared.
- If you use cross-place searching on a server that is set up for Lotus Domino Off-Line Services, and the server's LDAP directory is not a Lotus Domino directory or is a Lotus Domino directory in a different domain than the Domain Catalog server, use the notes.ini setting QuickPlaceExtensionManagerAllowServers=1 on the offline server. This setting gives the Domain Catalog server access to the Lotus Quickr server's databases. If you don't use this setting, database authorization failures occur during Domain Catalog indexing.
To configure cross-place searching, perform the following steps:
- Perform the following steps to configure Domain Search:
- From IBM Lotus Notes, open the Domino Directory (names.nsf) for the domain.
- Open the Server document of the Domino server that will index the Domain Catalog.
- Click Server Tasks -> Domain Catalog, and in the Domain Catalog field select Enabled.
Note: This step starts the Catalog task and creates the Domain Catalog. The Catalog task keeps the Database Catalog current. You should run the task on a schedule, for example, by including the task name in the ServerTasksAt1 notes.ini setting.
- For optimum performance, repeat step 2b and step 2c on the other servers in the domain, so that each server creates and manages its portion of the Domain Catalog. That way, the Domain Catalog server can simply copy the entries from each server to its Domain Catalog database.
- Wait for the Catalog task to stop on the Domain Catalog server.
- In the Server document of the Domain Catalog server, click Server Tasks -> Domain Indexer, and in the Schedule field, click Enabled to enable the Domain Indexer task. Specify a schedule for running the Domain Indexer.
- Perform the following steps on each Lotus Quickr server to configure the qpconfig.xml file:
- Open the qpconfig.xml file in domino_data_root or create the file if it does not exist already.
- Specify the following settings, providing values suitable for your environment, and then save the modified file:
<search_places enabled="true" anonymous="true">
Table 1 describes the settings.
Settings marked with an asterik (*) should be specified on every Lotus Quickr server except the Domain Catalog server. Do not use them on the Domain Catalog server.
- Enter the following command at the server console to restart the HTTP task:
Table 1. qpconfig.xml settings for cross-place searching
|enabled||When set to "true" enables cross-place searches. When set to "false," prevents cross-place searching. |
|anonymous||When set to "true" allows anonymous users to search across places. |
When set to "false" returns an error when anonymous users issue cross-place searches.
If you allow anonymous users to search across places, and the manager of a particular place does not want to expose the contents of the place to anonymous users through cross-place searching, the manager should make sure that anonymous access to the place is disabled, and limit the place membership to specified users and groups in the directory.
If you allow anonymous access, make sure that anonymous users have the same access as the -Default- access in the ACL for CATALOG.NSF on the Domain Catalog server.
|SSL*||When set to "true" defines that SSL generates the URL for the domain catalog server (HTTPS). When set to "false" defines that HTTP generates the URL.|
|port*||Defines the port used in the URL for the Domain Catalog server.|
|path_prefix*||Defines a path prefix for the URL for the Domain Catalog server.|
|hostname*||Specifies the hostname of the Domain Catalog server.|
|domino_server_name*||Specifies the Domino server name of the Domain Catalog server for example, ServerCatalog/Acme. Before removing places from this server, the server does a lookup to the Domain Catalog server to verify if the search index is cleared.|
Parent topic: Configuring services for Lotus Domino