Vulkan is a low-level graphics API used to program the GPU to perform graphics rendering and other tasks. It is a modern, high-performance replacement of the legacy OpenGL API. It is supported by all desktop and mobile GPU vendors, and support is included in all recent graphics drivers, although you may need to install the small Vulkan API loader manually.
OmniSci Release 5.8 officially enables the new Vulkan backend renderer as the default, replacing the OpenGL renderer. Releases before 5.8 use OpenGL. The new Vulkan renderer was first made available as Beta functionality in Release 5.7.
For Release 5.7 and up, a Vulkan API loader library is required to be installed regardless of which renderer you use. See the Troubleshooting guide below for details on how to install the Vulkan API loader.
Vulkan provides the following improvements over OpenGL in the backend renderer:
Vulkan is designed specifically for speed. The Vulkan renderer is often 2 times faster than OpenGL, and performance will improve in the future.
OpenGL does not provide direct access to GPU memory, making it difficult to manage memory utilization. Vulkan requires the application to manage GPU memory directly, and you can use the same memory for multiple, nonoverlapping tasks, which allows more work with less memory. Interaction with Cuda is more direct, because Cuda can reference and use the same memory as Vulkan with virtually no overhead.
Vulkan is more multi-thread friendly than OpenGL. It is designed to give the application far more control of task scheduling on the GPU. This will enable a more efficient end-to-end rendering process by providing opportunities to overlap multiple render requests at different stages.
In Release 5.8, Vulkan is the default. OpenGL rendering will be deprecated and later removed in subsequent releases. For Release 5.7, the Vulkan renderer is considered a Beta feature, and OpenGL is the default driver.
OmniSci recommends using the Vulkan renderer unless you have hit a blocking issue with Vulkan. Although the Vulkan driver is reliable and stable, it has not yet had wide external usage compared to its OpenGL counterpart and may be prone to unforeseen configuration issues; see Troubleshooting below for guidance on known issues. Having Vulkan enabled helps us to find and address additional issues while a reliable fallback exists to ensure a smooth, less risky transition.
To enable Vulkan rendering, set the configuration option
renderer-use-vulkan-driver=true. Note that this is the default in Release 5.8.
To disable Vulkan rendering and use the OpenGL legacy renderer, set the configuration option
renderer-use-vulkan-driver=false. NOTE that this is the default in Release 5.7.
As extra incentive to use the new Vulkan renderer, you are likely to benefit from performance improvements with Vulkan. For example, when rendering a large number of overlapping polygons, you may notice a 2x speedup with many more enhancements to come.
Follow these steps if you receive error messages when using Vulkan.
You might see the following error when trying to start a rendering-enabled server for the first time:
error while loading shared libraries: libvulkan.so.1: cannot open shared object file: No such file or directory
If you receive this error, you need to install the Vulkan API loader:
sudo yum install vulkan
sudo apt install libvulkan1 --no-install-recommends
You might experience a server crash or get errors on startup like the following:
Oct 21 17:09:33 ip-xxx-xxx-xx-xx.us-east-2.compute.internal omnisci_server: LLVM ERROR: inconsistency in registered CommandLine option
If this occurs, OmniSci recommends setting the following environment variable before staring the server:
export VK_ICD_FILENAMES=$(ls /usr/share/vulkan/icd.d/
If the server has been installed as a service, check the name of the nvidia icd json file with the following command:
Then, add the output as an Environment to the omnisci server service section with the followoing command:
sudo vi /usr/lib/systemd/system/omnisci_server.service
sudo systemctl daemon-reload.
As a last resort, you can remove the package
mesa-vulkan-driverfrom the OS.
sudo yum remove mesa-vulkan-drivers
sudo apt remove mesa-vulkan-drivers
For a summary of how to install the Vulkan loader on various Linux distributions, see https://linuxconfig.org/install-and-test-vulkan-on-linux.
If you run the server in a Docker container and you see an error similar to the following in your logs, even with the proper drivers installed, your NVIDIA Docker runtime may be out of date:
Backend rendering disabled: Error creating Vulkan instance: Vulkan Error: VK_ERROR_INCOMPATIBLE_DRIVER
To resolve, try upgrading the nvidia-docker2 package on your system.