...

Local Terminal
1. If you have used PowerShell on your local workstation it may be easiest to execute the onboarding package on your local workstation. In order to do so you must have already installed the AZ module and connected to your Azure account. Instructions for doing so are beyond the scope of this document but more information can be found here.
2. Unpack the zip file you received into a temporary folder on your local workstation.
3. Open a PowerShell, Windows Terminal, or other console window and change to the temporary folder created in the previous step.
4. Type the following commands:
  
  Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope CurrentUser
  
  Registration-Helper.ps1 -OfferTemplate ./ServiceOfferingTemplate.json -ParameterFile ./your-resort.json
Cloud Shell
1. If you are not comfortable with PowerShell on your local workstation, or do not have it installed, Azure offers a command line interface directly in the browser that can make this process relatively simple. More information about using Azure Cloud Shell can be found here.
2. Open the Azure Portal in your browser.
3. Click the “Cloud Shell” icon just to the right of the Search bar near the top of the page.
4. Click the “Upload/Download Files” icon in the Cloud Shell bar.
5. Select “Upload” and then find and select the onboarding files that you received and unpacked earlier.
6. When the files are uploaded, type the following command at the Cloud Shell prompt:
  
  Registration-Helper.ps1 -OfferTemplate ./ServiceOfferingTemplate.json -ParameterFile ./your-resort.json

Register Service Offering

This will process for several minutes.

If it completed successfully you will see a message directing you to open the Service Providers blade to continue.

If this is the first time that you have added or updated the Managed Services Offering you may see the following message. If so, a necessary operation has been started that may take up to 30 minutes to complete in the background. Retry the command again in 15 minutes

Code Block

Registering the Managed Services provider...
WARNING: Required provider registration may take up to 30 minutes to complete!
WARNING: Please run this command again after 15 minutes. If you see this message again please contact support.

After seeing the previous message that a provider registration is in progress and retrying the command after a reasonable interval you may encounter the following message. If so, try the command again after another 15 minutes has passed.
Code Block
WARNING: One or more ResourceTypes in the Managed Services provider is still being registerd. Please wait 15 minutes and try this command again.
If you continue to see the warning that a Resourcetype is still being registered after more than an hour has elapsed since the first command was run, please contact support.

Delegate Resources
1. Once you have opened the Service Providers blade you should see an entry for the new Managed Services Offering similar to the screenshot. Click the + icon near the end of the entry.
2. Delegate Subscriptions
  1. If the only resources in a Subscription will be Aspenware applications, the simplest model will be to delegate access to the entire Subscription.
  2. On the Delegate Resources page, click the “+ Delegate Subscriptions” button.
3. A “Delegate Subscriptions” pane will appear on the right side of the page. Check the box next to the Azure Subscription that will be hosting the Aspenware Commerce instance(s). Then click the “Delegate Resources” button at the bottom of the pane.
4. Delegate Resource Groups
  1. If you are hosting other applications or resources in a Subscription that will be hosting Aspenware resources then you will want to delegate access to only the Aspenware resource groups. You must have created the required Resource Groups prior to proceeding. Contact support to get the list of Resource Groups that need to be created.
  2. On the Delegate Resources page, click the “+ Delegate resource groups” button.
  3. A “Delegate Resource Groups” pane will appear on the right side of the page. Check the boxes next to each Resource Group that you were asked to create prior. Then click the “Delegate Resources button on the bottom of the pane.
The “Delegate Resources” page should now show the selected resources. Check the box near the bottom of the screen to accept the delegation as displayed, and then click the “Delegate” button.
After a minute or two you should see a notification that the delegation was successful!
At any time you can view the delegations you have granted from the Service Providers - Delegations page.