RAM | STAAD | ADINA - ADINA Installation & Licensing for Linux

ADINA CONNECT Edition version 9.10 and later uses Bentley Subscription Entitlement Service (SES) to authenticate user entitlements for the software. For more on this see Entitlement Management Overview.

Each CONNECTED User should be added by the account administrator prior to running the software. See CONNECTED User - Administrator Process.

On Linux systems, the installation and initial entitlement requires a few extra steps documented below. The following instructions were originally created for version 9.10 but have been revised for version 2024. Refer to prior versions of this wiki for prior version installation details.

Multiple versions can be installed side-by-side, but that requires the use of multiple directories.

Installation

Obtain the installation files from Software Downloads.

Be sure to select the ADINA Linux 2024 (SES) and confirm the System Requirements = Linux

In this tutorial, we assume that the username is represented by $username$. The Linux installation file name is "ADINA-24.00.0.547.run".

We will also assume that you are installing ADINA so that it can be used by all users on the Linux computer. Therefore ADINA will be installed into the /opt directory using sudo.

1) Download the ADINA Linux version installation file into the default location, /home/$username$/Downloads.

2) Open a terminal. For example, in Ubuntu Linux, right-click on the screen and select "Open in Terminal". All subsequent steps of the installation will be performed in this terminal.

3) Change the directory to the download folder:
cd /home/$username$/Downloads

4) Enable execute permission for the installation file:
chmod +x ADINA-24.00.0.547.run

5) Select the directory in which to install the ADINA System. This directory will be referred to as the "ADINA home directory". In this tutorial, we use /opt/adina24 as the home directory.

6) Create the above directory if it does not exist and change the working directory to the ADINA home directory:
cd /opt
sudo mkdir adina24
cd adina24

7) Move the installation file from download folder to the ADINA home directory:
sudo mv /home/$username$/Downloads/ADINA-24.00.0.547.run .

8) Start the installation:
sudo ./ADINA-24.00.0.547.run

9) The ADINA installation script performs the following steps:

9.1) Displays the End User License Agreement for Bentley Software. Use the spacebar to display the agreement, then type y to accept.

9.2) Uncompresses the ADINA 24.00.0.547 software package.

9.3) Displays the computer hostname. The computer hostname must be set in order to check out licenses. If the computer hostname is not set, or if the hostname contains the string "localhost", the installation script continues with a warning message.

9.4) Displays the Linux version information. If the Linux version is not recent enough, the installation script terminates with an error message.

9.5) Checks for Firefox. Firefox is required for ADINA licensing. If Firefox is not installed, the ADINA installation script aborts.

9.6) Checks for OpenSSL version 1.1 (libssl.so.1.1). OpenSSL version 1.1 is required for ADINA licensing. If OpenSSL 1.1 is not installed, the ADINA installation script aborts. (The instructions for installing OpenSSL 1.1 depend on which Linux distribution is used. If the Linux distribution is CentOS or Ubuntu, the ADINA installation script displays the instructions, otherwise the ADINA installation script does not display the instructions.) Warning: the most recent Linux distributions do not include OpenSSL 1.1 by default.

9.7) Checks for the following libraries: libbz2.so.1, libEGL.so.1,libGLU.so.1. These libraries are required by the AUI. If these libraries are not installed, the ADINA installation script aborts.

9.8) Checks for the following xcb shared libraries: libxcb-icccm.so.4, libxcb-image.so.0, libxcb-keysyms.so.1, libxcb-render-util.so.0, libxcb-shape.so.0, libxkbcommon-x11.so.0. These libraries might be used by ADINA licensing. If any of these libraries are not installed, the ADINA installation script gives a warning message.

9.9) Checks for ffmpeg. ffmpeg is used for by the AUI graphics to create movies using the Save MPEG icon. If ffmpeg is not installed, the ADINA installation script gives a warning message.

9.10) Creates symbolic links adadp24.00, adina24.00, ai24.00, aui24.00. These scripts are used to run ADINA, see below.

9.11) If the PDF file reader evince is not installed, asks if you want to specify a pdf file reader. The pdf file reader is required to display the ADINA manuals within AUI online help. You need not specify a pdf file reader if you don't need to display the ADINA manuals within AUI online help. Some pdf readers no longer support linked pdfs. In that case you will have to navigate between he manuals manually using the files in the ADINA\docs directory.

10) If the ADINA installation script fails because a component is missing, you need to install the missing component.
The instructions for installing missing components is Linux distribution-dependent. For example, on Ubuntu/Debian Linux computers, you will likely use the apt or dpkg package managers, on Red Hat/CentOS/Fedora Linux computers, you will likely use the yum package manager, on SuSE Linux computers, you will likely use the zypper package manager. The ADINA installation script gives some basic guidelines for installing libssl.so.1.1, but does not give instructions for installing the other components.

11) If the ADINA installation script runs successfully, the ADINA installation script displays the following messages:

--------------------------- PROGRAM SCRIPTS ---------------------------
The following program scripts are used to run the ADINA programs.

aui23.00 : ADINA User Interface (AUI) pre- and post-processing program.
adina23.00 : Any ADINA solution program in command mode.
ai23.00 : Any ADINA solution program in interactive mode.
adadp23.00 : Run CFD/FSI problems with adaptive meshing.

The program scripts are located in the directory /opt/adina23/ADINA/bin
It is recommended that you include the above directory in your PATH.
-----------------------------------------------------------------------

12) One way to add the directory containing the ADINA program scripts to your PATH environment variable is as follows:
PATH=$PATH:/opt/adina24/ADINA/bin

You can include this line in the /etc/profile startup script. Then whenever a user logs in, this line is executed and the directory containing the ADINA program scripts are added to the PATH environment variable.

You can verify that the PATH environment variable is set up correctly with the command:
printenv PATH

13) Once the PATH variable is set up correctly, you can change directory to any directory, then invoke the AUI with the command:
aui24.00

Running the First Time

There are three ways to invoke aui24.00. Each way involves navigating to a directory in which you have write privileges. Call this directory the "working directory". It is assumed below that you have already navigated to the working directory.

1) If the PATH variable does not include the directory containing the ADINA scripts, then type

/opt/adina24/ADINA/aui24.00

The absolute pathname is required here. Substitute the actual absolute pathname if ADINA is not installed in /opt/adina24.

2) If the PATH variable includes the directory containing the ADINA scripts, simply type

aui24.00

3) A third alternative is to copy the script aui24.00 from ./bin/ADINA to the working directory, then type

./aui24.00

The other *24.00 scripts can also be copied.

Next, the ADINA Licensing Configuration dialog will be presented:

Select the appropriate ADINA Edition and if using the optional ADINA Parasolid Modeler also check that option. We recommend Showing the Welcome Screen on Startup for at least the first few times. It is important for selecting different ADINA Editions or the optional ADINA Parasolid Modeler (also known as ADINA-M/PS).

Click OK.

This will launch a Firefox browser window where the user will need to Choose an Account and sign in using the Bentley CONNECTED User email address and password.

Note, we use two-factor authentication so there may be an additional requirement to enter a code via text message.

Once the sign in is complete a second browser window or tab will appear indicating "Callback received. Feel free to close this page."

And the program should launch.

These same steps are also required when changing machines.

Checking out a License

It is not generally required to check out a License with ADINA.

If the system is offline for more than 7 days the ADINA program can still function, but a license file must be copied to the machine and imported.

For general instructions for the Administrator to check out a license refer to: https://bentleysystems.service-now.com/community?id=kb_article_view&sysparm_article=KB0019064 The administrator will need a machine with internet access in order to reach the CONNECT Center - Entitlement Management - License Checkout portal.

When generating a license file the Administrator needs to enter the the intended user email address, the machine host name, and the duration of the checkout. A single ".belic" license file can include both an ADINA Edition License and an ADINA Parasolid Modeler license or 2 .belic files can be used. The screen should look like the image below:

Once complete the generated .belic file must be put in a location that the offline Linux machine can access (shared drive, disk, thumb drive etc.).

Note, in versions 9.10 and 23.00 the machine host name for a checked-out license cannot have a period "." in the name. This limitation was removed with the 2023 Minor Update 1 (23.00.01.16).

From the ADINA/bin directory on the Linux machine execute license24.00

In the resulting dialog select Checkout License and then navigate to the saved .belic file.

And click OK.

Conversely, a checked out license can be checked in early by selecting Checkin License, but for offline machines the license must be also be checked in through the CONNECT Center - Entitlement Management - License Checkout portal using the green arrow tool.

Possible Errors

During installation, if the Linux distribution is too old, or if the system is missing certain component .dll files you may receive warnings in the terminal window. The ADINA installation requires a Linux distro built on the Linux kernel 5.4 or higher.
The Linux computer must have Firefox and libssl.so.1.1 installed, otherwise the Linux installation will abort. Firefox and libssl.so.1.1 are used for Linux licensing.
If the product is installed to a directory to which the user does not have sufficient rights, the error "Internal Error: DBNEWD: Open of temporary database file failed" may occur when you try to start the AUI. If this happens, terminate the process and reinstall the program in a folder with full rights.
The ADINA program comes with a 7 day trial period. After that trial period, if you try to open any ADINA edition without a valid entitlement you will get an error indicating that aui failed to start the selected license, and the product will shutdown.

This can also happen if the user takes over 2 minutes to sign in.

ADINA Installation & Licensing for Linux

Installation

Running the First Time

Checking out a License

Possible Errors

See Also