Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -573,6 +573,36 @@ Python 3 automation requires Microsoft Visual C++ Redistributable 2015 x86 and x
</tbody>
</table>

## Disable approval request notifications to user groups
<table>
<tbody>
<tr>
<td>Key</td>
<td>`<add key="DisableApprovalGroupNotifications" value="True"/>`</td>
</tr>
<tr>
<td>Possible values</td>
<td>True/False. When True, blueprints can't notify a user group about new approval requests, the **notify users with group** option is hidden in the Portal, and no group notification emails are sent.</td>
</tr>
<tr>
<td>Where to add/change</td>
<td>`customer.config` Quali Server installation directory</td>
</tr>
<tr>
<td>Default value</td>
<td>False</td>
</tr>
<tr>
<td>Affected CloudShell Component</td>
<td>Quali Server</td>
</tr>
<tr>
<td>Version</td>
<td>2026.2.0.34 and above</td>
</tr>
</tbody>
</table>

## Enabling the automatic removal of expired approval requests
<table>
<tbody>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,8 +20,8 @@ Migrate a copy of your environment first, and keep your SQL Server databases unt

The tool's version must match your installed CloudShell version exactly. The tool prints its version when it starts, but it doesn't block a mismatch, and a mismatched tool creates a database schema that doesn't match your Quali Server.

- **CloudShell 2026.2 and later:** the CloudShell installation package includes the matching tool, in `CloudShell\Utilities\SqlServerToPostgresqlMigrator`.
- **Earlier versions:** contact Quali Support for the tool that matches your version.
- **CloudShell 2026.2.0.34 and later:** the CloudShell installation package includes the matching tool, in `CloudShell\Utilities\SqlServerToPostgresqlMigrator`.
- **Earlier versions, including 2026.2.0.2:** contact Quali Support for the tool that matches your version.

## Before you start

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ If any of the below 3rd Party components are missing from your computer, the Clo
- Microsoft Visual C++ Runtime 10.0
- Microsoft Visual C++ 14.0 or greater
- Microsoft Windows Installer 4.5
- Node.js 24.14.0 LTS (64-bit only)
- Node.js 24.22.1 LTS (64-bit only). CloudShell 2026.2.0.2 and 2026.1 use Node.js 24.14.0.
- pip 21.2.4 and up for Python 3 and pip 19.2.3 for Python 2.7.18
- Python 2.7.18 and 3.13.15 (64-bit)
- RabbitMQ 3.12.0 (installed as part of the Quali Server installation)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,6 @@ This section explains how to set the blueprint's properties, including name and
| Categories | Select the blueprint categories in which the blueprint is displayed. Once a category is selected, select the relevant sub-category, if there is one. For additional information, see [Managing Categories](../../../../admin/cloudshell-manage-dashboard/managing-categories.md). |
| Save Sandbox | (Unavailable for persistent blueprints) This area applies to the **Save and Restore** add-on.<ul><li>**Enable Sandbox Save:** Make sure this check box is selected if you want to allow end-users to save sandboxes created from this blueprint. If the check box is enabled, the **Save the Sandbox** button is displayed in the active sandbox and you will be able to save the sandbox. For additional information, see [Save a Sandbox](../../../sandboxes/sandbox-workspace/save-sandbox.md).</li><li>**Use abstract template save behavior**: Determine how the blueprint's abstract resources will behave in the saved sandbox. Options are:<ul><li>**Use abstract template save behavior**:(Default) Use the save behavior defined on each abstract resource in the blueprint.</li><li>**Return all resources to abstract**: Revert all selected resources back to their abstract states.</li><li>**Keep resolution for all resources**: Save the selected resources as is. In other words, do not revert them back to abstract.</li></ul></li></ul> |
| Persistent Sandbox | Select the **Enabling the checkbox will allow this blueprint to be reserved either as a persistent sandbox with no end time, or as a regular sandbox** checkbox to allow this blueprint to be deployed either as a regular time-limited sandbox or as a persistent sandbox with no end time. Persistent blueprints are used for deploying continuous environments with no end time. For details, see [Persistent Sandboxes Overview](../../../../intro/features/persistent-sandboxes.md). |
| Requires Approval | Select **Require users to request approval** to require launch approval from the blueprint's approval team, which comprises the blueprint owner and admins by design, but can also include a selected user group in the domain. This is useful for high cost sandboxes or those containing sensitive information.<ul><li>**When request is approved or rejected, notify the requester**</li><li>**When new approval request created, notify the blueprint owner** activates approval request notification emails for the owner.</li><li>**When new approval request created, notify users with group** allows you to add a user group to the domain's approval team. The team members will get a notification email whenever an end-user requests approval to reserve a blueprint, prompting them to **Approve** or **Reject** the request.</li></ul>**Note:** If you do not plan on using the Approval Request feature, you can hide its elements from your users. This is done by disabling the `EnableApprovals` configuration key. |
| Requires Approval | Select **Require users to request approval** to require launch approval from the blueprint's approval team, which comprises the blueprint owner and admins by design, but can also include a selected user group in the domain. This is useful for high cost sandboxes or those containing sensitive information.<ul><li>**When request is approved or rejected, notify the requester**</li><li>**When new approval request created, notify the blueprint owner** activates approval request notification emails for the owner.</li><li>**When new approval request created, notify users with group** allows you to add a user group to the domain's approval team. The team members will get a notification email whenever an end-user requests approval to reserve a blueprint, prompting them to **Approve** or **Reject** the request. In CloudShell 2026.2.0.34 and later, only system administrators (any group) and domain administrators (groups in their current domain) can set this option, and the Quali Server key `DisableApprovalGroupNotifications` can hide it for everyone.</li></ul>**Note:** If you do not plan on using the Approval Request feature, you can hide its elements from your users. This is done by disabling the `EnableApprovals` configuration key. |

3. Click Update.
2 changes: 2 additions & 0 deletions docs/portal/sandboxes/creating-sandboxes.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,6 +87,8 @@ Blueprints of type ‘view’ cannot be reserved.
- **On start** - Sends notification as the sandbox starts.
- **On setup complete** - Sends notification when the sandbox setup completes.
- **Before end** - (Unavailable for persistent blueprints) Sends notification before the Teardown process begins. The exact time is decided by the user.

To repeat this reminder until the sandbox ends, also select **and again every** and set the interval (minimum 15 minutes). Available in CloudShell 2026.2.0.34 and later.

:::note
By default, it is not possible to launch a sandbox that has a shorter duration than the Before end period. However, your admin can enable this capability using the `ReservationEmail.VerifyNotificationBeforeEndLongerThanDuration` configuration key.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ The sandbox’s name has a limit of 60 characters.
<tr>
<td>Email Notifications</td>
<td>
Email notifications to be sent to the owner and permitted users of the sandbox at different times during the lifecycle of the sandbox. Options are **On start**, **On setup complete**, **Before end**, and **On end** (you can decide exactly when to receive notification).
Email notifications to be sent to the owner and permitted users of the sandbox at different times during the lifecycle of the sandbox. Options are **On start**, **On setup complete**, **Before end**, and **On end** (you can decide exactly when to receive notification). For **Before end**, select **and again every** to repeat the reminder at a set interval (minimum 15 minutes) until the sandbox ends (CloudShell 2026.2.0.34 and later).
:::note
This capability requires the administrator to activate the email notifications feature using the `ReservationEmail` configuration keys.
:::
Expand Down
4 changes: 4 additions & 0 deletions docs/release-notes/behavior-change.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,10 @@ The following list includes changes in behavior introduced into CloudShell by ve

| Capability | Change Description | Changed in Release |
| --- | --- | --- |
| Approval group notifications | Only system administrators (any group) and domain administrators (groups in their current domain) can set **When new approval request created, notify users with group** on a blueprint. Other users no longer see the group list; a group that is already set is kept when they edit the blueprint. Set the Quali Server key `DisableApprovalGroupNotifications=true` to hide the option for everyone and stop group notification emails. | 2026.2.0.34 |
| CloudShell Monitor log packages | Log packages created by CloudShell Monitor include redacted copies of the configuration files instead of the originals. Passwords, secrets, private keys and connection-string passwords are masked. | 2026.2.0.34 |
| Extension DLL file version | `ServiceExtension.dll` and `GenericServiceExtension.dll` now show the CloudShell version as their file and product version. Their assembly version stays 2.0.0.0, so existing references keep working. | 2026.2.0.34 |
| virtualenv seed packages | When creating a driver environment, the Execution Server sets `VIRTUALENV_NO_PERIODIC_UPDATE=1`, so virtualenv no longer downloads newer pip and setuptools in the background. Set `VIRTUALENV_NO_PERIODIC_UPDATE=0` on the Execution Server host to restore the previous behavior. | 2026.2 |
| Server defaults changed | `UseRabbitServer` now defaults to `false` (previously `true`). `UseEmbeddedSandboxService` now defaults to `false` (previously `true`). If your deployment relies on these, explicitly set them to `true` in `customer.config` after upgrading. | 2026.1 |
| Job Scheduling messaging path | Job Scheduling now reads the global `UseRabbitServer` setting instead of an independent default of `true`. When `UseRabbitServer` is not explicitly set, scheduled jobs now use the direct (non-RabbitMQ) path, matching manually launched reservations. Set `UseRabbitServer=true` in `customer.config` to keep scheduled jobs on the RabbitMQ path. | 2026.1 |
| Editing an active maintenance window | When editing an **active** maintenance window, an end time that is not in the future (at or before the current time) is now rejected — including the former within-grace "ends immediately" behavior. To end an active maintenance window immediately, use the **Stop** action. | 2026.1 |
Expand Down
43 changes: 43 additions & 0 deletions docs/release-notes/whats-new.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,49 @@ sidebar_position: 2
CloudShell Release History
==========

## Version 2026.2

### Repeating "Sandbox Ending" Email {#repeating-before-end-notification}
The **Before end** email notification can now repeat until the sandbox ends. In the Reserve dialog or the sandbox **Properties**, select **Before end**, then select **and again every** and set an interval (minimum 15 minutes). The sandbox owner and permitted users keep getting the reminder at that interval until the sandbox ends.

The Python and XML-RPC TestShell API methods `CreateReservation`, `CreateImmediateReservation`, `CreateTopologyReservation` and `CreateImmediateTopologyReservation` accept a new optional `notificationRepeatMinutes` parameter (0 = no repeat, otherwise at least 15). The parameter isn't available in the TCL and C# API clients.

Available in CloudShell **2026.2.0.34** and later.

### Minimum Lead Time in Resource Manager
A domain's minimum lead time can now be set in Resource Manager, in the **Min. Lead Time** field on the domain's **Properties** page, instead of directly in the database. Available in CloudShell **2026.2.0.34** and later.

### SQL Server to PostgreSQL Migration Tool Included
The CloudShell installation package now includes the SQL Server to PostgreSQL migration tool, in `CloudShell\Utilities\SqlServerToPostgresqlMigrator`, with a README. See [Migrating the Databases from SQL Server to PostgreSQL](../install-configure/cloudshell-suite/backup-restore/migrate-sql-server-to-postgresql.md). Available in CloudShell **2026.2.0.34** and later.

### Approval Group Notifications Limited to Administrators
Only system administrators (any group) and domain administrators (groups in their current domain) can set **When new approval request created, notify users with group** on a blueprint. A group that is already set is kept when other users edit the blueprint. The new Quali Server key `DisableApprovalGroupNotifications` (default `false`) hides the option and stops group notification emails. Available in CloudShell **2026.2.0.34** and later.

### Secrets Redacted from CloudShell Monitor Log Packages
Log packages created by CloudShell Monitor now include redacted copies of the configuration files, with passwords, secrets, private keys and connection-string passwords masked. Available in CloudShell **2026.2.0.34** and later.

### Execution Server Driver Environments Keep Their Seed Packages
When creating a driver environment, the Execution Server now sets `VIRTUALENV_NO_PERIODIC_UPDATE=1`, so virtualenv no longer downloads newer pip and setuptools in the background. This prevents environments from picking up setuptools versions that break drivers (for example, a missing `pkg_resources`). Set `VIRTUALENV_NO_PERIODIC_UPDATE=0` on the Execution Server host to restore the previous behavior.

### Docker Execution Server Per-Release Tag
Each Docker Execution Server release is also tagged with its release number, for example `qualihub/executionserver:2026.2`, which always points to the newest 2026.2 image.

### Security Updates
Node.js, used by the Sandbox API Gateway and Server Proxy, was updated from 24.14.0 to 24.22.1 (Node.js October 2026 security release). Available in CloudShell **2026.2.0.34** and later.

### Bug Fixes
- Fixed `GetReservationDetails` timing out on sandboxes with many resources. Resource details are now queried more efficiently. (2026.2.0.34)
- Fixed diagram connection lines staying attached to the old card size after changing the View Style, with `PreserveDiagramLayoutOnViewStyleChange` enabled. (2026.2.0.34)
- Fixed **Save as Blueprint** failing for a work-order sandbox with connected routes or cables. (2026.2.0.34)
- Fixed the **Drivers** tab being hidden in Resource Manager for resource models that have parent models. (2026.2.0.34)
- The Activity Feed **All Components** filter now lists components in natural alphabetical order instead of diagram order. (2026.2.0.34)
- Fixed the sandbox diagram occasionally staying on **LOADING**. (2026.2.0.34)
- `ServiceExtension.dll` and `GenericServiceExtension.dll` now show the CloudShell version as their file version. Their assembly version is unchanged (2.0.0.0). (2026.2.0.34)
- Fixed the App Orchestration package (1.0.1) on Python 3.13 Execution Servers. (2026.2.0.34)
- Fixed reserving a sandbox failing with `User "..." does not exist` when the owner's username contains non-ASCII characters, such as accented letters or Japanese characters.
- Fixed a custom logo override (`customer_override.css`) not being applied on the page shown after switching domain.
- Fixed the Connect All VLAN service script on Python 3 Execution Servers; the installer now ships the current Networking and Sandbox Orchestration packages.

## Version 2026.1

### Blueprint Export/Import via the Automation API
Expand Down
Loading