16.3 Migrating QuickFinder Data from NetWare to Linux

Use the following steps to migrate QuickFinder Server data from a NetWare server to a corresponding Linux server. You must repeat the tasks for each NetWare server in the cluster. It assumes a one-to-one server replacement in the cluster.

WARNING:Migrating indexes and virtual search server settings from a QuickFinder Server running on NetWare to QuickFinder Server running on OES 2 Linux replaces the existing settings on the Linux server. If you want to merge your NetWare settings with the existing Linux settings, you must manually re-create the NetWare settings by using the QuickFinder Server Manager.

  1. Open a Web browser, the access the QuickFinder Server Manager on the NetWare server.

    http://servername/qfsearch/admin
    
  2. Click Global Settings in the top toolbar.

  3. Write down the paths for each virtual search server displayed in the Location column.

  4. On the OES 2 Linux server where the shared volume is active, mount the NetWare server by using the ncpmount command.

  5. Make a backup of the /var/lib/qfsearch/SiteList.properties file.

    Ensure that you don't have a file with this name as a backup on the NetWare server.

  6. Copy all .properties and Cron.jobs files from the root folder sys:/qfsearch on the NetWare server to /var/lib/qfsearch on the Linux server.

  7. Copy sys:/qfsearch/Sites and all of its subdirectories to /var/lib/qfsearch/Sites.

  8. Copy sys:/qfsearch/Templates and all of its subdirectories to /var/lib/qfsearch/Templates.

  9. If any of the paths listed in Step 3 are not under sys:/qfsearch (for example, if you installed a virtual search server somewhere other than the default location), you must also copy those paths to Linux.

    For example, if you have the path sys:/SearchSites/PartnerSite, you must copy it to the Linux server. You could copy it to /var/opt/SearchSites/PartnerSite or /var/lib/qfsearch/Sites/PartnerSite.

  10. Edit all NetWare paths in /var/lib/qfsearch/SiteList.properties to reflect the new Linux paths.

    For example, change sys:/qfsearch to /var/lib/qfsearch.

    Or, as in the example in Step 9, change sys:/SearchSites/PartnerSite to /var/opt/SearchSites/PartnerSite.

    Some paths might have one or two backslashes (\) that must be replaced with one forward slash (/). For example, sys:\\qfsearch\\docs needs to be changed to /var/lib/qfsearch/docs.

  11. Update all NetWare paths in the properties and configuration files copied in the steps above to the Linux paths, and update any DNS names.

    The following files must be updated:

    • AdminServlet.properties
    • Cron.jobs
    • Sites/Highlighter.properties
    • Sites/Print.properties
    • Sites/Search.properties

    For each of the virtual search servers, modify the following:

    • qfind.cfg

    • Any of the above .properties files, if they exist.

    IMPORTANT:Linux filenames are case sensitive.

    The names of most properties files are mixed case, so ensure that the files copied from NetWare are the correct case. You can compare them to the .properties.sample files on Linux.

    You might also need to update paths in templates. If you have problems such as a template not being found or some properties not being set properly, check the case of the filename.

    If you modified any file index paths to index directories on the Linux server, that index must be regenerated.

  12. After all the files have been modified, run the following commands to set the access rights and the owner and groups so that the QuickFinder engine has rights to access the files.

    As the root user, enter

    chown -R root:www /var/lib/qfsearch

    chmod -R 770 /var/lib/qfsearch

  13. Repeat Step 1 to Step 12 for each NetWare and Linux pair of nodes.