Documente Academic
Documente Profesional
Documente Cultură
Japan Asia-Pacific
MSC Software Japan Ltd. MSC Software (S) Pte. Ltd.
Shinjuku First West 8F 100 Beach Road
23-7 Nishi Shinjuku #16-05 Shaw Tower
1-Chome, Shinjuku-Ku Singapore 189702
Tokyo 160-0023, JAPAN Telephone: 65-6272-0082
Telephone: (81) (3)-6911-1200 Email: APAC.Contact@mscsoftware.com
Email: MSCJ.Market@mscsoftware.com
Worldwide Web
www.mscsoftware.com
User Documentation: Copyright 2019 MSC Software Corporation. All Rights Reserved.
This document, and the software described in it, are furnished under license and may be used or copied only in accordance with the terms
of such license. Any reproduction or distribution of this document, in whole or in part, without the prior written authorization of MSC Software
Corporation is strictly prohibited.
MSC Software Corporation reserves the right to make changes in specifications and other information contained in this document without
prior notice. The concepts, methods, and examples presented in this document are for illustrative and educational purposes only and are
not intended to be exhaustive or to apply to any particular engineering problem or design. THIS DOCUMENT IS PROVIDED ON AN “AS-
IS” BASIS AND ALL EXPRESS AND IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED
WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, ARE DISCLAIMED, EXCEPT TO THE EXTENT
THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.
MSC Software logo, MSC, MSC Nastran, Adams, Dytran, Marc, Mentat, and Patran are trademarks or registered trademarks of
MSC Software Corporation or its subsidiaries in the United States and/or other countries.
NASTRAN is a registered trademark of NASA. Python is a trademark of the Python Software Foundation. Parasolid is a registered
trademark of Siemens Product Lifecycle Management Software, Inc. All other trademarks are the property of their respective owners.
This software may contain certain third-party software that is protected by copyright and licensed from MSC Software suppliers. Additional
terms and conditions and/or notices may apply for certain third party software. Such additional third party software terms and conditions
and/or notices may be set forth in documentation and/or at http://web.mscsoftware.com/thirdpartysoftware (or successor website designated
by MSC from time to time).
METIS is copyrighted by the regents of the University of Minnesota. MS MPI is developed by Microsoft Corporation. PCGLSS 8.0, Copyright
1992-2019 Computational Applications and System Integration Inc. All rights reserved. Portions of this software are owned by Siemens
Product Lifecycle Management Software, Inc. Copyright 2019.
Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in FAR 12.212 (Commercial Computer Software)
and DFARS 227.7202 (Commercial Computer Software and Commercial Computer Software Documentation), as applicable.
MA:V2019:Z:Z:Z:DC-OPS-PDF
Documentation Feedback
At MSC Software, we strive to produce the highest quality documentation and welcome your feedback.
If you have comments or suggestions about our documentation, write to us at: documentation-
feedback@mscsoftware.com.
Please include the following information with your feedback:
Document name
Release/Version number
Chapter/Section name
Topic title (for Online Help)
Brief description of the content (for example, incomplete/incorrect information, grammatical
errors, information that requires clarification or more details and so on).
Your suggestions for correcting/improving documentation
You may also provide your feedback about MSC Software documentation by taking a short 5-minute
survey at: http://msc-documentation.questionpro.com.
Note: The above mentioned e-mail address is only for providing documentation specific
feedback. If you have any technical problems, issues, or queries, please contact Technical
Support.
Contents
Installation and Operations Guide
Contents
SECTION 1: WINDOWS
Mentat Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
3 Windows Troubleshooting
SECTION 2: LINUX
PostScript. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Xdump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Edit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
System Shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Parallel Render . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
MPEG Playback. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Managing FLEXlm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
FLEXlm License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
FLEXlm License Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Machine hostid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
7 Linux Troubleshooting
SECTION 3: APPENDICES
7 Installation and Operations Guide
Introduction
This chapter describes the installation and usage of the Marc and Mentat programs on Microsoft Windows platforms
configured as shown in the following table:
Table 1-1 Requirements of Marc & Mentat
Operating System Windows 7, Windows 10, or Windows 2016 Server.
CPU X86-64
Graphics Card SVGA or better running in at least 16 bit (64k) color mode
Hard Drive Minimum:
950 MB Marc
800 MB Mentat
350 MB documentation
DVD Drive Required for media based installation. Not required for electronic download installation.
Ethernet Card An ethernet card is required. Also, Microsoft TCP/IP Service must be installed.
Mouse Three button mouse is recommended
Memory Minimum 8 GB
Recommended 16 GB
Fortran Compiler A Fortran compiler is necessary if user subroutines are to be used. For other cases, no compiler
is needed. The compiler needs to be compatible with the one used in the Marc build. For a
list of supported compilers, refer to the Marc and Mentat Release Guide.
The instructions provided in this chapter require a basic knowledge of the machine on which you are loading the Marc
products. No attempt is made to teach the use of Microsoft Windows commands.
This document contains a section containing details about the installation procedure, a section concerning the usage of the
Marc and Mentat programs and a section about the license management utility.
Troubleshooting related hints are provided in Chapter 3: Windows Troubleshooting.
Note: If you encounter a problem during installation, please contact the customer support staff at the nearest
MSC Software office.
Installation Prerequisites 12
Installation Prerequisites
Before installing the The product is available for download at the MSC Solutions Download Center available at
software https://mscsoftware.subscribenet.com
Select the product Marc and select the 2019 version on the next level. Download the installer
for your platform.
The FLEXlm security is installed separately. Select the product MSC Licensing FLEXlm and
the version 11.13 on the next level. Download the installer for your platform.
Decide where you want the product to be installed and where to perform the installation.
Marc requires approximately 950 Mbytes of permanent disk storage capacity.
Mentat requires approximately 800 Mbytes of permanent disk storage capacity.
Documentation, stored in the separate documentation directories doc and examples,
contains approximately 350 Mbytes of data.
It is preferred to first install security, then Marc and/or Mentat and finally the documentation.
Password protection The Marc and Mentat version you have received is protected against illegal usage by means of
Flexera Software’s FLEXlm licensing software. You cannot run the program directly after you
have installed the product from the installation media until you obtain a license file from MSC
Software Corporation.
Should I be Normally, there is no need to be logged in as Administrator. However, you will need
Administrator? administrator privileges since the system registry will be updated. Also, check that you have
read and write permissions to the installation directory.
Fortran compiler A Fortran compiler is necessary if user subroutines are to be used. For other cases, no compiler
is needed.
Note:
After you install the Fortran compiler, make sure that all users have their PATH and LIB
environment variable include the path to the Fortran compiler. Otherwise, using user
subroutines will not work properly.
See Chapter 3: Fortran files are not being compiled for important information regarding requirements
for the Intel Fortran compiler.
Computer Name Your machine must have a computer name (host name). If no computer name is known, supply
one by using the Control Panel\Network applet to set the “Computer Name”. You should also
make sure the “Host Name” specified in the DNS tab of Network\Protocols\TCP/IP Protocol
is the same as the “Computer Name”.
Previous Versions If you have previous versions of Marc and/or Mentat installed, you may want to adjust your
PATH environment variable to remove the reference to the previous version.
NVIDIA driver An NVIDIA driver is necessary if the GPGPU capability is to be used on Windows 64-bit
machines. For other cases, no special driver is needed. The driver needs to be compatible with
the one used in the Marc build; see Marc Volume A: Theory and User Information, Chapter 13
for the minimum driver version supported.
13 Marc and Mentat for Microsoft Windows Installation and Operations Guide
Supported Platforms
The supported Windows platforms are listed below:
Fortran
Type OS Hardware Version Default MPI
Windows (64-bit) Windows 7 Intel EM64T or AMD Opteron Intel Fortran 171 Intel MPI 2017.12
Windows 10
Windows 2016 Server
1
For user subroutines, Intel Fortran 17 and Microsoft Visual Studio 2015 are required.
2
MS-MPI is also supported.
Note: Installation of a Fortran compiler is only required if you need to run Marc with user
subroutines.
Installation Procedure 14
Installation Procedure
Step 1: Download FLEXlm from the Solutions Download
Security Center. Select the product MSC Licensing FLEXlm,
version 11.13.
Run the installation executable and follow the
installation instructions.
Default installation directory is
C:\MSC.Software\MSC.Licensing\
11.13
Obtain a license file from MSC Software. If a
nodelocked license is to be used, then obtain
FLEXlm hostid with
C:\MSC.Software\MSC.licensing\11.13\
lmtools
Select the System Settings tab and click on Save
HOSTID Info to a File.
Copy the license file to the proper location. The
standard location is
C:\MSC.Software\MSC.Licensing\11.13\
licenses\license.dat
Set the environment variable MSC_LICENSE_FILE
to point to the license file.
The license server must be running in order to run
Marc and Mentat.
Previous versions of Marc and Mentat will run with
the latest FLEXlm version, so it is safe to upgrade
previous installations of FLEXlm.
Step 2: Start the installation from the product media The first screen will prompt you to set the location
Install Marc obtained from the Solutions Download Center. where you want the products installed. This path is
and Mentat Choose Destination Location: the “parent” directory. It defaults to C:\Program
Files\MSC.Software\Marc\2019
Destination Folder:
The directories marc2019 and mentat2019 will be
C:\Program Files\MSC.Software\Marc\2019 created in the directory that you specify.
The default destination folder for Mentat is
C:\Program Files\MSC.Software\Marc\2019
15 Marc and Mentat for Microsoft Windows Installation and Operations Guide
Setup type You will then be presented with which product Select the Complete option to install both Marc and
options to install. Mentat.
Complete Select the Solver option to only install Marc, or select
Solver the Modeler option to only install Mentat.
Modeler
Program folder Select Program Folder: Select the folder that you wish to place the shortcut
Program Folder: to the Mentat startup script.
The default program folder name is MSC.Software.
MSC.Software
Specify license License: When you perform the Marc installation, it will ask
file for the location of a valid Marc license file.
C:\MSC Software\MSC.Licensing\11.6\license.dat
C:\MSC.Software\MSC.Licensing\11.13\
licenses\license.dat Specify the location of your license file.
Step 4: Run Mentat by either selecting the Mentat item Check the installation by running Mentat. You have
checking in the program folder that you chose, or run it three methods you can use to run Mentat. You may
from the MS-DOS Command Prompt. use either the Mentat icon which is created on the
First check that the variable desktop, the link in the MSC.Software\Marc 2019
MSC_LICENSE_FILE is set properly. Use an program group, or run it from an MS-DOS
MS-DOS Command Pompt window and type: Command Prompt window.
set msc_license_file You must first check that the environment variable
MSC_LICENSE_FILE is set properly to the full
If it is not correct, change it using the System pathname of your valid license file. If it is not, the
applet in the Control Panel. product will fail due to licensing.
Then run the program using: To run from the command prompt, cd to the
cd C:\Program \parent\mentat2019 directory, and enter the
Files\MSC.Software\marc command bin\mentat to start Mentat.
cd 2019\mentat2019 Check the Mentat program by running one of the
bin\mentat standard Marc demonstration examples as proof of a
successful installation. From the Help menu, select Run
Run a Demo problem by selecting the menu A Demo..., and then select the Thermal/Structural Contact
buttons: demo. It will run for 50 increments.
Help
Run A Demo...
Thermal/Structural Contact
To check that user subroutines are working by If you have a Fortran compiler, run a user subroutine
running one of the standard user subroutine example using:
demo problems: run_marc -j e2x4 -user u2x4
cd C:\Program Marc should give a Marc Exit number 3004.
Files\MSC.Software\marc
cd 2019\marc2019\demo\tools\
run_marc -j e2x4 -u u2x4
Step 5: If you will be using the Marc Parallel Network
for Network feature, you will need to setup MPI. This service is
Version only optionally installed on the system when you installed
Marc, however you will need to install it on the
remote machines. Follow the Marc Parallel Network
for Microsoft Windows (Parts 1 and 2) for important
information on installing and running jobs with the
network version.
17 Marc and Mentat for Microsoft Windows Installation and Operations Guide
Step 6: Start the installation from the product media To make optimal use of the documentation, it should
Installing the obtained from the Solutions Download Center. be installed on a computer where also Marc and
documentation Choose Destination Location: Mentat are available. This way, documents can be
accessed interactively from within Mentat, and Marc
Destination Folder: example problems can be run.
C:\Program Files\MSC.Software\ One can install the documentation either before or
Marc_Documentation\2019 after installing Marc and Mentat. The
documentation installer will check if there is a
corresponding Marc and Mentat version installed,
where the Marc and Mentat installer will check if
there is a corresponding documentation version
installed, so that they can be linked together.
The installer will prompt the user to set the location
where the documentation needs to be installed. This
defaults to:
C:\Program
Files\MSC.Software\Marc_Documentation
\2019
The user now has the option of installing the
documentation to any other location. The directories
doc and examples will be created in the directory
specified by the user.
Installation Information 18
Installation Information
License file Two lines of the file license.dat need to be modified
“SERVER” line which specifies the system hostname
“DAEMON” line which specifies the daemon name and the path to the daemon program
The content is typically something like
SERVER this_host 0022192361f 1700
DAEMON MSC /your_path/msc
The string “this_host” should be replaced by the hostname of the machine where the license server is
running.
The string “your_path” should be replaced by the full path to the program “msc”. If the default
location is used for the security installation it should be
DAEMON MSC C:\MSC.Software\MSC.Licensing11.13\msc
Specify license You will be prompted to specify the path to your license file. It will default to the current setting of
file MSC_LICENSE_FILE. If it is not set, then it will attempt to use the license file specified for FLEXlm
License Manager version 11.13. If you do not already have your license file, you may leave it blank,
however you must set the MSC_LICENSE_FILE variable before attempting to run any of the Marc
products.
Note: This is an important step. The installation will set the variable MSC_LICENSE_FILE to
the setting that you enter. Failing to set it to a valid license file will result in a licensing failure
and you will have to edit the environment variable setting by using the System applet in the
Control Panel.
File types The installation will associate the file types .mfd, .mud, t16, .t19 and .proc to Mentat if they are not
already associated. If they are, as it would be in the case that you have a previous Mentat installation,
you will be asked if you wish to overwrite them.
If you answer YES, then they are set to the current version and the PATH environment variable is
updated with the current version specified first.
If you answer NO, then they are not modified and the PATH environment variable is updated with
the current version specified last.
Complete the Select the Finish button in Setup.
installation You may want to check the contents against the list supplied in Appendix A of this document. Should
any subdirectory be missing, please contact MSC Software customer support for further details.
Starting the You must start the FLEXlm License Manager before attempting to run Marc or Mentat on the system
License that is assigned the license. To start the license manager, use the Start menu and select:
Manager Programs → MSC Software → MSC.Licensing 11.13 → FLEXlm Configuration Utility
Select the Config Services tab and verify that the settings are correct; i.e. the “License File” is set to the
proper license file. Then start the license manager from the Start/Stop/Reread tab by pressing the Start
Server button.
Note: If you already had the FLEXlm License Manager 11.13 installed, you should not need to
perform these steps.
You should specify the options “Use NT Services” and “Start Server at Power-Up” under the
Config Services tab. This will enable the license manager to start automatically at boot time.
Running Marc
This section describes the Marc usage on Microsoft Windows based machines. The Marc programs are mainly controlled
by a batch script program called run_marc.bat, which is stored in the parent subdirectory marc2019\tools.
The batch script will submit a job and must be executed in the directory where all relevant input and output files
concerning the job are available. To use the batch script, each Marc job should have a unique name qualifier and all Marc
output files connected to that job will use this same qualifier.
Running Marc 20
Marc input files should always be named job_name.dat, whereby the prefix job_name is the name qualifier which you
are free to choose. The suffix .dat is obligatory.
To actually submit a Marc job from an MS-DOS Command Prompt window, the following command should be used.
The single input line is split over multiple lines for clarity:
Running Mentat
This section describes the Mentat usage on Microsoft Windows machines. The Mentat program is started by a batch script
called mentat.bat which is stored in the parent\mentat2019\bin directory. It may also be started by using the Marc
Mentat 2019 menu item in the Start menu in the MSC.Software folder or by selecting the Marc Mentat 2019 icon that
the Setup program created on your desktop.
You need not start the batch script from a specific directory.
The Mentat program creates the default files in your current working directory; i.e. where you are located at the time of
starting the Mentat program (if run from the command line), or the Start in directory specified for the shortcut if
started from the Marc Mentat 2019 icon.
Note: Since Mentat is started by running a batch script, it is not possible to use a UNC path as the current working
directory. It is recommended to map a UNC path to a drive letter, otherwise Mentat would use %WINDIR%
(usually C:\Windows) as the current working directory.
The batch script mentat.bat contains a number of arguments which are passed on to the Mentat program. Table 1-4 gives
the meaning of these input options. You are free to alter these commands to suit your preference.
Mentat Interfaces
Jobs
The subdirectory bin contains batch script files to start a Marc job using the following batch scripts:
submit1.bat, submit2.bat, submit3.bat
These batch scripts are called by means of the buttons in the job menu. You may alter these files to suit your environment.
Plotter Interface
Because of the many variations in plotting environments, we have created plotting interfaces in the form of batch scripts
that operate from within Mentat. Currently, Mentat recognizes the following plotting formats:
PostScript
WinDump (translated into Windows bitmap (.BMP) format)
This section describes a template batch script for each of the formats mentioned above. They are located in the
mentat2019\bin directory and are named as follows:
pscolor1.bat, pscolor2.bat, pscolor3.bat
psgray1.bat, psgray2.bat, psgray3.bat
xdump1.bat, xdump2.bat, xdump3.bat
Managing FLEXlm 28
PostScript
PostScript
The PostScript function is activated by pressing the Gray or Color Print button from the UTILS menu on the POSTSCRIPT
panel. The program captures the graphics portion of the screen into a file and sends this file to a PostScript printer using
the psgray or pscolor batch scripts located in the mentat2019\bin directory. In the example listed below, the file is sent to the
printer LPT1. This can be a printer attached locally, or located somewhere on the network. After the file is sent, it is
removed from disk automatically.
print /D:LPT1: %1
del %1
The argument %1 is the filename handed to the batch script by Mentat. If there is more than one printer on-line, the
pscolor2.bat and pcolor3.bat batch scripts may be used to address these other printers.
You can use the setup_printer program to configure a network printer. Run setup_printer for more details.
Edit
The edit_window.bat batch script is used to control the editor associated with the EDIT commands. It is possible to change
the type of editor, for example, from notepad to emacs.
System Shell
The system_window.bat batch script is used to control the type of window opened with the system_shell command.
AVI Playback
The avi_window.bat batch script is used to control the program opened with the play_avi command.
MPEG Playback
The mpeg_window.bat batch script is used to control the program opened with the play_mpeg command.
Managing FLEXlm
Here “this_host” should be set to the hostname of the machine where the license server is running. “your_path” should be
set to the full path to the msc program, by default located in C:\MSC.Software\MSC.Licensing\11.13
Environment Variables
The environment variable MSC_LICENSE_FILE is used to specify the license.dat file. This environment variable
can be set using the System applet in the Control Panel, and is a semicolon separated list of file pathnames or hosts. The
default setting will be C:\MSC.Software\msc.licensing\11.13\license.dat. When Marc executes, it checks
the list of license files specified by this environment variable. You may have it point to a license server using the syntax
port@host, as follows:
Variable: MSC_LICENSE_FILE
Value: 10620@myserver
If you have other products that use FLEXlm and they are required to be available when Marc is running (such as a Fortran
compiler license), then you should modify the MSC_LICENSE_FILE setting to point to the proper license file for that
product.
You may instead want to combine the licenses into one file.
The environment variable MSC_AUTHQUE is used to specify the number of minutes a program will wait for a license
after it has been requested. If the license request cannot immediately be honored, the request will be queued and the variable
defines how long it should wait in this queue. The variable must be set in your environment before Marc and Mentat are
started. The default value is 5 minutes. It may be set as follows:
set MSC_AUTHQUE=20
Configuring the Marc DCOM Server 30
Client/Server Licensing
Client/Server Licensing
The default installation assumes that the system in which Marc is installed will function as the license server. The term license
server only refers to the fact that lmgrd and MSC will be running on that system, and will maintain the state of available
licenses. Even if you have purchased a nodelocked license, the nodelocked system will function as the license server for that
license. A nodelocked license can be distinguished from a floating license by the string HOSTID=xxx specified in the
feature line.
Figure 1-2 Dcomcnfg Displaying the Properties of the Marc DCOM Server
This is illustrated in Figure 1-2. The Local Path depends on the destination folder chosen during the installation procedure.
The only property that needs adjusting is the Identity property.
33 Marc and Mentat for Microsoft Windows Installation and Operations Guide
8. Select the Identity tab. Dcomcnfg will then display the identity view as shown in Figure 1-3.
Figure 1-3 Dcomcnfg Displaying the Identity Properties of the Marc DCOM Server
9. Select This user, and specify a user that has access rights to this machine.
10. Select Apply, and then OK to close the window.
11. Select OK in the main view.
The data files must be located in a shared directory. This is required so that the two machines can access the files. If the file
is not located in a shared directory, Marc will issue an error message specifying that the file is not located in a shared
directory.
To share a disk or a directory:
1. Select My Computer from the desktop and select the disk or browse to the directory.
2. Right click, and select Sharing to select the disk or the directory.
3. In the Sharing view, select the Share this folder button and enter a name for the share.
If it succeeds, then perform the same test on a client machine. If a failure occurs, see the section on the following page on
Troubleshooting. Again, make sure the data file resides in a shared directory. When running the job, you may also use the
UNC name in the path. If it is not specified, Marc will determine the UNC path and send it to the server.
Mentat Support
Running the job remotely may also be done within Mentat, however the menu is not displayed by default. You must first
rebuild the menu file using:
cd <parent>\mentat2019
bin\mentat -compile menus\win64\main.msb -df DCOM
In the Jobs Run Advanced Job Submission menu, there now is an option named DCOM as shown in Figure 1-4.
Select this DCOM option and in the adjacent text area specify the name of the remote machine.
Figure 1-4 Advanced Job Submission Menu Displaying the DCOM Option
Troubleshooting
In the case of an error, try some of the following suggestions:
Check that your user ID is valid on both the server and the client machines.
Check that the user ID has read and write access to the directory where the job is to be run.
Check that the directory that the data file resides in is a shared directory. Note that for Windows Server, you must
also specify the user permissions using the /GRANT option for the net share command or by clicking the
Permissions button under the Sharing tab in Explorer.
Run the run_marc script using the -it option to print out debugging information. This will print out exactly what
is being sent to the server:
<parent>\marc2019\tools\run_marc -pc <servername> -j e2x1 -it 0
35 Marc and Mentat for Microsoft Windows Installation and Operations Guide
The path name displayed in the debug output should be displayed as a proper UNC name. If not, verify that the
directory is shared.
Chapter 2: Marc Parallel Network for Microsoft Windows
Introduction
This chapter is divided into three parts:
Provides the general description about the hardware and software
Part 1: General Information
requirements and definitions.
Part 2: Installation Notes Provides a step-by-step approach to installation of the network version.
Provides miscellaneous information about executing a parallel job over a
Part 3: User Notes
network and use of user subroutines.
The list of supported capabilities in parallel can be found in “Supported and Unsupported Features” in Chapter 13 of Marc
Volume A, Theory and User Information.
The list of supported platforms can be found in the section “Supported Platforms” in Chapter 1 of this guide.
General Information
Note: When opening a Command Prompt window, always start the Command Prompt window by right clicking the
icon and selecting ‘Run as Administrator’.
Enter your account (use a network account if you intend to run DMP jobs) and the password at the command prompt.
account (domain\user) [<domain>\<username>]:
password:
confirm password:
The message “Password encrypted into the Registry” will show in the Command Prompt Window.
If you change your account and password, you will need to repeat this step.
Next, type:
.\hydra_service -install
To run DMP (network parallel jobs) using Intel MPI, create a host file using the following format:
host1 n1 workdir1
host2 n2 workdir2
General Information 38
Definitions
host3 n3 workdir3
Use the directory name (UNC) as echoed by typing net share on your system for workdir.
For example:
sv-x861 2
sv-x862 2 \\sv-x862\test2
The DMP job will run using two processors on node sv-x861 in the directory where the job is started and two processors
on node sv-x862 in the shared directory test2.
Please note that the test1 and test2 directories in nodes sv-x861 and sv-x862 as well as the marc2019 directory in node
sv-x861 will need to be shared with a general permission to all users.
The default MPI is Intel MPI 2017.1 for Windows. The other MPI option for the 64-bit Windows platform is MS-MPI.
To use MS-MPI, please install Microsoft MPI; the version is listed in the include_win64.bat file in the marc tools
directory.
Please turn off the Windows firewall in your cluster and share the marc directory with a general permission to all users.
Although no specific hardware requirements exist to run a job in parallel, it is preferable that for distributed parallel
processing to have fast network connections between the machines. It is recommended that the network should have a
speed of at least 100 MBit per second. If only two machines are to be used, a hub or a cross-over cable can be used to
connect them. If more than two machines are to be used, a switch is preferable. TCP/IP is used for communications. Refer
to the include_win64.bat file in the tools directory for requirements on O/S, compilers, etc. for more details regarding
running on Microsoft Windows.
Definitions
The definition of some of the terms are as follows:
Network Configuration
Marc only needs to be installed on the root machine where the installation directory is UNC shared (shared installation).
Marc can also be installed on the remote machines which then use their own executable (distributed installation). For this
case the same path name must be used on all machines. The root machine is the one on which the Marc job is started,
typically from within Mentat. The remote machines can be located anywhere as long as they are connected to the network.
The working directory on each machine can be a shared directory on any machine on the network (shared I/O) or it can
be a local directory on the hard disk of each machine in the analysis (distributed I/O). The User Notes describes how to
specify what working directory to use.
network
Installation Notes
This part describes the specific steps needed to install and set up a network version of Marc. For general information on
Marc installation, see Marc and Mentat for Microsoft Windows.
Steps 1–6: Must be performed as Administrator.
Step 1: Install Marc on the root machine.
Step 2: Make sure that the installation directory on the root machine is properly shared, so that the remote machines
can access it. Assuming that Marc is installed under C:\Program Files\MSC.Software, share this
directory by associating a UNC share name with it as follows. Use My Computer and locate the directory to be
shared. Right click on the directory and choose Sharing, Choose Share As and give it a Share Name (this is the
UNC name) and click OK.
Please note that Marc restricts the UNC name to have a maximum of 10 characters and the name of the shared
directory to have a maximum of 30 characters. If necessary, a directory higher up in the path can be shared (for
instance, C:\ instead of C:\Program Files\MSC.Software). It is sufficient that either C:\ or
C:\Program Files\MSC.Software is shared.
Step 3: On the remote machines you can perform a full Marc installation or an installation of the Intel MPI Library
Process Manager service only. In the latter case, the remote machine will be using the Marc installation of the
root machine via the UNC share name.
The Process Manager service must be installed and running on all hosts involved a distributed job across the
network. To install the Process Manager on a machine without a full Marc installation, copy the
hydra_service.exe program from the intelmpi\win64\bin directory (on the root machine) to a local
directory on the remote machine. Open a Command Prompt window on the remote machine, go into that
directory and execute:
.\hydra_service -install
Step 4: Create a Marc file with the shared naming information. From the Command Prompt, change directory to the
tools directory in the Marc installation directory (here assumed to be C:\Program Files\MSC.
Software).
C:
cd \Program Files\MSC.Software\Marc\2019\marc2019\tools
net share > marc.net
This file has to be recreated each time the shared name of the installation directory is changed. The file marc.net
contains the connection between the path names on the root machine and the UNC names, and can be created
only by the Administrator. If this file does not exist or contains outdated information, the remote machines will
not be able to find the executable on the root machine.
Step 5: Test the Marc installation for single processor execution by typing from the root machine:
C:
cd \Program Files\MSC.Software\Marc\2019\marc2019\test_ddm\exmpl2\exmpl2_1
run_marc -j cyl2
and Marc should exit in about three minutes if it is a successful run.
41 Marc Parallel Network for Microsoft Windows Installation and Operations Guide
Step 6: Test the Marc installation for multi-processor, distributed execution. Assume the host name of the root
machine is host1 and one of the remote machine is host2. Type from host1:
C:
cd \Program Files\MSC.Software\Marc\2019\marc2019\test_ddm\exmpl2\exmpl2_2
and edit the file hostfile in this directory by replacing workdir with
C:\Program Files\MSC.Software\Marc\2019\marc2019\test_ddm\exmpl2\exmpl2_2
The host names and directory names should be replaced with the names on the current system. Finally, type:
run_marc -j cyl2 -nprocd 2 -host hostfile
and Marc should exit in about two minutes if it is a successful parallel run on host1 and host2 using one processor
on each. If the job stalls or hangs at start-up time, exit it by typing control-C in the window in which is was
started. See User Notes in this section.
User Notes
This section assumes that the network version of Marc has been successfully installed on two machines that are to be used
in a distributed analysis and that the appropriate Marc licenses are in order. Assume that host1 is the host name of the
machine on which Mentat is running and from which the job is to be started (the root machine). The host name of the
other machine (the remote machine) is host2.
Note: The current version does not support the IPV6 protocol.
In order to perform an analysis over a network, a special file called a host file needs to be created by the user. This file defines
which machines are to be used, how many processes are to run on each, what working directory should be used, and where
the Marc executable can be found on each machine. The host file can be selected and edited in Mentat and the Marc job
started as usual from within Mentat (see the example below). If Marc is run from the command line, it is done as for a
normal run using an additional command line option. For example:
run_marc -b no -jid test -nprocd 2 -host hostfile1
will run the two-processor job test.dat using the specification in the file hostfile1. No specific name or extension is
used for the host file except that the name jobid.host (in this example test.host) must be avoided since it is used
internally by Marc.
User Notes 42
Specification of the Host File
Shared I/O
Suppose a job is to be run on host1 and host2. A shared directory on host1 is to be used for I/O. The UNC sharename for
this directory is assumed to be dir7. The host file for a two-processor job would simply be
host1 1
host2 1 \\host1\dir7
To verify that the work directory is accessible, use Internet Explorer on host2 and browse to host1->dir7. The directory
seen should be the same one as the working directory on host1.
It is also possible to use only two entries for each host in the host file (host name and number of processes). This requires
that the working directory is shared and that the sharing information is up to date in the file tools\marc.net in the
Marc installation directory.
Distributed I/O
If the user wants to have the I/O to be local on host2, specify the host file as
host1 1
host2 1 D:\users\dir5
43 Marc Parallel Network for Microsoft Windows Installation and Operations Guide
The I/O on host2 will now take place in the directory D:\users\dir5 on the hard disk of host2. For this case, the Marc
input files are transferred to D:\users\dir5 on host2 before the job is started, and the results files are transferred back
after the analysis for postprocessing. This transfer of files is done by Marc automatically.
Example
The definitions for a network run with Mentat is demonstrated with a simple example. We assume the simplest case where
both the working directory and installation directories are shared.
User Notes 44
Distributed I/O
Step 1
Enter the menu Help Run a Demo... and select the example Contact With DDM. Select and confirm your two domains
as shown in the image as follows:
.
Step 2
Check the Use DDM option and enter the Network submenu.
45 Marc Parallel Network for Microsoft Windows Installation and Operations Guide
Select Network
Click on the Host File button and select the file called my_host_file and modify it to contain:
host1 1
host2 1 \\host1\...
Set the working directory according to the share names on the current system. The host file places one domain on host1
and one domain on host2.
User Notes 46
Distributed I/O
Run Marc from within Mentat using the Submit 1 button. Upon completion of the analysis, the following dialog box
appears:
47 Marc Parallel Network for Microsoft Windows Installation and Operations Guide
Step 3
Check your results. This can easily be done by clicking the Open Post File (Results Menu) button. A plot of the Total
Equivalent Plastic Strain in the final deformed configuration is shown as follows:
Marc creates a post file associated with each domain as well as a root post file associated with the job id. For the previous
model, 1model1_job1.t16 and 2model1_job1.t16 are the processor files, while model1_job1.t16 is the root file.
To post process the entire model, select model1_job1.t16 as the post process file. If the model is very large, it may be
convenient to view only a portion of the model by selecting any one of the processor post files, such as
2model1_job1.t16. This file contains only data associated with domain 2as selected in the Domain Decomposition
menu. As specified in the host file, this file was created by host2.
Troubleshooting
General
Make sure that:
1. The user ID that was registered using the mpiexec.exe utility exists on the root machine and all remote machines
(see General Information). Also check that the password you entered is the same on all machines.
Note that if you change your login password, you must register it again using mpiexec.exe
2. The remote machines have permission to read from the Marc installation on the root machine via the UNC
sharename. For shared I/O, the remote machines also must have permission to read from and write to the shared
(working) directory on the root host.
3. Your Marc and Marc Parallel licenses are valid.
4. The host names are valid.
5. The Intel Process Manager service is installed and running on all hosts involved in the distributed job across the
network. Select Start/Control Panel/Administrative Tools/Services and look for Intel MPI® Library Process
Manager, Intel. Make sure that it is as Status:Started.
The typical error message that appears if the Process Manager service is not running on or more hosts is:
abort: Unable to connect to 'hostname:8676'
sock error: generic socket failure, error stack:
...
Please refer to Step 3 of the installation instructions (Installation Notes) on how to install the Process Manager on
machines without a full Marc installation.
Note: These settings are important to enable Microsoft Windows to run a parallel job. If they are not set properly, the
error message "Host is unreachable (5)" or "Access is Denied (5)" will be issued.
Required Privileges
Running a parallel job either locally or over a network requires certain user privileges. If the privileges are not sufficient,
MPI will print an error code of 1314.
You will need to check the following settings from the Control Panel:
1. Select Administrative Tools
2. Select Local Security Policy
3. Check the following items under Local Policies → User Rights Assignment.
Windows
"Adjust memory quotas for a process"
"Replace a process level token"
You can add user names to these if needed by right clicking them and going to Properties.
Note: The setting on the domain controller will also need to provide access to these settings for
each user name, if the users login through a domain controller.
Chapter 3: Windows Troubleshooting
3 Windows Troubleshooting
52
Access is denied This type of problem is caused by not having write permissions to the file or directories to which
you are installing.
To correct this problem, open up an MS-DOS Command Prompt window, cd to the directory in
which you are installing Marc, and run the attrib program to remove the read-only attributes (with
the -R option).
You may also use the File Manager’s Security menu to change Ownership of files and directories,
and to change Permissions on them.
Error during move This problem is caused by having an application or a file open during the installation process that
process the installation is trying to overwrite. Exit all applications and documents during installation and
restart the installation.
Security failed • The environment settings are not set properly. If you have not already logged out and logged
or Marc exit 67 back in again, do so now and try again. Check that the environment variable
MSC_LICENSE_FILE is set to a valid license file. If you have not installed your passwords yet,
then you must do so before security will succeed.
• Check that the FLEXlm license manager has been started from the FLEXlm Configuration
Utility applet in the Start menu under MSC.Software → MSC.Licensing 11.13. This must be
done AFTER you have saved your license.dat file in the
MSC.Software\MSC.licensing\11.13 directory. Test that it is working by pressing the
Status button in the Control menu.
• You are attempting to run on a machine that according to the Marc password(s) you are not
allowed to use.
• Your license period has expired. Check the date on your machine.
• Cannot access or read the file license.dat in the MSC.Software\MSC.licensing\11.13
subdirectory.
• Every Marc user should have read and write rights for the parent subdirectory 11.13.
License Manager • If the license manager won’t start, check that the hostname on the SERVER line is correct. Also
will not start check that the DAEMON line contains the correct path to the license daemon MSC.exe.
• If you had an older version of the FLEXlm license manager installed, the new installation may
replace it. If the Use NT Services button was previously checked, you should uncheck this
button, start the license manager, and then select the Use NT Services button.
Link failed • Your user subroutine causes compiler errors.
• You have no Fortran compiler or Fortran libraries not available.
• Your PATH or LIB environment variables settings do not point to the proper location for your
Fortran compiler.
53 Marc and Mentat for Microsoft Windows Installation and Operations Guide
Fortran files are • The Fortran compiler is not in your search path, or the INCLUDE and LIB environment
not being variables are not set. You can verify that your settings are correct with the set command. Run the
compiled following scripts to set it up:
Installation Prerequisites
Before The product is available for download at the MSC Solutions Download Center available at
installing the https://mscsoftware.subscribenet.com
software
Select the product Marc and select the 2019 version on the next level. Download the installer for
your platform.
The FLEXlm security is installed separately. Select the product MSC Licensing and the version
11.13 on the next level. Download the installer for your platform.
Decide where you want the product to be installed and where to perform the installation.
Marc requires approximately 1.1 GB of permanent disk storage capacity.
Mentat requires approximately 1.3 GB of permanent disk storage capacity. Documentation, stored
in the separate documentation directories doc and examples, contains approximately 350 MB of
data.
First install security. If you are installing both Marc and Mentat, then first install Marc and then
install Mentat.
Password The Marc and Mentat version you have received is protected against illegal usage by means of Flexera
protection Software’s FLEXlm licensing software. You cannot run the program directly after you have installed
the product from the installation media until you obtain a license file from MSC Software
Corporation.
Multiple If you are installing Marc and/or Mentat on an NFS Fileserver, the install script needs to create
machines/NFS directories in which to install Marc and/or Mentat; the default NFS export options do not allow this
Fileserver level of access by root. Two approaches are possible – do not install as root, or if you must install as
root, modify your NFS export options to include ~root=list (where list can include hostnames and
netgroups).
Should I be You may need to be logged in as root if you want to create an optional link by which Marc and/or
“root”? Mentat will be known system-wide under the name marc2019 and/or mentat2019. This link will, by
default, be placed in the directory /usr/local/bin to which you must have write permission.
Logging in as root is one way of ensuring that you can create this link. Make sure that you have
write permission to the installation directory before you start the installation script.
For NFS fileserver networks, read the previous paragraph.
Fortran A Fortran compiler is necessary if user subroutines are to be used. For other cases, no compiler is
compiler needed. The compiler needs to be compatible with the one used in the Marc build, see the Marc and
Mentat Release Guide for a list of supported compilers.
NVIDIA driver An NVIDIA driver is necessary if the GPGPU capability is to be used. For other cases, no special
driver is needed. The NVIDIA driver needs to be compatible with the one used in the Marc build;
see Marc Volume A: Theory and User Information, Chapter 13 for the minimum driver version
supported.
Supported Platforms 58
Supported Platforms
The supported Linux platforms are listed below. Note that the installation of a Fortran compiler is only required if you
would like to run Marc with user subroutines.
Fortran
Type OS Hardware Version Default MPI
Linux (64 bit) Red Hat RHEL7.11 Intel EM64T or AMD Opteron Intel Fortran 173 Intel MPI 2017.14
SUSE 11 SP42 Intel EM64T or AMD Opteron Intel Fortran 17 Intel MPI 2017.1
1 Also runs on RHEL 7.3.
2
Also runs on SUSE 12 SP1 and RHEL 6.7.
3
For user subroutines, Intel Fortran 17 is required.
4 IBM Platform MPI (community edition) is also supported. In the documentation and the scripts, this is referred to
as hpmpi.
Installation Procedure
Step 1: chmod +x msc_licensing_11.13_<platform>.bin Download FLEXlm from the Solutions
Security ./msc_licensing_11.13_<platform>.bin Download Center. Select the product MSC
Licensing, version 11.13.
For nodelocked license, run
Run the installation executable. It may be
/msc/MSC.Licensing/11.13/bin/lmhostid
necessary to give execution permission
(chmod +x) to the downloaded file. Follow
cp license.dat the installation instructions.
/msc/MSC.Licensing/11.13/licenses/license.dat Default installation directory is
For csh and similar: /msc/MSC.Licensing/11.13
setenv MSC_LICENSE_FILE Obtain a license file from MSC Software. If
/msc/MSC.Licensing/11.13/licenses/license.dat a nodelocked license is to be used, then
For Bourne shell and similar obtain FLEXlm hostid with
MSC_LICENSE_FILE=/msc/MSC.Licensing/ /msc/MSC.Licensing/11.13/bin/lmhostid
11.13/licenses/license.dat
export MSC_LICENSE_FILE Copy the license file to the proper location.
Edit license.dat to set SERVER and DAEMON (see Standard location is
chapter 3 below for details). /msc/MSC.Licensing/11.13/licenses/
license.dat
Start the license server:
Set the environment variable
/msc/MSC.Licensing/11.13/bin/lmgrd -c
MSC_LICENSE_FILE to point to the
/msc/MSC.Licensing/11.13/licenses/license.dat -l
license file.
/msc/MSC.Licensing/11.13/lmgrd.log
The license server must be running in order
to run marc and Mentat.
59 Marc and Mentat for Linux Installation and Operations Guide
Set the default The current default MARC_MPI is set to intelmpi The script will ask about changing the
MPI Do you want to change it to hpmpi [y/N]? default MPI from its current setting to
another MPI if supported on the installed
platform. Supported MPI versions are
IBM Platform MPI* and Intel MPI. The
setting is stored in the file
run_marc_defaults in the
marc2019/tools directory.
*In the documentation and the scripts, this
is labeled as hpmpi.
r) Return to the previous menu Choose the Return to previous menu option to
return to the main menu.
Mentat Installation Select option 2 from the main menu to
Mentat 2019 Menu install Mentat.
l1) Install for Linux 64-bit RHEL 7.1/7.3 Select the platform that you will be running
(~1.3 GB) Mentat on. The script will show the
platform for which you have downloaded
the version and if this is compatible with
your system, it is shown as a default value in
brackets after the Selection prompt. Just
press Return/Enter to use the default value,
otherwise enter l1 to install the
Red Hat 7.1/7.3 version and l2 to install the
SUSE 11SP4/12SP1 / Red Hat 6.7 version.
You will be prompted to supply the
pathname to the directory where Marc is
installed. If the script determines that Marc
is already installed to the default location of
<parent>/marc2019, then a default
value for the path is displayed. Press
Return/Enter to use the default value. If you
do not have Marc at this site, you can ignore
the prompt.
You will also be prompted whether you want
to create a system wide link in
/usr/local/bin to the mentat2019 run
script. You must be root to perform this.
r) Return to the previous menu Choose the Return to previous menu option to
return to the main menu. Select q to exit the
installation script.
61 Marc and Mentat for Linux Installation and Operations Guide
1.2)Run a Marc job with user subroutine If you have a Fortran compiler on your
system, choose a second demonstration
example, option 1.2. Here again, Marc
should give the same exit message as shown
above.
Troubleshooting:
1.If you get an error message of f90
not found or ifort not found
when running a job with a
user subroutine and there is a
Fortran compiler, its path needs to
be appended to your path
in the .cshrc or .profile file.
0) Return to previous menu Repeatedly choose the Return/Exit option
0) Exit from the maintenance script to leave the installation script.
Choose option 0 to leave the maintenance
script.
Step 6: cd <parent>/mentat2019 Next, change your current directory to be
Checking ./bin/mentat the <parent> directory in which you
Mentat installed Mentat, and then cd to
mentat2019.
Checking Marc Run a Demo problem by selecting the menu buttons:
from Mentat Enter the command ./bin/mentat to
Help
start Mentat. From the Help menu, select
Run A Demo... Run A Demo..., and then select the
Thermal/Structural Contact Thermal/Structural Contact demo. It will run
for 50 increments.
Step 7: Please follow the Parallel Network Version
For Marc Parallel for Linux Installation Instructions
Network version ( Chapter 5: General Information and
only Chapter 5: Installation Notes) on installing and
running jobs with the network version.
63 Marc and Mentat for Linux Installation and Operations Guide
Installation Information
Options to the The install.exe script will accept the following options:
install.exe script -a Turns on automatic installation – installs both Marc and Mentat from the installation media.
The -i option (described below) is required.
-i <path> Specifies the installation path (<parent> directory). This option is required when
specifying the automatic installation option -a.
-l <file>Specifies a file for product listing
-v Turns on verbose mode.
The “automatic” installation will install both Marc and Mentat. To perform an “automatic”
installation, run the installation script as follows:
./install.exe -a -i <path>
License server The FLEXlm license manager needs to be started on the license server before running Marc and
Mentat.
The license server is started with (assuming default installation location)
/msc/MSC.Licensing/11.13/bin/lmgrd -c /msc/MSC.Licensing/11.13/licenses/license.dat
-l /msc/MSC.Licensing/11.13/lmgrd.log
hostid For a nodelocked license it is necessary to obtain a FLEXlm hostid for the machine running Marc
and Mentat. This is done by running the command
/msc/MSC.Licensing/11.13/bin/lmhostid
Running Marc
This section describes the Marc usage on Linux based machines. The Marc programs are mainly controlled by a shell script
called run_marc which is stored in the marc2019 subdirectory tools. If you have used the option to creating a link
Running Marc 64
during the installation, this link is also known system wide as marc2019. It is designed to handle practically all possible
options.
The shell script will submit a job and must be executed in the directory where all relevant input and output files concerning
the job are available. To use the shell script, each Marc job should have a unique name qualifier and all Marc output files
connected to that job will use this same qualifier.
Marc input files should always be named job_name.dat, whereby the prefix job_name is the name qualifier which you are
free to choose. The suffix .dat is obligatory.
To actually submit a Marc job, the following command should be used. The single input line is split over multiple lines for
clarity:
Table 4-1 describes the meaning of these input options and Table 4-2 gives examples.
Running Mentat
This section describes the Mentat usage on Linux based machines. Mentat is started by a shell script called mentat which
is stored in the mentat2019/bin directory. If you used the option to create a link during the installation, this link is
known system wide as mentat2019.
67 Marc and Mentat for Linux Installation and Operations Guide
You do not need to start the shell script from a specific directory.
Mentat creates the default files in your current working directory; that is, where you are located at the time of starting
Mentat.
The shell-script mentat contains a number of arguments which are passed on to Mentat. Table 4-3 gives the meaning of
these input options (more details can be obtained using -help option). You are free to alter these commands to suit your
preference.
Mentat Interfaces
Jobs
The subdirectory bin contains shell script files to start a Marc FEM job using the following shell scripts:
submit1, submit2, submit3,
These shell scripts are called by means of the buttons in the JOBS menu.
You can alter these files to suit your environment; for example, set up one of the submit scripts so that it starts a Marc job
on a different machine on your network.
Plotter Interface
Because of the many variations in plotting environments, we have created plotting interfaces in the form of shell scripts
that operate from within Mentat. Currently, Mentat recognizes the following plotting formats:
PostScript
Xdump (translated in either PostScript or HPGL format)
This section describes a template shell script for each of the formats mentioned above. They are located in the bin directory
and are named as follows:
psgray1, psgray2, psgray3
pscolor1, pscolor2, pscolor3
xdump1, xdump2, xdump3
71 Marc and Mentat for Linux Installation and Operations Guide
PostScript
The PostScript function is activated by pressing either the Gray or Color Print button from the UTILS menu on the
POSTSCRIPT panel. The program captures the graphics portion of the screen into a file and sends this file to a PostScript
printer using the psgray or pscolor shell scripts located in the bin directory. In the example listed below, the file is
sent to a computer called ‘mars’ on the network. The lpr command with the -Psupt argument sends the file to a
PostScript printer known to the spooler as supt. After the file is sent, it is removed from disk automatically.
#!/bin/csh
rsh mars lpr -Psupt < $1
rm -f $1
The argument $1 is the filename handed to the shell by Mentat. If there is more than one printer on-line, the psgray
and pscolor shell scripts can be used to address these other printers.
Xdump
The xwd command, widely available on many platforms, dumps an image of an X window into a specially formatted
dump file. This file can then be read by various other X utilities for redisplay, printing, editing, formatting, and archiving.
Its complementary xpr command takes the window dump file as input and formats its output for a particular device, such
as a PostScript or other color printer. Below is an example of a shell script that uses xwd, and, in conjunction with xpr,
sends the information to printer pjetxl. See the man pages on your system for more details.
#!/bin/csh
xwd | xpr -device pjetxl -scale 2 | /etc/aprint -Abatphone2 -L25
Edit
The edit_window shell script is used to control the editor associated with the EDIT commands. It is possible to change the
type of editor, for example, from vi to emacs or change the type of windowing environment.
System Shell
The system_window shell script is used to control the type of window opened with the system_shell command. It is
possible to change the type of window.
Parallel Render
The marc_render shell script can be modified such that the photorealistic rendering is performed across multiple CPUs.
The parameter nbands is used to specify the number of CPUs.
MPEG Playback
The mpeg_window shell script is used to control the program opened with the play_mpeg command.
Managing FLEXlm 72
FLEXlm License File
Managing FLEXlm
FLEXlm is the network based licensing product from Flexera Software used in MSC products.
FLEXlm on-line documentation is available from Flexera, see the URL
http://support.flexerasoftware.com/doc/
Note: The above URL is not an MSC Software Corporation site, and MSC has no control over the site’s content.
MSC cannot guarantee the accuracy of the information on this site and will not be liable for any misleading
or incorrect information obtained from this site.
Environment Variables
The environment variable MSC_LICENSE_FILE is used to specify the full path to the license.dat file, and is a colon
separated list of file pathnames. An example setting of MSC_LICENSE_FILE is:
MSC_LICENSE_FILE=/msc/MSC.Licensing/11.13/licenses/license.dat:/home/joe/license.dat
The environment variable MSC_AUTHQUE is used to specify the number of minutes a program will wait for a license
after it has been requested. If the license request cannot immediately be honored, the request will be queued and the variable
defines how long it should wait in this queue. The variable must be set in your environment before Marc and Mentat are
started. The default value is 5 minutes.
73 Marc and Mentat for Linux Installation and Operations Guide
Machine hostid
For a nodelocked license it is necessary to obtain a FLEXlm hostid for the machine running Marc and Mentat. This is done
by running the command
/msc/MSC.Licensing/11.13/bin/lmhostid
Chapter 5: Marc Parallel Network for Linux
Introduction
This chapter is divided into three parts:
Provides the general description about the hardware and software
Part 1: General Information
requirements and definitions.
Part 2: Installation Notes Provides a step-by-step approach to installation of the network version.
Provides miscellaneous information about executing a parallel job over a
Part 3: User Notes
network and use of user subroutines.
The list of supported capabilities in parallel can be found in “Supported and Unsupported Features” in Chapter 13 of Marc
Volume A, Theory and User Information.
The Supported platforms are listed in the section “Supported Platforms” in Chapter 4 of this guide.
General Information
Compatibility
All machines used in a network run must be compatible. That is, they must use the same Marc version.
General Information 76
Definitions
Definitions
The definitions of some of the terms are as follows:
Network Configuration
Marc only needs to be installed on the root machine where the installation directory is shared via NFS (shared installation).
Please note that if HPMPI or Intel MPI is used the installation directory must be available with the same path for every
machine. Marc can also be installed on the remote machines which then use their own executable (distributed installation),
but the name of the path must be the same. The root machine is the one on which the Marc job is started, typically from
within Mentat. The remote machines can be located anywhere as long as they are connected to the network. The working
directory on each machine can be a shared directory on any machine on the network (shared I/O) or it can be a local
directory on the hard disk of each machine in the analysis (distributed I/O). The User Notes describes how to specify what
working directory to use.
77 Marc Parallel Network for Linux Installation and Operations Guide
network
Installation Notes
This part describes the specific steps needed to install and set up a network version of Marc. For general information on
Marc installation, see Marc and Mentat for Linux.
Install Marc on the root machine and, if needed, on the remote machines. Marc only needs to be installed on the root
machine. However, if Marc is to be used on the remote machines as well, it can also be installed there. There is nothing
special that needs to be done related to the installation itself for the network version. For IBM MPI and Intel MPI the
installation directory must be available with the same path on every machine, regardless of if the installation is local or if it
uses a shared directory.
In order to run parallel jobs on machines connected over the network, it has to be set up properly. If any of the remote hosts
does not have Marc installed, the installation directory on the root machine needs to be shared using NFS or some other
mechanism so that the Marc version is available from the remote machines. Users need to be able to connect between the
machines using rlogin or ssh without having to provide a password. It is possible to define if rsh/rcp or ssh/rsh or
similar command is to be used. This is done by modifying the variables RCP and RSH in the include file for the platform
used.
Assume the following, there are two machines with hostnames host1 and host2 that are to be used in a parallel job over the
network. Marc has been installed on host1 and the job is to be started from this machine. A hypothetical naming
convention is used for shared directories where a directory name on any machine starts with /nfs/hostname, where hostname
is the name of the machine on which the directory is located.
First, test the installation for single processor execution. Change directory to the test_ddm subdirectory of the Marc
installation directory on host1. Then do
cd exmpl2/exmpl2_1
marc -j cyl2 -b no -v no
and Marc should exit in about three minutes if it is a successful run. Here we assume that the command “marc” points to
the current Marc version.
Then test the Marc installation for multi-processor execution. Do
cd ../exmpl2_2
and edit the file hostfile in this directory by replacing workdir with
User Notes 78
How to run a network job
/nfs/host1/marcinstall/test_ddm/examp2/exmpl2_2
and installdir with
/nfs/host1/marcinstall.
For HPMPI and Intel MPI delete installdir (so only use three columns in the host file).
The host names and directory names should, of course, be replaced with the names on the current system. Finally, type:
marc -j cyl2 -b no -v no -nprocd 2 -host hostfile
and Marc should exit in about two minutes if it is a successful, parallel run on host1 and host2 using one processor on each.
User Notes
This section assumes that the network version of Marc has been successfully installed on at least one of two machines that
are to be used in a distributed analysis and that the appropriate Marc licenses are in order. Assume that host1 is the host
name of the machine on which Mentat is running and from which the job is to be started (the root machine). The host
name of the other machine (the remote machine) is host2.
Note: The current version does not support the IPV6 protocol.
In order to perform an analysis over a network, a specific file called host file needs to be created by the user. This file defines
which machines are to be used, how many processes are to run on each, what working directory should be used, and where
the Marc executable can be found on each machine. The host file can be selected and edited in Mentat and the Marc job
started as usual from within Mentat (see the example below). If Marc is run from the command line, it is done as for a serial
run using an additional command line option. For example:
marc -v no -b no -jid test -nprocd 2 -host hostfile1
will run the two-processor job test.dat using the specification in the file hostfile1. No specific name or extension is
used for the host file except that the name jobid.host (in this example test.host) must be avoided since it is used
internally by Marc.
79 Marc Parallel Network for Linux Installation and Operations Guide
Shared I/O
Suppose a job is to be run on host1 and host2. A shared directory on host1 is to be used for I/O and from host2 its name
is /nfs/host1/marc/workdir (assuming a hypothetical naming convention for shared directories which starts with /nfs/hostname).
User Notes 80
Distributed I/O
The installation directory is assumed to have the same name on both machines. The host file for a two-processor job would
simply be
host1 1
host2 1 /nfs/host1/marc/workdir
To verify the workdir given, do rlogin host2 ; ls /nfs/host1/marc/workdir. The directory seen should be the
same one as the working directory on host1.
Distributed I/O
If the user wants to have the I/O to be local on host2, specify the host file as
host1 1
host2 1 /usr/people/marcuser
The I/O on host2 will now take place in the directory /usr/people/marcuser on the hard disk of host2. For this case, the
Marc input files are transferred to /usr/people/marcuser on host2 before the job is started, and the results files are
transferred back after the analysis for postprocessing. This transfer of files is done by Marc automatically.
It is also possible to use only two entries in the host file. This requires that both the working directory and the installation
directory have the same names on all machines.
Example
The definitions for a network run with Mentat is demonstrated with a simple example. We assume the simplest case where
both the working directory and installation directories are shared.
Step 1
Enter the menu Help Run a Demo... and select the example Contact With DDM. Select and confirm your three
domains as shown below.
81 Marc Parallel Network for Linux Installation and Operations Guide
Step 2
Check the Use DDM option and enter the Network submenu.
User Notes 82
Distributed I/O
Select Network
Select the file my_host_file with the Host File button. Edit it by clicking the Edit button. The my_host_file places
one domains on host1 and one domain on host2 with the contents:
host1 1
host2 1 workdir installdir
Replace workdir and installdir with the full paths to the working and Marc installation directories, respectively.
83 Marc Parallel Network for Linux Installation and Operations Guide
Run Marc from within Mentat using the Submit (1) button. Upon completion of the analysis, the following dialog box
appears :
User Notes 84
Shared vs. Distributed I/O
Step 3
Check your results. This can easily be done by clicking the Open Post File (Model Plot Results Menu) button. A plot of
the Total Equivalent Plastic Strain in the final deformed configuration is shown in the image as follows:
Marc created a post file associated with each domain as well as a root post file associated with the job id. For the previous
model, 1model1_job1.t16 and 2model1_job1.t16 are the processor files, while model1_job1.t16 is the root
file.
If the model is very large, it can be convenient to view only a portion of the model by selecting any one of the processor
post files, such as 2model1_job1.t16. This file contains only data associated with domain 2 as selected in the domain
decomposition menu under Step 1. As described in Step 2, this file was created by host2.
Troubleshooting
Check the Following:
1. The network connection between the hosts is working by using the command ping host.
2. A remote login using the command rlogin can be done between the hosts without providing a password. If not,
contact your system administrator or check the man pages for rlogin and look for .rhosts.
3. The host names used in the hostfile are correct. It should be the same as the output from the command hostname
on the respective host.
4. The working and installation directories on the host file are correct. Log onto the remote host, change directory to
these directories to verify the host file content. The installation directory given should (among others) contain the
executable in the bin directory.
5. The input files for each host are available in the respective working directory. An error message is printed out from
Marc if they are not.
Error messages:
1. The error message “semget failed...” at job start-up means that the communication environment is not clean.
This can be checked with the Linux command ipcs. If entries belonging to specific users except root show up,
they may need to be removed. Run the script tools/mpiclean located in the Marc installation directory.
Note: This will kill all parallel jobs currently running under the current user.
Only entries belonging to the current user are deleted.
Chapter 6: Linux: Sample Installation of Marc and Mentat
In this appendix, a sample installation is demonstrated of a single license installation for Linux 64-bit. It is assumed that
the licensing is already completed.
Step 1: mkdir /tmp/marc Create a temporary directory and download the product file to
Download the cd /tmp/marc that directory. Substitute the proper filename for <file>. Use
product and start gunzip to uncompress the file and extract the files using the tar
the install script gunzip <file>.gz command.
tar xvf <file>.tar Start the install.exe script which will be in the current
./install.exe directory. Confirm that Marc 2019 will be installed and enter “I
Accept” if you accept the conditions echoed by the script.
? )Help information
r )Return to previous menu
You may need to be root to Do you want to create links to the startup scripts [y/N] ? n
create the links. The current default MARC_MPI is set to intelmpi
You can use the default Do you want to change it to hpmpi [y/N] ? n
selection by just pressing the
enter key. You can always change the defaults by editing the
run_marc_defaults file in the marc tools directory or use the
appropriate run_marc options.
? )Help information
r )Return to previous menu
Enter the path to the Enter the pathname to the directory containing the solver:
marc2019 directory. [/opt/marc/marc2019]
You can use the default Hit return to continue
selection by just pressing the
enter key. submit1 script adjusted
submit2 script adjusted
submit3 script adjusted
Make your choice Do you want to create links to the startup scripts [y/N] ? n
Hit return to continue
Step 4: Run the installation executable for security. Install and run
Install Security lmtools to obtain a hostid. Send this information to MSC
Software and put the obtained license file in
/msc/MSC.Licensing/11.13/licenses/license.dat
89 Marc and Mentat for Linux Installation and Operations Guide
Step 5: mkdir Enter the directory used to install Marc and Mentat:
Installing the /tmp/documentation /opt/marc
documentation cd /tmp/documentation
gunzip <file>.gz
tar xvf <file>.tar
./install_doc.exe
7 Linux Troubleshooting
91 Marc and Mentat for Linux Installation and Operations Guide
Cannot create • You have no write permission in the parent directory. Change with chmod.
Security failed Marc or Mentat was unable to obtain a license from the FLEXlm licensing software. In this case,
Marc or Mentat will exit. The possible causes for this are:
• The FLEXlm license manager is not running. See chapter 2 and 8 for information on how to
run the license manager.
• You are attempting to run on a machine that according to the license file you are not allowed to
use.
• Your license period has expired. Check the date on your machine.
• For counted licenses, currently running too many Marc jobs. Try later. If the limit has not been
exceeded, try restarting the license manager, lmgrd, and the vendor daemon MSC. Make sure
no other Marc jobs are running.
• If you have just modified the license.dat file, the lmgrd and MSC daemons may not have
been restarted. Run the lmreread utility as follows:
lmreread -c “parent”/msc/MSC.Licensing/licenses/license.dat
• If you get the FLEXlm error:
Invalid (inconsistent) license key (-8,130:2) No such file
or directory
it may be implying that the hostid value specified on the SERVER line are inconsistent with the
passwords. Check the values and restart the license manager.
• If you get the FLEXlm error:
Cannot connect to license server (-15,12:146)
and you are using a server license, the license manager (lmgrd) may not be running on the
license server, or the USE_SERVER line in your client side license.dat file is incorrect. Also
make sure that the TCP/IP port numbers used on the SERVER line are the same on both the
client and the server.
Testing Marc • If you are using install.exe to test Marc installation and the Test and maintain installation
Installation fail does not respond, remove exec tcsh from your .cshrc and restart installation testing.
Mentat cannot • Make sure Mentat has X server access to your display device. The command: xhost + allows
open the display Mentat to run on a remote screen. This command must be issued while logged onto the
computer that owns the remote screen.
• If you are using a terminal other than the default screen belonging to the machine, you may
have to set the X-window output device:
C-shell: setenv DISPLAY your_terminal_name:0.0
Bourne shell: DISPLAY=your_terminal_name:0.0 export DISPLAY
Mentat runs • This may happen when the model you are working on becomes very large. Mentat requires a
OK, then aborts considerable amount of memory to store the model. We advise that a minimum of 8 GB core
memory is available in your machine.
• If the multi-level UNDO option is off, you can save memory by switching UNDO off in the
Tools Program Settings... menu.
93 Marc and Mentat for Linux Installation and Operations Guide
You are • In Marc 2019, on Linux the default MPI version is IntelMPI. This MPI version requires that
prompted for a the ssh command has been set up such that it does not prompt for a password. Here is a
password when description on how to set this up.
running parallel • Make sure there is a directory called .ssh in the home directory (note that in this home
jobs directory only you must have write access):
cd $HOME
ls .ssh
• If it does not exist, create it:
mkdir .ssh
chmod 700 .ssh
cd .ssh
• Execute the command
ssh-keygen -t rsa -f id_rsa -P ''
• Please note that it is -P followed by two single quotes. This will create two files: id_rsa and
id_rsa.pub. Copy id_rsa into a file called identity:
cp id_rsa identity
• Append id_rsa.pub to a file called authorized_keys
cat id_rsa.pub >> authorized_keys
chmod 600 authorized_keys
• The directory $HOME/.ssh should now contain the four files id_rsa, id_rsa.pub,
identity and authorized_keys (and possibly more files).
If all went well it should now be possible to do:
ssh thishost
with thishost replaced by the hostname of the current machine, without getting a prompt for
the password. After this it should be possible to run a parallel job without having to provide a
password.
In order to be able to connect to other Linux machines without being prompted for a password
(for example for running parallel network jobs), use the following steps:
• Copy the file id_rsa.pub that was created above to the other machine. Make sure it has a
directory $HOME/.ssh. Append the file id_rsa.pub to the files
$HOME/.ssh/authorized_keys and $HOME/.ssh/authorized_keys2 and give them
the appropriate permission:
cat id_rsa.pub >> $HOME/.ssh/authorized_keys
cat id_rsa.pub >> $HOME/.ssh/authorized_keys2
chmod 600 $HOME/.ssh/authorized_keys $HOME/.ssh/authorized_keys2
chmod 700 $HOME/.ssh
• The first time you login with ssh to the second system you will get a warning and asked if you
want to continue. Type yes to accept and the remote host will be added to the file
$HOME/.ssh/known_hosts and the next time you will not be prompted.
SECTION 3: APPENDICES
Appendix A: Microsoft Windows: Marc Subdirectories
The Marc version you have received contains a full set of subdirectories listed below. You can save disk space by removing
the example subsets that you do not need.
The Mentat version you have received contains a full set of subdirectories listed below.
The Marc version you have received contains a full set of subdirectories listed below. You can save disk space by removing
the example subsets that you do not need.
Table 3-1 Contents of the Marc installation
Basic set: Contents: required as minimum
bin executable Marc programs
tools shell scripts to run and maintain the Marc programs
AF_flowmat material data for database
xdr_lib machine dependent libraries
Extended set: Contents: only for use with user subroutines
common insert files containing Marc common blocks
lib binary libraries with the compiled Marc routines
lib_shared system dependent shared libaries.
user templates for all available Marc user subroutines
Examples: Contents: example files
demo input files and user subroutines for the Marc Volume E: Demonstration Problems
demo_ddm input files and user subroutines for the single parallel machine as well as the network parallel
version of Marc
demo_table input files and user subroutines for the Marc Volume E: Demonstration Problems based upon
Table driven input format.
test_ddm one, two, and four processor test examples for installation testing of the single parallel machine
as well as the network parallel version
Utilities: Contents:
pldump source routines for the post-file conversion programs pldump, pldump13 and pldump2000
intelmpi MPI libraries for network parallel version
102
The Mentat version you have received contains a full set of subdirectories listed below.
Table 3-2 Contents of the Mentat directory unloaded from installation package
Basic set:
3dx 3-D mouse driver
bin Shell scripts and programs for Mentat
ctkernel CAD import libraries
help Mentat online help files
lang Localization dictionaries
materials Mentat material files
materials_pre2010 Old Mentat material files
menus Mentat menu files
parasolid Parasolid schema files
python Python installation
qt Graphics plug-ins
scasystem Components interface
shlib Shared libraries
utilities SIFT Python scripts
103 Marc and Mentat for Linux Installation and Operations Guide