Installing CONVERGE on Linux

Top  Next

The CONVERGE 3.0 and 3.1 Linux packages include scripts and modulefiles that make it easy to install, run, and upgrade the CONVERGE solver, as detailed in the instructions below. In particular, note that you must run the INSTALL script every time you install CONVERGE 3.0 or 3.1 or upgrade to a new minor version (e.g., from 3.0.4 to 3.0.5). Unlike in CONVERGE 2.4 and earlier versions, you cannot simply copy the CONVERGE executable from the most recently downloaded package.

 

If you do not have root access privileges, you can install CONVERGE for a single user. If you are logged in as root, you can install CONVERGE for all users.

 

The first time you install and run CONVERGE 3.0 or 3.1, complete the following steps:

 

1.Unpack the distribution (Convergent_Science_Full_Package-<version>.tar.gz) in a temporary location.

2.Run the INSTALL script and specify the installation location.

3.Obtain a valid license.lic file.

4.Start the Reprise License Manager (RLM) license server.

A license server is necessary only if you will use a floating license. If you use a node-locked license, a license server is unnecessary.

5.Set up the CONVERGE environment either by loading a module or running a script.

6.Run the appropriate CONVERGE executable from your Case Directory.

 

Every time you upgrade to a new minor version, complete the following steps:

 

1.Unpack the distribution (Convergent_Science_Full_Package-<version>.tar.gz) in a temporary location.

2.Run the INSTALL script and specify the same installation location as your earlier minor version(s) of CONVERGE 3.0 or 3.1. Directories for the new minor version are installed parallel to the directories for the earlier version(s).

3.Set up the CONVERGE environment either by loading a module or running a script.

4.Run the appropriate CONVERGE executable from your Case Directory.

 

Unpacking and Installing CONVERGE

You can download a CONVERGE 3.0 or 3.1 installation package from the Convergent Science hub (https://hub.convergecfd.com/downloads). Note that you must log in to this website. The installation package is in a gzipped tar file named Convergent_Science_Full_Package-<version>.tar.gz.

 

Place the file in a temporary directory. Unzip the file and open the archive using the tar utility:

 

tar –xzvf Convergent_Science_Full_Package-<version>.tar.gz

 

This creates a directory called Convergent_Science_Full_Package-<version>, which contains the following three items:

 

The Convergent_Science directory

The INSTALL script

The README file

 

Run the INSTALL script (./INSTALL) to install the CONVERGE solver along with the MPI packages available with CONVERGE. If you do not have root access privileges, you can install CONVERGE for a single user. If you are logged in as root, you can install CONVERGE for all users.

 

You are not required to use one of the MPI packages that is included in the CONVERGE installation. You can use your own MPI implementation instead, as long as you are using a supported version of HPC-X, Intel MPI, MPICH, or Open MPI.

 

By default, CONVERGE is installed in the /opt/Convergent_Science/ directory. To install in a different directory, specify that directory when prompted.

 

After you run the INSTALL script, you can safely delete the contents of this temporary directory.