Adams 2020 fp1 Doc Install
Adams 2020 fp1 Doc Install
Adams 2020 fp1 Doc Install
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: [email protected]
Email: [email protected]
Worldwide Web
www.mscsoftware.com
Support
http://www.mscsoftware.com/Contents/Services/Technical-Support/Contact-Technical-Support.aspx
Disclaimer
This documentation, as well as the software described in it, is furnished under license and may be used only in accordance with the
terms of such license.
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 text are for illustrative and educational purposes only, and are not intended
to be exhaustive or to apply to any particular engineering problem or design. MSC Software Corporation assumes no liability or
responsibility to any person or company for direct or indirect damages resulting from the use of any information contained herein.
User Documentation: Copyright © 2020 MSC Software Corporation. Printed in U.S.A. All Rights Reserved.
This notice shall be marked on any reproduction of this documentation, in whole or in part. Any reproduction or distribution of this
document, in whole or in part, without the prior written consent of MSC Software Corporation is prohibited.
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://www.mscsoftware.com/thirdpartysoftware (or successor
website designated by MSC from time to time). Portions of this software are owned by Siemens Product Lifecycle Management, Inc.
© Copyright 2020
The MSC Software logo, MSC, MSC Adams, MD Adams, and Adams are trademarks or registered trademarks of MSC Software
Corporation in the United States and/or other countries. Hexagon and the Hexagon logo are trademarks or registered trademarks of
Hexagon AB and/or its subsidiaries. FLEXlm and FlexNet Publisher are trademarks or registered trademarks of Flexera Software.
Parasolid is a registered trademark of Siemens Product Lifecycle Management, Inc. All other trademarks are the property of their
respective owners.
ADAM:V2020FP1: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-
[email protected].
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
Adams 2020 FP1 Installation and Operations Guide
Preface
About MSC Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Internet Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
1 Getting Started
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Welcome to Adams Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
What You Need . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Types of Installations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Product Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
4 Licensing on Linux
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
About the Adams License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Licensing Adams When File and License Server Are Same Machine . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Licensing Adams When File and License Server Are Different Systems . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Starting the Adams License Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Restarting the Adams License Daemons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Changing the License to Point to a Different License Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Verifying a Successful License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
6 Licensing on Windows
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Licensing Basics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Specifying your License. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Replacing Codes (Licenses) on an Existing Windows Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Customizing End-User License Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
9 Troubleshooting
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Troubleshooting on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Troubleshooting on Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Preface
About MSC Software
Technical Support
Internet Resources
x Adams 2020 FP1 Installation and Operations Guide
About MSC Software
Overview
MSC Software Corporation is the leading global provider of virtual product development (VPD) tools,
including simulation software and professional services. MSC Software helps companies make money, save
time, and reduce costs associated with designing, testing, producing, and supporting manufactured products.
MSC Software works with thousands of companies worldwide, in hundreds of industries, to develop better
products faster by using information technology, software, and services to enhance and automate the product
design and manufacturing process. Simulating your product performance reduces development costs, time to
market, and warranty costs.
Technical Support
For help with installing or using an MSC Software product, contact MSC technical support. Our technical
support provides technical assistance on questions related to installation and use of the software. For further
details please see the Technical Support Usage Guide, which is accessible via our support web site.
You can reach MSC technical support on the web, by telephone, or e-mail.
Web
Go to the MSC Software web site at www.mscsoftware.com, and click on Services → Technical Support.
Here, you can find a wide variety of support resources including Product Updates, Discussions, Technical
Articles, and Documentation updates.
In addition, we provide several excellent sources of online information:
SimCompanion - Find solutions to problems in this repository of troubleshooting tips, examples,
and frequently asked questions. To access the SimCompanion, go to:
http://simcompanion.mscsoftware.com
VPD Community - The VPD community is where to go when you are looking for peer support, as
well as technical expertise. Many of our consultants, developers, and technical support staff monitor
the forums. To sign up for the forums, go to:
http://forums.mscsoftware.com
Then:
• To view the Adams discussions, select Adams.
• To view product alerts and company news and events, select MSC News.
Training
MSC Software training provides comprehensive training in Virtual Product Development. We offer standard
and customized training courses in the application of CAE tools to solve from basic to complex problems
within any industry. We offer over 100 courses in our state-of-the-art classroom facilities and individual
computer graphics laboratories at training centers throughout the world. All of our courses emphasize hands-
on computer laboratory work to facilitate skills development. We are uniquely positioned to optimize your
investment in design and simulation software tools.
Our industry experienced expert staff is available to customize our course offerings to meet your unique
training requirements. For the most effective training, we also offer many of our courses at our customer's
facilities.
xii Adams 2020 FP1 Installation and Operations Guide
Technical Support
We specialize in customized training based on our evaluation of your design and simulation processes, which
yields courses that are geared to your business. In addition to traditional instructor-led classes, we also offer
video courses, interactive multimedia training, web-based training, and a specialized instructor's program.
Internet Resources
MSC Software (www.mscsoftware.com)
MSC Software corporate site with information on the latest events, products and services for the
CAD/CAE/CAM marketplace.
1 Getting Started
Overview
Welcome to Adams Products
What You Need
Types of Installations
Product Categories
Getting Help
2 Adams 2020 FP1 Installation and Operations Guide
Overview
Overview
This chapter describes what you need to know and have available to install the Adams 2020 FP1 suite of
software. It contains the sections:
Welcome to Adams Products, 3
What You Need, 4
Types of Installations, 5
Product Categories, 6
Getting Help, 7
CHAPTER 1 3
Getting Started
Types of Installations
The way in which you install and license the Adams products depends on your installation configuration.
Any given installation configuration is composed of the following three components:
File server - Machine that contains the Adams files. It may be shared with other computers on a
network.
License Server - Machine that runs the Adams license server. The licensing of Adams products
depends on the type of license you purchased.
Client - Machine that runs the Adams products.
You can manage these three components on one machine, three different machines, or any combination of
machines. You can also install Adams products on a heterogeneous network where you install Adams
products for different platforms all on one network. For information on the various Linux configurations,
see Linux Installation Roadmaps, 103.
6 Adams 2020 FP1 Installation and Operations Guide
Product Categories
Product Categories
The product(s) or feature package you are licensed to use for Adams appear on the first page of your password
certificate under the section Feature/Password. When you install the products, select the packages that you
are licensed for.
CHAPTER 1 7
Getting Started
Getting Help
If you have questions or problems installing or testing your Adams products, refer to Troubleshooting, 95. If the
problems persist, go to the Technical Articles or Known Issues at http://simcompanion.mscsoftware.com/. If the
problems still persist, call MSC Software Technical Support. For a current list of phone numbers and
language-based email addresses please visit our web site http://www.mscsoftware.com, click on Services →
Technical Support → Contact Technical Support. Before contacting Technical Support, please have the
following information available:
Hardware type (be as specific as possible)
Version of the operating system, including build number and service packs, if applicable
Version of compilers
Hardcopy of all error messages (you can send it by fax or through e-mail)
If possible, generate a troubleshooting report as explained in Generating Problem Reports, 97.
8 Adams 2020 FP1 Installation and Operations Guide
Getting Help
MSC Nastran Implicit Nonlinear (SOL 600) User’s GuideAdams 2017 Installation and
Operations Guide
Chapter 2: Hardware and Software Configurations
Overview
Hardware and Software Specifications
Compiler Requirement Details
System Requirements
Graphics Requirements
Licensing Requirements
Dropped Platforms
10 Adams 2020 FP1 Installation and Operations Guide
Overview
Overview
This chapter provides the hardware and software configurations for Adams.
Note: For the latest version of the hardware and software specifications, see the Adams Support site
at http://simcompanion.mscsoftware.com
Notes: 1. Intel IA-32 and x64 processors: Pentium (4, D), Core (i3, i5, i7), Xeon and AMD compatibles.
2. Adams 2020 FP1 product developed using the 'Intel Composer Edition' compiler.
3. Adams Controls is supported on these platforms. However, partner product support varies. Please
see the Supported Versions of Integration Products section of the Adams product Release Guide.
4. Conditions under which compilers are required are listed below in Compiler Requirement Details
section.
5. For the latest information on supported platforms for upcoming releases of MSC products, please
visit the following web site: http://www.mscsoftware.com/Support/Platform-Support/Default.aspx
6. Adams officially supports the Professional Edition of Microsoft Visual Studio, but the Community
Edition has been found to function in the following scenarios:
• DLL generation for user-written subroutines in C or in C and Fortran
• Some Adams Controls scenarios with MATLAB/Simulink, Easy5 and FMI compliant
software. For details, please see the Supported Versions of Integration Products section of the
Adams product Release Guide.
CHAPTER 2 13
Hardware and Software Configurations
*
Easy5 requires Intel® Fortran
**Easy5 requires GNU Compiler Collection or Intel® Fortran; Intel® recommended
^
Easy5 requires Visual Studio linker; note that some FORTRAN compiler environments include this
#
MATLAB/Simulink® may require it under some circumstances; check with The MathWorks, Inc. for
compiler requirements
##
MATLAB/Simulink® requires it for building the .dll to be exported; check with The MathWorks, Inc. for
compiler requirements
$FMI with Easy5 requires GNU Compiler Collection or Intel® compiler
$$
FMI with Easy5 requires GNU Compiler Collection or Visual Studio C compiler
14 Adams 2020 FP1 Installation and Operations Guide
Compiler Requirement Details
compiler requirements
$FMI with Easy5 requires GNU Compiler Collection or Intel® compiler
CHAPTER 2 15
Hardware and Software Configurations
System Requirements
Table 2-4 shows the system requirements for Adams.
Note: Ubuntu Linux 16.04 and 18.04 are also supported, but only for standalone Adams
Solver jobs including those that use Adams Controls and/or Adams Car Solver
extensions. Use the installer for Red Hat Enterprise Linux 7.3.
Note: Due to security restrictions in the latest version of Google Chrome, you cannot use
Chrome to view the Adams help. Mozilla Firefox and Microsoft Internet Explorer are
recommended to view the Adams help.
16 Adams 2020 FP1 Installation and Operations Guide
Graphics Requirements
Graphics Requirements
The following are the graphics requirements for Adams.
Licensing Requirements
Following are the Adams licensing requirements for obtaining a node locked license file. Note that when
obtaining licenses from a server, this version of Adams requires access to MSC License Server (FLEXlm)
v11.13 or greater (installed separately).
Dropped Platforms
Each release we review the platforms and operating system changes by our partners and in the industry, and
address these changes in our release. We make this information available to you for hardware planning. We
welcome your input on platform support. Please communicate platform support needs to your MSC Sales
Representative.
MSC Nastran Implicit Nonlinear (SOL 600) User’s GuideAdams 2018 Installation and Oper-
ations Guide
Chapter 3: Installing Adams on Linux
Overview
Preparing to Install the Adams Product
Creating the Installation Directory
Installing Adams
Installing the Adams Controls Thin Client
Installing the Adams Extension for Easy5
Installing on a Heterogeneous Network
20 Adams 2020 FP1 Installation and Operations Guide
Overview
Overview
This chapter provides instructions for installing the Adams software. It contains the sections:
Preparing to Install the Adams Product, 21
Creating the Installation Directory, 24
Installing Adams, 25
Installing the Adams Controls Thin Client, 36
Installing the Adams Extension for Easy5, 37
Installing on a Heterogeneous Network, 39
After installing the Adams products, you need to set up the licenses to run them. See Licensing on Linux, 41 for
more information.
Note: For general steps (roadmaps) for the various Linux configurations, see Linux Installation
Roadmaps, 103
CHAPTER 3 21
Installing Adams on Linux
Installing Adams
This section contains instructions for starting the Adams installation program.
If you have downloaded Adams from the MSC Solutions Download Center, you will run the installation
program from the directory you unloaded the executable installer into. If you are installing from a DVD, you
will run the executable installer directly from the DVD.
The installation program has command line options available to help you tailor the installation to your site's
needs.
Running the installation program without any options will launch it in graphical mode. Running in
graphical mode uses the X-Windows display protocol. You must have the X-Windows DISPLAY variable set
to a valid display to run in graphical mode.
Available Options:
--debug Run installer in debug mode. Not supported for customer installations
--debugconsole Run installer with a debug console open. Not supported for customer
installations
--help Display this information
--mode [ARG] Set the mode to run the installer in. Available values: console, default, silent
or standard
--prefix [ARG] Set the installation directory
--record Settings will be saved in ./config.rec file
--response-file [ARG] A file to read installer responses from
--save-response-file [ARG] A file to write installer responses to when the installer exits
--temp [ARG] Set the temporary directory used by this program
--test Run installer without installing any files
--version Display installer version information
The installation responses are often system specific, it is not recommended to use the responses from one
platform installer on other supported platforms.
The most common combinations are provided as examples below because MSC changes the name of the
installation program to include product and release version number. The generic name "installer.bin" is used
to represent the name of the installer in these examples.
The installation program will install in graphical mode by default.
1. Move to the installation directory you previously created.
2. Locate the installation program, adams_XXXX_PLAT.bin, in either the download directory or the
DVD. The full path to the installation program will be needed to run it.
where XXXX is the release version, and PLAT is the platform name that corresponds to the platform
you wish to install. For example:
26 Adams 2020 FP1 Installation and Operations Guide
Installing Adams
adams_2020_1_redhat64.bin
3. Start the installation program, including the full location path you determined in Step 2 above. For
example, from a shell window prompt enter:
/tmp/adams_installer/adams_2020_1_redhat64.bin
You will see a confirmation dialog box. Select Yes button to begin the installation.
5. Select Acknowledged > button to continue, or Cancel button to exit without installing.
6. Select the full path to the directory you want to install Adams in. You can type in the directory path
after selecting the Browse button, or use the directory tree to locate the installation directory.
28 Adams 2020 FP1 Installation and Operations Guide
Installing Adams
b. User Selectable: Will allow you to select individual product suites to install.
30 Adams 2020 FP1 Installation and Operations Guide
Installing Adams
8. Select the Next > button to confirm your installation selection (s). A progress dialog box will be
displayed. You can select the Cancel button at any time to stop the installation.
CHAPTER 3 31
Installing Adams on Linux
9. The Licensing dialog box allows you to choose the method of communications with an MSC License
Manager. The most common method for communicating with the license manager is a port@host
connection. This is the TCP port number your license manager is listening to, and the hostname of
the system that is running the license manager processes. The standard MSC License ManagerTCP
port number is 27500.
32 Adams 2020 FP1 Installation and Operations Guide
Installing Adams
12. After entering the correct path to your HTML Browser, select Next> button to continue.
34 Adams 2020 FP1 Installation and Operations Guide
Installing Adams
13. A summary dialog box announces the completion of the installation process and provides final
instructions for license manager communication changes should you need to change that setting in
the future. It also provides the MSC Technical Support e-mail address. Selecting Finish will complete
the installation process.
14. If you chose to install either the Adams package or the Adams Advanced package, you will need to
setup the Adams Extension for Easy5. For more information, refer to Installing the Adams Extension for
Easy5, 37
Other than the default standard installation, you will encounter various installation scenarios. The following
lists the common standard scenarios used in Adams.
Scenario 1:
The product installation needs to be performed on multiple systems of the same system type
1. Perform the installation on one reference platform interactively and record the responses
installer.bin --record
CHAPTER 3 35
Installing Adams on Linux
The responses will be recorded in a default file name of "config.rec" in the current working directory.
If you want to specify the name of the recorded response file use the option:
installer.bin --save-response-file my_install_responses.txt
where "my_install_responses.txt" is the file name the responses will be save to.
2. Log into the next system that you need to install the product on
3. Copy the response file you recorded in step (1) to this system
4. Run the installer on this system with the following option
installer.bin --response-file my_install_responses.txt --mode silent
Scenario 2:
You have tried to install, but the installer reports that it does not have enough file system space to create
temporary files during the installation. The /tmp partition on the system you are installing on has insufficient
space to create these temporary files. You need to be able to use another location for temporary files.
1. Perform the installation on the system with the following option
installer.bin --temp /scratch/mytemp
Note that the directory you specify with the --temp option must previously exist.
Scenario 3:
You want to enforce a standard installation directory location. You can add an installation directory option
to control this when documenting the procedure for others to follow.
install.bin --prefix /opt/applications/adams
The directory specified as the prefix will appear in the dialog requesting an installation directory. You can add
any path below that prefix directory to store multiple releases, or accept it as the default.
Scenario 4:
You are installing on a system that does not have a system console running an X-Windows server. If you want
install Adams through console mode by manually entering required input via Linux console without GUI
install shield display.
installer.bin --mode console
The console mode will use text prompts to answer the questions required to install. You can use console mode
with all other options.
36 Adams 2020 FP1 Installation and Operations Guide
Installing the Adams Controls Thin Client
Note: You must install the Adams Extension for Easy5 to use the Adams Controls Thin Client with
Easy5. For more information, see Installing the Adams Extension for Easy5, 37.
CHAPTER 3 37
Installing Adams on Linux
To run Adams and Easy5 together, you must install the Adams extension into Easy5. To import models into
Adams that were exported from Easy5 (containing components from licensed Easy5 libraries), you must also
configure your computer so that Adams knows how to find your Easy5 license. The following procedures
explain how to do this.
Note: If you are unable to identify a command line command to run Adams but you can
identify the top-level directory of the Adams installation, you can use -d
directory_path in place of the command line command in the following steps.
To configure your computer to run licensed exported Easy5 models within Adams:
1. Start Easy5.
2. From the File menu, select Open Command Shell.
3. At the prompt in the command shell, type easy5x --license.
38 Adams 2020 FP1 Installation and Operations Guide
Installing the Adams Extension for Easy5
Easy5 displays the licensing information, beginning with the type of license and the server name (if a
server license) or the path to the license file.
4. Write down the contents of the line that starts with Active license file(s), and the value that appears
in the line following it (for example, 27500@rainier).
5. Perform one of the following:
• If the line is Active license file(s) [EASY5_LMD_LICENSE_FILE], set the environment variable
EASY5_LMD_LICENSE_FILE to the output value displayed in Step 4 above (for example,
27500@rainier).
• If the line is Active license file(s) [MSC_LICENSE_FILE], find the value of the environment
variable MSC_LICENSE_FILE to see what license file Adams is using.
• If Easy5 and Adams are using different licenses (or license servers), set LM_LICENSE_FILE to
the value for the Easy5 license (for example 2500@bosco).
• If Easy5 and Adams are using the same license, your computer is configured properly.
CHAPTER 3 39
Installing Adams on Linux
4 Licensing on Linux
Overview
About the Adams License Server
Licensing Adams When File and License Server Are Same Machine
Licensing Adams When File and License Server Are Different Systems
Starting the Adams License Server
Restarting the Adams License Daemons
Changing the License to Point to a Different License Server
Verifying a Successful License
42 Adams 2020 FP1 Installation and Operations Guide
Overview
Overview
This chapter provides instructions for licensing the Adams software. You must complete the steps in Installing
Adams on Linux, 19 before licensing the Adams software. Refer to Linux Installation Roadmaps, 103 for which
procedure in this chapter to follow depending on your system configuration.
The chapter contains the sections:
About the Adams License Server, 43
Licensing Adams When File and License Server Are Same Machine, 44
Licensing Adams When File and License Server Are Different Systems, 45
Starting the Adams License Server, 46
Restarting the Adams License Daemons, 47
Changing the License to Point to a Different License Server, 48
Verifying a Successful License, 49
CHAPTER 4 43
Licensing on Linux
To set up licensing:
1. From the Installation directory start the installation program INSTALL.ADAMS.
2. Enter 1 to select the option, Install Adams passwords on this license server.
3. Enter y if the name of the Adams license server that appears in the prompt is the same as the machine
designated as the server in your e-mail password certificate. (Depending on the type of license you
have, the server name may not be listed in your e-mail certificate; in this case, use the hostid instead.)
4. The default is the machine to which you are logged on. If this is not your license server, enter n, log
in to your license server, and start the procedure again.
5. Follow the instructions in the e-mail password certificate to locate the information required for
licensing your Adams software.
6. At the prompt Are your passwords in a file e-mailed from MSC Software?, enter y.
7. Enter the name of the text file that contains your passwords.
The installation program reads this file and constructs a properly formatted license data file
(license.dat) for you.
8. If the installation program cannot read the file, open the original file and verify that you cut the
information required for licensing at the correct locations.
9. Continue with Starting the Adams License Server, 46.
CHAPTER 4 45
Licensing on Linux
Note: To add the Adams license server startup commands, follow the instructions provided by your
operating system.
The licensing of Adams products is complete. You can now verify that installation was successful by following
the procedures in Verifying a Successful License, 49.
48 Adams 2020 FP1 Installation and Operations Guide
Changing the License to Point to a Different License Server
Installing Adams on
5 Windows
Overview
Installing the Adams Controls Thin Client
Installing the Adams Extension for Easy5
Installing Adams in Silent Mode (Batch)
52 Adams 2020 FP1 Installation and Operations Guide
Overview
Overview
The following sections explain how to install Adams 2020 FP1 products and online documentation by
running the Adams 2020 FP1 installation program. It also includes information on licensing your Adams
2020 FP1.
Installing Adams, 52
Installing the Adams Controls Thin Client, 63
Installing Adams in Silent Mode (Batch), 67
Installing Adams
This section shows you how to install Adams software and documentation.
To install Adams:
1. Open Windows Explorer, browse to your Adams download and double click the Adams 2020 FP1
self extracting executable file.
The language selection window will appear as shown below:
2. If you select “English” the welcome agreement window will appear as shown below.
3. If you select “Japanese” the welcome agreement window will appear as shown below.
4. Select Acknowledged > button to continue, or Cancel button to exit without installing.
Note: To re-select the language, click Cancel button to exit and restart the installation.
5. In the Customer Information window, enter your user and company name, and then select one of
the following:
• Anyone who uses this computer (all users) - Anyone logged on to this machine can run Adams 2020
FP1.
• Only for me - A user must be logged on using the user name and password that was used at the
time of installation.
56 Adams 2020 FP1 Installation and Operations Guide
Overview
6. Select Next.
The Setup Type window appears as shown below.
Note: You cannot install the Adams Controls Thin Client at the same time as other Adams
2020 FP1 products. You must install it by itself. See Installing the Adams Controls Thin
Client, 63 for more information
11. Confirm the installation settings and then select Next to begin the installation.
12. The License Setup window appears as shown below.
CHAPTER 5 59
Installing Adams on Windows
13. Enter the name of the license server or the path to your license file. If you don’t enter this information
here, you can specify your license using the procedure in Specifying your License, 72.
14. Select Next.
15. Specify whether or not you want to install the various desktop icons. If you select Yes, then select the
products for which the icons to be created.
60 Adams 2020 FP1 Installation and Operations Guide
Overview
17. Select the solver product with which you want .acf files on this machine associated. You can also select
not to associate .acf files with an Adams 2020 FP1 product.
18. Select Next.
A dialog box appears indicating that the file permissions are being changed. If you do not have
sufficient administration privileges you need to contact the system administrator.
19. Select Next.
If you do not have the Visual Studio Redistributable Package installed, the installer begins the
installation of the following packages:
• Microsoft VC++ 2010 x64 redist – 10.0.30319
• Microsoft VC++ 2012 x64 redist – 11.0.61030.0
• Microsoft VC++ 2013 x64 redist – 12.0.21005.1
• Microsoft VC++ 2015 x64 redist – 14.0.23026.0
• Microsoft VC++ 2017 x64 redist – 14.12.25810
62 Adams 2020 FP1 Installation and Operations Guide
Overview
20. To view the readme file, select I would like to view the README file.
Note: You must install the Adams Extension for Easy5 to use the Adams Controls Thin Client.
64 Adams 2020 FP1 Installation and Operations Guide
Installing the Adams Extension for Easy5
To run Adams and Easy5 together, you must install the Adams extension into Easy5. To import models into
Adams that were exported from Easy5 (containing components from licensed Easy5 libraries), you must also
configure your computer so that Adams knows how to find your Easy5 license. The following procedures
explain how to do this.
1. Make sure that both Easy5 and Adams have been installed.
2. Make sure you have permission (that is, root ('superuser') privilege) to add and modify files in the
Easy5 installation directory.
3. Perform the following:
a. From the Start menu, point to Programs, point to EASY5 <version>, point to Shell, and then
select Easy5 Command Shell.
b. At the prompt within the command shell type:
install_adams_controls.bat <Adams_topdir> <Easy5_topdir>
where: <Adams_topdir> is the top-level directory for Adams, also provided by "adams2020_1 -
top"; <Easy5_topdir> is the top-level directory of Easy5 (for example, C:\Program
Files\MSC.Software\Adams\2020_1,
C:\Program Files\MSC.Software\EASY5\2017.1, respectively).
Note: If you are unable to identify a command line command to run Adams but you can
identify the top-level directory of the Adams installation, you can use -d “directory
path” in place of the command line command.
To configure your computer to run licensed exported Easy5 models within Adams:
1. Start Easy5.
2. From the File menu, select Open Command Shell.
CHAPTER 5 65
Installing Adams on Windows
where:
• C: is the location of your adams_2020_1_windows64.exe file
• f1 is a lower-case f and the number 1
• c:\temp\mysetup.iss is the location and name of the batch setup file
3. Select OK.
4. Follow the installation instructions in the section, Installing Adams, 52.
The batch installation file (.iss) is created.
where:
• C: is the location of your adams_2020_1_windows64.exe file
• f1 is a lower-case f and the number 1
• c:\temp\mysetup.iss is the location and name of the batch setup file.
68 Adams 2020 FP1 Installation and Operations Guide
Installing Adams in Silent Mode (Batch)
[InstallShield Silent]
Version=v7.00
File=Response File
[File Transfer]
OverwrittenReadOnly=NoToAll
[{D6D7D44A-7056-4EAF-9B63-2691B41583DA}-DlgOrder]
Dlg0={D6D7D44A-7056-4EAF-9B63-2691B41583DA}-SdWelcome-0
Count=10
Dlg1={D6D7D44A-7056-4EAF-9B63-2691B41583DA}-SdCustomerInfo-0
Dlg2={D6D7D44A-7056-4EAF-9B63-2691B41583DA}-MSC_SetupType3-0
Dlg3={D6D7D44A-7056-4EAF-9B63-2691B41583DA}-SdStartCopy-0
Dlg4={D6D7D44A-7056-4EAF-9B63-2691B41583DA}-MSC_License-0
Dlg5={D6D7D44A-7056-4EAF-9B63-2691B41583DA}-AskOptions-0
Dlg6={D6D7D44A-7056-4EAF-9B63-2691B41583DA}-AskOptions-1
Dlg7={D6D7D44A-7056-4EAF-9B63-2691B41583DA}-AskOptions-2
Dlg8={D6D7D44A-7056-4EAF-9B63-2691B41583DA}-AskOptions-3
Dlg9={D6D7D44A-7056-4EAF-9B63-2691B41583DA}-SdFinish-0
[{D6D7D44A-7056-4EAF-9B63-2691B41583DA}-SdWelcome-0]
Result=1
[{D6D7D44A-7056-4EAF-9B63-2691B41583DA}-SdCustomerInfo-0]
szName=buildadm
szCompany=MSC Software Corporation
nvUser=1
Result=1
[{D6D7D44A-7056-4EAF-9B63-2691B41583DA}-MSC_SetupType3-0]
szDir=C:\Program Files\MSC.Software\Adams\2020_1 Installation
Result=301 Directory
SetupType=501
SetupName=Full
[{D6D7D44A-7056-4EAF-9B63-2691B41583DA}-SdStartCopy-0]
Result=1
[Application]
Name=Adams
Version=18.1.0
Company=MSC Software Corporation
Lang=0009
[{D6D7D44A-7056-4EAF-9B63-2691B41583DA}-MSC_License-0]
szEdit1=27500@yoda License server
Result=1
[{D6D7D44A-7056-4EAF-9B63-2691B41583DA}-AskOptions-0]
Result=1
Sel-0=1
Sel-1=0
[{D6D7D44A-7056-4EAF-9B63-2691B41583DA}-AskOptions-1]
Result=1
Sel-0=1
Sel-1=1
Sel-2=1
6 Licensing on Windows
Overview
Licensing Basics
Specifying your License
Replacing Codes (Licenses) on an Existing Windows Server
Customizing End-User License Administration
70 Adams 2020 FP1 Installation and Operations Guide
Overview
Overview
Adams products use a license server to manage the access to its products. Therefore, before you can run the
products you just installed, you must license them. The next sections explain more about Adams licensing,
the initial licensing options, and how you can manage the licensing after you’ve initially licensed the products.
Licensing Basics, 71
Specifying your License, 72
Replacing Codes (Licenses) on an Existing Windows Server, 73
Customizing End-User License Administration, 74
CHAPTER 6 71
Licensing on Windows
Licensing Basics
You can license Adams products in the following ways:
Set up a license server that is available to your users through the network, and set up the number of
users who can use Adams. The number of users who can run Adams concurrently depends on the
number of licenses you purchased. Refer to your password certificate for information on the number
of users who can run Adams.
You can run the license server on one machine or on three. We strongly recommend that you use a
one-server configuration, however. If you select a three-server configuration, the machines act as
backups to the other machines. You must install passwords on all of the server machines to set up a
three-server configuration.
You can select to load only the licensing tools on the license server and install the Adams products
only on the clients.
You also can set up the licensing so that it is locked to a particular machine or node. If your Adams
licensing is node-locked, then users can only run Adams products on that machine. To see if you
have purchased node-locked licensing, refer to your password certificate.
Set up a client using an existing license server.
In both cases, the procedure for licensing Adams is the same.
72 Adams 2020 FP1 Installation and Operations Guide
Specifying your License
27500@hostname
If you do not know the name of the host, enter the command hostname at a command prompt. Or, you can
refer to the SERVER line of your password certificate/license file.
Starting Adams Products
Setting Preferences
Setting Your Working Directory
Using Distributed Computing for Nonlinear Adams Flex Bodies
High Performance Computing Considerations
76 Adams 2020 FP1 Installation and Operations Guide
Starting Adams Products
Note: We recommend that you use the Adams Toolbar to start your Adams products, but
if you want to automate certain operations, use the text-based Program Menu. For
more information, see the Running and Configuring online help.
Tip: Select the corresponding desktop icon for the product, if you installed it on your
desktop.
An alternative is to add the /bin directory under the Adams installation directory to your user
PATH environment variable. You can do this via the Control Panel:
a. Type environment in the Control Panel search box.
b. Select the Edit environment variables for your account pick.
78 Adams 2020 FP1 Installation and Operations Guide
Starting Adams Products
Check to see if you already have a PATH variable defined under “User variables”. If it exists then
edit it, add a semicolon “;” to the end of the existing value, and then add the “bin” directory under
the Adams installation directory. Otherwise select New..., use PATH for the variable name and add
the “bin” directory under the Adams installation directory as the value. The default location of this
directory is:
Win64 Adams:
C:\Program Files\MSC.Software\Adams\2020_1\bin
Once you are done click OK.
Note: Windows appends your User PATH to the System PATH environment variable, so there is
no need to copy the existing System PATH variable to your user PATH variable. This
behavior is unique to the User PATH variable. For all other environment variables, a User
variables definition overrides a System Variables definition.
CHAPTER 7 79
Running Adams Products
Setting Preferences
This section describes how you can set preferences, such as your working directory, graphics setting, and
memory model size.
Overview
When constructing a model containing nonlinear flexible bodies using Adams MaxFlex the model can be
configure to distribute the computing effort across multiple hosts by specifying Compute Resource
hostnames for the nonlinear flex bodies. A prerequisite for a simulation utilizing Compute Resource hosts is
that those hosts have been properly configured.
Before an Adams simulation is able to utilize distributed computing some network daemons must be started.
On a host on the local network a process called a Directory Service Server needs to be running. In addition,
a process called a Starter Daemon needs to be running on each compute host. When needed the Starter
Daemon process on a compute host will start one or more NLFE services. The figure below shows a diagram
of the relationship between Adams Solver, the network daemons, and the NLFE service.
Figure 7-4 Adams Solver, Network Deamons and NLFE service links
The Directory Service runs in a thread inside client kernel and is listening. This functions as a broker between
the Adams Solver process and the Starter Daemon on an external host. The Starter Daemon registers itself
with the Directory Service when it starts. The Directory Service keeps a list of registered hosts along with
their credentials. Later when Solver is connecting to an external host it starts by contacting the Directory
Service to obtain the host's credentials. The Directory Service runs automatically when required.
The Starter Daemon is a process that, when requested, starts up instances of services installed on a remote
host. Adams utilizes the Starter Daemon to start the NLFE service when required. A running Starter Daemon
is needed on each host that an Adams model utilizes. Only one Starter Daemon should be run on any given
host.
CHAPTER 7 83
Running Adams Products
%: adams<version> -clientmanager
Where, <version> is replaced with the actual string of the version of Adams installation, that is, 2020_1.
CHAPTER 7 85
Running Adams Products
Figure 7-7 NLFE Client Manager: Start and Stop Starter Daemon
86 Adams 2020 FP1 Installation and Operations Guide
Using Distributed Computing for Nonlinear Adams Flex Bodies
Add a colon (":") between the machine name and the Port Number as shown above.
CHAPTER 7 87
Running Adams Products
Overview
Setting Up the Client Machine
Updating Passwords
90 Adams 2020 FP1 Installation and Operations Guide
Overview
Overview
This chapter describes some basic administration and configuration operations you might want to perform
after you install the Adams products, and others that you might need to perform periodically as you obtain
new passwords. These operations include the following:
Setting Up the Client Machine, 91
Updating Passwords, 92
CHAPTER 8 91
Linux Administration and Configuration
Updating Passwords
If you receive new passwords from MSC Software, follow the instructions below to update your passwords.
If you receive new software along with the passwords, you should follow the complete installation instructions
in Installing Adams on Linux, 19
Note: If the license server started with root, you must be root to stop and start it.
Note: If you do not have an lmreread executable, copy lmdown and name it lmreread
You should now be able to run Adams products using the new licenses. If this fails, kill and restart the
daemons as follows:
# flexlm_install_dir/lmdown -c <path>/license.dat
# flexlm_install_dir/lmgrd -c <path>/license.dat
94 Adams 2020 FP1 Installation and Operations Guide
Updating Passwords
MSC Nastran Implicit Nonlinear (SOL 600) User’s GuideAdams 2020 FP1 Installation and
Operations Guide
Chapter 9: Troubleshooting
9 Troubleshooting
Overview
Troubleshooting on Windows
Troubleshooting on Linux
96 Adams 2020 FP1 Installation and Operations Guide
Overview
Overview
This chapter describes how to generate problem reports to send to Adams Technical Support. It also lists some
common problems that can occur when installing, updating, and running Adams software, and recommends
solutions to those problems.
Troubleshooting on Windows, 97
Troubleshooting on Linux, 100
If you do not find your problem in this chapter or if the recommended solution does not solve your problem,
then:
Refer to the Adams Technical Articles at http://simcompanion.mscsoftware.com
Contact Adams Technical Support as explained in Getting Help, 7.
CHAPTER 9 97
Troubleshooting
Troubleshooting on Windows
Note: For correct results, you must run the problem report from the license server, not the client
machine.
The actions, when run for the first time in a given installation of Adams, known to MSC to trigger this alert
are:
Launch of Adams View or Adams View based products like Adams Car and Adams Driveline;
Windows security alert will reference "aview"
Creation of linear (modal) flexible body via Adams ViewFlex; Windows security alert will reference
"remotebootstrap.exe"
Creation of a nonlinear flexible body via import of a BDF; Windows security alert will reference
"remotebootstrap.exe"
Execution of a co-simulation via the Adams Co-simulation Interface (ACSI); Windows security alert
will reference "ACSI_Gui.exe"
To fix this permanently, click Allow access. This will add the particular Adams component (for example,
"aview" or "remotebootstrap.exe") to the Windows Firewall Allowed Program list and this dialog will no
longer display for the given version of Adams installed on the machine. Note that you need an Administrator
access to make this change.
To manage the Windows Firewall on your machine go to Control Panel → Windows Firewall.
CHAPTER 9 99
Troubleshooting
Troubleshooting on Linux
Note: For accurate results, you must run the problem report from the license server, not the
client machine.
Check hostid on the system - Returns the hardware identification number from the system that is
used for Adams licensing. This identification number is also included in the problem report.
that the number of sockets and process file descriptors limitations for your system is adequate to handle all
of the licenses. See your operating system’s documentation for the maximum number of file descriptors
available on the system designated as your Adams license server.
The license server writes a debug log file as it runs. It writes an entry for each license request and return. If
the file becomes too large, you can edit the log file periodically.
The Adams license daemons send small amounts of data across the network. Each license transaction requires
approximately 1 KB of data. If there are a lot of transactions (in the hundreds), the network bandwidth use
can become significant. If this happens, you should consider keeping the license server on the same local area
network as the one being used for the Adams products.
Linux Installation
10 Roadmaps
Overview
File Server, License Server, and Client - Same Machine
File Server and License Server - Same Machine, Client - Different Machine
File Server and Client - Same Machine, License Server - Different Machine
File Server, License Server, and Client - Different Machines
File Server - Different Machine, License Server and Client - Same Machine
Different Linux Platforms - Heterogeneous Network
104 Adams 2020 FP1 Installation and Operations Guide
Overview
Overview
This appendix describes the overall steps or roadmaps that you perform to install Adams products depending
on your network configuration. Use these roadmaps to guide your installation. For complete installation and
licensing instructions, see Installing Adams on Linux for more information. The roadmaps are:
File Server, License Server, and Client - Same Machine, 105
File Server and License Server - Same Machine, Client - Different Machine, 106
File Server and Client - Same Machine, License Server - Different Machine, 107
File Server, License Server, and Client - Different Machines, 108
File Server - Different Machine, License Server and Client - Same Machine, 109
Different Linux Platforms - Heterogeneous Network, 110
For assistance in determining which roadmap to follow, see Table 10-1. It lists the seven types of configurations
and the page that contains the roadmap for performing installation and licensing for that type of
configuration. If your configuration is not in the table, review the options in each chapter and choose the
ones that best fit your needs.
Table 10-6 Roadmap When License Server and Client are the Same Machine
Do the following: For more information, see the section:
1. Log on to the central NFS server. --
2. Create an installation directory. Creating the Installation Directory, 24
3. Install Adams. Installing Adams, 25
4. Exit from the installation program. --
5. Log on to license server and client. --
6. Mount Adams installation directory from --
file server on license server system
through NFS.
7. Create a directory for Adams on this Creating the Installation Directory, 24
machine.
8. Install Adams Installing Adams, 25
9. Install network passwords. Licensing Adams When File and License Server Are Different
Systems, 45
10. Start the license server. Starting the Adams License Server, 46
11. Modify system startup procedures so they Restarting the Adams License Daemons, 47
include the restarting of the Adams
license manager.
12. Generate a troubleshooting report to Verifying a Successful License, 49
verify that all products and files were
properly installed.
110 Adams 2020 FP1 Installation and Operations Guide
Different Linux Platforms - Heterogeneous Network
Overview
Installing Adams Drill on Windows
Installing Adams Drill on Linux
Launching Adams Drill
112 Adams 2020 FP1 Installation and Operations Guide
Overview
Overview
Adams Drill is an industry application specific vertical product. Adams Drill is packaged in a separate installer
file found alongside the general Adams installers on either the MSC Solutions Download Center (SDC)
website or the Adams DVD.
2. If you select "English" the welcome agreement window will appear as shown below.
3. If you select "Japanese" the welcome agreement window will appear as shown below.
4. Select Acknowledged > button to continue, or Cancel button to exit without installing.
Note: To re-select the language, click Cancel button to exit and restart the installation.
116 Adams 2020 FP1 Installation and Operations Guide
Installing Adams Drill on Windows
5. In the Customer Information window, enter your user and company name, and then select one of the
following:
• Anyone who uses this computer (all users) - Anyone logged on to this machine can run Adams
Drill 2020 FP1.
• Only for me - A user must be logged on using the user name and password that was used at the
time of installation.
Important: Be sure to select the same option here for "Install this application for:" that was selected
when installing the pre-requisite, general Adams 2020 FP1 software.
CHAPTER 11 117
Installing Adams Drill
Note: The Adams Drill Windows installer will automatically set the Target Directory to the
directory which was selected when installing the pre-requisite, general Adams 2020
FP1 software.
7. Confirm the installation settings and then select Next to begin the installation.
118 Adams 2020 FP1 Installation and Operations Guide
Installing Adams Drill on Windows
8. Specify whether or not you want to install the Adams Drill 2020 FP1 desktop icons. If you select Yes
the desktop icon will be created and if you select No the desktop icon will not be created.
9. On the final “Installed Wizard Complete” page, to view the readme file, select I would like to view
the README file.
5. Select Acknowledged > button to continue, or Cancel button to exit without installing.
CHAPTER 11 121
Installing Adams Drill
6. Select the full path to the directory you want to install Adams Drill 2020 FP1. You can type in the
directory path after selecting the Browse button, or use the directory tree to locate the installation
directory.
Important: On Linux platforms, Installation wizard does not automatically detect and select
Adams 2020 FP1 Software destination folder and one must specify the path where the
pre-requisite, general Adams 2020 FP1 software is installed.
122 Adams 2020 FP1 Installation and Operations Guide
Installing Adams Drill on Linux
7. Selecting the Next > button to continue will move you to "Selected Destination Folder Already
Exist". This will show the path of the pre-requisite, general Adams 2020 FP1 software's installation
which is already installed.
8. Select the Next > button and move to "Start Copying Files"
9. Select the Next > button to confirm your installation selection. A progress dialog box will be
displayed. You can select the Cancel button at any time to stop the installation.
124 Adams 2020 FP1 Installation and Operations Guide
Installing Adams Drill on Linux
10. After installation is completed the "InstallJammer Wizard Complete" page will appear
11. A summary dialog box announces the completion of the installation process. Selecting Finish will
complete the installation process.
CHAPTER 11 125
Installing Adams Drill
On Linux operating systems, Adams Drill simulation jobs can be launched remotely from within the Adams
Drill spreadsheet-based interface on Windows machines (see the Adams Drill documentation for details) or
locally on the Linux machine via running Adams Solver standalone from the command line against an .acf
file (and referenced files) generated by the Adams Drill spreadsheet-based interface on Windows machines.
See Running Adams Products for more details.
126 Adams 2020 FP1 Installation and Operations Guide
Launching Adams Drill