Installation and Licensing Guide

Contents

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-13

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-1

Copyright 2015 Dassault Systèmes UK Limited

Contents 1-1
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Contents

3.1 Licensing the fe-safe application .......................................................................................................................... 3-1

3.1.1 Licence timeout ................................................................................................................................................ 3-3

3.1.2 Changing the default location of the licensing configuration ............................................................................ 3-3

3.1.3 Specifying multiple License Servers ................................................................................................................ 3-5

4 Configuring fe-safe for multi-user environments ............................................................................................................. 4-7

4.1 Running simultaneous sessions of fe-safe from different user accounts .............................................................. 4-7

4.2 Running simultaneous sessions of fe-safe from the same user account .............................................................. 4-7

4.3 Running fe-safe locally from a remote installation ................................................................................................ 4-8

4.4 Running simultaneous sessions of fe-safe on a remote host ............................................................................... 4-8

Appendix A – System requirements .......................................................................................................................................... 1

Appendix B – Nomenclature ..................................................................................................................................................... 2

Contents 1-2 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 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, 2015.

Copyright 2015 Dassault Systèmes UK Limited

Contents 1-1
Installation and Licensing Guide Issue: 5 Date: 11.09.15
 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 Copyright Notice

Version

Under BSD 2-Clause

UnZip (from Info- 2.4 Copyright (c) 1990-2009 Info-ZIP. All rights
ZIP) reserved.

Under BSD 3-Clause

Qt Solutions 2.6 Copyright (c) 2014 Digia Plc and/or its

subsidiary(-ies)

All rights reserved.

Contents 1-2 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

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.

Copyright 2015 Dassault Systèmes UK Limited

Contents 1-1
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Installation Guide

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).

Contents 1-2 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

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 3.

Copyright 2015 Dassault Systèmes UK Limited

Contents 1-3
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Installation Guide

Contents 1-4 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

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 2.2 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

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.

Copyright 2015 Dassault Systèmes UK Limited

Contents 2-5
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Installation Guide

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.

Contents 2-6 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

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.

Copyright 2015 Dassault Systèmes UK Limited

Contents 2-7
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Installation Guide

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.

Contents 2-8 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

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.

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.

Copyright 2015 Dassault Systèmes UK Limited

Contents 2-9
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Installation Guide

If you are using a networked licence click on the Network button, if not already selected.

Then select either the DSLS Licensing or FlexNet Licensing options in the Licensing System drop down menu

If you have chosen DSLS Licensing you should then ensure that the correct type of license is chosen, depending
on your maintenance contract.

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 3.1.

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 3.1.

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).

Contents 2-10 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

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.

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.

Copyright 2015 Dassault Systèmes UK Limited

Contents 2-11
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Installation Guide

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.

Contents 2-12 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

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.

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 3 or 4.

Copyright 2015 Dassault Systèmes UK Limited

Contents 2-13
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Installation Guide

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.

Contents 2-14 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

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.

Copyright 2015 Dassault Systèmes UK Limited

Contents 2-15
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Installation Guide

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.

Contents 2-16 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

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.

Copyright 2015 Dassault Systèmes UK Limited

Contents 2-17
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Installation Guide

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.

Step 5 – Selecting licensing type

The Licensing page allows you to select the required licensing type.

Contents 2-18 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

Note: You should already have decided on which licensing type you will be using before beginning installation, see
section 1.2.

Select either the DSLS Licensing or FlexNet Licensing options in the Licensing System drop down menu

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.

Copyright 2015 Dassault Systèmes UK Limited

Contents 2-19
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Installation Guide

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.

Contents 2-20 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

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.

Copyright 2015 Dassault Systèmes UK Limited

Contents 2-21
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Installation Guide

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 3 or 4.

Contents 2-22 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

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.

Copyright 2015 Dassault Systèmes UK Limited

Contents 2-23
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Installation Guide

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.

Contents 2-24 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

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.

Copyright 2015 Dassault Systèmes UK Limited

Contents 2-25
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Installation Guide

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.

Contents 2-26 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

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.

Copyright 2015 Dassault Systèmes UK Limited

Contents 2-27
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Installation Guide

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 3.

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 3.

Contents 2-28 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

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.

Copyright 2015 Dassault Systèmes UK Limited

Contents 2-29
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Installation Guide

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.

Contents 2-30 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

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.

Copyright 2015 Dassault Systèmes UK Limited

Contents 2-31
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Installation Guide

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.

Contents 2-32 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

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.

Copyright 2015 Dassault Systèmes UK Limited

Contents 2-33
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Installation Guide

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 3.3.

Contents 2-34 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

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.

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

Copyright 2015 Dassault Systèmes UK Limited

Contents 2-35
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Installation Guide

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.

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

Contents 2-36 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

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.

Copyright 2015 Dassault Systèmes UK Limited

Contents 2-37
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Installation Guide

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:

Configures the installation root directory <RootDir>.

--root_directory

Configures the installation directory for the product

--product_directory

<InstallDir>.

This is a relative path that is appended to the root directory.

Configures the user settings directory.

--user_directory

Note: This parameter is applicable to the fe-safe Fatigue

Analysis Application installation only.

Specifies the location of a local licence file.

--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.

Contents 2-38 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

Specifies the location of a default user settings file.

--user_default_settings

Note: This parameter is applicable to the fe-safe Fatigue

Analysis Application installation only.

Specifies the location of a default project settings file. Note:

--project_default_settings

This parameter is applicable to the fe-safe Fatigue Analysis

Application installation only.

Selects the fe-safe product to be installed: fesafe (default),

--package

node_admin, fesafeanalysis and flexnet_server

Selects optional components to install.

--components

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>
</root>

Copyright 2015 Dassault Systèmes UK Limited

Contents 2-39
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Installation Guide

Installs the fe-safe application to C:\AllMyPrograms\fe-safe_evaluation, with a user directory of

C:\Users\MyName\fesafe

<?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>

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

Contents 2-40 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Installation Guide

Copyright 2015 Dassault Systèmes UK Limited

Contents 2-41
Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Licensing Guide

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/TMF, 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.

Note: This section does not describe usage, configuration or maintenance of the SIMULIA FlexNet License
Manager, for those please refer to the Abaqus Installation and Licensing Guide.

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.

Start the fe-safe application as described in the fe-safe User Guide. Confirm the suggested project name to
proceed to the license check

Copyright 2015 Dassault Systèmes UK Limited

Contents 3-1
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Licensing Guide

A licencing selection dialogue will then be shown:

• From the 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).

• For a network licence server select Network licence from the options, specify the IP address or a
hostname of the licence server and set the network port number if it is different to the defaults.

• For local licensing select Local licence. If a non-default network port is to be used, replace the default
values with the correct port number in the entry field.

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 licence details box is checked automatically to prevent having to specify this information every time
the software is run. License details are written to a safe_sim.lic file in the Windows user directory or a
safe_dsls.lic. For example, on Windows 7 for the user Joe Smith licence details would be saved to:

C:\Users\joesmith\safe_sim.lic (Windows)

/home/joesmith/safe_sim.lic (Linux)

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.

Contents 3-2 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Licensing Guide

3.1.1 Licence timeout

Exclusively for the command-line operation of the fe-safe application:

<InstallDir>\exe\fe-safe_cl.exe (Windows)

<InstallDir>/fe-safe_cl (Linux)

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 for a predefined timeout period (15 minutes by default) and then exit.
Appropriate prompt will be shown during this period. If the licence server becomes available again during the
timeout period the fe-safe application will resume normal operation. The length of timeout is configurable using a
command line option -timeout <minutes> when starting the fe-safe application, which will change the timeout for
all future runs. For more details on command-line options see the fe-safe User Guide.

3.1.2 Changing the default location of the licensing configuration

By default location of the licence server will be saved in a local User Directory, see Option 5 below. However, the
following locations will also be searched by fe-safe client to locate the licence server (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. 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

Copyright 2015 Dassault Systèmes UK Limited

Contents 3-3
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Licensing Guide

3. 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.

4. Environment Variable

The following environment variable with the 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

5. 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>

6. All Users Directory

This option uses the All Users directory:

Windows 7: C:\Users\<license_filename>

7. Executable Directory

The directory containing the fe-safe Fatigue Analysis Application executable:

<InstallDir>\exe\<license_filename>

Note: The above options take precedence in descending order. i.e. if 1 and 2 are both defined then option 1 is
used.

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.

Contents 3-4 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Licensing Guide

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 : or ; 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

Copyright 2015 Dassault Systèmes UK Limited

Contents 3-5
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Licensing Guide

Contents 3-6 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Licensing Guide

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::=%

Copyright 2015 Dassault Systèmes UK Limited

Contents 4-7
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Licensing Guide

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.

Contents 4-8 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Appendix A – Nomenclature

Appendix A – System requirements

The following platforms are supported:

Support for Applications

FlexNet LMTOOLS Utility

Abaqus FlexNet Licence
Graphical User Interface
fe-safe and safe4fatigue

fe-safe and safe4fatigue

command-line Analysis
Engine

Server
Platform Versions Supported

(GUI)
7 64-bit • • • •
Microsoft
8 64-bit • • • •
Windows 1
Server Edition 2008 • •
Red Hat Enterprise Linux
Red Hat • • • •
(RHEL) 5 and 6
Linux 2
Novell SUSE SLES 10 and 11 • • • •

Disc Space

The amount of available disk space recommended for a typical installation of fe-safe is under 1.5Gb, 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.
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.

Copyright 2015 Dassault Systèmes UK Limited

Contents 1
Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Appendix A – Nomenclature

Copyright 2015 Dassault Systèmes UK Limited

Contents 1
Installation and Licensing Guide Issue: 5 Date: 11.09.15
Appendix B - Nomenclature

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 2 Copyright 2015 Dassault Systèmes UK Limited

Installation and Licensing Guide Issue: 5 Date: 11.09.15
 Appendix A – Nomenclature

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.

Copyright 2015 Dassault Systèmes UK Limited

Contents 3
Installation and Licensing Guide Issue: 5 Date: 11.09.15