Restoring a 3.1.0 backup into 3.2.0

After you install 3.2.0, you can restore the 3.1.0 backup into the new installation.

To restore a 3.1.0 backup into 3.2.0:
  1. If you modified <install path>\IAS\workspace\conf\DocumentConversionFilters.xml, make the following changes:
    1. Open the backed up copy of DocumentConversionFilters.xml in a text editor.
    2. Copy your include and exclude filters from the backup.
    3. Open DocumentConversionFilters.xml of your 3.2.0 installation in a text editor and add the include and exclude filters.
    4. Save and close DocumentConversionFilters.xml.
  2. If you modified <install path>\IAS\workspace\conf\jetty.xml in 3.1.0, make the following changes:
    1. Open the backed up copy of jetty.xml in a text editor.
    2. Open the newer version of jetty.xml in a text editor.
    3. Copy your specific customizations into the 3.2.0 version of jetty.xml.
    4. Save and close the 3.2.0 version of jetty.xml.
  3. If you had any IAS plugins installed in 3.1.0, copy the directory containing the plugin JAR or JARs from the backup location to <install path>\IAS\<version>\lib\ias-server-plugins.
  4. If a crawl configuration contains custom references to version numbers, for example, in paths to output files, then modify the paths as appropriate, and save and close the crawl configuration.
  5. Restart the Endeca IAS Service.
  6. If you created unmanaged Record Store instances or if you modified the configuration of a Record Store instance in 3.1.0, import the Record Store instance configuration into 3.2.0 by doing the following:
    1. Open a Command Prompt and navigate to <install path>\IAS\<old version>\bin.
    2. Recreate each Record Store instance by running component-manager-cmd and the create-component task for each Record Store instance. The syntax for the create-component task is:
      component-manager-cmd create-component -n <RecordStoreInstanceName> 
      -t <RecordStore> -h <HostName> -p <PortNumber>
    3. For each Record Store instance, run recordstore-cmd and the set-configuration task. Specify the path to an XML file for the Record Store instance configuration.
      The syntax for the set-configuration task is:
      recordstore-cmd set-configuration -a <RecordStoreInstanceName>
      -f <FileName.xml> -h <HostName> -n -p <PortNumber>
  7. Import the backed up crawl configurations into 3.2.0 by doing the following:
    1. Open a Command Prompt and navigate to <install path>\IAS\<old version>\bin.
    2. Run ias-cmd and the createCrawls task. Specify the path to the XML file you created in Backing up 3.1.0.
      The syntax for the createCrawls task is:
      ias-cmd createCrawls -f <FileName.xml> -h <HostName> -p <PortNumber>

      You will be prompted for the password of any connector or data source that requires a password.

  8. If you used any custom Web Crawler plugins installed in 3.1.0, copy the directory containing the plugin JAR and plugin.xml from the backup location to <install path>\IAS\3.2.0\lib\web-crawler\plugins.
  9. If you used the Web Crawler in 3.1.0, do the following:
    1. Copy the older version of default.xml and site.xml from the workspace backup into the 3.2.0 workspace\conf\web-crawler locations.
    2. Open default.xml in a text editor and modify the path in the plugin.folders property to the 3.2.0 directory structure of <install path>\IAS\3.2.0\lib\web-crawler\plugins.