ProCAST 2021-5 InstallationGuide

ProCAST
Installation Guide
version
2021.5
ProCAST 2021.5
Installation Guide
© ESI Group, 2021
Published: December 2021
DocID: GR/PRCA/21/004/00/A
BuildID: R40019S20211222T1712Z
This documentation is the property of ESI Group and is protected by intellectual property laws.
Any reproduction of this document or communication to third parties, unless expressly authorized
in writing by ESI Group, exposes its author to legal proceedings.
This documentation is subject to limited distribution and restricted disclosure.
All PAM- and SYS- product names as well as other products belonging to ESI 's portfolio are
tradenames or trademarks of ESI Group, unless specifically mentioned.
All other trademarks are the property of their respective owners.
Specifications are subject to change without prior notice.
Contents
Hardware and Software Requirements 1

Platform Support 1
Minimum Hardware Requirements 4
MPI Support 5
Memory Configuration 6
Software Installation on Windows 7

Launching Installation 7
Installing Licenses 8
Software Installation on Linux 13

Overview 13
Installation with the ESI Installation Wizard 15
Installing Licenses 17
Customizing Installation 22
Troubleshooting 25
Windows: What to Do if MAC Address is "FFFFFFFF"? 25
-i-
Hardware and Software Requirements
Platform Support
Platform Support
Platform Definitions
Platform types mentioned in this chapter are detailed below.
linux-libc217-x86-64
This platform is targeted at our 64-bit Linux x86_64 users.
CPU Any x86-64 processor that supports the AVX2 and SSE4.1 extensions
(such as the AMD Epyc and Intel Xeon)
Executable format 64-bit
Interpreter Bash interpreter
Libc Glibc-2.17
Intel FORTRAN version 19.1.0.166
MPI availability Intel MPI Version 2018 Update 3 (default)

Intel MPI Version 2019 Update 11 (embedded)
License Daemon flexlm 11.16.2.1
windows-msvc142 -x86-64
This platform is targeted at our 64-bit Windows users.
CPU Any x86-64 processor that supports the AVX2 and SSE4.1 extensions
(such as the AMD Epyc and Intel Xeon)
Executable format 64-bit
Visual Studio version 2019
Intel FORTRAN version 19.1.0.166
MPI availability Intel MPI Version 2018 Update 3 (default)

Intel MPI Version 2019 Update 9 (embedded)
License Daemon flexlm 11.16.2.1
ProCAST 2021.5 Installation Guide -1-

© ESI Group, 2021
Platform Support
Validated Platforms
Validated platforms are platforms that were tested with ESI Group's software through a set of manual
or automated tests and that can properly run ESI Group's software.
linux-libc217-x86-64 windows-msvc142 -x86-64
ProCAST Solver l CentOS 7.8 l Windows 10 1809

l Windows Server 2016
QuikCAST Solver l CentOS 7.8 2003 (sanity l Windows 10 1809

check)
Visual-Environment l RedHat / CentOS 7 l Windows 10 1809

Graphical User Interface
(Visual-Mesh, Visual-
Cast, Visual-Viewer)
Compilation of user-defined functions are certified with Microsoft® Visual Studio Express 2017.
Supported Platforms
Supported platforms are platforms relying on the platform vendor 's compatibility rules and that should
run properly ESI Group's software.
ProCAST Solver l RedHat / CentOS 7 l Windows 10 from 1809

l RedHat / CentOS 8 l Windows Server 2016
l SUSE SLES 12 SP5 / 15 SP1 l Windows Server 2019
QuikCAST Solver l N/A l Windows 10 from 1809

Visual-Environment l N/A l Windows 10 from 1809

Graphical User Interface l Windows Server 2016
(Visual-Mesh, Visual- l Windows Server 2019
Cast, Visual-Viewer)
* N/A: Not available.
Not Supported Platforms

Not supported platforms are platforms relying on the platform vendor's compatibility rules and that
may not run properly ESI Group's software.
-2- ProCAST 2021.5 Installation Guide

© ESI Group, 2021
Platform Support
ProCAST/QuikCAST l RedHat / CentOS 5 l Windows Vista

Solvers l RedHat / CentOS 6 l Windows XP
l Windows 7 / 8
l Windows Server 2008 and 2012
Visual-Environment l N/A l Windows Vista

Graphical User Interface l Windows XP
(Visual-Mesh, Visual- l Windows 7 and 8
Cast, Visual-Viewer) l Windows Server 2008 and 2012
* N/A: Not available.
Two-year Plan for Platform Support

This information is based on ESI Group ’s current knowledge of its product's supported platform
evolution. It is intended for information purpose only.
2022 2023
Linux RedHat / CentOS 7 Supported Supported
Red Hat / CentOS 8 Supported Supported
SUSE SLES 12 SP5 / 15 SP1 Supported Supported
Windows Windows 10 from 1809 Supported Supported
Windows Server 2016 Not supported -
Windows Server 2019 Supported Supported

© ESI Group, 2021
Minimum Hardware Requirements
Minimum Hardware Requirements
RAM At least 4 GB
Hard Disk l At least 3 GB of free disk space recommended for complete installation of the
Space software
l For storage of the various projects, a minimum of several GB is recommended.
l For DMP computations, large disk space is required, because of the number of
restart files (one on each node).
Graphics l OpenGL hardware graphics accelerator (highly recommended).

Systems without an OpenGL graphics board will perform significantly slower.
l Super VGA monitor with the following settings:
o Minimum 1280 × 1024 screen resolution
o Small fonts selected
Other 3-button mouse (recommended with Intel / AMD systems as these versions support
wheel-driven dynamic zoom).

© ESI Group, 2021
MPI Support
MPI Support
Validated MPI Version

Validated MPI versions are MPI versions that were tested with ESI Group's software through a set of
manual or automated tests and that can properly run ESI Group's software.
Platform MPI Interconnect
linux-libc217-x86-64 l Intel MPI 2018.3 (default) l Mellanox Infiniband

l Intel MPI 2019.11 (embedded) l Intel Onmi-Path
windows-msvc142 -x86-64 l Intel MPI 2018.3 (default) -

l Intel MPI 2019.9 (embedded)
Supported MPI Versions

Supported MPI versions are MPI versions that should run properly ESI Group's software.
Platform MPI Interconnect
linux-libc217-x86-64 l Intel MPI 2018.3 (default) l Ethernet

l Intel MPI 2019.11 (embedded) l Mellanox Infiniband
l Intel Omni-Path
windows-msvc142 -x86-64 l Intel MPI 2018.3 (default) l Ethernet

l Intel MPI 2019.9 (embedded)

© ESI Group, 2021
Memory Configuration
Memory Configuration
The user configuration does not always allow the user to use hardware capabilities of the computer. It is
necessary to use the maximum value possible for datasize and stacksize for the solver and the user
interface. Therefore it is recommended to set datasize and stacksize limits to “unlimited” in the end-user
configuration.

© ESI Group, 2021
Software Installation on Windows
Launching Installation
1. Unzip the archive downloaded from myESI Customer Portal in a temporary directory.
2. Double-click ProCASTSetup.exe to start the software installation.
3. Follow the instructions displayed in the InstallShield Wizard dialog box.

© ESI Group, 2021
Installing Licenses
Installing Licenses
Getting your License(s)

Prerequisites
Before starting the license installation you should obtain a valid license file.
ProCAST 2021.5 software is version-protected and compiled with Flexera™ version 11.16.2.1.
You must have installed a license server running the same Flexera™ version or higher to be able to run
the software.
License files delivered for the previous versions may not be valid with this version of the software and
need to be updated to contain ProCAST 2021.5 features.
Retrieving Necessary System Information

System information must be retrieved before you can request your Flexera™ license files. Proceed as
follows to do so:
1. For each PC machine that will be running ProCAST 2021.5, execute the following command line:
c:\flexlm\lmtools.exe.
2. Select the System Settings tab.
3. Send all information in the Hostid Settings frame to your local ESI support representative.
4. Once you have received your license file(s), move it(them) to the appropriate c:\flexlm directory
on each machine with the pam_lmd.lic filename.

© ESI Group, 2021
Installing Licenses
If the hostid turns out to be "FFFFFFFF", refer to further details.
Starting Flexera™ License Server

The Flexera™ license server installation must be done with administrator privileges.
Once the ProCAST 2021.5 installation is completed, proceed as follows:
1. Move the pam_lmd.lic file to the c:\flexlm directory (if not already done).
2. Edit the pam_ lmd.lic file using any usual text editor to change $PAMHOME variable to
c:\flexlm\pam_lmd.exe on the line beginning with the VENDOR keyword.
3. Start the license server:
a. Execute c:\flexlm\lmtools.exe.
b. Go to the Service/License File tab and select Configuration using Services.
c. Select the Config Services tab, adjust parameters as shown below and click the Save Service
button.

© ESI Group, 2021
Installing Licenses
d. Select the Start/Stop/Reread tab and click the Start Server button.
After completing these installation steps, you may start using ProCAST 2021.5.
- 10 - ProCAST 2021.5 Installation Guide

© ESI Group, 2021
Installing Licenses
Additional specific Flexera™ documentation is provided with the software in the c:\flexlm
directory.
ProCAST 2021.5 Installation Guide - 11 -

© ESI Group, 2021
Software Installation on Linux
Overview
Overview
The following installation procedure are available to install ProCAST 2021.5 on Linux platforms:
l using the Graphical User Interface script paminst-gui.sh;
l using the command line script paminst.sh.
Sufficient privileges may be required by the system during the installation of ESI
Group products. Although no system library is updated in the process, sufficient
privileges are necessary to mount the DVD and install the boot files to start the
license server.
Both procedures consists of the following tasks:

1. Installing the software: all software files are copied from the DVD to the chosen location.
2. Setting the license file:
a. Installing the license file.
b. Starting the license daemons lmgrd and pam_lmd if needed.
c. Installing the license daemon startup scripts.
3. Customizing the installation by setting up the ESI Group software environment for each current
user.
Tasks 2 and 3 can be performed later if you do not want to do them immediately.

© ESI Group, 2021
Overview
After installation, files installed on the hard disk are organized in a directory tree as shown below.

© ESI Group, 2021
Installation with the ESI Installation Wizard
System Requirements
Supported Systems
The Installation Wizard is available for PC Linux x86_64 distributions with GlibC 2.12 or higher.
Prerequisites
The following is necessary to install the software properly:
l An X-compliant window system available on your display.
Position the DISPLAY environment variable for display on the current screen and, if necessary,
allow this display using an appropriate xhost command on the display host.
l About 15 Mb of free space in the /tmp directory to store graphical tools temporarily.
Proceed as follows:
1. After the graphical tools are loaded in /tmp, the main dialog box window appears.
2. Click the Install software button and click the Next button to continue.
3. Specify the installation directory in the Install in directory text field. By default, it is filled with the
path name used with the previous ESI Group software installation, if any. To change it, proceed
with one of the following methods:
o Fill in the text field with a valid path name directory (read, write, execute permissions are
required), or
o Click the Browse button to select a software installation location different from the default
one.
4. Click the Next button when you are satisfied with the software installation directory selected.
Selecting Components to be Installed

1. Select all packages you wish to install on the system by checking the corresponding boxes:

© ESI Group, 2021
o flexnet_v11.16.2.1: FlexNet v11.16.2.1 utilities for Linux platforms.

This package is required to start a license server when a floating license file is delivered. It is
not required for a demo or uncounted node-locked license files.
o VisualEnv-17.5_Linux64: Visual-Environment 17.5 (containing Visual-Cast, Visual-Mesh, and
Visual-Viewer) for Linux x86 64-bit processors
o ProCAST-QuikCAST-Solvers_Linux64 comprises the following solvers for Linux on x86 64-bit
processors:
n ProCAST 2021.5 DMP solver
n QuikCAST 2021.5 SMP solver
o PAMOPT- Solvers- 2021.0_ Linux64 : PAM- OPT 2021.0 solvers for Linux on x86 64- bit
processors
o ESIPlayer-4.5_Linux: ESI-Player 4.5 for Linux on x86 64-bit processors
2. Click the Next button to continue. The 'file downloading' window is displayed.
3. When downloading is finished, click the Close button in the bottom of the window to continue.
Installation of files is now completed.
4. In the displayed window:
o Click the Exit button if you wish to perform the license installation and software
customization later.
o Click the License management button to install the license. A license file is needed to
perform this task. For more details, refer to License Installation.
o Click the Define environment button to customize the software environment. For more
details, refer to Customizing Installation.

© ESI Group, 2021
Installing Licenses
Installing Licenses
System Requirements
Before starting the license installation you should obtain a valid license file.
ProCAST 2021.5 software is version-protected and compiled with Flexera™ version 11.16.2.1.
You must have installed a license server running the same Flexera™ version or higher to be able to run
the software.
License files delivered for the previous versions may not be valid with this version of the software and
need to be updated to contain ProCAST 2021.5 features.
The license installation should be performed on the system where the license server will run.
Launching License Installation

To launch the license installation with the ESI's Installation Wizard, proceed as follows:
1. Go to the software installation directory and type one of the following commands:
./paminst-gui.sh lic
or
./paminst-gui.sh install_lic
2. After the graphical tools are loaded in /tmp, the ESI Installation Wizard dialog box appears.
Getting the Host ID

Click the Get host id. button to get the system information (hostname, hostid) needed for the license
server (floating license) or standalone license (node-locked license) installation. The following window

© ESI Group, 2021
Installing Licenses
should be displayed:
Important remark on Linux i686 or x86_64 based distributions

The FlexNet Toolkit can only run on LSB3™ (Linux Standard Base™)-compliant Linux
distributions.
The 'LSB3 OS Compliant' detail must display 'Yes', otherwise your Linux distribution
cannot run a license server with this latest version of the FlexNet Toolkit.
Check that the following package is installed on the station:
l RedHat Based Operating Systems:
o For RedHat, CentOS, Oracle Linux, Fedora …: package redhat-lsb
o How to check installation: rpm -q redhat-lsb
o How to install it (as root or with sudo): yum install redhat-lsb
l SUSE Based Operating Systems:
o For SUSE Entreprise, openSUSE …: package lsb
o How to check installation: rpm -q lsb
o How to install it (as root or with sudo): zypper install lsb
l Debian Based Operating Systems:
o For Debian, Ubuntu …: package lsb
o How to check installation: dpkg -l lsb
o How to install it (as root or with sudo): apt install lsb

© ESI Group, 2021
Installing Licenses
Selecting License Files and License Installation Directory

By default, the Install licenses directory under directory text field is filled with the path name of the
previous ESI Group's software installation, if any.
1. Click the Browse button to redefine the path name of the software installation directory.
The directory specified in the text field should contain a licenses sub-directory with
write permission for the Next button to be available.
2. Click the Next button when the installation directory path is selected.
The license file is installed and the following window is displayed:
3. Click the Get another license file button to select a new license file.
4. Select Find file on a local disk in the displayed window and click OK.
5. Select the new license file and click the Open button to validate the selection.
By default, the file filter is set to find PAM license file format.

© ESI Group, 2021
Installing Licenses
A small window pops up displaying the checking result of the selected license file with the Host ID.
The dialog box of license file selection will be displayed again and filled in with information
corresponding to the selected license file:
6. Click the Apply changes to new file button and then the Save new file as current button.
The new license file is installed.
7. Click the Next button to start the license daemons.
8. Click the Start daemon now as current user button to start the daemon.

© ESI Group, 2021
Installing Licenses
Additional specific Flexera™ FlexNet documentation is provided with the software in the
installation directory.

© ESI Group, 2021
Customizing Installation
The ESI Group software installation script paminst.sh can be used for customization.
The customization script creates definitions to allow access to the executables and configuration files
for all users or for selected users, depending on the method selected.
The software configuration is defined in the following files:
l psi.Cenv for csh and derivatives;
l psi.Kenv for ksh and derivatives;
l psi.Baenv for bash.
sh is not supported due to its lack of functionalities necessary for ESI Group products.
We recommend to sh users to migrate to ksh which preserves sh syntax and habits.
This customization is done with pamcust.sh which can be used separately as well.
To perform the customization separately, proceed as follows:
1. Log in onto the machine on which you want to perform the customizations.
2. Change $PAMHOME variable to the directory where the installation was done.
3. Type ./pamcust.sh and follow the instructions.
The customization procedure will automatically update the .cshrc , .profile or .bash_
profile files accordingly, as shown below:
### ESI-Group begin ###

#
#ESI-Group Software environment
#setenv PAMHOME /home/ppg/ESIGroup
C Shell – .cshrc setenv PAMENV $PAMHOME/env-ùname`
if ( -r $PAMENV/psi.Cenv ) then
source $PAMENV/psi.Cenv
endif
### ESI-Group end ###

© ESI Group, 2021

#
#ESI-Group Software environment#
PAMHOME=/home/ppg/ESIGroup; export PAMHOME
PAMENV=$PAMHOME/env-ùname`; export PAMENV
if [ -r $PAMENV/psi.Kenv ]; then
Korn Shell – .profile . $PAMENV/psi.Kenv
fi
ENV=${ENV:””}
if [ -z “$ENV” ]; then
ENV=$HOME/.kshrc; export ENV
fi

#
#ESI-Group Software environment#
PAMHOME=/home/ppg/ESIGroup; export PAMHOME
PAMENV=$PAMHOME/env-ùname`; export PAMENV
Bourne Again Shell – if [ -r $PAMENV/psi.Baenv ]; then
.bash_profile . $PAMENV/psi.Baenv
fi
if [ -z “$BASH_ENV” ]; then
BASH_ENV=$HOME/.bashrc; export BASH_ENV
fi
4. Repeat this procedure for each candidate user.

© ESI Group, 2021
Troubleshooting
Windows: What to Do if MAC Address is "FFFFFFFF"?
Troubleshooting
Windows: What to Do if MAC Address is "FFFFFFFF"?
Issue Description
The licensing tools see my hostid as "FFFFFFFF" when using a Virtual NIC even though the ipconfig
command shows a different hostid for the Virtual NIC.
Workaround
Virtual NICs have been no longer supported since FlexNet 11.6.
This is not a bug, but a deliberate change in FlexNet software behavior.
Workaround is to un- team these Ethernet adapters or enable a disabled adapter or install a new
Ethernet adapter.
If not possible, "Disk Volume Serial Number" can eventually be used as server hostid.

© ESI Group, 2021
esi-group.com
All PAM- and SYS- product names as well as other products belonging to ESI's portfolio are tradenames or trademarks of ESI Group, unless specifically mentioned.
All other trademarks are the property of their respective owners - Specifications are subject to change without prior notice.
© ESI Group, 2021

ProCAST 2021-5 InstallationGuide

Uploaded by

Copyright:

Available Formats

ProCAST 2021-5 InstallationGuide

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

ProCAST 2021-5 InstallationGuide

Uploaded by

Copyright:

Available Formats

ProCAST

Hardware and Software Requirements 1

Software Installation on Windows 7

Software Installation on Linux 13

Hardware and Software Requirements

Executable format 64-bit

Interpreter Bash interpreter

Intel FORTRAN version 19.1.0.166

MPI availability Intel MPI Version 2018 Update 3 (default)

License Daemon flexlm 11.16.2.1

Executable format 64-bit

Visual Studio version 2019

Intel FORTRAN version 19.1.0.166

MPI availability Intel MPI Version 2018 Update 3 (default)

License Daemon flexlm 11.16.2.1

ProCAST 2021.5 Installation Guide -1-

linux-libc217-x86-64 windows-msvc142 -x86-64

ProCAST Solver l CentOS 7.8 l Windows 10 1809

QuikCAST Solver l CentOS 7.8 2003 (sanity l Windows 10 1809

Visual-Environment l RedHat / CentOS 7 l Windows 10 1809

linux-libc217-x86-64 windows-msvc142 -x86-64

ProCAST Solver l RedHat / CentOS 7 l Windows 10 from 1809

QuikCAST Solver l N/A l Windows 10 from 1809

Visual-Environment l N/A l Windows 10 from 1809

* N/A: Not available.

Not Supported Platforms

-2- ProCAST 2021.5 Installation Guide

linux-libc217-x86-64 windows-msvc142 -x86-64

ProCAST/QuikCAST l RedHat / CentOS 5 l Windows Vista

Visual-Environment l N/A l Windows Vista

* N/A: Not available.

Two-year Plan for Platform Support

Linux RedHat / CentOS 7 Supported Supported

Red Hat / CentOS 8 Supported Supported

SUSE SLES 12 SP5 / 15 SP1 Supported Supported

Windows Windows 10 from 1809 Supported Supported

Windows Server 2016 Not supported -

Windows Server 2019 Supported Supported

ProCAST 2021.5 Installation Guide -3-

Minimum Hardware Requirements

Graphics l OpenGL hardware graphics accelerator (highly recommended).

-4- ProCAST 2021.5 Installation Guide

Validated MPI Version

Platform MPI Interconnect

linux-libc217-x86-64 l Intel MPI 2018.3 (default) l Mellanox Infiniband

windows-msvc142 -x86-64 l Intel MPI 2018.3 (default) -

Supported MPI Versions

Platform MPI Interconnect

linux-libc217-x86-64 l Intel MPI 2018.3 (default) l Ethernet

windows-msvc142 -x86-64 l Intel MPI 2018.3 (default) l Ethernet

ProCAST 2021.5 Installation Guide -5-

-6- ProCAST 2021.5 Installation Guide

Software Installation on Windows

ProCAST 2021.5 Installation Guide -7-

Getting your License(s)

Retrieving Necessary System Information

-8- ProCAST 2021.5 Installation Guide

If the hostid turns out to be "FFFFFFFF", refer to further details.

Starting Flexera™ License Server