Installation Instructions - ESHA Research

Installation and Setup
This document assumes you have a basic knowledge of Windows and how to navigate in the Windows environment.
For Windows assistance, please refer to your Windows documentation.
System Requirements
● P4 processor (2GHz or faster recommended)
● Minimum of 512 MB RAM (1 GB recommended)
● Windows XP (SP3), Windows Server 2003 (SP1), Windows Vista, Windows 7, Windows 2008 Server
● Both 32-bit and 64-bit operating systems are supported
● .NET Framework 2.0
● Not Supported: Windows 95, 98, ME, 2000, or NT
● 350 MB Hard Disk space
IMPORTANT: You must be logged in as an administrator in order to install the software. You may be prompted
to reboot at the end of installation - if so, you must still log in as an administrator to complete installation. If you are
upgrading from a previous version of Food Processor SQL, then go to the UPDATE INSTALLATION instructions
below. If this is the first time you've installed the program then start from the beginning.
Note: If you are installing to a Network, you have to be physically at the computer and cannot install to a mapped
network location or use Terminal Services.
First Time Installation (for update installation see below)
Determine type of installation for your environment
● Single stand-alone computer installation (where program & database will reside locally on the machine)
● Network or shared installation – where database will be in a network location. This includes a scenario
where only one user will use the program but the database is not local to that computer.
Single Stand-Alone install
1. Place the disc in your drive. If the installation does not automatically start:
a. Click your Start button and select Run;
b. Type in x:\setup.exe, where x is the drive letter of your disc drive.
2. On the opening screen, select next.
3. On the next screen, select Full Installation.
4. Enter a password for the SQL server database engine.
(REQUIRED) This password can be any combination of letters and numbers. You must enter a password
before continuing.
Make note of your password, you may need it in the future.
Password:__________________________
5. Click Finish.
6. From this point, follow the onscreen prompts. When given a choice of Complete or Custom, choose
Complete.
7. Click Install.
8. When the installation is complete, click Finish.
9. The program is now available for any user with administrator credentials. To add any non-administrator
users to the database for Genesis, refer to the following online knowledgebase article:
http://www.esha.com/kb/questions/16/

Network or Shared Database installation
The ESHA Database can be either attached to your own existing instance of SQL Server, or you may use the ESHA
disc to install an ‘ESHA’ instance of SQL Server.
Your instance of SQL Server:
1. Copy the eshadata.mdf file from "[disc]:\win32\program files\ESHA Research\data" into a drive that is local
to the server (recommended is "c:\program files\ESHA Research\data").
2. Check/change attributes on that file so it is not Read-Only.
3. Open Microsoft SQL Server Management Studio.
4. Connect to your server instance, and browse to Databases.
5. Right-click in the white area on the right under Databases.
6. Choose Attach…
a. Click Add…
b. Browse to the location to which you copied the eshadata.mdf in step 1 above.
c. Select the eshadata.mdf and click OK.
d. Highlight ‘eshadata_log.ldf' from the list in the lower right.
e. Click Remove to remove the log file from the list.
f. In the upper portion, note the Attach As setting. This should be 'eshadata'. If it is anything other
than that, click in that box and edit it to ‘eshadata’.
g. Owner should be 'sa'.
h. Click OK.
PERMISSIONS NOTE: After it has been attached you will need to assign permissions for any user that will access
the data. Use SQL Server Management Studio to add the user's Windows Authentication to the role 'FPRole' that
exists in the database. If you are not using Windows Authentication (Active Directory), refer to the Using SQL
Authentication http://www.esha.com/kb/questions/17 document for information.
ESHA installed instance of SQL Server (client-server):
Server installation
1. Follow the steps above for Single Stand-Alone install near the beginning of this chapter. This will install
SQL Server, the ESHA Database, and the application on that server machine.
2. After installation, run the program
a. Click Help / Information.
b. Note the Server Name listed in this dialog. You will need this for the client installation (step 11 of
the Client Installation below).
c. Close the program.
3. If Windows Firewall is enabled on this machine, refer to the online knowledgebase article for allowing
exceptions for SQL Server. http://www.esha.com/kb/questions/132/
4. Grant access to any non-administrator users who will need access to the program. Refer to the
knowledgebase article for steps on adding users. http://www.esha.com/kb/questions/16/
5. Ensure the SQL Server Browser service is Started on the server.
Client Installation. The client may be installed locally on each workstation, in an application server, or under
terminal services. The concepts for each are the same.
1. Insert the disc.
2. Click Next to the Welcome Screen.
3. Choose Client Only install, then Next to continue.
4. Click Finish. (Note: the initial installation will give way to the Client installation at this point.)
5. Click Next to the Welcome screen.
6. Accept the License Agreement.
7. Enter your user information.
8. Select your Destination Folder.
9. Choose Custom installation, then Next to continue.
10. Configure to install Food Processor SQL only, then Next to continue.
11. Enter the SQL Server instance name to which your ESHA Database has been (or will be) attached, then
Next to continue.
12. Click Install.

Update Installation
Each ESHA update is an update to both the client and the database. Both must be updated before the update will
work. The order does not matter – client then database or vice versa.
Determine the existing installation in your environment
● Single stand-alone computer installation (where program & database will reside locally on the machine)
● Network or shared installation – where database will be in a network location. This includes a scenario
where only one user will use the program but the database is not local to that computer.
Single Stand-Alone install
1. Place the disc in your drive. If the installation does not automatically start:
a. Click your Start button and select Run;
b. Type in x:\setup.exe, where x is the drive letter of your disc drive.
2. On the opening screen, select next.
3. On the next screen, select Full Installation.
4. Click Finish.
5. From this point, follow the onscreen prompts. When given a choice of Complete or Custom, choose
Complete.
6. Click Install.
7. When the installation is complete, click Finish.
Network or Shared Database installation
The ESHA Database can be either attached to your own existing instance of SQL Server, or you may use the ESHA
disc to install an instance of SQL Server. If in doubt, open an existing installed instance of Food Processor and click
Help / Information. Note the Server Name line. This is the Server location of the database. If the Server Name line
includes \ESHA your environment is using an ESHA instance of SQL Server (see ESHA installed instance of SQL
Server below.
Updating the Food Processor Client
1. Insert the disc.
2. Click Next to the Welcome Screen.
3. Choose Client Only install, then Next to continue.
4. Click Finish.
(Note: the initial installation will give way to the Client installation at this point.)
5. Click Next to the Welcome screen.
6. Accept the License Agreement.
7. Enter your user information.
8. Select your Destination Folder.
9. Choose Custom installation, then Next to continue.
10. Configure to install Food Processor SQL only, then Next to continue.
11. Enter the SQL Server instance name to which your ESHA Database has been (or will be) attached, then
Next to continue.
12. Click Install.
Updating the Database
Your instance of SQL Server:
Refer to the document for manually updating the ESHA Database under full SQL Server on ESHA’s website.
http://www.esha.com/kb/questions/107/
ESHA installed instance of SQL Server:
Follow the steps above for Single Stand-Alone install near the beginning of this section. This will update SQL
Server, the ESHA Database, and the application on that server machine.