Appendix B: Frequently Asked Questions

<< Click to Display Table of Contents >>

Navigation:  »No topics above this level«

Appendix B: Frequently Asked Questions

The questions below pertain to the CONVERGE 5.x.x installation process. For a more general list of FAQs pertaining to internal combustion, physical modeling, and other topics, go to https://convergecfd.com/support/faqs.

 

If you need help resolving an issue, please email [email protected] (US), [email protected] (EU), or [email protected] (India).

 

Why is CONVERGE running slowly?

If you observe poor performance, we recommend checking your latency as a first step. CONVERGE prints the node-to-node latency to the screen and to mpi_latency.log at the start of a simulation. You can also run the check_system utility to check the latency without starting a simulation. Example commands:

 

CONVERGE 5.0.0: mpirun -np 16 converge-ompi -u check_system

 

CONVERGE does not check out a license when you run this utility.

 

For high-speed interconnects like InfiniBand and Omni-Path, we have seen latencies ranging from about 2 µs to 25 µs. These numbers are highly dependent on system configuration. If a high-speed interconnect is available for your system and your latency is higher than you expect, it is possible that the MPI library is not configured to use the high-speed interconnect. Work with your IT team to check your MPI setup.

 

Do I have to use one of the MPI packages that was installed with the CONVERGE 5.x.x solver?

No. We include MPI packages in the CONVERGE 5.x.x installer only for convenience. If your IT team has set up their own MPI package in a supported version, we recommend using that instead. To do so on Linux, load the module for your organization's MPI environment immediately after loading the CONVERGE module. To do so on Windows, prepend the path to your organization's MPI environment files to the Path environment variable.

 

Can I copy the CONVERGE executable from the installation package to a different directory (on Linux) without running the CONVERGE_CFD Bundle script?

No. To install CONVERGE 5.x.x on Linux, you must run the CONVERGE_CFD Bundle script.

 

In CONVERGE 5.x.x, you do not need to copy or link the CONVERGE executable to your Case Directory when you run a simulation. Instead, you set up your environment so that the executable can be run from any directory.

 

I've already installed CONVERGE 5.x.y. How do I upgrade to CONVERGE 5.x.z?

Download the installation package for the new version and run the CONVERGE_CFD Bundle script (Linux) or the .exe installer (Windows). The directories for the new version (e.g., 5.0.0) are installed parallel to the directories for the old version (e.g., 5.0.1).

 

Where can I download the training materials?

You can download training materials from https://hub.convergecfd.com/downloads/category/60-training_matrials. Additionally, you can watch prepared training videos available at https://hub.convergecfd.com/converge-r-training-videos. Note that a valid login is required to access the training materials and videos. In addition to these training materials, numerous example cases and case setups are included within CONVERGE Studio. These can be accessed by going to File > Load Example Case option.

 

Which drawing software and CAD formats are compatible with CONVERGE Studio?

You may use any CAD software with CONVERGE Studio. Additionally, CONVERGE Studio can import most native CAD formats. A detailed list of the compatible CAD formats can be found in <Studio_Install_path/doc/SpatialFileFormat.pdf>.

 

What should I do if CONVERGE experiences an error while downloading the CONVERGE installation files, especially at the conclusion of the download process?

The error may stem from slow internet connection. You should wait and attempt to download the files again later, or consider using a different browser.

 

What should I do if CONVERGE outputs an error message saying: "missing file api-ms-win-core-path-l1-1-0.dill. Try to reinstall the software"?

i.We advise that you verify the compatibility of your operating system with the CONVERGE Studio/solver versions being used.

ii.We recommend uninstalling both CONVERGE Studio and the CONVERGE solver components, and then reinstalling only CONVERGE Studio. If you are able to successfully install CONVERGE Studio, then install the CONVERGE solver and verify that both CONVERGE Studio and the CONVERGE solver were installed correctly.

 

What does the Polygonica error message "License server does not support this product" mean?

This message means that access to Polygonica is denied because Polygonica requires a separate license. Contact your sales representative to request a quote.

 

How should I resolve the error message: "FATAL ERROR: cannot open file stream_settings.in"?

Make sure the input files and CONVERGE version being used are compatible. Check if the directory is accessible to the solver. Try to restart the simulation.

 

How can I restrict the usage of certain CONVERGE features to specific users?

CONVERGE usage can be restricted to specific users or hosts by setting the options in csci.opt file. Detailed information can be found in the the RLM Options File section of the RLM administration guide located at https://www.reprisesoftware.com/RLM_License_Administration.pdf.

 

How can I reclaim an idle or stale license?

You can specify a TIMEOUT value in the csci.opt file for any idle license. If the license remains idle (i.e., does not communicate with the license server) for this amount of time, the license server performs an automatic check-in of the license and informs the application (if it is still running). The default value of the RLM timeout is 3600 seconds (1 hour).

 

How can I restrict the CONVERGE feature access of a particular license type?

Create a csci.opt file and specify in the INCLUDE line the user, host, group, or internet_group you want to restrict from accessing a specific CONVERGE feature. Then, for each product (e.g., converge_gui, converge_super), include the following instructions: EXCLUDE converge_gui user 1 (applies to license with id=1) (assuming the commercial license has id=1). Refer to the RLM User Manual at https://www.reprisesoftware.com/RLM_License_Administration.pdf for more information.

 

How do I create different types or groups of users for license accessing in RLM?

To create groups of users, you must make a csci.opt file (ISV option file). An example is provided below:

 

GROUP group1 user1 user2 user3

GROUP group2 user4 user5 user6

 

Can a simulation reserve a license on the RLM server before it goes on a queue on the cluster?

Yes. The general procedure is to create an option file (csci.opt) wherein licenses can be reserved for specifc users, groups, hosts, etc. For instance:

i.A csci.opt file can be created with the following contents and placed in the RLM folder:

    RESERVE 10 converge_super user1

    This action reserves 10 CONVERGE solver licenses for the user user1.

ii.Another option involves creating a csci.opt file with the following contents and placing it in the RLM folder:

    GROUP group_name user1 user2...

    RESERVE 10 converge_super group_name

    This reserves 10 CONVERGE licenses for the group group_name.

This information can be found in the RLM administration guide: https://www.reprisesoftware.com/RLM_License_Administration.pdf.

 

How do I configure access limits for all groups and users across the csci tools?

You cannot specify access to various products across multiple groups at the same time. Instead you can use INCLUDEALL, MAX, and other commands on each group separately to specify the access each group has to various products. To use the INCLUDEALL function write: INCLUDEALL group group_name. To use the MAX command to specify usage limits for a particular group with a product write the command: MAX2 converge_gui group group_name. Alternatively, you may use the RESRVE option.

 

How do I define different user groups and assign CONVERGE resources for each group in RLM environment?

You can create a csci.opt file to define user groups and assign CONVERGE resources. You should include the following lines in the csci.opt file to define groups using the GROUP keyword, each with a specified number of users. Restrictions on license usage among these groups can be enforced by using the MAX keyword.

 

GROUP group1 user1 user2 user3

GROUP group2 user4 user5 user6

 

MAX2 converge_gui GROUP group1

MAX1 converge_gui GROUP group2

 

MAX2 converge_tecplot GROUP group1

MAX1 converge_tecplot GROUP group2

MAX2 converge_child GROUP group1

 

MAX2 converge GROUP group1

MAX1 converge GROUP group2

 

Alternatively, you can use the INCLUDE or RESERVE keywords. Refer to the RLM manual (https://www.reprisesoftware.com/RLM_License_Administration.pdf).

 

What are the different types of CONVERGE licenses available?

The following table contains a list of all available CONVERGE licenses.

 

Table 12: Available CONVERGE license types.

License Types

License Name(s)

Descriptions

CONVERGE

converge (Base)

converge_child (Parallel)

One parent license is checked out for each job

For a parallel job on N processors, N-1 child licenses are checked out

converge_super

For a parallel job, one converge_super license is checked out (no child licenses)

Allows for an infinite number of cores per job (Any number of processor cores)

CONVERGE Studio

converge_gui (Pre-processor)

One license is checked out for each instance of CONVERGE Studio.

converge_polygonica (Advanced repairing)

One license is checked out for each instance of CONVERGE Studio

Allows use of Polygonica geometry preparation tools in CONVERGE Studio

Academic

converge

converge_child

converge_gui

Academic pricing is available for eligible institutions.

Trial

Varies

Negotiated upon request.

Tecplot for CONVERGE

Tecplot

Tecplot for CONVERGE is included with all installations. It does not check out a license at runtime.

2 weeks license

 

Client creates the license after gaining access to the Convergent Science hub. The license is valid for 2 weeks.

Explore

 

This license is restricted to one node, 8 cores, and 500,000 cells, and it cannot be used for proprietary or commercial purposes.