Merge pull request #286296 from yousefi-msft/license-service

Update a license, quickstart, and troubleshooting.

Author: prmerger-automator[bot]

articles/modeling-simulation-workbench/how-to-guide-licenses.md

@@ -20,8 +20,12 @@ This article shows you how to upload a license file and activate a license servi
 
 - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
 
+[!INCLUDE [prerequisite-chamber](includes/prerequisite-chamber.md)]
+
 - A FLEXlm license file for a software vendor that requires a license. You need to buy a production environment license from a vendor such as Synopsys, Cadence, Siemens, or Ansys.
 
+[!INCLUDE [prerequisite-user-chamber-admin](includes/prerequisite-user-chamber-admin.md)]
+
 ## Upload or update a license for FLEXlm-based tools
 
 This section lists the steps to upload a license for a FLEXlm-based tool. First, you get the FLEXlm host ID or the virtual machine (VM) universally unique ID (UUID) from the chamber. Then you provide that value to the license vendor to get the license file. After you get the license file from the vendor, you upload it to the chamber and activate it.
@@ -37,6 +41,11 @@ This section lists the steps to upload a license for a FLEXlm-based tool. First,
 
 > [!IMPORTANT]
 > Loading a new license causes the license server to restart. This could affect actively running jobs.
+>
+> For Siemens license files validate that:
+>
+> - A `saltd` compatible file is requested; and
+> - The clause `VENDOR saltd` is included in the license file.
 
 ## Next steps
 

articles/modeling-simulation-workbench/quickstart-create-portal.md

@@ -74,7 +74,7 @@ Creating a client secret allows the Azure Modeling and Simulation Workbench to r
 1. In **App registrations**, select your application *QuickstartModSimWorkbenchApp*.
 1. Select **Certificates & secrets** > **Client secrets** > **New client secret**.
 1. Add a description for your client secret.
-1. Select **6 months** for the **Expires**.
+1. Select **12 months** for the **Expires**.
 1. Select **Add**. The application properties displays.
 1. Locate the **Client secret value** and document it. You need the client secret value when you create your Key Vault. Make sure you write it down now, as it will never be displayed again after you leave this page.
 

articles/modeling-simulation-workbench/resources-troubleshoot.md

@@ -30,7 +30,7 @@ A *not authorized error* while accessing the remote desktop dashboard URL indica
 
 #### Failing for all users
 
-- Review the [Create an application in Microsoft Entra ID](./quickstart-create-portal.md#create-an-application-in-microsoft-entra-id) article to verify your application registration is set up correctly.
+- Review the [Create an application in Microsoft Entra ID](./quickstart-create-portal.md#create-an-application-in-microsoft-entra-id) article and verify your application registration is set up correctly.
 - Review the redirect URI registrations for the specific chamber and confirm the connector's redirects match those found with the application. If they don't match, re[register the redirect URIs](./how-to-guide-add-redirect-uris.md).
 - Review the application registration secrets for Modeling and Simulation Workbench and check to see if your application client secret has expired. Complete the following steps if it's expired.
     1. Generate a new secret and make note of the client secret value.
@@ -44,7 +44,7 @@ A *not authorized error* while accessing the remote desktop dashboard URL indica
 #### Failing for some users
 
 1. Ensure the user is provisioned as a Chamber User or a Chamber Admin on the **chamber** resource. They should be set up as an IAM role directly for that chamber, not as a parent resource with inherited permission.
-1. Ensure the user has a valid email set for their Microsoft Entra profile, and that their Microsoft Entra alias matches their email alias. For example, a Microsoft Entra sign-in alias of *jane.doe* must also have an email alias of *jane.doe*. Jane Doe can't sign in to Microsoft Entra ID with jadoe or any other variation.
+1. Ensure the user has a valid email set for their Microsoft Entra profile, and that their Microsoft Entra alias matches their email alias. For example, a Microsoft Entra sign-in alias of *jane.doe* must also have an email alias of *jane.doe*. Jane Doe can't sign in to Microsoft Entra ID with *jadoe* or any other variation.
 1. Validate your `/mount/sharehome` folder has available space. The`/mount/sharedhome` directory is set up to store user keys to establish a secure connection. Don't store uploaded tarballs/binaries in this folder or install tools and use disk capacity, as it may create system connection errors causing an outage. Use /mount/chamberstorages/\<storage name\> directory instead for all your data storage and tool installation needs.
 1. Validate your folder permission settings are correct within your chamber. User provisioning may not work properly if the folder permission settings aren't correct. You can check folder permissions in a terminal session using the *ls -al* command for each /mount/sharedhome/\<useralias\>/.ssh folder, results should match below expectations:
 
@@ -64,7 +64,7 @@ A *not authorized error* while accessing the remote desktop dashboard URL indica
 
 ### License error
 
-An *all licenses are in use for the remote desktop error* means that all licenses are already being used for the remote desktop tool. Ask someone on your team to sign out of their session so that you can sign in.  Or contact your Microsoft account manager to get more remote desktop licenses.
+An *all licenses are in use for the remote desktop error* means that all licenses are already being used for the remote desktop tool. Ask someone on your team to sign out of their session so that you can sign in. Or contact your Microsoft account manager to get more remote desktop licenses.
 
 ## License server troubleshooting
 
@@ -128,8 +128,8 @@ An *all licenses are in use for the remote desktop error* means that all license
 
 ### Unable to approve data export request
 
-1. Confirm you're a Workbench Owner.  A Workbench Owner has a Subscription Owner or Subscription Contributor role assigned to them. It's the only role that can approve (or reject) a data export request.
-1. Confirm you didn't request the data export.  The user who requests the data export isn't allowed to also approve the data export.  For more information about data export, see [Export data from chamber.](./how-to-guide-download-data.md)
+1. Confirm you're a Workbench Owner. A Workbench Owner has a Subscription Owner or Subscription Contributor role assigned to them. It's the only role that can approve (or reject) a data export request.
+1. Confirm you didn't request the data export. The user who requests the data export isn't allowed to also approve the data export. For more information about data export, see [Export data from chamber.](./how-to-guide-download-data.md)
 
 ### Data export from chamber not working
 
@@ -145,7 +145,13 @@ Complete the following steps if you're unable to export data from the chamber us
 
 ## Quota/capacity troubleshooting
 
-For storage or computing quota issues, contact your Microsoft account manager.  They'll get you more allocation for your workbench subscription, subject to regional capacity limits/constraints.
+For storage or computing quota issues, contact your Microsoft account manager. They'll get you more allocation for your workbench subscription, subject to regional capacity limits/constraints.
+
+## Chamber or connector troubleshooting
+
+### Excessive time starting or stopping
+
+When starting a connector or chamber from stopped state, if the power state is in the 'Starting' status for longer than 25 minutes, then perform a Stop, wait for Power State to show Stopped, then perform a Start again. [Learn how to start and stop a chamber, connector, or VM.](how-to-guide-start-stop-restart.md)
 
 ## Issue not covered or addressed