Documente Academic
Documente Profesional
Documente Cultură
Installation Guide
Suite 6.2
September 2012
Copyright 1998 2012: EM Software & Systems-S.A. (Pty) Ltd
32 Techno Avenue, Technopark, Stellenbosch, 7600, South Africa
Tel: +27-21-880-1880, Fax: +27-21-880-1936
E-Mail: feko@emss.co.za
WWW: www.feko.info
CONTENTS i
Contents
1 Introduction 1-1
1.1 Using FEKO LITE instead of the full version . . . . . . . . . . . . . . . . . . . . . 1-1
1.2 Installing the full version after using FEKO LITE . . . . . . . . . . . . . . . . . . 1-1
1.3 System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
1.4 Display settings and graphics cards . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
1.5 Contacting your distributor or EMSS . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
1.6 Updates to the documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
2 MS Windows installation 2-1
2.1 Installing FEKO for Windows in graphical interactive mode . . . . . . . . . . . 2-1
2.2 Installing FEKO for Windows in silent mode using the installation . . . . . . . 2-4
2.3 Installing FEKO for Windows in silent mode using the MSI database . . . . . . 2-5
2.4 Obtaining the FEKO licence le . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
2.5 Domain-based authentication (SSPI) with parallel FEKO . . . . . . . . . . . . . 2-6
3 MS HPC Solution: Windows HPC Server installation 3-1
3.1 Installing FEKO for MS Windows HPC in silent mode . . . . . . . . . . . . . . . 3-1
3.2 Silent Mode using the Installation Executable . . . . . . . . . . . . . . . . . . . . 3-1
3.3 Post-Installation Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
3.4 Starting Parallel FEKO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
4 UNIX / Linux workstation installations 4-1
4.1 Supported UNIX platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
4.2 Interactive UNIX installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
5 Floating licences 5-1
5.1 Concept of oating licences and general comments . . . . . . . . . . . . . . . . 5-1
5.2 Floating licence server installation and maintenance (Windows) . . . . . . . . 5-2
5.3 Floating licence server installation and maintenance (UNIX) . . . . . . . . . . . 5-4
6 Setup for remote launching and farming 6-1
6.1 Remote launching using SSH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1
6.2 Remote launching from Windows to Windows (simplied) . . . . . . . . . . . . 6-2
6.2.1 Manual steps, if not selected during installation of FEKO . . . . . . . . 6-3
6.2.2 Authentication aspects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3
7 Adobe Reader installation 7-1
Index I-1
September 2012 FEKO Installation Guide
INTRODUCTION 1-1
1 Introduction
This manual describes the installation procedures for FEKO on PCs and workstations, and also
covers advanced topics such as oating licences and remote launching. You should be able to
install the software successfully by following the on-screen installation instructions. However, it
is recommended that you work through the applicable installation procedures described here. If you
have technical questions, please contact your distributor (see section 1.5).
The installation copies the FEKO manuals to the doc subdirectory. These manuals are in PDF
format and a PDF viewer, for example the Adobe Reader, is required to view them. Installation
of the Adobe Reader is discussed in section 7. On MS Windows systems the FEKO installation
congures the GUI components to use the default PDF viewer, hence the PDF viewer should be
installed before FEKO. (It is, of course, possible to congure the PDF viewer in the GUI compo-
nents if it is installed / updated after installing FEKO, or if the installation detected an old version
which is no longer available.)
1.1 Using FEKO LITE instead of the full version
FEKO can be run in a mode called FEKO LITE. This is a limited version of the FEKO suite. All the
components of the suite, from the graphical user interfaces to the solver, are limited in capability
when running in this mode. Note that the LITE version of FEKO is not an evaluation version!
An evaluation licence will allow using an unlimited version of FEKO for 45 days. If you are
considering the purchase of FEKO, please contact your distributor for an evaluation licence.
A licence is required to run FEKO in LITE mode. If no licence is present, FEKO will run for a period
of 30 days. The FEKO licence is stored in the le secfeko.dat in the license subdirectory of
the FEKO installation.
A licence for the FEKO LITE mode can be requested from the FEKO web-site. The licence that
will be provided will expire after 1 year, at which time a re-registration is required. Once the
registration from is lled in, it will be submitted to the distributor for your region for processing.
Once the request is processed, a licence le will be sent to you via email.
You can register your copy of FEKO LITE at
www.feko.info/register_lite
FEKO LITE is limited with respect to problem size and can therefore run only about half the ex-
amples in the FEKO Examples Guide. Similarly, only a subset of the examples in the FEKO Getting
Started Manual can be used without modications. The FEKO LITE restrictions are available on
the FEKO website
1
.
1.2 Installing the full version after using FEKO LITE
If you have an installation of FEKO LITE, switching to the full version is simple. (Note that the
evaluation version is a full version which is limited only in the period for which it can be used.)
1
www.feko.info
September 2012 FEKO Installation Guide
INTRODUCTION 1-2
In order to create a FEKO licence for a computer, information about that computer is required.
During the installation of FEKO, a request le should have been created in the license subdi-
rectory of the FEKO installation. If this licence request le is not there, then under MS Windows
open the FEKO Licence Manager, secfeko_gui, and execute from the menu the command Info
Create request le. Under UNIX either run request.sh or use the FEKO Licence Manager
and use the menu item Info Create request le. If you are not able to create the request
le, then please obtain the machine code information by using menu item Info Machine code
info or by running secfeko -m in a console. Then send this information (licence request le
request or machine code information) by email or fax to your distributor. You will then receive
a le secfeko.dat which you must copy to the license subdirectory of the FEKO installation
(overwrite any such existing le there).
1.3 System requirements
Windows
The PC installation is for Microsoft Windows XP/Vista/7/8 or Server 2003/2008 running on
Intel Pentium/Xeon or AMD Athlon/Opteron or compatible processors. (Windows 98 and ME
are no longer supported.) Both 32-bit and 64-bit Windows versions of FEKO are also available
for IA32(Intel32), AMD64, EM64T (Intel64). The 32bit and 64bit versions are available on
Windows for all licence categories.
Depending on the specic installation options and the platform, the Windows installation requires
about 500 MByte . . . 2.1 GByte free hard disk space.
UNIX workstations (including Linux)
The workstation installation is for any of the major UNIX workstation platforms, including Linux.
This then includes 32-bit IA32 Linux, x86_64 Linux for EM64T (Intel64) and AMD64 available
with the BRONZE, SILVER and GOLD licence categories. Other platforms like IA64 / Linux and
IBM are also availble and require a PLATINUM licence category of FEKO).
1.4 Display settings and graphics cards
CADFEKO and POSTFEKO can be used with 256 colours, but a colour setting of at least 16 bits
is recommended. In addition, practical use of these components require a screen resolution of
1024768 or larger.
These components use OpenGL for rendering and this depends on the graphics card being used
and the drivers installed for it. With a properly installed graphics card that supports 3D hard-
ware rendering, a considerable speedup in visualisation should be seen. (See the graphics cards
documentation for information on OpenGL support.) Note that not all cards support OpenGL at
a all colour depths. A list of supported graphics cards that work with HOOPS (FEKO Suite 6.2)
are available at www.feko.info/GFXsupport.
In addition, CADFEKO and POSTFEKO can be congured to allow accurate rendering on most
graphics cards. In CADFEKO and POSTFEKO, select Settings Rendering options from the
September 2012 FEKO Installation Guide
INTRODUCTION 1-3
application menu to open the Rendering options dialog. Graphics cards may produce better (but
slower) results using software rendering. Face displacement allows a trade-off between edges
appearing broken and supposedly hidden lines being visible. More detail is given in the FEKO
Users Manual.
1.5 Contacting your distributor or EMSS
You can nd the distributor for your region at
www.feko.info/contact.htm
Alternatively, for technical questions, please send an email to
feko_support@emssusa.com for North America
feko_support@emss.de for Europe
feko_support@emss-china.net for China
feko_support@emss.co.za for all other regions
or, for activation codes and licence queries, to
feko_license@emssusa.com for North America
feko_license@emss.de for Europe
feko_license@emss-china.net for China
feko_license@emss.co.za for all other regions
1.6 Updates to the documentation
Changes to the functionality of the code in this release with respect to the previous release of
December 2011 (Suite 6.1.1) are indicated by adding a column in the margin. The changes are
indicated in two ways:
Sections that have changed from those in the previous version of the manual.
Sections that were newly added to this version of the manual.
September 2012 FEKO Installation Guide
MS WINDOWS INSTALLATION 2-1
2 MS Windows installation
Unless you install the 30-day unregistered version of FEKO LITE, FEKO requires a licence le (see
section 2.4). FEKO can only be installed on Windows machines (see section 1.3) by a user with
administrative rights. In addition, for the parallel version, you must have an account with the
same username and password on all the PCs you want to use or use domain-based security.
There are three different ways to install FEKO:
Graphical interactive mode
Silent mode using the installation executable
Silent mode using the embedded Microsoft Installer database
Note that the silent installation does not perform all the necessary setup steps (there are steps
that always require user input). FEKO will be installed, but the conguration must be completed
on all machines in the cluster. This can be done by editing the le machines.feko (located
in %FEKO_HOME%\mpi\share) and running mpiregister.bat (in %FEKO_HOME%\mpi\share)
on all the target machines. Note that it is only required to run mpiregister.bat when the
credentials have to be encrypted to the Windows registry.
After completing the installation, the examples in the FEKO Getting Started Manual should be
consulted for a step-by-step introduction to the basic operation of FEKO.
2.1 Installing FEKO for Windows in graphical interactive mode (recom-
mended)
There are two FEKO installations for MS Windows:
Platform Filename
32-bit Intel/AMD x86 feko_distrib_xx.yy_win32.exe
64-bit Intel EM64T or AMD x86_64 feko_distrib_xx.yy_win64.exe
where the xx.yy in the lename indicates the FEKO Suite number. The 64-bit installation auto-
matically detects the platform and installs the correct version of the executables (different opti-
mised executables are provided for AMD64 and EM64T). It is also, of course, possible to install
the 32-bit version on a 64-bit system, but then the 32-bit limits (such as allocating a maximum
of 2 GByte RAM) still apply.
If you have downloaded the installation executable, copy it to a temporary directory on your hard
drive and execute it.
If you have a FEKO DVD, insert it into your DVDROM drive. The FEKO installation program
should start automatically. (If not, execute startup.exe in the root directory of the FEKO
DVD.) Click Install 32-bit FEKO or Install 64-bit FEKO to install the corresponding version. Both
versions are available for all licence categories and users should install the correct version for
their system. (Note that the Install 64-bit FEKO button will be disabled when running on a 32-
bit system. If this button is disabled in error, the installation executable can be found in the
installs\windows directory.)
September 2012 FEKO Installation Guide
MS WINDOWS INSTALLATION 2-2
You must uninstall any existing versions of FEKO (prior to version 5.0) before continuing.
If you have FEKO 5.0 or later installed, the installation will automatically upgrade your
existing installation. (All user and licence les will be retained.) Please note that as of
Suite 5.5 FEKO supports side-by-side concurrent FEKO installations on Windows. You will
therefore be able to have 5.5 and later versions installed simultaneously. FEKO 5.4 or
earlier will however still be removed upon installation of Suite 5.5 or later.
If you already have FEKO Suite 5.5 or later installed on your computer, the Select up-
grade conguration dialog will be shown. Select the Install this version alongside all other
versions to install this version of FEKO side-by-side with all other versions currently on
the machine. If you want to remove all other versions, select the Upgrade to this version
option. You may also elect to manually choose which versions to keep or uninstall.
If you have selected the option to manually choose which versions to keep or uninstall,
the Select upgrade settings dialog will be shown. You will see a list of the current FEKO
installations on the machine. Here you can select which versions should be automatically
uninstalled by this installer. When you have nished and click Next the installer will try
to uninstall all the selected versions. Please wait for these uninstallation actions to nish
before proceeding.
The Choose destination location page is used to select the folder where FEKO will be in-
stalled. Because FEKO now supports side-by-side concurrent suite installations the default
installation location is now%ProgramFiles%\FEKO\xx.yy where xx.yy is the suite num-
ber. If you elect to always keep only one version of FEKO on your machine, you may remove
the xx.yy from the installation location.
Note that if you are installing the 32-bit version of FEKO on a 64-bit system you cannot
install it to the %ProgramFiles% folder, as this is reserved for 64-bit applications. If you
have selected the %ProgramFiles% folder the installer will automatically use the 32-bit
%ProgramFiles(x86)% folder.
The Select features page controls what is installed. FEKO (Solver and GUI) must be selected
if this PC will be used to setup and solve FEKO models.
Select Install as FEKO LITE to install a limited version that can be used for 30 days without
a licence. After 30 days you need to register FEKO LITE or switch to a full version. (See
section 2.4.)
If you purchased oating licences, you must install a Floating licence server on one server
in your network (see section 5).
If you purchased a dongle you must also install the drivers for it. To install the drivers,
select Dongle Drivers. This will also install the dongle server components, allowing you to
access the machine where FEKO is installed with a dongle licence via a Remote Desktop
connection.
The Choose a scratch directory page allows the user to determine where FEKO writes tem-
porary les during the out-of-core solution. This should be a directory which can accommo-
date very large les. This path is stored in the environment variable FEKO_TMPDIR which
may be modied if the temporary les should be written to a different location (such as
when a second hard disk is used to provide larger scratch space).
September 2012 FEKO Installation Guide
MS WINDOWS INSTALLATION 2-3
The Remote execution of the FEKO solver page allows you to specify whether the FEKO
temporary directory (which you specied on the previous page) should be a shared di-
rectory or not. If you enable sharing of the temporary folder, you will be able to use the
current computer as a remote host. What this allows you to do is to build your model
on one computer (where you maybe only have a SILVER or BRONZE licence, or a less
powerful CPU) and then run the FEKO solver on another computer (where you maybe
have a Gold licence or a more powerful CPU). The temporary folder will be shared as
\\%COMPUTERNAME%\feko_remote$ and have full permissions for Authenticated Users.
Guests or unauthenticated users will not have access by default.
Note that if you disable this option, you can still use remote launching using SSH (if SSH
is available on the computer). Please refer to section 6 for more information about setting
up remote launching via SSH.
The Custom installation options page allows you to choose whether you want to create
icons for CADFEKO and POSTFEKO on the desktop. You can also choose whether the in-
staller should associate the le types used by FEKO with this version of FEKO. This is useful
if you have other versions of FEKO installed and you want to preserve your associations.
You also have the option to let the installer automatically add Windows Firewall rules for
the parallel FEKO executables, the parallel services and the FEKO oating licence server,
depending on what features were selected. The rules will be created as follows for each
of the executables that require it: for TCP and UDP connections, allow incoming and out-
going connections on any local or remote port for any local or remote address from any
computer on your private networks. You can make the rules more strict using Windows
Firewall settings.
The Select parallel runs settings can be used to specify where parallel FEKO runs will be
performed. If you intend to perform parallel runs only on the local machine, select Run on
local machine only. Selecting this option allows you to perform parallel FEKO runs on a
multi-core CPU. The installer automatically inserts the detected number of cores/CPUs as a
default number, but this may be changed if you wish to run a different number of parallel
processes. If you have installed FEKO on a Windows cluster that is part of a Windows
domain and you intend to perform parallel runs on the cluster, select Run on a Windows
cluster, use Active Directory integration. If you have installed FEKO on a Windows cluster
that is not part of a Windows domain and you intend to performparallel runs on this cluster,
select Run on a Windows cluster, encrypt credentials into registry. If you also have FEKO
installed on a non-Windows cluster and you wish to perform parallel runs on that cluster,
select Run on a non-Windows cluster.
Depending on your selection in the Select parallel runs settings dialog, when the Next
button is clicked you may see a le [INSTALLDIR]\mpi\share\machines.feko being
opened in Notepad. You may use this to enter the names of all the machines that you will
be performing parallel runs on, as well as the number of parallel processes per machine.
Use the format MACHINE_NAME:PROCESSES, e.g. clustermachine.mydomain:4.
If you selected the option Run on a Windows cluster, encrypt credentials into registry you
will see an additional console window that you must use to enter the user credentials that
will be used for authentication on the cluster. The default username is the user that is
performing the installation, but you may enter any valid username/password combination
here. The credentials are encrypted and stored in the registry for use during parallel runs.
September 2012 FEKO Installation Guide
MS WINDOWS INSTALLATION 2-4
FEKO can be congured by setting certain environment variables. (See the FEKO Users
Manual for more details regarding changing initfeko.bat.) The installation already sets
the most common of these.
During setup a number of examples are copied to the subdirectory examples under the
FEKO installation. These may be used to test your FEKO installation and to provide exam-
ples of the various FEKO features. (For more detail consult the Examples Guide which may
be found in PDF format in the doc subdirectory of the FEKO installation directory.)
If you have installed FEKO and would like to change any of the installation options such as
adding or removing the oating licence server, simply run the FEKO installation again to modify
the installation.
For parallel solver runs FEKO uses MPI (Message Passing Interface). Three MPI implementations
are supported on Windows, namely Intel MPI, MPICH2 and MS-MPI. The installer sets Intel MPI
as the default on all systems except Windows HPC, where MS-MPI is used by default. This
may be changed at any time by either setting the environment variable FEKO_WHICH_MPI or
my modifying the value of the variable initfeko_FEKO_WHICH_MPI in the le initfeko.bat
located in the %FEKO_HOME%\bin directory. Possible values for the variables are listed below.
Intel MPI: This is the recommended MPI implementation to use (default for most plat-
forms). It supports SMP (Symmetrical Multi-Processing) and all communication protocols
like Ethernet, GigaBit Ethernet, but also Myrinet or Inniband through DAPL. Select Intel
MPI by setting FEKO_WHICH_MPI=11.
MS-MPI: This MPI implementation is provided by Microsoft, and it provides tighter inte-
gration with the Windows HPC (High-Performance Computing) job scheduler. Note that
this is not available in general on Windows systems, as it is a part of the Microsoft HPC
Server 2008 and Windows Compute Cluster Server 2003. MS-MPI is selected by setting
FEKO_WHICH_MPI=13.
MPICH2: This MPI implementation should normally not be used, and it is provided as fall-
back if trouble with Intel MPI is observed (e.g. bad parallel performance of one solution
phase). MPICH2 is selected by setting FEKO_WHICH_MPI=1.
Advanced users might want to read the MPI documentation that is provided in the directory
mpi\<mpi-version>\doc of the FEKO installation directory. For instance for Intel MPI addi-
tional hints are given on how to install DAPL drivers for interconnects like Myrinet or Inniband.
Regarding the usage of the parallel FEKO version (i.e. how to run parallel FEKO, how to specify
which nodes to be used and how many processes, how to set specic MPI options etc.), please
refer to the corresponding section in the FEKO Users Manual.
2.2 Installing FEKO for Windows in silent mode using the installation exe-
cutable
The FEKO installer for Windows can also be installed in silent mode using the provided installa-
tion executable. This mode is used to install FEKO without manually going through the installa-
tion dialogs.
September 2012 FEKO Installation Guide
MS WINDOWS INSTALLATION 2-5
To use the installer in silent mode, a response le must rst be created. The response
le only needs to be created once, and can then be used on all the target machines. The
FEKO DVD contains a template response le called setup.iss. This le is located in the
installs\windows directory on the DVD. Copy this le to a temporary location on the
target computers hard drive. This le contains the header information required by the
installer when running in silent mode.
The next step is to run the installer in record mode. Launch the installer as follows:
feko_distrib_xx.yy_winNN.exe /r /f1"C:\Temp\setup.iss"
where "C:\Temp\setup.iss" species the absolute path to the setup.iss le. This will
launch the installer in record mode and record all the steps followed (selecting installation
directory, installed components etc.). Note that this will install FEKO on the computer that
is used to create the response le.
The completed setup.iss le can now be copied to all the target machines along with
the installation executable. To install FEKO in silent mode on a target machine, launch the
installer as follows:
feko_distrib_xx.yy_winNN.exe /s /f1"C:\Temp\setup.iss"
where "C:\Temp\setup.iss" species the absolute path to the setup.iss le. The
installation will complete without any user input.
2.3 Installing FEKO for Windows in silent mode using the MSI database
The last mechanism provided to install FEKO silently uses the embedded MSI le directly.
The FEKO installer (feko_distrib_xx.yy_winNN.exe) contains a MSI database. This
must rst be extracted before it can be used. To extract the MSI database, launch the FEKO
installer normally (i.e. by double-clicking it or just typing
feko_distrib_xx.yy_winNN.exe
at a command prompt). When the welcome screen is displayed, click the Cancel button
and abort the installation. The FEKO MSI database can then be found under
%ALLUSERSPROFILE%\FEKO\[GUID]\ (Windows Vista and later) or
%ALLUSERSPROFILE%\Application Data\FEKO\[GUID]\ (Windows XP). Copy this le
to all the target machines. Note that FEKO is NOT installed on the machine that the le
was extracted on.
On the target machines, open a command prompt and change directory to the location of
the MSI database. Then launch the Windows installer as follows:
msiexec /i "feko_distrib_xx.yy_winNN.msi" /qb+ [variables]
where [variables] may optionally contain
INSTALLDIR=Drive:\Path : The path where FEKO must be installed. The default
is C:\%ProgramFiles%\FEKO\xx.yy.
FEKO_USER_HOME="C:\FEKO" : The location of the FEKO user les. The default is
%APPDATA%\feko.
September 2012 FEKO Installation Guide
MS WINDOWS INSTALLATION 2-6
CF_DESKTOP=1 and/or PF_DESKTOP=1 : Specify these variables to let the installer
create desktop shortcuts for CADFEKO and POSTFEKO respectively.
ADDFWEXCEPTIONS=0 : Specify this option to prevent the installer from automatically
adding exception rules to the Windows Firewall for the parallel FEKO executables. If
you do not specify this option, the rules will be added by the installer.
and must contain
FEKO_TMPDIR=C:\Temp : The path to the directory where FEKO will store tempo-
rary les.
FEATURES=... : The features to install. Specify any of the following items in a
comma-separated list:
Kernel
Lite
LicenceServer
DongleDrivers
Note that you must not specify Lite and LicenceServer together.
Note that you may also specify /qn, /qn+ or /qb instead of /qb+.
Please use double-quotes around all path values to avoid errors with paths that contain
spaces.
2.4 Obtaining the FEKO licence le
The installation program should have created the le request in the license subdirectory of
the FEKO installation. If it does not exist, this le can be created by starting the FEKO Licence
Manager, secfeko_gui, and from the menu executing the command Info Create request le.
Edit the le enter the information requested at the top thereof and email or fax it to your
distributor (see section 1.5). You will then receive a licence le secfeko.dat which must be
placed in the license subdirectory of the FEKO installation to activate your licence. (You can
run an unregistered version of FEKO LITE the GUI components will switch automatically if no
licence is found for a period of 30 days until you obtain this le. After 30 days you also need
a licence le to run FEKO LITE.) If you are using oating licences the procedure is the same, but
you may need to edit this le, see section 5).
If you want to switch to an evaluation version after running FEKO LITE, you need to create and
send the request le to your distributor as mentioned above. Then overwrite the existing le
secfeko.dat with the new one obtained from your distributor.
2.5 Domain-based authentication (SSPI) with parallel FEKO
When running parallel FEKO involving multiple machines, the processes must be authenticated.
FEKO on Windows uses MPI implementations which offer different possibilities for the authenti-
cation. These are available in the GUI for each run. (Detailed explanation about these options
are available in the FEKO Users Manual.)
September 2012 FEKO Installation Guide
MS WINDOWS INSTALLATION 2-7
For machines in a Windows (Active Directory) Domain there is also the SSPI authentication
method provided, which makes use of integrated domain mechanisms that do not need to have
the encrypted username and password saved in the registry. However, there may be conguration
settings required in the Active Directory and the member machines to prepare the domain and
computers for this kind of authentication (please contact your domain administrator).
Details about the required settings are given in the MPI documentation of Intel MPI (User Autho-
rization Active Directory Setup) and MPICH2 (Runtime Environment Security) shipped in
the directory mpi\<mpi-version>\doc of the FEKO installation directory.
September 2012 FEKO Installation Guide
MS HPC SOLUTION: WINDOWS HPC SERVER INSTALLATION 3-1
3 MS HPC Solution: Windows HPC Server installation
The installation and conguration of FEKO on the Microsoft HPC solution "Windows HPC Server
2008" are detailed below.
Note: The rst version of this platform was named "Windows CCS Server 2003" (Compute Cluster
Server) which is now replaced by the version 2 of this product named "Windows HPC Server
2008" edition.
3.1 Installing FEKO for MS Windows HPC in silent mode
The silent mode using the installation executable (as available form the FEKO website) will be the
preferred way of (un-)installing FEKO on Microsoft Windows HPC. With this option, additional
steps will be performed which will ensure proper functionality. With the MSI-based option, these
steps might have to be run manually after the (un-)installation has been completed.
3.2 Silent Mode using the Installation Executable
First do an interactive installation on a node (preferably on a test machine or the head
node) and record all the settings into an answer le which is then is used to perform the
unattended installation on all the cluster nodes (see section 2.2 for details). This setup
is started using the following command (where xx.yy refers the major and minor version
number for the current release):
feko_distrib_xx.yy_win64.exe /r /f1"C:\Temp\setup.iss"
Note that if the head node is not a compute node, then performing this interactive installa-
tion (with recording the settings) is best done directly on the head node where FEKO then
will also be available.
Next the installation le "feko_distrib_xx.yy_win64.exe" and also the setup answer
le "setup.iss" have to be made available on a shared network location to be reachable
by all the cluster nodes in the following steps. For the following assuming the location to
be \\server\share.
Then one can start the unattended installation on all the cluster nodes from the head node:
clusrun start /wait "\\server\share\feko_distrib_xx.yy_win64.exe" /s /sms
/f1"\\server\share\setup.iss"
The clusrun tool is part of the Windows CCS / CCP toolset and readily available on the head
node. The above command will install FEKO on all cluster nodes, that are congured and
approved by the Windows Compute Cluster Administrator Management Console SnapIn. If
FEKO will be installed on a subset or a computer group, then please see the documentation
of the clusrun tool for additional command line options to be added to the above command.
Note that if the head node is not a compute node, then clusrun might not include the head
node in the execution of this command. Thus one will have to make sure that FEKO was
installed manually on this head node before starting the cluster installation (i.e. use the
head node as described above for recording the setup answer le in the rst step).
September 2012 FEKO Installation Guide
MS HPC SOLUTION: WINDOWS HPC SERVER INSTALLATION 3-2
The duration of the last step will be quite long (according to the number of cluster nodes that
have to be installed) and there will be no output available during this time, so please be patient.
At the end there will be an output for each of the nodes. There should also not be any error
messages displayed and preferably the return value must be 0 (zero) to indicate a successful
installation.
Uninstalling FEKO is done in the very same way: On one node (again preferably the head node)
start the uninstallation with recording to a setup an answer le (i.e. uninstall.iss). Then
repeat the above steps using this uninstallation answer le.
3.3 Post-Installation Steps
After the above procedure has been completed, FEKO is installed (on all nodes of the cluster)
and all additional required resources are installed and congured. However, there are additional
steps, depending on the licensing scheme and the user authentication. Additionally this might
also depend on how jobs will be submitted to the cluster (administrative policies, company poli-
cies, etc.).
Request File (for License Generation)
This le (%FEKO_HOME%\license\request) is only generated in the correct way if, dur-
ing installation from the head node, this head node was also installed with FEKO (see
above). Please check this le by opening in any text editor if it contains all the information
for all the nodes of the cluster (including the head node). This le has to be submitted to
EMSS for license generation.
If that is not the case, then please run the following le:
%FEKO_HOME%\bin\request.bat on the head node. This will then create the correct le
with all information on the head nodes license subdirectory.
FEKO License File
The FEKO license le (secfeko.dat) must be copied to all the nodes where FEKO is
installed. you will receive this le from EMSS after you submitted the "request" le
containing all required information. This le has to be placed in the following direc-
tory: %FEKO_HOME%\license. The easiest way to do this is to place it on a share (e.g.
\\server\share) and then running the following command from the head node:
clusrun copy "\\server\share\secfeko.dat" "%FEKO\_HOME%\license"
The user is now ready to run on parallel FEKO computations on this cluster.
3.4 Starting Parallel FEKO
There are many ways to submit a job to the HPC system. Maybe there are also company policies
enforcing a special way of submitting, thus only the basic way will be discussed in this manual.
The cluster administrators should then be able to incorporate this into their means of submitting
jobs.
General notes:
September 2012 FEKO Installation Guide
MS HPC SOLUTION: WINDOWS HPC SERVER INSTALLATION 3-3
Jobs can be submitted from either the head node or from any machine having access to the
cluster and having the Windows Compute Cluster Pack (CCP) tools installed.
The machine from where a job is being submitted does not necessarily need to have FEKO
installed (but mostly it will be there because of pre- and postprocessing).
The model les must be accessible via network from the cluster nodes.
The real command in the submitted job/task is then:
"<path to FEKO installation folder>\bin\runfeko.exe" "<modelname>" --use-job-scheduler
All options (e.g. regarding which machines to use and how many nodes will participate in
this run) have the to be specied when submitting/creating this job/task. This can be done
in any way and has to be provided by the cluster administrator.
The following will discuss submitting/running a simple example from the command line:
As an example, assume the following situation:
FEKO is installed in C:\Program Files\FEKO\xx.yy.
The model lename is example_1.pre.
The model is located on a shared network location at \\server\share.
There are four nodes participating in the parallel run.
The command to launch this would be (all in one line):
job submit /numprocessors:4-4
/jobname:FEKO_testjob_1
/workdir:\\server\share
/stdout:\\server\share\example_01.stdout
/stdErr:\\server\share\example_01.stderr
"C:\Program Files\FEKO\xx.yy\bin\runfeko.exe" example_01 --use-job-scheduler
This then creates a task with one single job and runs this immediately (if resources are available)
on this cluster. All information is being read from and written to the directory where the model
is located. Also the normal output (STDOUT) and the error messages (STERR) are redirected into
les and will thus be available for later checking after the computation was completed.
September 2012 FEKO Installation Guide
UNIX / LINUX WORKSTATION INSTALLATIONS 4-1
4 UNIX / Linux workstation installations
To install FEKO on a Linux or UNIX workstation (both parallel and sequential versions) the FEKO
installation script must be executed, see below for detailed instructions. Note again that the pre-
and post processing support components are currently only available on Windows and Linux PCs.
4.1 Supported UNIX platforms
The UNIX platforms currently supported are summarised below. A parallel version of FEKO is
available for all these platforms. For FEKO on other workstation platforms please contact your
distributor, a port might be available or can maybe be made available. The indicated lename
is relevant only if you are not installing directly from the FEKO DVD. The string xx.yy in the
lename indicates the FEKO Suite version.
Platform Filename
Linux (32-bit Intel/AMD x86) feko_distrib_xx.yy_LINUX.tar.gz
Linux (64-bit on Intel Itanium IA64) feko_distrib_xx.yy_LINUX_IA64.tar.gz
Linux (64-bit on Intel EM64T) feko_distrib_xx.yy_LINUX_EM64T.tar.gz
Linux (64-bit on AMD x86_64) feko_distrib_xx.yy_LINUX_AMD64.tar.gz
IBM AIX (64-bit on PowerPC) feko_distrib_xx.yy_IBM.tar.gz
4.2 Interactive UNIX installation
The following procedure can be used to install FEKO on a new workstation or to perform an
update of an existing installation (in the case of an update, a backup of the old installation
is created automatically). If you have technical questions, please contact your distributor (see
section 1.5).
The default FEKO installation path is /opt/feko/xx.yy where xx.yy represent the ma-
jor and minor suite versions. Of course any other directory can be specied during the
interactive installation process. Make sure at this stage that you have write permissions on
the directory where you want to install FEKO. In most situations, one might have to change
to the root user, in particular if FEKO is to be installed in a global directory accessible by
more than one user.
For the next step, we distinguish between three different situations:
a.) You have received FEKO on a DVD, and the workstation where you want to install
FEKO has a DVDROM drive. Then you can install directly from the DVD. Load the
DVD on this workstation and mount it. The command for this is system dependent,
for example
mount /dev/hdc /mnt/dvddrom
(check for your system). It is assumed that the DVD has been mounted to /mnt/dvdrom,
then simply execute the FEKO installation script
September 2012 FEKO Installation Guide
UNIX / LINUX WORKSTATION INSTALLATIONS 4-2
cd /mnt/dvdrom/installs/unix
sh ./INSTALL.SH
which will guide you step by step through the installation process. Note that the mount
options may inuence the case of le and directory names please use ls to determine
the case of the directory and le names if it is not the same as above. (The installation
script will account for both cases.)
b.) If you have received FEKO on a DVD, but cannot read the DVD from your worksta-
tion, then copy the appropriate *.tar.gz le for your platform (see table in sec-
tion 4.1, e.g. feko_distrib_xx.yy_LINUX.tar.gz for the FEKO Suite xx.yy for
Linux PCs) from the subdirectory installs/unix/archives on the DVD to a tem-
porary directory on the workstation (you may temporarily need up to 620 MByte of
disk space there). This can be done for instance by reading the DVD on a PC, and
transferring the le via ftp (binary mode) to the workstation, or by using a shared
network drive.
c.) If you have not received FEKO on a DVD, but rather downloaded the installation le
(e.g. feko_distrib_xx.yy_LINUX.tar.gz for Suite xx.yy for Linux PCs) directly
fromthe FEKOwebsite, then put this le in a temporary directory on your workstation.
In the following section it is assumed that this directory is /tmp.
Then proceed as follows (this is an example for 32-bit Linux PCs, substitute the correct
lenames for your platform and note again that the GUI is available only for Linux):
cd /tmp
gunzip -c feko_distrib_xx.yy_LINUX.tar.gz | tar -xf -
cd feko_install
sh ./INSTALL.SH
This will start the installation script. The installation script will guide you step by step
through the installation process.
Once the installation is nished, the temporary les in /tmp/feko_install can be
deleted. Also see the instructions given to you online.
The component selection allows the user to select which features of the FEKO Suite should
be installed on the machine:
a.) Full Product installs all features of the FEKO Suite.
b.) Floating Licence Server Only installs only the oating licence server and the required
les (including the automatic updater), but no Kernel and no GUI applications will
then be available and thus neither any computations nor any pre- or postprocessing
can be done on that machine.
Choosing this option saves space on the harddisk if only a licence server is to be setup.
To activate the FEKO oating licence server, additional steps are necessary (see section 5.3).
The section of the installation script that installs the parallel version of FEKO allows the
user to select the interconnect type and MPI (Message Passing Interface) version to be used,
whether rsh (remote shell) or ssh (secure shell) should be used for remote operations, and
also selecting the nodes in a cluster with the number of CPUs available on the nodes.
For parallel clusters, the FEKO installation script will also automatically copy the FEKO
installation to all nodes on the cluster if not available there via NFS or so (thus as opposed
to Windows a separate installation on each node is not required).
The different MPI versions which is supported by FEKO are listed here:
September 2012 FEKO Installation Guide
UNIX / LINUX WORKSTATION INSTALLATIONS 4-3
Platform Filename
Linux (32-bit Intel/AMD x86) MPICH, Intel MPI
Linux (64-bit on Intel Itanium IA64) SGI MPI