FLOTHERM Version 5.1 Installation InstructionsDocument Number: FLOTHERM/IN/1003

Copyright 1988-2004 Flomerics Limited.

COPYRIGHTThis document is copyright and may not be reproduced by any method, translated, transmitted, or stored in aretrieval system without prior written permission of Flomerics Limited.

DISCLAIMERWhile every effort is made to ensure accuracy, Flomerics Limited cannot be held responsible for errors oromissions, and reserve the right to revise this document without notice.

CONDITIONS OF USEThis document is issued along with the FLOTHERM software for use under the terms and conditions of thelicense agreement between the user’s organisation and Flomerics. Users thereby agree not to disclose in full or inpart the documentation or the software or the intellectual content thereof to any other individual or organisationwithout prior written consent of Flomerics.

1

Table of ContentsFLOTHERM VERSION 5.1 INSTALLATION INSTRUCTIONS................................................................1

1.QUICK START.................................................................................................................................................... 3

2. GENERAL INSTRUCTIONS............................................................................................................................4

2.1 DELIVERY CONTENTS........................................................................................................................................... 42.2 HARDWARE AND OPERATING SYSTEM REQUIREMENTS...............................................................................................42.3 HPUX, SOLARIS PREREQUISITES......................................................................................................................62.4 USER PRIVILEGES REQUIRED TO INSTALL THE SOFTWARE.......................................................................................... 6

3. IF YOU ARE UPGRADING FROM A PREVIOUS VERSION.................................................................... 6

4. INSTALLING FLOTHERM .............................................................................................................................6

5. FILE PERMISSIONS AND DEFAULT DIRECTORIES.............................................................................12

6. LICENSING THE SOFTWARE UNDER WINDOWS.................................................................................13

6.1 OBTAINING A LICENSE FILE ................................................................................................................................136.2 IF YOU HAVE A HARDWARE KEY (DONGLE)..................................................................................................... 136.3 LICENSE SETUP - CONFIGURING FLEXLM 8.2 ..................................................................................................... 14

7. LICENSING THE SOFTWARE UNDER UNIX........................................................................................... 16

7.1 OBTAINING A LICENSE FILE (LOCKING TO NETWORK CARD ONLY).......................................................................... 167.2 CONFIGURING FLEXLM 8.2...............................................................................................................................16

8. INSTALLING AND STARTING THE VOLUNTEER SERVICE ON WINDOWS..................................17

9. INSTALLING AND STARTING THE VOLUNTEER DAEMON ON UNIX........................................... 18

10. RUNNING FLOTHERM .............................................................................................................................. 19

11. LAUNCHING THE ON-LINE USER DOCUMENTATION..................................................................... 19

12. UNINSTALLING FLOTHERM....................................................................................................................19

13. TRADEMARKS..............................................................................................................................................20

2

1. QUICK START

If you have any problems with the instructions below please refer to later sections, which give more detail.Please Note:

If the installation is an upgrade from FLOTHERM v4.2, a new license file is NOT required, asFLOTHERM V5.1 will work with existing v4.2 licenses. FLOTHERM V5.1 will be installed at adifferent directory, so un-installation of v4.2 is not required. If un-installation of v4.2 is desirable,please use the FLOTHERM v4.2 uninstaller or follow the “FLOTHERM v4.2 InstallationInstructions” for details.

INSTALLING (Section 4) If you received a FLOTHERM installation CD, load the CD, if it does not ‘autorun’, please run the

appropriate install for your operating system. WINDOWS: install_windows.exeSOLARIS: install_solaris.bin

If you downloaded FLOTHERM from a Flomerics ftp site, unzip the downloaded file into a temporarydirectory, and then run the appropriate install for your operating system.

WINDOWS: install_windows.exeSOLARIS: install_solaris.binHPUX: install_hpux.bin (please note, HPUX version will be available in 2005)

A Welcome Screen should then appear To complete the install please follow the on-screen instructions (generally the defaults are acceptable)

LICENSING (WINDOWS Section 6 UNIX Section 7) Start the software. If a license file is not found, a prompt will ask for either a license file or license

server to be specified. Type in the license file name or ‘7241@servername’. If FLOTHERM returns an error, the license server has not been set up correctly. To setup the license

server:

WINDOWS: on the license server run the utility “lmtools.exe” located at<install_dir>\Flexlm82\Windows\lmtools.exe

Switch to “Config Service” tab, configure the license service, then tick the boxes as shown below: Tick“Use Services” first, then “Start server at Power Up”. Save the service, then switch to“Start/Stop/Reread” tab, click on the “Start Server” button.

UNIX The environment variable LM_LICENSE_FILE must be set to the license file path. On the license server, issue the following command to start Flexlm license manager: <install_dir>/Flexlm82/<os_dir>/lmgrd –c <license file> -l <log file>

<install_dir> refers to the directory where software has been installed to. <os_dir> refers to the

3

12

operating system that the license server resides on.

2. General Instructions

2.1 Delivery Contents

Your FLOTHERM delivery should contain a CDROM labelled as follows:

FLOTHERM v5.1September 2004

SOLARIS, Windows NT/2000/XP

The default installation uses the “Install Anywhere” software, which is a Java based installation program.

2.2 Hardware and Operating System Requirements

This version of FLOTHERM is available for the following operating systems:

Platform OS Revision NotesWindows 32-bit Windows NT4, SP 6a See Note 1

Windows 2000, SP1 or higher.

Windows XP Professional, SP1 or higher. See Note 2

Windows 64-bit Windows XP 64-Bit Edition for Extended Systems(i.e.Opteron)

See Note 3 and 4

Windows Server Windows Server 2003 Enterprise Edition.

LINUX 32-bit Red Hat Enterprise V3 See Note 5HPUX HPUX 11i (Technical Computing OE Environment -

June 2002).See Note 6

SUN Solaris (Sparc) SOLARIS 7 (11/99 Release), 8 (10/00Release) & 9.

See Notes 6, 7 and 8

AIX 4.3 has been dropped from the supported OS list for 2004. We also do not expect to support any futureversions of this OS. PLEASE NOTE: We will continue to support AIX 4.3 as a license server and willoffer full support through 2004 for all existing software releases. For the product releases in 2005 allsoftware support – including license server support – will expire for this OS.

1. PLEASE NOTE: V5.1 will be the last Flomerics software release supported on Windows NT 4.0.This OS has been retired by Microsoft, with the Extended Support period expiring as of June 2003(http://support.microsoft.com/default.aspx?scid=fh;[LN];Lifenls).

2. On Windows XP Professional, we had intended offering 3 Gbyte memory addressing for theFLOTHERM solvers. Unfortunately, in-house tests of this Microsoft feature resulted in a number ofoperating system crashes and as a result has been withdrawn as a change for the V5.1 release. IfMicrosoft improves the stability of this feature, Flomerics will consider making it available in asubsequent software release. For further information on this feature, please refer to:http://support.microsoft.com/default.aspx?scid=kb;EN-US;316739.

3. Itanium II support has been dropped for the V5.1 release and Opteron support has been deferred until thenecessary compilers become available. A decision on when we can deliver a 64-bit Opteron release willbe made in December 2004, but we currently expect this to be in Q1, 2005. We currently expect this tobe a 32-bit port of the software generally, but with 64-bit versions of the solver and EFG.

4. On Windows XP 64-bit Editions, up to 16 gigabytes of RAM can be addressed and up to eight terabytesof virtual memory (http://www.microsoft.com/windowsxp/64bit/evaluation/faq.asp).

4

5. Support for the Linux OS has been deferred until Q1 2005 and will be limited to the following softwaremodules:

• Solver (single processor only),• Exchange factor generator (EFG),• Volunteer daemon.

6. In addition to the normal OS support, we will also be providing continued support for the followingoptimized solvers:

• For the PA2 processor running under HPUX;• For the Ultrasparc processor running under SOLARIS.

PLEASE NOTE: We currently expect to deliver the HPUX version in Q1, 2005.

7. FLOTHERM will be supported on Solaris 9. 64-bit versions of the solvers will also be available for thisOS, expected delivery in Q1, 2005.

8. Solaris 10 is due for release in Q3, 2004 so we anticipate supporting this OS with our software releasesin 2005. PLEASE NOTE: V5.1 will be the last Flomerics software release supported on Solaris 7 andwe expect to support Solaris 8, 9 and 10 in 2005.

Please ensure that the operating systems listed above include the one you intend to install to.

The software requires the following minimum hardware configuration:

512 Mbytes RAM minimum, 1 Gbyte recommended; Approximately 400 Mbytes of free swap space or virtual memory; Approximately 350 Mbytes free disk space to install; Recommended minimum of 1 Gbyte additional free disk space for practical project data storage; A 24-bit graphics card with texture mapping, using OpenGL is recommended. It is recommended that the latest versions of the OpenGL graphics libraries are available on all

supported UNIX software.

In addition to the requirements listed above Windows NT, Windows 2000 and Windows XP require anEthernet network adapter, with the following protocols installed:

NetBEUI Protocol (This is not required for Windows XP) TCP/IP Protocol

Windows NT and 2000 also requires the following network services:

NetBIOS Interface RPC Configuration Server Workstation

It is necessary to have the following settings made under the Settings tab in the Display Properties dialog inthe Control Panel:

Color Palette: 32768 Colors (this is the minimum required by the application).Font Size: Small Fonts.

5

2.3 HPUX, SOLARIS Prerequisites

The following operating system components are required for the operation of FLOTHERM:All Platforms

Motif 2.1 Runtime.

HPUX on HP Platforms Native OpenGL Version 1.2 or higher.

SOLARIS on Sun Platforms OpenGL Runtime 1.2 or higher, with latest OpenGL 1.2 for SOLARIS patches.

2.4 User Privileges Required to Install the Software

Note: On Windows NT/2000/XP the installer needs to have write access to the system32 directoryand so Administrator privileges are required for the entire installation.

To perform the installation on UNIX you do not need to be logged on as root for the local machine, howeverto set up the FLEXlm license manager you will need root privileges.

3. If you are Upgrading from a Previous Version

If the installation is an upgrade from FLOTHERM v4.2, a new license file is NOT required, asFLOTHERM V5.1 will work with existing v4.2 licenses. FLOTHERM V5.1 will be installed at a differentdirectory, un-installation of v4.2 is not required. Skip to Step 4 to continue.

If un-installation of v4.2 is desirable, please use the FLOTHERM v4.2 uninstaller or follow the“FLOTHERM v4.2 Installation Instruction” for details.

4. Installing FLOTHERM

If you are upgrading from a previous version please make sure you have read the instructions in the previoussection (If you are Upgrading from a Previous Version).

For Windows PlatformInsert the CDROM. The CD does autorun unless this capability has been disabled on your PC. If theinstallation does not start automatically, then the following steps are required:

o Click on [Start/Run];o Use [Browse] to navigate to the CDROM;o Select install_windows.exe;

If you downloaded FLOTHERM from Flomerics ftp site, unzip the downloaded zip file to a temporarydirectory, and then run the install_windows.exe file

For SOLARIS systemso Insert and mount the CDROM

To NFS mount the CDROM use one of the following commands; the general format is:<OS> <mount command> <cdrom device> <mount

point>SOLARIS mount –rF hsfs /dev/sr0 /cdromNOTE: The <cdrom device> and the <mount point> can differ between machines.

o Navigate to the CDROM mount point directory and start the installation by running the installprogram for your platformSun install_solaris.bin

6

If you downloaded FLOTHERM from Flomerics ftp site, unzip the downloaded zip file to a temporarydirectory, and then run the install_solaris.bin file

For HPUX systems

The HPUX version of FLOTHERM will be available in Q1 2005, and it will be electronics deliveryonly. Download the HPUX installation file from Flomerics ftp site, then unzip the downloaded zip fileto a temporary directory, and then run the install_hpux.bin file

The installation of FLOTHERM uses the “InstallAnywhere” software, the installation progresses through anumber of dialog screens.

1. Introduction

The first dialog is the introduction screen. Start the installation by clicking the Next button

2. Licence Agreement

You have to select the option accepting the terms of the licence agreement in order to progress past thisdialog.

7

3. Release Notes

The FLOTHERM version 5.1 release notes are displayed. These are also installed with the softwareinto the <install_dir>\flosuite_v51\flotherm directory and you are requested to read these since theycontain important information regarding the operation and configuration of the software. (<install_dir>refers to the location where you would like the software installed to).

4. Choose Product Features

There are four options; Typical, Client, Volunteer Only and FLEX Only: The Typical installation will install all the components required for full operation of FLOTHERM. If you do not require the FLEXlm licensing software on the local machine then the Client install

will install all the components required for full operation of FLOTHERM except for the licensingsoftware.

The Volunteer Only option will install the components of FLOTHERM required to use theVolunteer distributed processing technology.

The FLEX Only option would be used on a machine that is only required to act as the licenceserver.

Note: Check if <install_dir>\flexlm82 directory exists. If so, use Client option, if not, use Typicaloption.

8

5. Choose Units

You are then asked which units you would like to use for your default project; selecting “Metric” setsthe default units to SI, selecting “Standard” sets Length=Inches, Velocity=ft/min, Area=Inches2, andPressure=Inches of Water, all other units are SI.

6. Choose Shortcut Folder Note: THIS WINDOW DOES NOT APPEAR FOR THE UNIX INSTALL

The location of the FLOTHERM Icons can be selected. The options are:1. In a new Program Group

The install process will create a new program group under the [Start/Programs] menu andlocate the FLOTHERM icons in this group.

2. In an existing Program GroupThe install process will locate the FLOTHERM icons in an existing program group, which youselect. The default will be the Flomerics group if it already exists, for example, if you haveinstalled a previous version of the software.

3. In the Start MenuThe install process will create a new program group under the [Start] menu and locate theFLOTHERM icons in this group.

4. On the DesktopThe install process will locate the FLOTHERM icons on your desktop.

5. On the Quick Launch Bar

9

The install process will locate the FLOTHERM icons on the Quick Launch Toolbar.6. Other

The install process will locate the FLOTHERM icons in a directory of your choice.7. Don’t Create Icons

The install process will not create any FLOTHERM icons8. Create Icons for All Users

This option allows icons to be created in all user profiles. You have to have Administrator orPower User privileges to activate this option.

7. Choose Install Folder

WINDOWS UNIX

The next dialog asks you where you would like the software installed to, the defaults areWindows Platform C:\program files\flomericsUNIX /opt/flomerics

This directory is referred to in this document as <install_dir>.

8. System Configuration

This is displayed for a short time while the Installer collates the information supplied so that the correctoptions are installed.

10

9. Install

The installation progress will be displayed.

10. Install Complete

WINDOWS UNIX

Once the Install Complete dialog is displayed you can click the [Done] button to complete theinstallation. The system will only need to be restarted on Windows NT (NOT Other Windows Platform,or UNIX) to enable the FLOTHERM software to function correctly.

THE INSTALLATION OF THE SOFTWARE IS NOW COMPLETE, HOWEVER, YOU MAYALSO HAVE SOME ADDITIONAL POST-INSTALLATION TASKS TO CONSIDER. THESEWILL DEPEND ON YOUR SYSTEM CONFIGURATION AND THE INSTALL OPTIONSCHOSEN.

ALL USERS ARE STRONGLY RECOMMENDED TO CAREFULLY READ THEFOLLOWING SECTIONS.

11

5. File Permissions and Default Directories

Depending on your particular system configuration, some of the following steps may be required to complete theinstallation of the software prior to operation.

The FLOTHERM install process will try to correctly set the permissions for the directories created below therequested install directory (<install_dir>), however it is the responsibility of the person installing to ensure thatthe permissions set for this directory are correct. This directory requires read and execute permissions to allowFLOTHERM to operate correctly.

Correct operation of FLOTHERM also requires that the FLOTHERM users have read and write permissions tothe following directories:

The FLOTHERM Central Library Directory: <install_dir>\flosuite_v51\flotherm\flocentral

Note: The above default can be reset in the FLOTHERM start-up script by editing the FLOCENTRALDIRenvironment variable.

The FLOTHERM Default Project Directory: <install_dir>\flosuite_v51\flotherm\flouser

Note: The above default can be reset in the FLOTHERM start-up script by editing the FLOUSERDIRenvironment variable and is over-written by each user as the software is launched and user-specified projectdirectories are accessed.

The FLOTHERM configuration directory: <install_dir>\flosuite_v51\flotherm\config

Notes:1. The above default can be reset in the FLOTHERM start-up script by editing the

FLOPRODUCTCONFIG environment variable. This directory is used for all the productconfiguration files that are installed and is used for the User Configuration files if it has writepermissions. On Windows systems, if the default directory does not have the correct permissions, then theUser Configuration files will be automatically written to the user profiles directory for eachuser. This uses the system USERPROFILE environment variable and typically will have thefollowing defaults:Windows NT: C:\WINNT\Profiles\<user name>\floconfig\FLOTHERMWindows 2000: C:\Documents and Settings\<user name>\floconfig\FLOTHERMWindows XP: C:\Documents and Settings\<user name>\floconfig\FLOTHERM

2. On XP systems, installing with Administrator rights is not sufficient to give full permissions toall users for the three directories listed above. To enable this: Click on [My Computer] and navigate to each directory in turn, Right mouse click and access the [Properties/Security] tab, Select the group name for users: "Users (<Computer_Name>\Users),” Set the "Permissions for Users" to "Full Control.”

12

6. Licensing the software under WINDOWS

6.1 Obtaining a License File

To obtain a license file, you must supply the following information to your account manager at your localFlomerics office. Your license file will then be sent to you via e-mail.

1. Hostname.2. The directory the software was installed into.3. The machine’s host ID (physical address of the ethernet adaptor card).

Note: If the installation is an upgrade from a previous version a new license will be required.

Start an MS-DOS (command) prompt on the server computer (Click on [Start/Run], type cmd, hit[OK] or press [Enter] key).

Type the command ipconfig /all:

Windows NT IP Configuration

Host Name . . . . . . . . . : machine1DNS Servers . . . . . . . . : 162.168.10.148Node Type . . . . . . . . . : BroadcastNetBIOS Scope ID. . . . . . : IP Routing Enabled. . . . . : NoWINS Proxy Enabled. . . . . : NoNetBIOS Resolution Uses DNS : Yes

Ethernet adapter FEM5561:

Description . . . . . . . . : 3Com Megahertz 10/100 Ethernet + 56K PC CardPhysical Address. . . . . . : 00-0A-86-1F-F9-09DHCP Enabled. . . . . . . . : NoIP Address. . . . . . . . . : 162.168.10.117Subnet Mask . . . . . . . . : 255.255.255.0Default Gateway . . . . . . : 162.168.10.254

The Host Name and host ID (Physical Address) can then be noted.

When you receive your code you should save the file to the <install_dir> directory, and call it flomerics.lic.

6.2 If you have a Hardware Key (DONGLE)

Please only complete this section if you have a hardware key (DONGLE). If you are unsure please ignorethis section. We currently support two types of dongles: dongles that can be used on a computer’s parallelport or USB port.

Notes: You need to have “Administrator” privileges to install these drivers.

Attach the dongle supplied by Flomerics to the parallel port or USB port of your license servermachine.

Browse to the “<install dir>\Flexlm82\Windows” directory and select “flexid.exe”. Click “OK” to start the installation. The drivers will now be installed with no further interaction. Once all disk activity has stopped you can check that the dongle is now recognised by starting the

“License Manager Tools” interface from [Start-Programs-Flomerics-License Manager Tools], orthe location you selected for shortcut folder:

13

Select the “System Settings” tab; you should see the ID of the dongle listed in the FLEXID box:

You should now follow the instructions for Section 6.3 License Setup - Configuring FLEXlm 8.2

6.3 License Setup - Configuring FLEXlm 8.2

1. License Server (including stand alone workstations)

Notes: The following instructions assume that no previous version of FLEXlm has beeninstalled or that any older version has been stopped and removed as described insection 3.

Open the “License Manager Tools” user interface from Start-Programs-Flomerics-License Manager Tools], or the location you selected for the shortcut folder.

Select “Configuration using Services” and then select the “Config Services” Tab. Create a new service called, for example, “Flomerics License Manager”. Click on the “Browse” button to select the “Path to the lmgrd.exe file”, navigate to the

<install_dir>\Flexlm82\windows directory, and select “lmgrd.exe”. Click on the “Browse” button for “Path to the license file”, navigate to the <install_dir>

directory, and select “flomerics.lic”, (you should have obtained a license file from Flomerics,if you have not then go to section 6.1“Obtaining a License File”).

Click on the “Browse” button for “Path to the debug.log file”; navigate to a directory whereyou want the log file to be created. This file is useful for diagnostics purposes.

Tick the two boxes at the bottom “Use Services” and then “Start Server at Power-Up”.

14

Click on the “Save Service” button, and confirm the changes.

Select the “Start/Stop/Reread” tab, and click on the “Start Server” button; you should get amessage displayed below the status button stating that the server started:

The license manager is now installed and working.

2. Client Machine

Ensure that the Flomerics License Manager has been set-up on the server machine, as detailedin the section above.

From the license file on the server machine note the server host name and the port numberbeing used by the Flomerics License Manager Service. This is given in the first line of thelicense file, with the following syntax: SERVER server_hostname hostid TCP:port_number, e.g. SERVER machine1 000A861FF909 TCP:7241.

Add a user environment variable called FLOLIC, and set the “Value” to<port_number>@<server_hostname>, e.g. 7241@machine1.

The client is now set-up to obtain licenses from the server machine.

15

7. Licensing the software under UNIX

7.1 Obtaining a License File (Locking to Network Card Only)

FLOTHERM uses the FLEXlm Licence manager, which needs to be installed on at least one machine inyour network. In order to run the software you will need to obtain an Authorised Licence Code fromFlomerics. You will need to provide the following information about the computer that is to be used as theserver:

1. Hostname.2. The directory the software was installed into.3. The machines host ID (physical address of the ethernet adaptor card).

The hostid can be obtained using the command for your hardware from the following list:

Platform Command Typical OutputSun hostid 8 digit hexadecimal numberHP uname -l 10 digit decimal numberIBM uname –m hexadecimal number

When you receive your code you should save the file to the <install_dir> directory, and call itflomerics.lic.

7.2 Configuring FLEXlm 8.2

1. License Server (including stand alone workstations)The following steps need to be completed to set up the license for FLOTHERM v5.1:

The environment variable LM_LICENSE_FILE must be set to the license file pathe.g. setenv LM_LICENSE_FILE /opt/flomerics/flomerics.lic

Then issue the following command to start the license server, e.g:<install_dir>/Flexlm82/<os_dir>/bin/lmgrd –c <licensefile> –l <logfile>

where <os_dir> is: “HPUX11_11” on HP, and “SOLARIS8” or “SOLARIS 64” onSun, for AIX systems, see note 1 below.

An example of the above command on a SOLARIS system is as follows:/opt/flomerics/Flexlm82/SOLARIS8/bin/lmgrd –c /opt/flomerics/flomerics.lic –l /tmp/ftflex.log

The above command must be used to start the FLEXlm License Manager and should be addedto the workstation boot sequence by the Systems Administrator.

Note: 1. If you are planning to use IBM AIX as your license server, you need to transfer license

binaries from another installation of FLOTHERM. For example, you can locate a windowsinstallation, transfer <install_dir>\Flexlm82\AIX43 directory onto an AIX computer. Thenuse above mentioned command to start the license server.

2. The FLEXlm daemon must be re-started whenever the workstation has been re-started.

2. Client Machine:The configuration of the client machine is similar to that of the windows platform. Make surethe license server is up and running, then set LM_LICENSE_FILE to 7241@licenseserver, e.g.setenv LM_LICENSE_FILE 7241@flosun

The client is now set-up to obtain licenses from the server machine.

16

8. Installing and Starting the Volunteer Service on Windows

The FLOTHERM v5.1 release continues to support the use of distributed processing in conjunction with theCommand Center (CC) and the Volunteer technology. This can be activated by using the FLOVolunteerGUI (please refer to the On-Line Help and check for the entry FLOVolunteer in the Index), however, theequivalent technology can also be used ‘in the background’ by starting the Volunteer as a service on a PC.

To install and start the v5.1 Volunteer service, the following steps are required:

Perform a Typical, Client or Volunteer Only FLOTHERM installation. Set the following System environment variables and ensure that any defined directories exist in the

file system:

FLOQUEUELOCATION to point to a directory into which the queue file is written and read byboth the CC and all Volunteers. By default, in the flotherm.bat script, it is set to %FLOCENTRALDIR%\floqueue.

FLOHOME is set so that the actual path to the solution repository is written to the queue file insuch a way that a Volunteer can convert the queue file path to where it sees the solution repository.This circumvents issues associated with different mount points defined on different machines.

FLOMERICS_LICENSE_FILE to point to the flomerics license file, e.g. <install_dir>\flomerics.lic

TEMP to point to a temporary directory (e.g. c:\temp).

FLOPRODUCTCONFIG to point at the installed product configuration directory, e.g. <install_dir>\flosuite_v51\flotherm\config

Add : <install_dir>\flosuite_v51\common\winnt\bin and <install_dir>\flosuite_v51\common\winnt\lib to the PATH environment variable.

The service can be either run as a GUI, or “in the background”

As a GUI: Navigate to the <install_dir>\flosuite_v51\flotherm\WinNT\bin directory, and run the file runVolunteer.bat

Note: If running as a GUI, it is not necessary to follow thefurther steps within this section.

In the Background: This option requires that all earlier versions of the Volunteer serviceare stopped AND removed from the system. For FLOTHERMv5.1 this will require the following steps:

To halt and remove the currently running service, launch aCommand Prompt and type:

c:\winnt\system32\volunteer –d Navigate to the c:\winnt\system32 directory and delete the file,

volunteer.exe.

Note: If this step is omitted, the FLOTHERM v5.1 installation willnot be able to install volunteer.exe into the system32 directory.It will be installed into <install_dir>\flosuite_v51\common\WinNT\bin instead andwill need to be manually moved to the system32 directory,prior to starting the Volunteer service as described below.

17

Launch a Command Prompt and type c:\winnt\system32\volunteer –i

Reboot the machine. Open the Control Panel and access Services (NT) or Administrative Tools Services

(2000 or XP). Check that the ‘Flomerics Volunteer Service’ has started and is set to Automatic.

The Volunteer service is now configured and ready for use in combination with the CommandCenter.

Note: The behaviour of an installed service is dependent on which “user” it is run by. Thedefault will be for a Local System profile to be used. If, however, theFLOQUEUELOCATION environment variable points at a mapped drive location,then the Logon settings for the service need to be updated to use a User Profile thathas admin rights and all the necessary drives mapped. There are two possible ways todo this:

1. Open the Control Panel and access Services (NT) or Administrative Tools Services (2000 or XP). Right mouse click the ‘Flomerics Volunteer Service’and access Properties. In the Logon tab, activate the “This account” button andselect a suitable User Profile and password that has all the necessary mappeddrives.

2. As an alternative to adjusting the service properties, all required mapped drivescan be defined by logging on as the Local Administrator and making thenecessary connections. This will ensure that the default Local System profileused by the service will be correct.

3.

9. Installing and Starting the Volunteer Daemon on UNIX

The FLOTHERM v5.1 release continues to support the use of distributed processing in conjunction with theCommand Center (CC) and the Volunteer technology. The Volunteer GUI can be activated by using therunVolunteer script.

To install and start the v5.1 Volunteer daemon, the following steps are required:

Perform a Typical, Client or Volunteer Only FLOTHERM installation.

Set the following environment variables and ensure that any defined directories exist in the filesystem:

FLOQUEUELOCATION to point to a directory into which the queue file is written and read byboth the CC and all Volunteers.

FLOHOME is set so that the actual path to the solution repository is written to the queue file insuch a way that a Volunteer can convert the queue file path to where it sees the solution repository.This circumvents issues associated with different mount points defined on different machines.

FLOLIC to point to the flomerics license file, e.g. <install_dir>/flomerics.lic

FLOPRODUCTCONFIG to point at the installed product configuration directory. By default, inthe flotherm setup script, it is set to<install_dir>/flosuite_v51/flotherm/config

Run the runVolunteer scripte.g. <install_dir>/flosuite_v51/flotherm/<os_dir>/bin/runVolunteer

18

10. Running FLOTHERM

WINDOWSLaunch the software via the FLOTHERM 5.1 group, e.g.:

Note: This will depend on the option you chose for the Shortcut folder during the installation process.

The software can also be operated in batch mode. Please refer to the documentation for further details.

UNIXAdd the <install_dir>/flosuite_v51/common/<os_dir>/bin to your path environment variable, this canbe done in the home directory for the user in the .login file for c-shell users, or the .profile file for k-shell users. The interactive mode is then started by typing flotherm.

The software can also be operated in batch mode. Please refer to the documentation for further details.

11. Launching the On-Line User Documentation

WINDOWSThe On-Line User Documentation can be launched from within the software itself via Help in theDialogs and Windows or directly from the Shortcut folder:

UNIXThe On-Line User Documentation can be launched from within the software itself via Help in theDialogs and Windows.

12. Uninstalling FLOTHERM

WINDOWSFLOTHERM v5.1 can be uninstalled from your Windows workstation using the uninstall scriptprovided:

19

UNIXFLOTHERM v5.1 can be uninstalled by removing the flosuite_v51 directory tree from your system.

Note: If you have been storing data you wish to keep in the default locations ensurethat you copy this data to a new location prior to deleting the FLOTHERM 5.1tree.

13. Trademarks

Flomerics and FLOTHERM are registered trademarks of Flomerics Limited. Microsoft Windows NT is a trademark of Microsoft Corporation.Microsoft Windows 2000 is a trademark of Microsoft Corporation.Microsoft Windows XP is a trademark of Microsoft Corporation.Windows XP 64-Bit Edition for Extended Systems is a trademark of Microsoft CorporationWindows Server 2003 Enterprise Edition is a trademark of Microsoft CorporationFLEXlm is a trademark of Macrovision Corporation.HPUX is a trademark of Hewlett-Packard Development Company, L.PSOLARIS is a trademark of SUN Microsystems, Inc.InstallAnywhere is a trademark of Zero G Software Inc.All trademarks and copyrights mentioned in this documentation are the property of their respective owners.

20