Cache on Workstations

General Notes

If any changes are made to cache settings, you may have to restart any applications using cache for the changes to take effect.

Manage Cache With System Monitor

Omniverse Cache can be managed through System Monitor. You can enable/disable cache, change cache location, clear cache, and configure remote Cache from this page.

../../_images/nucleus_cache.png

To get there:

  • In Omniverse Launcher, click the ‘LIBRARY’ tab, click ‘Cache’, and then click the ‘CACHE SETTINGS’ button

  • Alternatively, open http://localhost:3080/cache in a web browser

Local and remote Cache can be enabled or disabled using these switches:

../../_images/nucleus_cache_enable-disable.png

The local cache service can also be started and stopped from the Apps page.

Remote Cache

In addition to using your local cache, which should always be installed and enabled, you can configure your client to point to a remote/upstream Cache.

For best results, whether connecting to a remote Cache on your local network or by VPN, always choose a remote Cache that is closest to your geographical location to minimize latency whenever possible.

To enable the use of a remote Cache:

  • Enable Remote Cache by activating the switch within the interface

  • Entering the hostname and port number for the remote Cache. i.e., http://my.remote.cache.instance.com:8891 and click ‘Apply’.

../../_images/cache_remote.png

If the remote Cache can be reached, a confirmation message will appear as follows:

../../_images/remote_cache_enabled.png
  • Restart your applications to ensure that they are using the new configuration.

Important

If the remote Cache is SSL-enabled, ensure that https:// is used when specifying the address.

If the remote Cache cannot be reached, the following message will appear:

../../_images/remote_cache_unreachable.png

If this message appears, contact your Nucleus server administrator for assistance.

Cache Configuration And Ports

Cache uses ports 8891 and 8892 by default, but can be changed.

Ports can be changed in System Monitor. Click ‘Configure Ports’:

../../_images/nucleus_system-monitor_configure-ports-1.png

You will land on this page:

../../_images/nucleus_system-monitor_configure-ports-2.png

Change port number preferences as needed and click ‘Apply’.

Cache configuration files are located in the same directory as the cache executable. You can check where this is by looking at the directory under Cache in the Apps page.

../../_images/nucleus_cache_directory-location.png