What's New in Help Version CloudShell 9.0 GA
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.
CloudShell Dev Guide - new instructional videos
To help you successfully develop in CloudShell, we have started incorporating short instructional videos in the CloudShell Dev Guide. These videos illustrate key development methods, principles and implementation examples. The videos are embedded throughout the dev guide and listed in the dev guide's new Short Development Videos article.
Online Help Documentation Updates and News
Enhanced vCenter Integration documentation
Following customer feedback, we rewrote our VMware vCenter Integration and Configuration chapter to include additional content and clarifications regarding the integration with vCenter, including a detailed explanation of the architecture, outline of the integration configuration steps, high level vCenter App deployment flow, and an end-to-end tutorial video on Add VMware vCenter Cloud Provider Resource (at the bottom of the article).
Official Shells: Documentation initiative
We're currently rewriting the user guides of our official shells (Preview and Certified grades) to improve the overall quality, clarity and usability of the documentation. The new guides are provided as readme (.md) files attached to the shell's source code on GitHub, allowing you to easily view and also modify the contents (if you choose to extend a shell and wish to document your updates), and contain comprehensive information about the shell, its data model, and up to date installation and usage instructions.
Shells are updated based on urgency and customer feedback, so feel free to use the send feedback button at the bottom right corner of this page to tell us which shells you'd like us to update next.
This is a long term initiative and is expected to span several CloudShell releases.
Help Patch Documentation Updates
- Adding/Removing Domain Blueprints: clarified the process for adding/removing blueprints from domains
- Save and Restore documentation: Various updates
- Traffic Generators Overview: New article
- Create a Management Resource Group and VNets: Updated instructions per Azure Portal updates
- Configuring Single Logout (SLO): Enhanced overview and instructions
- Advanced CloudShell Customizations: Documented config keys
- Save a Sandbox as a Blueprint: New article
- AWS Integration: Clarified when NAT/cloudshell-server instances are used
- LDAP Integration: Note clarifying that mail and uid must be configued on LDAP server
- vCenter Integration Architecture and Prerequisites: Detailed vCenter prerequisites for integration with CloudShell
- Microsoft Azure Integration: Various updates
- Add VMware vCenter Cloud Provider Resource: Improved descriptions for attributes VM Cluster and Resource Pool
- Enabling Automation Suites to Use Local Tests: Clarifications regarding invalid execution servers
- Advanced CloudShell Customizations:
TopologySetupDurationMaxHoursis a Server config key, not Portal
Release 9.0 Features and Enhancements
Below are some of the major improvements and enhancements introduced in CloudShell 9.0:
Save and Restore for sandboxes
CloudShell 9.0 provides support for saving and restoring virtual sandboxes. In version 9.0, Save and Restore applies to sandboxes containing vCenter Apps and/or services. For additional information, see Sandbox Save and Restore Overview.
In future versions, this feature will be expanded to support additional types of components, including resources and other cloud provider Apps.
The Cloud Provider implementation guide provides step-by-step instructions on how to develop a shell that integrates the cloud provider of your choice with CloudShell. The guide is available in version 9.0 of the CloudShell Dev Guide.
This is done using the Cloud Provider shell template, which allows you to easily model and add new cloud providers to CloudShell, beyond our supported cloud providers (AWS, Azure, vCenter, Openstack). Custom Cloud Provider supports both private and public cloud deployments and is based on our existing Shells Standard mechanism.
Ease of use and ideas from our Community
Release 9.0 introduces some great enhancements taken from our Community’s Idea-box:
- New SSO Domain attribute allows directing the user to a specific domain upon login to CloudShell (documented in Configuring Single Sign-On (SSO))
- AWS Cloud Provider: Support IAM roles for Apps
- QualiX 2.6 (Documented in the QualiX Installation and Configuration Guide)
Key online help improvements
In addition to other improvements and enhancements, below are some of the major improvements in the CloudShell 9.0 online help.
- New BlockPackageExportForNonAdmins configuration key that blocks non-admin users from exporting blueprints
- CloudShell User Permission Levels: Enhanced look and feel, added permissions sections for additional CloudShell Portal dashboards and pages, and fixed inaccuracies
- Management articles for execution servers installed on public clouds: New articles explaining how to access, install, upgrade, and troubleshoot execution servers on Azure and AWS EC2, respectively: Managing the Azure Execution Server and Managing AWS EC2 Execution Servers
- Viewing Test, Job and Suite Execution Results: Article detailing Test, Job and Suite results
- Added architecture diagrams for the following CloudShell deployments: CloudShell suite, AWS Integration, and Microsoft Azure Integration
- Configuring QualiX (Apache Tomcat): New topic explaining how to modify the QualiX web server's security settings.
- Create a Management Resource Group and VNets: Added instructions for CloudShell suite installation on Azure cloud
- Power Switches: Rewrote article to use the 2nd generation PDU shell instead of CloudShell Authoring
- Traffic Generators Overview: New feature article for Traffic Generators in CloudShell explaining their use, architecture and setup
- New AutoSwitchDomain configuration key that enables admins to control how CloudShell opens links to sandbox from other domains
- New ShowSharedResourceUsage configuration key that allows hiding user/sandbox details of currently shared resources in CloudShell Portal
- Troubleshooting Guide: Added several new troubleshooting issues
- Several existing admin configuration keys added to the documentation
- Added in-depth explanations of the CloudShell installation options to the CloudShell Suite Installation Guide
- Setting the QualiX remote connection browser's title: New section explaining how to customize the browser tab title for QualiX in-browser sessions
- Upgrade execution server process: Added a note explaining how to modify or upgrade an execution server process installation
- High Availability: New article explaining how to set the same certificate on the different execution servers (in the Set the Same Certificate on all Quali Server Nodes)
- CloudShell Automation API:
- API methods for saving, viewing, restoring and deleting saved sandboxes
- GetTopologyUrls: New API method for generating a full blueprint URL (To be used when trying to open a topology from a link)
Key CloudShell Dev Guide enhancements
- New custom cloud providers chapter explaining how to implement any cloud provider in CloudShell. For details see Custom Cloud Provider implementation guide at the top of this article
- New article explaining how to work with resource scripts
- New CloudShell APIs article providing a detailed description of each API as well as useful links and implementation examples
- Shellfoundry offline mode
- L1 driver shell implementation guide
- Enhanced shell debugging and logging information
For additional information, visit the CloudShell Dev Guide.
New and updated shell standards
- Networking standard 5.0.4
- Cloud provider standard 1.0.0
- Deployed app standard 1.0.3
- Virtual traffic generator standard 1.0.0
The "CloudShell Standards" documentation pages are available on this GitHub page.