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. .. image:: /content/images/nucleus_cache.png :width: 300px :align: center 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: .. image:: /content/images/nucleus_cache_enable-disable.png :width: 300px :align: center 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., :code:`http://my.remote.cache.instance.com:8891` and click 'Apply'. .. image:: /content/images/cache_remote.png :width: 400px :align: center If the remote Cache can be reached, a confirmation message will appear as follows: .. image:: /content/images/remote_cache_enabled.png :width: 350px :align: center * Restart your applications to ensure that they are using the new configuration. .. important:: If the remote Cache is SSL-enabled, ensure that :code:`https://` is used when specifying the address. If the remote Cache cannot be reached, the following message will appear: .. image:: /content/images/remote_cache_unreachable.png :width: 400px :align: center 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': .. image:: /content/images/nucleus_system-monitor_configure-ports-1.png :width: 300px :align: center You will land on this page: .. image:: /content/images/nucleus_system-monitor_configure-ports-2.png :width: 300px :align: center 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. .. image:: /content/images/nucleus_cache_directory-location.png :width: 300px :align: center