Upgrade Guide?

[rhellewell@slco.org]

Would be interested in best practices for upgrading an existing production Zoom environment.

For instance, how to ensure that searching will still work for the visitors; will existing templates will work; or if a separate instance of Zoom7 should/can be installed until we want to make the v7 search pages live on production.

Thanks....Rick...

[David]

V6 to V7 upgrade notes

There isn't a printed guide, but here is a summary of the process going from V6 to V7.

For most people

1. Download V7 of the software.
2. Double click on the downloaded package to install it. We suggest to this folder,
   C:\Program Files (x86)\Zoom Search Engine 7.0
3. Start up V7 & load up your existing Zoom configuration file (xxxx.zcfg). Then use the software in the same way as you did with V6. It is always a good idea to keep a backup of this configuration file, along with the rest of your web site.
4. If you are not using the Free edition of the software enter the V7 license key, under the Help menu.
5. Once you are happy V7 is working OK on your site, you can uninstall V6 from the Windows control panel, or you can keep V6 and V7 installed at the same time.

No changes to the search_template.html file are required, unless you want to make use of the new V7 features, like auto-complete.

For people moving from Windows to Mac or Linux
With the release of V7, there is also now the option of switching to the Mac or Linux release.

1. Save your V6 Zoom configuration file (xxxx.zcfg) on the Windows machine and move it to the new machine.
2. Download V7 of the software for Mac or Linux.
3. To install the Linux software refer to the Readme.txt file in the download package and run the install script. This isn't as simple as a Windows or Mac install, but you wouldn't be using Linux if you wanted simple, right
4. To install the Mac software, open the zip file and double click on the package file to install it.
5. You should then run the software and load your existing configuration file and use it as you did with V6. You might also want to get the PDF User's Guide.

Advanced users
Most users will not have done any of this. But if you have done any of the following then you need extra steps.

• If you have customised the language file (e.g. English.zlang, German.zlang, etc..) then you need to move across these files.
• If you have done any customisation on the search script(s) (e.g. search.php, search.asp) then you need to reapply your customisations changes to the new V7 script.

[rhellewell@slco.org]

I suspect that this is also needed, on a production system, if you want the V6 to work whilst getting the V7 configured for production. May be other items:

- Load the V6 config, save into a V7 config folder (different than the V6 config folder)
- change all output locations for the index files to a different V7 folder (so you don't overwrite the existing V6 production index files) (the Start Options, Start Directory and Output Directory)
- change FTP locations if needed to be different than the V6 versions (FTP button in Configure)
- change other settings (like Start Options, Platform; and enable new features as needed)
- save the V7 configuration file (into the V7 location, not the V6 location)

That should allow you to test and configure the V7 indexing process and results before moving your production links to use the new V7 indexes.

There may be other considerations to not killing your V6 version while you get V7 ready for production. Backups are important also.

[rhellewell@slco.org]

another consideration. ... will the ASP.NET DLL for version 7 co-exist with the v6 version? Will the V7 version work with a v6 ASPX search form?