Importing and exporting search collections | HCL Digital Experience
You can export search collections from a source portal and import them into a target portal with the Import and Export Collection option. When you export and import a search collection, you are exporting and importing the configuration information and not the actual content from the search index. You might want to export or import verified search collections from a test portal to a production portal; from a local portal to a configuration with remote search; from a single portal to a portal cluster environment; or to stage your portal to production by using the Release Builder. The export and import operations are beneficial when you upgrade to software levels that are not compatible with the data storage format of older versions of the software.
Before you begin
Before you export a collection, make sure that the user who is running the portal application process has write access to the target directory location. Otherwise, you might get an error message, such as File not found.
About this task
To include the security information when you export or import the search collection, add the WS_KEY parameter to the search service that contains the source or target search collection. For more information, see Exporting and importing search collections in HCL Digital Experience Product Documentation.
Procedure
-
Specify the target directory location and export your search collection.
Note: When you specify the target directory location for the export, be aware that the export can overwrite files in that directory.
-
Document the following data:
- The target file names and directory locations to which you export the collections. For example, C:\ibm\wp_profile\PortalServer\collections.
- The following configuration data of the collections: location, name, description, and language for each collection.
-
Create the search collections on the target portal. This task creates the empty shell for the
search collection. Complete the following data entry fields and select the following options
according to the data that you documented:
- Location of Collection: Specify the new collection location.
- Name of Collection: Specify the collection name. The name can match the old setting, but does not have to match it.
- Description of Collection: Specify a collection description. The description can match the old setting, but does not have to match it.
- Specify Collection Language: Select an option to match the old setting.
- Select Summarizer: You do not need to select this option. The value is overwritten by the import.
Note: When you import search collection data into a collection, most of the collection configuration data is also imported. For example, this data includes the content sources, schedulers, filters, and language settings. If you configured such settings when you created the new collection, they are overwritten by the imported settings. -
Import the data of your search collections into the target portal. For the import source
information, use your documented file names and directory locations to which you exported the
collections before the portal upgrade.
Note: Import collection data only into an empty collection. Do not import collection data into a target collection that has content sources or documents already.
Results
If a search collection is imported to a new environment, you might need to check whether the URLs stored in the content source configuration are still valid.
What to do next
If you want to migrate from one portal version to a higher version, you need to delete the search collections between the export and the re-import. For more information, see Migrating web search collections.