4.2 Migration Procedure

Use the following steps to migrate QuickFinder Server from a NetWare server to an OES for Linux server.

NOTE:Migrating from QuickFinder Server running on OES NetWare to OES Linux replaces any indexes or configurations made on the Linux server. If you want to merge your changes from NetWare to Linux, you must manually re-create the changes by using the QuickFinder Server Manager.

  1. Install QuickFinder Server on Linux.

    For more information, see Section 3.2.2, Installing QuickFinder Server From the OES for Linux Media.

  2. Access QuickFinder Server Manager on the NetWare server, then click Global Settings () on the top toolbar.

    See Section 1.4.1, Accessing QuickFinder Server Manager on NetWare for more information.

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

  4. On the OES for Linux server, mount the NetWare server (you can use ncpmount).

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

    Make sure 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 directory 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 (such as sys:/qfsearch to /var/lib/qfsearch, or as in Step 9, 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 change 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 is a list of files that 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.

    The names of most properties files are mixed case, so make sure 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. Linux filenames are case sensitive.

    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 owner/groups so that the QuickFinder engine has rights to access the files:

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

    chmod -R 770 /var/lib/qfsearch