What's New in the CloudShell 9.2 GA Help
The Troubleshooting Guide provides possible causes to common errors and offers step-by-step instructions to resolve them. To help you quickly find what you are looking for, simply search for the error or check out the guide's table of contents, organized in categories like Database and Permissions, QualiX and vCenter.
Help Patch Documentation Updates
- Modeling Public Cloud Services in CloudShell: New article providing a high-level overview of how to model cloud application services in sandboxes.
- Integrating Azure with Cloud-based CloudShell Installation: New article providing a high level workflow for integrating Azure with a CloudShell system that is also installed on Azure.
- Insight BI documentation updates: Updated instructions and images in several Insight installation and configuration articles.
- Managing App Templates: Updated descriptions for Azure deployment type attributes Wait for IP, Inbound Ports and Allow All Sandbox Traffic.
- Insight BI documentation: Various updates, including updated instructions and images, and updated links to external sources
- Controlling execution server selection for resource commands: Clarified overview and instructions and
- Configure Azure API to work with CloudShell: Updated configuration instructions per Azure Portal updates
- Advanced CloudShell Customizations:
SupportedConnectionTypesis a Portal config key, not Server
- Enabling Automation Suites to Use Local Tests: Clarifications regarding invalid execution servers
Release 9.2 Features and Enhancements
Below are some of the major improvements and enhancements introduced in this CloudShell version:
- Block regular users from adding/removing resources in the sandbox: Starting with 9.2 GA, admins can set this restriction in CloudShell. For details, see Preventing regular users from adding/removing resources in sandboxes.
- Share Level setting: CloudShell admins can now set the share level on specific resources in the Inventory dashboard. This overrides the share level defined on the resource's family in the Locked by Default check box. For details, see Editing Resources from the Inventory Dashboard.
- L1 route resolution during sandbox setup: CloudShell's Default Sandbox Setup script resolves physical connection requirements as part of the sandbox setup process. For details, see CloudShell Sandbox Template.
- IP allocation options for Azure Apps: CloudShell admins can now control which platform (CloudShell or Azure) is responsible for allocating IPs for Azure Apps. For details, see Add an Azure Cloud Provider Resource.
- Check blueprint routes containing abstract resource endpoints: This option allows blueprint designers to check if a connectivity resolution exists for L1 routes that have one or two abstract resource endpoints. Unlike the existing Check Blueprint option, this action runs a "deep check" that may take some time to complete and is especially useful for highly complex blueprints containing tens and hundreds of routes. For details, see Check Blueprint Routes.
Execution Server Selector enhancements:
- Show Execution Server Selector attributes in the resource discovery form: In CloudShell 9.2, custom shell attributes that have the Execution Server Selector rule are included by default in the discovery form of new resources.
- Execution Server Selector added by default to new resources: This enhancement is detailed in the ideas section below.
- 3rd Party Software: CloudShell 9.2 GA supports 126.96.36.19902 only. Versions 6.5 and 6.7 are still supported. For details, see 3rd Party Software.
Ease of use and ideas from our Community
This CloudShell release introduces several enhancements and updates taken from our Community’s Idea-box:
- Python 3 support: CloudShell 9.2 supports executing python 3-based scripts. This requires setting the script as a Python 3 type script in the Scripts management page, as explained in Editing scripts. Related to idea: https://community.quali.com/idea/994/python-3-support
- Ability to manage Abstract templates between Domains: In version 9.2, we added the capability to share abstract resource templates between different domains. For details, see Sharing the abstract resource template with other domains. Related to idea: https://community.quali.com/idea/174/ability-to-manage-abstract-templates-between-domai
- Make max user reservation value accessible via API: As explained in API enhancements below, several API methods now return the user's maximum concurrent reservations and maximum saved sandboxes. Related to this idea: https://community.quali.com/idea/750/make-max-user-reservation-value-accessible-via-api
- Shells should come with execution server selector attribute as a default: The Execution Server Selector attribute now comes out-of-the-box with all new shells to enable admins to quickly and easily associate resources to Execution Servers. Related to idea: https://community.quali.com/idea/3717/shells-should-come-with-execution-server-selector
- Maintenance Window: CloudShell admins can now define a system-wide maintenance window. For details, see Maintenance Window. Related to idea: https://community.quali.com/idea/145/admin-level-control-to-create-a-scheduling-blackou
- Role-based user access (RBAC) for resource/blueprint commands: User access to resource and blueprint commands can now be limited to CloudShell admins. For shells, this is done in the shell itself (see this CloudShell Dev Guide article), and for scripts, this is done by setting the Visibility attribute when editing the script in CloudShell, as explained in Editing scripts. Related to idea: https://community.quali.com/idea/1400/rbac-for-resource-blueprint-commands
- Custom attributes on service shells are 'user input' by default: When adding a custom attribute to a 2nd Gen service, it is defined as a
user_inputattribute, and will be included in the Add Service dialog box that is displayed when adding the service to the blueprintor sandbox. For additional information, see the Key CloudShell Dev Guide enhancements section below. Related to idea: https://community.quali.com/idea/4006/add-user-input-to-custom-attributes-that-are-added
- Storing Reservation specific information for later use: Using the API, custom key-value data can now be added to the sandbox and used by the sandbox's automation processes. Related to idea: https://community.quali.com/idea/655/storing-reservation-specific-information-for-later
- GetTopologyDetails API enhancements: As explained in API enhancements below, this method now returns additional blueprint information.
Key online help improvements
In addition to other improvements and enhancements, below are some of the major improvements in the CloudShell 9.2 online help.
VLAN documentation enhancements: To clarify how CloudShell handles L2/VLAN connectivity, we made the following updates to our VLAN documentation:
- VLAN Connectivity: Added an overview section explaining how CloudShell uses the L2 network to create VLAN connections in the sandbox.
- VLAN Connectivity - Points to Consider: New article listing CloudShell-related VLAN/L2 issues, important notes and limitations.
- Connectivity: Note explaining that CloudShell does not support creating cross-networking layer connections involving both L1 and L2 devices.
- Email Notifications Overview: CloudShell email notifications have been a source of confusion for some so to help make sense of it all, we created this article that covers all the different options and explains how to quickly and successfully set them up.
- Configuring Sandbox API to Run in HTTPS Mode: New article in the CloudShell Suite Installation Guide.
XML RPC / CloudShell Automation API:
- The following methods now return the user's maximum concurrent reservation count, maximum saved sandboxes count and maximum reservation duration:
SetResourceShareLevel: Allows you to set a specific resource's default share level. This setting overrides the share level policy defined in the resource family via the Locked by default check box.
RestoreSavedSandbox: Added two new input parameters:
endTime, which allow you to restore a saved sandbox at a future time.
- Resource conflict validations implemented for sandbox creation APIs: The following methods now return an error message blocking a non-admin user from creating or restoring a saved sandbox with conflicts when the BlockReserveWithConflicts admin configuration key value is enabled:
CreateTopologyReservation, and starting with 9.2 GA:
GetTopologyDetailsnow includes the following bluperint information: description, privacy state, estimated setup duration, estimated teardown duration, create date, modification date and default duration (in seconds).
- The following methods were implemented for storing and retrieving custom sandbox metadata:
GetAbstractTemplateListnow includes a list of the domains the user is permitted to access.
Note: This enhancement is related to the Ability to manage Abstract templates between Domains idea above.
- The blueprint start and sandbox_identifier methods can now accept a list of permitted users in the request.
AttachFileToReservation: Fixed code example and File path parameter description
Key CloudShell Dev Guide enhancements
- Shellfoundry article: New shellfoundry versions providing various fixes and enhancements. Notable updates include:
- Version 1.2.6 provides new commands
deletethat enable developers to download shell templates for shell development in offline mode and delete installed shells from CloudShell, respectively.
- Version 1.2.7 provides data model support for renamed shell templates.
distcommand for creating a shell's dependencies package.
- Version 1.2.6 provides new commands
Modifying a Shell to Declare a VM as a Resource article: New article guiding developers on how to modify a 2nd Gen shell to load static VM into CloudShell.
- Working with Custom Sandbox Metadata article: New article explaining how to store and use custom sandbox data.
- Modeling Shells with TOSCA article: In the resource discovery form, admins are allowed to edit the values of shell attributes that have the
More supported shells and standards
- Generic Resource with Connected Commands standard
- Generic Connectable Resource standard
- Ixia IxNetwork Controller 2G Shell
- Ixia IxLoad Controller 2G Shell
- Ixia BreakingPoint Controller 2G Shells
- Ixia BreakingPoint Chassis 2G Shells
- TeraVM Controller 2G Shell
- TeraVM Chassis 2G Shells
- TeraVM Virtual Chassis 2G Shells
- TeraVM Virtual Blade 2G Shells
- APCON CLI4 L1 Driver - added support for a newer firmware version