Digimat INSTALL

INSTALLATION
Release 6.0.1 May 2015
For material suppliers and end-users who suffer from long and costly development cycles, e-Xstream engineering offers Digimat,
The nonlinear multi-scale material & structure modeling platform, an innovative and efficient software suite to accurately predict
the nonlinear behavior of composite materials and structures used across the industries.
The material modeling company
www.e-Xstream.com
Contents
Contents
Installation of Digimat software
I.1
I.1.1
I.1.2
I.1.3
I.1.4
Getting started
Digimat installation - quick & easy . . . . .
Installation of Digimat on a local computer
Step-by-step: FlexLM license server . . . . .
Step-by-step: Digimat software . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
7
8
11
12
17
I.2
I.2.1
I.2.2
I.2.3
I.2.4
FlexLM Licensing
Licensing system . . . . . . . . . . .
Digimat via FlexLM licensing . . . .
Set-up of the licensing system . . . .
Configuration of the licensing system
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
35
36
38
40
41
I.3
I.3.1
I.3.2
Digimat licensing management

Licensing location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Licensing status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
43
44
44
I.4
I.4.1
I.4.2
I.4.3
Digimat settings
The DIGIMAT_Settings.ini file . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Structure of the DIGIMAT_Settings.ini file . . . . . . . . . . . . . . . . . . . . . .
Digimat environment variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
45
46
47
51
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
I.5
Digimat-CAE Interfaces
I.5.1
Digimat-CAE/Abaqus . . . . . . . . . . . . . . . . . . . . .
I.5.2
Digimat-CAE/ANSYS . . . . . . . . . . . . . . . . . . . . .
I.5.3
Digimat-CAE/Marc . . . . . . . . . . . . . . . . . . . . . .
I.5.4
Digimat-CAE/MSC Nastran SOL400 . . . . . . . . . . . . .
I.5.5
Digimat-CAE/SAMCEF . . . . . . . . . . . . . . . . . . . .
I.5.6
Digimat-CAE/LS-DYNA . . . . . . . . . . . . . . . . . . . .
I.5.7
I.5.8
Digimat-CAE/PAM-CRASH . . . . . . . . . . . . . . . . . .
I.5.9
Digimat-CAE/Hypermesh and Digimat-CAE/RADIOSS Bulk
I.5.10
Digimat-CAE/RADIOSS Block 51 . . . . . . . . . . . . . .
I.5.11
Digimat-CAE/MSC Nastran SOL1XX . . . . . . . . . . . . .
I.5.12
Digimat-CAE/nCode DesignLife . . . . . . . . . . . . . . . .
I.5.13
Digimat-CAE/VirtualLab . . . . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
53
54
57
66
70
71
74
78
79
81
84
87
88
89
Part I
Installation of Digimat software
Installation I.1
Getting started
I.1.1
I.1.2
Digimat installation - quick & easy . . . . .

Workflow & details . . . . . . . . . . . . . . . . .
I.1.3
Step-by-step: FlexLM license server . . . . .
I.1.4
Step-by-step: Digimat software . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
8
11
11
12
17
Installation
I.1.1
Getting started
Digimat installation - quick & easy
The following chapter is intended to give a quick and general overview over the single steps of the Digimat installation. A general overview over the installation procedure is followed by a typical example of a local
Digimat installation on a Windows computer. For detailed procedures please refer to the dedicated chapters.
It is highly recommended to follow the described procedures as given in the overview step by step
to receive a stable installation of Digimat software!
To obtain test files for the test of the installation of Digimat 6.0.1, please contact support@exstream.com.
I.1.1. Digimat installation - quick & easy
Digimat licensing
FlexLM
Install license server

Configure licensing
Start license server
Digimat platform
Digimat-MF
Digimat-FE
Select & install products

Set environment variables
Digimat-MX
Digimat-MAP
Digimat-CAE
Digimat-RP
Digimat-HC
Digimat-VA
Figure I.1.1: General overview over steps required to receive a stable installation of Digimat software.
10
Installation
Getting started
Test basic installation
GUI start-up
Installed
modules
3rd party prerequisites
If coupling to CAE codes
Test CAE coupling
VS2012
compiler
Only required if coupling to

CAE codes via static linking
procedure
Linking Digimat to CAE
Use a model from the examples

manual to test the successfull
installation of Digimat
Use a model from the examples

manual to test the successfull
installation of Digimat
dynamic
static
CAE solver
Digimat-CAE
CAE Plug-Ins
Figure I.1.2: General overview over steps required to receive a stable installation of Digimat software.
I.1.2. Installation of Digimat on a local computer
I.1.2
11
The goal of this section is to demonstrate the most straightforward way to create a FULL standard installation
of the Digimat software on a local Windows computer using the FlexLM licensing system.
Please notice that the installation requires three principle steps which are best performed in the following
subsequent order:
1. Installation of the FlexLM license server
2. Installation of Digimat
3. Linking with CAE software
Workflow & details
1. Installation of the FlexLM license server

Floating license system
Server running on the current machine
Automated start with every boot of the machine
It is recommended to reboot the machine as a last step of this installation!
2. Installation of Digimat
Setup of a floating license pointing to the FlexLM license server
Installation of ALL Digimat modules
Usage of a non-default Digimat working directory
Setup of standard paths to
Adobe Reader executable (required for the Digimat manual)
Patran installation (required for Digimat-RP)
MSC Nastran installation (required for Digimat-RP)
Marc Mentat installation (required for Digimat-RP and to use Digimat to Marc Mentat plug-in)
ANSYS installation (required for Digimat-RP and Digimat-FE interface with ANSYS Workbench)
Abaqus installation (required for Digimat-RP and Digimat-FE interface with Abaqus CAE)
Installation of Intel-MPI service (if Digimat-FE component is selected)
Creation of Digimat-MX database during installation procedure
Installation of Visual C/C++ redistributable files during installation procedure
It is recommented to reboot the machine as a last step of this installation!
After reboot the user is up and running for the usage of all Digimat standalone modules.
3. Linking with CAE software
Linking Digimat with the external CAE software like Abaqus, ANSYS, Marc, LS-DYNA or others
has to be carefully set up and tested.
Please note that depending on the solver type and platform special linker software might be required.
The detailed linking procedure with CAE solvers will not be dealt with in this chapter
Please refer to the individual section of the required CAE code in Chapter I.5.
12
Installation
I.1.3
Getting started
Step-by-step: FlexLM license server
Figure I.1.3: Running the Install FlexLM licensing for Digimat 6.0.1.exe will open up the Digimat installer for the
FlexLM license manager.
I.1.3. Step-by-step: FlexLM license server
13
Figure I.1.4: If no FlexLM license manager has been installed on the so far all components of the FlexLM system
should be installed. For individual and customized installation of FLexLM, please read the more detailed
explanations in chapter I.2.
Figure I.1.5: The location of the Digimat license file has to be specified. This file was shipped by e-Xstream engineering
and contains the valid licenses for the agreed duration of software usage. In case you do not have any
license file, please contact support@e-xstream.com for more information.
14
Installation
Getting started
Figure I.1.6: The destination folder for the FlexLM license server needs to be specified.
Figure I.1.7: The FlexLM license server runs as a service in the background. This service can be started manually each
time it is needed. However, it is recommended to choose the option of automatically starting the license
server upon every boot of the machine to ensure smooth & easy performance of the complete installation.
I.1.3. Step-by-step: FlexLM license server
15
Figure I.1.8: A summary of the installation details is given and can be checked. Proceeding with the " Install " button
will finalize the installation of the FlexLM license server.
Figure I.1.9: The installation is finished. Afterwards the server is up and running and the licenses available to the
Digimat software via the EXLM vendor daemon.
16
Installation
Getting started
To ensure that the license server is running, you should:

Open the Services tool of Windows, and check that e-Xstream FLEXlm License Manager is running.
Open the log file of the license server, located in C:/DIGIMAT_licensing/Licensing/DIGIMAT.log. If
the server did start successfully, you should see something similar to this:
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:45
16:14:47
(lmgrd) ----------------------------------------------(lmgrd)
Please Note:
(lmgrd)
(lmgrd)
This log is intended for debug purposes only.
(lmgrd)
In order to capture accurate license
(lmgrd)
usage data into an organized repository,
(lmgrd)
please enable report logging. Use Flexera Software, Inc.s
(lmgrd)
software license administration solution,
(lmgrd)
FLEXnet Manager, to readily gain visibility
(lmgrd)
into license usage data and to create
(lmgrd)
insightful reports on critical information like
(lmgrd)
license availability and usage. FLEXnet Manager
(lmgrd)
can be fully automated to run these reports on
(lmgrd)
schedule and can be used to track license
(lmgrd)
servers and usage across a heterogeneous
(lmgrd)
network of servers including Windows NT, Linux
(lmgrd)
and UNIX. Contact Flexera Software, Inc. at
(lmgrd)
www.flexerasoftware.com for more details on how to
(lmgrd)
obtain an evaluation copy of FLEXnet Manager
(lmgrd)
for your enterprise.
(lmgrd)
(lmgrd) ----------------------------------------------(lmgrd)
(lmgrd)
(lmgrd) pid 7904
(lmgrd) Done rereading
(lmgrd) FLEXnet Licensing (v11.9.1.0 build 89952 i86_n3)
(lmgrd) started on EX2011 (IBM PC) (4/2/2015)
(lmgrd) Copyright (c) 1988-2010 Flexera Software, Inc.
(lmgrd) All Rights Reserved.
(lmgrd) US Patents 5,390,297 and 5,671,412.
(lmgrd) World Wide Web: http://www.flexerasoftware.com
(lmgrd) License file(s): c:\LICENSING\Digimat\digimat.lic
(lmgrd) lmgrd tcp-port 27011
(lmgrd) Starting vendor daemons ...
(lmgrd) Started EXLM (pid 6820)
(EXLM) Server started on EXMDE2011 for:
DIGIMAT_FE_MODELER
(EXLM) DIGIMAT_FE_SOLVER DIGIMAT_FE_SOLVER_TOKEN DIGIMAT_CAE_TOKEN
(EXLM) DIGIMAT_MF
DIGIMAT_MAP
DIGIMAT_MX
(EXLM) DIGIMAT_MX+
DIGIMAT_HC
DIGIMAT_RP_GUI
(EXLM) DIGIMAT_VA_GUI
DIGIMAT_VA_SOLVER DIGIMAT_CAE_LINEAR
(EXLM) DIGIMAT_CAE_STRUCTURAL DIGIMAT_CAE_FATIGUE DIGIMAT_CAE_MOLDING
(EXLM) DIGIMAT_CAE_DRAPING DIGIMAT_CAE_CASTING DIGIMAT_CRYPT
(EXLM) DIGIMAT_CRYPT_FORALL DIGIMAT_CRYPT_FORSOLVAY
(lmgrd) EXLM using TCP-port 59008
(EXLM) TCP_NODELAY NOT enabled
If the server is running and you still have issue to start the products, check the firewall configuration of your
license server, and open the right ports.
I.1.4. Step-by-step: Digimat software
I.1.4
17
Step-by-step: Digimat software
Digimat software
Examples Manual
3rd party components
Figure I.1.10: Two files are mandatory to be downloaded from the FTP server: the Digimat installer and the installer for
third-party components. For the installation of the examples manual, the respective third package is also
required. The global installer Install Digimat x64 6.0.1.exe will lead through the complete procedures
for installing Digimat on Windows 64bit platforms.
18
Installation
Getting started
Figure I.1.11: Opening prompt of the Digimat installer. Follow the given instructions step-by-step.
19
Figure I.1.12: Upon execution of the Digimat installer, the release notes will be shown in a separate PDF viewer.
20
Installation
Getting started
Figure I.1.13: Please read carefully the software license agreement. It must be agreed to before being able to continue
with the installation procedure.
Figure I.1.14: The licensing type has to be specified. In this case, we would like to connect to a previously installed
FlexLM floating license via a license server installed on the local computer. For more information on the
availbale types of licensing with Digimat, please refer to chapter I.2.
21
Figure I.1.15: The IP address for communication with the FlexLM license service has to be given, preceded by the @.
If needed, you can also specify explicitly the port used by the license server, e.g., 27010@192.168.1.1.
Port specification should only be used if it is explicitely specified in the license server.
Figure I.1.16: The destination folder for the Digimat installation has to be given.
22
Installation
Getting started
Figure I.1.17: The path to an existing installation of Adobe Reader has to be defined. This is to ensure the correct
performance of the software help showing the Digimat documentation.
Figure I.1.18: The destination folder for the Digimat working directory has to be given. This directory can be located
anywhere on the computer and shared also between different versions of Digimat.
23
Figure I.1.19: The required Digimat modules can be chosen individually to save disk space for the installation. In the
default case as used here all modules will be installed.
Figure I.1.20: If Digimat-FE installation is selected, the Intel-MPI service must be installed to be able to launch parallel
computations using Digimat embedded finite element solver. If this service is already setup on your
machine, click no, else, click yes. In case of issue during installation of Intel-MPI service, please refer to
section ??
24
Installation
Getting started
Figure I.1.21: The usage of the Digimat-MX module requires a server for the MX database to be set up. This setup can
be done in a later step by using the database tools provided with Digimat-MX (choose "No"). However,
to get up and running it is convenient to perform this directly as a step of the Digimat installation
(choose "Yes").
Figure I.1.22: The path of an existing Patran installation is requested. If not using this FEA solver the step can
be skipped and the input field left blank. If needed this path can be specified in a later step via
Digimat settings as explained in section I.4.1.
25
Figure I.1.23: The path of an existing MSC Nastran installation is requested. If not using this FEA solver the step
can be skipped and the input field left blank. If needed this path can be specified in a later step via
Digimat settings as explained in section I.4.1.
Figure I.1.24: The path of an existing Marc Mentat installation is requested. This is to ensure smooth performance
of Digimat-RP with Marc Mentat. If not using this FEA solver the step can be skipped and the input
field left blank. If needed this path can be specified in a later step via Digimat settings as explained in
section I.4.1.
26
Installation
Getting started
Figure I.1.25: The path of an existing ANSYS installation is requested. This is to ensure smooth performance of
Digimat-RP and the Digimat-FE interface with ANSYS Workbench. If not using either the DigimatFE module or this FEA solver the step can be skipped and the input field left blank. If needed this path
can be specified in a later step via Digimat settings as explained in section I.4.1.
27
Figure I.1.26: The path of an existing Abaqus installation is requested. This is to ensure smooth performance of
Digimat-RP and the Digimat-FE interface with Abaqus CAE. If not using either the Digimat-FE module
or this FEA solver the step can be skipped and the input field left blank. If needed this path can be
specified in a later step via Digimat settings as explained in section I.4.1.
Figure I.1.27: An individual name for the Digimat shortcut can be specified.
28
Installation
Getting started
Figure I.1.28: A desktop icon can be created. User can also choose to install Visual 2010 C/C++ redistributable
files together with Digimat. These files are required to run Digimat computations. In this case, Visual
C/C++ redistributable files will be installed. Finally, the installer giving access to the ready-to-run
Digimat models can be installed right after the software installation, assuming the separate installer for
the example manual was downloaded as well.
29
Figure I.1.29: A summary of the installation details is given and can be checked. Proceeding with the "Install" button
will start the installation of Digimat.
30
Installation
Getting started
Figure I.1.30: The installation of the Digimat core software is executed.
Figure I.1.31: Third party products are installed followed by the installation of the Visual C/C++ redistributable files
(if chosen). Third party components must be installed in order to be able to run the Digimat software.
Figure I.1.32: As a last step, the examples manual is installed (if chosen).
31
32
Installation
Getting started
Figure I.1.33: The setup of the MX database is called (if chosen). In case that you already have an existing MX
database running as a service on the current machine, this service must be ended first (please use MX
database tools to do so). The screenshot shows a typical setup for a MX database to be created and
started as a windows service every time the computer is booted. For management of the database a
manager password has to be set. Clicking " Create " will setup the such defined service.
33
Figure I.1.34: If Digimat-FE installation is selected, the Intel-MPI service must be installed to be able to launch parallel
computations. At the end of installation, it is needed to register by entering its user name (including
domain name, e.g., E-XSTREAM\username) and its password and to click on register to save it in
register database.
34
Installation
Getting started
Figure I.1.35: In the end of the installation procedure additional information is given for Abaqus users. This let you
know how to update the abaqus_v6.env file to be able to use the Digimat-CAE/Abaqus interface. If
Digimat-CAE/Abaqus is required, we strongly recommend to read I.5.1 before proceeding with the linking
procedure to the Abaqus solver.
Figure I.1.36: Upon finalization of the installation the user can choose to reboot the computer immediately. Please
note that to ensure safely a fully functional installation of Digimat the reboot of the machine is
mandatory!
Installation I.2
FlexLM Licensing
I.2.1
Licensing system . . . . . . . . . . . . .
Floating licenses . . . . . . . . . . . . . . . .
Floating licenses and redundant license servers
Node-locked licenses . . . . . . . . . . . . . .
I.2.2
Digimat via FlexLM licensing . . . . . .
License features . . . . . . . . . . . . . . . .
Usage of licenses . . . . . . . . . . . . . . . .
I.2.3
Set-up of the licensing system . . . . . .
Windows . . . . . . . . . . . . . . . . . . . .
Linux . . . . . . . . . . . . . . . . . . . . . .
Manual start of the license server . . . . . . .
I.2.4
Configuration of the licensing system . .
35
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
36
36
37
37
38
38
38
40
40
40
40
41
36
Installation
I.2.1
FlexLM Licensing
Licensing system
Digimat licensing is based on the FlexLM license manager from Macrovision Corporation. It enables the
following types of licensing:
paid-up or lease agreement
floating or node-locked (file based) licenses
For an overview over the currently supported version of the FlexLM licensing system, please refer to the
appendix ??. For information about the current limitations in the set up of licensing systems, please refer to
appendix ??.
Floating licenses
Digimat uses FlexLM to manage floating licenses on a network. Floating licenses enable to have access,
from anywhere on a network, to Digimat licenses. Such system, providing licenses to Digimat when a job is
executed, is called a license server. So that this works properly, the license server must continuously run on
one of the network computers. If the license server is down for any reason, the licenses will not be accessible
and Digimat jobs will not run.
The license server is basically made of three parts.
lmgrd is the FlexLM license manager. It deals with requests coming from the software (in this case
Digimat products), and redirects these requests to the vendor specific server. It also manages all the
vendor specific servers under its responsibility.
EXLM is the e-Xstream engineering specific server. It answers to requests coming from lmgrd based
on the vendor specific license files and the history of use of the licenses.
DIGIMAT.lic is the e-Xstream engineering specific license file. It contains information about the
licensed Digimat products available to the user. Floating license files start with the following two
headlines
SERVER . . .
VENDOR EXLM. . .
while it is not the case for node-locked licenses.
If those two heading lines are not present, this means the license file actually contains node-locked
licenses. If this is not what you were expecting to receive, it is suggested to contact the support team
of e-Xstream engineering at support@e-xstream.com.
In order to have a valid-working licensing installation, these three components must have been
installed and lmgrd must be running!
When running a Digimat job, a first request is send to lmgrd in order to check out the required licenses, which
depends on the Digimat product that is executed.
After this first request is addressed to lmgrd, periodic connections are made by the Digimat product with lmgrd
to check that the server and license status are still valid. These periodic connections are called heartbeats
and are usually made every minute.
If the connection to the license server is lost by the Digimat product (in other words if several heartbeats failed),
a reconnection strategy is started. Depending on the Digimat product running, the number of reconnection
attempts as well as the time interval between two tries varies. This information is printed in the log file or in
dialog boxes used by the Digimat product. If the reconnection does not occur for some reason, the product
exits, abruptly stopping any on-going simulation.
I.2.1. Licensing system
37
Licensing utilities are provided with FlexLM (lmtools and related utilities). These can be used to manage the
license server by allowing server starts and stop actions, as well as license changes. lmhostid can be employed
to extract the necessary information to generate a license file for the machine on which it was run. More
information about FlexLM licensing utilities can be found in the FlexLM end user guide, which is provided
with the Digimat installation files.
Floating licenses and redundant license servers
In the single license server configuration, licenses are not available when the license server is down, disconnected
from the network or if the lmgrd daemon has been shut down. If it is mandatory for licenses to be available
all the time, then a redundant server setup can be the solution. In that case, three servers are running rather
than one. If at least two of the three servers are available, users are able to checkout licenses. These three
redundant servers must be well interconnected, as they will exchange information periodically, i.e., heartbeats,
and at each license checkout.
For redundant server configuration, the license file contains three SERVER lines. Compared to the single
server configuration, these SERVER lines must contain a port number at the end of the line.
The three server will find each other using their host names. Therefore, domain name information for the
three servers must be up to date.
To start the servers, the procedure is the same as for the single server configuration, and must be repeated on
each of the redundant servers.
On the client side, the address of the three servers must be used to benefit from the redundancy.
Node-locked licenses
Floating licenses are not mandatory. It is also possible as well as sometimes useful to use a single node-locked
license file, especially for laptops when not having constant access to a network that would provide a floating
license. If using node-locked licenses, the installation of a license server is not required. Notice though that
a node-locked license points towards the physical address of a computer, which means it is attributed to a
single specific computer and cannot be transferred on other ones.
38
Installation
I.2.2
FlexLM Licensing
Digimat via FlexLM licensing
In the following, the Digimat specific usage of the FlexLM licensing system will be described.
License features
A sample license feature exhibits the following structure and underlying information.
FEATURE DIGIMAT_MF EXLM 4.2 31-jan-2013 1 ISSUED=01-jan-2012 \
START=01-jan-2012 SIGN=2CEA5858D9E6
DIGIMAT_MF : It refers to the feature name. It refers to a product of the Digimat suite, or to an
interface between Digimat and an external code.
4.2 : This tells for which version of the software the license is valid. It contains only the first two numbers
of the Digimat version number. This means the license file is valid for any Digimat version numbered
as 4.2.x.
31-jan-2013 : This is the date until which the license feature is valid.
1: This is the total number of seats available for the corresponding license feature.
In Digimat 6.0.1, all the previously existing license features are maintained.
Usage of licenses
Digimat licenses usage depends on the features considered.

When starting Digimat-MF, Digimat-FE, Digimat-MAP, Digimat-MX, Digimat-RP or Digimat-HC the
existence of a feature is verified but also the availability of a seat of the required license feature. If
no seat is available, those products cannot be opened. If a seat is available, it will immediately be
checked-out and the product will open.
At the start-up of the Digimat-CAE GUI, a check on the existence of a structural license is performed: it
could also be one of the two features referring to structural analyses, being DIGIMAT_CAE_STRUCTURAL or DIGIMAT_CAE_LINEAR.
If any of these exists, the GUI opens successfully. Then, when defining the interface code the user
intends to work with, the existence of the license feature of the selected interface is again verified. It
could also be one of the global flexible license features. If none exists, the interface cannot be selected.
A similar verification is performed when selecting the injection interface format.
Up to now, no license feature is consumed. This is done when executing the Digimat-CAE job to
generate the interface files. It is also done when executing a coupled structural Digimat job. In such
case, the license features, both structural and injection, are checked out during the entire simulation.
They are checked in once the job is over.
In case of parallel computation, one structural feature seat is first used, and for the other n-1 processors
used for the parallel computation, n-1 Digimat tokens are checked out. For example, a Digimat-CAE/LSDYNA parallel run on 4 processors consumes 1 seat of a structural feature as well as 3 Digimat tokens.
When performing parallel computations using distributed storage devices, Digimat requires the DIGIMAT2CAE_Working_Directory setting to be defined in your DIGIMAT_Settings.ini file (see Section
I.4.1). This setting has to indicate a global, unique, location which can be accessed by all the processes.
If this setting is not defined, it can result in an overconsumption of license features!
Finally, in the case of Digimat-MX, one DIGIMAT_MX+ (tried first) or DIGIMAT_MX feature seat is
consumed at the moment the GUI opens. No more seat is required at any time. When performing a
reverse-engineering, no DIGIMAT_MF seat is required though the Digimat executable is used.
I.2.2. Digimat via FlexLM licensing
39
To encrypt files, a DIGIMAT_MX+ feature is required.

To use encrypted files and decrypt them in the Digimat products, the user needs to get a DIGIMAT_CRYPT feature. Without this, the user cannot use the encrypted files provided in the DigimatMX database by the material suppliers.
For more information, please contact the support team at support@e-xstream.com.
40
Installation
I.2.3
FlexLM Licensing
Set-up of the licensing system
In order to set-up Digimat licensing, the executable DIGIMAT_licensing_install.exe needs to be run from the
installation medium and the installation steps followed. This setup allows to
install EXLM, lmgrd as well as license management tools;
start lmgrd.
For a step-by-step example for the standard installation of the FlexLM license server via the provided installer,
please refer to section I.1.3.
If a lmgrd server is already running on a computer, only EXLM can be installed and the previous installation
of FlexLM server be used to manage EXLM.
e-Xstream engineering recommends proceeding with the complete installation and using a separate
lmgrd process, not a previously installed one!
For further details, please consult the FlexLM end user guide.
Windows
Under Windows, lmgrd should be started at the end of the installation procedure. lmgrd is installed as a
Windows service. Windows services are restarted automatically after a reboot. Notice that it is required to be
logged as administrator in order to install a Windows service.
Linux
Under Linux, lmgrd should also be started at the end of the installation procedure but this starting process will
be active only till the next reboot of the Linux machine. Each time the Linux machine is rebooted, the lmgrd
must be restarted manually (see below). There is no option as for Windows operating system to activate
automatically this lmgrd restart.
Remark: The lmgrd server can be installed and run on a computer working with a different operating system
from the one on which the Digimat software suite itself is installed and run.
Manual start of the license server
Under both operating systems, Windows as well as Linux, the license server can be started manually. The
command to start the process is the following:
lmgrd -c Digimat.lic -l Digimat.log
After lmgrd start-up, a DIGIMAT.log file is created and keeps track, among others, of the license server status
as well as check-ins and check-outs of Digimat licenses.
For debugging purposes, the FlexLM server can also be started in an interactive mode. To do so, please type
lmgrd.exe -c Digimat.lic -l digimat.log
-z
I.2.4. Configuration of the licensing system
I.2.4
41
Configuration of the licensing system
In the DIGIMAT_Settings.ini file (see Section I.4.1), it is required to set the EXLM_LICENSE_FILE key
to a valid license file location. Most classical values are:
Floating licenses:
port@host where host refers to the IP address or the host name of the computer on which runs the
license server, and port is the port to be used to establish the connection between the application
and the license server (note that a port is not mandatory). Multiple license servers can be defined
with different @host references separated by : under Linux and ; under Windows.
Example:
EXLM_LICENSE_FILE = @WorkStation1:@192.168.1.10
Node-locked license file:
The full path to the license file and its name are required.
You can also set in your operating system the EXLM_LICENSE_FILE environment variable in order to avoid
the need to define it in your DIGIMAT_Settings.ini file.
For other values, please refer to the FlexLM end user guide which is in the root directory of your installation
media.
If the DIGIMAT_Settings.ini file cannot be located during a Digimat job, or if the file does not contain the
EXLM_LICENSE_FILE key, licenses will be searched in the previously used licensing locations as well as
the default location, being
Windows: C:\DIGIMAT\licensing,
Linux: /usr/local/DIGIMAT/licensing.
Setting the correct license location can be done by using the Set license location option in the License menu
of the Digimat platform (see Section I.3.1).
Installation I.3
I.3.1
I.3.2
Licensing location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Licensing status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
43
44
44
44
Installation
I.3.1
Licensing location
The licensing location can be directly defined by using the settings option of the Digimat platform (see
Figure I.3.1).
Figure I.3.1: Setting the licensing location via the Digimat GUI.
I.3.2
Licensing status
Also available under the settings options (see Figure I.3.1) is query of the license status. This option gives
the user information about the status of the licenses on the current license server. Licenses in use are seen as
checked out licenses. When they are released, a check-in feature is written in the log file.
Installation I.4
Digimat settings
I.4.1
I.4.2
The DIGIMAT_Settings.ini file . . . .

Structure of the DIGIMAT_Settings.ini
Remarks . . . . . . . . . . . . . . . . . . .
I.4.3
Digimat environment variables . . . .
45
. . .
file .
. . .
. . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
46
47
50
51
46
Installation
I.4.1
Digimat settings
The DIGIMAT_Settings.ini file
Digimat settings are set by the DIGIMAT_Settings.ini file which contains a list of key-values. This file
is read by Digimat each time the platform is launched to let them become the current settings. The entire
Digimat installation can be parameterized by these settings.
Digimat looks in the following directories for the DIGIMAT_Settings.ini file:
1. in the current working directory, i.e., the directory in which the computation is run;
2. in the directory pointed to by the environment variable DIGIMAT_BIN.
Note that Digimat will use the first DIGIMAT_Settings.ini file that it finds! Since it first looks in the
current working directory, it allows using a local settings file, and if none is defined, it is not problematic as
long as it can find the global settings file defined in the folder where the DIGIMAT_BIN variable is pointing
to.
The DIGIMAT_Settings.ini file can be modified from the platform settings menu (see Figure I.4.1) or directly
via a text editor.
Figure I.4.1: Definition of Digimat settings.
I.4.2. Structure of the DIGIMAT_Settings.ini file
I.4.2
47
Structure of the DIGIMAT_Settings.ini file
The DIGIMAT_Settings.ini file is made of sections delimited by a line [SectionKeyWord], each section
containing a list of lines key = value.
For the current version, this file is made of a unique section which is identified by the [Default] tag as a header
to the file content. The list of keys that can be used is the following:
ABAQUS_Directory: path to the Abaqus root directory.

Acrobat_Exec: path to Adobe Reader executable, including its name.
ANSYS_Directory: path to the ANSYS root directory.
ASTER_Directory: path to the ASTER binaries.
DIGIMAT2CAE_Directory: path to the Digimat-CAE binaries.
DIGIMAT2CAE_Manual_Directory: path to the Digimat-CAE documentation. It is used by Digimat when opening the documentation (general or context help page) from the GUI.
DIGIMAT2CAE_Working_Directory: path to the working directory used by Digimat-CAE.
DIGIMAT2MARC_Directory: path to the directory containing Digimat-CAE/Marc executable (see
Section I.5.3).
DIGIMAT2SAMCEF_Directory: path to the directory containing Digimat-CAE/SAMCEF executable
(see Section I.5.5).
DIGIMATFE_Directory: path to the Digimat-FE binaries.
DIGIMATFE_Manual_Directory: path to the Digimat-FE documentation. It is used by Digimat when
opening the documentation (general or context help page) from the GUI.
DIGIMATFE_Working_Directory: path to the working directory used by Digimat-FE.
DIGIMATHC_Directory: path to the Digimat-HC binaries.
DIGIMATHC_Manual_Directory: path to the Digimat-HC documentation. It is used by Digimat when opening the documentation (general or context help page) from the GUI.
DIGIMATHC_Working_Directory: path to the working directory used by Digimat-HC.
DIGIMATMF_Directory: path to the Digimat-MF binaries.
DIGIMATMF_Manual_Directory: path to the Digimat-MF documentation. It is used by Digimat when opening the documentation (general or context help page) from the GUI.
DIGIMATMF_Working_Directory: path to the working directory used by Digimat-MF.
DIGIMATMX_Database_Cluster: list of the locations (localhost and server IP addresses) of servers
on which a successful connection has been made. The first listed value is the location of the server
on which the last successful connection occurred and it is the default value used by Digimat-MX. If no
successful connection ever occurred, localhost is the only value.
DIGIMATMX_ Database_Name: Digimat-MX default database to be opened. The default value is
mxdb.
DIGIMATMX_Directory: path to the Digimat-MX binaries.
DIGIMATMX_Manual_Directory: path to the Digimat-MX documentation. It is used by Digimat when opening the documentation (general or context help page) from the GUI.
DIGIMATMX_Request_Data_Format: length of the content of the email which is automatically
created when requesting data to a material supplier from Digimat-MX. The two possible values are Long
(which is the default) and Short (which is usually required when using Lotus Notes as e-mail client).
DIGIMATMX_User: Digimat-MX user name.
DIGIMATMX_Working_Directory: path to the working directory used by Digimat-MX.
DIGIMATRP_Directory: path to the Digimat-RP binaries.
DIGIMAT_Directory: path to the working directory used by the Digimat platform.
EXLM_LICENSE_FILE: path to the Digimat license file or to the license server. In the case of a
license server, the IP address must be prefixed by an @ symbol. See Section I.2.4 for more information.
HPMPI_Directory: path to the HP-MPI root directory.
HYPERWORKS_Directory: path to the HyperWorks root directory.
Log_output: path to the location where Digimat will output its log messages. This is one of the keys
a user could most probably be brought to change. The different choices are:
Default: the Digimat messages will be output to the default location which means, for example:
48
Installation
Digimat settings
in the .log file of the analysis/job if using Digimat-MF or a Digimat-CAE interface;

the dos screen when using the interface to ANSYS, ...
Any valid path to a file, including its name. The log messages will be output to the indicated file.
LSDYNA_Directory: path to the directory containing Digimat-CAE/LS-DYNA executable (see Section I.5.6).
LSPREPOST_Directory: path to the LS-PrePost root directory.
MAP_Directory: path to the Digimat-MAP binaries.
MAP_Manual_Directory: path to the Digimat-MAP documentation. It is used by Digimat when
opening the documentation (general or context help page) from the GUI.
MAP_Working_Directory: path to the working directory used by Digimat-MAP.
MARC_Directory: path to the Marc root directory.
MENTAT_Directory: path to the Mentat root directory.
MSCNASTRAN_Directory: path to the MSC Nastran root directory.
Manual_Directory: path to the Digimat documentation.
PAMCRASH_Directory: path to the PAM-CRASH root directory.
PATRAN_Directory: path to the Patran root directory.
RADIOSS_Directory: path to the directory containing Digimat-CAE/RADIOSS executable (see Section I.5.10).
SAMCEF_Directory: path to the Samcef root directory.
VISUALVIEWER_Directory: path to the Visual-Viewer root directory.
Working_Directory: path to the working directory used by Digimat.
The following settings are only active when using Digimat enabled products via Altair Gridworks Licensing:
ALTAIR_LICENSE_PATH: path to the Altair license server, using the format port@IPaddress.
DIGIMATMX_Crypt: key allowing to encrypt and decrypt Digimat Material files. This key is sent on
request by contacting support@e-xstream.com.
DIGIMATMX_User_ID: user ID required to encrypt and decrypt Digimat material files. This ID is
sent on request by contacting support@e-xstream.com.
All these parameters can be set from the Digimat platform settings manager (see Figure I.4.1).
An example of a valid DIGIMAT_Settings.ini file is:
[Default]
ABAQUS_Directory = C:\SIMULIA\Abaqus\6.12-2
ANSYS_Directory = C:\Program Files\ANSYS Inc\v145
ASTER_Directory = C:\DIGIMAT\DigimatHC\5.0.1\Code_Aster81
Acrobat_Exec = C:\Program Files (x86)\Adobe\Reader 11.0\Reader\AcroRd32.exe
DIGIMAT2CAE_Directory = C:\DIGIMAT\Digimat2CAE\5.0.1\exec
DIGIMAT2CAE_Manual_Directory = C:\DIGIMAT\Digimat2CAE\5.0.1\manual
DIGIMAT2CAE_Working_Directory = C:\DIGIMAT\working
DIGIMATFE_Directory = C:\DIGIMAT\DigimatFE\5.0.1\exec
DIGIMATFE_Manual_Directory = C:\DIGIMAT\DigimatFE\5.0.1\manual
DIGIMATFE_Working_Directory = C:\DIGIMAT\working
DIGIMATHC_Directory = C:\DIGIMAT\DigimatHC\5.0.1\exec
DIGIMATHC_Manual_Directory = C:\DIGIMAT\DigimatHC\5.0.1\manual
DIGIMATHC_Working_Directory = C:\DIGIMAT\working
DIGIMATMF_Directory = C:\DIGIMAT\DigimatMF\5.0.1\exec
DIGIMATMF_Manual_Directory = C:\DIGIMAT\DigimatMF\5.0.1\manual
DIGIMATMF_Working_Directory = C:\DIGIMAT\working
DIGIMATMX_Database_Cluster = localhost
DIGIMATMX_Database_Name = mxdb
DIGIMATMX_Directory = C:\DIGIMAT\DigimatMX\5.0.1\exec
DIGIMATMX_Manual_Directory = C:\DIGIMAT\DigimatMX\5.0.1\manual
DIGIMATMX_User = manager
DIGIMATMX_Working_Directory = C:\DIGIMAT\working
DIGIMATRP_Directory = C:\DIGIMAT\DigimatRP\5.0.1\exec
DIGIMAT_Directory = C:\DIGIMAT\Digimat\5.0.1\exec
EXLM_LICENSE_FILE = @127.0.0.1
HPMPI_Directory = C:\Program Files (x86)\Hewlett-Packard\HP-MPI
HYPERWORKS_Directory = C:\Program Files\Altair\11.0\hw
LSPREPOST_Directory = C:\Program Files\LSTC\LS-PrePost\3.2-X64
Log_output = Default
MAP_Directory = C:\DIGIMAT\Map\5.0.1\exec
MAP_Manual_Directory = C:\DIGIMAT\Map\5.0.1\manual
MAP_Working_Directory = C:\DIGIMAT\working
MARC_Directory = C:\MSC.Software\Marc\2012\marc2012
I.4.2. Structure of the DIGIMAT_Settings.ini file
MENTAT_Directory = C:\MSC.Software\Marc\2012\mentat2012
MSCNASTRAN_Directory = C:\MSC.Software\MSC_Nastran\20131
Manual_Directory = C:\DIGIMAT\Digimat\5.0.1\manual
PAMCRASH_Directory = C:\Program Files (x86)\ESI Group\Virtual-Performance\2013.0
PATRAN_Directory = C:\MSC.Software\Patran_x64\20131
SAMCEF_Directory = C:\Program Files\Samtech\Samcef\V14.1-02_x64
VISUALVIEWER_Directory = C:\Program Files (x86)\ESI Group\Visual-Environment\9.0
Working_Directory = C:\DIGIMAT\working
49
50
Installation
Digimat settings
Remarks
The listing order of the keywords does not matter.

Trailing or leading white spaces, tabulations, or quotations marks ( ) are removed from the values.
The initial keyword [Default] must be defined.
A path including directories with long names can be written in short notation, e.g.,
C:\Progra1\DIGIMAT.
I.4.3. Digimat environment variables
I.4.3
51
Digimat environment variables
Environment variables are defined automatically during the installation of Digimat. However their values can
be changed through the Digimat environment variables manager accessible from the Digimat platform top
menu bar.
Figure I.4.2: Definition of Digimat environment variables
The defined system environment variables are the following ones:

DIGIMAT_HELP: points towards the directory containing the manual of Digimat.
DIGIMAT_MATERIALS: points towards the directory which can be used as a default location to store
and retrieve Digimat material files.
DIGIMAT_BIN: points towards the directory containing the Digimat platform executable and the DIGIMAT_Settings.ini file.
All environment variables are automatically created during the installation of Digimat platform. In addition,
the path to the shortcuts folder, containing the file that launches the Digimat platform, as well as the path
to the bin folder of Digimat-MX are added to the system environment variable PATH.
Installation I.5
I.5.1
Digimat-CAE/Abaqus . . . . . . . . . . . . . . . . . . . . .
Installation procedure . . . . . . . . . . . . . . . . . . . . . . . .
Abaqus Configuration . . . . . . . . . . . . . . . . . . . . . . . .
I.5.2
Digimat-CAE/ANSYS . . . . . . . . . . . . . . . . . . . . .
Digimat-CAE/ANSYS for Windows . . . . . . . . . . . . . . . . .
Digimat-CAE/ANSYS Workbench for Windows . . . . . . . . . .
Digimat-CAE/ANSYS for Linux . . . . . . . . . . . . . . . . . . .
Configuration of Remote Solve Manager . . . . . . . . . . . . . .
I.5.3
Digimat-CAE/Marc . . . . . . . . . . . . . . . . . . . . . . .
Windows platforms . . . . . . . . . . . . . . . . . . . . . . . . . .
Linux platforms . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installation of the Digimat plugin for Marc Mentat . . . . . . . .
I.5.4
Licensing for Digimat-CAE/MSC Nastran SOL400 computations .
I.5.5
Digimat-CAE/SAMCEF . . . . . . . . . . . . . . . . . . . .
I.5.6
Digimat-CAE/LS-DYNA . . . . . . . . . . . . . . . . . . . .
Linux platforms . . . . . . . . . . . . . . . . . . . . . . . . . . .
Windows platform . . . . . . . . . . . . . . . . . . . . . . . . . .
Licensing for parallel Digimat-CAE/LS-DYNA computations . . . .
I.5.7
Licensing for Digimat-CAE/MSC Nastran SOL700 computations .
I.5.8
Digimat-CAE/PAM-CRASH . . . . . . . . . . . . . . . . . .
Dynamic libraries . . . . . . . . . . . . . . . . . . . . . . . . . . .
I.5.9
I.5.10
Digimat-CAE/RADIOSS Block 51 . . . . . . . . . . . . . . .
Dynamic libraries . . . . . . . . . . . . . . . . . . . . . . . . . . .
Static libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . .
53
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
54
54
54
57
57
57
60
64
64
66
66
66
68
69
70
70
70
71
71
74
74
74
76
77
78
78
78
79
79
79
81
81
84
84
84
84
54
Installation
I.5.11
Digimat-CAE/MSC Nastran SOL1XX

Installation procedure . . . . . . . . . . .
I.5.12
Digimat-CAE/nCode DesignLife . . .
I.5.13
Digimat-CAE/VirtualLab . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
87
87
88
89
I.5.1. Digimat-CAE/Abaqus
I.5.1
55
Digimat-CAE/Abaqus
The objective of this section is to explain how to install the interface between Digimat and Abaqus.
Installation procedure
Digimat-CAE/Abaqus is provided as a set of dynamic libraries. These libraries contain Digimat capabilities,
allowing the use of Digimat materials in Abaqus analyses. This link can be performed on both Linux and
Windows operating systems.
Dynamic libraries are version dependent. This means that libraries provided for Abaqus 6.13 cannot be used
with Abaqus 6.14.
Dynamic libraries are located in the directory
Digimat2CAE/X.X.X/exec/digi2aba
of the Digimat installation. This directory contains one subfolder of the type lib_v6.X-X for each supported
version of Abaqus. Each of these folders contains three dynamic libraries:
one single precision library for Abaqus/Explicit: explicitU.dll (Windows) or libexplicitU.so (Linux)
one double precision library for Abaqus/Explicit: explicitU-D.dll (Windows) or libexplicitU-D.so (Linux)
one double precision library for Abaqus/Standard: standardU.dll (Windows) or libstandardU.so (Linux)
For Windows platforms, they also contain dynamic libraries for third-party components
digimathdf5_cppdll.dll
digimathdf5_hldll.dll
digimathdf5dll.dll
digimatMathTools.dll
szip.dll
tinyxmlSTL.dll
zlib.dll
If the location of the dynamic libraries is changed, all the third-party components must also be moved to the
new location.
Abaqus Configuration
For Windows platforms An environment file abaqus_v6.env is provided with the Digimat installation for
each supported Abaqus version. This file is located in the
Digimat2CAE\X.X.X\exec\digi2aba\lib_v6.X-X
directory. To launch a coupled analyis, simply copy this environment file to the working directory, i.e., the
directory from where the Abaqus job is launched.
To launch parallel computations, MS-Message Passing Interface (MPI) must be installed by using the installer
shipped with Abaqus. If MS-MPI is not installed, it can be downloaded at the Microsoft homepage.
The path to the Abaqus installation must be specified during the installation of Digimat. The Digimat plugins
are automatically installed for this version of Abaqus. To use another version of Abaqus with the plugins, the
abaqus_v6.env file, located in
56
Installation
C:\Abaqus\6.XX-X\site\
must be edited by adding the following line:
plugin_central_dir = r"C:\DIGIMAT\Digimat2CAE\X.X.X\exec\digi2Aba\abaqus_plugins\"
For Linux platforms The abaqus_v6.env file, located in

/opt/abaqus/6.XX-X/site/
must be edited by adding the following at the end of the file (replacing the versions and location by the
installed Digimat and Abaqus version):
usub_lib_dir = "/opt/Digimat/Digimat2CAE/X.X.X/exec/digi2aba/lib_6.XX-X"
standard_parallel=ALL
import os, socket
os.environ["ABA_BATCH_OVERRIDE"] = "1"
os.environ["ABA_MPI_SKIP_BUNCH_NODES"] = "1"
mp_mode = MPI
cpus = globals().get("cpus", locals().get("cpus", 1))
mp_host_list = []
for i in range(cpus):
mp_host_list.append([socket.gethostname(), 1])
del i
To run a job on several nodes, the last five lines must be replaced by:
mp_host_list=[["node1",1],["node1",1],["node2",1],["node2",1]]
Where node1 and node2 are the name or IP address of the nodes where computation is ran. The node name
must be repeated as many times as there are cores on this node, and the "1" cannot be replaced by the number
of cores on the node. This ensures that MPI parallelization is used, and not and shared memory parallelization
(which is default for Abaqus and is not supported by Digimat).
Executing a parallel job under Windows 64-bit
In addition to single processor computation on Windows 32- and 64-bit, it is possible to also perform parallel
computations under Windows 64 bits. After having configured Digimat-CAE/Abaqus interface (see I.5.1
beforehand), user should should open a dos command prompt.
The command used to start a parallel computation is
For Digimat-CAE/Abaqus Standard and Digimat-CAE/Abaqus Explicit:
abq6122.exe job=name_of_the_Abaqus_input cpus=n
The command used to start a computation on a single processor is the same, except that the
cpus=n
argument is omitted.
Executing a parallel job under Linux 64-bit
Parallel computations, as well as single processor computation, involving Digimat-CAE/Abaqus interfaces
(Standard or Explicit) can be performed under Linux 64-bit using MPI.
The first step is to add Digimat third-party libraries to LD_LIBRARY_PATH environment variable:
LD_LIBRARY_PATH=DIGIMAT_INSTALL/Digimat/Digimat/X.X.X/lib/:$LD_LIBRARY_PATH
I.5.1. Digimat-CAE/Abaqus
57
where DIGIMAT_INSTALL is the Digimat installation directory (e.g., /opt) and X.X.X is the Digimat version.
The number of CPU over which the job has to be launched must be specified in the command line. To do
this, user should open a shell command prompt.
The command to start the parallel computation is:
abq6122.exe job=name_of_the_Abaqus_input cpus=n
The command used to start a computation on a single processor is the same, except that the
cpus=n
argument is omitted.
58
Installation
I.5.2
Digimat-CAE/ANSYS
The objective of this section is to explain how to install the interface between Digimat and ANSYS.
Digimat-CAE/ANSYS is provided as a set of dynamic libraries. These libraries contain Digimat capabilities,
allowing to use Digimat materials in ANSYS analyses.
For more information concerning supported ANSYS releases and platforms, please refer to the apppendix ??.
Digimat-CAE/ANSYS for Windows
The Digimat-CAE/ANSYS interface for the Windows operating system is distributed in two parts. The first
part contains third-party components as listed in the following:
digimathdf5_cppdll.dll
digimathdf5_hldll.dll
digimathdf5dll.dll
digimatMathTools.dll
szip.dll
tinyxmlSTL.dll
zlib.dll
These files are found in the

Digimat2CAE\X.X.X\exec\digi2Ansys
folder of the Digimat installation. The second part contains the libraries which are crucial for the installation
process of the Digimat-CAE/ANSYS interface:
UserMatLib.dll
USolBegLib.dll
USolFinLib.dll
These dynamic libraries can be found in three different sub-folders:
Digimat2CAE\X.X.X\exec\digi2Ansys\DMP_MSMPI
Digimat2CAE\X.X.X\exec\digi2Ansys\DMP_PCMPI
Digimat2CAE\X.X.X\exec\digi2Ansys\SMP
In order to use Digimat-CAE/ANSYS, the user simply needs to point the environment variable
ANS_USER_PATH
to the directory containing the required dynamic libraries. Which ones to use depends on the modus operandi
that will be used for the Ansys solver (single processor using SMP or multi processor using DMP):
Configuration for single processor computation: point the environment variable to the sub folder called
Digimat2CAE\X.X.X\exec\digi2Ansys\SMP
I.5.2. Digimat-CAE/ANSYS
59
Configuration for DMP parallel computations:

DMP - Platform-MPI
Point the environment variable to the sub folder called DMP_PCMPI
DMP - MS-MPI
Point the environment variable to the sub folder called DMP_MSMPI
Under Windows operating system the environmental variables can be accessed by right-clicking "computer"
and moving to the "Properties" option. The "Advanced settings" will contain a choice to set "Environment
variables...". Please refer to Figures I.5.1 to I.5.3 for an example related to Winfows 7 operating system.
Figure I.5.1: Setting the ANS_USER_PATH environmental variable under Windows 7 operating system - step 1.
Alternatively the Windows command prompt can be used to set the environmental variable. Executing a
command line (C:\Windows\system32\cmd.exe), e.g., for DMP_PCMPI computation:
set ANS_USER_PATH=C:\DIGIMAT\Digimat2CAE\X.X.X\exec\digi2Ansys\DMP_PCMPI
will set the required environmental variable.
The path to digi2ansys library and to the third-party libraries digimathdf5_cppdll.dll, digimathdf5_hldll.dll,
digimathdf5dll.dll, digimatMathTools.dll, szip.dll, tinyxmlSTL.dll, zlib.dll is written in the PATH environment
variables when installing Digimat. If these libraries are moved to another directory, PATH variable has to be
updated by adding the location of this new directory.
Distributed computation with MS-MPI can be executed only if the Microsoft HPC Pack 2008 is installed. This
can be downloaded at the Microsoft homepage. After the installation, please check that the following path is
added in the PATH environment variable: C:\Program Files\Microsoft HPC Pack 2008\Bin.
If a bad version of MS_MPI is used, the computation will stop immediately.
60
Installation
Figure I.5.2: Setting the ANS_USER_PATH environmental variable under Windows 7 operating system - steps 2 and
3.
Multiple installation of Digimat software In case the user wants to have multiple versions of Digimat
installed in parallel, special action has to be taken to create a clean installation. It is explicitly not possible to
have several locations of digi2Ansys defined in the PATH variable.
Thus the PATH (system or user) variable has to be adjusted manually and must point to only one single location
of a Digimat installation for the ANSYS interface, e.g.,
"C:\DIGIMAT\Digimat2CAE\X.X.X\exec\digi2Ansys".
where X.X.X corresponds to the desired Digimat version.
Note: When uninstalling Digimat, this information given in the PATH variable is not deleted.
61
Figure I.5.3: Setting the ANS_USER_PATH environmental variable under Windows 7 operating system - step 4 and
5.
Digimat-CAE/ANSYS Workbench for Windows
Installation of Digimat material library

Once Digimat in installed, user has to check that the Digimat material library has been added in the engineering
data sources, using the following procedure:
1.
2.
3.
4.
5.
6.
Open ANSYS Workbench.

Open the "Engineering data" item in the main window of ANSYS Workbench (Figure I.5.4).
Double click on the "Engineering data" item that appeared in the project frame (Figure I.5.5).
Open the "Engineering data sources" window by clicking the corresponding icon (Figure I.5.6).
Click at the bottom of the C column to add an existing data source from a file (Figure I.5.7).
Browse to the "workbenchSimulationWizard" directory in the Digimat installation directory
(e.g., C:\DIGIMAT\Digimat2CAE\X.X.X\exec\digi2Ansys) and select the file "DigimatDummyMaterial.xml" which adds the library "DigimatDummyMaterial" to the engineering data sources (Figure
I.5.8).
To check that the Digimat material library has been added to the engineering data sources, the data source
"DigimatDummyMaterial" must appear in the list of engineering data sources (see Figure I.5.9).
62
Installation
Figure I.5.4: Entering in the "Engineering Data" section, step 1.
Figure I.5.5: Entering in the "Engineering Data" section, step 2.
Figure I.5.6: Opening the "Engineering Data Sources" window.
Figure I.5.7: Adding a new engineering data source.
Figure I.5.8: Selecting the file "DigimatDummyMaterial.xml".
Figure I.5.9: Checking the creation of the data source "DigimatDummyMaterial"
63
64
Installation
Installation of Digimat-CAE /ANSYS Workbench ACT plugin

With ANSYS v14.5 and v15.0, an additional ACT extension is available for the the ANSYS/Workbench
environment. This add-on module simplifies the integration of Digimat materials in an FE analysis, the postprocessing of some Digimat history variables, and provides a better integration with Digimat-MAP. It is based
on the Application Customization Toolkit environment, and does not require any specific licensing feature.
In order to be able to use this extension, the user must install the DigimatACTplugin extension, following
this step-by-step procedure:
1. Open ANSYS Workbench.
2. Click on menu bar item "Extension", then "Install extension..." (Figure I.5.10).
3. In the window that pops up, browse to the "DigimatACTplugin.wbex" file, provided in the Digimat directory, in the sub-folder: Digimat2CAE\X.X.X\exec\digi2Ansys\workbenchACTplugin.
This will install the extension by copying the corresponding files in the users directory:
%appdata%\Ansys\v145\AdvancedAddinPackage\extensions
Figure I.5.10: Installing the DigimatACTplugin extension for ANSYS Workbench.
For each new ANSYS/Workbench session where the Digimat ACT plugin is needed, it must be loaded by
clicking "Extension" then "Manage extension..." in the menu bar, and ticking the DigimatACTplugin extension
(Figure I.5.11). It is also possible to automatically load this extension, by going in the trough the "Extension"
tab of the "Options" window (Figure I.5.12).
Remark: : The Digimat ACT plugin is specific to a given ANSYS Workbench extension, but also to a given
Digimat version; so make sure to reinstall the plugin when you upgrade your ANSYS or Digimat version, and
to edit your environment variables so that the plugin version matches the Digimat version called by ANSYS.
Moreover, the plugin can only be used with Digimat 6.0.1 an later versions; using a lower version will block
65
Figure I.5.11: Loading the DigimatACTplugin extension for ANSYS Workbench.
Figure I.5.12: Automatic loading of the DigimatACTplugin extension for ANSYS Workbench.
the "Hybrid Parameters generation" capability of the plugin, and may also result in unrecognized keywords in
the material file.
Digimat-CAE/ANSYS for Linux
Under Linux, the Digimat-CAE/ANSYS interface is distributed using the shared library
libansuser.so
This library can be found in the Digimat installation directory, e.g.,
(...)/Digimat2CAE/X.X.X/exec/digi2ansys
In order to use Digimat-CAE/ANSYS the user simply needs to set the ANS_USER_PATH environment variable
to the directory containing the libansuser.so library.
This can be done for example by executing a command similar to the following line in the command prompt:
export ANS_USER_PATH=/opt/Digimat/Digimat2CAE/X.X.X/exec/digi2ansys:
/opt/Digimat/Digimat/X.X.X/lib
Configuration of Remote Solve Manager
66
Installation
In order to run Digimat/ANSYS coupled analyses through the Remote Solve Manager, it is necessary to
modify the following configuration file (assuming a default installation of ANSYS):
C:\Program Files\ANSYS Inc\vXXX\RSM\Config\xml\Ansys_Generic.xml.
This file must be replaced (or edited) following the file provided in the Digimat directory, in the sub-folder:
Digimat2CAE\X.X.X\exec\digi2Ansys\RemoteSolveManager\vXX.X. This operation will require administrator rights.
The additional lines will force the Remote Solve Manager to copy the Digimat input files (material file,
orientation file, etc...) from the local analysis directory to the remote scratch directory, and to retieve the
Digimat files after computation.
Remark: The RSM configuration file must be edited on the local machine, but also on the master
node of the remote machine. This is especially important when the remote machine is a multi-node cluster.
I.5.3. Digimat-CAE/Marc
I.5.3
67
Digimat-CAE/Marc
The objective of this section is to explain how to install the interface between Digimat and Marc.
Digimat-CAE/Marc is the module containing the Digimat capabilities and the required interfaces in order to
be linked with the Marc implicit solver. Linking in general is performed in a static way. For more information
on supported versions and platforms, please refer to the appendix ??. In the following, X.X.X and 201X
denote the Digimat version number, i.e., 6.0.1, and the number of a supported version of Marc, e.g., 2013.1,
respectively.
Windows platforms
The Digimat-CAE/Marc library is embedded inside the Marc executable by linking both libraries. Hence the
following tools and libraries are required in order to generate the executable.
Prerequisites for the linking between Digimat and Marc
The linking procedure requires the following files available from the Digimat and Marc installation directories
e.g.,
C:\DIGIMAT\Digimat2CAE\X.X.X\exec\digi2marc
C:\MSC.Software\Marc\201X\marc201X
For Digimat, the following libraries are needed:
digi2marc20131I8.obj if Marc version 2013.1 is targeted.

digi2marc20140I8.obj if Marc version 2014.0 is targeted.
libifcoremt.lib
libifcoremd.lib
libmmd.lib
libmmt.lib
ifconsol.lib
libifport.lib
libirc.lib
svml_disp.lib
svml_dispmd.lib
svml_dispmt.lib
libifportmd.lib
libiomp5md.lib
For Marc, the following libraries are needed:
68
Installation
All
All
All
All
All
files
files
files
files
files
located
located
located
located
located
in
in
in
in
in
lib\win64i8
intelmkl\win64i8
intelmpi\win64\lib
msmpi\win64\lib
xdr_lib\win64
To link Digimat and Marc libraries together, a linker is needed. Therefore the following software must be
installed before linking Digimat-CAE/Marc.
Microsoft Visual Studio Express 2012 for Windows Desktop
See Section ?? on how to install this software.
Microsoft HPC Pack 2008 if user intents to perform parallel computation using MS-Message Passing
Interface (MS-MPI). It can be downloaded at the following address: Microsoft homepage.
To perform the linking procedure on Windows platforms, please perform the following steps:
1. Go to the directory of Marc version to be used. This directory depends on the Marc version that user
wants to couple with Digimat and on the MPI to be used (MS-MPI or INTEL-MPI). For example, if
using Marc 2013.1 coupled with INTEL-MPI for parallel computations, the directory
C:\DIGIMAT\Digimat2CAE\X.X.X\exec\digi2marc\2013.1\INTELMPI
must be selected. If no parallel computation is planned, the makefile located in INTELMPI directory
must be used.
2. Edit the MARCDIR of the file makefile to point to the right Marc installation directory (by default, it is
set to the Marc default installation)
3. Double-click on the nmake_x64.bat file located next to the makefile.
This procedure generates the new executable digi2marc.exe. This new executable replaces the original
marc.exe file. It requires the file digi2marc20131I8.dll (if using Marc 2013.1) or digi2marc20140I8.dll
(for Marc 2014.0) and the third-party component libraries digimathdf5_cppdll.dll, digimathdf5_hldll.dll, digimathdf5dll.dll, digimatMathTools.dll, szip.dll, tinyxmlSTL.dll, zlib.dll to be placed in the same directory. Those
files are located in directory C:\DIGIMAT\Digimat2CAE\X.X.X\exec\digi2marc
Launching Digimat-CAE/Marc computations on Windows platforms
For a single processor application, in a DOS command prompt, execute the command:
[MARC_INSTALL_DIR]\tools\run_marc.bat -j model.dat
-prog [DIGI2MARC_DIR]\digi2marc
where [MARC_INSTALL_DIR] is the Marc installation directory and [DIGI2MARC_DIR] the directory where
digi2marc.exe has been created.
To launch computation using MS-MPI, the preliminary following steps are required to run Marc DDM i8
with MS-MPI, if the full Microsoft Compute Cluster Pack (CCP) is not installed:
1. Install the Microsoft HPC Pack 2008 R2. This can be installed from the Microsoft homepage. The
required file is mpi_x64.msi (for WIN/XP 64-bit OS). If a bad version of MS-MPI is used, the computation will stop immediately
2. Move to directory
[MARC_INSTALL_DIR]\tools
and edit the file include_win64.bat. Change the lines 103 from:
I.5.3. Digimat-CAE/Marc
69
if %MPITYPE%==ms-mpi SET RUN_JOB1=

"C:\Program Files\Microsoft Compute Cluster Pack\bin\mpiexec.exe"
to
rem if %MPITYPE%==ms-mpi SET RUN_JOB1=
"C:\Program Files\Microsoft Compute Cluster Pack\bin\mpiexec.exe"
if %MPITYPE%==ms-mpi SET RUN_JOB1=
"C:\Program Files\Microsoft HPC Pack 2008 R2\Bin\mpiexec.exe"
Save and exit.
3. Edit the file run_marc.bat.
Change the line 1414 (Marc 2013.1) or 1418 (Marc 2014.0) from:
set run_job=%run_job1% -n %nprocd% "%execnm%" -jid %jid% %nprocdarg%
%nprocdddm% %nsolverarg% %nsolver% -maxnum %maxnum% -itree %itree%
%ntearg% %nte% %ntsarg% %nts% %gpuoption% -dirjob "%dirjob%" %cpinp%
%cpres%
to
rem set run_job=%run_job1% -n %nprocd% "%execnm%" -jid %jid% %nprocdarg%
%ntearg% %nte% %ntsarg% %nts% %gpuoption% -dirjob "%dirjob%" %cpinp%
%cpres%
set run_job=%run_job1% -n %nprocd% "%execnm%" -jid %jid% %nprocdarg%
-nthread %nthread% %gpuoption% -dirjob "%dirjob%" %cpinp% %cpres%
Save and Exit.
Now DDM run using MS-MPI can be executed by using the command in a command prompt:
[MARC_INSTALL_DIR]\tools\run_marc.bat
-j model.dat
-prog {[DIGI2MARC_DIR]\digi2marc}
-nps [N] -mpi ms-mpi
where [N] is the number of CPUs.
Launching Digimat-CAE/Marc computations via Marc Mentat
To use Marc Mentat to launch computations, supersede the original exectuable marc.exe:
1. Create a backup of the original file
[MARC_INSTALL_DIR]\bin\win64i8\marc.exe (e.g., marc_orig.exe);
2. Copy the file digi2marc.exe in the directory [MARC_INSTALL_DIR]\bin\win64i8 and rename it
marc.exe;
3. Copy the file digi2marc.dll and the third-party component libraries digimathdf5_cppdll.dll, digimathdf5_hldll.dll, digimathdf5dll.dll, digimatMathTools.dll, szip.dll, tinyxmlSTL.dll, zlib.dll in the same
directory.
Linux platforms
70
Installation
Linking of Digimat-CAE/Marc executable

To be able to link the customized Digimat-CAE/Marc executable, the following software are required:
An installation of a supported version of Marc;
Access to g++, the GNU C++ compiler.
The Digimat-CAE/Marc objects needed to link the executable are located in the following directory:
[DIGIMAT_INSTALL_DIR]/Digimat/Digimat2CAE/X.X.X/exec/digi2marc/201XX
where [DIGIMAT_INSTALL_DIR] is the installation directory of Digimat 6.0.1 (e.g., /opt/Digimat).
Edit the makefile located in this directory so that the first line with the definition of the path to the
Marc 201X.X installation is correct (e.g., for Marc 2014.0)
MARC_INSTALL_DIR=/opt/msc/Marc/marc2014.0/marc2014
In a shell, move to that directory and type
make
The executable digi2marc.marc.exec should have been created.
Launching Digimat-CAE/Marc computations on Linux platforms
To launch computations under Linux platforms, write a script containing the following lines:
export MSC_LICENSE_FILE=[PORT]@[PATH_TO_LICENSE_FILE]
[MARC_INSTALL_DIR]/tools/run_marc -j nameProblem.dat -prog
[DIGIMAT_INSTALL_DIR]/Digimat/Digimat2CAE/X.X.X/exec/digi2marc/201X/digi2marc
-nps [N] -mpi hpmpi
where [PATH_TO_LICENSE_FILE] is the adress of the machine where the license server is installed, [PORT]
the port used by the Marc license server, [DIGIMAT_INSTALL_DIR] the Digimat installation directory and
[N] the number of CPUs. The nps argument is not mandatory for 1 CPU. -mpi hpmpi ensures that the used
MPI is HP-MPI and not Intel-MPI (not supported).
Installation of the Digimat plugin for Marc Mentat
The plugin files are stored in

[DIGIMAT_INSTALL_DIR]/Digimat2CAE/x.x.x/exec/digi2marc/mentat_plugin
During the Digimat installation procedure, those files are also copied in a Digimat folder in the Marc Mentat
installation directory: [MENTAT_INSTALL_DIR]/digimat. If the Marc Mentat installation directory does not
contain a Digimat folder, copy it from the Digimat installation (cf. mentat_plugin directory here above).
This might happen if Marc Mentat was installed after Digimat or if several versions of Marc Mentat are
installed in which case the Digimat folder was created only in the installation directory of the latest version.
To be able to use the plugin from within Marc Mentat, perform the following steps.
1. Insert the content of the file
[MENTAT_INSTALL_DIR]/digimat/mentatPlugin.xml
at the end of the file [MENTAT_INSTALL_DIR]/menus/menubar.xml (just before the last line, containing
</menubar>). Create first a backup of the original file menubar.xml (e.g., menubar_orig.xml) and
possibly disable the "Read only" status in the file properties.
2. Compile the Digimat plugin menu file digimat.ms by running the following command from the directory
containing the digimat.ms file):
[MENTAT_INSTALL_DIR]/bin/mentat -compile main.msb
Copy the new file main.msb in [MENTAT_INSTALL_DIR]/menus/win64 after having created a backup
of the original file main.msb (e.g., main_orig.msb).
To launch computations set up using the plugin from within Marc Mentat, supersede the original executable
marc.exe (cf. section about launching Digimat-CAE/Marc computations via Marc Mentat here above).
I.5.4. Digimat-CAE/MSC Nastran SOL400
I.5.4
71
Digimat-CAE/MSC Nastran SOL400
The objective of this section is to explain how to install the interface between Digimat and MSC Nastran
SOL400.
Digimat and MSC Nastran SOL400 can be coupled together by the use of dynamic libraries. These libraries
contain Digimat capabilities, allowing to use Digimat materials in MSC Nastran SOL400 analyses. This link
is performed on both Linux and Windows operating systems. Dynamic libraries are distributed by MSC in
Nastran 2015.0.
For Digimat 6.0.1, the 2015.0 version of MSC Nastran software is supported (see appendix ?? for more
information).
Executing a job under Windows 64-bit using command line
MSC_INSTALL_DIR\MSC_Nastran\20150\bin\nast2015.exe nameOfInputDeck.bdf
where MSC_INSTALL_DIR is the installation directory of MSC Software.
Executing a job under Windows 64-bit using MSC Nastran configuration GUI
Launch MSC Nastran 2015. Then select the input deck to be used and click on Run. Note that, as Digimat
commands are not recognized by Patran, it is not possible to launch a coupled Digimat MSC Nastran SOL400
computation from Patran.
Executing a parallel job under Windows 64-bit
For Digimat 6.0.1, parallel processing is not stable and currently not recommended.
Executing a parallel job under Linux 64-bit
For Digimat 6.0.1, parallel processing is not stable and currently not recommended.
Licensing for Digimat-CAE/MSC Nastran SOL400 computations
As Digimat libraries are distributed by MSC, licensing works using MSC Nastran features. To be able to
launch Digimat to Nastran computations, the user needs to request NA_DIGIMAT and NA_DIGIMAT_DMP license
features to its local MSC distributor.
72
Installation
I.5.5
Digimat-CAE/SAMCEF
The objective of this section is to explain how to install the interface between Digimat and SAMCEF/Mecano
and SAMCEF/Dynam.
Digimat-CAE/SAMCEF is the module containing the Digimat capabilities and the required interfaces in order to
be linked with the SAMCEF/Mecano implicit solver and SAMCEF/Dynam modal solver. Linking is performed
in a static way. For more information on supported versions and platforms, please refer to the appendix ??.
The Digimat material library is embedded inside the SAMCEF/Mecano and SAMCEF/Dynam executables by
linking both the libraries together.
Prerequisites for the link between Digimat and SAMCEF
SAMCEF libraries
Official SAMCEF installation CD is shipped with the SAMCEF libraries that are necessary to use DigimatCAE/SAMCEF. As Digimat interacts with SAMCEF as a user material, the user has to install these user
material libraries.
Linker
To link Digimat and SAMCEF/Mecano and SAMCEF/Dynam libraries together, a linker is needed. Before
linking Digimat-CAE/SAMCEF, therefore the following software must be installed:
For Windows 64-bit platform:
See Section ?? on how to install this software
For Linux platform:
Need g++ the GNU c++ compiler, shipped with all Linux distributions.
Linking between Digimat and SAMCEF under Windows Platform
A link must be performed between SAMCEF and the Digimat material library. This link between Digimat and
SAMCEF libraries provides new SAMCEF/Mecano and SAMCEF/Dynam executables called my_mecano.exe
and my_dynam.exe.
To link the SAMCEF/Mecano and SAMCEF/Dynam executables with the Digimat libraries, the following
procedure is to be applied.
1. Copy the Lib directory found in the Muser directory of the SAMCEF installation
(e.g., C:\Program Files\Samtech\Samcef\Muser\Lib) in the digi2Samcef directory in the Digimat installation directory
(e.g., C:\DIGIMAT\Digimat2CAE\X.X.X\exec\digi2Samcef\v14.1-2).
2. Copy the files mecano.obj and dynam.obj from the Muser\Src directory of the SAMCEF installation
into the digi2Samcef directory.
3. Copy all .dll files from the Muser\Exe directory of the SAMCEF installation into the digi2Samcef
directory.
I.5.5. Digimat-CAE/SAMCEF
73
4. Open a VS2012 x64 Cross tools command prompt, move to the digi2Samcef directory and type
nmake my_mecano (respectively nmake my_dynam) to generate the new my_mecano.exe (respectively
my_dynam.exe) executable.
5. Add the following lines in the samrc.ini file found in the Exec directory of the SAMCEF installation
(adapt the Digimat install path, version, and SAMCEF version):
module*mm.me: my_mecano
C:\DIGIMAT\Digimat2CAE\X.X.X\exec\digi2Samcef\v14.1-2\my_Mecano.exe
module*md.dy: my_dynam
C:\DIGIMAT\Digimat2CAE\X.X.X\exec\digi2Samcef\v14.1-2\my_Dynam.exe
If the location of the executables my_mecano.exe and/or my_dynam.exe are changed, the digi2samcef.dll
file and the third-party components libraries digimathdf5_cppdll.dll, digimathdf5_hldll.dll, digimathdf5dll.dll,
digimatMathTools.dll, szip.dll, tinyxmlSTL.dll, zlib.dll must also move to this new location.
74
Installation
Linking between Digimat and SAMCEF under Linux Platform

A link must be performed between SAMCEF and the Digimat material library. This link between Digimat and
SAMCEF libraries provides two new SAMCEF executables called my_mecano and my_dynam.
1. Edit the makefile located in the /opt/Digimat/Digimat2CAE/X.X.X/exec/digi2samcef/vXX.X-X_iX
directory to point to the Samcef installation (e.g., /opt/samcef/v14.1-2/i8/.
2. Compile by typing make my_mecano and make my_dynam.
3. Add the following lines in the samrc.ini file found in the Exec directory of the SAMCEF installation
(adapt the Digimat install path, version, and SAMCEF version):
module*mm.me: my_mecano
/opt/Digimat/Digimat2CAE/X.X.X/exec/digi2samcef/v14.1-2_i8/my_mecano
module*md.dy: my_dynam
/opt/Digimat/Digimat2CAE/X.X.X/exec/digi2samcef/v14.1-2_i8/my_dynam
Launching Digimat-CAE/SAMCEF computations
To launch a SAMCEF/Mecano analysis, simply replace the usual me by mm in the command line, for instance
samcef ba,mm,bp analyis.dat n 1
To launch a SAMCEF/Dynam analysis, simply replace the usual dy by md in the command line, for instance
samcef ba,md,bp analyis.dat n 1
I.5.6. Digimat-CAE/LS-DYNA
I.5.6
75
Digimat-CAE/LS-DYNA
The objective of this section is to explain how to install the interface between Digimat and LS-DYNA.
Digimat-CAE/LS-DYNA is the module containing the Digimat capabilities and the required interfaces in order
to be linked with the LS-DYNA FE explicit and implicit solvers. Depending on the platform that is used,
linking is performed either in a dynamic or a static way. For more information on supported versions and
platforms, please refer to the appendix ??.
Linux platforms
Under Linux operating system Digimat-CAE/LS-DYNA is provided as a dynamic library. For Intel-MPI
computation, an additional link operation is needed.
Platform-MPI libraries
The dynamic Digimat-CAE/LS-DYNA libraries and associated LS-DYNA executables are called
For LS-DYNA 6.1.2:
For single precision: libmpp971_s_74965.81143_usermat.so and
ls-dyna_mpp_s_r6_1_2_85274_x64_redhat54_ifort120_sse2_platformmpi_sharelib
For double precision: libmpp971_d_74965.81143_usermat.so and
ls-dyna_mpp_d_r6_1_2_85274_x64_redhat54_ifort120_sse2_platformmpi_sharelib
For LS-DYNA 7.1.1:
For single precision: libmppdyna_s_86848.84183_usermat.so and
For double precision: libmppdyna_d_86848.84183_usermat.so and
Intel-MPI libraries
The additional link operation is described hereafter. For each version provided, the process to link the DigimatCAE/LS-DYNA executable is the same:
Make sure the GNU C++ g++ compiler is installed.
Get LS-DYNA libraries from your LS-DYNA distributor:
Copy all the .a and the .o files corresponding to the target version of Digimat-CAE/LS-DYNA in
the directory corresponding to this version in the Digimat installation tree.
Edit the makefile to make sure that the path to Intel-MPI library is correct.
Type make in a shell command.
An executable should be created in the directory, named mppdyna.exe.
76
Installation
Configure Digimat-CAE/LS-DYNA computations

The following operations have to be performed to be able to use the shared Digimat-CAE/LS-DYNA library
on Linux cluster:
For all versions
The Digimat-CAE/LS-DYNA shared library is compiled using Intel C++ Compiler V13. Therefore,
it is linked to Intel system libraries.
These libraries are shipped with Digimat. They are found in the installation folder, e.g.,
Digimat/Digimat/X.X.X/lib/
Needed to:
Update the LD_LIBRARY_PATH environment variable so that latter folder is the first listed in
this variable, i.e.,
export LD_LIBRARY_PATH=/opt/Digimat/Digimat/X.X.X/lib/:$LD_LIBRARY_PATH
If using INTEL-MPI, make sure that no Intel libraries are next to the Digimat-CAE/LS-DYNA
library, i.e., keep it in the Digimat installation folder.
Check that the right libraries are used in the environment used to launch the job. Replace mpirun
by ldd and check that all Intel Libraries come from the Digimat installation:
$ export LD_LIBRARY_PATH=/opt/Digimat/Digimat/X.X.X/lib/:
/opt/Digimat/Digimat2CAE/X.X.X/exec/digi2dyna/V612/Single/INTELMPI
$ ldd mppdyna
linux-vdso.so.1 => (0x00007fffd93ff000)
libmpigf.so.4 => /opt/intel/impi/4.1.3/lib64/libmpigf.so.4
(0x00002b808e9e6000)
libmpi.so.4 => /opt/intel/impi/4.1.3/lib64/libmpi.so.4 (0x00002b808ec17000)
libdl.so.2 => /lib64/libdl.so.2 (0x0000003c6bc00000)
librt.so.1 => /lib64/librt.so.1 (0x0000003c6c800000)
libpthread.so.0 => /lib64/libpthread.so.0 (0x0000003c6c000000)
libdigi2dynaV612SingleINTELMPI.so =>
/opt/Digimat/Digimat2CAE/6.0.1/exec/digi2dyna/V612/Single/INTELMPI/
libdigi2dynaV612SingleINTELMPI.so (0x00002b808f29c000)
libdigimathdf5_hl_cpp.so.7.3.0 => /opt/Digimat/Digimat/6.0.1/lib/
libdigimathdf5_hl_cpp.so.7.3.0 (0x00002b808fc10000)
libdigimathdf5_hl.so.7.3.0 => /opt/Digimat/Digimat/6.0.1/lib/
libdigimathdf5_hl.so.7.3.0 (0x00002b808fd13000)
libdigimathdf5_cpp.so.7.3.0 => /opt/Digimat/Digimat/6.0.1/lib/
libdigimathdf5_cpp.so.7.3.0 (0x00002b808fe41000)
libdigimathdf5.so.7.3.0 => /opt/Digimat/Digimat/6.0.1/lib/
libdigimathdf5.so.7.3.0 (0x00002b808ffb3000)
libcryptopp.so =>
/opt/Digimat/Digimat/6.0.1/lib/libcryptopp.so (0x00002b809035a000)
libdigimatMathTools.so => /opt/Digimat/Digimat/6.0.1/lib/
libdigimatMathTools.so (0x00002b80907a9000)
libtinyxmlSTL.so =>
/opt/Digimat/Digimat/6.0.1/lib/libtinyxmlSTL.so (0x00002b80909bb000)
libsvml.so => /opt/Digimat/Digimat/6.0.1/lib/libsvml.so (0x00002b8090ad6000)
I.5.6. Digimat-CAE/LS-DYNA
77
libifport.so.5 =>
/opt/Digimat/Digimat/6.0.1/lib/libifport.so.5 (0x00002b80913a4000)
libifcore.so.5 =>
/opt/Digimat/Digimat/6.0.1/lib/libifcore.so.5 (0x00002b80915d3000)
libimf.so => /opt/Digimat/Digimat/6.0.1/lib/libimf.so (0x00002b809190a000)
libirc.so => /opt/Digimat/Digimat/6.0.1/lib/libirc.so (0x00002b8091dc6000)
libintlc.so.5 =>
/opt/Digimat/Digimat/6.0.1/lib/libintlc.so.5 (0x00002b8092014000)
libstdc++.so.6 => /usr/lib64/libstdc++.so.6 (0x0000003c72800000)
libm.so.6 => /lib64/libm.so.6 (0x0000003c6b800000)
libgcc_s.so.1 => /lib64/libgcc_s.so.1 (0x0000003c71c00000)
libc.so.6 => /lib64/libc.so.6 (0x0000003c6b400000)
/lib64/ld-linux-x86-64.so.2 (0x0000003c6b000000)
If in the results of the latter command some Intel libraries are found somewhere else than in the
Digimat installation, it is likely that the following error message will appear:
symbol lookup error: undefined symbol: __intel_sse2_strcpy
This is because the function is defined in the new Intel libraries (shipped with Digimat) but not in
the older one that may exist on the Linux machine.
Launching Digimat-CAE/LS-DYNA under Linux
To launch a Linux job of Digimat-CAE/LS-DYNA, the very same procedure as to launch a LS-DYNA standalone
job can be followed. The only differences are:
Use the correct version of LS-DYNA, i.e., the one that looks for a user material library
Make sure that this executable sees the right LD_LIBRARY_PATH environment variable, i.e., the one
pointing to Intel libraries shipped with Digimat, and to the right Digimat-CAE/LS-DYNA library:
libmpp971_X_XXXXX.XXXXX_usermat.so for Platform-MPI
libdigi2dynaVXXXDoubleINTELMPI.so for Intel-MPI
If running across multiple nodes, it is recommended to define a bash script containing:
#!/bin/bash
export LD_LIBRARY_PATH=.../Digimat/X.X.X/lib:.../Digimat2CAE\
/X.X.X/exec/digi2dyna/.../:$LD_LIBRARY_PATH
path_to_the_right_mpp_executable $@
exit $?
make it executable:
chmod a+x launch_script.sh
and call this script rather than the LS-DYNA executable, with the very same arguments, i.e.,
mpirun -np 4 path_to_my_launch_script.sh i=input.k
Windows platform
Under Windows operating system a static linking procedure must be followed.

For each version provided, the process to link the Digimat-CAE/LS-DYNA executable is the same:
Make sure Microsoft Visual Studio Express 2012 for Windows Desktop is installed (See Section ?? on
how to install this software)
Get LS-DYNA libraries from your LS-DYNA distributor:
Digimat does NOT support ANSYS licensing. So, the libdyna.lib to request and use for
compilation must correspond to LS-DYNA licensing only. It is a different file than the one provided
along with libansys.lib.
78
Installation
Double-click on the nmake_x64.bat.

An executable should be created in the directory, named mpp971.exe, mpp971d.exe depending on the
version (single or double precision).
If the executable is not created, check the following:
The path to the installation of Microsoft Visual Studio Express 2012 for Windows Desktop in the
.bat script if Visual Studio 2012 has not been installed in the default directory.
The lstc_client.exe executable next to the Digimat-CAE/LS-DYNA one is needed. It can be found in
LS-DYNA installation.
Please notice that LS-DYNA libraries (libdyna.lib) are NOT provided together with the Digimat software.
LS-DYNA distributor can be contacted to get access to the library files required for the linking procedure. For
detailed information on supported versions and platforms, please refer to the appendix ??.
Prerequisites for the link between Digimat and LS-DYNA
To link Digimat and LS-DYNA libraries together on Windows platforms, a linker is needed. Before linking
Digimat-CAE/LS-DYNA, therefore the following software must be installed:
For all Windows platforms:
See Section ?? on how to install this software
For parallel computations on Windows 64 bits platforms
Microsoft HPC Pack 2008 (needed for MS-MPI versions)
An installer can be downloaded at Microsoft home page
Platform MPI (needed for PC-MPI versions)
An installer can be downloaded at IBM home page
Licensing for parallel Digimat-CAE/LS-DYNA computations
In order to run on n cores an application using Digimat-CAE/LS-DYNA interface, one license for the DigimatCAE/LS-DYNA interface is needed, as well as n-1 Digimat parallel tokens.
If the job also involves, for example, the Digimat-CAE/Moldflow interface, only one license of that additional
interface will be required.
I.5.7. Digimat-CAE/MSC Nastran SOL700
I.5.7
79
Digimat-CAE/MSC Nastran SOL700
SOL700.
Digimat and MSC Nastran SOL700 can be coupled together by the use of dynamic libraries. These libraries
contain Digimat capabilities, allowing to use Digimat materials in MSC Nastran SOL700 analyses. This link
is performed on both Linux and Windows operating systems. Dynamic libraries are distributed by MSC in
Nastran 2015.0.
information).
Executing a job under Windows 64-bit using command line
MSC_INSTALL_DIR\MSC_Nastran\20150\bin\nast2015.exe nameOfInputDeck.dat
where MSC_INSTALL_DIR is the installation directory of MSC Software.
Executing a job under Windows 64-bit using MSC Nastran configuration GUI
Launch MSC Nastran 2015. Then select the input deck to be used and click on Run. Note that, as Digimat
commands are not recognized by Patran, it is not possible to launch a coupled Digimat MSC Nastran SOL700
computation from Patran.
Licensing for Digimat-CAE/MSC Nastran SOL700 computations
As Digimat libraries are distributed by MSC, licensing works using MSC Nastran features. To be able to
launch Digimat to Nastran computations, the user needs to request NA_DIGIMAT and NA_DIGIMAT_DMP license
features to its local MSC distributor.
80
Installation
I.5.8
Digimat-CAE/PAM-CRASH
The objective of this section is to explain how to install the interface between Digimat and PAM-CRASH.
Digimat-CAE/PAM-CRASH is the material library containing the Digimat linear and nonlinear multi-scale
material modeling capabilities:
libcsm_user.dll
libcsm_user.so
(under the Windows operating system)

(under Linux operating system)
Digimat-CAE/PAM-CRASH is the module containing the Digimat capabilities and the required interfaces in
order to be linked with the PAM-CRASH explicit solver. Linking in general is performed either in a dynamic
or a static way. For more information on supported versions and platforms, please refer to the appendix ??.
Dynamic libraries
For Digimat 6.0.1, a set of dynamic libraries is provided for the Digimat-CAE/PAM-CRASH interface, both
for single and double precision. The installation procedure for the dynamic library is straightforward. While
installing Digimat to PAM-CRASH, it installs the necessary libraries, including
libcsm_user.dll
that will be loaded by the explicit solver (psolid.exe) at runtime. The library libcsm_user.dll contains
definition of all possible user defined subroutines. This will allow the user to use all linear and nonlinear smallstrain material models capabilities available in Digimat for small-strain analyses. Defining Digimat material
model in PAM-CRASH then is just like defining any other PAM-CRASH material model.
To run coupled Digimat to PAM-CRASH computations in command line, it is advised to write a .bat file
containing all the information needed by PAM-CRASH to allow the call to user subroutine. An example of
such launch script is given below to run PAM-CRASH with double precision.
1.
2.
3.
4.
5.
@echo off
set PATH=C:\DIGIMAT\Digimat2CAE\X.X.X\exec\digi2Pamcrash\2013.0\Double;%PATH%
set OMP_NUM_THREADS=1
set PYTHONHOME=C:\Program Files (x86)\ESI Group\Virtual-Performance\2013.0
\Solver-64Bit\Python\win
6. set PAMSHARE=C:\DIGIMAT\Digimat2CAE\X.X.X\exec\digi2Pamcrash\2013.0
\Double\libcsm_user.dll
7.
8. "C:\Program Files (x86)\ESI Group\Virtual-Performance\2013.0\Solver-64Bit\
pamcrash.bat" -fp 2 test.pc > "test.out"
The first command suppress screen display of command. The second command add to PATH environment
variable the path to Digimat library digi2pam2013.0Double.dll and Digimat third-party libraries. The
third command specify the number of processors to be used (under Windows64, only 1 CPU can be used).
The fourth command is needed by PAM-CRASH 2013 to find Python executable. The fifth command gives to
I.5.8. Digimat-CAE/PAM-CRASH
81
PAM-CRASH the path to the libcsm_user.dll file. The last command is the command to run PAM-CRASH
analysis, the -fp 2 option sets the precision to double precision. The command sends the output to the .out
file. If error is encountered in Digimat, it will be written in this file. More complex running script can be found
in Digimat install directory (in C:\DIGIMAT\Digimat\X.X.X\manual\files\Digimat-CAE). The header of
this file must be read carefully before using this launching script.
Launching Digimat-CAE/PAM-CRASH computations on Linux platform
The Digimat-CAE/PAM-CRASH dynamic library libcsm_user.so under Linux can be used to run parallel
jobs. Currently only HP-MPI version of PAM-CRASH can be used with Digimat material library.
To define environment variables needed to run Digimat to PAM-CRASH coupled analysis, user can write a
launch script as the one described below:
#!/bin/bash
export
export
export
export
PAMSHARE=/opt/Digimat/Digimat2CAE/X.X.X/exec/digi2pamcrash/2013.0/Double
LD_LIBRARY_PATH=/opt/Digimat/Digimat2CAE/X.X.X/lib:$LD_LIBRARY_PATH
PAM_LMD_LICENSE_FILE=port@XXX.XXX.XXX.XXX
EXLM_LICENSE_FILE=port@XXX.XXX.XXX.XXX
export PAMROOT=/opt/pamcrash/2013.0
export PAMHOME=$PAMROOT
$PAMROOT/pamcrash_safe/2013.0/pamcrash -np 2 -fp 2 -lic CRASHSAF test.pc > test.out
The first command is the header to execute bash scripts. The second command defines the location of
the libcsm_user.so shared library. The third command add the path to Digimat third-party libraries to
LD_LIBRARY_PATHenvironment variable. The next two commands defines the path to Digimat and PAMCRASH licences (the XXX must be replaced by the adress of the license file or license server). The PAMROOT
gives the path to PAM-CRASH directory. The last command launch PAM-CRASH computation
82
Installation
I.5.9
Digimat and OptiStruct/RADIOSS bulk can be coupled together through the User utility interface of HyperMesh. For information about supported versions and platforms please refer to appendix ??.
After the installation of Digimat and HyperMesh, at the end of the file userpage.mac, the following command
lines must be added:
*createtext(5," ",0,0)
*createbutton(5,"About",0,1,10,GREEN,"About Digimat plugin for Altair HyperMesh",
"EvalTcl","aboutDigimat.tcl")
*createbutton(5,"Digimat Documentation",0,1,10,GREEN,"Open the Digimat
documentation","EvalTcl","openDigimatDoc.tcl")
*createbutton(5,"Add Digimat Material",0,1,10,GREEN,"Add a Digimat material to the
current model","EvalTcl","Digimat.tcl")
*createtext(5,"Digimat: ", 0,0)
The file userpage.mac is located in the directory:
installHMDir/12.0/hm/bin/win64
or
installHMDir/12.0/hm/bin/win32}
where "installHMDir" is the directory where Altair products are installed (e.g., C:\Program Files\Altair).
To be able to use Digimat to HyperMesh and OptiStruct interface, user has also to define the environment
variable TCL_INCLUDE. The environmental variables can be accessed by right-clicking "computer" and moving
to the "Properties" option. The "Advanced settings" will contain a choice to set "Environment variables...".
Please refer to Figures I.5.13 to I.5.15 for an example related to Winfows 7 operating system. This environment
variable must point to the location of Digimat to HyperMesh and OptiStruct libraries, e.g.,
C:\DIGIMAT\Digimat2CAE\X.X.X\exec\digi2HyperMesh;
C:\DIGIMAT\Digimat2CAE\X.X.X\exec\digi2OptiStruct
I.5.9. Digimat-CAE/Hypermesh and Digimat-CAE/RADIOSS Bulk
83
Figure I.5.13: Define the TCL_INCLUDE environmental variable under Windows 7 operating system - step 1.
Figure I.5.14: Define the TCL_INCLUDE environmental variable under Windows 7 operating system - steps 2 and 3.
84
Installation
Figure I.5.15: Define the TCL_INCLUDE environmental variable under Windows 7 operating system - step 4 and 5.
I.5.10. Digimat-CAE/RADIOSS Block 51
I.5.10
85
Digimat-CAE/RADIOSS Block 51
The objective of this section is to explain how to install the interface between Digimat and the RADIOSS
explicit solver.
Digimat-CAE/RADIOSS Block is the module containing the Digimat capabilities and the required interfaces in
order to be linked with the RADIOSS explicit solver of Altair/HyperMesh. For information about supported
versions and platforms please refer to appendix ??.
Dynamic libraries
Linking via dynamic libraries is not supported for the RADIOSS explicit solver. A static linking procedure is
required. It will create a new starter and engine executable for this solver. Please read on with the following
secvtion to get more information on the required procedure.
Static libraries
This section explains how to couple Digimat with RADIOSS explicit.

Prerequisites for the link between Digimat and RADIOSS
The following list details the files needed to link Digimat and RADIOSS. The listed files are those that are
NOT shipped with Digimat and that is provided by Altair distributor.
Windows 64 bits platforms
RADIOSS 12.0.222 SMP:
s_12.0.222_win64.a
e_12.0.222_win64.a
radflex_12_win64.exe
liblmx-altair.12.0.12.dll
hdf5_win64.lib
libcci_win64.lib
libfrm_win64.lib
szip_win64.lib
zlibstat_win64.lib
RADIOSS 12.0.222 HPMPI:
s_12.0.222_win64.a
e_12.0.222_win64_plmpi.a
libhpmpi64.lib
radflex_12_win64.exe
liblmx-altair.12.0.12.dll
hdf5_win64.lib
libcci_win64.lib
86
Installation
libfrm_win64.lib
szip_win64.lib
zlibstat_win64.lib
Linux 64 bits platforms
RADIOSS 12.0.222 HPMPI
s_12.0.222_linux64.a
e_12.0.222_linux64_plmpi.a
radflex_12_linux64
liblmx-altair.12.0.12.so
To link Digimat-CAE/RADIOSS Block executable on Windows platforms, follow the following procedure:
Make sure having installed Microsoft Visual Studio Express 2012 for Windows Desktop (See Section ??
on how to install this software)
Copy the required files listed above corresponding to the target version of Digimat-CAE/RADIOSS Block
in the directory corresponding to this version in the Digimat installation tree.
Double-click on the nmake_x64.bat (for Windows 64 bits platform) or nmake_x86.bat (for Windows
32 bits platform).
Starter.exe and Engine.exe should have been created in the directory.
If the executable is not created, check the following:
The path to the installation of Microsoft Visual Studio Express 2012 in the .bat script if Visual
Studio 2012 has not been installed in the default directory.
To link Digimat-CAE/RADIOSS Block executable on Linux platforms, follow the following procedure:
We use g++, the free C++ compiler, to link Digimat-CAE/RADIOSS Block, make sure it is available.
Copy the required files listed above corresponding to the target version of Digimat-CAE/RADIOSS Block
in the directory corresponding to this version in the Digimat installation tree.
In this directory, type make
STARTER and ENGINE executable should have been created in the directory.
Launching coupled Digimat-CAE/RADIOSS Block jobs for parallel computation under Windows
64-bit
The following files must be located in the working directory:
1. The file radflex_12_win64.exe must be located in the working directory.
2. The file liblmx-altair.12.0.12.dll needs to be added along with the radflex file inside the working
directory.
3. The digi2radioss.dll, digi2radiossMPP.dll, digimathdf5_cppdll.dll, digimathdf5_hldll.dll, digimathdf5dll.dll, digimatMathTools.dll, szip.dll, tinyxmlSTL.dll, zlib.dll and libiomp5md.dll files
need to be given in the directory where the Starter and Engine are located.
Parallel computations, involving the Digimat-CAE/RADIOSS Block interface, can be performed under Windows 64-bit using HP-MPI. The following is the command to launch Digimat-CAE/RADIOSS Block parallel
job on a single node.
For Starter
Starter.exe -i
{starter-input}_0000.rad -nspmd {number of CPU}
For RADIOSS Engine:

mpirun.exe -np {number of CPU} Engine.exe
-i {engine-input}_0001.rad
The argument {number of CPU} mentioned must be the same for Starter and Engine.
I.5.10. Digimat-CAE/RADIOSS Block 51
87
Launching coupled Digimat-CAE/RADIOSS Block jobs for parallel computation under Linux 64-bit
Before running job make sure to set the stack size to unlimited in the command shell, using the command
ulimit -s unlimited
The path to the libraries needed by Digimat-CAE/RADIOSS Block must be the first one in the LD_LIBRARY_PATH variable:
export LD_LIBRARY_PATH=
.../Digimat/Digimat2CAE/X.X.X/exec/digi2radioss/12.0.222/lib:
.../Digimat/Digimat2CAE/X.X.X/lib:$LD_LIBRARY_PATH
where the "..." must be completed by the Digimat installation path (e.g., /opt).
Parallel computations, the involving Digimat-CAE/RADIOSS Block interface, can be performed under Linux
64-bit using HP-MPI.
The following is the command to launch Digimat-CAE/RADIOSS Block parallel job on a single node.
For Starter
./STARTER -i
{starter-input}_0000.rad -nspmd {number of CPU}
For RADIOSS Engine:

mpirun -np {number of CPU} ./ENGINE -i {engine-input}_0001.rad
The argument {number of CPU} mentioned must be the same for Starter and Engine.
88
Installation
I.5.11
Digimat-CAE/MSC Nastran SOL1XX
SOL1XX.
Digimat and MSC Nastran SOL1XX can be coupled together without the need for installing anything in
particular on top of the classical MSC Nastran and Digimat installations.
information).
Executing a job
Once coupled with one or more Digimat materials, the modified Nastran input deck can be run with Nastran
under Windows 32-bit, Windows 64-bit or Linux 64-bit environments like any other input deck, without taking
any specific action. Please refer to the MSC Nastran documentation for more information.
For example, to execute a sequential job under Windows 64-bit using the command line, the user needs to
type:
MSC_INSTALL_DIR/MSC_Nastran/20140/bin/nast2014.exe modifiedInputDeck.bdf
where MSC_INSTALL_DIR is the installation directory of MSC Software and modifiedInputDeck.bdf is the
name of the Nastran input deck created by Digimat-RP after coupling the structural model with one or more
Digimat materials.
I.5.12. Digimat-CAE/nCode DesignLife
I.5.12
89
Digimat-CAE/nCode DesignLife
Within the Digimat installation, the dynamic library digi2ncode.dll is located in the directory
[INSTALL_DIR]/Digimat2CAE/X.X.X/exec/digi2ncode
where [INSTALL_DIR] is the Digimat installation directory.
Installing Digimat automatically creates and defines an environment variable DIGIMAT2NCODE_SHARED_LIBS.
This latter serves nCode DesignLife at communicating with the Digimat user material card when executing
coupled Digimat nCode DesignLife FEA.
Remark: When installing a new version of Digimat, it is recommended to update the following nCode variable:
(Tools -> Preferences) Libraries -> DTDigimat -> DigimatLibsFolder.
The path to the third-party libraries digimathdf5_cppdll.dll, digimathdf5_hldll.dll, digimathdf5dll.dll, digimatMathTools.dll, szip.dll, tinyxmlSTL.dll, zlib.dll is written in the PATH environment variables when installing
Digimat. If these libraries are moved to another directory, PATH variable has to be updated by adding the
location of this new directory.
Note:When Digimat is uninstalled, the information written in PATH variable are not deleted.
90
Installation
I.5.13
Digimat-CAE/VirtualLab
Within the Digimat installation, the dynamic library digi2virtuallab.dll is located in the directory
INSTALL_DIR/Digimat2CAE/X.X.X/exec/digi2virtuallab/V11.0
After having installed Virtual.Lab Durability, the connection to Digimat is not yet configured. The path to
the DLL file must be given to the Virtual.Lab Durability software. To activate the connection:
1. Open the dialog "Tools/options" (see Figure I.5.16).
2. Inside the dialog move to the "Durability" part and select the tab page "External Provider".
3. Press "Add ..."
4. Select the dll digi2virtuallab.dll file of Digimat installation (see Figure I.5.17). Note that the DLL file
can be located anywhere on the machine.
Upon application of this procedure, coupled Digimat to Virtual.Lab computations can be successfully executed.
Note that this procedure must be applied only the first time that LMS Virtual.Lab is configured with Digimat.
Figure I.5.16: Access to option dialog box in LMS Virtual.Lab.
I.5.13. Digimat-CAE/VirtualLab
Figure I.5.17: Selection of the digi2virtuallab.dll file in LMS Virtual.Lab.
91
Copyright 2015 MSC Software Belgium SA

All rights reserved
2015 MSC Software Belgium SA. All rights reserved.

The e-Xstream and eXdigimat logos, e-Xstream engineering, eX, eXdigimat and Digimat are trademarks or registered trademarks
of MSC Software Belgium SA. All other trademarks belong to their respective owners.
e-Xstream engineering is a division of MSC Software Belgium SA.
The material modeling company
www.e-Xstream.com

Digimat INSTALL

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Digimat INSTALL

Uploaded by

Copyright:

Available Formats

INSTALLATION

Release 6.0.1 May 2015

The material modeling company

Installation of Digimat software

Digimat licensing management

Installation of Digimat software

Digimat installation - quick & easy . . . . .

Digimat installation - quick & easy

I.1.1. Digimat installation - quick & easy

Install license server

Select & install products

Test basic installation

3rd party prerequisites

If coupling to CAE codes

Test CAE coupling

Only required if coupling to

Linking Digimat to CAE

Use a model from the examples

Use a model from the examples

I.1.2. Installation of Digimat on a local computer

Installation of Digimat on a local computer

Workflow & details

1. Installation of the FlexLM license server

Step-by-step: FlexLM license server

I.1.3. Step-by-step: FlexLM license server

I.1.3. Step-by-step: FlexLM license server

To ensure that the license server is running, you should:

I.1.4. Step-by-step: Digimat software

Step-by-step: Digimat software

I.1.4. Step-by-step: Digimat software

I.1.4. Step-by-step: Digimat software

I.1.4. Step-by-step: Digimat software

I.1.4. Step-by-step: Digimat software

I.1.4. Step-by-step: Digimat software

I.1.4. Step-by-step: Digimat software

Figure I.1.30: The installation of the Digimat core software is executed.

I.1.4. Step-by-step: Digimat software

I.1.4. Step-by-step: Digimat software

I.2.1. Licensing system

Floating licenses and redundant license servers

Digimat via FlexLM licensing

Digimat licenses usage depends on the features considered.

I.2.2. Digimat via FlexLM licensing

To encrypt files, a DIGIMAT_MX+ feature is required.

Set-up of the licensing system

Manual start of the license server

I.2.4. Configuration of the licensing system

Configuration of the licensing system

Digimat licensing management

The DIGIMAT_Settings.ini file . . . .

The DIGIMAT_Settings.ini file

Figure I.4.1: Definition of Digimat settings.

I.4.2. Structure of the DIGIMAT_Settings.ini file

Structure of the DIGIMAT_Settings.ini file

ABAQUS_Directory: path to the Abaqus root directory.

in the .log file of the analysis/job if using Digimat-MF or a Digimat-CAE interface;

I.4.2. Structure of the DIGIMAT_Settings.ini file

The listing order of the keywords does not matter.

I.4.3. Digimat environment variables

Digimat environment variables

Figure I.4.2: Definition of Digimat environment variables

The defined system environment variables are the following ones:

Digimat-CAE/MSC Nastran SOL1XX

For Linux platforms The abaqus_v6.env file, located in