INSTALLATION & LICENSING · Section 2.3 describes how to install the Abaqus FlexNet Licence Server...
Transcript of INSTALLATION & LICENSING · Section 2.3 describes how to install the Abaqus FlexNet Licence Server...
INSTALLATION & LICENSINGfe-safe 2017
Contents
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 1-2
Table of Contents
1 Getting started ................................................................................................................................................................ 1-1
1.1 Getting the installation files .................................................................................................................................. 1-1
1.1.1 The fe-safe distribution DVD ............................................................................................................................ 1-1
1.1.2 The fe-safe software download ........................................................................................................................ 1-1
1.1.3 Documentation ................................................................................................................................................. 1-2
1.2 Deciding on your installation options .................................................................................................................... 1-2
1.2.1 Installation of a valid licence key ...................................................................................................................... 1-3
2 Using the fe-safe installer for product installation ........................................................................................................... 2-5
2.1 Installing the fe-safe application on a Windows operating system........................................................................ 2-5
2.1.1 Install fe-safe version ....................................................................................................................................... 2-5
2.1.2 Licence product .............................................................................................................................................. 2-14
2.2 Installing the fe-safe application on a Linux operating system ........................................................................... 2-14
2.2.1 Install fe-safe .................................................................................................................................................. 2-14
2.2.2 Licence product .............................................................................................................................................. 2-22
2.3 Installing the Abaqus FlexNet Licence Server on a Windows operating system ................................................ 2-23
2.3.1 Install Abaqus FlexNet Licence Server .......................................................................................................... 2-23
2.3.2 Install licence key ........................................................................................................................................... 2-28
2.4 Installing the Abaqus FlexNet Licence Server on a Linux operating system ...................................................... 2-29
2.4.1 Install Abaqus FlexNet Licence Server .......................................................................................................... 2-29
2.4.2 Install licence key ........................................................................................................................................... 2-34
2.5 Installing other products ..................................................................................................................................... 2-35
2.5.1 Installing the fe-safe Analysis Server Node.................................................................................................... 2-35
2.5.2 Installing the fe-safe Analysis Node Administration Utility .............................................................................. 2-35
2.6 Upgrading and reinstalling the product ............................................................................................................... 2-35
2.7 Multiple installations ........................................................................................................................................... 2-35
2.8 Uninstalling the product ...................................................................................................................................... 2-35
2.9 Command-line installation .................................................................................................................................. 2-38
2.9.1 Using the command line parameters ............................................................................................................. 2-38
2.9.2 Using the configuration file ............................................................................................................................. 2-39
2.9.3 Command-line Uninstallation ......................................................................................................................... 2-40
3 Licensing fe-safe products ............................................................................................................................................ 3-43
Contents
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 1-3
3.1 Licensing the fe-safe application .........................................................................................................................3-43
3.1.1 Licence timeout ..............................................................................................................................................3-45
3.1.2 Changing the default location of the licensing configuration ...........................................................................3-45
3.1.3 Specifying multiple License Servers ...............................................................................................................3-47
4 Configuring fe-safe for multi-user environments ...........................................................................................................4-49
4.1 Running simultaneous sessions of fe-safe from different user accounts ............................................................4-49
4.2 Running simultaneous sessions of fe-safe from the same user account ............................................................4-49
4.3 Running fe-safe locally from a remote installation ..............................................................................................4-50
4.4 Running simultaneous sessions of fe-safe on a remote host ..............................................................................4-50
Appendix A – System requirements .......................................................................................................................................... 1
Appendix B – Nomenclature ...................................................................................................................................................... 1
Appendix C – fe-safe Environment File ..................................................................................................................................... 3
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 1-1
Trademarks
fe-safe, Abaqus, Isight, Tosca, the 3DS logo, and SIMULIA are commercial trademarks or registered trademarks of
Dassault Systèmes or its subsidiaries in the United States and/or other countries. Use of any Dassault Systèmes or
its subsidiaries trademarks is subject to their express written approval. Other company, product, and service
names may be trademarks or service marks of their respective owners.
Legal Notices
fe-safe and this documentation may be used or reproduced only in accordance with the terms of the software
license agreement signed by the customer, or, absent such an agreement, the then current software license
agreement to which the documentation relates.
This documentation and the software described in this documentation are subject to change without prior notice.
Dassault Systèmes and its subsidiaries shall not be responsible for the consequences of any errors or omissions
that may appear in this documentation.
© Dassault Systèmes Simulia Corp, 2016.
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 1-2
Third-Party Copyright Notices
Certain portions of fe-safe contain elements subject to copyright owned by the entities listed below.
© Batelle
© Endurica LLC
© Amec Foster Wheeler Nuclear UK Limited
fe-safe Licensed Programs may include open source software components. Source code for these components is
available if required by the license.
The open source software components are grouped under the applicable licensing terms. Where required, links to
common license terms are included below.
IP Asset Name IP Asset
Version
Copyright Notice
Under BSD 2-Clause
UnZip (from Info-
ZIP)
2.4 Copyright (c) 1990-2009 Info-ZIP. All rights
reserved.
Under BSD 3-Clause
Qt Solutions 2.6 Copyright (c) 2014 Digia Plc and/or its
subsidiary(-ies)
All rights reserved.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 1-1
1 Getting started
The installation and licensing procedure will vary depending on whether you are installing in a Windows or Linux
environment. Follow the relevant heading in section 2 to install fe-safe on your machine.
Before you can begin installing your product you must get the installation files from either a DVD or by download
and decide on which method of licensing is appropriate for your needs.
1.1 Getting the installation files
The first step is to obtain the fe-safe installation files from your supplier; details below apply to products distributed
by Dassault Systemes / SIMULIA.
Software is distributed in a number of formats listed and described below.
1.1.1 The fe-safe distribution DVD
The fe-safe distribution DVD is used to install either fe-safe, safe4fatigue, one of the fe-safe Distributed Processing
options or the Abaqus FlexNet Licence Server.
Layout of the DVD
The installation DVD contains a series of sub directories:
The directory structure is provided for clarity and ease of use. The general directory contains files that are
common to most platforms. The other directories contain platform specific installation files and may not be present
depending on which version of the software is installed and which operating system is used.
Mounting the DVD on Linux
On most Linux platforms the CD/DVD will be mounted automatically as the disk is inserted. To mount it manually
the following command can be used (paths may vary):
mount /dev/device/cdrom
1.1.2 The fe-safe software download
Full software distributions (essentially the same as distributed on DVD) can be downloaded from the customer area
of the Dassault Systèmes portal provided by your local sales or support representative.
Occasionally, files for updating an existing installation of the software are available for download from the customer
area of the Dassault Systèmes portal provided by your local sales or support representative
The installation instructions in the following sections should be read in conjunction with any additional instructions
(release notes) provided with downloaded files.
Downloaded files are available only to customers with a current lease or maintenance contract.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 1-2
1.1.3 Documentation
When you install the fe-safe products the User Manual is installed to the installation directory. This can be
accessed from the Windows Start menu, the Help menu within the fe-safe application or from the documentation
directory within the fe-safe installation.
All fe-safe documentation, including the on-line help, is in Adobe Portable Document (PDF) format. This requires a
PDF viewer to be installed.
Acrobat® Reader can be downloaded free of charge from the Adobe Systems Incorporated web site, at
www.adobe.com.
Linux users should ensure that the BROWSER environment variable is set to the path of a pdf viewer installed on the
machine to be able to launch the documentation from within the fe-safe Help menu.
This should be applied through the profile settings for the default shell environment on the system, e.g;
For the bash shell, open the ~/.bashrc file in a text editor and add a line at the bottom of the file
export BROWSER=/usr/bin/firefox
where /usr/bin/firefox may be substituted for a suitable browser or dedicated pdf viewer in accordance with your
system configuration.
1.2 Deciding on your installation options
The next step for installing the software is to decide on which licensing option you require. This will depend on
whether you are using:
Standalone machine – local licensing for a single client
Networked machine – networked licensing for multiple clients
fe-safe can be installed using network licensing or local licensing.
Note: Check the reference table in Appendix A for information on which platforms support specific licence
configurations.
Configuring client applications with a local licence service
You will use a local licence if you are using only one client machine for fe-safe applications (this client machine can
be standalone or network-attached).
For client applications with a local licence, a FlexNet/lmgrd process must be started on the client machine. The
required libraries and vendor daemon are installed with the fe-safe application if local licensing is selected. On
Windows the local service can be started automatically during client installation as described below. Otherwise, the
local service can be started after installation.
Configuring client applications with existing network licence service
You will use a networked licence if a Network Licence Server installation is or will be installed for licensing your
tokens to more than one client machine (a client machine can operate as the networked licence server if
necessary).
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 1-3
Networked Licence Server installation
You will use this option if you are installing the licence on a server for use on multiple client machines.
1.2.1 Installation of a valid licence key
You will need to obtain a licence key to enable the software. Contact your local Dassault Systemes support
representative to obtain the key, and place it in a directory where you have read and write access. Details on how
to configure local or network licence service can be found in section Error! Reference source not found..
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 1-4
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-5
2 Using the fe-safe installer for product installation
This section describes the installation procedures for the fe-safe application and license server
Section 2.1 describes how to install the fe-safe application on Windows operating system
Section 0 describes how to install the fe-safe application on a Linux operating system
Section 2.3 describes how to install the Abaqus FlexNet Licence Server on a Windows operating system
Section 2.4 describes how to install the Abaqus FlexNet Licence Server on a Linux operating system
Note: If being run from a Windows hosted shared location on a network, the installer will not function correctly if
there are per user access permissions granted.
If the permissions to the shared folder are set to Everyone the installer will operate as intended
2.1 Installing the fe-safe application on a Windows operating system
Ensure the current user profile has administrator privileges otherwise the licence and analysis servers cannot be
installed correctly and it may not be possible to install fe-safe to the default locations.
On Windows 7 and later operating systems, even if logged on as a user with administrator privileges, it is
recommended that the installer is started by right-clicking on setup.exe and selecting Run as Administrator.
Note: Where appropriate, the installer will attempt to configure Windows firewall exceptions automatically.
However, if exceptions are disabled, or a third party firewall is installed, the user will need to manually configure the
firewall.
Follow the steps in this section to install the fe-safe product on your computer.
2.1.1 Install fe-safe version
Initialising the installer
Once you have obtained the DVD or downloaded the installation files you can begin installing the product.
Running the installer from the DVD
Insert the DVD into the machine to initialise the installer.
If the Welcome page opens automatically cancel and go to the DVD drive directory and find the setup.exe file in
the root directory.
Right-click and select Run as Administrator to open the installer.
The Welcome page is displayed and you can begin configuring up your installation settings.
Running the installer from the downloaded files
Uncompress the downloaded files to a temporary location, then right-click on the setup.exe file in the temporary
directory and select Run as Administrator to open the installer at the Welcome page.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-6
Step 1 – Welcome
From the main screen of the Welcome page you can check which version of the software you are installing. On the
left is a list of the installation steps which is also displayed on every subsequent page.
Installer navigation guide
<< Back - Click on the Back button to go back a stage.
Cancel - You can stop the installation at any time be clicking on the Cancel button.
Continue >> - Click on the Continue button to move forward a stage.
Begin the process by clicking on the Continue >> button.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-7
Step 2 – Installing the products
The Products page lists all the products available for installation with your version.
Note: You will usually only need to install the first product – fe-safe Fatigue Analysis Application unless you are
installing the network licence server.
The fe-safe Fatigue Analysis Application product will be selected automatically when you first use the installer. If
you have already installed this product and need to install one of the others as well, click on the product you require
to select it.
Start installing the product by clicking on the Continue >> button.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-8
Step 3 – Selecting the components
The Components page lists all the components available for installation with the product you have selected. To
reduce the disk space required for the fe-safe installation, components that are not required (e.g. external
interfaces or tutorial models) can be deselected.
Move to the next step by clicking on the Continue >> button.
The Components page contents may appear differently depending on version.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-9
Step 4 – Selecting the installation directory
This page allows you to select a specific directory for your installation files if you do not want to use the default
location.
a) Choose an installation root directory
You can select the installation root directory from here. It is recommended that you use the default root
installation directory <RootDir>:
C:\SIMULIA
If you want to place your fe-safe installation in a different location select the Custom button and select a
directory using the … button or by typing it directly into the relevant field.
b) Choose a product installation directory
You can select the installation directory for the fe-safe products from here. It is recommended that you use the
default installation directory <InstallDir>:
<RootDir>\fe-safe\<version>
If you want to place your installation files in a different location select the Custom button and select a directory
using the … button or by typing it directly into the relevant field.
Note: It is recommended that the <RootDir> is retained and is the same for each fe-safe product installed.
Move to the next step by clicking on the Continue >> button.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-10
Step 5 – Selecting licensing type
The Licensing page allows you to select the required licensing type.
Note: You should already have decided on which licensing type you will be using before beginning installation, see
section 1.2.
The initial options are set to Auto-Detect Licensing. When left as this default fe-safe will attempt to find a valid
existing licensing configuration (e.g. from a previous installation or administrator configuration). If no configuration
is found, fe-safe will show the license configuration prompt when started.
Alternatively a specific licensing system can be chosen with the DSLS Licensing or FlexNet Licensing radio
buttons.
If you have chosen DSLS Licensing you should then ensure that the correct type of license is chosen, depending
on your maintenance contract.
When choosing FlexNet Licensing the Licensing type options will change.
If you are using a networked licence click on the Network button, if not already selected.
If you are using a local licence click on the Local: button and specify the location of your licence file if you have it
either using the … button or by typing the location directly into the relevant field.
Note: If you do not have your licence file you can configure local licensing later, see section Error! Reference
source not found..
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-11
Note: If the local licensing is selected the installer will attempt to install and register a local licence server and start
it automatically, however, if that fails, e.g. due to insufficient access privileges, the user will need to configure the
server manually, see section Error! Reference source not found..
Move to the next step by clicking on the Continue >> button.
Step 6 – Configuring the product
The Product Configuration page allows you to specify the working directory in which you want to store your
settings, and to configure default settings (this is optional).
a) Selecting a user settings directory
You can select the user settings directory for the fe-safe products from here. It is recommended that you use the
default installation directory which is in the subdirectory of the user’s Documents directory.
<UserDir>\fe-safe.<version>
In Windows it is the ‘My Documents’ or simply ‘Documents’ directory.
For example, the settings on Windows 7 for the user Joe Smith would be:
\My Documents\fe-safe.<version>
You can specify a different directory if preferred by clicking on the Specify Directory button and entering the
location using the … button or by typing the address directly.
If a location outside the user’s home or Documents directory is set the settings will be shared between all users
on that system.
Note: You must make sure the users have read/write access to the settings directory.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-12
b) Selecting optional User Settings Defaults
You can select a user settings file (*.stld) for configuring the default user settings in the fe-safe application here.
See the fe-safe User Guide for more details on how to configure default user settings.
c) Selecting optional Project Settings Defaults
You can select a project settings file (*.stld) for configuring the default project settings in the fe-safe application
here. See the fe-safe User Guide for more details on how to configure default project settings.
Move to the next step by clicking on the Continue >> button.
Step 7 – Reviewing the summary and installing the program
When you have set the installation and product settings you can run the installation.
Click on the Continue >> button to initiate the installation.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-13
The components and files installed will be displayed on the Installing page.
Step 8 – Finishing the installation
When the installation is complete the following screen is displayed. The Installation Complete page displays
information on the IP address and hardware ID (MAC ID). Make a note of these as they may be needed for
licensing.
Click on the Finish button to close down the installer.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-14
2.1.2 Licence product
You need to licence the product before you can use it. For information on how to licence your fe-safe product see
sections Error! Reference source not found. or 0.
2.2 Installing the fe-safe application on a Linux operating system
Write access to the installation directory is required to install the software on a Linux machine, but once installed
only read access to the installation area is required to run the software. Typically, the fe-safe application installation
is done by the root user but that is not required. However, installation to the default location requires root privileges.
Follow the steps in this section to install the fe-safe products on your computer.
2.2.1 Install fe-safe
Initialising the installer
Once you have obtained the DVD or downloaded the installation files you can begin installing the product.
Running installer from DVD
Use the install.sh script in the DVD root to launch the installer.
Run the script by changing directory to the DVD then using the following command:
csh ./install.sh
to open the installer at the Welcome page.
For example:
joesmith@localhost:~/linux_fe-safe_vx.yy> su
Password:
localhost:/home/joesmith/linux_fe-safe_vx.yy # csh ./install.sh
Running the installer from the downloaded files
Uncompress the downloaded files to a temporary location using the archive application or by issuing the following
command:
tar –xvf <filename> -C <target_directory>
Run the install.sh script using the following command:
csh ./install.sh
to open the installer at the Welcome page.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-15
Step 1 – Welcome
From the main screen of the Welcome page you can check which version of the software you are installing. On the
left is a list of the installation steps which is also displayed on every subsequent page.
Installer navigation guide
<< Back - Click on the Back button to go back a stage.
Cancel - You can cancel the installation at any time be clicking on the Cancel button.
Continue >> - Click on the Continue button to move forward a stage.
Begin the process by clicking on the Continue >> button.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-16
Step 2 – Installing the products
The Products page lists all the products available for installation with your version.
.
Note: You will usually only need to install the first product – fe-safe Fatigue analysis application unless you are
installing the networked licence server.
The fe-safe Fatigue Analysis Application product will be selected automatically when you first use the installer. If
you have already installed this product and need to install one of the others as well, click on the product you require
to select it.
Start installing the product by clicking on the Continue >> button.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-17
Step 3 – Selecting the components
The Components page lists all the components available for installation with the product you have selected. To
reduce the disk space required for the fe-safe installation, components that are not required (e.g. external
interfaces or tutorial models) can be deselected.
Move to the next step by clicking on the Continue >> button.
The Components page contents may appear differently depending on version.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-18
Step 4 – Selecting the installation directory
This page allows you to select a specific directory for your installation files if you do not want to use the default
location.
a) Choose an installation root directory
You can select the installation root directory from here. It is recommended that you use the default root
installation directory <RootDir>:
/usr/SIMULIA
If you want to place your fe-safe installation in a different location select the Custom button and select a
directory using the … button or by typing it directly into the relevant field.
b) Choose a product installation directory
You can select the installation directory for the fe-safe products from here. It is recommended that you use the
default installation directory <InstallDir>:
<RootDir>/fe-safe/<version>
If you want to place your installation files in a different location select the Custom button and select a directory
using the … button or by typing it directly into the relevant field.
Note: It is recommended that the <RootDir> is retained and is the same for each fe-safe product installed.
Move to the next step by clicking on the Continue >> button.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-19
Step 5 – Selecting licensing type
The Licensing page allows you to select the required licensing type.
Note: You should already have decided on which licensing type you will be using before beginning installation, see
section 1.2.
The initial options are set to Auto-Detect Licensing. When left as this default fe-safe will attempt to find a valid
existing licensing configuration (e.g. from a previous installation or administrator configuration). If no configuration
is found, fe-safe will show the license configuration prompt when started.
Alternatively a specific licensing system can be chosen with the DSLS Licensing or FlexNet Licensing radio
buttons.
If you have chosen DSLS Licensing you should then ensure that the correct type of license is chosen, depending
on your maintenance contract.
Move to the next step by clicking on the Continue >> button.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-20
Step 6 – Configuring the product
The Product Configuration page allows you to specify the working directory in which you want to store your
settings, and to configure default settings (this is optional).
a) Selecting a user settings directory
You can select the user settings directory for the fe-safe products from here. It is recommended that you use the
default installation directory which is in the subdirectory of the user’s Home directory.
$HOME/fesafe.<version>
For example, the settings on Linux for the user joesmith would be:
/home/joesmith/fe-safe.<version>
The settings on Linux for the user root would be the working directory passed as:
/root/fe-safe.<version>
You can specify a different directory if preferred by clicking on the Specify Directory button and entering the
location using the … button or by typing the address directly.
If a location outside the user’s home directory is selected the settings will be shared between all users on that
system.
Note: You must make sure the users have read/write access to the settings directory.
b) Selecting optional User Settings Defaults
You can select a user settings file (*.stld) for configuring the default user settings in the fe-safe application here.
See the fe-safe User Guide for more details on how to configure default user settings.
c) Selecting optional Project Settings Defaults
You can select a project settings file (*.stld) for configuring the default project settings in the fe-safe application
here. See the fe-safe User Guide for more details on how to configure default project settings.
Move to the next step by clicking on the Continue >> button.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-21
Step 7 – Reviewing the summary and installing the program
When you have set the installation and product settings you can run the installation.
Click on the Continue >> button to initiate the installation.
The components and files installed will be displayed on the Installing page.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-22
Step 8 – Finishing the installation
When the installation is complete the following screen is displayed. The Installation Complete page displays
information on the IP address and hardware ID (MAC ID). Make a note of these as they may be needed for
licensing.
Click on the Finish button to close the installer.
Note: Linux platforms with SELinux (Security Enhanced Linux) enabled, require executing the following commands
after installation and before running fe-safe:
>chcon -t unconfined_execmem_exec_t '/<InstallDir>/exe/fe-safe'
>chcon -t unconfined_execmem_exec_t '/<InstallDir>/exe/fe-safe_cl'
2.2.2 Licence product
You need to licence the product before you can use it. For information on how to licence your fe-safe product see
sections Error! Reference source not found. or 0.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-23
2.3 Installing the Abaqus FlexNet Licence Server on a Windows operating system
This option is used for installation of the Abaqus FlexNet Licence Server. The licence server software can be
installed in the same location as the analysis software if a machine is to be used for both purposes.
Ensure the current user profile has administrator privileges otherwise the licence server cannot be installed
correctly.
On Windows 7 and later operating systems, even if logged on as a user with administrator privileges, it is
recommended that the installer is started by right-clicking on setup.exe and selecting Run as Administrator.
Note: Where appropriate, the installer will attempt to configure Windows firewall exceptions automatically.
However, if exceptions are disabled, or a third party firewall is installed, the user will need to manually configure the
firewall.
Follow the steps in this section to install the Abaqus FlexNet Licence Server on your computer.
2.3.1 Install Abaqus FlexNet Licence Server
Initialising the installer
Once you have obtained the DVD or downloaded the installation files you can begin installing the product.
Running the installer from the DVD
Insert the DVD into the machine to initialise the installer.
If the Welcome page opens automatically cancel and go to the DVD drive directory and find the setup.exe file in
the root directory.
Right-click and select Run as Administrator to open the installer.
The Welcome page is displayed and you can begin configuring up your installation settings.
Running the installer from the downloaded files
Uncompress the downloaded files to a temporary location, then right-click on the setup.exe file in the temporary
directory and select Run as Administrator to open the installer at the Welcome page.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-24
Step 1 – Welcome
From the main screen of the Welcome page you can check which version of the software you are installing. On the
left is a list of the installation steps which is also displayed on every subsequent page.
Installer navigation guide
<< Back - Click on the Back button to go back a stage.
Cancel - You can stop the installation at any time be clicking on the Cancel button.
Continue >> - Click on the Continue button to move forward a stage.
Begin the process by clicking on the Continue >> button.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-25
Step 2 – Installing the products
The Products page lists all the products available for installation with your version.
The fe-safe Fatigue Analysis Application product will be selected automatically when you first use the installer,
ensure the Abaqus FlexNet Licence Server product is selected instead.
Start installing the product by clicking on the Continue >> button.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-26
Step 3 – Selecting the installation directory
This page allows you to select a specific directory for your installation files if you do not want to use the default
location.
a) Choose an installation root directory
You can select the installation root directory from here. It is recommended that you use the default root
installation directory <RootDir>:
C:\SIMULIA
If you want to place your fe-safe installation in a different location select the Custom button and select a
directory using the … button or by typing it directly into the relevant field.
b) Choose a product installation directory
You can select the installation directory for the fe-safe products from here. It is recommended that you use the
default installation directory <InstallDir>:
<RootDir>\License
If you want to place your installation files in a different location select the Custom button and select a directory
using the … button or by typing it directly into the relevant field.
Note: It is recommended that the <RootDir> is retained and is the same for each fe-safe product installed.
Move to the next step by clicking on the Continue >> button.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-27
Step 4 – Reviewing the summary and installing the program
When you have set the installation and product settings you can run the installation.
Click on the Continue >> button to initiate the installation.
The components and files installed will be displayed on the Installing page.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-28
Step 5 – Finishing the installation
When the installation is complete the Installation Complete page is displayed.
Click on the Finish button to close down the installer.
Note: The installer will attempt to register the Abaqus FlexNet Licence Server as a Windows service named Abaqus
FelxNet Licence Server and start it automatically, however, if that fails, e.g. due to insufficient access privileges,
the user will need to configure the server manually, see section Error! Reference source not found..
2.3.2 Install licence key
After installing the licence server software a licence key must be installed before the licence server can be started.
For information on how to licence your fe-safe products, see section Error! Reference source not found..
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-29
2.4 Installing the Abaqus FlexNet Licence Server on a Linux operating system
This option is used for installation of the Abaqus FlexNet Sicence Server. The licence server software can be
installed in the same location as the analysis software if a machine is to be used for both purposes.
Note: This section does not apply to products distributed through the Dassault Systemés SIMULIA network, for
those please refer to the Abaqus Installation and Licensing Guide for licensing information.
For an Abaqus FlexNet Licence Server installation it is recommended to use the root account to install, but the user
account to start the license server process.
Follow the steps in this section to install the AbaqusFlexNet Licence Server on your computer.
2.4.1 Install Abaqus FlexNet Licence Server
Initialising the installer
Once you have obtained the DVD or downloaded the installation files you can begin installing the product.
Running the installer from the DVD
Use the install.sh script in the DVD root to launch the installer.
Run the script by changing directory to the DVD then using the following command:
csh ./install.sh
to open the installer at the Welcome page.
For example:
joesmith@localhost:~/linux_fe-safe_vx.yy> su
Password:
localhost:/home/joesmith/linux_fe-safe_vx.yy # csh ./install.sh
Running the installer from the downloaded files
Uncompress the downloaded files to a temporary location using the archive application or by issuing the following
command:
tar –xvf <filename> -C <target_directory>
Run the install.sh script using the following command:
csh ./install.sh
to open the installer at the Welcome page.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-30
Step 1 – Welcome
From the main screen of the Welcome page you can check which version of the software you are installing. On the
left is a list of the installation steps which is also displayed on every subsequent page.
Installer navigation guide
<< Back - Click on the Back button to go back a stage.
Cancel - You can stop the installation at any time be clicking on the Cancel button.
Continue >> - Click on the Continue button to move forward a stage.
Begin the process by clicking on the Continue >> button.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-31
Step 2 – Installing the products
The Products page lists all the products available for installation with your version.
The fe-safe Fatigue Analysis Application product will be selected automatically when you first use the installer,
ensure the Abaqus FlexNet Licence Server product is selected instead.
Start installing the product by clicking on the Continue >> button.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-32
Step 3 – Selecting the installation directory
This page allows you to select a specific directory for your installation files if you do not want to use the default
location.
a) Choose an installation root directory
You can select the installation root directory from here. It is recommended that you use the default root
installation directory <RootDir>:
/usr/SIMULIA
If you want to place your fe-safe installation in a different location select the Custom button and select a
directory using the … button or by typing it directly into the relevant field.
b) Choose a product installation directory
You can select the installation directory for the fe-safe products from here. It is recommended that you use the
default installation directory <InstallDir>:
<RootDir>/License
If you want to place your installation files in a different location select the Custom button and select a directory
using the … button or by typing it directly into the relevant field.
Note: It is recommended that the <RootDir> is retained and is the same for each fe-safe product installed.
Move to the next step by clicking on the Continue >> button.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-33
Step 4 – Reviewing the summary and installing the program
When you have set the installation and product settings you can run the installation.
Click on the Continue >> button to initiate the installation.
The components and files installed will be displayed on the Installing page.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-34
Step 5 – Finishing the installation
When the installation is complete the Installation Complete page is displayed.
Click on the Finish button to close down the installer.
Note: After installation the Abaqus FlexNet Licence Server will need to be configured and started as described in
the Abaqus Installation and Licensing Guide.
2.4.2 Install licence key
After installing the licence server software a licence key must be installed before the licence server can be started.
For information on how to licence your fe-safe products see section Error! Reference source not found..
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-35
2.5 Installing other products
The fe-safe installer includes a number of other products.
2.5.1 Installing the fe-safe Analysis Server Node
This option is used for installation of an analysis solver as a service on a cluster node for Distributed Memory
Processing (DMP) analysis. The Distributed Processing is described in detail in separate documentation.
2.5.2 Installing the fe-safe Analysis Node Administration Utility
This option is used for installation of a utility tool for managing and monitoring of analysis server nodes in a Safe
Technology Distributed Memory Processing (DMP). The Distributed Processing is described in detail in separate
documentation.
2.6 Upgrading and reinstalling the product
Occasionally, a point release will be supplied as a patch file in which case instructions for patching an existing
installation will be delivered in the Release Notes document, downloaded along with the patch file.
Point releases can also be delivered as full installation media, in which case the installer can be used to upgrade
an existing installation. When an existing installation is detected in the same <InstallDir>, the user will be
prompted to uninstall, upgrade, or cancel the process.
Care should be taken to avoid overwriting valuable data when installing a software upgrade or if the software is re-
installed. In particular, backup copies should be made of material database files (*.dbase) before upgrading or
reinstalling.
2.7 Multiple installations
Different versions of fe-safe can be installed on the same machine. If retained, refer to administrator records to find
the last selected root installation directory <RootDir> for fe-safe products. If it was not default, change the root
installation directory at the Installation Directories page. Change the <InstallDir> so that the original installation
is not overwritten. Point releases can be maintained along with earlier versions if desired.
2.8 Uninstalling the product
The product should be uninstalled by running the uninstall shortcut from the product installation directory
<InstallDir>, shown below, rather than from the Add or Remove Programs in the Control Panel.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-36
Windows operating system
Right-click on the Uninstall [product] shortcut in the product installation directory <InstallDir> and select Run as
Administrator to open the uninstaller:
Default fe-safe application product installation directory:
C:\SIMULIA\fe-safe\<version>\Uninstall fe-safe Fatigue Analysis Application
Default Abaqus FlexNet Licence Server product installation directory:
C:\SIMULIA\License\Uninstall Abaqus FlexNet Licence Server
A confirmation dialogue will be shown prompting whether to proceed with uninstallation, click Yes.
An uninstaller window will open and the components and files being uninstalled will be shown on the Uninstalling
page. When the process is complete the Uninstallation Complete page is displayed.
Click on the Finish button to close down the uninstaller.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-37
Linux operating system
Change directory to the product installation directory <InstallDir>. If the owner of the files contained in the
<InstallDir> is root, login as the root user before proceeding. Locate the Uninstall [product] shortcut in the
product installation directory <InstallDir>:
Default fe-safe application product installation directory:
/usr/SIMULIA/fe-safe/<version>/Uninstall fe-safe Fatigue Analysis Application.sh
Default Abaqus FlexNet Licence Server product installation directory:
/usr/SIMULIA/License/Uninstall Abaqus FlexNet Licence Server.sh
Run the script by using the following command:
csh ./Uninstall fe-safe Fatigue Analysis Application.sh
or
csh ./Uninstall Abaqus FlexNet Licence Server.sh
A confirmation dialogue will be shown prompting whether to proceed with uninstallation, click Yes.
An uninstaller window will open and the components and files being uninstalled will be shown on the Uninstalling
page. When the process is complete the Uninstallation Complete page is displayed.
Click on the Finish button to close down the uninstaller.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-38
2.9 Command-line installation
The command-line installation option provides a way of installing the software without using the installer graphical
user interface (GUI), e.g.: it can be used to install the fe-safe application with remote administration software, as
the installation can be controlled entirely from the command line. For every input field in the installer GUI there is
an equivalent command-line option.
There are two methods of using the command-line installation; the options can be either configured as command-
line parameters, or they can be written to a configuration file that is then used by the installer.
It is recommended to use an administrator (Windows) or root (Linux) account to perform the installation.
The following commands are used to start the installation:
setup.exe –s [options] (Windows)
csh ./install.sh -s [options] (Linux)
The -s switch initiates the command-line installation; if it is omitted the normal graphical user interface will open
and any subsequent parameters will be ignored.
2.9.1 Using the command line parameters
Command-line parameters should be specified with a prefix of -- (double hyphen) followed by their values, multiple
parameters should be space-separated, e.g.:
–-parameter value
If values of parameters contain any spaces they should be surrounded by double quotes. File references should
include the full path, on Windows the path should include the drive letter. The order of the parameters is irrelevant,
if no parameters are specified, the installation will proceed with default settings.
The supported parameters are:
--root_directory Configures the installation root directory <RootDir>.
--product_directory Configures the installation directory for the product
<InstallDir>.
This is a relative path that is appended to the root directory.
--user_directory Configures the user settings directory.
Note: This parameter is applicable to the fe-safe Fatigue
Analysis Application installation only.
--licence_file Specifies the location of a local licence file.
If this parameter is set a local licencing option is configured
during installation.
Note: This parameter is applicable to the fe-safe Fatigue
Analysis Application installation on Windows operating
system only.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-39
--user_default_settings Specifies the location of a default user settings file.
Note: This parameter is applicable to the fe-safe Fatigue
Analysis Application installation only.
--project_default_settings Specifies the location of a default project settings file. Note:
This parameter is applicable to the fe-safe Fatigue Analysis
Application installation only.
--package Selects the fe-safe product to be installed: fesafe (default),
node_admin, fesafeanalysis and flexnet_server
--components Selects optional components to install.
If left blank, all components are installed.
For example:
setup.exe –s --root_directory “C:\AllMyPrograms\” --product_directory
“fe-safe_evaluation” --user_directory “C:\Users\MyName\fesafe”
Installs the fe-safe application to C:\AllMyPrograms\fe-safe_evaluation, with a user directory of
C:\Users\MyName\fesafe
setup.exe –s --package flexnet_server --root_directory “C:\FlexNet”
Installs the Abaqus FlexNet Licence Server to C:\FlexNet
2.9.2 Using the configuration file
To use the configuration file instead of command-line parameters, the –-config option should be used, i.e.:
setup.exe –s –-config <config_file>
If the file path contains any spaces it should be surrounded by double quotes; on Windows the path should include
the drive letter.
Name of the configuration file as well as its location are not restricted; network locations are also supported.
The configuration file is a standard XML file with parameter names that match those listed in the table above. An
example config_template.xml file is provided as a reference in the root of the distribution DVD. Any standard text
editor can be used to edit the file, however, care should be taken to ensure the validity of the XML structure. If any
parameters are not set or are missing a relevant default will be used.
For example:
<?xml version="1.0" ?>
<root>
<root_directory>
C:/AllMyPrograms/
</root_directory>
<product_directory>
fe-safe_evaluation
</product_directory>
<user_directory>
C:/Users/MyName/fesafe
</user_directory>
<licence_system>
DSLS
</licence_system>
</root>
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-40
Installs the fe-safe application to C:\AllMyPrograms\fe-safe_evaluation, with a user directory of
C:\Users\MyName\fesafe
The <licence_system> configures fe-safe to use a DSLS configuration when it is run. Accepted values are
“FlexNet” or “DSLS”. If left blank or omitting the option fe-safe will default to the auto-select configuration for the
licensing system. See
Step 5 – Selecting licensing type for more details.
<?xml version="1.0" ?>
<root>
<root_directory>
C:\FlexNet
</root_directory>
<package>
flexnet_server
</package>
</root>
Installs the Abaqus FlexNet Licence Server to C:\FlexNet
2.9.3 Command-line Uninstallation
A command line uninstallation utility is provided as a way of removing the software without using the installer
graphical user interface (GUI), e.g.: it can be used to uninstall the fe-safe application with remote administration
software, as the installation can be controlled entirely from the command line..
The utility is located in the Installation folder underneath the Installation root directory configured during the
installation
e.g. C:\SIMULIA\Installation
on Microsoft Windows or
/usr/SIMULIA/Installation
On a Linux platform
Using an administrator command prompt on Microsoft Windows, or as a superuser on a Linux terminal type
C:\SIMULIA\Installation\uninstall_cl.exe –c <install_log>
On Microsoft Windows, or
/usr/SIMULIA/Installation/uninstall_cl –c <install_log>
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-41
On Linux, where <install_log> refers to the install.log file that is within the installation directory of the fe-
safe component that you wish to remove e.g.
C:\SIMULIA\fe-safe\<version>\install.log
This will read the details in the installation log file to correctly remove all of the chosen product components
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 2-42
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 3-43
3 Licensing fe-safe products
fe-safe products can be installed using network licensing or local licensing, utilising either SIMULIA FlexNet, or the
DSLS licencing systems.
A licence is required to run the main application, fe-safe. The optional advanced modules, fe-safe/TURBOLife, fe-
safe/Rubber and Verity® in fe-safe are licensed separately and in addition to the main application.
You will need to obtain a licence key to enable the software, to request the key contact your local Dassault
Systemés SIMULIA representative.
If extended token licensing has already been specified using the standard licensing configuration then no extra
configuration is required for fe-safe. DSLS licensing configuration information can be found in the Abaqus
Installation and Licensing Guide, as can the section Abaqus/SIMULIA FlexNet.
3.1 Licensing the fe-safe application
For a new installation of the fe-safe client, the licence server can be specified using the prompt dialogue shown at
startup. Note that if licensing has been sucessfully configured for Abaqus which will likely contain licecnes for fe-
safe then fe-safe will obtain licences without user intervention.
A licencing selection dialogue will then be shown:
From the licensing system dropdown box choose the appropriate licensing system. The appropriate
default port will automatically change upon selection (DSLS: 4085, Simulia FlexNet: 27000, contact your
licence administrator if different).
Select the appropriate licence server type, either Local server, Single server or Redundant servers using
the radio buttons.
For single and redundant servers server hostname(s) or IP address(es) but be entered.
If non-default port(s) are to be used, enter the correct port number(s) in the entry field(s).
click OK when complete.
If the licence server specified is invalid, the dialogue will allow the user to reenter the licence server details.
Note: The Save new details to: box defaults to the fe-safe environment file to prevent having to specify this
information every time the software is run. License details are written to fe-safe.env file in the Windows user
directory. For example, on Windows 7 for the user Joe Smith licence details would be saved to:
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 3-44
C:\Users\joesmith\fe-safe.env (Windows)
/home/joesmith/fe-safe.env (Linux)
There is the option Do Not Save which will forget the licence details when fe-safe exits.
The User Licence File option will save the server details to a user file and is a backward compatible way to set the
licensing, see section 3.1.2 option 6 below.
The User Setting option will save the server details to a user setting and is a backward compatible way to set the
licensing, see section 3.1.2 option 3 below.
The fe-safe application should then start up and you can begin to use the product.
Information about the licences is available from within the fe-safe GUI by selecting Licensing Information from the
Help menu. The Licensing Information dialogue can also be used to reset licensing, by selecting the Reset button.
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 3-45
3.1.1 Licence timeout
When fe-safe has been idle for 8 hours, i.e. there has been no user interaction and fe-safe is not reading a model
or analysing etc. the licences allocated to fe-safe will be released and fe-safe will wait for the user to return and
request re-acquisition of the licences (or to exit).
If the network licence server becomes unavailable, e.g.: network connection to the licence server is lost, the fe-safe
application will wait to restore the connection. Using the command line option -timeout <minutes> when starting
the fe-safe application it is possible to limit the number of minutes fe-safe will wait when connection to the licence
server is lost. For more details on command-line options see the fe-safe User Guide.
3.1.2 Changing the default location of the licensing configuration
Where licensing is not used standard DSLS or FlexNet licensing configurations or the existing configuration needs
to be overridden the following methods can be used to specify the licence server location (a full path, including the
file name should be used where appropriate):
1. System Setting
The following Windows system registry keys are used:
SIMULIA FlexNet
HKEY_LOCAL_MACHINE\SOFTWARE\Dassault Systemes Simulia\fe-
safe\FLEXNET_ABAQUS_LICENCE_FILE
DSLS
HKEY_LOCAL_MACHINE\SOFTWARE\Dassault Systemes Simulia\fe-safe\DSLS_LICENCE_FILE
The Linux LICENSE_FILE variable in the fe-safe system configuration file is used:
/etc/xdg/Dassault Systemes Simulia/fe-safe.conf
Note: Any non-empty entry will lock the licence details regardless of whether the content is valid. Users will not
be able to reset the licence configuration details as described in section 3.1 above.
2. Command Line Option
A modified command line option can be used to run the fe-safe application:
fe-safe.exe -licence <host>
where <host> is the IP address or a hostname of the network licence server.
3. User Setting
The following Windows user registry key is used:
SIMULIA FlexNet Licensing
HKEY_CURRENT_USER\SOFTWARE\Dassault Systemes Simulia\fe-safe\FLEXNET_ABAQUS_LICENCE_FILE
DSLS
HKEY_CURRENT_USER\SOFTWARE\Dassault Systemes Simulia\fe-safe\DSLS_LICENCE_FILE
The Linux LICENSE_FILE variable in the fe-safe user configuration file is used:
$HOME/.config/Dassault Systemes Simulia/fe-safe.conf
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 3-46
4. fe-safe Environment File
This option uses the user directory:
Windows 7: C:\Users\<username>\fe-safe.env
This option uses is the user Home directory:
Linux: /home/<username>/fe-safe.env
The option is Licence in the [licensing] section where LicenceSystem equals DSLS or FLEXnet.
See Appendix C for full details on the fe-safe environemnt file.
5. Environment Variable
The following environment variable with the IP address or a hostname of the network licence server can be
used:
SIMULIA FlexNet Licensing
FLEXNET_ABAQUS_LICENSE_FILE or abaquslm_license_file
DSLS
DSLS_LICENSE_FILE
The following options all use a license file. For the names of these files, please refer to the following table
License type License Filename
SIMULIA FlexNet safe_sim.lic
DSLS safe_dsls.lic
6. User Directory
This option uses the user directory:
Windows 7: C:\Users\<username>\<license_filename>
This option uses is the user Home directory:
Linux: /home/<username>/<license_filename>
7. All Users Directory
This Windows only option uses the path defined by the CSIDL_COMMON_APPDATA setting:
Windows 7: c:\ProgramData\<license_filename>
8. Executable Directory
The directory containing the fe-safe Fatigue Analysis Application executable:
<InstallDir>\exe\<license_filename>
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 3-47
Note: By default the above options take precedence in descending order. i.e. if 1 and 2 are both defined then
option 1 is used. This order can be cahgned using the fe-safe environemnt file, see See Appendix C for full details.
If the specified server cannot be found, or is not valid, the user will again be prompted for the licence information,
except when the system setting is used, see p.1 above.
3.1.3 Specifying multiple License Servers
It is possible to list multiple servers for the purpose of redundancy, so that if fe-safe is unable to request a license
from a server it will try another one until it has succeeded, or exhausted the list.
The server names or addresses can be separated either with , (although : or ; can also be used it is not
recommended) e.g.
server1,server2,server3
To specify a port number for the server it should be entered as <port>@<server> e.g.
8045@server1:8046@server2:8045@server3
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 3-48
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 4-49
4 Configuring fe-safe for multi-user environments
This section describes how to configure a single fe-safe installation for use by multiple users. A fe-safe session has
a number of files that are used (e.g. debug.log, current.macro, local.dbase etc.) which normally will prevent the
same user from being able to run multiple sessions of fe-safe simultaneously.
Note that in all cases the user directory (<UserDir>) can be configured at install time or subsequently by editing
the file global.stli in the setup subdirectory of the fe-safe installation and modifying the user_directory element.
The token ${USERNAME} can be used which has special significance to fe-safe and will always resolve to the
current users username. In addition to this there is a selection of environment variables that fe-safe will resolve at
runtime to assist with the configuration of the multi-user environment. These are as follows
Windows Linux Effect
${USERPROFILE} ${HOME} The path to the users directory
${COMPUTERNAME} ${HOSTNAME} The name of the machine
4.1 Running simultaneous sessions of fe-safe from different user accounts
The user directory defaults to <My Documents>\fe-safe.version.x.y on Windows and ~/fe-safe.version.x.y on other
platforms. If this is done no other action is required. To specify a different directory relative to the user’s My
Documents or home directory, use ~ which will be dynamically resolved when fe-safe runs.
To use a directory outside of the user’s directory the token ${USERNAME} can be used to make fe-safe
dynamically resolve to the username of the active user when fe-safe is run, e.g. C:\fe-
safe_user_data\${USERNAME}.
4.2 Running simultaneous sessions of fe-safe from the same user account
So ensure that each users session is unique there must be an environment variable available the uniquely identify
the different users. The environment variable must only contain characters that are valid directory name characters.
The user directory must be configured to include this environment variable – any environment variable can be used
by surrounding it in ${…} e.g. to use SESSION_ID the user directory should be C:\fe-
safe_user_data\${SESSION_ID}
For the situation where there isn’t a user-unique environment variable a script to run fe-safe will be required. On
Linux this already provided, for Windows a simple .bat will suffice. In the script create a user-unique environment
variable, either by removing invalid characters from a user-unique environment variable that contains invalid
directory characters or from prompting the user to enter a string and using that as the custom environment variable.
Alternatively the current time could be used (or some other non-repeating value), however the drawback is a user’s
local material database etc. would be reset on every session.
To get the time on Windows use:
set SESSION_ID=%DATE:/=%.%TIME::=%
Licensing Guide
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 4-50
On Linux you could use the date command output that uses the amount of seconds elapsed since 1970-01-01 to
create a unique ID based on the time of execution
SESSION_ID=$(date +”%s”)
export SESSION_ID
4.3 Running fe-safe locally from a remote installation
If the session data is stored locally on each of the different clients there will be no clash and the user directory
needs no special modifications. For where the user directories are also on a common remote machine then
changes will be required. To support different users follow the steps marked out in 4.1.
For a single user account include the environment variable that contains the local machine name. On Windows this
it COMPUTERNAME, on Linux it is HOSTNAME. Alternatively follow section 4.2 noting that the environment
variables are for the local machine, not the remote host and that if the environment variable is not generated
dynamically it must be present on all machines where fe-safe will be run. It is suggested that the environment
variable is checked in the script to ensure that it is correctly set before running fe-safe.
4.4 Running simultaneous sessions of fe-safe on a remote host
When fe-safe is running on a remote machine (i.e. through remote desktop or terminal) it is exactly like running fe-
safe locally on the remote machine and sections 4.1 or 4.2 will apply.
Appendix A – Nomenclature
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 1
Appendix A – System requirements
The following platforms are supported:
Platform
Versions Supported
Support for Applications
fe-s
afe
and
sa
fe4fa
tigu
e
Gra
ph
ica
l U
se
r In
terf
ace
(GU
I)
fe-s
afe
and
sa
fe4fa
tigu
e
co
mm
and
-lin
e A
na
lysis
En
gin
e
Ab
aq
us
Fle
xN
et
Lic
ence
Se
rve
r
Fle
xN
et
LM
TO
OL
S U
tilit
y
Microsoft
Windows1
7 64-bit
8 64-bit
10 64-bit
Server Edition 2008, 2008 R2, 2012
Linux2
Red Hat
Red Hat Enterprise Linux
(RHEL) 6 & 7
CentOS 6.5
Novell SUSE SLES 11 and 12
Disc Space
The amount of available disk space recommended for a typical installation of fe-safe is 2 GB, however, this may
vary depending on the platform and the components selected for installation.
The installation process will create a local directory for each user, where individual database and working files are
stored.
1 Support for Microsoft Windows is on x86-64 architecture only. Itanium versions (IA-64) are not supported. The Microsoft Visual
C++ 2012 64-bit runtime libraries are required to install and run fe-safe.
2 Support for Linux is on x86-64 (AMD64 (Opteron, Athlon) and Intel 64-compliant processors architectures only. To run fe-safe
on Linux platform an updated standard C++ library may be required.
Appendix B - Nomenclature
Copyright 2015 Dassault Systèmes UK Limited
Installation and Licensing Guide Issue: 5 Date: 01.09.16
Appendix B 2
Appendix A – Nomenclature
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 1
Appendix B – Nomenclature
Typographic conventions used in this manual
The following typographic conventions are used in this manual:
Convention Meaning
Bold Text Indicates the name of a dialogue box, control, indicator,
graphics label or menu option.
Note: the use of a double-bracket symbol, i.e. >>, indicates a
sequence of menu options or dialogue box actions, for example:
FEA Fatigue >> Analysis Options >> Read strains from FE models
Italics Indicates the name of an fe-safe product, for example:
fe-safe/Rotate.
Monospace text Indicates a file, directory or path.
Indicates the content of a data file, log file or text displayed in
the message log window.
<bold monospace text in brackets> Indicates a reference to a file or directory.
References to files and directories
The following nomenclature is used throughout the fe-safe documentation when referring to files and directories.
This nomenclature is as a shorthand method of referring to files and directories in the documentation only – the
names have no meaning in the actual software. Where a path description used in the documentation is intended to
be generic, the backwards-slash symbol used in Windows, i.e. \, is used as a directory separator. For Linux
installations, this symbol should be interchanged with the forward-slash symbol, i.e. /.
Each of the shorthand file or folder references below (in angled brackets, < >), is followed by a short description of
what it refers to.
<RootDir> The common Product Root Installation Directory may include installations of fe-safe
Application, fe-safe Analysis Server, fe-safe Node Administration Utility, Abaqus FlexNet
Licence Server as well as common files and documentation.
<InstallDir> The fe-safe Installation Directory is established as part of the installation process.
The directory fe-safe is the fe-safe Installation Directory.
Appendix B - Nomenclature
Copyright 2015 Dassault Systèmes UK Limited
Installation and Licensing Guide Issue: 5 Date: 01.09.16
Appendix B 2
Linux: On Linux installations, the fe-safe Installation Directory is determined
during the install process. The default location is:
<RootDir>/fe-safe/version.x.yy
Windows: On Windows, the fe-safe Installation Directory is determined during
the install process. The default location is:
<RootRit>\fe-safe\version.x.yy
In both cases, the x and yy refers to fe-safe major and minor version numbers.
<UserName> This is a user login name.
<UserDir> An fe-safe User Directory is created for each user the first time they run fe-safe when
logged on with a particular login name.
The location of the user directory depends on the platform on which fe-safe is installed.
This directory will contain a copy of the local material database from <LocalDir> as
well as the user’s Project Directory.
Appendix A – Nomenclature
Copyright © 2016 Dassault Systemes Simulia Corp.
Installation and Licensing Guide Issue: 6 Date: 01.09.16
Contents 3
Appendix C – fe-safe Environment File
Environment file location
The fe-safe environment file is a per user-account file used to configure fe-safe and is found in the user or home
directory:
Windows 7: C:\Users\<username>\fe-safe.env
Linux: /home/<username>/fe-safe.env
Environment file structure
The file is similar to the Windows ini file format. The file is separated into sections, each section starts with the
section name enclosed in square brackets and includes all subsequent lines until the end of file or another section
start, whichever occurs first. The order of lines within a section has no significance.
Within each section there will be a number of name-value pairs in the format <name>=<pair> e.g.
[section1]
aName=aValue
While using semi-colons to indicate a comment line will not cause read errors, whenever fe-safe re-writes the file
comments will be stripped.
Environment file content - licensing
If there is no fe-safe environment file, or the licensing settings have been removed then when fe-safe is next run
the default license settings will be populated, e.g. running the command-line version of fe-safe with no options can
be used to populate any missing settings.
Note that in general, when a licence server is expected, 1 or 3 servers can be specified and should be separated
by commas and an optional per-server port should be separated by an @ (order is not important) e.g.
1234@server1, server 2@5678, server 3@91
In addition, depending on the licensing system other separators can be used, e.g. normally DSLS uses a colon to
separate the port, e.g. server:port
The main licensing settings in the [licensing] section which contains 3 name-value pairs:
1. LicenceSystem=<type>
This can be used to indicate the licensing system to use, valid values for <type> are:
a. AUTO-DETECT (the default): fe-safe will check all ways to specify licensing and choose the
corresponding licensing system
b. DSLS: DSLS will be used
c. FLEXnet: SIMULIA FLEXnet licensing will be used
2. Licence=<licence server>
By default when a licence is set through the UI is will be saved here. The value <licence server> is the licence
server(s) as specified above.
Appendix B - Nomenclature
Copyright 2015 Dassault Systèmes UK Limited
Installation and Licensing Guide Issue: 5 Date: 01.09.16
Appendix B 4
3. SaveLocation=<location>
When saving the licensing through the UI this option determines the default location to save the new licensing
setting to. Valid values are:
a. EnvironmentFile: The licence server details will be saved in the fe-safe environment in this section
under the Licence=<licence server> name-value pair.
b. UserSetting:
c. UserFile:
There are 2 other sections named [DSLS] and [FLEXnet] which specify where fe-safe should look for licence server
details. Within these sections each name-value pair has the extra format:
<precedence>/SpecType=<type>
Or
<precedence>/SpecType=<type>:<value>
Where:
<precedence> : A number indicating the order in which configurations options will be checked, with 0
being highest priority. Note that the system setting will always be first (see 3.1.2 option 1).
<type> : Can be one of the following:
o SystemDefault will cause the licensing system default configuration to be checked. <value> is
not used.
o CommandLine will case the–licence command-line option to be checked. <value> is not used.
o SystemSetting where on Windows the registry entry is used:
HKEY_LOCAL_MACHINE\SOFTWARE\Dassault Systemes Simulia\fe-safe\<value>
The Linux <value>variable in the fe-safe system configuration file is used:
/etc/xdg/Dassault Systemes Simulia/fe-safe.conf
o UserSetting where on Windows the registry entry is used:
HKEY_CURRENT_USER\SOFTWARE\Dassault Systemes Simulia\fe-safe\DSLS_LICENCE_FILE
The Linux <value> variable in the fe-safe user configuration file is used:
$HOME/.config/Dassault Systemes Simulia/fe-safe.conf
o Environment will cause the environment variable <value> to be checked.
o File will cause the first line in the file <value> to be checked.