Installation

Top  Previous  Next

Prequisites: Apache, PHP5 and the Apache PHP5 module must be installed and working correctly. Access to the files via the command line is assumed, if you can't access the command line (for example when using shared hosting) it is recommended to create the index locally using the Windows or Mac version. The search scripts to run on a Linux based web server come with all the Zoom versions.

Un-gzip the downloaded zoom file (gunzip zoom_linux.tar.gz)
Un-tar the zoom tar file into this folder (tar -xvf  zoom_linux.tar), copy the "zoom" folder into the Apache DocumentRoot/htdocs folder, the usual default is /var/www.
There is a shell script in the zoom folder, install.sh, that can be run to set all the required permissions, this is not a very secure method as it will set permissions so all users can access the files. If you know the user that your webserver runs as you can either alter the script or follow the recommended steps below.
1.Check that permissions are set so the web server can acess all the php files
chmod a+r *
2.Check that the images folder has read and execute permissions set and that the contents of this folder have read permissions
chmod -R a+r images
chmod a+rx images
3.Check that the ZoomEngine executable permissions are set
chmod a+rx ZoomEngine*
4.Check that  default.zcfg, userinfo.dat, .ZoomLogBuffer, .ZoomPageDataBuffer and .key.tmp files have read/write permissions
chmod a+rw default.zcfg
chmod a+rw userinfo.dat
chmod a+rw .ZoomLogBuffer
chmod a+rw .ZoomPageDataBuffer
chmod a+rw .key.tmp
5.Check that the "plugins" folder and the executables it contains can also be read and executed
chmod -R a+rx plugins
6.Check that the "help" folder be read
chmod -R a+r help
7.Create a "temp" directory in the "zoom" directory and make sure it can be accessed
mkdir temp
chmod a+rwx temp
8.Check that the ZoomEngine executable can successfully run on this system by using the "ldd" command and that there are no missing libraries. If ldd reports "not a dynamic executable" you may be trying to execute on a 64bit system with no 32bit libraries sinstalled (Zoom Linux is currently 32bit only). Missing libraries will be reported as "not found".
ldd ZoomEngine
Open the zoom_defines.php file (eg /var/www/zoom/zoom_defines.php) in a text editor and check that $EngineExePath points to the location on disk of the ZoomEngine executable (eg /var/www/Zoom/ZoomIndexer) and that $EngineExeDir points to that location minus the executable name (eg /var/www/Zoom/).
Plugin Installation, some plugins are not packaged with Zoom and need to be installed before using if required.      
If you want to index WordPerfect files (wpd2txt) you will need to install "libwpd-tools" using your Linux distributions package manager (eg "apt-get install libwpd-tools").
Open a web browser and point to http://localhost/zoom/ZoomIndexer.php and you should see the initial zoom screen displayed.

Zoom Linux main window