Upgrading Sitecore Module from 1.7.1 to 2.0.0

---

How to upgrade from Sitecore Module v1.7.1 to v2.0.0

SearchStax released the latest version of its SearchStax for Sitecore package which contains several new features and bug fixes. If you are still using SearchStax for Sitecore 1.7.1 you should think about upgrading it in order to leverage all this. This document shows how you can upgrade from a previous version to 2.0.0.

Start by downloading SearchStax for Sitecore 2.0.0 version from here.

There are a few changes in the structure of the SearchStax configuration files between versions 1.7.1 and 2.0.0, so please move this file to a separate folder where it won’t be overwritten:

• \App_Config\Modules\SearchStax\SearchStax.Connector.Provider.config

Then delete all the config files in the following folder:

• \App_Config\Modules\SearchStax

Open your Sitecore instance and install the SearchStax for Sitecore 2.0.0 package using the Sitecore Installation Wizard.

Make sure you select “Yes to all” when asked to overwrite files:

Make sure you select “Apply to all” and “Overwrite” to overwrite all the items already in Sitecore.

Once the installation is finished, open the configuration page, and recreate the SearchStax indexes you need to be part of your Sitecore instance.

If you have custom attributes that were previously added to your indexes, such as computed fields, open the following file using a text-editor program:

• \App_Config\Modules\SearchStax\SearchStax.Connector.Provider.config

And replace its <indexes> node by the one present in the SearchStax.Connector.Provider.config file you backed up at the beginning of this upgrade process. This will bring all our custom attributes back to the Sitecore instance.

Open every search page using /sitecore/templates/Feature/SearchStax/SearchPage/SearchStaxPage template and use the SearchStax Index field to select which previously created index this given page should use when searching for results.

Rebuild all your SearchStax indexes using the Sitecore index manager.

Publish your website and you should now be able to use the search page without any issues.