Part IInstallation, Licensing, and Utilities1

CHAPTERONEINSTALLATION, LICENSING, AND CONFIGURATIONThis chapter provides detailed instructions for installing FLOW-3D, configuring software licensing, and setting upthe remote solving features. For any trouble during the installation, please contact our support department at [email protected] or by calling (505) 982-0088 and we will be happy to assist.1.1 Installation1.1.1 Supported operating systemsThere are certain operating systems on which FLOW-3D and FlowSight are tested. While it may be possible to installand run both of these programs on other operating systems, Flow Science supports and provides installation assistancefor only the following 64 bit operating systems: Microsoft Windows 7 and greater Microsoft Windows Server 2008 and greater Red Hat Enterprise Linux 6 and greaterNote: 32 bit operating systems are not supported. The lmgrd license server is not compatible with Red Hat Enterprise Linux 7. The new lmadmin license serverhas been included instead.1.1.2 Hardware requirements and recommendations Processor: An x86-64 compatible CPU is required. Multiple core CPUs, particularly Intel Core i7 and IntelXeon CPUs, are strongly recommended. AMD CPUs are not recommended. Memory: The software requires a minimum of 2GB RAM per processor core. Note that the amount of RAMrequired is highly problem dependent. For simulations with large domains, or with complex geometry requiringfine resolution, significantly more RAM than the required minimum will benecessary. Memory speed has asmall effect on simulation time and typically 1333 or 1600 MHz memory is adequate. Graphics: The FlowSight postprocessor works best with a workstation card. nVidia Quadro K series cardsor AMD FirePro W series cards are highly recommended. nVidia’s GTX series 660 and above have showndecent performance on desktop and notebook machines. FLOW-3D for Windows requires at least 1GB of free disk space. On Linux operating systems, at least 1.2GBof free disk space is necessary. Additional space is required for simulation results, which can be upwards of100GB depending on the simulation.3

FLOW-3D User Manual, Release 11.1.0 Settings: Machines that run FLOW-3D should be set to a high-performance power setting to prevent the machinefrom sleeping or otherwise powering-down during long-running simulations. Additionally, using automatic filecompression utilities is not recommended.1.1.3 Licensing InformationLicensing RequirementsPlease ensure that you have a valid FLOW-3D license file or the name or IP address of your FLOW-3D license serverbefore beginning the installation. If you do not have a license file or a license server please contact your sales associateor [email protected] and provide the following information: The host name of the machine that will run the license server software Either the FlexID (if using a hardware dongle; the FlexID is printed on the side of the dongle) or the MACaddress of the machineIf the MAC address is not known: On Windows operating systems, the host name and MAC address can be found by opening the commandprompt and entering ipconfig /all. When multiple ethernet cards are present, multiple MAC addressesmay be listed in the output. The connected ethernet device or the first in the series is preferable. On Linux operating systems, typing /sbin/ifconfig in a terminal window will provide the MAC address,under the heading HWAddr. The host name can be found by entering the hostname command in a terminalwindow. When multiple ethernet cards are present, multiple MAC addresses may be listed in the output. eth0is usually best, but if you are unsure which MAC address to use, please send a text file or attach a screen capturewith the output of the command, and the License Administrator will determine the best option.Once the host name and MAC address or FLEXID have been received, the License Administrator at Flow Sciencewill send the license file (flow3d.lic) as an email attachment. It is an ASCII text file with encryption codes thatallow it to be used only on the computer or dongle for which it was generated. Check the license file to be sure that itcontains the host name and HOSTID that matches the license server. More information about licensing can be foundin the following sections on FlexNet License Administration Tools and Licensing Terminology.FlexNet License Administration ToolsFLOW-3D uses the licensing package FlexNet Publisher, by Flexera Software. FlexNet enables FLOW-3D licenses tobe shared across a network.Flexera Software provides utilities for users or local license administrators to manage FlexNet licensing activities. TheFlexNet End User Manual is available in the utilities subdirectory of the FLOW-3D installation in both PDFand HTML formats. For Windows computers, the program lmtools.exe is provided with all installations. WithLMTOOLS, users can start, stop and configure FlexNet license servers, get system information, get server information,and more. For more information, please see Chapter 12 of FlexNet End User Manual.On Windows computers, the license manager daemon lmgrd will restart automatically whenever the computer isrebooted. On Linux computers, however, the license manager must be started each time the computer is rebooted. Tohave the license manager start automatically on Linux requires editing the appropriate boot script and inserting theappropriate startup commands. See Section 6.2 of the FlexNet End User Manual for more information. A summary ofcommonly used administration tools on Linux is included here. Full descriptions of these and other available utilitiescan be found in Chapter 12 of the FlexNet manual. lmdiag - diagnoses license checkout problems Useful debugging command: lmutil lmdiag -n -c"full license file path" lmdown - gracefully shuts down all license daemons on the license server node.4Chapter 1. Installation, Licensing, and Configuration

FLOW-3D User Manual, Release 11.1.0 lmgrd - the main daemon program for FlexNet lmhostid - reports the HOSTID of a system lmreread - causes the license daemon to reread the license file and start any new vendor daemons lmstat - helps monitor the status of all network licensing activities Useful debugging command: lmutillmstat -a -c "full license file path" lmver - reports the FlexNet version of a library or binary fileNote: Using kill -9 to to shut down the license server on Linux computers is not recommended. Instead, use eitherlmdown or use the kill command without the “-9” parameter. The lmgrd license server is not supported on Red Hat Enterprise Linux 7Licensing Terminology Definition of Client and License Server: Any computer running FLOW-3D is referred to as a “client.” Thecomputer on which the FlexNet license server is installed will be referred to as the “license server.” The clientand server may be (and often are) the same machine. Software Package and Software Distribution: The terms “software package” and “software distribution” willbe used to refer to the directory structure containing all of the data files and executables needed to run FLOW-3Don a particular computer. License Files and Servers: A valid license file from Flow Science is required to use FLOW-3D. This licensefile will be sent as an email attachment from Flow Science’s License Administrator at [email protected] license file must be saved in the licenses directory of the FLOW-3D installation on the machine that will actas the license server. More detail about this is given in the Windows Installation and Linux Installation sectionsbelow.As discussed in Floating vs. Node-Locked Licenses, FLOW-3D can be used on multiple computers, but onecomputer must be selected to be the license server. If the computer chosen to be the license server will notactually be used to run FLOW-3D, then only the FlexNet license server needs to be installed on that machine.Also, if the FlexNet license server will be installed on a Windows computer, a licensing dongle that attaches tothe USB port of the computer will be provided by Flow Science. This key is enclosed in the FLOW-3D package.TokensThe total number of FLOW-3D solver processes that can be run concurrently is determined by the number of “tokens”contained in the license file. The number of tokens available depends on how many were purchased. The licenseserver checks tokens out to client computers on the network, and then checks them back in when the application hascompleted. In this process, tokens are counted by the license server and when all of the tokens purchased have beenchecked out, no more tokens can be checked out until a token which is in use has been checked in.There are several different types of solver tokens. The most important distinction is between “serial” solver tokensand “parallel” solver tokens. Flow Science offers multi-processor versions of FLOW-3D for both shared-memory(SMP) and distributed-memory (cluster) environments. A shared memory parallel solver token (shown in the license file as hydr3dp) enables FLOW-3D simulations using more than one processor on a multiprocessor computer.For the distributed-memory version, FLOW-3D/MP, a hydr3d or hydr3dp instance token is required as well ashydr3dmpi rank tokens. For example, to run a simulation on 16 processors using FLOW-3D/MP, the license filemust have a hydr3d token and 15 hydr3dmpi tokens. In special cases one or more serial solver tokens hydr3dmay be in the license file. These serial solver tokens will run the solver on a single processor and can be used oncomputers running any supported operating system.1.1. Installation5

FLOW-3D User Manual, Release 11.1.0There are essentially an unlimited number of tokens available to run FLOW-3D‘s auxiliary programs such as thepreprocessor, the postprocessor, and the various visualization options. The exception is for FlowSight, where twoflowsight tokens are provided for each hydr3d or hydr3dp instance token.Floating vs. Node-Locked LicensesThere are two general types of licenses used to enable FLOW-3D: “floating” and “node-locked.” A floating license isthe most common type of license and is available to any computer on the network. Flow Science can also provide anode-locked license. Node-locked licenses can only be used on the designated computer.Both floating and node-locked licensing schemes require that one computer be designated as the license server. Floating Licenses: To use floating licenses, it is important that both the network and the computer intendedfor use as the license server are reliable. The TCP/IP protocol must be loaded and functional, and all intendedclients must be able to access the license server. Floating licenses may also be accessed through a VPN tunnel.The computer that is acting as the license server may be any computer on the network, and does not need to haveFLOW-3D installed. The license server may be a Windows or a Linux computer. Users may load FLOW-3D onany client running a supported Linux or Windows computer on the network. A hardware key is not needed on aclient computer unless it uses a node-locked license.To employ a floating license on a single computer, FLOW-3D should be installed with the client/server option.The license server and the clients may reside on the same local area network, over a WAN, or across VPN.FLOW-3D must be installed locally on each client. An example of a floating license configuration is shownbelow. Node-Locked Licenses: Users may choose to have their solver tokens locked to a particular computer so thatonly that computer can run the solver.Both floating and node-locked licensing schemes have their advantages and disadvantages. A floating license is advised if several people are sharing a license, or it may be necessary to run FLOW-3D on a different computer if aparticular computer is busy. With a floating license, a problem can be set up on one computer while using another torun the FLOW-3D solver on a second problem. If other machines or problems are using all available tokens, the solver6Chapter 1. Installation, Licensing, and Configuration

FLOW-3D User Manual, Release 11.1.0will not run until a token becomes available. The main advantage of a node-locked license is the ability to ensure thattoken(s) are always available to a specific machine and not available to others on the network.Note: All licenses are floating licenses unless specifically requested as node-locked.1.1.4 ProcedureWindows InstallationNote: Administrator privileges are necessary to install FLOW-3D on Windows. Before installing, please close allother running programs. If installing on the Windows 8 operating system, please consult the Special Considerations for Windows 8and 8.1. Please note that third-party security software that includes a firewall, such as Norton 360, may interfere withlicense checkout and remote server operation. Ports that needs to be opened for proper operation are listed inthe licensing documentation below. If installing on a machine that has an earlier FLOW-3D version installed, please close any running copies ofRunnerServer.exe. This can be done by either:– Right-clicking the green “running person” icon in the system tray and choosing Quit.– Opening the Windows Task Manager and stopping any RunnerServer.exe processes shown inthe Processes tab. It may be necessary to click the Show Processes from All Users button to find theRunnerServer.exe process.The installation can be started by double clicking the downloaded flow3d v11.1.exe file.1. On Windows operating systems, a User Account Control dialog, similar to the one below, will appear. The“Verified publisher” entry should confirm that the executable has been digitally signed by Flow Science, Inc.2. Next, the Preparing to Install dialog will be displayed. It requires no user input and will disappear after severalseconds.1.1. Installation7

FLOW-3D User Manual, Release 11.1.03. The next dialog to appear is the Welcome screen. Click Next to continue.4. The next dialog is the FLOW-3D end user license agreement. Please read it carefully. If all the terms areacceptable, click the Next button to signify agreement and move to the next dialog.8Chapter 1. Installation, Licensing, and Configuration

FLOW-3D User Manual, Release 11.1.05. Now the install location can be chosen. The default directory can be used, or FLOW-3D can be installed to aspecific directory. Once the location is chosen, click Next. When installing to a different location, it is importantthat the directory name not contain spaces, ampersand characters, or multiple dots.1.1. Installation9

FLOW-3D User Manual, Release 11.1.06. The available features are shown. Individual features may be selected for installation by checking the appropriatebox. If this machine will connect to a remote license server, License Server should be left unchecked. This isequivalent to the Client Only installation in older FLOW-3D versions.Note: If this machine is intended to act as a remote server with the Remote Solving feature (see Remote SolvingSetup), FLOW-3D should be checked.7. If the License Server option was not selected, this dialog will be shown instead. It allows an IPv4 address ora server name to be specified for the license server. If unknown, the IP address can be found by opening thecommand prompt and entering ipconfig /all on the license server machine. The name can be determinedby opening a command prompt or terminal window and issuing the command hostname. When using ahostname, the server should respond to ping requests. The name required may differ based on the network.For example, a machine may respond to ping but not to ping host. If this is thecase, the full name must be used. If the hostname entered is not reachable, the client will not function.10Chapter 1. Installation, Licensing, and Configuration

FLOW-3D User Manual, Release 11.1.08. If the license server is being installed, FLOW-3D will ask to temporarily shut down any existing license servers.This allows the FLOW-3D license as well as FlexLM licenses from other vendors to be served. This can onlybe skipped safely when no other software that uses FlexLM licensing is installed, including older versions ofFLOW-3D.1.1. Installation11

FLOW-3D User Manual, Release 11.1.09. FLOW-3D is now ready to install.12Chapter 1. Installation, Licensing, and Configuration

FLOW-3D User Manual, Release 11.1.010. The FLOW-3D installer will copy the necessary files.11. Next, the installer will create firewall exceptions to allow communication to remote license servers and forremote solving.12. Finally, the Microsoft Visual C redistributables will be installed.13. The installation is now complete.1.1. Installation13

FLOW-3D User Manual, Release 11.1.014. After installation, an opportunity is presented to learn about new features.15. The FLOW-3D and FlowSight icons (if installed) will now appear on the desktop.16. Also, there will be a new Program Group in the Windows Start Menu. It includes tools and viewers appropriate14Chapter 1. Installation, Licensing, and Configuration

FLOW-3D User Manual, Release 11.1.0to the features that were installed.Special Considerations for Windows 8 and 8.1Flow Science highly recommends updating Windows 8 to version 8.1 Update 1 (or the newest version available)before installing FLOW-3D. On all versions of the Windows 8 operating system, including those which have been updated, the followingconsiderations apply:– Secure boot must be disabled for the Sentinel HASP USB drivers to /dn481258.aspx for the procedure.Please see– The “Creating Firewall Exceptions” dialog may not be shown. However, the firewall exceptions are created. When the Windows 8 operating system has not been updated, the desktop icons are not created by the installerautomatically.– One potential solution is to install a third-party Start Menu replacement, such as Classic Shell orStart8. If a Start Menu replacement is installed prior to installing FLOW-3D, the icons will be createdcorrectly.– Another option is to use the Modern interface All Apps view. This can be done by right-clicking the StartScreen, then clicking All Apps at the lower right.1.1. Installation15

FLOW-3D User Manual, Release 11.1.0There will be a Program Group for FLOW-3D.Right-click one of the icons and choose Pin to Start at the lower left to place the icon on the main StartScreen.The icon should now appear on the main Start Screen and can be used to launch the program.16Chapter 1. Installation, Licensing, and Configuration

FLOW-3D User Manual, Release 11.1.0Special Considerations for Remote DesktopWhen connecting to a remote desktop session, Windows uses software rendering by default. This impacts performancenegatively for both FLOW-3D and FlowSight. To determine whether FLOW-3D is using software rendering, chooseAbout from the FLOW-3D Help menu. The entry for GL RENDERER will show GDI Generic if software renderingis being used.If software rendering is being used, there are several options to enable hardware rendering. One easy option is to startFLOW-3D from the physical console, then connect the remote desktop session. Some VNC software uses hardwarerendering by default. Finally, the TSCON command can be added to the batch file used to launch FLOW-3D totemporarily pass control back to the console session. This option will be discussed.1.1. Installation17

FLOW-3D User Manual, Release 11.1.0To use TSCON, determine which session is connected. This can be determined using a query. Click the Start buttonand type cmd in the box labeled Search programs and files. Click cmd.exe when it appears at the top ofthis window to open a command prompt.At the prompt, type query session to receive a list of sessions. The relevant remote desktop session will be listedwith a greater than symbol to its left and show the username with which you logged in. In this example, user dev isconnected with a session ID of 1.18Chapter 1. Installation, Licensing, and Configuration

FLOW-3D User Manual, Release 11.1.0To connect session 1 (for example) to the console, add tscon 1 /dest:console to the beginning of the FLOW3D launch batch file (replace 1 with your session ID). To edit the batch file, right-click the FLOW-3D desktop icon andchoose Edit or navigate to %F3D HOME%\local, right- click flow3d.bat and choose Edit. In the resultingnotepad window, the line can be added. It should be placed before all other lines in the file.After editing the file, save it and launch FLOW-3D. The remote desktop session will be ended, and when reconnected,the hardware renderer should now be shown in the About menu.Some caveats:1. The TSCON command must be run as administrator. If Error 5 occurs, right-click the FLOW-3D desktopicon and choose Run as Administrator.2. The host machine must have an OpenGL-capable graphics card.3. Due to the graphics requirement, this will not work for virtual machines.4. The user must have a console session. This may not work after a reboot and is known not to work whenanother user is logged into the console session.1.1. Installation19

FLOW-3D User Manual, Release 11.1.0Special Considerations for Multi-User MachinesWhen not using Windows Server, FLOW-3D cannot be simultaneously run by more than one user. This is dueto inherent limitations of the Fast User Switching functionality of the operating system. For example, on aWindows 7 or Windows 8 operating system, if User A starts a FLOW-3D simulation, and switches to User B orthe Administrator account, another FLOW-3D simulation cannot be run by that user until the simulation launched byUser A is complete.As such, Windows Server or Linux operating systems are recommended if it is desired that multiple users be ableto run FLOW-3D simulations simultaneously.Linux InstallationFLOW-3D for Linux is distributed as a gzip-compressed tar archive, often called a tarball. The installationfiles can be extracted from flow3d v11.1.tar.gz in a terminal window, using the command tar -xzvfflow3d v11.1.tar.gz. The tarball can be unpacked into any directory on the filesystem using the -C flag. Forexample, to extract the tarball to /home/user, use tar -xzvf flow3d v11.1.tar.gz -C /home/user.Once in the directory where the installation files exist, or to which they have been unpacked, the can be run. A preceding dotslash may be necessary depending on whether the current directory is on the system PATH (i.e., ./ By default, this file is executable. FLOW-3D is onlysupported on 64-bit Red Hat Enterprise Linux 6 or greater. It may be possible to install on other distributions, but dueto potential library and package differences, Flow Science does not provide technical assistance on these distributions.Note: The FlowSight visualization software requires libstdc .so.5. This may be installed on RHEL6 orRHEL7 using the commandyum install compat-libstdc -33 The installation script must be run as root The default installation directory is /opt/flow3d/v11.11. Having the Linux Standard Base package installed allows the script to work best. This can be done using thecommands below.RHEL6: yum install lsbRHEL7: yum install redhat-lsb2. Execute the install script in the directory where the tarball was unpacked. For example, if viewing that directory,use the command ./ The license agreement can be read prior to installing the software.20Chapter 1. Installation, Licensing, and Configuration

FLOW-3D User Manual, Release 11.1.03. If all the terms are acceptable, typing y or yes and pressing Enter will continue the installation.4. FLOW-3D can be installed to a directory of your choosing. The default is /opt/flow3d/v11.1. Press Enterto use the default. To change the installation directory, enter a prefix PATH here and press Enter.1.1. Installation21

FLOW-3D User Manual, Release 11.1.0Note: A /flow3d/v11.1 suffix will be added to this prefix PATH. So, for example, if the desired full PATHis /usr/local/flow3d/v11.1 the prefix PATH would be entered as /usr/local5. After the directory has been determined, an installation type may be chosen.22Chapter 1. Installation, Licensing, and Configuration

FLOW-3D User Manual, Release 11.1.0Note: If this machine is intended to act as a remote server with the Remote Solving feature (see Remote SolvingSetup), an installation type that includes FLOW-3D should be chosen.6. Next, the script will display an installation summary, and request the name or IPv4 address of the licenseserver. This server machine must be accessible by the client. Unless networking is configured otherwise, pinghostname or ping (ip address) will verify whether the machine can be reached.Note: If a license server will be installed locally on this machine use The installation script will now install the RPMs that are needed for the selected Installation Type. It will alsowrite all the scripts needed to run the installed software.1.1. Installation23

FLOW-3D User Manual, Release 11.1.08. Finally, the install script allows the creation of desktop icons for root and/or users. Icons may be created for alist of users. List the users with a space between each username, as in the example.9. The installation will now complete.Shell scripts named and flow3dvars.csh, have been written into the local directory of24Chapter 1. Installation, Licensing, and Configuration

FLOW-3D User Manual, Release 11.1.0the installation path. The install script will write the full path to these files to both stdout and the install.logfile. If FlowSight was chosen, and FlowSight.csh have also been written in that directory.Again, the script will give full information.Necessary libraries are included with the distribution in the F3D HOME/gui/lib directory. TheLD LIBRARY PATH environment variable is set in the flow3dvars scripts so any libraries not found onthe system will be accessible.The install script also gives the source command that can be used to set up an environment to run FLOW-3D.The command may be added to the user’s .bashrc or .cshrc file, if desired. FLOW-3D can then be runfrom a terminal prompt using the command flow3d or flow3d&. Alternately, FLOW-3D may be launchedusing the shell script in the local directory.10. After installation, the installation directory will contain a directory structure similar to the one shown. A log ofthe installation, named install.log will be at the top level, and the scripts created by the installer will be inthe local directory.1.1. Installation25

FLOW-3D User Manual, Release 11.1.011. The file illustrates the environment variables that should be set to successfully run FLOW3D.Linux License Server: lmadmin26Chapter 1. Installation, Licensing, and Configuration

FLOW-3D User Manual, Release 11.1.0Installation For FLOW-3D v11.1.0, the lmgrd license server has been replaced with lmadmin. This new licenseserver has two main benefits. First, it is compatible with both Red Hat Enterprise Linux 6 and 7 (lmgrd was notcompatible with Consistent Network Device Naming, which was introduced with RHEL7). Second, it has a webbased interface. This interface is easy to use and may be configured to allow users to view detailed informationdirectly in a web browser.Note: lmadmin is a 32-bit executable and requires a number of 32-bit libraries. These are as follows: Linux Standard Base libstdc glibc libgcc1. Install 32-bit LSB; the commands differ between Red Hat versions. In this example, the operating system isRed Hat Enterprise Linux 7. These commands must be run as root: RHEL6: yum install lsb.i686 RHEL7: yum install redhat-lsb.i6862. Install the other needed 32-bit libraries. yum install libstdc .i6861.1. Installation27

FLOW-3D User Manual, Release 11.1.0 yum install glibc.i686 yum install libgcc.i68628Chapter 1. Installation, Licensing, and Configuration

FLOW-3D User Manual, Release 11.1.03. Navigate to the license server directory of the unpacked installation tarball.Note: The following steps should be performed as a user, not as root. Here, su was used to change to root, soexit is used to return to the user account.1.1. Installation29

FLOW-3D User Manual, Release 11.1.04. Execute lmadmin-i86 lsb-11 11 0 0.bin – if the directory is not on the PATH, a preceding dotslashwill be necessary.5. The graphical installer should then launch. Clicking Next will advance past the Introduction dialog.6. The installation directory is set here. For this example, the default will not work. Instead, the software will beinstalled to /home/flow3d/license server30Chapter 1. Installation, Licensing, and Configuration

FLOW-3D User Manual, Release 11.1.07. Next, the installer will prompt for previous installations. It should not be necessary to do anything here.8. A pre-installation summary will be displayed with the choices made in the earlier screens. Use Previous tocorrect any unintended choices, or Install to continue.1.1. Installation31

FLOW-3D User Manual, Release 11.1.09. The license server will be installed, and this screen will show the status of the installation.10. Next, the installer will prompt for ports. The HTTP port is where the web interface will be served. LicenseServer Port is where licenses will be served. In most cases, the defaults should be fine. However, the defaultlicense server port of 27000-27009 can sometimes conflict with other license servers. These may be eitherconsolidated, or the port may be changed here.The License Server Port can also be changed later using the web interface.32Chapter 1. Installation, Licensing, and Configuration

FLOW-3D User Manual, Release 11.1.011. It is convenient to start the server now, so this box should be checked. Clicking Next continues to the finalscreen.12. The final screen provides congratulations, and reiterates

FLOW-3D uses the licensing package FlexNet Publisher, by Flexera Software. FlexNet enables FLOW-3D licenses to be shared across a network. Flexera Software provides utilities for users or local license administrators to manage FlexNet licensing activities. The FlexNet End User Manual is