Configure the default location for search collections

 

+

Search Tips   |   Advanced Search

 

The default directory location under which search collections are created is...

This default can be applied when you create a new search collection, depending on the value you specify in the entry field Location of Collection when you create a new search collection:

  • If you type a relative directory location of the choice, the location for the new search collection is combined from the default directory for search locations and the location that you type. For example, if you type foo_collection_location, the new search collection is created under the directory...

    portal_server_root/collections/foo_collection_location

  • To create the search collection in a location that is different from the default search collection location, type the full directory location as required. The new search collection will be created under the directory location that you specified.

To customize the default directory location set DefaultCollectionsDirectory in the portal search service.

The specified value determines the default directory location for the search collections that you create. When you create a new search collection and specify only a relative path (not a full path location), the default value set by this parameter and the relative path that you specify are combined to form the full directory path under which the search collection is created. If you do not specify a value for DefaultCollectionsDirectory, the default directory for search collections remains as set by the portal installation and described above. To configure a different default search collection location...

  1. Navigate to the Manage Search portlet by clicking...

    Main Menu | Administration | Search Administration | Manage Search | Search Services

  2. Click the New Search Service button. Or, if you want to customize the default collection location for an existing search service, click the Edit icon for that search service.

  3. Set the value of the choice for the parameter DefaultCollectionsDirectory for the search service. The value set for this parameter is prefixed to the relative location that you specify when creating a new search collection. For details about the value refer to the description above.

  4. Click OK to save the updates. Manage Search returns to the Search Services panel.

The directory location that you specify can be on a different hard drive or machine.

If you change the value for the DefaultCollectionsDirectory parameter, make sure that you do all of the following:

  • Specify a full directory path, for example...

    /root/our_search_collections

  • On the specified hard drive create the directory that you specify as the value for the DefaultCollectionsDirectory parameter.

  • Manage the write access to the directory to enable creation of search collections in that directory.

The value set for this parameter is used only if during the creation of a new search collection you specify a relative directory for the location of the new search collection. If you specify a full directory for the location of the search collection, the collection is created in that directory. In this case the value that is set for the default directory under the search service has no effect, but is overwritten by the full directory location that you specify for the search collection.

The initial default directory as given above is created during the portal installation. The portal process has write access to this default directory.

The default portal site collection that is part of the portal installation is created under the default directory. Creation of the portal site collection is started when you navigate to the Manage Search portlet. If you created the portal site collection by navigating to the Manage Search portlet before changing the default directory for the collection location, you might want to relocate the portal site collection to the new default directory.

If you set up a remote search service, for example for a portal cluster, then this parameter is mandatory. You need to configure the default location for search collections to a directory on the remote server that has write access.

The file path length for search collections is limited to 118 characters. If this limit is exceeded, the collection cannot be created. In this case specify a shorter value for the parameter DefaultCollectionsDirectory. This can occur particularly when the portal site collection is created under UNIX operating systems. For details about this refer to Creating the virtual portal site search collection fails (especially under UNIX operating systems).

 

Parent topic:

Administer Portal Search