FOCUSPEARL_4_4_4 ReadMeDuringInstallation file, date: 14-Jan-2011

IMPORTANT:
Please read this information carefully before continuing installation as it contains essential information about the installation and uninstallation of FOCUSPEARL_4_4_4. This file is provided among the installer files as ReadMeDuringInstallation.rtf.

Installation instructions for computers on which FOCUSPEARL has not been installed before (first time installs)

Windows 2000, Windows XP and Windows Vista systems where you HAVE Administrator rights:

1.	Install InterBase 6.5 Desktop Edition first by running the InterBase6_5.exe installer, unless this is already installed on your system.
2.	Run or continue the Setup.exe program and follow on screen instructions (please keep in mind that it is advised to install the database only on a local drive),
3.	FOCUSPEARL_4_4_4 can be started from the Start menu or from the shortcut on your desktop. FOCUSPEARL_4_4_4 should display its main screen without errors and connect to the database.

Notes:
•	it is advised to keep the installation files somewhere on your local machine as these can be used to repair damaged installations.
•	an existing FOCUSPEARL_1_1_1, FOCUSPEARL_2_2_2 or FOCUSPEARL_3_3_3 installation on your computer should still be working fine.
•	FOCUSPEARL_4_4_4 cannot be used on XP machines where "Fast User Switching" is turned on, and you are not the first user to log on to the system. This is caused by an InterBase bug which we cannot fix. The problem does not occur if you are the first person to log on to your system.

Windows 2000, Windows XP and Windows Vista systems where you DO NOT have Administrator rights:

1.	Cancel any installation now and logon to your computer with a username that has Administrator rights.
2.	Install InterBase 6.5 Desktop Edition first by running the InterBase6_5.exe installer, unless this is already installed on your system.
3.	Determine, and if necessary, create a directory where the database can be placed with full access rights (please keep in mind that it is advised to install the database only on a local drive).
4.	Run the Setup.exe program to install FOCUSPEARL_4_4_4 and follow on screen instructions, instruct the installer to install the database in the abovementioned directory.
5.	Launch FOCUSPEARL_4_4_4 from the Setup.exe program. FOCUSPEARL_4_4_4 should display its main screen without errors and connect to the database.
6.	Exit FOCUSPEARL_4_4_4 and logoff from the administrator account.
7.	Logon to your system using your own account name and start FOCUSPEARL_4_4_4 either from the desktop icon or from the Start menu. FOCUSPEARL_4_4_4 should now connect succesfully to the database.

If immediately after starting FOCUSPEARL_4_4_4 in either way, you get a Windows installer application instead of the FOCUSPEARL_4_4_4 application, press Cancel and manually create a shortcut that points to the FOCUSPEARL.exe file and start FOCUSPEARL_4_4_4 from now on using that shortcut.

Notes:
•	it is advised to keep the installation files somewhere on your local machine as these can be used to repair damaged installations.
•	an existing FOCUSPEARL_1_1_1, FOCUSPEARL_2_2_2 or FOCUSPEARL_3_3_3 installation on your computer should still be working fine.
•	FOCUSPEARL_4_4_4 cannot be used on XP machines where "Fast User Switching" is turned on, and you are not the first user to log on to the system. This is caused by an InterBase bug which we cannot fix. The problem does not occur if you are the first person to log on to your system.
•	
•	
•	Installation instructions for computers on which an earlier version of FOCUSPEARL has been installed
•	
•	FOCUSPEARL_4_4_4 should be able to work next to earlier FOCUSPEARL versions ! You can simply install FOCUSPEARL_4_4_4 as described above, choose installation directories of your own choice, as long as you avoid installation in directories with older FOCUSPEARL versions. You can open a FOCUSPEARL_2_2_2 or FOCUSPEARL_3_3_3 database from FOCUSPEARL_4_4_4, but once opened with FOCUSPEARL_4_4_4, it cannot be opened with the earlier version ! So the best thing is to make a copy first of the database if you still want to be able to open it with an earlier version. Be warned that opening a database of an older version using a newer version could invalidate all existing results necessitating you to recalculate these runs.
•	
•	Note:
•	the FOCUSPEARL_4_4_4 installer will NEVER replace an existing database and directory with one from the installer files, similarly when uninstalling FOCUSPEARL_4_4_4, an existing database and directory will NEVER be removed.

Uninstallation instructions for FOCUSPEARL_4_4_4

1.	Run the “Add or Remove programs” item from the Control Panel, click on “Remove” and follow the on-screen instructions.
2.	If you want to get rid of FOCUSPEARL_4_4_4 altogether (remember the database is never automatically removed), you could now delete remaining files on the database installation directory (this directory is shown at the top of the FOCUSPEARL_4_4_4 window). Be aware that removing this directory will also remove the database which, as mentioned earlier, is never removed by the uninstallation procedure.

Hard and software requirements
Operating systems:
FOCUSPEARL_4_4_4 is supported on Windows XP, Vista and 7 operating systems. FOCUSPEARL_4_4_4 is not supported and has not been tested on other operating systems such as Windows 95, Windows 98 1st Edition, Windows 98 2nd Edition, Windows ME, Windows NT4 and Windows 2000 operating systems. FOCUSPEARL_4_4_4, however, is likely to run on these operating systems, but technical support will not be provided in case of operating system related problems.

Access rights:
Windows XP, Vista and 7 machines, it is required to have Administrator rights during the installation phase. After installation and running FOCUSPEARL_4_4_4 for the first time, you do not require Administrator rights anymore. You do require, however, full access rights to the directory where the database is installed. This holds for any user on your machine wanting to use FOCUSPEARL_4_4_4.

If you don't have Administrator rights, you can ask somebody else who has on your machine, to install the FOCUSPEARL_4_4_4 software following the above instructions. After logging on to your own account you should be able to have full access to FOCUSPEARL_4_4_4.

Preinstalled software:
FOCUSPEARL_4_4_4 requires a preinstalled InterBase 6.5 installation. This installation is provided by the same supplier as FOCUSPEARL_4_4_4.

Internal memory:
FOCUSPEARL_4_4_4 requires at least 64 Mb internal memory, although sometimes problems occur when viewing very large detailed output files with 64 Mb.

Hard disk memory:
FOCUSPEARL_4_4_4 requires 70 Mb for installation, and around 40 Mb for output of every scenario.

Display:
Monitor with at least 1024x768, at 256 colors.

Processor:
The faster the better.

Known bugs

XP Fast User Switching
FOCUSPEARL_4_4_4 cannot be used on XP machines where "Fast User Switching" is turned on, and you are not the first user to log on to the system. This is caused by an InterBase bug which we cannot fix. The problem does not occur if you are the first person to log on to your system.

FOCUSPEARL_4_4_4 update  date: 28-Feb-2011

In this version the following issues have been solved:
1) Error for run without crop (=bare soil). It is no longer necessary to specify a crop calendar in the SWAP input file. Therefore a new version of SWAP is used in FOCUS_PEARL_444.
2) When updating a FOCUS_PEARL_333 database it is no longer necessary to confirm the various steps in the update procedure. The progress of the update procedure is shown in a DOS box.
3) The Windows message after clicking on the Finish button of the installation procedure
4) It is no longer possible to delete the example project (project is locked)
5) If selecting a number of runs and clicking the 'Calculate button' the user has the option to prepare the input files and execute the model or to generate only the input files.
6) The message about a missing value for KomEqlMax for a run with a parent and metabolite with different sorption options

Testing of the installation and the use of the model on Windows XP 32 bits and Windows 7 64 bits: all results OK

Help
If you suffer from installation problems or problems in the use of FOCUSPEARL, send an e-mail to: pearl@pesticidemodels.nl