Is this page helpful?

Hub Workstation Cache#

Overview#

Hub Workstation Cache is a service that helps speed up USD workflows on your local workstation. This is a stand-alone service that runs on your local workstation and benefits Kit-based applications or Client Library tools.

Hub Workstation Cache has been performance optimized and supports storage-derived data from newer versions of Kit-based applications.

You can download Hub Workstation Cache from our NGC collection.

Warning

Hub Workstation Cache requires Client Library 2.49.2 or greater. If using older versions of Client Library, you may experience errors when attempting to load files.

Installing Hub with Install Scripts#

Hub Workstation Cache is simple to manually install with the scripts included in the archive files you can download from our NGC Resource page. Under File Browser, choose which package to download (either Windows or Linux), and click the three dots under Actions to download it. Extract the data, and install using the ./scripts/install.[bat/sh] file.

Installing Hub with Kit Cache Status Indicator#

Installing Hub Workstation Cache is simple using the Cache Status Indicator extension within your Kit app.

Note

This requires Cache Status Indicator 3.0.0 or greater.

First, search for the Cache Status Indicator extension within your Kit app. Install and load the Cache Status Indicator. Set the extension to autoload so it will always load in your application.

Cache Status Indicator

This will load the extension, and add a UI element to the upper right corner of your application. The UI element will notify you when a new version of the Cache Status Indicator is available to download.

Cache Indicator Loaded

Click the indicator to download and install Hub Workstation Cache.

Cache Indicator Install

The indicator will change to Downloading… while this is happening.

Cache Indicator Download

Once the installation is complete, you will be prompted to restart your applications (Hub will not connect to running Kit applications until they are restarted).

Restart Kit

After you restart your application, the indicator will be updated with a green SET letting you know it is ready to use.

Cache Indicator Set

Clicking the cache indicator will now take you to the Hub Settings documented below.

Uninstalling Hub with Install Scripts#

Within the installed Hub directory, you will find an uninstall.[bat/sh] file.

To uninstall, make sure all your Omniverse applications are shutdown.

Next, run the uninstall.[bat/sh] file directly.

Note

If you provide the -d argument, the hub directory will be removed as well, rather than only the content of the directory.

Hub Configuration and Settings#

Hub Workstation Cache is managed through a settings page, located at http://localhost:14090/index.html.

Hub Workstation Cache Settings

  • Cache Path

    • This is where all your cache data will be stored for Hub. Make sure this is a local disk on your workstation.

  • Cleanup Threshold (%)

    • How much data should get cleaned up once you have reached or exceeded your allocated storage amount.

  • Cache Collection Interval(s)

    • Duration, in seconds, for when storage utilization is checked for cleanup to make sure it stays within the allocated threshold.

  • Cache Max Size (Gb)

    • This is your initial storage allocation Hub will use when caching data. It is possible for your utilization to be higher than the allocated space until cleanup finishes.

  • Apply

    • Button to make sure modifications to the settings are saved.

  • Cache size/Cached files

    • This is the current size of data and file count stored in your cache location.

  • Clear

    • Clears all the data stored in your cache that is not in use.

  • Download Support Bundle

    • This will zip up all the needed data to supply to NVIDIA to report bugs.

Cache Cleaner Tool#

New in Hub 1.1.0, we have now included the Cache Cleaner tool for use with Kit 107 and below, applications. This helps manage the derived data those versions of Kit create, to help keep derived cache from growing unbounded.

To use the Cache Cleaner tool in Hub with Kit versions lower than 109.0.1, you will need to launch Hub from the command line. Go into the Hub install directory and run the following command:

hub --with-cleaner

Or, if you are using Kit version 109.0.1 or greater, you can launch Kit with an environment variable:

export OMNICLIENT_HUB_WITH_CLEANER=1

Once Hub is running, you can go to the Hub Settings page and click the Cache Cleaner button.

Cache Cleaner Dialog

Known Issues and Workarounds#

  • Updating of Hub Workstation Cache does not remove the old versions that were installed.

    • Workaround: Delete the old version of Hub Workstation Cache after updating.

  • Some Windows users may experience errors when using Kit-based applications 107.3 and below, you may experience errors with Hub not being found in the application, even if it’s been installed.

    • Workaround: You will need to create a symlink as follows: mklink /d %APPDATA%\ov %LOCALAPPDATA%\ov

    • This issue is fixed in Kit 109.0.1 and greater.

Release Notes#

  • 1.1.0:

    • Added new Cache Cleaner for more information.

    • Performance improvments to support Kit 109 derived data creation.

    • Overall stability improvements.

  • 1.0.2:

    • Install script now supports installing to a non-default location

    • Updated default library root location on Windows to %LOCALAPPDATA%\ov\pkg

  • 1.0.1:

    • Added an uninstall script

  • 1.0.0:

    • Initial Release