# Workstation Release Notes

## 2022.4.1

* Released 12/09/2022
* **Nucleus Core**
    - Fixing workstation Nucleus Core exposing metrics unnecessarily

Component versions:

* Nucleus Core 114.4
* Authentication Service 1.4.5
* Discovery Service 1.4.6
* Search Service 3.2.1
* Tagging Service 3.1.3
* Thumbnail Service 1.5.3
* System Monitor 3.2.6

## 2022.4.0

* Released 11/29/2022
* **Nucleus Core**
    - Atomic Checkpoints

Component versions:

* Nucleus Core 114.2
* Authentication Service 1.4.5
* Discovery Service 1.4.6
* Search Service 3.2.1
* Tagging Service 3.1.3
* Thumbnail Service 1.5.3
* System Monitor 3.2.6

## 2022.2.0

* Released 09/06/2022
* **Nucleus Core**
    - Fixing Centos build

Component versions:

* Nucleus Core 113.29
* Authentication Service 1.4.4
* Discovery Service 1.4.4
* Search Service 3.2.0
* Tagging Service 3.0.0
* Thumbnail Service 1.4.4
* Web Service 2.4.4
* System Monitor 3.1.2

## 2022.1.2

* **Nucleus Core**
    - Fixing Centos build

Component versions:

* Nucleus Core 113.20
* Authentication Service 1.4.2
* Discovery Service 1.4.4
* Search Service 3.2.0
* Tagging Service 3.0.0
* Thumbnail Service 1.4.4
* Web Service 2.4.4
* System Monitor 3.1.2

## 2022.1.1

* **Nucleus Core**
    - Adding configurable quotas for list & read subscriptions
    - extending subscribe_list with an optional 'recursive' argument available only for superusers
    - Updated libcurl to version 7.82.0 (brotli compression is no longer supported) and zlib to version 1.2.12
    - Fixed access log encoding (default is utf-8, configurable using 'OMNI_LFT_ACCESS_LOG_ENCODING' env.var.)
    - Bugfixes

* **Nucleus Authentication**
    - Bugfixes

* **Nucleus Search**
    - Extended functionality of the search service. Supported the metadata search.
    - 'token' became required argument for the find_paged_cursor, find_paged_skip methods
    - Changed the indexing process to use multiple requests instead of a single recursive call
    - Added new calls to get prefixes and run paginated search

* **Nucleus System Monitor**
    - Added an option to open log location
    - Bugfixes

Component versions:

* Nucleus Core 113.19
* Authentication Service 1.4.2
* Discovery Service 1.4.4
* Search Service 3.2.0
* Tagging Service 3.0.0
* Thumbnail Service 1.4.4
* Web Service 2.4.4
* System Monitor 3.1.2

## 2022.1.0

* **Nucleus Core**
    - Do not send CheckpointsChanged event in subscribe_list to clients which don't support subscribe_list:1 and higher capability
    - Declare "stop" capability (version 0) when registering in the Discovery service
    - Fix "auth" setting group name collision in omni.server.app config .json files, one group is renamed to "auth_service_client"
    - Optimized omni.objects update & KeyValueDB transaction setup
    - Simplifying list implementation, stopping support for wildcards anywhere but the end of the path
    - Implemented get_acl_resolved API call
    - Only rename event should come to clients supporting it
    - Send CheckpointsChanged event when checkpoint is created
    - Fix meta record with unflushed content repair routine
    - Added missing list subscription event on object update
    - Support /path2/ endpoint for downloading a file in a branch or a checkpoint of a file
    - Atomic checkpointing of assets and omni-objects
    - Added missing list subscription event on object update
    - Output logs to stderr
    - Adding deep_copy_object_struct command
    - Extended access log with new information
    - Make delete/delete2 delete HEAD only when all checkpoints are deleted, set_acl_v2 can set ACLs only on HEAD, all checkpoints get ACLs same as in HEAD
    - Implemented support for passing user data to mount using Auth service's user store.
    - Support for OMNI_DEFAULT_S3_PROXY_CACHE environment variable
    - Bugfixes
    - 3rd-party libraries updates

* **Nucleus Authentication**
    - Support API tokens
    - Updated idl.py to support configuring WS_MAX_HTTP_LINE
    - Fixed an error occurred when clients sent refresh tokens signed with the private key that is no longer valid
    - Optimize deleting expired refresh tokens
    - Support read-only users
    - Fixed an issue where service couldn't write its logs to a file
    - Support `nonce` argument to let clients subscribe to authentication results
    - Healthchecks

* **Nucleus Search**
    - [BREAKING CHANGE] All search requests now require the authentication token.
    - Support PathEvent.Copy and PathEvent.Rename for indexing
    - Bugfixes

* **Nucleus Tagging**
    - Added required auto token field to all API functions that expose data from Nucleus.
    - Reverted default storage location of sqlite database.
    - Auto create path to sqlite db if it does not exist.
    - Added support for different storage backends

* **Nucleus Web**
    - Updated search and tagging libraries to send the authentication token
    - Fixed an app crash when local storage does not have the cached server
    - Added option to mark user as read-only
    - Updated discovery and auth libraries to fix connection issues in Chrome and Firefox
    - Fix upload notes dialog delay when directory is big(over 100gb)
    - Fixed invitation page wasn't working if CredentialSettings is null

* **Nucleus System Monitor**
    - Added controls for managing cache cleanup policies
    - Ping remote cache before applying it in the settings
    - Restart Cache automatically after changing the remote cache settings
    - Added a button to restart all services
    - Detect which protocol of the remote cache should be used (http vs https)
    - Show warning dialog about enabled sharing

Component versions:

* Nucleus Core 113.6
* Authentication Service 1.4.0
* Discovery Service 1.4.2
* Search Service 3.0.0
* Tagging Service 3.0.0
* Thumbnail Service 1.4.4
* Web Service 2.4.4
* System Monitor 3.1.0

## 2021.2.6

* Fixes incorrect link on the package page in the Omniverse Launcher

Component versions:

* Nucleus Core 111.5
* Authentication Service 1.2.0
* Discovery Service 1.4.0
* Search Service 2.2.0
* Tagging Service 2.1.1
* Thumbnail Service 1.4.2
* Web Service 2.3.3
* System Monitor 3.0.7

## 2021.2.5

* Fixes missing Web Service component on Linux

Component versions:

* Nucleus Core 111.5
* Authentication Service 1.2.0
* Discovery Service 1.4.0
* Search Service 2.2.0
* Tagging Service 2.1.1
* Thumbnail Service 1.4.2
* Web Service 2.3.3
* System Monitor 3.0.7

## 2021.2.4

Component versions:

* Nucleus Core 111.5
* Authentication Service 1.2.0
* Discovery Service 1.4.0
* Search Service 2.2.0
* Tagging Service 2.1.1
* Thumbnail Service 1.4.2
* Web Service 2.3.3
* System Monitor 3.0.7


## 2021.2.3

Component versions:

* Nucleus Core 111.5
* Authentication Service 1.2.0
* Discovery Service 1.4.0
* Search Service 2.2.0
* Tagging Service 2.1.1
* Thumbnail Service 1.4.2
* Web Service 2.3.1
* System Monitor 3.0.7


## 2021.2.2

Component versions:

* Nucleus Core 111.3
* Authentication Service 1.1.1
* Discovery Service 1.3.0
* Search Service 2.1.0
* Tagging Service 2.1.1
* Thumbnail Service 1.4.2
* Web Service 2.3.1
* System Monitor 3.0.6

## 2021.2.0

Component versions:

* Nucleus Core 111.0
* Authentication Service 1.1.0
* Discovery Service 1.3.0
* Search Service 2.1.0
* Tagging Service 2.1.1
* Thumbnail Service 1.4.1
* Web Service 2.3.0
* System Monitor 3.0.5

## 2021.1.1

Component versions:

* Nucleus Core 110.3
* Authentication Service 1.0.6
* Discovery Service 1.1.1
* Search Service 2.0.5
* Snapshot Service 2.0.5
* Tagging Service 2.0.8
* Thumbnail Service 1.3.1
* Web Service 2.2.11
* System Monitor 3.0.5

## 2021.1.0

Component versions:

* Nucleus Core 110.2
* Authentication Service 1.0.5
* Discovery Service 1.1.1
* Search Service 2.0.5
* Snapshot Service 2.0.5
* Tagging Service 2.0.8
* Thumbnail Service 1.3.1
* Web Service 2.2.11
* System Monitor 3.0.4

## 2020.3.2

Component versions:

* Nucleus Core 109.14
* Authentication Service 1.0.4
* Discovery Service 1.0.6
* Search Service 2.0.4
* Snapshot Service 2.0.4
* Tagging Service 2.0.7
* Thumbnail Service 1.3.0
* Web Service 2.2.8
* System Monitor 3.0.4

## 2020.3.1

Component versions:

* Nucleus Core 109.9
* Authentication Service 1.0.3
* Discovery Service 1.0.6
* Search Service 2.0.4
* Snapshot Service 2.0.4
* Tagging Service 2.0.7
* Thumbnail Service 1.3.0
* Web Service 2.2.8
* System Monitor 3.0.4

## 2020.3.0

**NOTE:** If you are upgrading from a previous installation of Nucleus Workstation there are situations where
the location of the server data will be incorrectly mapped for the new version, resulting in the newly installed
Nucleus *not* picking up the old data. This can be fixed by following these steps:

1. Locate the top-level Omniverse configuration file at:
    * $HOME/.nvidia-omniverse/config/omniverse.toml (Linux)
    * %userprofile%\\.nvidia-omniverse\config\omniverse.toml (Windows)
2. Find the `data_root` path inside the file and append `"\\data"` to it. For example, if it was `"C:\\my_nucleus"` it
would become `"C:\\my_Nucleus\\data"`. Note that if you inspect your file system
using the path just constructed it should contain a folder named *server* that holds the old data.

Component versions:

* Nucleus Core 109.8
* Authentication Service 1.0.3
* Cache Service 1.5.3
* Discovery Service 1.0.3
* Search Service 2.0.4
* Snapshot Service 2.0.4
* Tagging Service 2.0.7
* Thumbnail Service 1.3.0
* Omniverse Navigator (previously Web Service) 2.2.8
* System Monitor 3.0.0

## 2020.2.2

* Nucleus Core 109.5
* Authentication Service 1.0.1
* Cache Service 1.4.0
* Discovery 1.0.0
* Search Service (previously Indexing) 2.0.2
* Snapshot Service 2.0.2
* Tagging Service 2.0.3
* Thumbnail Service 1.2.5
* Web Service 2.2.4
* System Monitor 2.0.0

## 2020.2.1

* Nucleus Core 109.3
* Asset Service 2.0.0
* Authentication Service 1.0.0
* Cache Service 1.4.0
* Discovery 1.0.1
* Search Service (previously Indexing) 2.0.1
* Snapshot Service 2.0.0
* Tagging Service 2.0.1
* Thumbnail Service 1.2.5
* Web Service 2.2.1
* System Monitor 2.0.0

## 2020.2

* Nucleus Core 109.3
* Asset Service 2.0.0
* Authentication Service 1.0.0
* Cache Service 1.4.0
* Discovery 1.0.0
* Search Service (previously Indexing) 2.0.0
* Snapshot Service 2.0.0
* Tagging Service 2.0.0
* Thumbnail Service 1.2.4
* Web Service 2.2.0
* System Monitor 1.0.0

## 2020.1

* Nucleus Core 107.6
* Asset Service 1.0.0
* Cache Service 1.3.1
* Indexing Service 1.2.0
* Snapshot Service 1.0.1
* Thumbnail Service 1.2.3
* Web Service 2.1.0
* System Monitor 0.1.0

## 2019.3a

* Nucleus Core 107.6
* Asset Service 1.0.0
* Cache Service 1.3.1
* Indexing Service 1.2.0
* Snapshot Service 1.0.1
* Thumbnail Service 1.2.3
* Web Service 2.1.0
* System Monitor 0.2.0

## 2019.3

* Nucleus Core 107.3
* Asset Service 1.0.0
* Cache Service 1.1
* Indexing Service 1.2.0
* Snapshot Service 1.0.1
* Thumbnail Service 1.2.2
* Web Service 2.1.0
* System Monitor 0.1.0