Content Comparison

...

• Version numbers are formatted as x.y.z where x=major version, y=minor version and z=patch version

• Regarding Blue/Green upgrades:

  • Blue/Green upgrades can be performed on environments running version a.b.c or newer.

  • ClearBlade only guarantees compatibility between one minor version and the next.

  • If an environment needs to be upgraded from one version to another in a Blue/Green fashion where the origin and target versions are separated by more than one minor version, then:

    • Multiple upgrade steps are required.

    • The steps must upgrade the environment to each of the minor versions between the origin and target versions.

    • Only one step per minor version is required.

    • Although a step can be used to upgrade to any patch version within a minor version, it is recommended that the latest patch version is chosen. This is because the latest patch version is likely to incorporate the most bug fixes.

    • For example, if upgrading from 9.36.2 to 9.38.0 either of these series of steps can be used:

      • 9.36.2 -> 9.37.2 -> 9.38.0

      • 9.36.2 -> 9.37.4 -> 9.38.0 (recommended)

2025.2.0

Date: 2025-07-01

Notes:

Platform:

• Feature: MQTT connector for Azure Event Hub

• Feature: Support shared access token authentication in the broker. This can be disabled with DisableSharedAccessTokenAuth.

• Feature: New query parser option that natively supports Postgres syntax. This can be enabled by setting config option UseLegacyParser to false.

• Feature: New distributed lock store option. Add config options ConsistentHashVirtualNodes, HashRingGetNodeRetryCount, HashRingGetNodeRetryDelaySeconds, DebounceTimeoutSeconds and ClusterStablePeriodSeconds to configure the consistent hash ring and waiting for the cluster to stabilize and connect to every other node. Add config options LockQueueSize, MaxLockRetryAttempts, LockRetryInitialDelayMilliseconds, LockRetryMaxDelayMilliseconds and LockRetryBackoffFactor to configure the hash ring lock implementation.

• Enhancement: Add ReportIntervalSeconds and ReportIntervalInitialDelaySeconds config options for tuning metric reporting

• Enhancement: Add config options AzureEventHubPullBatchSize, AzureEventHubPullTimeoutSeconds, AzureEventHubPushBatchSize and AzureEventHubPushTimeoutSeconds for customizing the Event Hub connector

• Enhancement: Allow preloaded services to serve many requests concurrently, even if no run-as user is set.

• Enhancement: Add config variable MaxInFlightPreloadedRequestsPerInstance to limit the number of requests that a preloaded service instance will serve concurrently.

• Enhancement: Pull user contexts in execution engines directly from global store instead of storing a local copy. This deprecates HotSwapUserCtx.

• Enhancement: Allow use of the EXCLUDED keyword in the ON CONFLICT clause of raw queries

• Enhancement: Reject raw queries that use black-listed functions. See config options RawQueryFunctionBlacklist, DefaultQueryFunctionBlacklistOverride, and DisableDefaultQueryFunctionBlacklist.

• Enhancement: Upgrade MongoDB driver to v2.2.2

• Fix: Check primary key index name dynamically using queries before converting collections to hypertables

• Fix: Reject raw queries that contain cyclical aliases

2025.1.11

Date: 2025-06-27

Notes:

Platform:

• Fix: Message history getting deleted when using cb-cli push that excludes message history settings

• Enhancement: Add prometheus metric clearblade_rpc_messages to track total number of RPC messages sent by each node

• Enhancement: Change default Buckets.QueueEmptyIntervalSecs config value to 1 hour

2025.1.10

Date: 2025-06-24

Notes:

Platform:

• Fix: Decode null and undefined bodies in the fetch library instead of throwing an error

• Fix: Remove default throttlers when EnableDefaultThrottlers is updated

• Fix: Don't allow permissions to be set on invalid MQTT topic filters

• Fix: verifytables subcommand failing with "table is already a hypertable" and "constraint already exists" errors

• Fix: system uploads not removing library dependencies from service metadata

• Fix: Prevent race condition when updating config through the set subcommand which could generate malformed toml files

• Fix: Prevent panic when using external brokers in V8.

• Enhancement: Add prometheus gauge clearblade_security_sessions for user, dev, and device sessions (may cause long scrape times, disabled by default with config Security.DisableSessionMetrics)

• Enhancement: Support {systemKey} wildcard in topic permissions to match the current system

2025.1.9

Date: 2025-06-06

Notes:

...