CONVERGE Studio Troubleshooting Tips

The following notes help you troubleshoot problems you may encounter when installing and running CONVERGE Studio. Unless otherwise specified, this information applies to CONVERGE Studio versions 2.3 and 2.4 on Linux and Windows operating systems.

 

For Linux systems, if CONVERGE Studio crashes immediately after launch, use the qtconfig or qtconfig-qt4 command to update the GUI style for rendering Qt applications under Appearance and then click File > Save. We recommend Cleanlooks or Plastique.

 

InstallationNote-Qtconfig

Figure 2: The Qt Configuration > Appearance tab on a Linux system.

 

For Windows systems, if you have an unwanted clipping plane and if all edges are rendered in the boundary fence color, the solution is as follows.

 

1.Open the NVIDIA Control Panel.

2.In Manage 3D Settings > Global Settings or Program Settings:

For a desktop GeForce GPU, turn off Shader Cache.

For a workstation Quadro GPU, turn off Threading Optimization.

 

InstallationNote-NVIDIAcontrol

Figure 3: The NVIDIA Control Panel > Manage 3D Settings > Program Settings tab on a Windows system.

 

3.Run CONVERGE Studio with the -n command line option. Check the CONVERGE Studio Message log to verify that CONVERGE Studio is using the OpenGL rendering method.

 

For both Linux and Windows systems, to use the boundary animation feature and to enable faster rendering, you must have a discrete GPU from NVIDIA or AMD. For Windows only, create a shortcut to CONVERGE_Studio.exe, right-click it, then select Properties. In the Target field, the path to the program will be listed as "*.exe" (note the quotation marks at the beginning and end of the path are necessary to define the full path name). After the terminating quotation marks, append [space]-n to the Target field (i.e., the Target field will appear as "*.exe" -n). Note the space character between the closing quotation mark and the -n. If your hardware meets our requirements and if the device driver works correctly, you can verify that fast rendering is activated by checking the CONVERGE Studio Message log. You should see the following messages. The OpenGL line will indicate which rendering method you are using:

 

--------------------------------------------------------------------------------

CONVERGE Studio v2.x Jan 14 2016 14:56:06

CONVERGE Studio uses QT 4.8.X

--------------------------------------------------------------------------------

Set the log file to: '/tmp/CONVERGE_Studio.log'

--------------------------------------------------------------------------------

OpenGL: using GLSL to render triangles, edges and normals (the fastest method).

--------------------------------------------------------------------------------

 

If CONVERGE Studio is using the old rendering, you will see the following message:

 

--------------------------------------------------------------------------------

CONVERGE Studio v2.x Jan 14 2016 14:56:06

CONVERGE Studio uses QT 4.8.X

--------------------------------------------------------------------------------

Set the log file to: '/tmp/CONVERGE_Studio.log'

--------------------------------------------------------------------------------

OpenGL: using old rendering methods (deprecated GL calls).

--------------------------------------------------------------------------------

 

In Linux, CONVERGE Studio defaults to fast rendering. If your machine does not meet the hardware requirement, CONVERGE Studio will use the old rendering. To force CONVERGE Studio to use the old rendering, use the -o command line option.

 

You may see the warning "missing libicui18n dynamic library" when launching CONVERGE Studio on RedHat (CentOS) 7.x. However, this warning should not affect the functionality of CONVERGE Studio.

 

Compared to CONVERGE Studio 2.3, CONVERGE Studio 2.4 has additional required dependencies. In Windows, after launching the CONVERGE Studio 2.4 *.msi installer package, a dialog box prompts you to install the additional dependencies (e.g., Microsoft Visual C++ 2015 Redistributable). This dialog box may open behind the CONVERGE Studio 2.4 installation dialog box. Therefore, the installation appears to freeze. You can open the Microsoft Visual C++ 2015 Redistributable installation dialog box by clicking the corresponding icon on the task bar.

 

The CONVERGE Studio 2.4 Windows installer packages no longer overwrite an existing license.lic file. Additionally, uninstalling CONVERGE Studio 2.4 will not remove an existing license.lic file.

 

Many newer Linux operating systems upgrade to gstreamer 1.0 instead of 0.1, which is the required version for CONVERGE Studio. It is much easier to install gstreamer 0.1 on newer systems compared to installing gstreamer 1.0 on older systems. If your system does not install gstreamer 0.1 by default, you can manually install it.

oFor OpenSUSE, you can find rpm packages from https://software.opensuse.org/package/libgstreamer-0_10-0

oFor Ubuntu 18.10, use the following steps

wget http://fr.archive.ubuntu.com/ubuntu/pool/main/g/gst-plugins-base0.10/libgstreamer-plugins-base0.10-0_0.10.36-1_amd64.deb

wget http://fr.archive.ubuntu.com/ubuntu/pool/universe/g/gstreamer0.10/libgstreamer0.10-0_0.10.36-1.5ubuntu1_amd64.deb

sudo dpkg -i libgstreamer*.deb

 

Please ask your IT department to install gstreamer 0.1 or use an older Linux system, which provides it by default.