4.2 Migration Procedure

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

NOTE:Migrating from QuickFinder Server running on NetWare 6.5 SP8 to the latest version of OES 2 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 an OES 2 Linux server.

    For more information, see Section 3.2.1, Installing QuickFinder Server From the OES 2 Linux Media.

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

    See Accessing QuickFinder Server Manager on NetWare in the NW 6.5 SP8 Novell QuickFinder Server 5.0 Administration Guide for more information.

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

  4. On the OES 2 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 the /var/lib/qfsearch directory on the OES 2 Linux server.

  7. Copy sys:/qfsearch/Sites and all of its subdirectories to the /var/lib/qfsearch/Sites directory on the OES 2 Linux server.

  8. Copy sys:/qfsearch/Templates and all of its subdirectories to the /var/lib/qfsearch/Templates directory on the OES 2 Linux server.

  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.

    Linux paths are case sensitive.

  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